1 \listfiles % Writes out the package versions in the log file
3 11pt,
% normal font size (default, alias for fontsize=11pt)
4 BCOR10mm,
% binding correction (deprecated, use: BCOR=10mm)
5 DIV12,
% divison factor for page layout contrution
6 % (deprecated, use: DIV=12)
7 bibtotoc,
% add unnumbered entry for the bibliography to the table
8 % of contents (deprecated, use: toc=bibliography or
10 parskip,
% use one base line vertical inter-paragraph space and
11 % at least 1 em horizontal space at the end of paragraphs
12 % instead of indenting first line of paragraphs
13 twoside,
% use twosided layout (default)
14 smallheadings,
% use smaller font sizes for headings (but at least
15 % \normalsize) with less vertical above and below headings
16 % (deprecated, use: headings=small)
17 1.1headlines,
% set head height to 1.1\baselineskip of \normalsize
18 % (deprecated, use: headlines=1.1)
19 headexclude,
% page head is part of the margins not the type area
20 % (default, deprecated, use: headinclude=false)
21 footexclude,
% page foot is part of the margins not the type area
22 % (default, deprecated, use: footinclude=false)
23 mpexclude
% margin notes are part of the margins not the type area
24 % (default, deprecated, use: mpinclude=false)
27 \usepackage[latin1]{inputenc}
28 \usepackage[T1]{fontenc}
31 \pagestyle{scrheadings
}
37 %\usepackage[garamond]{mathdesign}
38 %\renewcommand{\ttdefault}{lmtt}
40 \usepackage{multicol
} % Intermix single and multiple columns
41 \usepackage{longtable
} % Allows tables to flow over page boundaries
42 \usepackage{array
} % Extending the array and tabular environments
43 \usepackage{arrayjob
} % Management of arrays
44 \usepackage{url
} % Verbatim with URL-sensitive line breaks
45 \usepackage[a4paper,
dvips,hmargin=
2cm,vmargin=
3cm
]{geometry
} % Flexible and complete interface to document dimensions
46 \usepackage{framed
} % Framed or shaded regions that can break across pages
47 \usepackage{amsmath,amssymb
} % allows multiple maths-environments
49 \usepackage{titlesec
} % Select alternative section titles
54 %%%%%%% Loading the necessary graphic packages
55 \usepackage[dvipsnames,svgnames,table
]{pstricks
} % Loads the basic packages of 'PSTricks'
56 % with predefined color schemes from 'xcolor'
57 \usepackage[final
]{showexpl
} % Typesetting LaTeX source code
58 \usepackage{pst-plot
} % Macros for plotting functions and data records
59 \usepackage{pst-eucl
} % The 'pst-eucl' package allow the drawing of Euclidean geometric
60 % figures using LaTeX macros for specifying mathematical constraints.
61 % It is thus possible to build point using common transformations or intersections.
62 % The use of coordinates is limited to points which controlled the figure.
63 \usepackage{pst-solides3d
} % The package is designed to draw solids in 3D perspective.
64 \let\PSTfileversion\fileversion
65 \let\PSTfiledate\filedate
66 \usepackage{pstricks-add
} % A collection of add-ons and bugfixes for PSTricks.
67 % Allows 'algebraic notation' instead of the PostScript
68 % native RPN (Revers Polish Notation).
69 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
70 % Note: 'pstricks-add' always needs to be loaded last. %
71 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
73 \DeclareFixedFont{\timesnormal}{T1}{ptm
}{m
}{n
}{2cm
}
76 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
77 %% adapt\'{e} de \psRandom du package pstricks-add
78 %% pour rendre al\'{e}atoire la taille des \'{e}toiles
81 \def\psset@sizeStar
#1{\pssetlength\pssizeStar{#1}}
83 \def\psRandomStar{\pst@object
{psRandomStar
}}%
84 \def\psRandomStar@i
{\@ifnextchar(
{\psRandomStar@ii
}{\psRandomStar@iii(
0,
0)(
1,
1)
}}
85 \def\psRandomStar@ii(
#1)
{\@ifnextchar(
{\psRandomStar@iii(
#1)
}{\psRandomStar@iii(
0,
0)(
#1)
}}
86 \def\psRandomStar@iii(
#1)(
#2)
#3{%
88 \ifx\pst@tempA
\pst@empty
\psclip{\psframe(
#2)
}\else\psclip{#3}\fi
89 \pst@getcoor
{#1}\pst@tempA
90 \pst@getcoor
{#2}\pst@tempB
93 \pst@tempA
\space /yMin exch def
95 \pst@tempB
\space /yMax exch def
99 rrand srand
% initializes the random generator
100 /getRandReal
{ rand
2147483647 div
} def
102 /DS
\pst@number
\pssizeStar\space getRandReal mul def
103 \@nameuse
{psds@
\psk@dotstyle
}
104 \ifPst@
color getRandReal
1 1 sethsbcolor
\fi
105 getRandReal dx mul xMin add
106 getRandReal dy mul yMin add
108 \ifx\psk@fillstyle
\psfs@solid fill
\fi stroke
117 \renewcommand*
\l@section
{\bprot@dottedtocline
{1}{1.5em
}{2.5em
}} % hv
118 \renewcommand*
\l@subsection
{\bprot@dottedtocline
{2}{3.8em
}{3.5em
}}% hv
121 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
122 %% macro H.Voss sur :
123 %%http://tug.org/mailman/htdig/pstricks/2007/004640.html
125 \def\GetCenter#1{ tx@NodeDict begin /N@
#1 load GetCenter end
126 \pst@number
\psyunit div /
#1.y ED
127 \pst@number
\psxunit div /
#1.x ED
}
130 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
131 %% Jean-Michel Sarlat et Guillaume Connan
132 \newenvironment{gbar
}{%
133 \def\FrameCommand{{\color{red
}\vrule width
2pt
}\colorbox{yellow!
30}}%
134 \MakeFramed {\advance\hsize-
\width \FrameRestore}}%
138 %%%%%%% Setting the Chapter layout
139 \titleformat{\chapter}[display
] % {command}[shape]
140 {\usekomafont{chapter
}\Large \color{OrangeReddy
}} % format
142 \LARGE\MakeUppercase{\chaptertitlename} \Huge \thechapter \filright%
144 {1pt
} % sep (from chapternumber)
145 {\titlerule \vspace{0.9pc
} \filright \color{OrangeReddy
}} % {before}[after] (before chaptertitle and after)
146 [\color{OrangeReddy
} \vspace{0.9pc
} \filright {\titlerule}]
150 %%%%%%% Highlight some expressions
151 \newcommand\Cadre[1]{\psframebox[fillstyle=solid,fillcolor=gray!
20,linecolor=gray!
20]{\texttt{#1}}}
154 %%%%%%% Box and highlight some notes
155 \newcommand\encadre[1]{
156 \psframebox[fillstyle=solid,fillcolor=gray!
20,linecolor=gray!
20]{
157 \begin{minipage
}{\textwidth}
158 {\textbf{\textcolor{OrangeReddy
}{Note:
}}\qquad #1}
164 %%%%%%% Highlight the table of the predefined solids
165 \newcommand\toptableau{
167 \textbf{Solid
} &
\begin{tabular
}{c
}
171 \begin{minipage
}{4cm
}
172 \centerline{\textbf{View
}}
174 \begin{minipage
}{4cm
}
175 \centerline{\textbf{Code
}}
182 &Bittersweet&Black&Blue&BlueGreen&BlueViolet&BrickRed&Brown&BurntOrange
%
183 &CadetBlue&CarnationPink&Cerulean&CornflowerBlue&Cyan&Dandelion&DarkOrchid
%
184 &Emerald&ForestGreen&Fuchsia&Goldenrod&Gray&Green&GreenYellow&JungleGreen
%
185 &Lavender&LimeGreen&Magenta&Mahogany&Maroon&Melon&MidnightBlue&Mulberry
%
186 &NavyBlue&OliveGreen&Orange&OrangeRed&Orchid&Peach&Periwinkle&PineGreen
%
187 &Plum&ProcessBlue&Purple&RawSienna&Red&RedOrange&RedViolet&Rhodamine&RoyalBlue
%
188 &RoyalPurple&RubineRed&Salmon&SeaGreen&Sepia&SkyBlue&SpringGreen&Tan&TealBlue
%
189 &Thistle&Turquoise&Violet&VioletRed&White&WildStrawberry&Yellow&YellowGreen&YellowOrange
}
192 \multido{\i=
0+
1}{67}{%
194 \xdef\colorfaces{\colorfaces\i\space(
\cachedata)
\space}}
196 \definecolor{bleuciel
}{rgb
}{0.78,
0.84,
0.99}
197 \definecolor{OrangeReddy
}{rgb
}{0.73,
0.00,
0.00}
200 %%%%%%% Highlight some commands with backslashes (the three macros)
201 \newcommand{\bs}[1]{%
202 \psframebox[fillstyle=solid,fillcolor=gray!
20,
203 linecolor=gray!
20]{\texttt{\textbackslash#1}}}
206 %%%%%%% Positioning the viewpoint
207 \def\PointEcran(
#1,
#2,
#3)
#4{% position of the viewpoint on the screen
208 \pstVerb{/xM
#1 def /yM
#2 def /zM
#3 def
209 /kC dE dup mul xM xE mul yM yE mul zM zE mul add add sub
210 xV xE mul xM xE mul sub
211 yV yE mul yM yE mul sub add
212 zV zE mul zM zE mul sub add
214 /x_E kC xV xM sub mul xM add def
215 /y_E kC yV yM sub mul yM add def
216 /z_E kC zV zM sub mul zM add def
}%
217 \psPoint(x_E,y_E,z_E)
{#4}}
220 \def\datapath{}% ../doc/}
223 basicstyle=
\ttfamily\footnotesize,
224 commentstyle=
\color{PineGreen
}\slshape\footnotesize,
226 showstringspaces=false,
228 backgroundcolor=
\color{gray!
20},
229 breakautoindent=true,
232 emph=
{\begin,
\codejps,
\end},
233 emphstyle=
\color{RoyalBlue
},
235 emphstyle=
{[2]\color{OrangeReddy
}},
243 \title{\texttt{pst-solides3d
}:\\
244 The Documentation -- The Basics
246 {\normalsize v.
\PSTfileversion\ (
\PSTfiledate)
}\\
[20pt
]
247 \includegraphics[scale=
0.6]{kepler
}
249 \author{Jean-Paul
\textsc{Vignault
}, Manuel
\textsc{Luque
}, Arnaud
250 \textsc{Schmittbuhl
}\\
252 \url{<jpv@melusine.eu.org>
},
\url{<manuel.luque27@gmail.com>
},
253 \url{<aschmittbuhl@libertysurf.fr>
}}
254 \thanks{With the additional help of:
\newline
255 J\"
{u
}rgen
\textsc{Gilg
} \url{<gilg@acrotex.net>
},
\newline
256 Jean-Michel
\textsc{Sarlat
} \url{<jm.sarlat@gmail.com>
},
\newline
257 Herbert
\textsc{Voss
} \url{<herbert.voss@fu-berlin.de>
}.
264 % colors for the links
265 colorlinks=true,
% color links
266 urlcolor=OrangeReddy,
% color of URL links
267 filecolor=black,
% color of file links
268 linkcolor=OrangeReddy,
% color of links
270 %raiselinks=true, % raise up links (for HyperTeX backend)
271 %backref=page, % do bibliographical back refenrernces
272 pagebackref=true,
% back reference by page numbers
274 hyperindex=true,
% set up hyperlink indices
275 linktocpage=true,
% make page number, not text, be linked on TOC, LOF, LOT
276 hyperfootnotes=false,
% do not set up hyperlink footnotes
278 bookmarks=true,
% Generating Bookmarks for the PDF-Viewer
279 bookmarksopenlevel=
1,
% Level to which Bookmarks are opened
280 bookmarksopen=true,
% Open up Bookmarks tree
281 bookmarksnumbered=true,
% Put section numbers in Bookmarks
282 %bookmarkstype=toc, % Specify which TOC file to mimic
284 plainpages=false,
% do not page number anchors as plain arabic
285 pageanchor=true
% put an anchor on every page
289 %%%%%%% PDF Informations
291 pdftitle=
{pst-solides3d - The Documentation
},
% Text for the PDF title field
292 pdfauthor=
{Jean-Paul Vignault, Manuel Luque, Arnaud Schmittbuhl
},
% Text for the PDF author field
293 pdfcreator=
{LaTeX, hyperref, KOMA-Script
},
% Text for the PDF creator field
294 %pdfproducer={pdfeTeX 1.10b-2.1} % Text for the PDF producer field
295 pdfstartview=FitH,
% Fits the width of the page to the window.
296 pdfpagemode=UseOutlines,
% Show Bookmarks in the Viewer
297 pdfpagelabels=true
% set PDF page labels
299 \usepackage{breakurl
} % Line-breakable \url-like links in hyperref when compiling via dvips/ps2pdf
301 %%%%%%%%%%%%%%%%%%%%%%%%%%%%% Herbert %%%%%%%%%%%%%%%%%%%%%%%%%%
302 \pagestyle{scrheadings
}
304 \newcommand\Input[2][\datapath]{\ifoot{{\footnotesize#2}}\input{#1#2}}
305 \def\Lcs#1{\texttt{\textbackslash#1}%
306 \index{#1@
\texttt{\textbackslash#1}}%
307 \index{Macro!
#1@
\texttt{\textbackslash#1}}}
308 \def\Lenv#1{\texttt{#1}\index{#1@
\texttt{#1}}\index{Environment!
#1@
\texttt{#1}}}
309 \def\Lkeyword#1{\texttt{#1}%
310 \index{#1@
\texttt{#1}}\index{Keyword!
#1@
\texttt{#1}}}
311 \def\Lkeyval#1{\texttt{#1}%
312 \index{#1@
\texttt{#1}}\index{Value!
#1@
\texttt{#1}}}
313 \def\Index#1{#1\index{#1}}
322 \chapter{Basics for the package
}
325 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
326 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
328 \chapter{Setting the layout of the scenery
}
330 \Input{par-eclairageponctuel-en
}
331 \Input{par-axes3D-en
}
333 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
334 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
336 \chapter{Predefined solids and their positioning
}
338 \Input{par-solidespredefinis-en
}
339 \Input{par-positionnersolide-en
}
341 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
342 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
344 \chapter{More options of
\textbackslash{}psSolid
}
345 \Input{par-commandestrace-en
}
346 \Input{par-solidescreux-en
}
347 \Input{par-numeroterfacettes-en
}
348 \Input{par-enleverfacettes-en
}
349 \Input{par-pointagesommets-en
}
350 \Input{par-couleurs-en
}
351 \Input{par-colorierfacettes-en
}
352 \Input{par-opacity-en
}
353 \Input{par-definitionmaillage-en
}
357 \Input{par-tronque-en
}
358 \Input{par-affinage-en
}
359 \Input{par-chanfrein-en
}
360 \Input{par-transform-en
}
361 \Input{par-lignedeniveau-en
}
362 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
364 \chapter{Usage of external files
}
365 \Input{par-datfile-en
}
367 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
369 \chapter{Some special objects
}
370 \Input{par-grille-en
}
372 \Input{par-vecteur-en
}
376 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
378 \chapter{Generating some new solids
}
379 \Input{par-codejps-en
}
380 \Input{par-definirfonction-en
}
381 \Input{par-courbeR3-en
}
383 \Input{par-prisme-en
}
387 \Input{par-anneaux-en
}
388 \Input{par-cylindres-cones-en
}
389 \Input{par-surfacesparametrees-en
}
390 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
392 \chapter{Surfaces defined by a function of the form $z=f(x,y)$
}
393 \Input{par-surfaces-en
}
395 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
397 \chapter{Advanced usage
}
398 \Input{par-nommersolide-en
}
399 \Input{par-section-en
}
400 \Input{par-fusion-en
}
401 \Input{par-fusionjps-en
}
403 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
404 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
406 \chapter{Interaction with PSTricks
}
408 \Input{par-positionnerpointconnu-en
}
409 \Input{par-ligne3D-en
}
410 \Input{par-tracerpolygone-en
}
411 \Input{par-transformpointconnu-en
}
412 \Input{par-annoterschema-en
}
414 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
415 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
417 \chapter{Projections
}
418 \Input{par-projpresentation-en
}
419 \Input{par-projectionvisibility-en
}
420 \Input{par-definirplanquelconque-en
}
421 \Input{par-projectionpoint-en
}
422 \Input{par-projectionvecteur-en
}
423 \Input{par-projectiondroite-en
}
426 \Input{par-projectioncercle-en
}
427 \Input{par-projectionpolygone-en
}
428 \Input{par-projectionligne-en
}
430 \Input{par-projectionangledroit-en
}
431 \Input{par-projectioncourbe-en
}
432 \Input{par-projectiontexte-en
}
434 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
435 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
437 \chapter{Possible extensions
}
438 \Input{par-extensions-en
}
440 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
441 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
445 \Input{par-parametres-en
}
446 \Input{par-keywords-en
}
447 \Input{par-acknowledgements-en
}
456 \bibliographystyle{plain
}
457 \bibliography{pst-solides3d-doc
}