GMF_$INTRO Domain/OS GMF_$INTRO
NAME
intro - using graphics metafiles
SYNOPSIS (C)
#include <apollo/base.h>
#include <apollo/gmf.h>
SYNOPSIS (Pascal)
%include '/sys/ins/base.ins.pas';
%include '/sys/ins/gmf.ins.pas';
SYNOPSIS (FORTRAN)
%include '/sys/ins/base.ins.ftn'
%include '/sys/ins/gmf.ins.ftn'
DESCRIPTION
The gmf_$ calls provide a simple interface whereby old programs can save
bitmaps into graphics metafiles, and restore them from graphics
metafiles. New applications should not use these calls to save or
restore bitmaps; they should use GPR bitmap files instead. These GMF
metafiles are not in any way related to the metafiles created by the 2D
GMR or 3D GMR (Graphics Metafile Resource) packages.
The following is a list of the gmf_$ calls.
gmf_$close close a GMF
gmf_$copy_plane copy a bitmap plane to a GMF
gmf_$copy_subplane copy part of a bitmap plane to a GMF
gmf_$open open a GMF
gmf_$restore_plane restore a bitmap from a GMF
Data Types
gmf_$opos_t
An enumerated type for modifying the result of a gmf_$open call. It
takes one of the following values:
gmf_$overwrite
Open the file for writing and truncate if it exists. The file
pointer is initialized to the beginning of the file (BOF), and
the contents of the file are lost.
gmf_$append
Open the file for writing and initialize the file pointer to
the end of the file (EOF). Use this to append image data to an
existing GMF.
gmf_$read
Open the file for reading only, and initialize the file pointer
to the beginning of the file (BOF).
gmf_$memory_t
An array of 65535 2-byte integers.
gmf_$memory_ptr_t
A pointer to an array of type gmf_$memory_t.
Errors
gmf_$bad_bpi
The supplied bits-per-inch parameter is negative.
gmf_$bad_pos
The supplied opening position (open option) value is not one of the
valid predefined values.
gmf_$bad_wpl
The words-per-line parameter is too small for the x-dimension.
gmf_$bad_x_dim
The x-dimension is not positive.
gmf_$bad_y_dim
The y-dimension is not positive.
gmf_$not_gmf
The indicated file is not a graphics metafile.