summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/pst-solides3d/doc-en/pst-solides3d-doc-EN.tex
diff options
context:
space:
mode:
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.tex493
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}