CreateClonedGdPictureImage24BppRGB Method (GdPictureImaging)

In This Topic

Creates a new 24-bit RGB GdPicture image and initializes it with a copy of the content of the specified GdPicture image, that is represented by its unique image identifier. The newly created image is identified by its unique non-zero image identifier and it is independent of the defined source image.

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 CreateClonedGdPictureImage24BppRGB( _
   ByVal ImageID As Integer _
) As Integer

public int CreateClonedGdPictureImage24BppRGB( 
   int ImageID
)

public function CreateClonedGdPictureImage24BppRGB( 
    ImageID: Integer
): Integer;

public function CreateClonedGdPictureImage24BppRGB( 
   ImageID : int
) : int;

public: int CreateClonedGdPictureImage24BppRGB( 
   int ImageID
)

public:
int CreateClonedGdPictureImage24BppRGB( 
   int ImageID
)

Parameters

ImageID: A unique image identifier of the GdPicture image representing the source image to clone.

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 if the source image is a multi-bitmap image, this method will clone only the currently selected bitmap (the current page) and it will create a single frame image.

This method requires the Image Documents component to run.

Reference

GdPictureImaging Class
GdPictureImaging Members
GetStat Method
ReleaseGdPictureImage Method
CreateGdPictureImageFromFile(String,Boolean) Method
CreateClonedGdPictureImage32BppARGB Method
CreateClonedGdPictureImage32BppPARGB Method