Class: TFontTransformStyle

Declaration: FontStyles.h

Taxonomy Categories:

Member Functions:

Interface Category:

API.

Inherits From:

TFontStyle

Inherited By:

None.

Purpose:

TFontTransformStyle derives from TFontStyle and specifies the transformation matrix for the font. A font, like any other graphic, can be transformed (translated, rotated, and scaled). These transformations are in addition to any scaling specified with TFontScaleStyle and its derived classes. The effect of this style is to transform each glyph about its midpoint on the baseline. Any translations in the specified transformation matrix are discarded.

Instantiation:

Allocate on the heap or the stack.

Deriving Classes:

Derive a class from this class for any specialization. The value returned from GetCategory should be preserved and the pure virtual function GetName must be overridden to return an unique name.

Concurrency:

Multithread safe.

Resource Use:

No special requirements.

Member Function: TFontTransformStyle::~TFontTransformStyle

virtual ~ TFontTransformStyle ()

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:

Multithread safe.

Other Considerations:

None.

Member Function: TFontTransformStyle::operator=

TFontTransformStyle & operator =(const TFontTransformStyle &)

Interface Category:

API.

Purpose:

Assignment operator.

Calling Context:

Call this function by using the operator in an assignment statement.

Parameters:

const TFontTransformStyle & -The object to be copied.

Return Value:

A non-const reference to the left-hand side object.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Multithread safe.

Other Considerations:

None.

Member Function: TFontTransformStyle::operator==

virtual bool operator ==(const TStyle &) const

Interface Category:

API.

Purpose:

Tests whether two objects are equal.

Calling Context:

Call this function by using the operator in an expression.

Parameters:

const TFontTransformStyle & -The object to be compared to this object.

Return Value:

Returns true if the two objects are equal.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Multithread safe.

Other Considerations:

None.

Member Function: TFontTransformStyle::operator>>=

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

Interface Category:

API.

Purpose:

Stream-out operator.

Calling Context:

Called to stream out data.

Parameters:

TStream & toWhere -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:

Multithread safe.

Other Considerations:

None.

Member Function: TFontTransformStyle::operator<<=

virtual TStream & operator <<= (TStream & fromWhere)

Interface Category:

API.

Purpose:

Stream-in operator.

Calling Context:

Called to stream in data.

Parameters:

TStream & fromWhere -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:

Multithread safe.

Other Considerations:

None.

Member Function: TFontTransformStyle::GetDefaultFontTransformStyle

static const TFontTransformStyle & GetDefaultFontTransformStyle ()

Interface Category:

API.

Purpose:

Returns an empty transform style. This empty TFontStyle object is used as a key for finding other TFontStyles objects in a TStyleSet by using the search functions of TStyleSet.

Calling Context:

Call this function directly.

Parameters:

Takes no parameters.

Return Value:

Returns an empty transform style.

Exceptions:

Throws TGraphicsInternalException when FontServer is not accessible, passes all other exceptions through.

Concurrency:

Multithread safe.

Other Considerations:

None.

Member Function: TFontTransformStyle::GetFontMatrix

virtual void GetFontMatrix (TGrafMatrix &) const

Interface Category:

API.

Purpose:

Returns the TGrafMatrix associated with this font.

Calling Context:

Call this function directly.

Parameters:

TGrafMatrix & -The TGrafMatrix returned by this function.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Multithread safe.

Other Considerations:

None.

Member Function: TFontTransformStyle::Hash

virtual long Hash () const

Interface Category:

API.

Purpose:

Returns the hash value of this object.

Calling Context:

Call this function directly.

Parameters:

Takes no parameters.

Return Value:

The hash value of this object.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Multithread safe.

Other Considerations:

None.

Member Function: TFontTransformStyle::TFontTransformStyle

TFontTransformStyle ()
TFontTransformStyle (const TGrafMatrix &)
TFontTransformStyle (const TFontTransformStyle &)

Interface Category:

API.

Purpose:

Default constructor.
Creates a new TFontTransformStyle object and initializes the transformation to the specified TGrafMatrix's value.
Copy constructor.

Calling Context:

Called by the stream-in operators.
Call this function directly.
Called to copy an object.

Parameters:

Takes no parameters.
const TGrafMatrix & -The initial transformation matrix for this object.
const TFontTransformStyle & -The object to be copied.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Multithread safe.

Other Considerations:

None.

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