diff options
Diffstat (limited to 'Master/texmf-dist/doc/generic/pst-solides3d/doc-en/pst-solides3d-doc-EN.tex')
-rw-r--r-- | Master/texmf-dist/doc/generic/pst-solides3d/doc-en/pst-solides3d-doc-EN.tex | 493 |
1 files changed, 493 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/generic/pst-solides3d/doc-en/pst-solides3d-doc-EN.tex b/Master/texmf-dist/doc/generic/pst-solides3d/doc-en/pst-solides3d-doc-EN.tex new file mode 100644 index 00000000000..558aa392901 --- /dev/null +++ b/Master/texmf-dist/doc/generic/pst-solides3d/doc-en/pst-solides3d-doc-EN.tex @@ -0,0 +1,493 @@ +\listfiles % Writes out the package versions in the log file +\documentclass[% + 11pt, % normal font size (default, alias for fontsize=11pt) + BCOR10mm, % binding correction (deprecated, use: BCOR=10mm) + DIV12, % divison factor for page layout contrution + % (deprecated, use: DIV=12) + bibtotoc, % add unnumbered entry for the bibliography to the table + % of contents (deprecated, use: toc=bibliography or + % bibliography=totoc) + parskip, % use one base line vertical inter-paragraph space and + % at least 1 em horizontal space at the end of paragraphs + % instead of indenting first line of paragraphs + twoside, % use twosided layout (default) + smallheadings, % use smaller font sizes for headings (but at least + % \normalsize) with less vertical above and below headings + % (deprecated, use: headings=small) + 1.1headlines, % set head height to 1.1\baselineskip of \normalsize + % (deprecated, use: headlines=1.1) + headexclude, % page head is part of the margins not the type area + % (default, deprecated, use: headinclude=false) + footexclude, % page foot is part of the margins not the type area + % (default, deprecated, use: footinclude=false) + mpexclude % margin notes are part of the margins not the type area + % (default, deprecated, use: mpinclude=false) + ]{scrbook} + +\usepackage[latin1]{inputenc} +\usepackage[T1]{fontenc} +\usepackage{lmodern} +\usepackage{scrpage2} +\pagestyle{scrheadings} + +%\usepackage{arev} +%\usepackage{manfnt} +%\usepackage[garamond]{mathdesign} +%\renewcommand{\ttdefault}{lmtt} + +\usepackage{multicol} % Intermix single and multiple columns +\usepackage{longtable} % Allows tables to flow over page boundaries +\usepackage{array} % Extending the array and tabular environments +\usepackage{arrayjob} % Management of arrays +\usepackage{url} % Verbatim with URL-sensitive line breaks +\usepackage[a4paper,dvips,hmargin=2cm,vmargin=3cm]{geometry} % Flexible and complete interface to document dimensions +\usepackage{framed} % Framed or shaded regions that can break across pages +\usepackage{amsmath,amssymb} % allows multiple maths-environments +\usepackage{ragged2e} +\usepackage{titlesec} % Select alternative section titles + + +%%%%%%% +%%%%%%% Loading the necessary graphic packages +\usepackage[dvipsnames,svgnames,table]{pstricks} % Loads the basic packages of 'PSTricks' + % with predefined color schemes from 'xcolor' +\usepackage[final]{showexpl} % Typesetting LaTeX source code +\usepackage{pst-plot} % Macros for plotting functions and data records +\usepackage{pst-eucl} % The 'pst-eucl' package allow the drawing of Euclidean geometric + % figures using LaTeX macros for specifying mathematical constraints. + % It is thus possible to build point using common transformations or intersections. + % The use of coordinates is limited to points which controlled the figure. +\usepackage{pst-solides3d} % The package is designed to draw solids in 3D perspective. +\let\PSTfileversion\fileversion +\let\PSTfiledate\filedate +\usepackage{pstricks-add} % A collection of add-ons and bugfixes for PSTricks. + % Allows 'algebraic notation' instead of the PostScript + % native RPN (Revers Polish Notation). +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +% Note: 'pstricks-add' always needs to be loaded last. % +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +\DeclareFixedFont{\timesnormal}{T1}{ptm}{m}{n}{2cm} +\raggedbottom +\makeatletter +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% adapt\'{e} de \psRandom du package pstricks-add +%% pour rendre al\'{e}atoire la taille des \'{e}toiles +%% Manuel Luque +\newdimen\pssizeStar +\def\psset@sizeStar#1{\pssetlength\pssizeStar{#1}} +\psset@sizeStar{1pt} +\def\psRandomStar{\pst@object{psRandomStar}}% +\def\psRandomStar@i{\@ifnextchar({\psRandomStar@ii}{\psRandomStar@iii(0,0)(1,1)}} +\def\psRandomStar@ii(#1){\@ifnextchar({\psRandomStar@iii(#1)}{\psRandomStar@iii(0,0)(#1)}} +\def\psRandomStar@iii(#1)(#2)#3{% + \def\pst@tempA{#3}% + \ifx\pst@tempA\pst@empty\psclip{\psframe(#2)}\else\psclip{#3}\fi + \pst@getcoor{#1}\pst@tempA + \pst@getcoor{#2}\pst@tempB + \begin@SpecialObj + \addto@pscode{ + \pst@tempA\space /yMin exch def + /xMin exch def + \pst@tempB\space /yMax exch def + /xMax exch def + /dy yMax yMin sub def + /dx xMax xMin sub def + rrand srand % initializes the random generator + /getRandReal { rand 2147483647 div } def + \psk@randomPoints { + /DS \pst@number\pssizeStar\space getRandReal mul def + \@nameuse{psds@\psk@dotstyle} + \ifPst@color getRandReal 1 1 sethsbcolor \fi + getRandReal dx mul xMin add + getRandReal dy mul yMin add + Dot + \ifx\psk@fillstyle\psfs@solid fill \fi stroke + } repeat + }% + \end@SpecialObj + \endpsclip + \ignorespaces +} + + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% macro H.Voss sur : +%%http://tug.org/mailman/htdig/pstricks/2007/004640.html + +\def\GetCenter#1{ tx@NodeDict begin /N@#1 load GetCenter end + \pst@number\psyunit div /#1.y ED + \pst@number\psxunit div /#1.x ED } +\makeatother + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% Jean-Michel Sarlat et Guillaume Connan +\newenvironment{gbar}{% + \def\FrameCommand{{\color{red}\vrule width 2pt}\colorbox{yellow!30}}% + \MakeFramed {\advance\hsize-\width \FrameRestore}}% +{\endMakeFramed} + +%%%%%%% +%%%%%%% Setting the Chapter layout +\titleformat{\chapter}[display] % {command}[shape] + {\usekomafont{chapter}\Large \color{OrangeReddy}} % format + { % label + \LARGE\MakeUppercase{\chaptertitlename} \Huge \thechapter \filright% + }%} + {1pt} % sep (from chapternumber) + {\titlerule \vspace{0.9pc} \filright \color{OrangeReddy}} % {before}[after] (before chaptertitle and after) + [\color{OrangeReddy} \vspace{0.9pc} \filright {\titlerule}] + + +%%%%%%% +%%%%%%% Highlight some expressions +\newcommand\Cadre[1]{\psframebox[fillstyle=solid,fillcolor=gray!20,linecolor=gray!20]{\texttt{#1}}} + +%%%%%%% +%%%%%%% Box and highlight some notes +\newcommand\encadre[1]{ +\psframebox[fillstyle=solid,fillcolor=gray!20,linecolor=gray!20]{ + \begin{minipage}{\textwidth} + {\textbf{\textcolor{OrangeReddy}{Note:}}\qquad #1} + \end{minipage}} +} + + +%%%%%%% +%%%%%%% Highlight the table of the predefined solids +\newcommand\toptableau{ +\rowcolor{gray!20} + \textbf{Solid} & \begin{tabular}{c} + \textbf{Default}\\ + \textbf{Parameters} + \end{tabular} & + \begin{minipage}{4cm} + \centerline{\textbf{View}} + \end{minipage}& + \begin{minipage}{4cm} + \centerline{\textbf{Code}} + \end{minipage}} +%%%%%%% +%%%%%%% Color array +\newarray\colors +\readarray{colors}{% +Apricot&Aquamarine% +&Bittersweet&Black&Blue&BlueGreen&BlueViolet&BrickRed&Brown&BurntOrange% +&CadetBlue&CarnationPink&Cerulean&CornflowerBlue&Cyan&Dandelion&DarkOrchid% +&Emerald&ForestGreen&Fuchsia&Goldenrod&Gray&Green&GreenYellow&JungleGreen% +&Lavender&LimeGreen&Magenta&Mahogany&Maroon&Melon&MidnightBlue&Mulberry% +&NavyBlue&OliveGreen&Orange&OrangeRed&Orchid&Peach&Periwinkle&PineGreen% +&Plum&ProcessBlue&Purple&RawSienna&Red&RedOrange&RedViolet&Rhodamine&RoyalBlue% +&RoyalPurple&RubineRed&Salmon&SeaGreen&Sepia&SkyBlue&SpringGreen&Tan&TealBlue% +&Thistle&Turquoise&Violet&VioletRed&White&WildStrawberry&Yellow&YellowGreen&YellowOrange} + +\edef\colorfaces{}% +\multido{\i=0+1}{67}{% + \checkcolors(\i) +\xdef\colorfaces{\colorfaces\i\space(\cachedata)\space}} + +\definecolor{bleuciel}{rgb}{0.78,0.84,0.99} +\definecolor{OrangeReddy}{rgb}{0.73,0.00,0.00} + +%%%%%%% +%%%%%%% Highlight some commands with backslashes (the three macros) +\newcommand{\bs}[1]{% + \psframebox[fillstyle=solid,fillcolor=gray!20, + linecolor=gray!20]{\texttt{\textbackslash#1}}} + +%%%%%%% +%%%%%%% Positioning the viewpoint +\def\PointEcran(#1,#2,#3)#4{% position of the viewpoint on the screen +\pstVerb{/xM #1 def /yM #2 def /zM #3 def + /kC dE dup mul xM xE mul yM yE mul zM zE mul add add sub + xV xE mul xM xE mul sub + yV yE mul yM yE mul sub add + zV zE mul zM zE mul sub add + div def + /x_E kC xV xM sub mul xM add def + /y_E kC yV yM sub mul yM add def + /z_E kC zV zM sub mul zM add def}% +\psPoint(x_E,y_E,z_E){#4}} + + +%%%%%%% +%%%%%%% Defining the path for the input files +\def \datapath{% +% ../doc/} +} + +%%%%%%% +%%%%%%% Layout of the verbatim listing of showexamples +\lstset{% + basicstyle=\ttfamily\footnotesize, + commentstyle=\color{PineGreen}\slshape\footnotesize, + showspaces=false, + showstringspaces=false, + breaklines=true, + backgroundcolor=\color{gray!20}, + breakautoindent=true, + captionpos=t, + language=TeX, + emph={\begin,\codejps,\end}, + emphstyle=\color{RoyalBlue}, + emph={[2]pspicture}, + emphstyle={[2]\color{OrangeReddy}}, + numbersep=5pt +} + +%%%%%%% +%%%%%%% Title Page +\title{\texttt{pst-solides3d}:\\ + The Documentation -- The Basics + \\[0.5cm] +{\normalsize v. \PSTfileversion\ (\PSTfiledate)}\\ +\input \datapath tintin +} +\author{Jean-Paul \textsc{Vignault}, Manuel \textsc{Luque}, Arnaud +\textsc{Schmittbuhl}\\ +{\small + \url{<jpv@melusine.eu.org>}, \url{<manuel.luque27@gmail.com>}, + \url{<aschmittbuhl@libertysurf.fr>}} +\thanks{With the additional help of:\newline + J\"{u}rgen \textsc{Gilg} \url{<gilg@acrotex.net>},\newline + Jean-Michel \textsc{Sarlat} \url{<jm.sarlat@gmail.com>},\newline + Herbert \textsc{Voss} \url{<herbert.voss@fu-berlin.de>}. +}} +\date{\today} + + + +\usepackage[ +% colors for the links + colorlinks=true, % color links + urlcolor=OrangeReddy, % color of URL links + filecolor=black, % color of file links + linkcolor=OrangeReddy, % color of links +% Links + %raiselinks=true, % raise up links (for HyperTeX backend) + %backref=page, % do bibliographical back refenrernces + pagebackref=true, % back reference by page numbers + verbose, % be chatty + hyperindex=true, % set up hyperlink indices + linktocpage=true, % make page number, not text, be linked on TOC, LOF, LOT + hyperfootnotes=false, % do not set up hyperlink footnotes +% Bookmarks + bookmarks=true, % Generating Bookmarks for the PDF-Viewer + bookmarksopenlevel=1, % Level to which Bookmarks are opened + bookmarksopen=true, % Open up Bookmarks tree + bookmarksnumbered=true, % Put section numbers in Bookmarks + %bookmarkstype=toc, % Specify which TOC file to mimic +% Anchors + plainpages=false, % do not page number anchors as plain arabic + pageanchor=true % put an anchor on every page + ]{hyperref} + +%%%%%%% +%%%%%%% PDF Informations +\hypersetup{% + pdftitle={pst-solides3d - The Documentation}, % Text for the PDF title field + pdfauthor={Jean-Paul Vignault, Manuel Luque, Arnaud Schmittbuhl}, % Text for the PDF author field + pdfcreator={LaTeX, hyperref, KOMA-Script}, % Text for the PDF creator field + %pdfproducer={pdfeTeX 1.10b-2.1} % Text for the PDF producer field + pdfstartview=FitH, % Fits the width of the page to the window. + pdfpagemode=UseOutlines, % Show Bookmarks in the Viewer + pdfpagelabels=true % set PDF page labels + } +\usepackage{breakurl} % Line-breakable \url-like links in hyperref when compiling via dvips/ps2pdf + +%%%%%%%%% Herbert +%\usepackage{underscore} +\ofoot{\pagemark} +\newcommand\Input[2][\datapath]{\ifoot{{\footnotesize#2}}\input{#1#2}} +% doesnt wotrk with underscores in filename + + +\begin{document} +\maketitle + +\tableofcontents + +\newpage + +\chapter{Basics for the package} +\input \datapath chapter_1_en_corr + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +\chapter{Basic commands} +\input \datapath chapter_2_en_corr +\input \datapath par-solidespredefinis_en_corr +\input \datapath par-positionnersolide_en_corr + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +\chapter{More options of \textbackslash{}psSolid} +\input \datapath par-commandestrace_en_corr + +\input \datapath par-solidescreux_en_corr + +\input \datapath par-numeroterfacettes_en_corr + +\input \datapath par-enleverfacettes_en_corr + +\input \datapath par-pointagesommets_en_corr + +\input \datapath par-couleurs_en_corr + +\input \datapath par-colorierfacettes_en_corr + +\input \datapath par-opacity_en_corr + +\input \datapath par-definitionmaillage_en_corr + +\input \datapath par-modes_en_corr + +\input \datapath par-eclairageponctuel_en_corr + +\input \datapath par-tronque_en_corr + +\input \datapath par-affinage_en_corr + +\input \datapath par-chanfrein_en_corr + +\input \datapath par-transform_en_corr + +\input \datapath par-lignedeniveau_en_corr + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +\chapter{Usage of external files} +\input \datapath par-datfile_en_corr + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +\chapter{Some special objects} +%\input \datapath par-grille_en_corr +\input \datapath par-point_en_corr + +\input \datapath par-vecteur_en_corr + +\input \datapath par-plan_en_corr + +\input \datapath par-geode_en_corr + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +\chapter{Generating some new solids} +\input \datapath par-codejps_en_corr + +\input \datapath par-definirfonction_en_corr + +\input \datapath par-courbeR3_en_corr + +\input \datapath par-tube_en_corr + +\input \datapath par-prisme_en_corr + +\input \datapath par-new_en_corr + +\input \datapath par-face_en_corr + +\input \datapath par-ruban_en_corr + +\input \datapath par-anneaux_en_corr + +\input \datapath par-cylindres-cones_en_corr + +\input \datapath par-surfacesparametrees_en_corr + + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +\chapter{Surfaces defined by a function of the form $z=f(x,y)$} +\input \datapath par-surfaces_en_corr + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +\chapter{Advanced usage} +\input \datapath par-nommersolide_en_corr + +\input \datapath par-section_en_corr + +\input \datapath par-fusion_en_corr + +\input \datapath par-fusionjps_en_corr + + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +\chapter{Interaction with PSTricks} + +\input \datapath par-positionnerpointconnu_en_corr + +\input \datapath par-ligne3D_en_corr + +\input \datapath par-tracerpolygone_en_corr + +\input \datapath par-transformpointconnu_en_corr + +\input \datapath par-annoterschema_en_corr + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +\chapter{Projections} +\input \datapath par-projpresentation_en_corr + +\input \datapath par-projectionvisibility_en_corr + +\input \datapath par-definirplanquelconque_en_corr + +\input \datapath par-projectionpoint_en_corr + +\input \datapath par-projectionvecteur_en_corr + +\input \datapath par-projectiondroite_en_corr + +%\newpage +\input \datapath par-projectioncercle_en_corr + +\input \datapath par-projectionpolygone_en_corr + +\input \datapath par-projectionligne_en_corr +%\newpage + +\input \datapath par-projectionangledroit_en_corr + +\input \datapath par-projectioncourbe_en_corr + +\input \datapath par-projectiontexte_en_corr + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +\chapter{Possible extensions} +\input \datapath par-extensions_en_corr + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +\appendix +\chapter{Appendix} +\input \datapath par-parametres_en_corr +\input \datapath par-keywords_en_corr +\input \datapath par-acknowledgements_en +\input \datapath par-poems_en + + +\nocite{*} +\bgroup +\RaggedRight +\bibliographystyle{plain} +\bibliography{pst-solides3d-doc} +\egroup + +\end{document} |