IBaseRootGrafPort

An IBaseRootGrafPort represents the top port of a port hierarchy. The IBaseRootGrafPort class represents the top port of a port hierarchy. IBaseRootGrafPort uses an ideal coordinate, which is expressed in point size (1/72 inch) to draw graphics. You cannot copy or copy construct objects of this class.


IBaseRootGrafPort - Member Functions and Data by Group

Constructors & Destructor

Use these functions to construct and destroy IBaseRootGrafPort objects.


[view class]
~IBaseRootGrafPort
public:
virtual ~IBaseRootGrafPort()
Destroys an IBaseRootGrafPort object.

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


[view class]
IBaseRootGrafPort
public:
IBaseRootGrafPort( const IPresSpaceHandle& deviceContextToBeAdopted, IColorMap* colormap = & ( IColorMap::defaultColorMap ( ) ) )
Constructs an IBaseRootGrafPort object, which represents the top port of a port hierarchy.
Use this constructor to create an IBaseRootGrafPort that adopts the given IPresSpaceHandle and IColorMap.

deviceContextToBeAdopted
The IPresSpaceHandle to be adopted.
colormap
The IColorMap to be adopted.

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


Converting from Pixel to Pointsize

Use the functions in this group to convert coordinates from pixels to points.


[view class]
pixelToPointSize
public:
virtual const IGrafMatrix& pixelToPointSize() const
Converts from device coordinate which is in pixel to "ideal" coordinate which is in point size ( 1/72 inch).

Return
Returns a conversion matrix from pixel size to point size.

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


Defining a Coordinate System

Use the function in this group to set up the coordinate system for the top graphics port in a port hierarchy.


[view class]
setupCoordinateSystem
protected:
void setupCoordinateSystem(int coordinateSystem)
Sets up coordinate system. Default is left-hand coordinate system.

coordinateSystem
The specified coordinate system.

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


Inverting the Device Transformation

Use the function in this group to invert the device transformation to its logical coordinate system.


[view class]
invertedDeviceTransform
public:
virtual const IGrafMatrix& invertedDeviceTransform() const
Inverts the device tranformation back to its logical coordinate system.

Return
A constant reference to the inverted device transformation matrix.

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


Marking the Graphics State

Use the functions in this group to mark the graphics state as either in use or not in use.


[view class]
doneWithState
public:
virtual void doneWithState() const
Marks the graphic state as being no longer in use so that changes to the state can be made.

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


[view class]
useState
public:
virtual void useState() const
Marks the graphic state as being in use so that no changes to the state are made until doneWithState is called.

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


Obtaining Information About the Graphics Device

Use the function in this group to obtain the bounding rectangle of a graphics device.


[view class]
worldBounds
public:
IGRect2D worldBounds() const
Returns the bounding rectangle of the IGrafDevice in world coordinates.

Return
The bounding rectangle.

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


Obtaining IXDC information on AIX

Use the functions in this group to obtain IXDC information on AIX.


[view class]
display
public:
virtual _XDisplay* display() const

Gets the IXDC display information.

Supported Platforms

Windows OS/2 AIX
No No Yes


[view class]
drawable
public:
virtual unsigned long drawable() const

Gets the IXDC drawable information.

Supported Platforms

Windows OS/2 AIX
No No Yes


[view class]
gc
public:
virtual _XGC* gc() const

Gets the IXDC gc information.

Supported Platforms

Windows OS/2 AIX
No No Yes


IBaseRootGrafPort - Inherited Member Functions and Data

Inherited Public Functions

IGrafPort

Inherited Public Data

Inherited Protected Functions

IGrafPort

Inherited Protected Data