pad_use_font()

PAD_$USE_FONT                     Domain/OS                      PAD_$USE_FONT


NAME
     pad_$use_font - use a new loaded font

SYNOPSIS (C)
     #include <apollo/base.h>
     #include <apollo/pad.h>

     void pad_$use_font(
          ios_$id_t &stream_id,
          short &font_id,
          status_$t *status)

SYNOPSIS (Pascal)
     %include '/sys/ins/base.ins.pas';
     %include '/sys/ins/pad.ins.pas';

     procedure pad_$use_font(
          in stream_id: ios_$id_t;
          in font_id: integer;
          out status: status_$t);

SYNOPSIS (FORTRAN)
     %include '/sys/ins/base.ins.ftn'
     %include '/sys/ins/pad.ins.ftn'

           integer*4 status
           integer*2 stream_id, font_id

           call pad_$use_font(stream_id, font_id, status)

DESCRIPTION
     Pad_$use_font changes a pad's current text font.  The font must be loaded
     with pad_$load_font before it is invoked with pad_$use_font.

     stream_id
          The stream ID of a pad.

     font_id
          The font ID of the new font.  The font ID is returned by
          pad_$load_font when the font is loaded.  The font must have been
          loaded in the pad specified by stream_id before calling
          pad_$use_font.

     status
          The completion status.

NOTES
     Call pad_$inq_font to find out the font currently in use for the pad.

SEE ALSO
     pad_$set_scale.
Museum
