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 2-D devices), except for the HP-GL device’s physical limits, which are the p1 and p2 limits.

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:

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.

Note: the direction and origin of the device coordinates reported in physical_limits is different for different devices. For bit-mapped displays, Windows/9000 windows, and X Window System windows, the device coordinate origin (x=0, y=0) is located in the upper left-hand corner of the window, with the coordinates increasing as you move downward and right. For graphics terminals, the device coordinate origin is located in the lower left-hand corner of the window with the coordinates increasing upward and right. For some plotters, the device coordinates origin is in the middle of the plotting surface.

Museum

Related Articles