Class: TAlpha8Gray8Image

Declaration: GraphicImage.h

Taxonomy Categories:

Member Functions:

Interface Category:

API.

Inherits From:

TModifiableImage

Inherited By:

None.

Purpose:

TAlpha8Gray8Image is a concrete 8-bit alpha gray image. Each pixel of this image is specified with 16 bits. These 16 bits are divided into two 8-bit components: alpha and gray. The alpha component specifies opacity or image transparency. The gray component forms a coordinate in luminance space. To derive an XYZcolor from this gray component, use the TColorProfile of the Image. The components are not premultiplied.

Instantiation:

Allocate on the heap or the stack.

Deriving Classes:

None.

Concurrency:

Not multithread safe.

Resource Use:

No special requirements.

Member Function: TAlpha8Gray8Image::TAlpha8Gray8Image

TAlpha8Gray8Image ()
TAlpha8Gray8Image (const TImage &)
TAlpha8Gray8Image (const TAlpha8Gray8Image &)
TAlpha8Gray8Image (const TGPoint & dstOrigin, long widthInPixels, long heightInPixels, TGPoint dpi =TGImage :: k72DPI, TGrafBundle * adoptBundle =NIL, TGImage :: EOrientation orientation =TGImage :: kIdentity, const TColorProfile & theProfile =* TColorProfile :: GetDefaultColorProfile (), const TGPoint & sourceOrigin =TGPoint ( 0, 0 ))
TAlpha8Gray8Image (const TGPoint & dstOrigin, const TGPoint & imageSizeInWorldSpace, TGPoint dpi =TGImage :: k72DPI, TGrafBundle * adoptBundle =NIL, TGImage :: EOrientation orientation =TGImage :: kIdentity, const TColorProfile & theProfile =* TColorProfile :: GetDefaultColorProfile (), const TGPoint & sourceOrigin =TGPoint ( 0, 0 ))

Interface Category:

API.

Purpose:

Default constructor.
Creates a TAlpha8Gray8Image from another type of image.
Copy constructor.
Creates a TAlpha8Gray8Image initialized with the given parameters.
Creates a TAlpha8Gray8Image initialized with the given parameters.

Calling Context:

Called by the stream-in operators.
Call to create a TAlpha8Gray8Image from another type of image.
Called to copy an object.
Call to create a new TAlpha8Gray8Image.
Call to create a new TAlpha8Gray8Image.

Parameters:

Takes no parameters.
const TImage & -The image from which to construct the TAlpha8Gray8Image.
const TAlpha8Gray8Image & -The image to be copied.
const TGPoint & dstOrigin -The origin of the image in world space.
long widthInPixels -The width of the image measured in pixels.
long heightInPixels -The height of the image measured in pixels.
TGPoint dpi =TGImage :: k72DPI -The vertical and horizontal resolution of the image. The default value for both axes is 72 dpi.
TGrafBundle * adoptBundle =NIL -The initial attribute bundle for the image. The default value is NIL.
TGImage :: EOrientation orientation =TGImage :: kIdentity -The initial orientation for the image. The default value is kIdentity; the orientation of the image as stored in memory.
const TColorProfile & theProfile =* TColorProfile :: GetDefaultColorProfile () -The color profile for the image.
const TGPoint & sourceOrigin =TGPoint ( 0 , 0 ) -The offscreen origin for the image.
const TGPoint & dstOrigin -The origin of the image in world space.
const TGPoint & imageSizeInWorldSpace -The height and width of the image in world space.
TGPoint dpi =TGImage :: k72DPI -The vertical and horizontal resolution of the image. The default value for both axes is 72 dpi.
TGrafBundle * adoptBundle =NIL -The initial attribute bundle for the image. The default value is NIL.
TGImage :: EOrientation orientation =TGImage :: kIdentity -The initial orientation for the image. The default value is kIdentity; the orientation of the image as stored in memory.
const TColorProfile & theProfile =* TColorProfile :: GetDefaultColorProfile () -The color profile for the image.
const TGPoint & sourceOrigin =TGPoint ( 0 , 0 ) -The offscreen origin for the image.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TAlpha8Gray8Image::~TAlpha8Gray8Image

virtual ~ TAlpha8Gray8Image ()

Interface Category:

API.

Purpose:

Destructor.

Calling Context:

Called to destroy an object.

Parameters:

Takes no parameters.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TAlpha8Gray8Image::operator=

TAlpha8Gray8Image & operator =(const TAlpha8Gray8Image & source)

Interface Category:

API.

Purpose:

Assignment operator.

Calling Context:

Called when an object is assigned to another compatible object.

Parameters:

const TAlpha8Gray8Image & source -The image to be copied.

Return Value:

Returns a const reference to the left-hand side object.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TAlpha8Gray8Image::operator>>=

virtual TStream & operator >>=(TStream &) const

Interface Category:

API.

Purpose:

Stream-out operator.

Calling Context:

Called to stream out data.

Parameters:

TStream & -The stream to which the object streams itself out.

Return Value:

Returns a reference to the stream the object streams itself out to.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TAlpha8Gray8Image::operator<<=

virtual TStream & operator <<= (TStream &)

Interface Category:

API.

Purpose:

Stream-in operator.

Calling Context:

Called to stream in data.

Parameters:

TStream & -The stream from which the object streams itself in.

Return Value:

Returns a reference to the stream the object streams itself in from.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TAlpha8Gray8Image::CreateGrafDevice

virtual TGrafDevice * CreateGrafDevice ()

Interface Category:

API.

Purpose:

Creates a new rendering pipeline device for an image object.

Calling Context:

Called when no graphics device has been defined for the object.

Parameters:

Takes no parameters.

Return Value:

Returns a pointer to a new graphics device.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TAlpha8Gray8Image::GetSourceOrigin

virtual TGPoint GetSourceOrigin () const

Interface Category:

API.

Purpose:

Returns the defined origin for the source image of a given object.

Calling Context:

Called when the user needs to determine the origin of the source image.

Parameters:

Takes no parameters.

Return Value:

Returns the coordinate which corresponds to the location of the origin of the source image (in pixel space).

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Click the icon to mail questions or corrections about this material to Taligent personnel.