ResizeHeightRatio Method (GdPictureImaging)

In This Topic

Resizes a GdPicture image with custom height keeping the original aspect ratio for the new width value.

Syntax

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

'Declaration
 
Public Function ResizeHeightRatio( _
   ByVal ImageID As Integer, _
   ByVal NewImageHeight As Integer, _
   ByVal InterpolationMode As InterpolationMode _
) As GdPictureStatus

public GdPictureStatus ResizeHeightRatio( 
   int ImageID,
   int NewImageHeight,
   InterpolationMode InterpolationMode
)

public function ResizeHeightRatio( 
    ImageID: Integer;
    NewImageHeight: Integer;
    InterpolationMode: InterpolationMode
): GdPictureStatus;

public function ResizeHeightRatio( 
   ImageID : int,
   NewImageHeight : int,
   InterpolationMode : InterpolationMode
) : GdPictureStatus;

public: GdPictureStatus ResizeHeightRatio( 
   int ImageID,
   int NewImageHeight,
   InterpolationMode InterpolationMode
)

public:
GdPictureStatus ResizeHeightRatio( 
   int ImageID,
   int NewImageHeight,
   InterpolationMode InterpolationMode
)

Parameters

ImageID: GdPicture image identifier.
NewImageHeight: The new height of the image in pixel.
InterpolationMode: A member of the Drawing2D.InterPolationMode enumeration.

Return Value

A member of the GdPictureStatus enumeration.

Remarks

This method automatically adjusts the vertical and horizontal image resolution in order to maintain the aspect ratio. If the intention is to change the aspect ratio, the SetVerticalResolution() and/or SetHorizontalResolution() methods should be used instead.

Example

Resizing the image making it half the original size.

using (GdPictureImaging gdpictureImaging = new GdPictureImaging())
{
    int imageID = gdpictureImaging.CreateGdPictureImageFromFile("input.png");
 
    // Resize the image making its height half. The width of the image will be changed in order to maintain the aspect ratio.
    int height = gdpictureImaging.GetHeight(imageID);
    gdpictureImaging.ResizeHeightRatio(imageID, height / 2, System.Drawing.Drawing2D.InterpolationMode.HighQualityBicubic);
 
    gdpictureImaging.SaveAsPNG(imageID, "output.png");
 
    gdpictureImaging.ReleaseGdPictureImage(imageID);
}

Reference

GdPictureImaging Class
GdPictureImaging Members