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





In This Topic
GdPicture14 Namespace / GdPictureImaging Class / CreateClonedGdPictureImage32BppPARGB Method

CreateClonedGdPictureImage32BppPARGB Method (GdPictureImaging)

In This Topic
Creates a new 32-bit PARGB 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.

Be aware that 8 bits are used for each of the alpha, red, green, and blue components. The red, green, and blue components are pre-multiplied, according to the alpha component. Just to inform you, that this pixel format provides better performances on Windows applications.

Syntax
'Declaration
 
Public Function CreateClonedGdPictureImage32BppPARGB( _
   ByVal ImageID As Integer _
) As Integer
public int CreateClonedGdPictureImage32BppPARGB( 
   int ImageID
)
public function CreateClonedGdPictureImage32BppPARGB( 
    ImageID: Integer
): Integer; 
public function CreateClonedGdPictureImage32BppPARGB( 
   ImageID : int
) : int;
public: int CreateClonedGdPictureImage32BppPARGB( 
   int ImageID
) 
public:
int CreateClonedGdPictureImage32BppPARGB( 
   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.

See Also