AIRasterSuite Struct Reference
[API Suite List]

This suite provides functions with which to access and modify the data associated with an art object of type kRasterArt. More...

#include <AIRaster.h>

List of all members.

Public Attributes
AIAPI AIErr(*	GetRasterInfo )(AIArtHandle raster, AIRasterRecord *info)
	Retrieves the raster record associated with a raster art object.
AIAPI AIErr(*	SetRasterInfo )(AIArtHandle raster, AIRasterRecord *info)
	Associates a raster record with a raster art object.
AIAPI AIErr(*	GetRasterFileSpecification )(AIArtHandle raster, ai::FilePath &file)
	Retrieves the file information associated with a raster art object for a link.
AIAPI AIErr(*	SetRasterFileSpecification )(AIArtHandle raster, const ai::FilePath &)
	Not implemented.
AIAPI AIErr(*	GetRasterMatrix )(AIArtHandle raster, AIRealMatrix *matrix)
	Retrieves the transformation matrix for a raster art object.
AIAPI AIErr(*	SetRasterMatrix )(AIArtHandle raster, AIRealMatrix *matrix)
	Sets the transformation matrix for a raster art object.
AIAPI AIErr(*	GetRasterBoundingBox )(AIArtHandle raster, AIRealRect *bbox)
	Retrieves the raster image bounding box of a raster art object.
AIAPI AIErr(*	SetRasterBoundingBox )(AIArtHandle raster, AIRealRect *bbox)
	Sets the raster image bounding box of a raster art object.
AIAPI AIErr(*	GetRasterTile )(AIArtHandle raster, AISlice artSlice, AITile workTile, AISlice *workSlice)
	Copies all or part of the pixel data for a raster art object into a local buffer (a tile).
AIAPI AIErr(*	SetRasterTile )(AIArtHandle raster, AISlice artSlice, AITile workTile, AISlice *workSlice)
	Copies pixel data in a local buffer (a tile) to all or part of a raster art object�s pixel map.
AIAPI AIErr(*	GetRasterLink )(AIArtHandle raster, AIRasterLink &link)
	Retrieves the link information for a raster object that is a link.
AIAPI AIErr(*	SetRasterLink )(AIArtHandle raster, const AIRasterLink &link)
	Sets link information for a raster object.
AIAPI AIErr(*	ResolveRasterLink )(AIArtHandle raster, ai::int32 flags)
	Retrieves the link information for a raster art object, and reloads the raster data if needed.
AIAPI AIErr(*	GetRasterFileInfoFromArt )(AIArtHandle raster, SPPlatformFileInfo *pSPFileInfo)
	Retrieves the file information associated with a raster art object that is a link, such as the time the file was created and last modified.
AIAPI AIErr(*	GetRasterFileInfoFromFile )(AIArtHandle raster, SPPlatformFileInfo *pSPFileInfo)
	Retrieves the file information for the file associated with a raster art object that is a link, such as the time the file was created and last modified.
AIAPI AIErr(*	GetRasterFilePathFromArt )(AIArtHandle raster, ai::UnicodeString &path)
	Retrieves the path for the file associated with a raster art object that is a link.
AIAPI AIErr(*	CountLevels )(AIArtHandle raster, ai::int32 *count)
	Retrieves the number of levels in the MIP map that stores the raster data for a raster art object.
AIAPI AIErr(*	GetLevelInfo )(AIArtHandle raster, ai::int32 level, AIRasterRecord *info)
	Retrieves the bitmap format information for a level in the MIP map for a raster art object.
AIAPI AIErr(*	GetLevelTile )(AIArtHandle raster, ai::int32 level, AISlice artSlice, AITile workTile, AISlice *workSlice)
	Retrieves the tile information for a level in the MIP map for a raster art object.
AIAPI AIErr(*	ExtractOutline )(AIArtHandle raster, const AIRasterOutlineParams params, AIRasterOutlineConsumer consumer)
	Extracts an outline path from the image data, and enumerates the curves to the supplied callback functions.
AIAPI AIErr(*	ConcatRasterMatrix )(AIArtHandle raster, AIRealMatrix *concat)
	Post-concatenate a transformation onto the matrix applied to a raster object.
AIAPI AIErr(*	SetColorSpaceInfo )(AIArtHandle raster, const ai::ColorSpace &cs)
	Attaches additional color space information to a raster art object, required for non-standard color spaces (Separation, NChannel, and Indexed).
AIAPI AIErr(*	GetColorSpaceInfo )(AIArtHandle raster, ai::ColorSpace &cs)
	Retrieves the additional color space information from a raster art object, which is required for non-standard color spaces (Separation, NChannel, and Indexed).
AIAPI AIErr(*	SetOverprint )(AIArtHandle raster, AIBoolean enable)
	Enables or disables overprinting for a raster object.
AIAPI AIErr(*	GetOverprint )(AIArtHandle raster, AIBoolean *status)
	Retrieves the overprint status for a raster object.
AIAPI AIErr(*	IsColorized )(AIArtHandle raster, AIBoolean isColorized, AIBoolean isAdditive)
	Reports whether a raster object is a colorized grayscale or bitmap image.
AIAPI AIErr(*	ClearColorization )(AIArtHandle raster)
	Clears the colorization on a colorized grayscale or bitmap image.
AIAPI AIErr(*	ConvertColors )(AIArtHandle *raster, const ai::ColorSpace &dstCS)
	Converts the colors in a raster object to a non-indexed color space.
AIAPI AIErr(*	InvertColors )(AIArtHandle *raster)
	Inverts the colors in a raster object.
AIAPI AIErr(*	SplitChannels )(AIArtHandle raster, AIArtHandle *rasterArray, ai::int32 numRasters, ai::uint32 flags)
	Decomposes a raster object into an array of rasters specified in the standard color spaces (Gray, RGB, CMYK and spot Separation).
AIAPI AIErr(*	InterleaveChannels )(AIArtHandle rasterArray, ai::int32 numRasters, AIArtHandle raster, ai::uint32 flags)
	Interleaves the color channels from an array of raster objects and recombines them into a single raster.

Detailed Description

This suite provides functions with which to access and modify the data associated with an art object of type kRasterArt.

(Use AIArtSuite, AIMatchingArtSuite, or AIArtSetSuite to create or access the raster art object itself.)

Acquire this suite using SPBasicSuite::AcquireSuite() with the constants kAIRasterSuite and kAIRasterVersion.

The art associated with a raster object is defined by its pixel data and a matrix that positions the pixel data in the document. This information is kept in an AIRasterRecord associated with the raster art object. This suite allows you to work with the raster data as whole, for instance by getting and setting its transformation matrix; or at a pixel level, using the tile functions.

All values in the associated raster record are initialized to zero when you create a raster art object with AIArtSuite::NewArt(). Retrieve the structure from the new art object using GetRasterInfo(), and use SetRasterInfo() to update the object.

Set to the rectangle containing the pixel map using SetRasterInfo(). This is not the same rectangle as the artwork bounds, which Illustrator calculates and provides. The origin of a raster art object is in the top left corner; the coordinate system for a raster object is inverted on the vertical axis with respect to the Illustrator artboard coordinate system.

All pixel data in a raster object uses a base resolution of 72 pixels per inch (PPI). You cannot directly specify the resolution; it is set from the bounds and the raster matrix. For a one inch square image at 72 PPI, the scale component of the raster matrix is set to 1.0 and the bounds would be 72 x 72. To create a one inch square image at 300 PPI, set the bounds to 300 x 300; the scale becomes 0.24 (72/300).

Keep your local pixel data in a tile (AITile). Use GetRasterTile() to retrieve pixels from the pixel map and create a tile, and SetRasterTile() to copy pixel information from the tile to the pixel map.

When copying or replacing image data between a raster art object and a local data buffer (tile), it can be impractical to work with all the information at one time. You can define and work with a more practical subset of the data called a slice. Slices are defined in parameters of the functions that copy the data, GetRasterTile and SetRasterTile().

A slice in the AITile structure defines the tile (the area to be copied or replaced), and additional slices are defined for both the raster art object (artSlice) and for the local data buffer (workSlice). The one for the source controls how the transfer occurs:

When copying from the raster art object to local data, GetRasterTile() iterates over art slices.
When copying from the local data to the raster art object, SetRasterTile() iterates over work slices.

Channel Interleaving

Together with the slice information (see AISlice), the AITile::channelInterleave array specifies how to change the order of bytes making up a pixel when transferring between a raster art object and the tile data buffer. This is useful when translating between similar but not identical color formats.

The array contains a value for each channel, or color byte to be transferred. The array index of a value specifies the source, for bytes read in order from the internal bitmap. The array value maps the corresponding byte to a destination position.

If there is no change in the data order, the array would be:

myTile.channelInterleave[0] = 0;
myTile.channelInterleave[1] = 1;
myTile.channelInterleave[2] = 2;
myTile.channelInterleave[3] = 3;

... An example of using the channel interleave is transferring from the internal RGB format to a Mac OS GWorld PixMap. The internal format uses 3 bytes in the order R G B to define a pixel. The GWorld uses 4 bytes in the order A R G B, where the A byte is the alpha channel information.

When transferring between the raster art object and the GWorld, the channel interleave specifies the mapping between the two incompatible forms. To transfer from the raster object to the GWorld this mapping would be used:

GWorldTile.channelInterleave[0] = 1; // Map 24-bit red value to 32-bit red value
GWorldTile.channelInterleave[1] = 2; // Map 24-bit green value to 32bit green value
GWorldTile.channelInterleave[2] = 3; // Map 24-bit blue value to 32-bit blue value
GWorldTile.channelInterleave[3] = 0; // Unused, handled by the slice definition

Only three channels are mapped. The alpha channel of the GWorld receives no information. To transfer from the GWorld back to the raster object, this mapping would be used:

GWorldTile.channelInterleave[0] = 0; // Alpha channel ignored, handled by slice definition
GWorldTile.channelInterleave[1] = 0; // Map 32-bit red value to 24-bit red value
GWorldTile.channelInterleave[2] = 1; // Map 32-bit green value to 24bit green value
GWorldTile.channelInterleave[3] = 2; // Map 32-bit blue value to 24-bit blue value

Here the data in the alpha channel of the GWorld is not transferred back to the raster object.

This example sets the art-object slice�s front and back values to limit the channelInterleave array:

GWorldTile.channelInterleave[0] = 1; // Map 24-bit red value to 32-bit red value
GWorldTile.channelInterleave[1] = 2; // Map 24-bit green value to 32bit green value
GWorldTile.channelInterleave[2] = 3; // Map 24-bit blue value to 32-bit blue value
GWorldTile.channelInterleave[3] = 0; // Unused, handled by the slice definition
artSlice.front = 0;
artSlice.back = 3;

Because artSlice.back is set to 3, only the color information for the first three channels is copied. When transferring data from the GWorld back to the raster art object, the GWorld�s slice controls the channel interleave. To skip the alpha channel, GWorldSlice.front is set to channel 1, causing channel 0 to be ignored.

GWorldTile.channelInterleave[0] = 0; // Alpha channel is ignored, handled by the slice definition
GWorldTile.channelInterleave[1] = 0; // Map 32-bit red value to 24-bit red value
GWorldTile.channelInterleave[2] = 1; // Map 32-bit green value to 24bit green value
GWorldTile.channelInterleave[3] = 2; // Map 32-bit blue value to 24-bit blue value
GWorldSlice.front = 1;
GWorldSlice.back = 4;

Member Data Documentation

AIAPI AIErr(* AIRasterSuite::ClearColorization)(AIArtHandle raster)

Clears the colorization on a colorized grayscale or bitmap image.

Parameters:

raster An art object of type kRasterArt.

AIAPI AIErr(* AIRasterSuite::ConcatRasterMatrix)(AIArtHandle raster, AIRealMatrix *concat)

Post-concatenate a transformation onto the matrix applied to a raster object.

Parameters:

	raster	An art object of type `kRasterArt`.
	concat	The new transformation matrix information.

AIAPI AIErr(* AIRasterSuite::ConvertColors)(AIArtHandle *raster, const ai::ColorSpace &dstCS)

Converts the colors in a raster object to a non-indexed color space.

Parameters:

	raster	[in, out] An art object of type `kRasterArt`, which is modified in place.
	dstCS	The destination color space, which must not be indexed.

AIAPI AIErr(* AIRasterSuite::CountLevels)(AIArtHandle raster, ai::int32 *count)

Retrieves the number of levels in the MIP map that stores the raster data for a raster art object.

Parameters:

	raster	An art object of type `kRasterArt`.
	count	[out] A buffer in which to return the number of levels (Currently always 6.)

AIAPI AIErr(* AIRasterSuite::ExtractOutline)(AIArtHandle raster, const AIRasterOutlineParams *params, AIRasterOutlineConsumer *consumer)

Extracts an outline path from the image data, and enumerates the curves to the supplied callback functions.

Parameters:

	raster	An art object of type `kRasterArt`.
	params	Parameters that control the curve fitting, or `NULL` to use defaults. Keep parameters within valid ranges to avoid excessive performance impact.
	consumer	The developer-defined callbacks.

AIAPI AIErr(* AIRasterSuite::GetColorSpaceInfo)(AIArtHandle raster, ai::ColorSpace &cs)

Retrieves the additional color space information from a raster art object, which is required for non-standard color spaces (Separation, NChannel, and Indexed).

Parameters:

	raster	An art object of type `kRasterArt`.
	cs	[out] A buffer in which to return the color space information

Note:: If the raster is a colorized grayscale image, returns the actual color space used for the colorization.
If the color space info for non-standard color space has not been specified, returns an error code and an invalid color space.

AIAPI AIErr(* AIRasterSuite::GetLevelInfo)(AIArtHandle raster, ai::int32 level, AIRasterRecord *info)

Retrieves the bitmap format information for a level in the MIP map for a raster art object.

Use with CountLevels() to iterate through levels.

Parameters:

	raster	An art object of type `kRasterArt`.
	level	The 0-based level index.
	info	[out] A buffer in which to return the bitmap information.

Note:

In the returned raster record:

The flags are those you would get by querying the image as a whole.
The bounds are those of the image at the given level of the MIP map. Each level is a power of two less than the previous one, with odd dimensions rounded up. For example, levelWidth = (prevLevelWidth + 1) / 2
Do not rely on this algorithm, however. The only important property maintained is that any rectangle contained within the base image is contained within an image at a given level after scaling to that level, even if its dimensions are rounded up.
The byteWidth is ignored.
The colorSpace and bitsPerPixel describe the format of the pixel data at the given level of the MIP map (currently always the same as that of the base image). The subsampled levels of a bitmap's MIP map are bitmaps; random sampling is used to avoid aliasing.

AIAPI AIErr(* AIRasterSuite::GetLevelTile)(AIArtHandle raster, ai::int32 level, AISlice *artSlice, AITile *workTile, AISlice *workSlice)

Retrieves the tile information for a level in the MIP map for a raster art object.

Use with CountLevels() to iterate through levels.

Parameters:

	raster	An art object of type `kRasterArt`.
	level	The 0-based level index.
	artSlice	The slice that defines a subset of the pixel map to be copied.
	workTile	The tile, which defines the data buffer in which pixel data is returned, and parameters for the transfer operation.
	workSlice	The slice that defines a subset of the local data buffer to which to copy data. Typically, the bounds are the same as those of the work tile.

See also:: GetRasterTile()

AIAPI AIErr(* AIRasterSuite::GetOverprint)(AIArtHandle raster, AIBoolean *status)

Retrieves the overprint status for a raster object.

Parameters:

	raster	An art object of type `kRasterArt`.
	enable	[out] A buffer in which to return true if overprint is enabled, false if it is disabled.

AIAPI AIErr(* AIRasterSuite::GetRasterBoundingBox)(AIArtHandle raster, AIRealRect *bbox)

Retrieves the raster image bounding box of a raster art object.

Parameters:

	raster	An art object of type `kRasterArt`.
	bbox	[out] A buffer in which to return the bounding rectangle.

Note:: The raster bounding box, as specified for SetRasterInfo() or SetRasterBoundingBox(), is not the same rectangle as the artwork bounds, which Illustrator calculates and provides for any art object. To do transformations, use AIArtSuite::GetArtBounds().

AIAPI AIErr(* AIRasterSuite::GetRasterFileInfoFromArt)(AIArtHandle raster, SPPlatformFileInfo *pSPFileInfo)

Retrieves the file information associated with a raster art object that is a link, such as the time the file was created and last modified.

This information is stored with the object from when the file was last read; compare to the current file information to check if the file has changed.
(Direct linking of images is deprecated, although still supported. Create linked objects using the AIPlacedSuite.)

Parameters:

	raster	An art object of type `kRasterArt`.
	pSPFileInfo	[out] A buffer in which to return the file information,

See also:: GetRasterFileInfoFromFile()

AIAPI AIErr(* AIRasterSuite::GetRasterFileInfoFromFile)(AIArtHandle raster, SPPlatformFileInfo *pSPFileInfo)

Retrieves the file information for the file associated with a raster art object that is a link, such as the time the file was created and last modified.

Compare to the file information stored with the object to check if the file has changed since it was last read.
(Direct linking of images is deprecated, although still supported. Create linked objects using the AIPlacedSuite.)

Parameters:

	raster	An art object of type `kRasterArt`.
	pSPFileInfo	[out] A buffer in which to return the file information,

See also:: GetRasterFileInfoFromArt()

AIAPI AIErr(* AIRasterSuite::GetRasterFilePathFromArt)(AIArtHandle raster, ai::UnicodeString &path)

Retrieves the path for the file associated with a raster art object that is a link.

(Direct linking of images is deprecated, although still supported. Create linked objects using the AIPlacedSuite.)

Parameters:

	raster	An art object of type `kRasterArt`.
	path	[out] A buffer in which to return the platform-specific path.

AIAPI AIErr(* AIRasterSuite::GetRasterFileSpecification)(AIArtHandle raster, ai::FilePath &file)

Retrieves the file information associated with a raster art object for a link.

(Direct linking of images is deprecated, although still supported. Create linked objects using the AIPlacedSuite.)

Parameters:

	raster	An art object of type `kRasterArt`.
	file	[out] A buffer in which to return the file specification.

AIAPI AIErr(* AIRasterSuite::GetRasterInfo)(AIArtHandle raster, AIRasterRecord *info)

Retrieves the raster record associated with a raster art object.

Parameters:

	raster	An art object of type `kRasterArt`.
	info	[out] A buffer in which to return the raster record.

AIAPI AIErr(* AIRasterSuite::GetRasterLink)(AIArtHandle raster, AIRasterLink &link)

Retrieves the link information for a raster object that is a link.

(Direct linking of images is deprecated, although still supported. Create linked objects using the AIPlacedSuite.)

Parameters:

	raster	An art object of type `kRasterArt`.
	link	[out] A buffer in which to return the link information.

AIAPI AIErr(* AIRasterSuite::GetRasterMatrix)(AIArtHandle raster, AIRealMatrix *matrix)

Retrieves the transformation matrix for a raster art object.

This is the concatenation of all transforms applied to the image after it was created. It typically contains at least the initial translation and a scale; see SetRasterMatrix().

Parameters:

	raster	An art object of type `kRasterArt`.
	matrix	[out] A buffer in which to return the matrix.

AIAPI AIErr(* AIRasterSuite::GetRasterTile)(AIArtHandle raster, AISlice *artSlice, AITile *workTile, AISlice *workSlice)

Copies all or part of the pixel data for a raster art object into a local buffer (a tile).

Use with SetRasterTile() to filter raster data.

Parameters:

	raster	An art object of type `kRasterArt`.
	artSlice	The slice that defines a subset of the pixel map to be copied.
	workTile	The tile, which defines the data buffer in which pixel data is returned, and parameters for the transfer operation.
	workSlice	The slice that defines a subset of the local data buffer to which to copy data. Typically, the bounds are the same as those of the work tile.

AIAPI AIErr(* AIRasterSuite::InterleaveChannels)(AIArtHandle *rasterArray, ai::int32 numRasters, AIArtHandle *raster, ai::uint32 flags)

Interleaves the color channels from an array of raster objects and recombines them into a single raster.

The source rasters and the destination raster must have the same width and height. 1-bit bitmap rasters are not allowed in the input raster array. The alpha channel of the output raster is the average of all the alpha channels in the input raster array (if there are any). It is ok that not all the input rasters have alpha channels.

Parameters:

	rasterArray	A pointer to a block of memory containing the array of raster art objects to be interleaved.
	numRasters	The number of objects in the raster array.
	raster	[out] A buffer in which to return the combined raster, an art object of type `kRasterArt`.
	flag	Not used. Pass `NULL`.

See also:: SplitChannels()

AIAPI AIErr(* AIRasterSuite::InvertColors)(AIArtHandle *raster)

Inverts the colors in a raster object.

Parameters:

raster [in, out] An art object of type kRasterArt, which is modified in place.

AIAPI AIErr(* AIRasterSuite::IsColorized)(AIArtHandle raster, AIBoolean *isColorized, AIBoolean *isAdditive)

Reports whether a raster object is a colorized grayscale or bitmap image.

Parameters:

	raster	An art object of type `kRasterArt`.
	isColorized	[out] A buffer in which to return true if the raster is a colorized grayscale or bitmap image.
	isAdditive	[out] Optional. A buffer in which to return true if the raster should be interpreted as additive.

AIAPI AIErr(* AIRasterSuite::ResolveRasterLink)(AIArtHandle raster, ai::int32 flags)

Retrieves the link information for a raster art object, and reloads the raster data if needed.

Marks the data as unmodified, but does not change the embedded state.

Depending on the option flags, this can force reload, regardless of the embedded or modified state. If the flags do not specify that resolution should be forced, it is done only if the linked to data is more recent than the current copy.

Attempting to resolve a link can fail for any of the following reasons:

No link source is specified
The link source is not found (kRasterLinkFileNotFoundErr)
A plug-in that can load the link source data is not found (kRasterLinkPluginNotFoundErr)
The link source data cannot be read
Out of memory

(Direct linking of images is deprecated, although still supported. Create linked objects using the AIPlacedSuite.)

Parameters:

	raster	An art object of type `kRasterArt`.
	flags	Option flags for how the operation is performed. A logical OR of `AIResolveRasterLinkFlags`.

AIAPI AIErr(* AIRasterSuite::SetColorSpaceInfo)(AIArtHandle raster, const ai::ColorSpace &cs)

Attaches additional color space information to a raster art object, required for non-standard color spaces (Separation, NChannel, and Indexed).

Parameters:

	raster	An art object of type `kRasterArt`.
	cs	The color space information, with the same number of colors and channels as the color space specified in the `AIRasterRecord::colorSpace`.

AIAPI AIErr(* AIRasterSuite::SetOverprint)(AIArtHandle raster, AIBoolean enable)

Enables or disables overprinting for a raster object.

Parameters:

	raster	An art object of type `kRasterArt`.
	enable	True to enable overprint, false to disable it.

AIAPI AIErr(* AIRasterSuite::SetRasterBoundingBox)(AIArtHandle raster, AIRealRect *bbox)

Sets the raster image bounding box of a raster art object.

Parameters:

	raster	An art object of type `kRasterArt`.
	bbox	The bounding rectangle for the raster image. The top left value must be zero. The right value gives the width and the bottom value the height. (The coordinate system for a raster object is inverted on the vertical axis with respect to the Illustrator artboard coordinate system.)

See also:: GetRasterBoundingBox(), AIRasterRecord::bounds

AIAPI AIErr(* AIRasterSuite::SetRasterFileSpecification)(AIArtHandle raster, const ai::FilePath &)

Not implemented.

Returns kNotImplementedErr.

AIAPI AIErr(* AIRasterSuite::SetRasterInfo)(AIArtHandle raster, AIRasterRecord *info)

Associates a raster record with a raster art object.

After setting the record, use other functions such as SetColorSpaceInfo() to specify the image data configuration.

Parameters:

	raster	An art object of type `kRasterArt`.
	info	The raster record.

AIAPI AIErr(* AIRasterSuite::SetRasterLink)(AIArtHandle raster, const AIRasterLink &link)

Sets link information for a raster object.

(Direct linking of images is deprecated, although still supported. Create linked objects using the AIPlacedSuite.)

Parameters:

	raster	An art object of type `kRasterArt`.
	link	The link information.

AIAPI AIErr(* AIRasterSuite::SetRasterMatrix)(AIArtHandle raster, AIRealMatrix *matrix)

Sets the transformation matrix for a raster art object.

All raster data is internally kept at 72 PPI and uses the object�s scale to set a resolution.

Parameters:

	raster	An art object of type `kRasterArt`.
	matrix	The new matrix.

AIAPI AIErr(* AIRasterSuite::SetRasterTile)(AIArtHandle raster, AISlice *artSlice, AITile *workTile, AISlice *workSlice)

Copies pixel data in a local buffer (a tile) to all or part of a raster art object�s pixel map.

This can be used, for instance, when reading a raster file format into a new raster art object.

Parameters:

	raster	An art object of type `kRasterArt`.
	artSlice	The slice that defines a subset of the pixel map to be replaced.
	workTile	The tile, which defines the data buffer in which pixel data is returned, and parameters for the transfer operation.
	workSlice	The slice that defines a subset of the local data buffer from which to copy data. Typically, the bounds are the same as those of the work tile.

AIAPI AIErr(* AIRasterSuite::SplitChannels)(AIArtHandle raster, AIArtHandle **rasterArray, ai::int32 *numRasters, ai::uint32 flags)

Decomposes a raster object into an array of rasters specified in the standard color spaces (Gray, RGB, CMYK and spot Separation).

The alpha channel from the original raster is duplicated among all the output rasters.

Parameters:

	raster	An art object of type `kRasterArt`.
	rasterArray	[out] A buffer in which to return a pointer to a block of memory containing the array of new raster art objects. You must release the memory block when it is no longer needed using `SPBasicSuite::FreeBlock()`.
	numRasters	[out] A buffer in which to return the number of objects in the raster array, 0 if no rasters are constructed.
	flag	How to treat CMYK process channels, one of the constants `kAISplitRasterStandard` or `kAISplitRasterSeparateProcess`.

See also:: InterleaveChannels()

The documentation for this struct was generated from the following file:

AIRaster.h

AIRasterSuite Struct Reference [API Suite List]

Public Attributes

Detailed Description

Channel Interleaving

Member Data Documentation

AIRasterSuite Struct Reference
[API Suite List]