Name: PGQCS Purpose: inquire character height in a variety of units Category: GRAPHICS File: pgplot.src Author: T.J. Pearson Use: see description below. Description: SUBROUTINE PGQCS(UNITS, XCH, YCH) INTEGER UNITS REAL XCH, YCH Return the current PGPLOT character height in a variety of units. This routine provides facilities that are not available via PGQCH. Use PGQCS if the character height is required in units other than those used in PGSCH. The PGPLOT "character height" is a dimension that scales with the size of the view surface and with the scale-factor specified with routine PGSCH. The default value is 1/40th of the height or width of the view surface (whichever is less); this value is then multiplied by the scale-factor supplied with PGSCH. Note that it is a nominal height only; the actual character size depends on the font and is usually somewhat smaller. Arguments: UNITS (input) : Used to specify the units of the output value: UNITS = 0 : normalized device coordinates UNITS = 1 : inches UNITS = 2 : millimeters UNITS = 3 : pixels UNITS = 4 : world coordinates Other values give an error message, and are treated as 0. XCH (output) : The character height for text written with a vertical baseline. YCH (output) : The character height for text written with a horizontal baseline (the usual case). The character height is returned in both XCH and YCH. If UNITS=1 or UNITS=2, XCH and YCH both receive the same value. If UNITS=3, XCH receives the height in horizontal pixel units, and YCH receives the height in vertical pixel units; on devices for which the pixels are not square, XCH and YCH will be different. If UNITS=4, XCH receives the height in horizontal world coordinates (as used for the x-axis), and YCH receives the height in vertical world coordinates (as used for the y-axis). Unless special care has been taken to achive equal world-coordinate scales on both axes, the values of XCH and YCH will be different. If UNITS=0, XCH receives the character height as a fraction of the horizontal dimension of the view surface, and YCH receives the character height as a fraction of the vertical dimension of the view surface. Updates: Oct 16, 1998: JPT automatically extracted from source.