pad_load_font()

PAD_$LOAD_FONT                    Domain/OS                     PAD_$LOAD_FONT


NAME
     pad_$load_font - load a character font

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

     void pad_$load_font(
          ios_$id_t &stream_id,
          char *font_name,
          short &name_length,
          short *font_id,
          status_$t *status)

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

     procedure pad_$load_font(
          in stream_id: ios_$id_t;
          in font_name: univ pad_$string_t;
          in name_length: integer;
          out 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, name_length, font_id
           character font_name*256

           call pad_$load_font(stream_id, font_name, name_length,
          &                    font_id, status)

DESCRIPTION
     A program can load up to 100 different character fonts in a pad with
     pad_$load_font.  Pad_$load_font does not change fonts.  It merely loads
     the font and returns a font ID by which to access it when needed.

     stream_id
          The stream ID for the pad to load the font in.

     font_name
          The pathname of the character font file to load.  The Display
          Manager first attempts to find the font file by using font_name
          directly.  If it fails to find an icon file at font_name, it
          searches in /sys/dm/fonts for the file.

     name_length
          The number of bytes in font_name.

     font_id
          The font identifier to be used in later calls to pad_$use_font.

     status
          The completion status.

NOTES
     After loading a font with pad_$load_font, a program can call
     pad_$use_font to use it.  Pad_$inq_font gets the name of the font
     currently used in a pad.

SEE ALSO
     pad_$inq_icon_font, pad_$set_icon_font.
Museum
