%N pgqcs %F $MIR/src/pgqcs.f
%D Inquire character height in a variety of units
%B
      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.
