doc-en/par-axes3D-en.tex

   1 \section{The \Index{axes} in 3d}
   2
   3 The command \verb+\axesIIID[options](x1,y1,z1)(x2,y2,z2)+ draws the axes $Ox$,
   4 $Oy$ and $Oz$ dashed from the origin $O$ to the coordinates
   5 $(x_1,0,0)$ for the $x$-axis, $(0,y_1,0)$ for the $y$-axis and
   6 $(0,0,z_1)$ for the $z$-axis and from there continues drawing the axes as lines to the points $(x_2,0,0)$, $(0,y_2,0)$ and $(0,0,z_2)$.
   7
   8 The options are the following:
   9 \begin{compactitem}
  10     \item all colour options, line width as well as all types of arrows.
  11     \item \texttt{\Lkeyword{labelsep}=length} which allows you to position the \Index{label} in a self defined distance away from the extremity of the arrow of the axis, the default value is \texttt{\Lkeyword{labelsep}=5pt}---this is a real distance in three dimensions and not on screen.
  12     \item the choice of the labels on each of the axes with the option: \\
  13     \texttt{\Lkeyword{axisnames}={a,b,c}}, the default values are \texttt{\Lkeyword{axisnames}={x,y,z}}.
  14     \item the potential to specify the style of the labels with the option: \\
  15     \texttt{\Lkeyword{axisemph}=}\verb+\boldmath\Large\color{red}+. By default there is no style predefined,
  16     which means, if no style is chosen one will get \verb+$x$,$y$,$z$+.
  17     \item \Lkeyword{showOrigin} is a Boolean, \texttt{true}---by default. If it is set to
  18     \texttt{\Lkeyword{showOrigin}=false} the dashed lines aren't drawn to the origin anymore.
  19     \item \Lkeyword{mathLabel} is a Boolean, \texttt{true}---by default, in which case the
  20      math mode is activated. Set to \texttt{\Lkeyword{mathLabel}=false} the labels are set in text mode.
  21 \end{compactitem}
  22 \encadre{The \Index{labels} are placed at the extemities of the axes.}
  23
  24 \begin{LTXexample}[width=5cm]
  25 \begin{pspicture}(-2,-2)(3,3)
  26 \psset{viewpoint=100 30 20,Decran=100}
  27 \psSolid[object=cube,a=2,
  28         action=draw*,
  29         fillcolor=magenta!20]
  30 \axesIIID[showOrigin=false](1,1,1)(3,2,2.5)
  31 \end{pspicture}
  32 \end{LTXexample}
  33
  34 \begin{LTXexample}[width=5cm]
  35 \begin{pspicture}(-2,-1)(3,4)
  36 \psset{viewpoint=100 45 20,Decran=100}
  37 \psSolid[object=cylindre,h=2,r=1,
  38         action=draw*,mode=4,
  39         fillcolor=green!20]
  40 \axesIIID[linewidth=1pt,linecolor=red,arrowsize=5pt,
  41           arrowinset=0,axisnames={a,b,c},
  42           axisemph={\boldmath\Large\color{red}},
  43           labelsep=10pt]
  44          (1,1,2)(2,2,3)
  45 \end{pspicture}
  46 \end{LTXexample}
  47
  48
  49 \endinput