GPR_$SET_SPACE_SIZE               GPR Calls                GPR_$SET_SPACE_SIZE


NAME
     gpr_$set_space_size - specifies the amount of horizontal space to leave
     blank when printing a character not defined in the current font.

FORMAT
     gpr_$set_space_size (font_id, space_size, status)

DESCRIPTION
     This routine specifies the amount of horizontal space to leave blank when
     printing a character not defined in the current font.  The space size is
     the number of pixels to skip in the horizontal direction when you write a
     character that is not in the font.  Space size is not the size of the
     space character.  To set the size of the space character use
     gpr_$set_char_width.

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

     space_size
          Space size is the number of pixels to skip in the horizontal direc-
          tion when you include a character that is not in the font. 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_space_size, gpr_$replicate_font, gpr_$set_character_width,
     gpr_$set_horizontal_spacing, gpr_$set_space_size.

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

     To   use   routines   that   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.