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 millimeters. 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 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