change_formatchange_formatChangeFormatChangeFormat (Operator)

Name

change_formatchange_formatChangeFormatChangeFormat — Change image size.

Signature

change_format(Image : ImagePart : Width, Height : )

Herror change_format(const Hobject Image, Hobject* ImagePart, const Hlong Width, const Hlong Height)

Herror T_change_format(const Hobject Image, Hobject* ImagePart, const Htuple Width, const Htuple Height)

void ChangeFormat(const HObject& Image, HObject* ImagePart, const HTuple& Width, const HTuple& Height)

HImage HImage::ChangeFormat(Hlong Width, Hlong Height) const

static void HOperatorSet.ChangeFormat(HObject image, out HObject imagePart, HTuple width, HTuple height)

HImage HImage.ChangeFormat(int width, int height)

Description

The operator change_formatchange_formatChangeFormatChangeFormatChangeFormat increases or decreases the size of the input images to the indicated height or width, respectively. If the image is reduced, parts are cut off at the “right” or “lower” edge of the image, respectively. If the image is enlarged, the additional areas are set to 0. The definition domain of the new image is equal to the domain of the input image, clipped to the size of the new image. No zooming is carried out.

Execution Information

Parameters

ImageImageImageImageimage (input_object)  (multichannel-)image(-array) objectHImageHImageHobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)

Input image.

ImagePartImagePartImagePartImagePartimagePart (output_object)  (multichannel-)image(-array) objectHImageHImageHobject * (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)

Image with new format.

WidthWidthWidthWidthwidth (input_control)  extent.x HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Width of new image.

Default value: 512

Suggested values: 32, 64, 128, 256, 512, 768, 1024

HeightHeightHeightHeightheight (input_control)  extent.y HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Height of new image.

Default value: 512

Suggested values: 32, 64, 128, 256, 512, 525, 1024

Possible Successors

disp_imagedisp_imageDispImageDispImageDispImage

Alternatives

crop_partcrop_partCropPartCropPartCropPart

See also

zoom_image_sizezoom_image_sizeZoomImageSizeZoomImageSizeZoomImageSize, zoom_image_factorzoom_image_factorZoomImageFactorZoomImageFactorZoomImageFactor

Module

Foundation