GPR_$INQ_CHARACTER_WIDTH          GPR Calls           GPR_$INQ_CHARACTER_WIDTH


NAME
     gpr_$inq_character_width - returns a character width.

FORMAT
     gpr_$inq_character_width (font_id, character, width, status)

DESCRIPTION
     This routine returns the width of a specified character in the specified
     font.  The initial character widths are defined in the font file.

     This routine returns the character width in the local copy of the returns
     a character width.  font.  Initially, this is a copy of the font file;
     but the local copy may have been changed.  Change in the local copy does
     not affect the font file or the use of the font by other processes.

   Input Parameters
     font_id
          Identifier of the text font.  This is a 2-byte integer.

     character
          The specified character.  This is a character variable.

   Output Parameters
     width
          The width parameter (in pixels) of the specified character.  This is
          a 2-byte integer.  Possible values are -127 to 127.

     status
          Completion status, in status_$t format.

SEE ALSO
     gpr_$set_character_width, gpr_$inq_character16_width.

NOTES
     If the specified character is not in the font, GPR returns a status of
     gpr_$character_not_in_font.

     To inquire the width of a 16-bit character call
     gpr_$inq_character16_width.