INQUIRE ANNOTATION FACILITIES(3P) — Kubota Pacfic Computer Inc. (29 February 1991)

NAME

INQUIRE ANNOTATION FACILITIES − inquire annotation text facilities on workstation type

SYNOPSIS

C Syntax

void
pinq_anno_facs ( type, length, start, error_ind, styles, total_length, num_char_hts,
min_char_ht, max_char_ht )
Pinttype;workstation type
Pintlength;length of application list
Pintstart;starting position
Pint∗error_ind;OUT error indicator
Pint_list∗styles;OUT list annotation styles
Pint∗total_length;OUT length of list in PHIGS
Pint∗num_char_hts; OUT number of character heights
Pfloat∗min_char_ht; OUT minimum character height
Pfloat∗max_char_ht; OUT maximum character height

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

INQUIRE ANNOTATION FACILITIES obtains a list of the annotation text facilities available on the specified workstation type.

C Input Parameters

typeWorkstation type.

lengthThe number of ints items in the styles output parameter for which the application has allocated memory. The length is the number of list elements (annotation styles) that the system can return in the list of integers in the Pint_list structure under styles. If a value of zero is used here, no data will be returned in this list, but the total number of annotation styles available on the specified workstation type will be returned in total_length.

startStarting position in the workstation type list of available annotation styles at which the inquiry is to begin. The elements of the list of annotation styles, beginning with the item number specified by start, are copied sequentially into the list of integers until it is full or all the annotation styles have been copied.

C Output Parameters

error_ind
A pointer to the location to store the error number of any error detected by this function.

stylesA pointer to a Pint_list structure in which the system returns the list of annotation styles available on the specified type of workstation. Pint_list is defined in phigs.h as follows:

typedef struct {
Pintnum_ints;/∗ number of Pints in list ∗/
Pint∗ints;/∗ list of integers ∗/
} Pint_list;

The num_ints component specifies the number of annotation styles in the list. The ints component is a pointer to a list, num_ints long, of the annotation styles. The application must allocate memory for length elements in the list of ints.

The defined values for the annotation styles are:

1PANNO_STYLE_UNCONNECTED
2PANNO_STYLE_LEAD_LINE

total_length
A pointer to an integer in which the total number of elements in the specified workstation type list of annotation styles is returned. This is the value required for length if all annotation styles are to be returned.

num_char_hts
A pointer to an integer in which the number of character heights is returned.

min_char_ht
A pointer to an integer in which the minimum character height is returned.

max_char_ht
A pointer to an integer in which the maximum character height is returned.

ERRORS

002Ignoring function, function requires state (PHOP, ∗, ∗, ∗)

052Ignoring function, workstation type not recognized by the implementation

051Ignoring function, this information is not yet available for this workstation type; open a workstation of this type and use the specific workstation type

059Ignoring function, the specified workstation does not have output capability (i.e., the workstation category is neither OUTPUT, OUTIN, nor MO)

062Ignoring function, this information is not available for this MO workstation type

Museum