INQUIRE_SIZES(3G)

NAME

inquire_sizes − return device physical limits, resolution, (p1,p2) and color map size

SYNOPSIS

C Syntax:

void inquire_sizes(fildes,physical_limits,resolution,
p1,p2,cmap_size);
int fildes;
float physical_limits[2][3],resolution[3],p1[3],p2[3];
int *cmap_size

FORTRAN77 Syntax:

subroutine inquire_sizes(fildes,physical_limits,
resolution,p1,p2,cmap_size)
integer*4 fildes,cmap_size
real physical_limits(3,2),resolution(3),p1(3),p2(3)

Pascal Syntax:

procedure inquire_sizes(fildes:integer;
var physical_limits:three_d_limits;
var resolution:three_d_resolution; var p1,p2:three_d_point;
var cmap_size:integer);

DESCRIPTION

Input Parameters

fildes Integer file descriptor returned by gopen when an I/O path to a graphics device is opened.

Output Parameters

physical_limits
Device’s accessible area in device coordinates (z=0 for 2D devices).

resolution Number of millimeters per device coordinate unit.

p1,p2 Physical device limits in millimetres. p1 and p2 are the points (lower-left and upper-right respectively) that define the device viewport that the vdc_extent is mapped to, using the vdc_justification and mapping_mode. The Starbase command set_p1_p2 can be used to redefine p1 and p2 (z=0 for 2-Dimensional devices).

cmap_size Number of entries in the device’s color map.

Discussion

The following values are returned (C syntax):

physical_limit [0][0]: Lower-left: x

physical_limit [0][1]: Lower-left: y

physical_limit [0][2]: Lower-left: z

physical_limit [1][0]: Upper-right: x

physical_limit [1][1]: Upper-right: y

physical_limit [1][2]: Upper-right: z

The resolution, p1 and p2 values are returned in (x,y,z) order.

Museum

Related Articles