gpr_set_character_width() — Apollo Domain/OS SR10.3.5

GPR_$SET_CHARACTER_WIDTH          GPR Calls           GPR_$SET_CHARACTER_WIDTH


NAME
     gpr_$set_character_width - specifies the character width in the specified
     modifiable font.

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

DESCRIPTION
     This routine specifies the width of the specified character in the speci-
     fied modifiable font.

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

     character
          The specified character.  This is a character variable.

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

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

SEE ALSO
     gpr_$inq_character_width, gpr_$replicate_font, gpr_$set_character_width,
     gpr_$set_horizontal_spacing, gpr_$set_space_size,
     gpr_$set_character16_width.

NOTES
     The initial character widths are defined in the font file.

     To   use   routines   which   change   fonts,   you   must   first   call
     gpr_$replicate_font  to  create  a  modifiable copy of a font.  The font-
     modifying        routines        include        gpr_$set_character_width,
     gpr_$set_horizontal_spacing, and gpr_$set_space_size.  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.

     Negative widths are not supported.

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