1 files changed, 142 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/generic/pst-solides3d/doc-en/source/par-new-en.tex b/Master/texmf-dist/doc/generic/pst-solides3d/doc-en/source/par-new-en.tex
new file mode 100644
index 00000000000..8765449b7a2
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/pst-solides3d/doc-en/source/par-new-en.tex
@@ -0,0 +1,142 @@
+\section{Construction from scratch}
+
+The object \Lkeyword{new} constructs a solid.  Two parameters are used: \Lkeyword{sommets}
+which indicates the list of coordinates of the different vertices, and \Lkeyword{faces} which
+gives the list of faces of the solid; a face is characterized by a list of the indices of its\Index{vertices}, listed
+in counterclockwise order
+when the face is viewed from the exterior of the solid.
+
+\clearpage
+
+\subsection{Example 1: a house}
+\begin{LTXexample}[width=6.5cm]
+\psset{unit=0.5}
+\psset{lightsrc=10 -20 50,viewpoint=50 -20 30 rtp2xyz,Decran=50}
+\begin{pspicture*}(-7,-4)(7,7)
+\psSolid[object=new,
+  sommets=
+    2  4  3   -2  4  3  -2 -4  3   2 -4  3
+    2  4  0   -2  4  0  -2 -4  0   2 -4  0
+   0  4  5   0 -4  5,
+  faces={
+  [0 1 2 3] [7 6 5 4] [0 3 7 4]
+  [3 9 2]   [1 8 0]   [8 9 3 0]
+  [9 8 1 2] [6 7 3 2] [2 1 5 6]},
+  num=all,show=all,action=draw]
+\end{pspicture*}
+\end{LTXexample}
+
+Note that the solid \Lkeyword{new} uses the same options as the other solids.
+For example, we give the same solid as above below, using the parameters
+\Lkeyword{hollow}, \Lkeyword{incolor}, \Lkeyword{fillcolor}, and \Lkeyword{rm}.
+
+%% example 2
+\begin{LTXexample}[width=6.5cm]
+\psset{unit=0.5}
+\psset{lightsrc=10 -20 50,viewpoint=50 -20 30 rtp2xyz,Decran=50}
+\begin{pspicture*}(-7,-3.5)(7,7.5)
+\psSolid[object=new,fillcolor=red!50,incolor=yellow,
+  action=draw**,hollow,rm=2,
+  sommets=
+   2  4  3  -2  4  3  -2 -4  3   2 -4  3
+   2  4  0  -2  4  0  -2 -4  0   2 -4  0
+   0  4  5   0 -4  5,
+  faces={   [0 1 2 3][7 6 5 4][0 3 7 4]
+   [3 9 2]  [1 8 0]  [8 9 3 0][9 8 1 2]
+   [6 7 3 2][2 1 5 6]},
+  num=all,show=all]
+\end{pspicture*}
+\end{LTXexample}
+
+\subsection{Example 2: a \Index{hyperboloid} with a fixed radius}
+
+%\psset{lightsrc=10 20 30,SphericalCoor=true,viewpoint=50 20 30}
+%\psset{SphericalCoor=true,viewpoint=50 20 30}
+
+
+As always, the options of the macro \Lcs{psSolid} can handle Postscript code, even \textit{jps code}
+
+Unlike an example in pure PostScript, where we use the parameters
+$a$, $b$ and $h$ which are transmitted by the options of PSTricks.
+In this way one obtains a variable solid constructed from scratch.
+
+Remark: the code being used comes from a \textit{jps} source used in practice, as in:
+
+\noindent\url{http://melusine.eu.org/lab/bjps/solide/tour.jps}
+\begin{LTXexample}[width=6.5cm]
+\psset{unit=0.75}
+\psset{lightsrc=10 -20 50,viewpoint=50 -20 30 rtp2xyz,Decran=50}
+\begin{pspicture*}(-5,-5)(3,5)
+\psSolid[object=new,fillcolor=red!50,incolor=yellow,
+  hollow, a=10, %% nb d'etages
+  b=20, %% diviseur de 360, nb de meridiens
+  h=8,  %% hauteur
+  action=draw**,sommets=
+   /z0 h neg 2 div def
+   a -1 0 {
+    /k exch def
+    0 1 b 1 sub {
+     /i exch def
+     /r z0 h a div k mul add dup mul 4 div 1 add sqrt def
+     360 b idiv i mul cos r mul 360 b idiv i mul sin r mul
+     z0 h a div k mul add
+    } for
+   } for,
+   faces={
+    0 1 a 1 sub {
+    /k exch def
+    k b mul 1 add 1 k 1 add b mul 1 sub {
+    /i exch def
+    [i i 1 sub b i add 1 sub b i add]
+   } for
+   [k b mul k 1 add b mul 1 sub k 2 add b mul 1 sub k 1 add b mul]
+  } for
+}]
+\end{pspicture*}
+\end{LTXexample}
+
+
+
+\subsection{Example 3: importing external files}
+
+
+From a file describing a solid in a particular format (other than \texttt{\Index{.obj}} or \texttt{\Index{.off}}),
+we can create a \texttt{\Index{.dat}} file containing the coordinates of the vertices,
+and another \texttt{.dat} file containing the tables of indices of the vertices on each face.
+These files can then be entered as parameters \Lkeyword{sommets} and \Lkeyword{faces}
+when using the PostScript instruction \Lkeyword{run}.
+
+
+In the example below, the files \verb+sommets_nefer.dat+
+and \verb+faces_nefer.dat+ have been placed in the directory of the compiler.
+
+\begin{LTXexample}[width=5.5cm]
+\psset{unit=0.4}
+\definecolor{AntiqueWhite}{rgb}{0.98,0.92,0.84}
+\begin{pspicture}(-7,-9)(7,7)
+\psset{lightsrc=30 -40 10}
+\psset{viewpoint=50 -50 20 rtp2xyz,Decran=50}
+\psset{RotX=90,sommets= (sommets_nefer.dat) run}
+\psSolid[object=new,fillcolor=AntiqueWhite,linewidth=0.5\pslinewidth,
+    faces={(faces_nefer.dat) run}]%
+\psSolid[object=new,fillcolor=red,linewidth=0.5\pslinewidth,
+    faces={(faces_nefer_levres.dat) run}]%
+\psSolid[object=new,fillcolor=black,
+    faces={(faces_nefer_sourcils.dat) run}]%
+\end{pspicture}
+\hfill
+\begin{pspicture}(-7,-9)(7,7)
+\psset{lightsrc=-10 -40 -5,lightintensity=.5}
+\psset{viewpoint=50 -80 10 rtp2xyz,Decran=50}
+\psset{RotX=90,RotZ=30,sommets= (sommets_nefer.dat) run}
+\psSolid[object=new,fillcolor=AntiqueWhite,linewidth=0.5\pslinewidth,
+  grid,faces={(faces_nefer.dat) run}]
+\psSolid[object=new,fillcolor=red,linewidth=0.5\pslinewidth,grid,
+    faces={(faces_nefer_levres.dat) run}]
+\psSolid[object=new,fillcolor=black,
+    faces={(faces_nefer_sourcils.dat) run}]
+\end{pspicture}
+\end{LTXexample}
+
+
+\endinput