CreateGdPictureImageFromCMYKSep Method (GdPictureImaging)

In This Topic

Creates a new GdPicture image from four separated GdPicture images (1bpp or 8bpp), where each individual image represents the Cyan, Magenta, Yellow, and Black channel of a resulting image. Each of these images, as well as the newly created image, is identified by its unique non-zero image identifier.

Please note that it is your responsibility to release the image resources once you have no use for them.

Syntax

Visual Basic
C#
Delphi
JScript
Managed Extensions for C++
C++/CLI

'Declaration
 
Public Function CreateGdPictureImageFromCMYKSep( _
   ByVal CyanImageID As Integer, _
   ByVal MagentaImageID As Integer, _
   ByVal YellowImageID As Integer, _
   ByVal BlackImageID As Integer _
) As Integer

public int CreateGdPictureImageFromCMYKSep( 
   int CyanImageID,
   int MagentaImageID,
   int YellowImageID,
   int BlackImageID
)

public function CreateGdPictureImageFromCMYKSep( 
    CyanImageID: Integer;
    MagentaImageID: Integer;
    YellowImageID: Integer;
    BlackImageID: Integer
): Integer;

public function CreateGdPictureImageFromCMYKSep( 
   CyanImageID : int,
   MagentaImageID : int,
   YellowImageID : int,
   BlackImageID : int
) : int;

public: int CreateGdPictureImageFromCMYKSep( 
   int CyanImageID,
   int MagentaImageID,
   int YellowImageID,
   int BlackImageID
)

public:
int CreateGdPictureImageFromCMYKSep( 
   int CyanImageID,
   int MagentaImageID,
   int YellowImageID,
   int BlackImageID
)

Parameters

CyanImageID: A unique image identifier of the GdPicture image representing the Cyan channel of the initial image to recompose.
MagentaImageID: A unique image identifier of the GdPicture image representing the Magenta channel of the initial image to recompose.
YellowImageID: A unique image identifier of the GdPicture image representing the Yellow channel of the initial image to recompose.
BlackImageID: A unique image identifier of the GdPicture image representing the Black channel of the initial image to recompose.

Return Value

A unique image identifier of the GdPicture image representing the newly created image. The returned value is non-zero if the image is successfully created. Please first of all use the GdPictureImaging.GetStat method to determine if this method has been successful.

Be aware that you need to release the image with the GdPictureImaging.ReleaseGdPictureImage method after being used.

Remarks

It is recommend to use the GdPictureImaging.GetStat method to identify the specific reason for the method's failure, if any.

Be aware that the source images must be only 1-bit per pixel or 8-bit per pixel. For 1-bpp source images, the resulting image will be 8-bpp, otherwise, a 24-bpp resulting image will be created.

This method requires the Image Documents component to run.

Reference

GdPictureImaging Class
GdPictureImaging Members
GetStat Method
ReleaseGdPictureImage Method