1 \section{The parameters of \texttt{pst-solides3d}}
3 \begin{longtable}{|>{\bfseries\ttfamily\color{blue}}l
4 |>{\ttfamily\centering}m{2cm}|m{10cm}|}
6 \multicolumn{1}{|c|}{\textbf{Parameter}}&
7 \multicolumn{1}{c|}{\textbf{Default}}&
8 \multicolumn{1}{c|}{\textbf{Description}} \\ \hline\hline
11 \multicolumn{1}{|c|}{\textbf{Parameter}}&
12 \multicolumn{1}{c|}{\textbf{Default}}&
13 \multicolumn{1}{c|}{\textbf{Description}} \\ \hline\hline
15 \multicolumn{3}{|r|}{\textit{Continued on next page}}\\ \hline
17 \multicolumn{3}{|r|}{\textit{End of table}}\\ \hline
20 object&&predefined objects for use with
21 \texttt{\textbackslash{}psSolid} and
22 \texttt{\textbackslash{}psProjection}: \texttt{\Lkeyword{object}=myName}
23 where \texttt{myName} is the type of object\\
26 viewpoint&10 10 10&the coordinates of the point of view\\ \hline
28 a&2&the value of \texttt{a} has several interpretations: the edge
29 length of a cube, the radius of the circumscribed sphere of
30 regular polyhedrons, the length of one of the edges of a
31 parallelepiped\\ \hline
33 r&2&the radius of a cylinder or sphere\\ \hline
35 h&6&the height of a cylinder, cone, truncated cone, or prism\\
38 r0&1.5&the inner radius of a torus\\\hline
40 r1&4&the mean radius of a torus\\ \hline
42 phi&0&the lower latitude of a spherical zone\\ \hline
44 theta&90&the upper latitude of a spherical zone\\ \hline
46 a,b and c&4&the lengths of three incident edges of a parallelepiped\\
49 base&\begin{tabular}{rr}-1 & -1 \\ 1 & -1 \\ 0 &
50 1\end{tabular}&the coordinates of vertices in the $xy$-plane
51 for specified shapes\\
54 axe&0 0 1&the direction of the axis of inclination of a prism\\
57 action&draw**&uses the painting algorithm to draw the solid
58 without hidden edges and with coloured faces\\ \hline
60 lightsrc&20 30 50&the Cartesian coordinates of the light source\\
63 lightintensity&2&the intensity of the light source\\ \hline
65 ngrid&n1 n2& sets the grid for a chosen solid\\ \hline
67 mode&0&sets a predefined grid: values are 0 to 4.
68 \texttt{mode=0} is a large grid and \texttt{mode=4} is a fine
71 grid& true&if \texttt{grid} is used then gridlines are suppressed\\
74 biface&true&draw the interior face; if you only want the exterior
75 shown write \texttt{biface=false}
78 algebraic&false&\texttt{algebraic=true} (also written as
79 \texttt{[algebraic]}) allows you to give the equation of a surface
80 in algebraic form (otherwise RPN is enabled); the package
81 \texttt{pstricks-add} must be loaded in the preamble\\ \hline
83 fillcolor&white&specifies a colour for the outer faces of a
86 incolor&green&specifies a colour for the inner faces of a solid\\
89 hue&&the colour gradient used for the outer faces of a solid\\
92 inhue&&the colour gradient used for internal faces\\
95 inouthue&&the colour gradient used for both internal and
96 external faces as a single continuation\\
99 fcol&&permits you to specify, in order of face number $0$ to $n-1$
100 (for $n$ faces) the colour of the appropriate face:\par
101 \texttt{fcol=0 (Apricot) 1 (Aquamarine) etc.}\\ \hline
103 rm&&removes visible faces: \texttt{rm=1 2 8} removes faces 1, 2
106 show&&determines which vertices are shown as points:
107 \texttt{show=0 1 2 3} shows the vertices 0, 1, 2 and 3,
108 \texttt{show=all} shows all the vertices\\ \hline
110 num&&numbers the vertices; for example \texttt{num=0 1 2 3}
111 numbers the vertices 0,1,2 and 3, and \texttt{num=all} numbers
112 all the vertices\\ \hline
114 name&&the name given to a solid\\ \hline
116 solidname&&the name of the active solid\\ \hline
118 RotX&0&the angle of rotation of the solid around $Ox$ (in
121 RotY&0&the angle of rotation of the solid around $Oy$ (in
124 RotZ&0&the angle of rotation of the solid around $Oz$ (in
127 hollow&false& draws the inside of hollow solids: cylinder, cone,
128 truncated cone and prism\\ \hline
130 decal&-2&reassign the index numbers of the vertices within a \texttt{base}\\
133 axesboxed& false& this option for surfaces allows semi-automatic
134 drawing of the 3D coordinate axes, since the limits of $z$ must be
136 hand; enabled with \texttt{axesboxed}\\
139 Zmin&$-4$& the minimum value of $z$\\ \hline
141 Zmax&$4$& the maximum value of $z$\\ \hline
143 QZ&$0$& shifts the coordinate axes vertically by the chosen value\\
146 spotX&dr&the position of the tick labels on the $x$-axis\\ \hline
148 spotY&dl&the position of the tick labels on the $y$-axis\\ \hline
150 spotZ&l&the position of the tick labels on the $z$-axis\\ \hline
152 resolution&36&the number of points used to draw a curve\\ \hline
154 range&-4 4 &the limits for function input\\ \hline
156 function& f & the name given to a function\\ \hline
158 path&newpath \par 0 0 moveto& the projected path\\ \hline
160 %normal&0 0 1&the normal to the surface being defined\\ \hline
162 text&&the projected text\\ \hline
164 visibility&false& if \texttt{false} the text applied to a hidden
169 chanfreincoeff&0.2&the chamfering coefficient\\ \hline
171 trunccoeff&0.25&the truncation coefficient\\ \hline
173 dualregcoeff&1&the dual solid coefficient\\ \hline %%%% is this used anywhere?
175 affinagecoeff&0.8&the hollowing coefficient\\ \hline
177 affinage& & determines which faces are hollowed out:
178 \texttt{affinage=0 1 2 3} recesses faces 0, 1, 2 and 3,
179 \texttt{affinage=all} recesses all faces\\ \hline
181 affinagerm& &keep the central part of hollowed out faces\\ \hline
183 intersectiontype&-1&the type of intersection between a plane and a
184 solid; a positive value draws the intersection\\ \hline
186 plansection&&list of equations of intersecting planes, when used
187 only for their intersections \\
190 plansepare&&the equation of the separating plane for a solid\\
193 {\small intersectionlinewidth}&1&the thickness of an intersection
194 in \texttt{pt}; if there are several inter\-sections of different
195 thicknesses then list them like so:\par
196 \texttt{intersectionlinewidth=1 1.5 1.8 etc.}\\
199 intersectioncolor&(rouge)&the colour used for intersections; if
200 several inter\-sections in different colours are required, list
201 them as follows:\par \texttt{intersectioncolor=(rouge) (vert) etc.}\\
204 intersectionplan&[0 0 1 0]&the equation of the intersecting
207 definition&&defines a point, a vector, a plane, a spherical arc,
210 args&&arguments associated with \texttt{definition}\\
213 section&\textbackslash Section&the coordinates of the vertices of
214 a cross-section of a solid ring\\ \hline
216 planmarks&false&scales the axes of the plane\\ \hline
218 plangrid&false&draws the coordinate axes of the plane \\ \hline
220 showbase&false&draws the unit vectors of the plane\\ \hline
222 showBase&false&draws the unit vectors of the plane and the normal
223 vector to the plane\\ \hline
225 deactivatecolor&false&disables the colour management of PSTricks\\
228 transform&&a formula, applied to the vertices of a solid, to
229 transform it\\ \hline
231 axisnames&\{x,y,z\}&the labels of the axes in 3D\\ \hline
233 axisemph&&the style of the axes labels in 3D\\ \hline
235 showOrigin&true&draws the axes from the origin, or not if set to
236 \texttt{false}\\ \hline
238 mathLabel&true&draws the axes labels in math mode, or not if set
239 to \texttt{false}\\ \hline
241 file&&the name of the data file having \texttt{.dat} extension
242 written with \texttt{action=writesolid} or read with
243 \texttt{object=datfile}\\
246 load&&the name of the object to be loaded\\ \hline
248 fcolor&&the colour of the refined parts of the faces of an object\\
251 sommets&&the list of vertices of a solid for use with \texttt{object=new}\\
254 faces&&the list of faces of a solid for use with \texttt{object=new}\\
257 stepX&1&a positive integer giving the interval between ticks on
258 the $x$-axis of \texttt{\textbackslash{}gridIIID}\\ \hline
260 stepY&1&a positive integer giving the interval between ticks on
261 the $y$-axis of \texttt{\textbackslash{}gridIIID}\\ \hline
263 stepZ&1&a positive integer giving the interval between ticks on
264 the $z$-axis of \texttt{\textbackslash{}gridIIID}\\ \hline
266 ticklength&0.2&the length of tickmarks for
267 \texttt{\textbackslash{}gridIIID}\\ \hline