gpr_set_character16_width()

GPR_$SET_CHARACTER16_WIDTH        GPR Calls         GPR_$SET_CHARACTER16_WIDTH


NAME
     gpr_$set_character16_width - specifies the width of a 16-bit character.

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

DESCRIPTION
     This routine sets the width of the specified 16-bit character in the
     specified modifiable 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.

     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.

   Output Parameters
     status
          Completion status, in status_$t format.

NOTES
     To retrieve a 16-bit character's width, use gpr_$inq_character16_width.

     The initial character widths are defined in the font file.

     Negative widths are not supported.

     To use routines that change fonts, you must first call
     gpr_$replicate_font to create a modifiable copy of a font.  Font-
     modifying routines include gpr_$set_character_width,
     gpr_$set_horizontal_spacing, and gpr_$set_space_size, as well as
     gpr_$set_character16_width.  These calls change only the local copy of
     the font.  If you unload a font and reload it, the font is reset to the
     values in the font file.

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