AITransformArtSuite Struct Reference
[API Suite List]
This suite provides a function that transforms an art object of any type by a given transformation matrix, making special transformation routines for the different art types unnecessary.
More...
#include <AITransformArt.h>
List of all members.
Detailed Description
This suite provides a function that transforms an art object of any type by a given transformation matrix, making special transformation routines for the different art types unnecessary.
- Text art, raster art, and placed art objects have associated transformation matrices. Functions such as
AIRasterSuite::GetRasterMatrix() in the related suites provide access to the matrices. TransformArt() does not use the associated matrix, but instead uses a matrix that you pass to the function.
- Path art objects are simple collections of connected line segments, and do not have an associated transformation matrix. For these, you must use the
TransformArt() function.
Acquire this suite using SPBasicSuite::AcquireSuite() with the constants kAITransformArtSuite and kAITransformArtSuiteVersion.
Member Data Documentation
Transforms an art object by a given transformation matrix.
- Parameters:
-
| art | The art object. |
| matrix | The transformation matrix. |
| lineScale | The scale factor to apply if the object has a stroke and the kScaleLines option is set. Expressed as a percentage in the range [0..1], where 1 is 100%, meaning no scaling. Calculate the appropriate linescale as a function of the horizontal and vertical scale factors of the matrix: lineScale = sqrt(Sx) * sqrt(Sy). |
| flags | Behavior options, a logical OR of AITransformArtOptions constants. |
- Note:
- This function does not do a "deep" transform; that is, it does not automatically traverse into the members of group or compound art objects. If you wish to do this, you must traverse the artwork tree and call the function on the member art objects.
The documentation for this struct was generated from the following file:
