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