GPR_$SET_HORIZONTAL_SPACING       GPR Calls        GPR_$SET_HORIZONTAL_SPACING


NAME
     gpr_$set_horizontal_spacing - specifies the parameter for horizontal
     spacing of the specified font.

FORMAT
     gpr_$set_horizontal_spacing (font_id, horizontal_spacing, status)

DESCRIPTION
     This routine specifies the parameter for horizontal spacing of the speci-
     fied font.

     Horizontal spacing is the space between each character in a string.

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

     horizontal_spacing
          The horizontal spacing in pixels, relative to the spacing that
          already exists. 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_horizontal_spacing, gpr_$replicate_font,
     gpr_$set_character_width, gpr_$set_horizontal_spacing,
     gpr_$set_space_size.

NOTES
     The initial horizontal spacing is 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.