CreateThumbnailHQ(Int32,Int32,Int32,Int32) Method

In This Topic

Creates a High Quality thumbnail of custom size from a GdPicture image. This method fits the image thumbnail within a rectangle of specified dimensions having a specified background color.

Syntax

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

'Declaration
 
Public Overloads Function CreateThumbnailHQ( _
   ByVal ImageID As Integer, _
   ByVal Width As Integer, _
   ByVal Height As Integer, _
   ByVal BackColor As Integer _
) As Integer

public int CreateThumbnailHQ( 
   int ImageID,
   int Width,
   int Height,
   int BackColor
)

public function CreateThumbnailHQ( 
    ImageID: Integer;
    Width: Integer;
    Height: Integer;
    BackColor: Integer
): Integer;

public function CreateThumbnailHQ( 
   ImageID : int,
   Width : int,
   Height : int,
   BackColor : int
) : int;

public: int CreateThumbnailHQ( 
   int ImageID,
   int Width,
   int Height,
   int BackColor
)

public:
int CreateThumbnailHQ( 
   int ImageID,
   int Width,
   int Height,
   int BackColor
)

Parameters

ImageID: GdPicture image identifier. The image from which the HQ thumbnail must be created.
Width: The width of the thumbnail to create.
Height: The height of the thumbnail to create.
BackColor: A suitable color value can be obtained by using the ARGBI() method. Background color of the thumbnail.

Return Value

GdPicture image identifier. The thumbnail Image. The ReleaseGdPictureImage() method must be subsequently used to release the image from the memory.

Remarks

This method requires the Image Documents component to run.

Example

Generating a high quality custom size thumbnail from a jpeg image with a background color.

using (GdPictureImaging gdpictureImaging = new GdPictureImaging())
{
    int imageID = gdpictureImaging.CreateGdPictureImageFromFile("image.jpg");
 
    // Create a thumbnail with a black background that is 100 pixels width and 200 pixels height.
    int thumbnailID = gdpictureImaging.CreateThumbnailHQ(imageID, 100, 200, gdpictureImaging.ARGBI(255, 0, 0, 0));
    gdpictureImaging.SaveAsPNG(thumbnailID, "thumbnail.png");
 
    // Release used resources.
    gdpictureImaging.ReleaseGdPictureImage(thumbnailID);
    gdpictureImaging.ReleaseGdPictureImage(imageID);
}

Reference

GdPictureImaging Class
GdPictureImaging Members
Overload List
ARGBI Method