Class: TAdobeIllustratorConverter

Declaration: AdobeIllustrator.h

Taxonomy Categories:

Member Functions:

Interface Category:

API.

Inherits From:

None.

Inherited By:

None.

Purpose:

Converts an Encapsulated PostScript file to into a graphic. Currently it only understands the Adobe Illustrator subset of PostScript.

Instantiation:

Allocate on the heap or the stack.

Deriving Classes:

None.

Concurrency:

Not multithread safe.

Resource Use:

No special requirements.

Member Function: TAdobeIllustratorConverter::TAdobeIllustratorConverter

TAdobeIllustratorConverter ()

Interface Category:

API.

Purpose:

Default constructor.

Calling Context:

Called by clients to create a converter 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: TAdobeIllustratorConverter::ConvertFromTo

void ConvertFromTo (TStream & inputStream, TGraphicGroup & graphicGroup)

Interface Category:

API.

Purpose:

Converts the data on the input stream into a TGraphicGroup. The input stream is expected to be in Adobe Illustrator Encapsulated PostScript format. This converter does not understand all of PostScript, just the limited subset used in Adobe Illustrator 3.0.

Calling Context:

Called by clients who are importing object graphics into CommonPoint.

Parameters:

TStream & inputStream -The stream containing the Adobe Illustrator EPS data.
TGraphicGroup & graphicGroup -The output is appended to the end of this group.

Return Value:

None.

Exceptions:

Throws TAdobeIllustratorConverterException if the input stream is not an Adobe Illustrator EPS data stream, or if the input stream contains bad data. Passes all other exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

Not all of the Adobe Illustrator operations are supported. In particular, the W mask operator is not supported, and some of the text mask operations are not supported. If these operations, or other new operations, are encountered, they are silently ignored.

Member Function: TAdobeIllustratorConverter::SetDebugMode

void SetDebugMode (bool debugOn)

Interface Category:

API.

Purpose:

Sets the debugging flag. If the debugging flag is on, diagnostic information is printed.

Calling Context:

Called from a test program when debugging the converter, or when attempting to understand why a particular source stream is not being converted as expected.

Parameters:

bool debugOn -true to turn debugging on.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TAdobeIllustratorConverter::GetDebugMode

bool GetDebugMode () const

Interface Category:

API.

Purpose:

Returns the current state of the debug mode.

Calling Context:

Can be used by a user interface to learn the status of the debug mode.

Parameters:

Takes no parameters.

Return Value:

Returns true if debug mode is on.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

Rarely called.

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