doc.tex

that is a useful book for people who like to learn more about C++.

\item{\large DrawCircle} \vs{1.5mm} \\
Draws a circle \vs{1.5mm} \\
{\tt DrawCircle(X, Y, Radius) } 
\bc
\btab{llll}
\hline
 Parameter &  C-Type &  FORTRAN-Type & Meaning \\ 
\hline 
\it X	& double& REAL*8& X-user-coordinate of center\\
\it Y	& double& REAL*8& Y-user-coordinate of center\\
\it Radius	& double& REAL*8& Radius in user-coordinates\\
\hline
\etab
\ec

A circle around {\it (X,Y)} is drawn. The radius is in user coordinates used 
along the X-axis.
The circle will always be drawn with two equal axes, even if the scale of
the $X$ and $Y$ axes are not identical.

\item{\large DrawRectangle} \vs{1.5mm} \\
Draws a rectangle \vs{1.5mm} \\
{\tt DrawRectangle(X1, Y1, X2, Y2) } 
\bc
\btab{llll}
\hline
 Parameter &  C-Type &  FORTRAN-Type & Meaning \\ 
\hline 
\it X1	& double& REAL*8& X-user-coordinate of lower-left point\\
\it Y1	& double& REAL*8& Y-user-coordinate of lower-left point\\
\it X2	& double& REAL*8& X-user-coordinate of upper-right point\\
\it Y2	& double& REAL*8& Y-user-coordinate of upper-right point\\
\hline
\etab
\ec

A rectangle is drawn. Opposite points are specified 
by {\it (X1, Y1)} and {\it(X2,Y2)} resp. 

\item{\large FillRectangle} \vs{1.5mm} \\
Draws a rectangle filled black\vs{1.5mm} \\
{\tt FillRectangle(X1, Y1, X2, Y2) } 
\bc
\btab{llll}
\hline
 Parameter &  C-Type &  FORTRAN-Type & Meaning \\ 
\hline 
\it X1	& double& REAL*8& X-user-coordinate of lower-left point\\
\it Y1	& double& REAL*8& Y-user-coordinate of lower-left point\\
\it X2	& double& REAL*8& X-user-coordinate of upper-right point\\
\it Y2	& double& REAL*8& Y-user-coordinate of upper-right point\\
\hline
\etab
\ec

A rectangle is drawn and filled black. Opposite points are specified 
by {\it (X1, Y1)} and {\it(X2,Y2)} resp. 


\item{\large FillPolygon} \vs{1.5mm} \\
Draws a polygon filled black\vs{1.5mm} \\
{\tt FillPolygon(Points, NPoints) } 
\bc
\btab{llll}
\hline
 Parameter &  C-Type &  FORTRAN-Type & Meaning \\ 
\hline 
\it Points & double[]& REAL*8 (npoints,2) & Array containing points\\
\it NPoints& int     & REAL*8	& number of points\\
\hline
\etab
\ec

Draws a polygon through {\it Points} and fills it black. Points should in 
Fortran be a {\tt REAL*8} array of dimension precisely {\it NPoints $\times$ 2}.
This array specifies the points defining the polygon to be filled. {\it NPoints}
is the number of points of the polygon. 

\item{\large SetLineStyle} \vs{1.5mm} \\
Set the current line style \vs{1.5mm} \\
{\tt SetLineStyle(Style) } 
\bc
\btab{llll}
\hline
 Parameter &  C-Type &  FORTRAN-Type & Meaning \\ 
\hline 
\it Style& int& INTEGER& code for line style (see below)\\
\hline
\etab
\ec

A call to this function sets the new line style. All drawing after this call 
will be done in the new line style, until a new call to this function
is performed. There exist four different
predefined line styles. The default style is 0, corresponding to solid line 
style. 1 means dashed line style, 2 dotted, and 3 dashed-dotted line style.
The size of the dashes and the distances between the dots are determined by
the current dash length (see {\tt SetDashLength}).

\item{\large SetDashLength} \vs{1.5mm} \\
Set the current dash length \vs{1.5mm} \\
{\tt SetDashLength(Length) } 
\bc
\btab{llll}
\hline
 Parameter &  C-Type &  FORTRAN-Type & Meaning \\ 
\hline 
\it Length& int& INTEGER& new dash length\\
\hline
\etab
\ec

This function is used to set the dash length for drawing until another call
to this function is made. 
In dashed line style, the dashes are twice the dash length and they are
separated by white spaces of one dash length. The dots in dotted line style
are separated by one dash length. In dash-dotted style, the dashes are two 
dash lengths long, and dashes and dots are separated by a dash length.
{\tt InitPlot} sets the dash length equal to 5 for X-windows. The dash length for
postscript is automatically rescaled to an equivalent length.

\item{\large SetLineWidth} \vs{1.5mm} \\
Set the current line width \vs{1.5mm} \\
{\tt SetLineWidth(Width) } 
\bc
\btab{llll}
\hline
 Parameter &  C-Type &  FORTRAN-Type & Meaning \\ 
\hline 
\it Width& int& INTEGER& new line width\\
\hline
\etab
\ec

This function is used to set the line width to a new value, {\it width}. 
The width is given in pixels, default is 1. 

\item{\large SetNamedColor} \vs{1.5mm} \\
Set X-window color by specifying color name \vs{1.5mm} \\
{\tt SetNamedColor (ColorName) } 
\bc
\btab{llll}
\hline
 Parameter &  C-Type &  FORTRAN-Type & Meaning \\ 
\hline 
\it ColorName	& char * & CHARACTER **& color name\\
\hline
\etab
\ec

This function has no effect on the postscript output. 
For X-output, the color of subsequent drawing can be set by specifying
the name of the desired color. Possible color names can be found in directory
{\tt /usr/local/X11R5/lib/X11} or a similar one, depending on the implementation
of X. This method of specifying colors by their is very convenient, but slow.


\item{\large SetNamedBackground} \vs{1.5mm} \\
Set X-window color by specifying color name \vs{1.5mm} \\
{\tt SetNamedBackground (ColorName) } 
\bc
\btab{llll}
\hline
 Parameter &  C-Type &  FORTRAN-Type & Meaning \\ 
\hline 
\it ColorName	& char * & CHARACTER **& color name\\
\hline
\etab
\ec

This function has no effect on the postscript output. 
For X-output, the color of the background drawing can be set by specifying
the name of the desired background color. Possible color names can be found in directory
{\tt /usr/local/X11R5/lib/X11} or a similar one, depending on the implementation
of X. 


\item{\large MoveTo} \vs{1.5mm} \\
Move current position to point specified by argument \vs{1.5mm} \\
{\tt MoveTo(X, Y) } 
\bc
\btab{llll}
\hline
 Parameter &  C-Type &  FORTRAN-Type & Meaning \\ 
\hline 
\it X	& double& REAL*8& X-user-coordinate of point\\
\it Y	& double& REAL*8& Y-user-coordinate of point\\
\hline
\etab
\ec

Moves the current position to {\it (X, Y)}. Use of this 
function is to write text or numbers starting at a position specified
by {\it (X, Y)}.


\item{\large SetFont} \vs{1.5mm} \\
Sets font style and size \vs{1.5mm} \\
{\tt SetFont(FontName, Weight, Orientation, Size) } 
\bc
\btab{llll}
\hline
 Parameter &  C-Type &  FORTRAN-Type & Meaning \\ 
\hline 
\it FontName	& char *& CHARACTER **	& font name\\
\it Weight	& char *& CHARACTER **	& font weight\\
\it Orientation	& char *& CHARACTER **	& orientation\\
\it Size  	& int	& INTEGER	& font size\\
\hline
\etab
\ec

SetFont sets the font style and size for writing text and numbers on
the screen. The character-type arguments are case-insensitive.

The {\it FontName} must be a string starting with ``T'' or ``t'' (for ``Times''),
 ``H'' or ``h'' (``Helvetica),  ``C'' or ``c'' (``Courier''),  ``N'' or ``n'' 
(``NewCenturySchlbk'') or  ``S'' or ``s'' (``Symbol''). These are some of the
most common adobe-fonts. It is believed that this choice will satisfy most
of the needs. 

{\it Weight} is either a string starting with ``m'' (from ``medium'') or ``b'' (``bold''). Furthermore,
{\it Orientation} a string starting with either ``r'' (``roman''), ``i''
(``italic'') or ``o'' (``oblique''). Oblique may only be used with 
fonts Courier and Helvetica, italic only with Times and NewCenturySchlbk.
Symbol can only have roman and medium for {\it Orientation} and {\it Weight} resp. 

{\it Size} is typically 12, 14, 18, 20 etc. 

This function may cause an error when a font cannot be found by the 
X-server. Furthermore, not all postscript printers have all these fonts at
their disposal. Sometimes, a font is not found when using ghostscript to 
preview the plot, but it comes out of the printer correctly\ldots

\item{\large WriteText} \vs{1.5mm} \\
Plots {\it Text} starting at the current pen position. \vs{1.5mm} \\
{\tt WriteText(Text) } 
\bc
\btab{llll}
\hline
 Parameter &  C-Type &  FORTRAN-Type & Meaning \\ 
\hline 
\it Text& char *& CHARACTER**& text to be written\\
\hline
\etab
\ec

Writes {\it Text} starting from the current position.
Most often, a call to this function is preceded by a call to {\tt MoveTo} or
to another write-function.

The left end of the plotted text starts at the {\it X}--coordinate 
of the current position. The 
{\it Y}--coordinate of the current position specifies the {\em mean} height of the written text,
that is, not the bottom line.  

The current position becomes the right end of the text plotted. 

\item{\large WriteInt} \vs{1.5mm} \\
Plot the {\it Number} using {\it CharNum} characters \vs{1.5mm} \\
{\tt WriteInt(Number, CharNum) } 
\bc
\btab{llll}
\hline
 Parameter &  C-Type &  FORTRAN-Type & Meaning \\ 
\hline 
\it Number& int & INTEGER& number to be written\\
\it CharNum& int & INTEGER& number of characters used to write {\it Number}\\
\hline
\etab
\ec

Writes {\it Number} using {\it CharNum} digits starting from the current 
position.
Most often, a call to this function is preceded by a call to {\tt MoveTo} or
to another write-function.

The left end of the plotted number starts at the current {\it X}--coordinate.
The current {\it Y}--coordinate specifies the {\em mean} height of the written text,
that is, not the bottom line.  

The current position becomes the right end of the text plotted. 

\item{\large WriteFloat} \vs{1.5mm} \\
Write a real number  \vs{1.5mm} \\
{\tt WriteFloat(Number, TotChar, DecChar) } 
\bc
\btab{llll}
\hline
 Parameter &  C-Type &  FORTRAN-Type & Meaning \\ 
\hline 
\it Number& double & REAL*8 & number to be written\\
\it CharNum& int & INTEGER & total number of characters used to write {\it Number}\\
\it DecChar& int & INTEGER & number of decimals used to write {\it Number}\\
\hline
\etab
\ec

Writes {\it Number} using {\it TotChar} characters and {\it DecChar} decimals
starting from the current position.
Most often, a call to this function is preceded by a call to {\tt MoveTo} or
to another write-function.

The left end of the plotted number starts at the current {\it X}--coordinate.
The current
{\it Y}--coordinate specifies the {\em mean} height of the written text,
that is, not the bottom line.  

The current position becomes the right end of the text plotted. 



\ei
\end{document}