The calls are: | IXP = NXPOSN (X) | level 2, 3 |
IYP = NYPOSN (Y) | level 2, 3 |
or: | int nxposn (float x); |
int nyposn (float y); |
Plot coordinates can also be returned as real numbers.
The calls are: | XP = XPOSN (X) | level 2, 3 |
YP = YPOSN (Y) | level 2, 3 |
or: | float xposn (float x); |
float yposn (float y); |
The following two functions convert plot coordinates to user coordinates.
The calls are: | XW = XINVRS (NXP) | level 2, 3 |
YW = YINVRS (NYP) | level 2, 3 |
or: | float xinvrs (int nxp); |
float yinvrs (int nyp); |
TRFREL converts user coordinates to plot coordinates.
The call is: | CALL TRFREL (XRAY, YRAY, N) | level 2, 3 |
or: | void trfrel (float *xray, float *yray, int n); |
XRAY, YRAY | are arrays containing the user coordinates. After the call, they contain the calculated plot coordinates. |
N | is the number of points. |
Additional note:
The routine TRFCO1 converts one-dimensional coordinates.
The call is: | CALL TRFCO1 (XRAY, N, CFROM, CTO) | level 0, 1, 2, 3 |
or: | void trfco1 (float *xray, int n, char *cfrom, char *cto); |
XRAY | is an array containing angles expressed in radians or degrees. After a call to TRFCO1, XRAY contains the converted coordinates. |
N | is the number of coordinates. |
CFROM, CTO | are character strings that can have the values 'DEGREES' and 'RADIANS'. |
The routine TRFCO2 converts two-dimensional coordinates.
The call is: | CALL TRFCO2 (XRAY, YRAY, N, CFROM, CTO) | level 0, 1, 2, 3 |
or: | void trfco2 (float *xray, float *yray, int n, char *cfrom, char *cto); |
XRAY, YRAY | are arrays containing rectangular or polar coordinates. For polar coordinates, XRAY contains the angles measured in degrees and YRAY the radii. |
N | is the number of coordinates. |
CFROM, CTO | are character strings that can have the values 'RECT' and 'POLAR'. |
The routine TRFCO3 converts three-dimensional coordinates.
The call is: | CALL TRFCO3 (XRAY, YRAY, ZRAY, N, CFROM, CTO) | level 0, 1, 2, 3 |
or: | void trfco3 (float *xray, float *yray, float *zray, int n, char *cfrom, char *cto); |
XRAY, YRAY, ZRAY | are arrays containing rectangular, spherical or cylindrical coordinates. Spherical coordinates must be in the form (longitude,latitude, radius) where 0 <= longitude <= 360 and -90 <= latitude <= 90. Cylindrical coordinates must be in the form (angle, radius, z). |
N | is the number of coordinates. |
CFROM, CTO | are character strings that can have the values 'RECT','SPHER' and 'CYLI'. |
The routine TRFMAT converts a matrix to another matrix by bilinear interpolation.
The call is: | CALL TRFMAT (ZMAT, NX, NY, ZMAT2, NX2, NY2) - | level 0, 1, 2, 3 |
or: | void trfmat (float *zmat, int nx, int ny, float *zmat2, int nx2, int ny2); |
ZMAT | is the input matrix of the dimesion (NX, NY). |
NX, NY | are the dimensions of the matrix ZMAT. |
ZMAT2 | is the output matrix of the dimesion (NX2, NY2). |
NX2, NY2 | are the dimensions of the matrix ZMAT2. |
The function NLMESS returns the length of text in plot coordinates.
The call is: | NL = NLMESS (CSTR) | level 1, 2, 3 |
or: | int nlmess (char *cstr); |
CSTR | is a character string (<= 132 characters). |
NL | is the length in plot coordinates. |
The function TRMLEN returns the number of characters in a character string.
The call is: | NL = TRMLEN (CSTR) | level 0, 1, 2, 3 |
or: | int trmlen (char *cstr); |
CSTR | is a character string. |
NL | is the number of characters. |
UPSTR converts a character string to uppercase letters.
The call is: | CALL UPSTR (CSTR) | level 0, 1, 2, 3 |
or: | void upstr (char *cstr); |
CSTR | is a character string to be converted. |
NLNUMB calculates the length of numbers in plot coordinates.
The call is: | NL = NLNUMB (X, NDIG) | level 1, 2, 3 |
or: | int nlnumb (float x, int ndig); |
X | is a real number. |
NDIG | is the number of decimal places (>= -1). |
NL | is the length in plot coordinates. |
INTLEN calculates the number of digits in integers.
The call is: | CALL INTLEN (NX, NL) | level 0, 1, 2, 3 |
or: | int intlen (int nx); |
NX | is an integer. |
NL | is the number of digits. |
FLEN calculates the number of digits in real numbers.
The call is: | CALL FLEN (X, NDIG, NL) | level 0, 1, 2, 3 |
or: | int flen (float x, int ndig); |
X | is a real number. |
NDIG | is the number of decimal places (>= -1). |
NL | is the number of digits including the decimal point. For negative numbers, it includes the minus sign. |
INTCHA converts integers to character strings.
The call is: | CALL INTCHA (NX, NL, CSTR) | level 0, 1, 2, 3 |
or: | int intcha (int nx, char *cstr); |
NX | is the integer to be converted. |
NL>/td> | is the number of digits in NX returned by INTCHA. |
CSTR | is the character string containing the integer. |
FCHA converts real numbers to character strings.
The call is: | CALL FCHA (X, NDIG, NL, CSTR) | level 0, 1, 2, 3 |
or: | int fcha (float x, ind ndig, char *cstr); |
X | is the real number to be converted. |
NDIG | is the number of decimal places to be considered (>= -1). The last digit will be rounded up. |
NL | is the number of digits returned by FCHA. |
CSTR | is the character string containing the real number. |
SORTR1 sorts real numbers.
The call is: | CALL SORTR1 (XRAY, N, COPT) | level 0, 1, 2, 3 |
or: | void sortr1 (float *xray, int n, char *copt); |
XRAY | is an array containing real numbers. |
N | is the dimension of XRAY. |
COPT | defines the sorting direction. IF COPT = 'A', the numbers will be sorted in ascending order; if COPT = 'D', they will be sorted in descending order. |
SORTR2 sorts two-dimensional points in the X-direction.
The call is: | CALL SORTR2 (XRAY, YRAY, N, COPT) | level 0, 1, 2, 3 |
or: | void sortr2 (float *xray, float *yray, int n, char *copt); |
XRAY, YRAY | are arrays containing the coordinates. |
N | is the number of points. |
COPT | defines the sorting direction. IF COPT = 'A', the points will be sorted in ascending order; if COPT = 'D', they will be sorted in descending order. |
Additional note:
SPLINE calculates splined points used in CURVE to plot a spline.
The call is: | CALL SPLINE (XRAY, YRAY, N, XSRAY, YSRAY, NSPL) | level 1, 2, 3 |
or: | void spline (float *xray, float *yray, int n, float *xsray, float *ysray, int *nspl); |
XRAY, YRAY | are arrays containing points of the curve. |
N | is the dimension of XRAY and YRAY. |
XSRAY, YSRAY | are the splined points returned by SPLINE. |
NSPL | is the number of calculated splined points returned by SPLINE. By default, NSPL has the value 200. |
Additional note:
The routine BEZIER calculates a Bezier interpolation.
The call is: | CALL BEZIER (XRAY, YRAY, N, XPRAY, YPRAY, NP) | level 0, 1, 2, 3 |
or: | void bezier (float *xray, float *yray, int n, float *xpray, float *ypray, int np); |
XRAY, YRAY | are arrays containing points of the curve. |
N | is the dimension of XRAY and YRAY (1 < N < 21). |
XPRAY, YPRAY | are the Bezier points returned by BEZIER. |
NP | is the number of calculated points defined by the user. |
The routine HISTOG calculates a histogram.
The call is: | CALL HISTOG (XRAY, N, XHRAY, YHRAY, NH) | level 0, 1, 2, 3 |
or: | void histog (float *xray, int n, float *xhray, float *yhray, int nh); |
XRAY | is an array containing floatingpoint numbers. |
N | is the dimension of XRAY. |
XHRAY, YHRAY | are arrays containing the calculated histogram. XHRAY contains distinct values from XRAY sorted in ascending order. YHRAY contains the frequency of points. |
NH | is the number of points in XHRAY und YHRAY returned by HISTOG. |
The routine TRIANG calculates the Delaunay triangulation of an arbitrary collection of points in the plane. The Delaunay triangulation can directly be used to display surfaces and contour lines of irregularily distributed data points.
The call is: | The call is: CALL TRIANG (XRAY, YRAY, N, I1RAY, I2RAY, I3RAY, NMAX, NTRI) | level 0, 1, 2, 3 |
or: | void triang (float *xray, float *yray, int n, int *i1ray, int *i2ray, int *i3ray, int nmax, int *ntri); |
XRAY, YRAY | are arrays containing floatingpoint numbers. The dimension of XRAY and YRAY must be greater or equal N + 3. |
N | is the number of points in XRAY and YRAY. |
I1RAY, I2RAY, I3RAY | are the returned vertices for each triangle in anticlockwise order. |
NMAX | is the dimension of I1RAY, I2RAY and I3RAY. NMAX must be greater of equal 2 * N + 1. |
NTRI | is the returned number of triangles. |
Additional notes:
The routine CIRC3P calculates a circle specified by three points.
The call is: | CALL CIRC3P (X1, Y1, X2, Y2, X3, Y3, XM, YM, R) | level 0, 1, 2, 3 |
or: | void circ3p (float x1, float y1, float x2, float y2, float x3, float y3, float *xm, float *ym , float *r) |
X1, Y1 | are the X- and Y-coordinates of the first point. |
X2, Y2 | are the X- and Y-coordinates of the second point. |
X3, Y3 | are the X- and Y-coordinates of the third point. |
XM, YM | are the calculated coordinates of the centre point. |
R | is the calculated radius of the circle. |
The routine BASDAT defines the base date. This routine is necessary for plotting date labels and data containing date coordinates.
The call is: | CALL BASDAT (IDAY, IMONTH, IYEAR) | level 0, 1, 2, 3 |
or: | void basdat (int iday, int imonth, int iyear); |
IDAY | is the day number of the date between 1 and 31. |
IMONTH | is the month number of the date between 1 and 12. |
IYEAR | is the four digit year number of the date. |
The function INCDAT returns the number of days between a specified date and the base date. This calculated days can be passed as parameters to the routine GRAF and as coordinates to data plotting routines such as CURVE.
The call is: | N = INCDAT (IDAY, IMONTH, IYEAR) | level 0, 1, 2, 3 |
or: | int incdat (int iday, int imonth, int iyear); |
N | is the returned number of calculated days. |
IDAY | is the day number of the date between 1 and 31. |
IMONTH | is the month number of the date between 1 and 12. |
IYEAR | is the four digit year number of the date. |
The routine TRFDAT calculates for a number of days the corresponding date.
The call is: | CALL TRFDAT (N, IDAY, IMONTH, IYEAR) | level 0, 1, 2, 3 |
or: | void trfdat (int n, int *iday, int *imonth, int *iyear); |
N | is the number of days. |
IDAY | is the returned day number. |
IMONTH | is the returned month number. |
IYEAR | is the returned four digit year number. |
The function NWKDAY returns the weekday for a given date.
The call is: | N = NWKDAY (IDAY, IMONTH, IYEAR) | level 0, 1, 2, 3 |
or: | int nwkday (int iday, int imonth, int iyear); |
N | is the returned weekday between 1 and 7 (1 = Monday, 2 = Tuesday, ...). |
IDAY | is the day number of the date between 1 and 31. |
IMONTH | is the month number of the date between 1 and 12. |
IYEAR | is the four digit year number of the date. |
The routine BITSI2 allows bit manipulation on 16 bit variables.
The call is: | CALL BITSI2 (NBITS, NINP, IINP, NOUT, IOUT, IOPT) | level 0, 1, 2, 3 |
or: | short bitsi2 (int nbits, short ninp, int iinp, short nout, int iout); |
NBITS | is the number of bits to be shifted. |
NINP | is a 16 bit variable from which to extract the bit field. |
IINP | is the bit position of the leftmost bit of the bit field. The bits are numbered 0 - 15 where 0 is the most significant bit. |
NOUT | is a 16 bit variable into which the bit field is placed. |
IOUT | is the bit position where to put the bit field. |
IOPT | controls whether the bits outside of the field are set to zero or not. If IOPT equal 0, the bits are set to zero. If IOPT not equal 0, the bits are left as they are. For this case, NOUT is also used as input parameter. In the C function, IOPT is missing in the parameter list and internally used with the value 1. |
The routine BITSI4 allows bit manipulation on 32 bit variables.
The call is: | CALL BITSI4 (NBITS, NINP, IINP, NOUT, IOUT, IOPT) | level 0, 1, 2, 3 |
or: | int bitsi4 (int nbits, int ninp, int iinp, int nout, int iout); |
NBITS | is the number of bits to be shifted. |
NINP | is a 32 bit variable from which to extract the bit field. |
IINP | is the bit position of the leftmost bit of the bit field. The bits are numbered 0 - 31 where 0 is the most significant bit. |
NOUT | is a 32 bit variable into which the bit field is placed. |
IOUT | is the bit position where to put the bit field. |
IOPT | controls whether the bits outside of the field are set to zero or not. If IOPT equal 0, the bits are set to zero. If IOPT not equal 0, the bits are left as they are. For this case, NOUT is also used as input parameter. In the C function, IOPT is missing in the parameter list and internally used with the value 1. |
The routine SWAPI2 swaps the bytes of 16 bit integer variables.
The call is: | CALL SWAPI2 (IRAY, N) | level 0, 1, 2, 3 |
or: | void swapi2 (short *iray, int n); |
IRAY | is an array containing the 16 bit variables. |
N | is the number of variables. |
The routine SWAPI4 swaps the bytes of 32 bit integer variables.
The call is: | CALL SWAPI4 (IRAY, N) | level 0, 1, 2, 3 |
or: | void swapi4 (int *iray, int n); |
IRAY | is an array containing the 32 bit variables. |
N | is the number of variables. |
The routine OPENFL opens a file for binary I/O.
The call is: | CALL OPENFL (CFILE, NLU, IRW, ISTAT) | level 0, 1, 2, 3 |
or: | int openfl (char *cfile, int nlu, int irw); |
CFILE | is a character string containing the file name. |
NLU | is the logical unit for the I/O (0 <= NLU <= 99). The units 15 and 16 are reserved for DISLIN. |
IRW | defines the file access mode (0: READ, 1: WRITE, 2: APPEND). |
ISTAT | is the returned status (0: no errors). |
The routine CLOSFL closes a file.
The call is: | CALL CLOSFL (NLU) | level 0, 1, 2, 3 |
or: | int close (int nlu); |
NLU | is the logical unit. |
The routine READFL reads a given number of bytes.
The call is: | CALL READFL (NLU, IBUF, NBYT, ISTAT) | level 0, 1, 2, 3 |
or: | int readfl (int nlu, unsigned char *ibuf, int nbyt); |
NLU | is the logical unit. |
IBUF | is an array where to read the bytes. |
NBYT | is the number of bytes. |
ISTAT | is the number of bytes read (0 means end of file). |
The routine WRITFL writes a number of bytes.
The call is: | CALL WRITFL (NLU, IBUF, NBYT, ISTAT) | level 0, 1, 2, 3 |
or: | int writfl (int nlu, unsigned char *ibuf, int nbyt); |
NLU | is the logical unit. |
IBUF | is an array containing the bytes. |
NBYT | is the number of bytes. |
ISTAT | is the number of bytes written (0 means an error). |
The routine SKIPFL skips a number of bytes from the current position.
The call is: | CALL SKIPFL (NLU, NBYT, ISTAT) | level 0, 1, 2, 3 |
or: | int skipfl (int nlu, int nbyt); |
NLU | is the logical unit. |
NBYT | is the number of bytes. |
ISTAT | is the returned status (0: OK). |
The routine TELLFL returns the current position in bytes.
The call is: | CALL TELLFL (NLU, NBYT) | level 0, 1, 2, 3 |
or: | int tellfl (int nlu); |
NLU | is the logical unit. |
NBYT | is the returned position in bytes where byte numbering begins with zero. NBYT = -1, if an error occurs. |
The routine POSIFL skips to a certain position relative to the start.
The call is: | CALL POSIFL (NLU, NBYT, ISTAT) | level 0, 1, 2, 3 |
or: | int posifl (int nlu, int nbyt); |
NLU | is the logical unit. |
NBYT | defines the position. Byte numbering begins with zero. |
ISTAT | is the returned status (0: OK). |
The routine ERASE clears the screen, a graphics window or the page of a raster format such as TIFF, PNG, PPM and BMP. In general, this is done by DISINI at the beginning of a plot.
The call is: | CALL ERASE | level 1, 2, 3 |
or: | void erase (void); |
Normally, the graphical output to the screen is buffered. To send the buffer to the screen, the routine SENDBF can be used.
The call is: | CALL SENDBF | level 1, 2, 3 |
or: | void sendbf (void); |
The routine OPNWIN creates a new window for graphics output on the screen.
The call is: | CALL OPNWIN (ID) | level 1, 2, 3 |
or: | void opnwin (int id); |
ID | is the window number between 1 and 8. |
Additional notes:
The routine CLSWIN closes a window created with OPNWIN.
The call is: | CALL CLSWIN (ID) | level 1, 2, 3 |
or: | void clswin (int id); |
ID | is the window number between 1 and 8. |
The routine SELWIN selects a window on the screen where the following graphics output will be sent to.
The call is: | CALL SELWIN (ID) | level 1, 2, 3 |
or: | void selwin (int id); |
ID | is the window number between 1 and 8. |
The routine WINID returns the ID of the currently selected window.
The call is: | CALL WINID (ID) | level 1, 2, 3 |
or: | ind winid (void); |
ID | is the returned window number. |
The routine WINTIT changes the window title of the currently selected window.
The call is: | CALL WINTIT (CSTR) | level 1, 2, 3 |
or: | void wintit (char *cstr); |
CSTR | is a character string containing the new window title. |
The routine CSRPOS sets the position of the mouse pointer and returns the position if a character key or a mouse button is pressed. This routine can be used for cursor navigation.
The call is: | CALL CSRPOS (NX, NY, IKEY) | level 1, 2, 3 |
or: | int csrpos (int *nx, int *ny); |
NX, NY | are integer coordinates. On entry, the mouse pointer is set to the position (NX, NY). If a character key is pressed, the position of the mouse is returned in NX and NY. |
IKEY | is the returned ASCII code for the pressed key. The cursor keys can also be used where the following values are returned: 1 for cursor left, 2 for cursor up, 3 for cursor right, 4 for cursor down. The value 5 is returned if the left mouse button is clicked, and the value 6 for the right mouse button. The value -1 is returned if an error occured. |
Additional note:
The routine CSRPT1 returns the position of the mouse pointer if the mouse button 1 is pressed. The mouse pointer is changed to a cross hair pointer in the graphics window if CSRPT1 is active.
The call is: | CALL CSRPT1 (NX, NY) | level 1, 2, 3 |
or: | void csrpt1 (int *nx, int *ny); |
NX, NY | are the returned coordinates of the pressed mouse pointer. |
The routine CSRPTS returns an array of mouse positions. The routine is waiting for mouse button 1 clicks and terminates if mouse button 2 is pressed. The mouse pointer is changed to a cross hair pointer in the graphics window.
The call is: | CALL CSRPTS (NXRAY, NYRAY, NMAX, N, IRET) | level 1, 2, 3 |
or: | void csrpts (int *nxray, int *nyray, int nmax, int *n, int *iret); |
NXRAY, NYRAY | are the returned coordinates of the collected mouse positions. |
NMAX | is the dimension of NXRAY and NYRAY and defines the maximal number of points that will be stored in NXRAY and NYRAY. |
N | is the number of points that are returned in NXRAY and NYRAY. |
IRET | is a returned status. IRET not equal 0 means that not all mouse movements could be stored in NXRAY and NYRAY. |
The routine CSRMOV returns an array of mouse movements. The routine collects the mouse movements of mouse button 1 and terminates if mouse button 1 is released. The mouse pointer is changed to a cross hair pointer in the graphics window.
The call is: | CALL CSRMOV (NXRAY, NYRAY, NMAX, N, IRET) | level 1, 2, 3 |
or: | void csrmov (int *nxray, int *nyray, int nmax, int *n, int *iret); |
NXRAY, NYRAY | are the returned coordinates of the collected mouse movements. |
NMAX | is the dimension of NXRAY and NYRAY and defines the maximal number of points that will be stored in NXRAY and NYRAY. |
N | is the number of points that are returned in NXRAY and NYRAY. |
IRET | is a returned status. IRET not equal 0 means that not all mouse positions could be stored in NXRAY and NYRAY. |
The routine CSRMOD modifies the behavior of CSRPOS.
The call is: | CALL CSRMOD (CMOD, CKEY) | level 1, 2, 3 |
or: | void csrmod (char *cmod, char *ckey); |
CMOD | is a character string that can have the values 'STANDARD', 'SET', 'GET' and 'READ'. With the keywords 'SET' and 'GET' the cursor position can be defined or requested without waiting for an user event. The value 'READ' means that the cursor position is not set at the entry of CSRPOS. The value 'STANDARD' means the default behavior of CSRPOS. |
CKEY | is a character string that can have the value 'POS'. Default: ('STANDARD', 'POS'). |
The routine CSRUNI defines if pixels or plot coordinates are returned by the cursor routines.
The call is: | CALL CSRUNI (COPT) | level 1, 2, 3 |
or: | void clruni (char *copt); |
COPT | is a character string that can have the values 'PIXEL' and 'PLOT'. Default: COPT = 'PLOT'. |
Additional note:
The routine CSRTYP defines the cursor used by the cursor routine.
The call is: | CALL CSRTYP (COPT) | level 1, 2, 3 |
or: | void csrtyp (char *copt); |
COPT | is a character string that can have the values 'NONE', 'CROSS', 'ARROW' and 'VARROW'. 'NONE' means that the current cursor is not changed. Default: COPT = 'CROSS'. |
The routine SETCSR defines the cursor that is used by the DISLIN graphics window.
The call is: | CALL SETCSR (COPT) | level 1, 2, 3 |
or: | void setcsr (char *copt); |
COPT | is a character string that can have the values 'ARROW', 'CROSS' and 'VARROW'. Default: COPT = 'ARROW'. |
The routine IMGINI initializes transfering of image data with the routines RPIXEL, RPIXLS, RPXROW, WPIXEL, WPIXLS and WPXROW. If the output format is PostScript or PDF, IMGINI creates a virtual image where image data can be written to.
The call is: | CALL IMGINI | level 1, 2, 3 |
or: | void imgini (void); |
The routine IMGFIN terminates transfering of image data with the routines RPIXEL, RPIXLS, RPXROW, WPIXEL, WPIXLS and WPXROW. If the output format is PostScript or PDF, the virtual image created in IMGINI is copied to the PostScript or PDF file.
The call is: | CALL IMGFIN | level 1, 2, 3 |
or: | void imgfin (void); |
The routine RPIXEL reads one pixel from memory.
The call is: | CALL RPIXEL (IX, IY, ICLR) | level 1, 2, 3 |
or: | void rpixel (int ix, int iy, int *iclr); |
IX, IY | is the position of the pixel in screen coordinates. |
ICLR | is the returned colour value of the pixel. |
The routine WPIXEL writes one pixel into memory.
The call is: | CALL WPIXEL (IX, IY, ICLR) | level 1, 2, 3 |
or: | void wpixel (int ix, int iy, int iclr); |
IX, IY | is the position of the pixel in screen coordinates. |
ICLR | is the new colour value of the pixel. |
The routine RPIXLS copies colour values from a rectangle in memory to an array.
The call is: | CALL RPIXLS (IRAY, IX, IY, NW, NH) | level 1, 2, 3 |
or: | void rpixls (unsigned char *iray, int ix, int iy, int nw, int nh); |
IRAY | is a byte array containing the returned colour values. |
IX, IY | contain the starting point in screen coordinates. |
NW, NH | are the width and height of the rectangle in screen coordinates. |
The routine WPIXLS copies colour values from an array to a rectangle in memory.
The call is: | CALL WPIXLS (IRAY, IX, IY, NW, NH) | level 1, 2, 3 |
or: | void wpixls (unsigned char *iray, int ix, int iy, int nw, int nh); |
IRAY | is a byte array containing the colour values. |
IX, IY | contain the starting point in screen coordinates. |
NW, NH | are the width and height of the rectangle in screen coordinates. |
The routine RPXROW copies one line of colour values from memory to an array.
The call is: | CALL RPXROW (IRAY, IX, IY, N) | level 1, 2, 3 |
or: | void rpxrow (unsigned char *iray, int ix, int iy, int n); |
IRAY | is a byte array containing the returned colour values. |
IX, IY | contain the starting point in screen coordinates. |
N | is the number of pixels. |
The routine WPXROW copies colour values from an array to a line in memory.
The call is: | CALL WPXROW (IRAY, IX, IY, N) | level 1, 2, 3 |
or: | void wpxrow (unsigned char *iray, int ix, int iy, int n); |
IRAY | is a byte array containing the colour values. |
IX, IY | contain the starting point in screen coordinates. |
N | is the number of pixels. |
Additional note:
The routine IMGMOD defines palette or truecolour mode for the routines RPIXLS, WPIXLS, RPXROW and WPXROW. For palette mode, the byte arrays in the routines above must contain colour indices between 0 and 255. For truecolour mode, the byte arrays must contain RGB values (8 bit for each value).
The call is: | CALL IMGMOD (CMOD) | level 1, 2, 3 |
or: | void imgmod (char *cmod); |
CMOD | is a character string that can contain the values 'INDEX' and 'RGB'. Default: CMOD = 'INDEX'. |
If the output format is PostScript or PDF, the size of images can be defined with the routine IMGSIZ. The routine must be called before IMGINI.
The call is: | CALL IMGSIZ (NW, NH) | level 1, 2, 3 |
or: | void imgsiz (int nw, int nh); |
NW, NH | are the image width and height in pixels. Default: (853, 603). |
If the output format is PostScript or PDF, a rectangle on the output page can be specified where the image is copied to. The routine IMGBOX must be called before IMGINI.
The call is: | CALL IMGBOX (NX, NY, NW, NH) | level 1, 2, 3 |
or: | void imgbox (int nx, int ny, int nw, int nh); |
NX, NY | is the upper left corner of the rectangle on the page in plot coordinates. |
NW, NH | are the width and height of the rectangle in plot coordinates. NW and NH should have the same ratio as the image that is copied to the rectangle. The default rectangle is the full page. |
The routine RIMAGE copies an image from memory to a file.
The call is: | CALL RIMAGE (CFIL) | level 1, 2, 3 |
or: | void rimage (char *cfil); |
CFIL | is the name of the output file. A new file version will be created for existing files (see FILMOD). |
Additional notes:
The routine WIMAGE copies an image from a file to memory.
The call is: | CALL WIMAGE (CFIL) | level 1, 2, 3 |
or: | void wimage (char *cfil); |
CFIL | is the name of the input file. |
The routine RTIFF copies an image from memory to a file. The image is stored in the device-independent TIFF format.
The call is: | CALL RTIFF (CFIL) | level 1, 2, 3 |
or: | void rtiff (char *cfil); |
CFIL | is the name of the output file. A new file version will be created for existing files (see FILMOD). |
Additional notes:
The routine WTIFF copies a TIFF file created by DISLIN from a file to memory.
The call is: | CALL WTIFF (CFIL) | level 1, 2, 3 |
or: | void wtiff (char *cfil); |
CFIL | is the name of the input file. |
Additional note:
The routine TIFORG defines the upper left corner of the screen where the TIFF file is copied to.
The call is: | CALL TIFORG (NX, NY) | level 1, 2, 3 |
or: | void tiforg (int nx, int ny); |
NX, NY | is the upper left corner in screen coordinates. |
The routine TIFWIN defines a clipping window of the TIFF file that can be copied with the routine WTIFF to the screen.
The call is: | CALL TIFWIN (NX, NY, NW, NH) | level 1, 2, 3 |
or: | void tifwin (int nx, int ny, int nw, int nh); |
NX, NY | is the upper left corner of the clipping window in pixels. |
NW, NH | are the width and height of the clipping window in pixels. |
The routine RGIF copies an image from memory to a GIF file.
The call is: | CALL RGIF (CFIL) | level 1, 2, 3 |
or: | void rgif (char *cfil); |
CFIL | is the name of the output file. A new file version will be created for existing files (see FILMOD). |
The routine RPNG copies an image from memory to a PNG file.
The call is: | CALL RPNG (CFIL) | level 1, 2, 3 |
or: | void rpng (char *cfil); |
CFIL | is the name of the output file. A new file version will be created for existing files (see FILMOD). |
The routine RBFPNG copies an image from memory as a PNG file to a buffer.
The call is: | CALL RBFPNG (CBUF, NMAX, N) | level 1, 2, 3 |
or: | int rbfpng (char *cbuf, int nmax); |
CBUF | is a character buffer where the image is copied to in PNG format. |
NMAX | defines how many bytes can be copied to CBUF. If NMAX = 0, the size of the PNG file is returned in N without copying the PNG file to CBUF. |
N | is the returned length of the buffer. N <= 0, if an error occurs. |
The routine RPPM copies an image from memory to a PPM file.
The call is: | CALL RPPM (CFIL) | level 1, 2, 3 |
or: | void rppm (char *cfil); |
CFIL | is the name of the output file. A new file version will be created for existing files (see FILMOD). |
The routine RBMP copies an image from memory to a BMP file.
The call is: | CALL RBMP (CFIL) | level 1, 2, 3 |
or: | void rbmp (char *cfil); |
CFIL | is the name of the output file. A new file version will be created for existing files (see FILMOD). |
The routine IMGCLP defines a clipping region for the routines RTIFF, RGIF, RPNG, RPPM and RBMP for copying the graphics window to an output file.
The call is: | CALL IMGCLP (NX, NY, NW, NH) | level 1, 2, 3 |
or: | void imgclp (int nx, int ny, int nw, int nh); |
NX, NY | is the upper left corner of the rectangle in pixels. |
NW, NH | are the width and height of the rectangle in pixels. |
The routine PDFBUF copies a PDF file from memory to an user buffer. The routine must be called after DISFIN and PDF buffer output must be enabled with the statment CALL PDFMOD ('ON', 'BUFFER') before DISINI.
The call is: | CALL PDFBUF (CBUF, NMAX, N) | level 1, 2, 3 |
or: | int pdfbuf (char *cbuf, int nmax); |
CBUF | is a character buffer where the PDF file is copied to. |
NMAX | defines how many bytes can be copied to CBUF. If NMAX = 0, the size of the PDF file is returned in N without copying the PDF file to CBUF. |
N | is the returned length of the buffer. N <= 0, if an error occurs. |
The routine MPSLOGO plots the new MPS logo.
The call is: | CALL MPSLOGO (NX, NY, NSIZE, COPT) | level 1, 2, 3 |
or: | void mpslogo (int nx, int ny, int nsize, char *copt); |
NX, NY | defines the position of the MPSLOGO (upper left corner, plot coordinates). |
NSIZE | defines the size of the MPSLOGO. NSIZE cam have the pixel values 100, 125, 150, 175, 200 and 300. |
COPT | is a character option that can have the values 'NOTEXT' and 'TEXT'. |
Additional note: