DvSetBackgroundJust(3D)

NAME
DvSetBackgroundJust - Set the background raster justification

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

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

DESCRIPTION

DvSetBackgroundJust sets 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 "white space" will be the background color of the view.

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 of the raster.

ERRORS
DvSetBackgroundJust will fail if the view handle is invalid.

[WARNING - invalid view handle]

DEFAULTS
The default is left = 0.5 and bottom = 0.5 creating an even distribution of white space in both directions.

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