%\RequirePackage{pdfmanagement-testphase}

%\RequirePackage{pdfmanagement-testphase}
%\DeclareDocumentMetadata{}

\listfiles % Writes out the package versions in the log file
\documentclass[%
11pt, % normal font size (default, alias for fontsize=11pt)
bibtotoc, % add unnumbered entry for the bibliography to the table
% of contents (deprecated, use: toc=bibliography or
% bibliography=totoc)
parskip=half-, % use one base line vertical inter-paragraph space and
% at least 1 em horizontal space at the end of paragraphs
% instead of indenting first line of paragraphs
twoside, % use twosided layout (default)
smallheadings, % use smaller font sizes for headings (but at least
% \normalsize) with less vertical above and below headings
% (deprecated, use: headings=small)
1.1headlines, % set head height to 1.1\baselineskip of \normalsize
% (deprecated, use: headlines=1.1)
french,english,
usegeometry,
]{scrbook}

%\graphicspath{{images/}}
\usepackage[T1]{fontenc}
\usepackage[scale=0.95]{tgpagella}
\usepackage[scale=0.92]{tgheros}
\usepackage[scaled=0.83]{beramono}
\usepackage{amsmath,amssymb} % allows multiple maths-environments
%\usepackage{libertinus}
%\usepackage[scaled=0.9]{beramono}
\usepackage[a4paper,hmargin=2cm,vmargin=3cm]{geometry} % Flexible and complete interface to document dimensions
\usepackage{scrlayer-scrpage}
\pagestyle{scrheadings}

\usepackage{babel}
\usepackage{makeidx}
\makeindex
%\usepackage{lscape}

\usepackage{biblatex}
\addbibresource{pst-solides3d-doc.bib}

%\usepackage{arev}
%\usepackage{manfnt}
%\usepackage[garamond]{mathdesign}
%\renewcommand{\ttdefault}{lmtt}

\usepackage{multicol} % Intermix single and multiple columns
\usepackage{longtable} % Allows tables to flow over page boundaries
\usepackage{array} % Extending the array and tabular environments
\usepackage{arrayjob} % Management of arrays
\usepackage{url} % Verbatim with URL-sensitive line breaks
\usepackage{framed} % Framed or shaded regions that can break across pages
\usepackage{ragged2e}
\usepackage{paralist}

%%%%%%%
%%%%%%% Loading the necessary graphic packages
\usepackage[dvipsnames,svgnames,x11names,prologue,table]{pstricks} % Loads 'PSTricks' and xcolor

%\usepackage{animate}
\usepackage{showexpl} % Typesetting LaTeX source code
\usepackage{pst-plot} % Macros for plotting functions and data records
\usepackage{pst-eucl} % The 'pst-eucl' package allow the drawing of Euclidean geometric
% figures using LaTeX macros for specifying mathematical constraints.
% It is thus possible to build point using common transformations or intersections.
% The use of coordinates is limited to points which controlled the figure.
\usepackage{pst-solides3d} % The package is designed to draw solids in 3D perspective.
\let\PSTfileversion\fileversion
\let\PSTfiledate\filedate
\usepackage{pstricks-add} % A collection of add-ons and bugfixes for PSTricks.
% Allows 'algebraic notation' instead of the PostScript
% native RPN (Revers Polish Notation).
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% Note: 'pstricks-add' always needs to be loaded last. %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\DeclareFixedFont{\timesnormal}{T1}{ptm}{m}{n}{2cm}
\raggedbottom
\makeatletter
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%% adapt\'{e} de \psRandom du package pstricks-add
%% pour rendre al\'{e}atoire la taille des \'{e}toiles
%% Manuel Luque
\newdimen\pssizeStar
\def\psset@sizeStar#1{\pssetlength\pssizeStar{#1}}
\psset@sizeStar{1pt}
\def\psRandomStar{\pst@object{psRandomStar}}%
\def\psRandomStar@i{\@ifnextchar({\psRandomStar@ii}{\psRandomStar@iii(0,0)(1,1)}}
\def\psRandomStar@ii(#1){\@ifnextchar({\psRandomStar@iii(#1)}{\psRandomStar@iii(0,0)(#1)}}
\def\psRandomStar@iii(#1)(#2)#3{%
\def\pst@tempA{#3}%
\ifx\pst@tempA\pst@empty\psclip{\psframe(#2)}\else\psclip{#3}\fi
\pst@getcoor{#1}\pst@tempA
\pst@getcoor{#2}\pst@tempB
\begin@SpecialObj
\addto@pscode{
\pst@tempA\space /yMin exch def
/xMin exch def
\pst@tempB\space /yMax exch def
/xMax exch def
/dy yMax yMin sub def
/dx xMax xMin sub def
rrand srand % initializes the random generator
/getRandReal { rand 2147483647 div } def
\psk@randomPoints {
/DS \pst@number\pssizeStar\space getRandReal mul def
\@nameuse{psds@\psk@dotstyle}
\ifPst@color getRandReal 1 1 sethsbcolor \fi
getRandReal dx mul xMin add
getRandReal dy mul yMin add
Dot
\ifx\psk@fillstyle\psfs@solid fill \fi stroke
} repeat
}%
\end@SpecialObj
\endpsclip
\ignorespaces
}

\renewcommand*\l@section{\bprot@dottedtocline{1}{1.5em}{2.5em}} % hv
\renewcommand*\l@subsection{\bprot@dottedtocline{2}{3.8em}{3.5em}}% hv

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%% macro H.Voss sur :
%%http://tug.org/mailman/htdig/pstricks/2007/004640.html

\def\GetCenter#1{ tx@NodeDict begin /N@#1 load GetCenter end
\pst@number\psyunit div /#1.y ED
\pst@number\psxunit div /#1.x ED }
\makeatother

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%% Jean-Michel Sarlat et Guillaume Connan
\newenvironment{gbar}{%
\def\FrameCommand{{\color{red}\vrule width 2pt}\colorbox{yellow!30}}%
\MakeFramed {\advance\hsize-\width \FrameRestore}}%
{\endMakeFramed}

%%%%%%% Highlight some expressions
\newcommand\Cadre[1]{\psframebox[fillstyle=solid,fillcolor=gray!20,linecolor=gray!20]{\texttt{#1}}}

%%%%%%%
%%%%%%% Box and highlight some notes
\newcommand\encadre[1]{
\psframebox[fillstyle=solid,fillcolor=gray!20,linecolor=gray!20]{
\begin{minipage}{\textwidth}
{\textbf{\textcolor{OrangeReddy}{Note:}}\qquad #1}
\end{minipage}}
}

%%%%%%%
%%%%%%% Highlight the table of the predefined solids
\newcommand\toptableau{%
\rowcolor{gray!20}
\textbf{Solid} & \begin{tabular}{c}
\textbf{Default}\\
\textbf{Parameters}
\end{tabular} &
\begin{minipage}{4cm}
\centerline{\textbf{View}}
\end{minipage}&
\begin{minipage}{4cm}
\centerline{\textbf{Code}}
\end{minipage}}
%%%%%%%
%%%%%%% Color array
\newarray\colors
\readarray{colors}{%
Apricot&Aquamarine&Bittersweet&Black&Blue&BlueGreen&BlueViolet&BrickRed&Brown&BurntOrange%
&CadetBlue&CarnationPink&Cerulean&CornflowerBlue&Cyan&Dandelion&DarkOrchid%
&Emerald&ForestGreen&Fuchsia&Goldenrod&Gray&Green&GreenYellow&JungleGreen%
&Lavender&LimeGreen&Magenta&Mahogany&Maroon&Melon&MidnightBlue&Mulberry%
&NavyBlue&OliveGreen&Orange&OrangeRed&Orchid&Peach&Periwinkle&PineGreen%
&Plum&ProcessBlue&Purple&RawSienna&Red&RedOrange&RedViolet&Rhodamine&RoyalBlue%
&RoyalPurple&RubineRed&Salmon&SeaGreen&Sepia&SkyBlue&SpringGreen&Tan&TealBlue%
&Thistle&Turquoise&Violet&VioletRed&White&WildStrawberry&Yellow&YellowGreen&YellowOrange}

\edef\colorfaces{}%
\multido{\i=0+1}{67}{%
\checkcolors(\i)
\xdef\colorfaces{\colorfaces\i\space(\cachedata)\space}}

\definecolor{bleuciel}{rgb}{0.78,0.84,0.99}
\definecolor{OrangeReddy}{rgb}{0.73,0.00,0.00}

%%%%%%%
%%%%%%% Highlight some commands with backslashes (the three macros)
\newcommand\bs[1]{%
\psframebox[fillstyle=solid,fillcolor=gray!20,
linecolor=gray!20]{\texttt{\textbackslash#1}}}

%%%%%%%
%%%%%%% Positioning the viewpoint
\def\PointEcran(#1,#2,#3)#4{% position of the viewpoint on the screen
\pstVerb{/xM #1 def /yM #2 def /zM #3 def
/kC dE dup mul xM xE mul yM yE mul zM zE mul add add sub
xV xE mul xM xE mul sub
yV yE mul yM yE mul sub add
zV zE mul zM zE mul sub add
div def
/x_E kC xV xM sub mul xM add def
/y_E kC yV yM sub mul yM add def
/z_E kC zV zM sub mul zM add def}%
\psPoint(x_E,y_E,z_E){#4}}

\def\datapath{data/}% ./data/
\def\inputpath{text/}% ..

\lstset{%
basicstyle=\ttfamily\footnotesize,
commentstyle=\color{PineGreen}\slshape\footnotesize,
showspaces=false,
showstringspaces=false,
breaklines=true,
backgroundcolor=\color{gray!20},
breakautoindent=true,
captionpos=t,
language=TeX,
emph={\begin,\codejps,\end},
emphstyle=\color{RoyalBlue},
emph={[2]pspicture},
emphstyle={[2]\color{OrangeReddy}},
numbersep=5pt,
preset=\centering,
rframe={}%
}

\usepackage[
% colors for the links
colorlinks=true, % color links
urlcolor=OrangeReddy, % color of URL links
filecolor=black, % color of file links
linkcolor=OrangeReddy, % color of links
% Links
%raiselinks=true, % raise up links (for HyperTeX backend)
% backref=page, % do bibliographical back refenrernces
% pagebackref=true, % back reference by page numbers
% verbose, % be chatty
% hyperindex=true, % set up hyperlink indices
linktocpage=true, % make page number, not text, be linked on TOC, LOF, LOT
% hyperfootnotes=false, % do not set up hyperlink footnotes
% Bookmarks
bookmarks=true, % Generating Bookmarks for the PDF-Viewer
% bookmarksopenlevel=1, % Level to which Bookmarks are opened
bookmarksopen=true, % Open up Bookmarks tree
% bookmarksnumbered=true, % Put section numbers in Bookmarks
%bookmarkstype=toc, % Specify which TOC file to mimic
% Anchors
% plainpages=false, % do not page number anchors as plain arabic
% pageanchor=true % put an anchor on every page
]{hyperref}

%%%%%%%
%%%%%%% PDF Informations
\hypersetup{%
pdftitle={pst-solides3d - The Documentation}, % Text for the PDF title field
pdfauthor={Jean-Paul Vignault, Manuel Luque, Arnaud Schmittbuhl, Herbert Voss;}, % Text for the PDF author field
pdfcreator={LaTeX, hyperref, KOMA-Script}, % Text for the PDF creator field
%pdfproducer={pdfeTeX 1.10b-2.1} % Text for the PDF producer field
pdfstartview=FitH, % Fits the width of the page to the window.
pdfpagemode=UseOutlines, % Show Bookmarks in the Viewer
pdfpagelabels=true % set PDF page labels
}
%\usepackage{breakurl} % Line-breakable \url-like links in hyperref when compiling via dvips/ps2pdf

%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Herbert %%%%%%%%%%%%%%%%%%%%%%%%%%
\pagestyle{scrheadings}
\ofoot{\pagemark}
\newcommand\Input[2][\inputpath]{\ifoot{{\footnotesize#2}}\input{#1#2}}
\def\Lcs#1{\texttt{\textbackslash#1}%
\index{#1@\texttt{\textbackslash#1}}%
\index{Macro!#1@\texttt{\textbackslash#1}}}
\def\Lenv#1{\texttt{#1}\index{#1@\texttt{#1}}\index{Environment!#1@\texttt{#1}}}
\def\Lkeyword#1{\texttt{#1}%
\index{#1@\texttt{#1}}\index{Keyword!#1@\texttt{#1}}}
\def\Lkeyval#1{\texttt{#1}%
\index{#1@\texttt{#1}}\index{Value!#1@\texttt{#1}}}
\def\Index#1{#1\index{#1}}

%%%%%%%
%%%%%%% Title Page
\title{\texttt{pst-solides3d}:\\
The Documentation -- The Basics
\\[0.5cm]
{\normalsize v. \PSTfileversion\ (\PSTfiledate)}\\[20pt]
%\includegraphics[scale=0.6]{images/kepler}
}
\author{Jean-Paul Vignault\thanks{\protect\url{<[email protected]>}}
\and Manuel Luque\thanks{\protect\url{<[email protected]>}}
\and Arnaud Schmittbuhl\thanks{\protect\url{<[email protected]>}}
\and Jürgen Gilg\thanks{\protect\url{<[email protected]>}}
\and Jean-Michel Sarlat\thanks{\protect\url{<[email protected]>}}
\and Herbert Voß\thanks{\protect\url{<[email protected]>}}}
\date{\today}

\begin{document}
\maketitle

%\tableofcontents

\newpage

\chapter{Basics for the package}
\Input{chapter-1-en}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\chapter{Setting the layout of the scenery}
\Input{chapter-2-en}
\Input{par-eclairageponctuel-en}
\Input{par-axes3D-en}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\chapter{Predefined solids and their positioning}

\Input{par-solidespredefinis-en}
\Input{par-positionnersolide-en}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\chapter{More options of \textbackslash{}psSolid}
\Input{par-commandestrace-en}
\Input{par-solidescreux-en}
\Input{par-numeroterfacettes-en}
\Input{par-enleverfacettes-en}
\Input{par-pointagesommets-en}
\Input{par-couleurs-en}
\Input{par-colorierfacettes-en}
\Input{par-opacity-en}
\Input{par-definitionmaillage-en}

\Input{par-modes-en}

\Input{par-tronque-en}
\Input{par-affinage-en}
\Input{par-chanfrein-en}
\Input{par-transform-en}
\Input{par-lignedeniveau-en}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\chapter{Usage of external files}
\Input{par-datfile-en}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\chapter{Some special objects}
\Input{par-grille-en}
\Input{par-point-en}
\Input{par-vecteur-en}
\Input{par-plan-en}
\Input{par-geode-en}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\chapter{Generating some new solids}
\Input{par-codejps-en}
\Input{par-definirfonction-en}
\Input{par-courbeR3-en}
\Input{par-tube-en}
\Input{par-prisme-en}
\Input{par-new-en}
\Input{par-face-en}
\Input{par-ruban-en}
\Input{par-anneaux-en}
\Input{par-cylindres-cones-en}
\Input{par-surfacesparametrees-en}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\chapter{Surfaces defined by a function of the form $z=f(x,y)$}
\Input{par-surfaces-en}

\clearpage
\Input{par-implicitsurface-en}%% hc 2016-12-11

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\chapter{Advanced usage}
\Input{par-nommersolide-en}
\Input{par-section-en}
\Input{par-fusion-en}
\Input{par-fusionjps-en}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\chapter{Interaction with PSTricks}

\Input{par-positionnerpointconnu-en}
\Input{par-ligne3D-en}
\Input{par-tracerpolygone-en}
\Input{par-transformpointconnu-en}
\Input{par-annoterschema-en}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\chapter{Projections}
\Input{par-projpresentation-en}
\Input{par-projectionvisibility-en}
\Input{par-definirplanquelconque-en}
\Input{par-projectionpoint-en}
\Input{par-projectionvecteur-en}

\Input{par-projectiondroite-en}

%\newpage
\Input{par-projectioncercle-en}
\Input{par-projectionpolygone-en}
\Input{par-projectionligne-en}
%\newpage
\Input{par-projectionangledroit-en}
\Input{par-projectioncourbe-en}
\Input{par-projectiontexte-en}

\Input{par-image2d-en}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\chapter{Possible extensions}
\Input{par-extensions-en}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\appendix
\chapter{Appendix}
\Input{par-parametres-en}
\Input{par-keywords-en}
\Input{par-acknowledgements-en}
\Input{par-poems-en}

\printindex

\nocite{*}
\bgroup
\RaggedRight
\printbibliography{pst-solides3d-doc}
\egroup

\end{document}