gpr_inq_character16_width(A)

GPR_$INQ_CHARACTER16_WIDTH        GPR Calls         GPR_$INQ_CHARACTER16_WIDTH


NAME
     gpr_$inq_character16_width - returns the width of a 16-bit character.

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

DESCRIPTION
     This routine returns the width of the specified 16-bit character in the
     specified font.

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

     character
          The specified 16-bit character.  This is an unsigned 2-byte integer.

   Output Parameters
     width
          The width (in pixels) of the specified 16-bit character.  The width
          is the distance from the origin of the specified character to the
          following current position.  This is a 2-byte integer.

     status
          Completion status, in status_$t format.

NOTES
     To set a 16-bit character's width, use gpr_$set_character16_width.

     The initial character widths are defined in the font file.

     This routine returns the 16-bit character width in the local copy of the
     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.

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