Ox Graphics Function Reference

Chapter contents:

Tables:

Default line and pallete attributes
Symbol types
Line types
Plotting styles

Table draw.1: Default line attributes

index    color           line type  width   symbol   size

 0       white            solid      10     plus     90
 1       black            solid       6     plus     90
 2       red              solid      10     plus     90
 3       blue             solid      10     box      90
 4       blue/green       solid      10     circle   90
 5       purple           dotted     10     plus     90
 6       green            dotted     10     plus     90
 7       brown/yellow     long dash  10     plus     90
 8       dark purple      long dash  10     plus     90
 9       pastel yellow    dotted     10     plus     90
10       pastel green     dotted     10     plus     90
11       pastel blue      solid      10     plus     90
12                        solid      10     plus     90
13       light grey       solid      10     plus     90
14       grey             solid      10     plus     90
15       light grey       solid      10     plus     90

palette  color      (palette is for 3D surface and error fans)      
-1       wireframe
 0       white           
 1       gray           
 2       red             
 3       blue            
 4       blue/green      
 5       purple          
 6       green
 7       brown/yellow

Table draw.2: Symbol types

    PL_FILLBOX    filled box        PL_FILLCIRCLE    filled circle   
    PL_BOX        open box          PL_TRIANGLE      triangle        
    PL_PLUS       plus              PL_FILLTRIANGLE  filled triangle 
    PL_DASH       dash              PL_DIAMOND       diamond         
    PL_CIRCLE     circle            PL_FILLDIAMOND   filled diamond  
    PL_LINE       no symbol         PL_CROSS         cross

Table draw.3: Line types

    TP_SOLID     solid line 
    TP_DOTTED    dotted line 
    TP_DASHED    dashed line 
    TP_LDASHED   long-dashed line 
    TP_USER      user-defined line

Table draw.4: Plotting styles

    ST_LINE           line (points connected)
    ST_SYMBOLS        symbols              
    ST_LINESYMBOLS    line and symbols     
    ST_INDEX          index line           
    ST_INDEXSYMBOLS   index line with symbols
    ST_BARS           bars                 
    ST_SHADING        shading

CloseDrawWindow

#include <oxdraw.oxh>
CloseDrawWindow();

No return value.
Description.: Starts a new draw window for subsequent graphs. Note that the OxMetrics graphics window will remain active there. A call to ShowDrawDrawing also clears the graphics buffer, so does not need to be followed by a call to CloseDrawWindow.

Draw

#include <oxdraw.oxh>
Draw(const iArea, const mYt);
Draw(const iArea, const mYt, const dXfirst, const dXstep);

iArea: in: int, area index
mYt: in: m x T matrix with m rows of data
dXfirst: in: (optional) double, X-value of first observation, x, default is 1
dXstep: in: (optional) double, gap between X-values, d_x, default is 1

No return value.

Description.

This function draws m variables against an X variable, where the X variable consists of evenly spaced observations x, x+d_x, x+2d_x, x+3d_x, .... Each variable is drawn by linking up the points. The first line index is 2.

DrawAcf

#include <oxdraw.oxh>
DrawAcf(const iArea, const vY, const sY, const cLag, ...);
DrawAcf(const iArea, const vY, const sY, const cLag, const fAcf,
    const fPacf, const fErrorBand, int iIndex, const fBar);

iArea: in: int, area index
vY: in: k x T matrix, each row is a new plot
sY: in: string, variable name, or array of strings (k > 1)
cLag: in: int, highest lag to be used in the ACF
fAcf: in: int, TRUE: draw ACF (optional argument, drawn by default)
fPacf: in: int, TRUE: draw PACF (optional argument, not drawn by default)
fErrorBand: in: int, TRUE: draw error bands (optional argument, not drawn by default)
iIndex: in: int, line index, see default line attributes, (optional argument, default is 2).
fBar: in: int, TRUE: draw bar plot, else draw index plot (optional argument, using bars by default)

No return value.

Description.

Draws an ACF and/or PACF.

DrawAdjust

#include <oxdraw.oxh>
DrawAdjust(const iType, ...);

iType: in: int, type of adjustment
d1 ... d4: in: optional arguments (defaults to -1 if missing)

No return value.

Description.

This function adjusts the properties of the current graph.

The expected number of arguments depends on the type of adjustment (use -1 to keep the default value):

constant         d1          d2          d3        d4        d5
ADJ_AREAMATRIX   Y areas     X areas     box all   margin
ADJ_AREA_3D      area        azimuth     elevation distance  twist
ADJ_AREA_P       area        x_1         y_1       width     height
ADJ_AREA_X       area        x_1         x_2       grow
ADJ_AREA_Y       area        y_1         y_2       grow
ADJ_AREA_Z       area        z_1         z_2       grow
ADJ_AREASCOLOR   red:0-255   green:0-255 blue:0-255
ADJ_AXISCENTRE   0,1                    
ADJ_AXISGRID     0,1         colour      type
ADJ_AXISHIDE     0,1                    
ADJ_AXISLABEL    rotation    font size   tick size
ADJ_AXISLINE     zero line   above       no line   no small
ADJ_AXISSCALE    type        scale       shift
ADJ_COLOR        colour      type
ADJ_COLORMODEL   display:0,1 print:0-3
ADJ_INDEX        0,1,2       base
ADJ_LEGEND       area        no columns  font size resize    box     
ADJ_MINMAX       minimum     maximum 
ADJ_PAPERCOLOR   red:0-255   green:0-255 blue:0-255
ADJ_PAPERSCALE   percentage
ADJ_SCALE        scale       shift
ADJ_SYMBOL       type        size
ADJ_SYMBOLUSE    style

The type for ADJ_AXISSCALE is one of:

    AXIS_LINEAR  standard axis,
    AXIS_LOG     log-scale (data is in natural logarithms),
    AXIS_LOG10   log10-scale (data is in base-10 logarithms),
    AXIS_SCALED  scaled: set scale and shift,
    AXIS_DATE    dated: interpret as Julian date/time values.

ADJ_INDEX with first argument equal to 1 draws an index line, use 2 for bars. The second argument sets the base for the index line or bars.

ADJ_AREA_X, ADJ_AREA_Y, ADJ_AREA_Z have an optional argument grow. Set this to one if the area should only grow if it already has dimensions fixed.

ADJ_COLORMODEL: the display mode can be 0 (colour) or 1 (b&w); the print mode can be: 0 = black & white, 1 = black,white&gray, 2 = gray levels, 3 = colour. This defines the colour model that is used for saving graphs in PDF and PostScript.

The azimuth is the rotation along the Z axis (or, more precisely orthogonal to the line of view). Elevation is the angle with the X-Y plane, and twist the rotation along the line of view. Azimuth, elevation and twist are specified in degrees, distance is in area units. The default values of azimuth, elevation, distance and twist could correspond approximately to: -125, 25, 1800, 0;

DrawAxis, DrawAxisAuto

#include <oxdraw.oxh>
DrawAxis(const iArea, const iIsXaxis, const dAnchor,
    const dAxmin, const dAxmax, const dFirstLarge,
    const dLargeStep, const dSmallStep, const iFreq);
DrawAxis(const iArea, const iIsXaxis, const dAnchor,
    const dAxmin, const dAxmax, const dFirstLarge,
    const dLargeStep, const dSmallStep, const iFreq,
    const dAnchor2);
DrawAxisAuto(const iArea, const iIsXaxis, ...);
DrawAxisAuto(const iArea, const iIsXaxis, const fShow,
    const iAnchor, const dAnchor, const dAnchor2);

iArea: in: int, area index
iIsXaxis: in: int, 1: X axis, 0: Y axis, 2: Z axis
dAnchor: in: int, if iAnchor=ANCHOR_USER: anchor of the axis (Y location of X, X location of Y and Z axis)
dAxmin: in: axis minimum
dAxmax: in: axis maximum
dFirstLarge: in: location of first large tick
dLargeStep: in: step size between large ticks
dSmallStep: in: step size between small ticks
iFreq: in: int, frequency (for time series X-axis, set to 0 otherwise)
fShow: in: int, TRUE: show the axis
iAnchor: in: int, axis anchor location, ANCHOR_MIN: at minimum, ANCHOR_MAX: at maximum, ANCHOR_USER: at dAnchor
dAnchor2: in: int, if iAnchor=ANCHOR_USER: anchor of the 3D axis (Z location of X and Y axis, Y location of Z)

No return value.

DrawBoxPlot

#include <oxdraw.oxh>
DrawBoxPlot(const iArea, const vY, const sY);
DrawBoxPlot(const iArea, const vY, const sY, const iIndex);

iArea: in: int, area index
vY: in: k x T matrix, each row is a new plot (needs T>5)
sY: in: string, variable name, or array of strings (k > 1)
iIndex: in: int, line index, see default line attributes, (optional argument, default is 2).

No return value.

DrawCorrelogram

#include <oxdraw.oxh>
DrawCorrelogram(const iArea, const vY, const sY, const cLag);
DrawCorrelogram(const iArea, const mY, const sY, const cLag, const iIndex);

iArea: in: int, area index
vY: in: k x T matrix, each row is a new plot
sY: in: string, variable name, or array of strings (k > 1)
cLag: in: int, highest lag to be used in correlogram
iIndex: in: int, line index, see default line attributes, (optional argument, default is 2).

No return value.

Description.

Draws a correlogram (the ACF is computed slightly differently from acf). This function has been replaced by DrawAcf.

DrawDensity

#include <oxdraw.oxh>
DrawDensity(const iArea, const vY, const sY, ...);
DrawDensity(const iArea, const vY, const sY, const fDens, const fHist,
	const fNormal, BOOL fCdf, BOOL fStand, const cBar, const iIndex);

iArea: in: int, area index
vY: in: k x T matrix, each row is a new plot
sY: in: string, variable name, or array of strings (k > 1)
fDens: in: int, TRUE: draw estimated density (optional argument, default)
fHist: in: int, TRUE: draw histogram (optional argument, not drawn by default)
fNormal: in: int, TRUE: add the normal density with same mean and variance for reference (optional argument, not drawn by default)
fCdf: in: int, TRUE: plot the CDF in separate area (optional argument, not drawn by default); this is drawn as a QQ plot against the normal with same mean and variance (unless fStand=TRUE)
fStand: in: int, TRUE: use standardized data (optional argument, default uses original data)
cBar: in: int, number of bars (0: use default; optional argument)
iIndex: in: int, line index, see default line attributes, (optional argument, default is 2).

No return value.

Description.

Draws the histogram and/or density of the data in the specified area. When fNormal is TRUE, a normal density with the same mean and variance as the data will be drawn.

DrawHistogram

#include <oxdraw.oxh>
DrawHistogram(const iArea, const vBar, ...);
DrawHistogram(const iArea, const vBar, const dMin, const dStep,
    const iIndex, const iColorIn);

iArea: in: int, area index
vBar: in: k x T matrix with bar heights, each row is a new plot
dMin: in: double, first X-coordinate of histogram (optional argument, default is 1)
dStep: in: double, bar step size (optional argument, default is 1)
iIndex: in: int, line index, see default line attributes, (optional argument, default is 2).
iColorIn: in: int, colour index for inside of bars, see default line attributes, (optional argument, default is 0: white).

No return value.

Description.

Draws a histogram when the data is already in histogram format, i.e. vBar contains the bar heights.

DrawLegend

#include <oxdraw.oxh>
DrawLegend(const iArea, const iOffsX, const iOffsY,
    const fHidden);

iArea: in: int, area index
iOffsX: in: int, X pixel offset from top left
iOffsY: in: int, Y pixel offset from top left
fHidden: in: int, TRUE: hide the legend

No return value.

Description.

DrawLegend determines the location of the legend. By default, a legend is drawn in the top left-hand corner, with a scale that adjusts automatically to the area size. DrawLegend can also be used to hide the legend. The content of the legend is determined by the variable names that are used when drawing vectors.

DrawLine

#include <oxdraw.oxh>
DrawLine(const iArea, const dX1, const dY1, const dX2,
    const dY2, const iIndex);
DrawLine(const iArea, const dX1, const dY1, const dZ1,
    const dX2, const dY2, const dZ2, const iIndex);

iArea: in: int, area index
dX1, dY1: in: int, real-world coordinates of starting point
dX2, dY2: in: int, Y real-world coordinates of end point
dZ1, dZ2: in: int, real-world Z coordinates for symbol in 3D graph
iIndex: in: int, line index for first row, see default line attributes.

No return value.

DrawMatrix

#include <oxdraw.oxh>
DrawMatrix(const iArea, const mYt, const asY,
    const dXfirst, const dXstep, ...);
DrawMatrix(const iArea, const mYt, const asY,
    const dXfirst, const dXstep, iSymbol, iIndex);

iArea: in: int, area index
mYt: in: m x T matrix with m rows of data
asY: in: array of strings (holds variable names), or 0 (no names)
dXfirst: in: double, X-value of first observation, x
dXstep: in: double, gap between X-values, d_x
iSymbol: in: int, 0: draw line, 1: draw symbols, 2: draw both (optional argument, default is 0), see Plotting styles.
Or vector with value for each row of data.
iIndex: in: int, line index for first row, see default line attributes, (optional argument, default is 2). Each subsequent row will have the next index.
Or vector with value for each row of data.

No return value.

Description.

This is a more flexible version of the Draw() function. DrawMatrix draws the m variables in the rows of mYt. The X variable consists of evenly spaced observations x, x+d_x, x+2d_x, x+3d_x, .... The following table gives the default settings for each line index. Note that index 0 is the background colour, and 1 the foreground colour.

DrawPLine, DrawPSymbol, DrawPText

#include <oxdraw.oxh>
DrawPLine(const iArea, const iX1, const iY1, const iX2,
    const iY2, const iIndex);
DrawPSymbol(const iArea, const iX1, const iY1, const iX2,
    const iY2, const iSymType, const iIndex);
DrawPText(const iArea, const sText, const iPx1,
    const iPy1, ...);
DrawPText(const iArea, const sText,const iPx1,const iPy1,
    const iFontNo, const iFontSize, const iTitle, const iRotation);

No return value.
Description.: Pixel coordinate versions of DrawLine, DrawSymbol DrawText.

DrawQQ

#include <oxdraw.oxh>
DrawQQ(const iArea, const vY, const sY, const iDens,
    const df1, const df2);
DrawQQ(const iArea, const mY, const sY, const iDens,
    const df1, const df2, const iIndex);

iArea: in: int, area index
vY: in: k x T matrix, each row is a new plot
sY: in: string, variable name, or array of strings (k > 1)
iDens: in: int, one of: QQ_CHI, QQ_F, QQ_N, QQ_T, QQ_U
df1: in: int, first parameter for distribution
df2: in: int, second parameter for distribution
iIndex: in: int, line index for first row, see default line attributes, (optional argument, default is 2).

No return value.

Description.

Draws a QQ plot. The following distributions are supported:

QQ_CHI : chi ^2(df1),
QQ_F : F(df1, df2),
QQ_N : N(0, 1),
QQ_N_SE : N(0, 1), with pointwise asymptotic 95% standard error bands, as derived in Engler and Nielsen(2009),
QQ_T : t(df1),
QQ_U : Uniform(0,1), resulting in a Quantile plot.

DrawSpectrum

#include <oxdraw.oxh>
DrawSpectrum(const iArea, const vY, const sY, const iOrder);
DrawSpectrum(const iArea, const mY, const sY, const iOrder,
    const iIndex);

iArea: in: int, area index
vY: in: k x T matrix, each row is a new plot
sY: in: string, variable name, or array of strings (k > 1)
iOrder: in: int, lag truncation parameter m
iIndex: in: int, line index for first row, see default line attributes, (optional argument, default is 2).

No return value.

Description.

Draws the estimated spectral density.

DrawSymbol

#include <oxdraw.oxh>
DrawSymbol(const iArea, const dX1, const dY1, const dX2,
    const dY2, const iSymType, const iIndex);
DrawSymbol(const iArea, const dX1, const dY1, const dZ1, const dX2,
    const dY2, const dZ2, const iSymType, const iIndex);

iArea: in: int, area index
dX1, dY1: in: int, real-world coordinates, lower-left corner of bounding box
dX2, dY2: in: int, real-world coordinates, upper-right corner of bounding box
dZ1, dZ2: in: int, real-world Z coordinates for symbol in 3D graph
iSymType: in: int, symbol type
iIndex: in: int, line index for first row, see default line attributes, (optional argument, default is 2). Each subsequent row will have the next index.

No return value.

DrawT

#include <oxdraw.oxh>
DrawT(const iArea, const mYt, const mnYear,
    const mnPeriod, const iFreq);
DrawT(const iArea, const mYt, const vDates, 0, 0);

iArea: in: int, area index
mYt: in: m x T matrix with m y variables
mnYear: in: int, year of first observation
mnPeriod: in: int, period of first observation
iFreq: in: int, frequency of observations
vDates: in: 1 x T matrix with with Julian dates (and/or times, see dayofcalendar and timeofday)

No return value.

Description.

Draws m variables in the specified area against time. Each variable is drawn by linking up the points. The first line index is 2.

DrawText, DrawTitle

#include <oxdraw.oxh>
DrawText(const iArea, const sText, const dX1,
    const dY1, ...);
DrawText(const iArea, const sText, const dX1, const dY1,
    const iFontNo, const iFontSize, const iTitle, const iRotation,
    const dZ1);
DrawTitle(const iArea, const sText);

iArea: in: int, area index
sText: in: string, the text may include LaTeX-style formatting
dX1, dY1: in: int, real-world coordinates, anchor of text
iFontNo: in: int, font number (0 for first font; use -1 for the default font)
iFontSize: in: int, font size (e.g. 330; use -1 for the default size)
iTitle: in: int,
  TEXT_TEXT or 0: is normal text, else is graph title (coordinates are ignored):
  TEXT_TITLE - graph title
  TEXT_XLABEL - label along X-axis
  TEXT_YLABEL - label along Y-axis
  TEXT_ZLABEL - label along Z-axis
iRotation: in: int, rotation (in degrees, default is 0), only effective if the iTitle argument is zero
dZ1: in: int, real-world Z coordinate of text anchor (for text in 3D graphs; default is 0)

No return value.

Description.

Note that the forward slash for LaTeX commands must be doubled, for example:

    DrawText(0, "$\\leftarrow\\arrowext$", 1962, 1, -1, -1, 0, 45);

DrawTitle draws text at the title location. This corresponds to DrawText(iArea, sText, 0, 0, -1, -1, TEXT_TITLE).

Text can also be rotated, by specifying the angle in degrees. This will not work well for multiple line text blocks.

DrawTMatrix

#include <oxdraw.oxh>
DrawTMatrix(const iArea, const mYt, const asY, ...);
DrawTMatrix(const iArea, const mYt, const asY,
    const mnYear, const mnPeriod, const iFreq, iSymbol,
    iIndex);
DrawTMatrix(const iArea, const mYt, const asY, const vDates,...);
DrawTMatrix(const iArea, const mYt, const asY, const vDates,
    0, 0, const iSymbol, const iIndex);

iArea: in: int, area index
mYt: in: m x T matrix with m y variables
asY: in: array of strings (holds variable names), or 0 (no names)
mnYear: in: int, year of first observation
mnPeriod: in: int, period of first observation
iFreq: in: int, frequency of observations
iSymbol: in: int, 0: draw line, 1: draw symbols, 2: draw both (optional argument, default is 0), see Plotting styles.
Or vector with value for each row of data.
iIndex: in: int, line index for first row, see Default line attributes, (optional argument, default is 2). Each subsequent row will have the next index.
Or vector with value for each row of data.
vDates: in: 1 x T matrix with with Julian dates (and/or times, see dayofcalendar and timeofday)

No return value.

Description.

This is a more flexible version of the DrawT() function. Draws m variables in the specified area against time. See under DrawMatrix for the default settings for each line index.

See ox/samples/graphics/draw10.ox for an example using fixed frequency, daily and timed data. See Modelbase::DbDrawTMatrix for a version that uses the database sample information for the horizontal axis.

DrawX

#include <oxdraw.oxh>
DrawX(const iArea, const mYt, const vX);

iArea: in: int, area index
mYt: in: m x T matrix with m y variables
vX: in: 1 x T matrix with x variable

No return value.

Description.

Draws m y variables in the specified area against an x variable. Each point is marked, but the points are not linked, resulting in a cross plot. The first line index is 2.

DrawXMatrix

#include <oxdraw.oxh>
DrawXMatrix(const iArea, const mYt, const asY, const vX,
    const sX, ...);
DrawXMatrix(const iArea, const mYt, const asY, const vX,
    const sX, iSymbol, iIndex);

iArea: in: int, area index
vX: in: 1 x T matrix with x variable
iSymbol: in: int, 0: draw line, 1: draw symbols, 2: draw both (optional argument, default is 0), see Plotting styles.
Or vector with value for each row of data.
iIndex: in: int, line index for first row, see Default line attributes, (optional argument, default is 2). Each subsequent row will have the next index.
Or vector with value for each row of data.

No return value.

Description.

This is a more flexible version of the DrawX() function. Draws m variables in the specified area against an x variable See under DrawMatrix for the default settings for each line index.

See ox/samples/graphics/draw11.ox for an example using fixed frequency and daily data.

DrawXYZ

#include <oxdraw.oxh>
DrawXYZ(const iArea, const vX, const vY, const mZ, ...);
DrawXYZ(const iArea, const vX, const vY, const mZ,
    const iMode, const sX, const sY, const sZ,
    const iPalette, const iIndex);

iArea: in: int, area index
vX: in: 1 x k matrix with X variable
vY: in: 1 x n matrix with Y variable
mZ: in: k x n matrix with Z variable, heights above XY plane (tabular format)
or; in: 1 x n=k matrix with Z coordinates for points (X, Y, Z), rough approximation of surface is constructed (scatter format)
iMode: in: int, type of plot (optional argument):
-1 - triangulation (only for scatter format)
0 - surface plot only (default)
1 - currently unsupported: surface plot with contours on ground level
2 - 2-dimensional contour plot
sX: in: string, name of X variable (optional argument)
sY: in: string, name of Y variable (optional argument)
sZ: in: string, name of Z variable (optional argument)
iPalette: in: int, palette index, see Default line attributes, (optional argument, default is 2: red).
iIndex: in: int, line index for mesh, see Default line attributes, (optional argument, default is 1: black).

No return value.

DrawZ

#include <oxdraw.oxh>
DrawZ(const vZ, ...);
DrawZ(const vZ, const sZ, const iMode, const dFac,
    const iIndex);

iArea: in: int, area index
vZ: in: 1 x T matrix with Z variable
sZ: in: string, 1 name of Z variable
iMode: in: int, type of Z variable (optional argument):
ZMODE_SYMBOL - use values as symbol size,
ZMODE_VALUE - draw value as text,
ZMODE_BAR - draw error bars (the default),
ZMODE_BAND - draw error bands,
ZMODE_FAN - draw error fans,
ZMODE_HILO - draw high-low plot,
ZMODE_3D - draw 3-D points.
dFac: in: double, bar/band factor (optional argument, 2.0 is default)
iIndex: in: int, line index for first row, see Default line attributes, (optional argument, default is 2). Each subsequent row will have the next index.

No return value.

Description.

DrawZ adds a Z component to the most recent graphics object. DrawZ should be used immediately after a call to one of the draw functions Draw, DrawMatrix, DrawX, etc.).

SetDraw

#include <oxdraw.oxh>
SetDraw(const iOption, ...);

iType: in: int, type of adjustment
i1 ... i5: in: optional arguments

No return value.

Description.

This function changes the default settings used in graphics. When run via OxMetrics, this will affect the persistent OxMetrics settings. Check first under DrawAdjust if the required customization is available there.

The expected number of arguments depends on the type of adjustment:

option             i1             i2             i3            i4           i5 

SET_AXIS           fontsize       step           tick       
SET_AXISFORMAT     width:8        precision:6    same prec:0,1 lead zero:0,1 
SET_AXISLINE       no X-line      no Y-line      center dates  no small Y      
SET_BOX            box:0-1        X-grid:0-1     Y-grid:0-1       
SET_BWG            lineno:0-15    red:0-255      green:0-255   blue:0-255     
SET_COLOR          lineno:0-15    red:0-255      green:0-255   blue:0-255     
SET_COLORMODEL     model:0-3          
SET_FONT           fontno:0-3     fontsize         
SET_GRID           color:0-15     type:0-15         
SET_HISTOGRAM      inside:0-15    outside:0-15         
SET_LEGEND         boxed:0-1      columns         
SET_LEGENDFONTSIZE fontsize     
SET_LEGENDHIDE     hide:0-1          
SET_LEGENDRESIZE   resize:0,1     
SET_LINE           lineno:0-15    linetype:0-4  width         on           off 
SET_LINEBWG        lineno:0-15    linetype:0-4  width         on           off 
SET_MARGIN         left-margin    top-margin
SET_PALETTE_MAX    lineno:0-7     red:0-255     green:0-255   blue:0-255      
SET_PALETTE_MIN    lineno:0-7     red:0-255     green:0-255   blue:0-255     
SET_PAPERCOLOR     red:0-255      green:0-255   blue:0-255     
SET_PRINTPAGE      papertype:0-2  orient:0-1    X-size        Y-size     
SET_SYMBOL         lineno:0-15    symtype:0-4   size            
SET_XYSTYLE        2D-style:0,1   3D-style:0,1

Paper, orientation and model arguments for SET_PRINTPAGE and SET_COLORMODEL are:

papertype    orientation        model
PAGE_A4      PAGE_PORTRAIT      0   black & white
PAGE_LETTER  PAGE_LANDSCAPE     1   black, white, gray
PAGE_USER                       2   gray
                                3   color

SaveDrawWindow

#include <oxdraw.oxh>
SaveDrawWindow(const sFilename);

sFilename: in: valid file name

No return value.

Description.

Saves the current graph to the specified file. The file format for saving is derived from the extension. The following formats are supported:

.eps : Encapsulated PostScript
.gwg : OxMetrics graphics file
.pdf : PDF: Portable document format
.ps : PostScript

See the OxMetrics book for a description of these formats. When saving in a format other than .gwg, the .gwg file is automatically saved as well (using the same file name with .gwg appended).

SetDrawWindow

#include <oxdraw.oxh>
SetDrawWindow(const sTitle);

sTitle: in: string, name of window

No return value.

Description.

This function is only relevant when interacting with OxMetrics otherwise it does nothing. It sets the name of the OxMetrics window in which the graphs of the Ox program appear to sTitle.

SetTextWindow

#include <oxdraw.oxh>
SetTextWindow(const sTitle);

sTitle: in: string, name of window

No return value.

Description.

This function is only relevant when interacting with OxMetrics otherwise it does nothing. It sets the name of the OxMetrics window in which the output (from the print() function) of the Ox program appears to sTitle.

ShowDrawWindow

#include <oxdraw.oxh>
ShowDrawWindow();

No return value.
Description.: Shows the drawing. Note that in some implementations the graphs cannot be displayed. Then a message is printed (SaveDrawWindow() will still work in that case!). A call to ShowDrawWindow also clears the drawing buffer, so does not need to be followed by a call to CloseDrawWindow. Therefore, two subsequent calls to ShowDrawWindow first show, then clear the graph from the active window.