DvInqBackgroundJust(3D)

NAME
DvInqBackgroundJust - Return the background raster justification

SYNOPSIS
C:
void DvInqBackgroundJust(view, left, bottom)
DtObject view;
DtReal *left;
DtReal *bottom;

FORTRAN:
CALL DVQBJ(VIEW, LEFT, BOT)
INTEGER*4 VIEW
REAL*8 LEFT
REAL*8 BOT

DESCRIPTION

DvInqBackgroundJust returns the justification of the background raster in the specified view view. When the aspect ratios of the view and the background raster returned from the background raster callback are not the same, there will be extra "white space" in the view. The justification provides a mechanism for controlling where this white space is positioned.

The left parameter defines a value between 0.0 and 1.0 inclusive specifying the fraction of white space to be inserted between the bottom left hand corner of the view and the left side of the raster. Similarly, the bottom parameter specifies the fraction of white space to be inserted between the bottom left hand corner of the view and the bottom of the raster.

If the raster is larger than the view, left and bottom specify the portion of the raster that will be cropped from the bottom left hand corner.

ERRORS
DvInqBackgroundJust will fail if the view handle is invalid.

[WARNING - invalid view handle]

SEE ALSO
DvSetBackgroundJust(3D), DvSetBackgroundRaster(3D), DvInqBackgroundRaster(3D), DsInqRaster(3D)