GdPicture.NET.14
GdPicture14 Namespace / GdPictureDocumentUtilities Class / DisposeImage Method
The unique image identifier of the image resource to be released.
Example





In This Topic
DisposeImage Method (GdPictureDocumentUtilities)
In This Topic
Releases a specified image and its corresponding image resource from memory. This method is particularly useful if you work with images outside the GdPictureImaging class, for example if you are using the GdPicturePDF class.Best Practices
Best Practices
Syntax
'Declaration
 
Public Shared Function DisposeImage( _
   ByVal ImageID As Integer _
) As GdPictureStatus
public static GdPictureStatus DisposeImage( 
   int ImageID
)
public function DisposeImage( 
    ImageID: Integer
): GdPictureStatus; static; 
public static function DisposeImage( 
   ImageID : int
) : GdPictureStatus;
public: static GdPictureStatus DisposeImage( 
   int ImageID
) 
public:
static GdPictureStatus DisposeImage( 
   int ImageID
) 

Parameters

ImageID
The unique image identifier of the image resource to be released.

Return Value

A member of the GdPictureStatus enumeration. If the method has been successfully followed, then the return value is GdPictureStatus.OK.
Remarks
It is always a best practice to release images you have created once you have no use for them. You can find some our recommendations in this Best Practices tutorial.Best Practices
Example
How to dispose of the used image.
Best Practices
Dim gdpicturePDF As GdPicturePDF = New GdPicturePDF()
If gdpicturePDF.LoadFromFile("test.pdf", False) = GdPictureStatus.OK Then
    Dim pageCount As Integer = gdpicturePDF.GetPageCount()
    Dim status As GdPictureStatus = gdpicturePDF.GetStat()
    If (status = GdPictureStatus.OK) AndAlso (pageCount > 0) Then
        Dim imageCount As Integer = gdpicturePDF.GetPageImageCount()
        status = gdpicturePDF.GetStat()
        If (status = GdPictureStatus.OK) AndAlso (imageCount > 0) Then
            Dim imageID As Integer = 0
            For i As Integer = 1 To imageCount
                imageID = gdpicturePDF.ExtractPageImage(i)
                status = gdpicturePDF.GetStat()
                If status = GdPictureStatus.OK Then
                    'Do your stuff with the extracted image here.
                    ' ...
                    'Dispose of the image after you have used it.
                    If GdPictureDocumentUtilities.DisposeImage(imageID) <> GdPictureStatus.OK Then
                        MessageBox.Show("The disposal of the image has failed. Status: " + status.ToString(), "GdPicture")
                    End If
                End If
            Next
        Else
            If status = GdPictureStatus.OK Then
                MessageBox.Show("The first page doesn't contain any image.", "GdPicture")
            Else
                MessageBox.Show("Error: " + status.ToString(), "GdPicture")
            End If
        End If
    Else
        If status = GdPictureStatus.OK Then
            MessageBox.Show("This file doesn't contain any page.", "GdPicture")
        Else
            MessageBox.Show("Error: " + status.ToString(), "GdPicture")
        End If
    End If
Else
    MessageBox.Show("The file can't be loaded.", "GdPicture")
End If
gdpicturePDF.Dispose()
GdPicturePDF gdpicturePDF = new GdPicturePDF();
if (gdpicturePDF.LoadFromFile("test.pdf", false) == GdPictureStatus.OK)
{
    int pageCount = gdpicturePDF.GetPageCount();
    GdPictureStatus status = gdpicturePDF.GetStat();
    if ((status == GdPictureStatus.OK) && (pageCount > 0))
    {
        int imageCount = gdpicturePDF.GetPageImageCount();
        status = gdpicturePDF.GetStat();
        if ((status == GdPictureStatus.OK) && (imageCount > 0))
        {
            int imageID = 0;
            for (int i = 1; i <= imageCount; i++)
            {
                imageID = gdpicturePDF.ExtractPageImage(i);
                status = gdpicturePDF.GetStat();
                if (status == GdPictureStatus.OK)
                {
                    //Do your stuff with the extracted image here.
                    //...
                    //Dispose of the image after you have used it.
                    if (GdPictureDocumentUtilities.DisposeImage(imageID) != GdPictureStatus.OK)
                        MessageBox.Show("The disposal of the image has failed. Status: " + status.ToString(), "GdPicture");
                }
            }
        }
        else
        {
            if (status == GdPictureStatus.OK)
                MessageBox.Show("The first page doesn't contain any image.", "GdPicture");
            else
                MessageBox.Show("Error: " + status.ToString(), "GdPicture");
        }
    }
    else
    {
        if (status == GdPictureStatus.OK)
            MessageBox.Show("This file doesn't contain any page.", "GdPicture");
        else
            MessageBox.Show("Error: " + status.ToString(), "GdPicture");
    }
}
else
    MessageBox.Show("The file can't be loaded.", "GdPicture");
gdpicturePDF.Dispose();
Example
Best Practices
How to dispose of the used image. Dim gdpicturePDF As GdPicturePDF = New GdPicturePDF() If gdpicturePDF.LoadFromFile("test.pdf", False) = GdPictureStatus.OK Then Dim pageCount As Integer = gdpicturePDF.GetPageCount() Dim status As GdPictureStatus = gdpicturePDF.GetStat() If (status = GdPictureStatus.OK) AndAlso (pageCount > 0) Then Dim imageCount As Integer = gdpicturePDF.GetPageImageCount() status = gdpicturePDF.GetStat() If (status = GdPictureStatus.OK) AndAlso (imageCount > 0) Then Dim imageID As Integer = 0 For i As Integer = 1 To imageCount imageID = gdpicturePDF.ExtractPageImage(i) status = gdpicturePDF.GetStat() If status = GdPictureStatus.OK Then 'Do your stuff with the extracted image here. ' ... 'Dispose of the image after you have used it. If GdPictureDocumentUtilities.DisposeImage(imageID) <> GdPictureStatus.OK Then MessageBox.Show("The disposal of the image has failed. Status: " + status.ToString(), "GdPicture") End If End If Next Else If status = GdPictureStatus.OK Then MessageBox.Show("The first page doesn't contain any image.", "GdPicture") Else MessageBox.Show("Error: " + status.ToString(), "GdPicture") End If End If Else If status = GdPictureStatus.OK Then MessageBox.Show("This file doesn't contain any page.", "GdPicture") Else MessageBox.Show("Error: " + status.ToString(), "GdPicture") End If End If Else MessageBox.Show("The file can't be loaded.", "GdPicture") End If gdpicturePDF.Dispose() GdPicturePDF gdpicturePDF = new GdPicturePDF(); if (gdpicturePDF.LoadFromFile("test.pdf", false) == GdPictureStatus.OK) { int pageCount = gdpicturePDF.GetPageCount(); GdPictureStatus status = gdpicturePDF.GetStat(); if ((status == GdPictureStatus.OK) && (pageCount > 0)) { int imageCount = gdpicturePDF.GetPageImageCount(); status = gdpicturePDF.GetStat(); if ((status == GdPictureStatus.OK) && (imageCount > 0)) { int imageID = 0; for (int i = 1; i <= imageCount; i++) { imageID = gdpicturePDF.ExtractPageImage(i); status = gdpicturePDF.GetStat(); if (status == GdPictureStatus.OK) { //Do your stuff with the extracted image here. //... //Dispose of the image after you have used it. if (GdPictureDocumentUtilities.DisposeImage(imageID) != GdPictureStatus.OK) MessageBox.Show("The disposal of the image has failed. Status: " + status.ToString(), "GdPicture"); } } } else { if (status == GdPictureStatus.OK) MessageBox.Show("The first page doesn't contain any image.", "GdPicture"); else MessageBox.Show("Error: " + status.ToString(), "GdPicture"); } } else { if (status == GdPictureStatus.OK) MessageBox.Show("This file doesn't contain any page.", "GdPicture"); else MessageBox.Show("Error: " + status.ToString(), "GdPicture"); } } else MessageBox.Show("The file can't be loaded.", "GdPicture"); gdpicturePDF.Dispose();
See Also