Changeset 113

Show
Ignore:
Timestamp:
08/17/08 18:34:02 (4 months ago)
Author:
herbert
Message:

M doc-en/par-section-en.tex
M doc-en/par-modes-en.tex
M doc-en/par-pointagesommets-en.tex
M doc-en/par-projectiontexte-en.tex
M doc-en/par-codejps-en.tex
M doc-en/par-colorierfacettes-en.tex
M doc-en/par-affinage-en.tex
M doc-en/par-cylindres-cones-en.tex
M doc-en/par-geode-en.tex
M doc-en/par-projectionvisibility-en.tex
M doc-en/par-commandestrace-en.tex
M doc-en/par-positionnerpointconnu-en.tex
M doc-en/par-projectionpoint-en.tex
M doc-en/par-new-en.tex
M doc-en/par-tronque-en.tex
M doc-en/par-numeroterfacettes-en.tex
M doc-en/par-anneaux-en.tex
M doc-en/par-surfaces-en.tex
M doc-en/par-enleverfacettes-en.tex
M doc-en/par-fusionjps-en.tex
M doc-en/par-transformpointconnu-en.tex
M doc-en/par-projectioncercle-en.tex
M doc-en/par-prisme-en.tex
M doc-en/chapter-2-en.tex
M doc-en/par-datfile-en.tex
M doc-en/par-positionnersolide-en.tex
M doc-en/par-transform-en.tex
M doc-en/par-lignedeniveau-en.tex
M doc-en/par-plan-en.tex
M doc-en/par-nommersolide-en.tex
M doc-en/Makefile
M doc-en/par-parametres-en.tex
M doc-en/chapter-1-en.tex
M doc-en/par-projpresentation-en.tex
M doc-en/par-opacity-en.tex
M doc-en/par-solidescreux-en.tex
M doc-en/par-solidespredefinis-en.tex
M doc-en/par-definitionmaillage-en.tex
M doc-en/par-point-en.tex
M doc-en/par-chanfrein-en.tex
M doc-en/par-face-en.tex
M doc-en/par-couleurs-en.tex
M doc-en/par-fusion-en.tex
M doc-en/par-ruban-en.tex
M doc-en/par-projectionvecteur-en.tex
M doc-en/par-definirfonction-en.tex
M doc-en/par-courbeR3-en.tex
M doc-en/par-eclairageponctuel-en.tex
M doc-en/par-annoterschema-en.tex
M doc-en/par-projectionpolygone-en.tex
M doc-en/par-projectionligne-en.tex
M doc-en/par-tube-en.tex
M doc-en/par-surfacesparametrees-en.tex
M doc-en/par-projectioncourbe-en.tex
M doc-en/par-vecteur-en.tex
M doc-en/par-projectiondroite-en.tex
M doc-en/par-projectionangledroit-en.tex
M doc-en/par-ligne3D-en.tex
M doc-en/par-axes3D-en.tex
M doc-en/par-tracerpolygone-en.tex
M doc-en/par-definirplanquelconque-en.tex

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • trunk/doc-en/Makefile

    r111 r113  
    3131        makeindex -s gglo.ist -t $(basename $<).glg -o $(basename $<).gls \ 
    3232          $(basename $<).glo 
    33         makeindex -t $(basename $<).ilg -o $(basename $<).ind \ 
     33        makeindex -s Letter.ist -t $(basename $<).ilg -o $(basename $<).ind \ 
    3434          $(basename $<).idx 
    3535        bibtex $(basename $<) 

  • trunk/doc-en/chapter-1-en.tex

    r112 r113  
    109109 
    110110From the user's standpoint, most of its functionalities are 
    111 accessible by way of three \TeX{} macros: \bs{psSolid}, which can 
    112 manipulate objects in 3 dimensions, \bs{psSurface}, related to the 
     111accessible by way of three \TeX{} macros: \Lcs{psSolid}, which can 
     112manipulate objects in 3 dimensions, \Lcs{psSurface}, related to the 
    113113first macro and designed to represent surfaces that are defined by 
    114 an equation of the type $f(x,y) = z$ and \bs{psProjection} which 
     114an equation of the type $f(x,y) = z$ and \Lcs{psProjection} which 
    115115allows the user to project two-dimensional graphics/text onto any 
    116116plane face of a 3D solid. 
    …… 
    141141 
    142142\begin{itemize} 
    143 \item The macro \bs{psProjection} has been completely rewritten. We now need to use an 
    144 object of type \verb+plan+ to define a projection. 
    145 \item The object \verb+courbe+ now uses the argument $r$. To reproduce the previous behaviour 
     143\item The macro \Lcs{psProjection} has been completely rewritten. We now need to use an 
     144object of type \Lkeyword{plan} to define a projection. 
     145\item The object \Lkeyword{courbe} now uses the argument $r$. To reproduce the previous behaviour 
    146146we now have to specify $r=0$. 
    147 \item The option \verb+resolution+ of the object \verb+courbe+ is replaced with the option 
    148 \verb+ngrid+ 
    149 \item Suppression of the argument \verb+tracelignedeniveau+. 
     147\item The option \Lkeyword{resolution} of the object \Lkeyword{courbe} is replaced with the option 
     148\Lkeyword{ngrid} 
     149\item Suppression of the argument \Lkeyword{tracelignedeniveau}. 
    150150\end{itemize} 
    151151 
    …… 
    153153 
    154154\begin{itemize} 
    155 \item The option \verb+hue+ is not a Boolean anymore. 
     155\item The option \Lkeyword{hue} is not a Boolean anymore. 
    156156\item The scaling in PostScript will from now on follow the workings of \textit{jps code}. 
    157157To be consistent, the commands \verb+smoveto+, 

  • trunk/doc-en/chapter-2-en.tex

    r112 r113  
    119119\end{center} 
    120120 
    121 The coordinates of the object, in this case the bluish cube, are setup in the axes of coordinates $Oxyz$.  The coordinates of the view point ($V$), are setup in the same axes of coordinates, either in spherical coordinates---with the adding option \verb+[rtp2xyz]+, or in Cartesian coordinates---which is the default option. 
     121The coordinates of the object, in this case the bluish cube, are setup in the axes of coordinates $Oxyz$.  The \Index{coordinates} of the \Index{view point} ($V$), are setup in the same axes of coordinates, either in \Index{spherical coordinates}---with the adding option \verb+[rtp2xyz]+, or in Cartesian coordinates---which is the default option. 
    122122 
    123123Example: \verb+[viewpoint=50 30 20  rtp2xyz]+ \qquad (here the notation with spherical coordinates) 
    …… 
    175175 \end{pspicture} 
    176176 
    177 \section{The definition of the option \texttt{Decran}} 
    178 The projection screen is placed perpendicular to the direction $OV$---central  
    179 perspective, at a distance $D$ from the view point $V$: We call that distance  
    180 `Decran', with the default value of \texttt{[\Lkeyword{Decran}=50]}; this value can  
     177\section{The definition of the option \texttt{\Index{Decran}}} 
     178The \Index{projection screen} is placed perpendicular to the direction $OV$---central 
     179perspective, at a distance $D$ from the view point $V$: We call that distance 
     180`Decran', with the default value of \texttt{\Lkeyword{Decran}=50}; this value can 
    181181either be positive or negative. 
    182182 
    …… 
    239239 
    240240 
    241 If you keep the view point and make the \Lkeyword{Decran} value smaller, then the  
     241If you keep the view point and make the \Lkeyword{Decran} value smaller, then the 
    242242image gets smaller. If you make the \Lkeyword{Decran} value larger, then the image gets larger. 
    243243 
    244 Here are some examples, where we keep the same object, the same view point  
     244Here are some examples, where we keep the same object, the same view point 
    245245and just vary the \Lkeyword{Decran} value: 
    246246 

  • trunk/doc-en/par-affinage-en.tex

    r112 r113  
    1 \section{Hollowing out a solid's faces} 
     1\section{\Index{Hollowing out} a solid's faces} 
    22 
    3 We call \textit{hollowing by the ratio $k$} an operation, which for a given  
    4 face with the center $G$, executes a dilation on that face with the ratio   
     3We call \textit{hollowing by the ratio $k$} an operation, which for a given 
     4face with the center $G$, executes a dilation on that face with the ratio 
    55$k$, then divides the original face with using this new face. 
    66 
    …… 
    1111\psset{lightsrc=10 0 10,viewpoint=50 -20 30 rtp2xyz,Decran=50} 
    1212\begin{pspicture*}(-4,-4)(4,4) 
    13 \psframe(-4,-4)(4,4) 
     13%\psframe(-4,-4)(4,4) 
    1414\psSolid[object=cube, 
    1515   fillcolor=red, 
    …… 
    2020\end{center} 
    2121 
    22 The option \verb+affinage+ allows to hollow a solid's faces either globally or 
    23 individually. This option uses the key \verb+affinagecoeff+ 
     22The option \Lkeyword{affinage} allows us to hollow a solid's faces either globally or 
     23individually. This option uses the key \Lkeyword{affinagecoeff} 
    2424(value $0.8$ by default) which indicates the ratio $k$ used for the 
    2525hollow ($0<k<1$). 
    2626% 
    2727\begin{itemize} 
    28  \item \verb+[affinage=all]+ hollows all the faces; 
    29  \item \verb+[affinage=0 1 2 3]+ hollows the faces \texttt{[0,1,2 and 3]}; 
     28 \item \texttt{\Lkeyword{affinage}=\Lkeyval{all}} hollows all the faces; 
     29 \item \texttt{\Lkeyword{affinage}=0 1 2 3} hollows the faces 0, 1, 2 and 3; 
    3030\end{itemize} 
    3131 
    32 When a face is hollowed out, the default behaviour suppresses the resulting central  
    33 face. However, the option \verb+affinagerm+ allows us to conserve that central face. 
     32When a face is hollowed out, the default behaviour suppresses the resulting central 
     33face. However, the option \Lkeyword{affinagerm} allows us to conserve that central face. 
    3434 
    35 When we conserve the centre face, it is---by default---drawn with the same colour  
    36 as the original. The option \verb+fcolor+ permits to specify another colour. 
     35When we conserve the centre face, it is---by default---drawn with the same colour 
     36as the original. The option \Lkeyword{fcolor} permits to specify another colour. 
    3737 
    3838%\newpage 
    …… 
    6262   affinage=all] 
    6363\end{pspicture*} 
    64 \end{LTXexample}  
     64\end{LTXexample} 
    6565 
    6666\endinput 

  • trunk/doc-en/par-anneaux-en.tex

    r112 r113  
    22\section{Solid rings} 
    33 
    4 This paragraph discusses the cylindric rings. Within the macro 
    5 \bs{psSolid}, this object is passed with the option: 
    6 \verb+[object=anneau]+, that comes with 3 parameters: 
     4This paragraph discusses the cylindric \Index{rings}. Within the macro 
     5\Lcs{psSolid}, this object is passed with the option: 
     6\texttt{\Lkeyword{object}=\Lkeyval{anneau}}, that comes with 3 parameters: 
    77\begin{itemize} 
    8   \item the inner radius \verb+[r=1.5]+ (value by default); 
    9   \item the outer radius \verb+[R=4]+ (value by default); 
    10   \item the height \verb+[h=6]+ (value by default). 
     8  \item the inner radius \texttt{\Lkeyword{r}=1.5} (value by default); 
     9  \item the outer radius \texttt{\Lkeyword{R}=4} (value by default); 
     10  \item the height \texttt{\Lkeyword{h}=6} (value by default). 
    1111\end{itemize} 
    1212 
    13 The argument \verb+ngrid+ defines the number of sections used to make a complete 
     13The argument \Lkeyword{ngrid} defines the number of sections used to make a complete 
    1414rotation of $360$~degrees. Its default value is $24$. 
    1515 
    …… 
    2222This section is defined in the plane $Oyz$, it is parameterized with the 
    2323triple $(r, R, h)$. The values of the outer radius $R$, inner radius $r$ and the 
    24 height $h$ are passed in the macro \bs{psSolid}. By default, one has a ring with 
     24height $h$ are passed in the macro \Lcs{psSolid}. By default, one has a ring with 
    2525a variable rectangular section, and the definition takes place at the time 
    26 of the transmission of the values $(r, R, h)$ into the options of \bs{psSolid}. 
     26of the transmission of the values $(r, R, h)$ into the options of \Lcs{psSolid}. 
    2727 
    2828If the user redefines the \TeX {} macro \verb+\Section+ with some numeric values 
    2929instead of the  parameters $r$, $R$ and $h$, then 
    3030the ring won't be variable anymore  and it is not necessary to transmit the 
    31 values  $r$, $R$, and $h$ into the options of \bs{psSolid}. 
     31values  $r$, $R$, and $h$ into the options of \Lcs{psSolid}. 
    3232 
    3333\begin{minipage}{0.45\linewidth} 
    …… 
    9292Below is a very simple ring with a fixed triangular section. 
    9393 The section is defined by $3$~points $(6, -2)$, $(10, 0)$ 
    94 and $(6, 2)$ within the option \verb+section+ of \bs{psSolid}. 
     94and $(6, 2)$ within the option \Lkeyword{section} of \Lcs{psSolid}. 
    9595 
    9696\begin{LTXexample}[width=6cm] 

  • trunk/doc-en/par-annoterschema-en.tex

    r112 r113  
    11\section{Adding dimensions to the scenery} 
    22 
    3 It is very interesting to add  dimensions to the scenery. We take the example  
     3It is very interesting to add  \Index{dimensions} to the scenery. We take the example 
    44of the methane molecule, where we want to insert the distances and angles. 
    55 
    6 The first step consists of representing the molecule with its bonds and  
     6The first step consists of representing the molecule with its bonds and 
    77characteristic dimensions, and then draw it in a good looking way. 
    88 
    …… 
    9494\end{center} 
    9595 
    96 The construction of the molecule is detailed in the document  
     96The construction of the molecule is detailed in the document 
    9797\texttt{molecules.tex}. To add a dimensioning you only need to find 
    9898the vertices of the tetrahedron: 

  • trunk/doc-en/par-axes3D-en.tex

    r112 r113  
    1 \section{The axes in 3d} 
     1\section{The \Index{axes} in 3d} 
    22 
    33The command \verb+\axesIIID[options](x1,y1,z1)(x2,y2,z2)+ draws the axes $Ox$, 
    …… 
    99\begin{itemize} 
    1010    \item all colour options, line width as well as all types of arrows. 
    11     \item \verb+labelsep=length+ which allows you to position the label in a self defined distance away from the extremity of the arrow of the axis, the default value is \verb+labelsep=5pt+---this is a real distance in three dimensions and not on screen. 
     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. 
    1212    \item the choice of the labels on each of the axes with the option: \\ 
    13     \verb+axisnames={a,b,c}+, the default values are \verb+axisnames={x,y,z}+. 
     13    \texttt{\Lkeyword{axisnames}={a,b,c}}, the default values are \texttt{\Lkeyword{axisnames}={x,y,z}}. 
    1414    \item the potential to specify the style of the labels with the option: \\ 
    15     \verb+axisemph={\boldmath\Large\color{red}}+. By default there is no style predefined, which means, if no style is chosen one will get \verb+$x$,$y$,$z$+. 
    16     \item \verb+showOrigin+ is a Boolean, \texttt{true}---by default. If it is set to \verb+showOrigin=false+ the dashed lines aren't drawn to the origin anymore. 
    17     \item \verb+mathLabel+ is a Boolean, \texttt{true}---by default, in which case the math mode is activated. Set to \verb+mathLabel=false+ the labels are set in text mode. 
     15    \texttt{\Lkeyword{axisemph}=}\verb+\boldmath\Large\color{red}+. By default there is no style predefined, which means, if no style is chosen one will get \verb+$x$,$y$,$z$+. 
     16    \item \Lkeyword{showOrigin} is a Boolean, \texttt{true}---by default. If it is set to \texttt{\Lkeyword{showOrigin}=false} the dashed lines aren't drawn to the origin anymore. 
     17    \item \Lkeyword{mathLabel} is a Boolean, \texttt{true}---by default, in which case the math mode is activated. Set to \texttt{\Lkeyword{mathLabel}=false} the labels are set in text mode. 
    1818\end{itemize} 
    19 \encadre{The labels are placed at the extemities of the axes.} 
     19\encadre{The \Index{labels} are placed at the extemities of the axes.} 
    2020 
    2121\begin{LTXexample}[width=5cm] 

  • trunk/doc-en/par-chanfrein-en.tex

    r112 r113  
    1 \section{Chamfering a solid} 
     1\section{\Index{Chamfering} a solid} 
    22 
    33\psset{lightsrc=10 0 10,viewpoint=50 -20 30 rtp2xyz,Decran=50} 
    …… 
    2323\end{LTXexample} 
    2424 
    25 The option \verb+chanfrein+ allows us to chamfer a solid. This option 
    26 uses the key \verb+chanfreincoeff+ (value $0.8$ by default) which indicates the 
     25The option \Lkeyword{chanfrein} allows us to \Index{chamfer} a solid. This option 
     26uses the key \Lkeyword{chanfreincoeff} (value $0.8$ by default) which indicates the 
    2727ratio $k$ with ($0<k<1$). This ratio is the one of a centre dilation with 
    2828the centre in the middle of the chosen face. 

  • trunk/doc-en/par-codejps-en.tex

    r112 r113  
    1 \section{The code jps} 
     1\section{The \Index{jps code}} 
    22 
    33\textit{jps code} contains all the  PostScript code that is used by the library 
    …… 
    2424 
    2525In all of the $3$~examples below, the number of points is declared by the global 
    26 variable \verb+resolution+. 
     26variable \Lkeyword{resolution}. 
    2727 
    28 In other words, with the function $F$ named above and a fixed resolution of 36, the \textit{jps code} 
     28In other words, with the \Index{function} $F$ named above and a fixed resolution of 36, the \textit{jps code} 
    2929\begin{verbatim} 
    3030   0 360 {F} CourbeR2+ 

  • trunk/doc-en/par-colorierfacettes-en.tex

    r112 r113  
    1 \section{Colouring some single faces} 
     1\section{\Index{Colouring} some single faces} 
    22 
    3 The key value \texttt{[fcol=}% 
    4    $i_0$~\verb+(+$c_0$\verb+)+~% 
    5    $i_1$~\verb+(+$c_1$\verb+)+~% 
    6    \dots 
    7    $i_n$~\verb+(+$c_n$\verb+)+~% 
    8    \texttt{]}, 
    9 where $i_k$ are integers and $c_k$ the names of the colours, permits to  
    10 specify a colour for special faces. 
    11 To the face with the index $i_k$ corresponds the colour $c_k$. The  
     3The key value \texttt{\Lkeyword{fcol}=$i_0$~($c_0$) $i_1$~($c_1$) \dots $i_n$~($c_n$)}, 
     4where $i_k$ are integers and $c_k$ the names of the colours, permits to 
     5specify a \Index{colour} for special \Index{faces}. 
     6To the face with the index $i_k$ corresponds the colour $c_k$. The 
    127integer $n$ must be lower than the maximum of the number of faces of the chosen solid. 
    138 
    …… 
    9893must be lower than 68! 
    9994 
    100 However users can define their own colours. There are two methods: 
     95However users can define their own \Index{colours}. There are two methods: 
    10196 
    10297\begin{itemize} 
    103 \item They can use one of the $4$~optional arguments  \texttt{[color1]}, 
    104   \texttt{[color2]}, \texttt{[color3]}, \texttt{[color4]} from 
    105   \verb+\psSolid+, then transmit to \verb+fcol+ a pair of the type 
     98\item They can use one of the $4$~optional arguments  \texttt{color1}, 
     99  \texttt{color2}, \texttt{color3}, \texttt{color4} from 
     100  \Lcs{psSolid}, then transmit to \Lkeyword{fcol} a pair of the type 
    106101  $i$~\verb+(color1)+, where $i$ is the index of the chosen face. The 
    107   arguments \texttt{[color1]}, etc.  are used in the same way as the  
    108   arguments from \texttt{color} and \texttt{incolor}.\hfill \break 
     102  arguments \texttt{color1}, etc.  are used in the same way as the 
     103  arguments from \Lkeyword{color} and \Lkeyword{incolor}.\hfill \break 
    109104  A possible command could be the following: 
    110105  \begin{verbatim} 
    …… 
    113108\item They define their own colour names with the command 
    114109  \verb+\pstVerb+, and then use these names with the argument 
    115   \verb+[fcol]+. For example: 
     110  \Lkeyword{fcol}. For example: 
    116111\begin{verbatim} 
    117112\pstVerb{/hetre {0.764 0.6 0.204 setrgbcolor} def 
    …… 
    176171\pstVerb{/iface 0 store}% 
    177172\psSolid[ 
    178 fcol=48 {iface (Black)  
    179   iface 1 add (LimeGreen)  
    180   iface 2 add (Yellow) /iface  
     173fcol=48 {iface (Black) 
     174  iface 1 add (LimeGreen) 
     175  iface 2 add (Yellow) /iface 
    181176  iface 3 add store} repeat, 
    182177  r1=4,r0=1, 
    …… 
    188183\end{center} 
    189184 
    190 When the option \verb+hue+ is activated, the faces of the solid are coloured with the nuance of the rainbow colours. 
     185When the option \Lkeyword{hue} is activated, the faces of the solid are coloured with the nuance of the rainbow colours. 
    191186 
    192187\begin{LTXexample}[width=5.9cm] 

  • trunk/doc-en/par-commandestrace-en.tex

    r112 r113  
    11\section{Commands for drawing} 
    22 
    3 The parameter for drawing comes with the key value \verb+action=+ within the command 
    4 \bs{psSolid}. 
     3The parameter for \Index{drawing} comes with the key value \Lkeyword{action} within the command 
     4\Lcs{psSolid}. 
    55 
    66Four values are possible: 
    77\begin{itemize} 
    8 \item \verb+none+: nothing is drawn. 
    9 \item\verb+draw+: draws the solid as a framework and sets up dashed lines for the hidden edges. 
    10 \item\verb+draw*+: draws the solid with dashed lines for the hidden edges and colours the visible faces. 
    11 \item\verb+draw**+: draws the solid with a painting algorithm, without the 
    12     hidden edges and with coloration of the visible faces. 
     8\item \Lkeyval{none}: nothing is drawn. 
     9\item \Lkeyval{draw}: draws the solid as a framework and sets up dashed lines for the hidden edges. 
     10\item \Lkeyval{draw*}: draws the solid with dashed lines for the hidden edges and colours the visible faces. 
     11\item \Lkeyword{draw**}: draws the solid with a painting algorithm, without the 
     12    hidden edges and with colouration of the visible faces. 
    1313\end{itemize} 
    14 \encadre{The key values \texttt{draw} and \texttt{draw*} only make sense for convex solids.} 
     14\encadre{The key values \Lkeyval{draw} and \Lkeyword{draw*} only make sense for convex solids.} 
    1515 
    1616\begin{center} 

  • trunk/doc-en/par-couleurs-en.tex

    r112 r113  
    11\section{Colours and the nuances of a colour} 
    22 
    3 The key value \verb+[fillcolor=name]+ allows us to specify the wanted colour for the outer faces of a solid. 
    4 The key value \verb+[incolor=name]+ allows us to specify the wanted colour for the inner faces of a solid. 
     3The key word \texttt{\Lkeyword{fillcolor}=colourname} allows us to specify the wanted colour for the outer faces of a solid. 
     4The key word \texttt{\texttt{\Lkeyword{incolor}=colourname}} allows us to specify the wanted colour for the inner faces of a solid. 
    55 
    66The possible values for \textit{name} are those known to PSTricks (and particularly those of the package \texttt{xcolor}). 
    77 
    88We can directly use the colour nuances in the color schemes of 
    9 HSB, RGB or CMYK. In that case we use the key values \verb+[hue]+, 
    10 \verb+[inhue]+ or \verb+[inouthue]+ for the outer faces, the inner faces, or for all the faces. 
    11 The number of arguments \verb+hue+ determines nuances. 
    12  
    13 \subsection{Predefined colours by the option [\texttt{dvipsnames}]} 
    14  
    15 There are $68$~predefined colours, which are identified by 
     9HSB, RGB or CMYK. In that case we use the key values \Lkeyval{hue}, 
     10\Lkeyval{inhue} or \Lkeyval{inouthue} for the outer faces, the inner faces, or for all the faces. 
     11The number of arguments \Lkeyval{hue} determines nuances. 
     12 
     13\subsection{Predefined \Index{colours} by the option \texttt{dvipsnames}} 
     14 
     15There are $68$~predefined \Index{colours}, which are identified by 
    1616\texttt{solides.pro}: \texttt{Black}, \texttt{White}, and the 
    1717$66$~colours below. 
    …… 
    113113\egroup 
    114114 
    115 \subsection {Predefined colours by the option [\texttt{svgnames}]} 
    116  
    117 The following colours are known by PSTricks, when the option [\texttt{svgnames}] is given. 
    118 These ones are not identified by the file \texttt{solides.pro}: we can use them directly with the option \texttt{[fcol]}. 
     115\subsection{Predefined \Index{colours} by the option \texttt{svgnames}} 
     116 
     117The following colours are known by PSTricks, when the option \texttt{svgnames} is given. 
     118These ones are not identified by the file \texttt{solides.pro}: we can use them directly with the option \Lkeyword{fcol}. 
    119119 
    120120\bgroup 
    …… 
    317317\egroup 
    318318 
    319 \subsection{Nuances in the colour scheme of HSB, saturation and maximum brilliance} 
    320  
    321 There are 2 key values: \verb+[hue=+$h_0$ $h_1$\verb+]+ where 
     319\subsection{Nuances in the \Index{colour scheme} of \Index{HSB}, \Index{saturation} and maximum \Index{brilliance}} 
     320 
     321There are 2 key values: \texttt{\Lkeyword{hue}=$h_0$ $h_1$} where 
    322322the numbers $h_0$ and $h_1$ with $0\leq h_0 < h_1 \leq 1$ 
    323323respect the limits of the colour scheme of HSB. 
    …… 
    363363 
    364364 
    365 \subsection{Nuances in the colour scheme of HSB, saturation and fixed brilliance} 
    366  
    367 There are 4 key values: \verb+[hue=+$h_0$ $h_1$ $s$ $b$\verb+]+ or 
     365\subsection{Nuances in the \Index{colour scheme} of \Index{HSB}, \Index{saturation} and fixed \Index{brilliance}} 
     366 
     367There are 4 key values: \texttt{\Lkeyword{hue}=$h_0$ $h_1$ $s$ $b$} or 
    368368the numbers $h_0$ and $h_1$ with $0\leq h_0 < h_1 \leq 1$ 
    369369respect the limits of the colour scheme HSB and $s$ 
    …… 
    395395\end{LTXexample} 
    396396 
    397 \subsection{Nuances in the colour scheme of HSB, gneral case} 
    398  
    399 There are 7 key values: \verb+[hue=+$h_0$ $s_0$ $b_0$ $h_1$ $s_1$ 
    400 $b_1$\verb+ (hsb)]+ or the numbers $h_i$, $s_i$ and $b_i$ respecting the limits of the parameters of HSB. 
     397\subsection{Nuances in the \Index{colour scheme} of \Index{HSB}, gneral case} 
     398 
     399There are 7 key values: \texttt{\Lkeyword{hue}=$h_0$ $s_0$ $b_0$ $h_1$ $s_1$ 
     400$b_1$ (hsb)} or the numbers $h_i$, $s_i$ and $b_i$ respecting the limits of the parameters of HSB. 
    401401 
    402402 
    …… 
    413413\end{LTXexample} 
    414414 
    415 \subsection{Nuances in the colour scheme of RGB} 
    416  
    417 There are 6 key values: \verb+[hue=+$r_0$ $g_0$ $b_0$ $r_1$ $g_1$ 
    418 $b_1$\verb+]+ or the numbers $r_i$, $g_i$ and $b_i$ respecting the limits of the $3$ parameters of RGB. 
     415\subsection{Nuances in the \Index{colour scheme} of \Index{RGB}} 
     416 
     417There are 6 key values: \texttt{\Lkeyword{hue}=$r_0$ $g_0$ $b_0$ $r_1$ $g_1$ 
     418$b_1$} or the numbers $r_i$, $g_i$ and $b_i$ respecting the limits of the $3$ parameters of RGB. 
    419419 
    420420 
    …… 
    432432 
    433433 
    434 \subsection{Nuances in the colour scheme of CMYK} 
    435  
    436 There are 8 key values: \verb+[hue=+$c_0$ $m_0$ $y_0$ $k_0$ $c_1$ $m_1$ 
    437 $y_1$ $k_1$\verb+]+ or the numbers $c_i$, $m_i$, $y_i$ and $k_i$ respecting the limits of the $4$ parameters of CMYK. 
     434\subsection{Nuances in the \Index{colour scheme} of \Index{CMYK}} 
     435 
     436There are 8 key values: \texttt{\Lkeyword{hue}=$c_0$ $m_0$ $y_0$ $k_0$ $c_1$ $m_1$ 
     437$y_1$ $k_1$} or the numbers $c_i$, $m_i$, $y_i$ and $k_i$ respecting the limits of the $4$ parameters of CMYK. 
    438438 
    439439 
    …… 
    453453 
    454454There are 2 key values 
    455 \verb+[hue=(color1) (color2)]+ where 
     455\texttt{\Lkeyword{hue}=(color1) (color2)} where 
    456456\texttt{color1} and \texttt{color2} are the names of colours known by \verb+solides.pro+. 
    457457 
    …… 
    470470 
    471471If we like to use some defined colours of \texttt{xcolor}, we use the 
    472 key values \texttt{color1}, \texttt{color2}, etc. from \bs{psSolid}. 
     472key values \texttt{color1}, \texttt{color2}, etc. from \Lcs{psSolid}. 
    473473 
    474474\psset{viewpoint=50 50 20 rtp2xyz,Decran=30} 
    …… 
    493493 
    494494To deactivate the colour application we use the option 
    495 \verb+[deactivatecolor]+. 
     495\Lkeyword{deactivatecolor}. 
    496496 
    497497\endinput 

  • trunk/doc-en/par-courbeR3-en.tex

    r112 r113  
    1 \section[Lines of functions from R in R\textsuperscript{3}]% 
    2 {Lines of functions from $\mathbb{R}$ in $\mathbb{R}^3$} %$ 
     1\section[Curves of functions from R in R\textsuperscript{3}]% 
     2{Curves of functions from $\mathbb{R}$ in $\mathbb{R}^3$} %$ 
    33 
    44%% \section{Fonctions R --> R\textsuperscript{3}} 
    55 
    6 The line of a defined function calls the object \verb+courbe+ and the option \verb+function+. 
     6The line of a defined \Index{function} calls the object \Lkeyval{courbe} and the option \Lkeyword{function}. 
    77We can realize a helix in algebraic notation with the function: 
    88 

  • trunk/doc-en/par-cylindres-cones-en.tex

    r112 r113  
    11\section{Generalization of the notion of a cylinder and a cone} 
    22 
    3 \subsection{Cylinder or cylindric area} 
    4  
    5 This paragraph generalizes the  notion of a cylinder, or a cylindric  
     3\subsection{Cylinder or \Index{cylindric area}} 
     4 
     5This paragraph generalizes the  notion of a cylinder, or a cylindric 
    66area\footnote{This was written by 
    7 Maxime \textsc{Chupin}, as a result of a question on the list  
    8 \url{http://melusine.eu.org/cgi-bin/mailman/listinfo/syracuse}}.  
    9 A \textit{routing} curve has to be defined by a function and the  
    10 direction of the \textit{cylinder} axis needs to be arranged. In  
     7Maxime \textsc{Chupin}, as a result of a question on the list 
     8\url{http://melusine.eu.org/cgi-bin/mailman/listinfo/syracuse}}. 
     9A \textit{routing} curve has to be defined by a function and the 
     10direction of the \textit{cylinder} axis needs to be arranged. In 
    1111the example below the routing curve is sinusoidal, situated in the plane $z=-2$: 
    1212\begin{verbatim} 
    1313\defFunction[algebraic]{G1}(t){t}{2*sin(t)}{-2} 
    1414\end{verbatim} 
    15 The direction of the cylinder is defined by the components of a vector   
    16 \verb+[axe=0 1 1]+. The drawing calls  \verb+[object=cylindre]+ which  
    17 in addition to the usual parameters---which is the height \verb+[h=4]+--- 
    18 is about the \textbf{length of the generator} and not of the distance  
    19 between the two base planes, and needs to define the routing curve  
    20 \verb+[function=G1]+ and the interval of the variable $t$ \verb+[range=-3 3]+. 
     15The direction of the cylinder is defined by the components of a vector 
     16\texttt{\Lkeyword{axe}=0 1 1}. The drawing calls  \texttt{\Lkeyword{object}=\Lkeyval{cylindre}} which 
     17in addition to the usual parameters---which is the height \texttt{\Lkeyword{h}=4}--- 
     18is about the \textbf{length of the generator} and not of the distance 
     19between the two base planes, and needs to define the routing curve 
     20\texttt{\Lkeyword{function}=G1} and the interval of the variable $t$ \texttt{\Lkeyword{range}=-3 3}. 
    2121 
    2222\begin{verbatim} 
    …… 
    7373\end{center} 
    7474 
    75 In the following example, before drawing the horizontal planes, we calculate the  
     75In the following example, before drawing the horizontal planes, we calculate the 
    7676distance between these two planes. 
    7777 
    …… 
    181181\end{LTXexample} 
    182182 
    183 \subsection{Cone or conic area} 
    184 This paragraph generalizes the  notion of a cone, or a conic  
     183\subsection{Cone or \Index{conic area}} 
     184This paragraph generalizes the  notion of a cone, or a conic 
    185185area\footnote{This was written by 
    186 Maxime \textsc{Chupin}, as the result of a question on the list  
    187 \url{http://melusine.eu.org/cgi-bin/mailman/listinfo/syracuse}}.  
    188 A \textit{routing} curve needs to be defined by a function which  
    189 defines the base of the cone, and the vertex of the \textit{cone}  
    190 which is by default \verb+[origine=0 0 0]+.  The parts above and  
    191 below the cone are symmetric concerning the vertice.  In the example  
     186Maxime \textsc{Chupin}, as the result of a question on the list 
     187\url{http://melusine.eu.org/cgi-bin/mailman/listinfo/syracuse}}. 
     188A \textit{routing} curve needs to be defined by a function which 
     189defines the base of the cone, and the vertex of the \textit{cone} 
     190which is by default \texttt{\Lkeyword{origine}=0 0 0}.  The parts above and 
     191below the cone are symmetric concerning the vertice.  In the example 
    192192below, the routing curve is a parabolic arc, situated in the plane $z=-2$. 
    193193 
    …… 
    268268\end{LTXexample} 
    269269 
    270 \encadre{For the cones as well, the routing curve can be any curve and need not necessarily  
    271 be a plane horizontal curve, as the following example, written by Maxime  
     270\encadre{For the cones as well, the routing curve can be any curve and need not necessarily 
     271be a plane horizontal curve, as the following example, written by Maxime 
    272272\textsc{Chupin}, will show.} 
    273273 

  • trunk/doc-en/par-datfile-en.tex

    r112 r113  
    3636 
    3737 
    38 \subsection{\texttt{.dat} files (specific to \texttt{pst-solides3d})} 
     38\subsection{\texttt{\Index{.dat}} files (specific to \texttt{pst-solides3d})} 
    3939 
    4040In \texttt{pst-solides3d}, the data structure used for a solid has 4 fields. 
    …… 
    4545\subsubsection{Writing \texttt{.dat} files} 
    4646 
    47 One uses the action \verb+writesolid+ within \bs{psSolid}, and one 
    48 uses the option \verb+file+ to specify the name of the file. 
     47One uses the action \Lkeyword{writesolid} within \Lcs{psSolid}, and one 
     48uses the option \Lkeyword{file} to specify the name of the file. 
    4949 
    5050For example, let's look at the code below: 
    …… 
    7272\subsubsection{Reading \texttt{.dat} files} 
    7373 
    74 We use the object \verb+datfile+ of \bs{psSolid}, with the argument 
    75 \verb+file+ to specify the name. 
     74We use the object \Lkeyword{datfile} of \Lcs{psSolid}, with the argument 
     75\Lkeyword{file} to specify the name. 
    7676Now the code 
    7777\begin{verbatim} 
    7878\psSolid[object=datfile, file=montore] 
    7979\end{verbatim} 
    80 will allow to use the object---now saved in the \texttt{.dat} files generated--- 
     80will allow us to use the object---now saved in the \texttt{.dat} files generated--- 
    8181as described in the previous paragraph. 
    8282 
    …… 
    9090the vertices and the faces. 
    9191 
    92 \subsubsection{Writing \texttt{.obj} files} 
     92\subsubsection{Writing \texttt{\Index{.obj}} files} 
    9393 
    94 One uses the action \verb+writeobj+ in \bs{psSolid}, and one uses 
    95 the option \verb+file+ to specify the name of the file. 
     94One uses the action \Lkeyword{writeobj} in \Lcs{psSolid}, and one uses 
     95the option \Lkeyword{file} to specify the name of the file. 
    9696 
    9797For example, the code below: 
    …… 
    106106\subsubsection{Reading \texttt{.obj} files} 
    107107 
    108 One uses the option \verb+objfile+ of \bs{psSolid}, with the argument 
    109 \verb+file+ to specify the name of the file. 
     108One uses the option \Lkeyword{objfile} of \Lcs{psSolid}, with the argument 
     109\Lkeyword{file} to specify the name of the file. 
    110110Now the following code 
    111111\begin{verbatim} 
    …… 
    135135vertices and the faces. 
    136136 
    137 \subsubsection{Writing \texttt{.off} files} 
     137\subsubsection{Writing \texttt{\Index{.off}} files} 
    138138 
    139 We use the action \verb+writeobj+ in \bs{psSolid}, and we use the option 
    140  \verb+file+ to specify the name of the file. 
     139We use the action \Lkeyword{writeobj} in \Lcs{psSolid}, and we use the option 
     140 \Lkeyword{file} to specify the name of the file. 
    141141 
    142142For example the code below: 
    …… 
    151151\subsubsection{Reading.off files} 
    152152 
    153 We use the option \verb+offfile+ of \bs{psSolid}, with the argument 
    154 \verb+file+ to specify the name of the file. 
     153We use the option \Lkeyword{offfile} of \Lcs{psSolid}, with the argument 
     154\Lkeyword{file} to specify the name of the file. 
    155155Now the following code 
    156156\begin{verbatim} 

  • trunk/doc-en/par-definirfonction-en.tex

    r112 r113  
    11\section{Defining a function} 
    22 
    3 It is possible to define functions usable in a PostScript environment. 
     3It is possible to define \Index{functions} usable in a PostScript environment. 
    44 
    55The domain can be  $\mathbb{R}$, $\mathbb{R}^2$ 

  • trunk/doc-en/par-definirplanquelconque-en.tex

    r112 r113  
    1 \section{Defining a projection plane} 
    2  
    3 The plane of projection is defined with the option 
    4 \texttt{[plan=plantype]} which expects an argument \textit{type of 
     1\section{Defining a \Index{projection plane}} 
     2 
     3The \Index{plane} of projection is defined with the option 
     4\texttt{\Lkeyword{plan}=plantype} which expects an argument \textit{type of 
    55plane}. The creation of such an argument invariably happens 
    66through the command \verb+\psSolid[object=plan]+ (see the relevant 
    …… 
    1313To define a plane of projection, we assume that the drawing to be 
    1414projected resides on the plane $Oxy$, and the user has to specify 
    15 the images of the origin $O$ and the basis $\overrightarrow{\imath}$,  
     15the images of the origin $O$ and the basis $\overrightarrow{\imath}$, 
    1616$\overrightarrow{\jmath}$, and $\overrightarrow{k}$. 
    1717If they wish to abbreviate the syntax, users are required at most 
    …… 
    5151There are four ways to define a normal to a plane, two of which 
    5252have an option to rotate the coordinate system of the plane around 
    53 that normal: \texttt{|normal=...]} 
     53that normal: \Lkeyword{normal} 
    5454 
    5555\subsubsection{Method 1: giving the components of the normal vector} 
    5656 
    5757 
    58 In this case \texttt{[normal=nx ny nz]}, the argument consists of 
     58In this case \texttt{\Lkeyword{normal}=nx ny nz}, the argument consists of 
    59593 values: the components of the normal vector. For example 
    60 \texttt{[normal=0 0 1]} for the plane $Oxy$. 
     60\texttt{\Lkeyword{normal}=0 0 1} for the plane $Oxy$. 
    6161 
    6262\newpage 
    …… 
    326326of rotation} 
    327327 
    328 In this case \texttt{[normal=nx ny nz A]}, the argument takes four 
     328In this case \texttt{\Lkeyword{normal}=nx ny nz A}, the argument takes four 
    329329values: the components of the normal vector and the angle of 
    330330rotation (in degrees) around that axis. 
    …… 
    429429 and \textit{k}} 
    430430 
    431 In this case \texttt{[normal=ix iy iz kx ky kz]}, the argument 
     431In this case \texttt{\Lkeyword{normal}=ix iy iz kx ky kz}, the argument 
    432432takes six values: the components of the images of 
    433433$\overrightarrow{i}$ and $\overrightarrow{k}$, with: 
    …… 
    533533  \textit{i}, \textit{k} and an angle of rotation} 
    534534 
    535 In this case \texttt{[normal=ix iy iz kx ky kz phi]}, the argument 
     535In this case \texttt{\Lkeyword{normal}=ix iy iz kx ky kz phi}, the argument 
    536536takes seven values: the components of the images of 
    537537$\overrightarrow{i}$, $\overrightarrow{k}$ and the angle of 

  • trunk/doc-en/par-definitionmaillage-en.tex

    r112 r113  
    11\section{Definition of grating} 
    22 
    3 The user can specify the grating of the solid with the option 
    4 \Lkeyword{ngrid} within the command \Cadre{\Lcs{psSolid}}. 
     3The user can specify the \Index{grating} of the solid with the option 
     4\Lkeyword{ngrid} within the command \Lcs{psSolid}. 
    55 
    66For the objects 
    …… 
    88\Lkeyval{prisme}, 
    99\Lkeyval{prismecreux}, 
    10 the syntax is \Lkeyword{ngrid}=$n_1$ where $n_1$ represents the number of vertical gridlines. 
     10the syntax is \Lkeyword{ngrid}=$n_1$ where $n_1$ represents the number of vertical \Index{gridlines}. 
    1111 
    1212For the objects 
    …… 
    1818\Lkeyval{troncconecreux}, 
    1919%%\verb+tore+, 
    20 the syntax is \Lkeyword{ngrid}=$n_1$~$n_2$ where $n_1$ is an integer greater or equal 
     20the syntax is \texttt{\Lkeyword{ngrid}=$n_1$~$n_2$} where $n_1$ is an integer greater or equal 
    2121to  1 ($2$ for \Lkeyval{tore}) representing the number of the vertical gridlines, and $n_2$ is an integer 
    2222representing the number of divisions on the circle. 
    2323 
    2424For the object 
    25 \verb+sphere+, 
    26 the syntax is \texttt{[ngrid=}$n_1$~$n_2$\texttt{]} where $n_1$ is an integer, representing the number of divisions on the vertical axis, and 
     25\Lkeyval{sphere}, 
     26the syntax is \texttt{\Lkeyword{ngrid}=$n_1$~$n_2$} where $n_1$ is an integer, representing the number of divisions on the vertical axis, and 
    2727$n_2$ is an integer representing the number of divisions on the circle 
    2828horizontally. 
    2929 
    3030For the object 
    31 \verb+tore+, 
    32 the syntax is \texttt{[ngrid=}$n_1$~$n_2$\texttt{]} where $n_1$ and $n_2$ 
     31\Lkeyval{tore}, 
     32the syntax is \texttt{\Lkeyword{ngrid}=$n_1$~$n_2$} where $n_1$ and $n_2$ 
    3333are integers. 
    3434 
    &hellip