SbViewportRegion(3IV)

NAME
SbViewportRegion — class for representing a viewport

INHERITS FROM
SbViewportRegion

SYNOPSIS
#include <Inventor/SbViewportRegion.h>

Methods from class SbViewportRegion:

SbViewportRegion()

SbViewportRegion(short width, short height)

SbViewportRegion(SbVec2s winSize)

SbViewportRegion(const SbViewportRegion &vpReg)
void
setWindowSize(short width, short height)
void
setWindowSize(SbVec2s winSize)
void
setViewport(float left, float bottom, float width, float height)
void
setViewport(SbVec2f origin, SbVec2f size)
void
setViewportPixels(short left, short bottom, short width, short height)
void
setViewportPixels(SbVec2s origin, SbVec2s size)
const SbVec2s &
getWindowSize() const
const SbVec2f &
getViewportOrigin() const
const SbVec2s &
getViewportOriginPixels() const
const SbVec2f &
getViewportSize() const
const SbVec2s &
getViewportSizePixels() const
float
getViewportAspectRatio() const
void
scaleWidth(float ratio)
void
scaleHeight(float ratio)
void
setPixelsPerInch(float ppi)
float
getPixelsPerInch() const
float
getPixelsPerPoint() const
friend int
operator ==(const SbViewportRegion &reg1, const SbViewportRegion &reg2)

DESCRIPTION
This class represents the active viewport region in a display window. It contains the screen-space size of the window as well as the origin and size of the viewport within the window. By default, the viewport is the same as the full window. Methods allow the viewport to be set either in terms of screen-space pixels or as normalized coordinates, where (0,0) is the lower-left corner of the window and (1,1) is the upper-right corner.

METHODS

SbViewportRegion()

SbViewportRegion(short width, short height)

SbViewportRegion(SbVec2s winSize)

SbViewportRegion(const SbViewportRegion &vpReg)
Constructors of various kinds.

void
setWindowSize(short width, short height)
Changes window size to given width and height in pixels.

void
setWindowSize(SbVec2s winSize)
Changes window size to given width and height in pixels, given as SbVec2s.

void
setViewport(float left, float bottom, float width, float height)
Sets viewport to given region, specified as normalized window coordinates: (0,0) is the lower-left corner, (1,1) is the upper-right.

void
setViewport(SbVec2f origin, SbVec2f size)
Sets viewport to region with given origin (lower-left corner) and size, given as normalized coordinate vectors.

void
setViewportPixels(short left, short bottom, short width, short height)
Sets viewport to given region, specified as pixel coordinates in window: (0,0) is the lower-left corner.

void
setViewportPixels(SbVec2s origin, SbVec2s size)
Sets viewport to region with given origin (lower-left corner) and size, given as pixel coordinates.

const SbVec2s &
getWindowSize() const
Returns window size in pixels.

const SbVec2f &
getViewportOrigin() const
Returns viewport origin in normalized coordinates.

const SbVec2s &
getViewportOriginPixels() const
Returns viewport origin in pixels.

const SbVec2f &
getViewportSize() const
Returns viewport size in normalized coordinates.

const SbVec2s &
getViewportSizePixels() const
Returns viewport size in pixels.

float
getViewportAspectRatio() const
Returns aspect ratio (width/height) of viewport.

void
scaleWidth(float ratio)
void
scaleHeight(float ratio)
Scales viewport within window to be the given ratio of its current width or height, leaving the resulting viewport centered about the same point as the current one.

void
setPixelsPerInch(float ppi)
float
getPixelsPerInch() const
Sets/returns the pixel-per-inch ratio for the display device the viewport is part of. The default value is 72 (1 pixel per printer's point).

float
getPixelsPerPoint() const
Convenience function that returns number of pixels per printer's point.

friend int
operator ==(const SbViewportRegion &reg1, const SbViewportRegion &reg2)
Equality comparison operator.

FILE FORMAT/DEFAULTS

SEE ALSO
SbVec2f, SbVec2s