Back to Adaptive Vision Library website

You are here: Start » Function Reference » Image » Image Spatial Transforms » CropImage

CropImage


Header: AVL.h
Namespace: avl
Module: FoundationLite

Creates an image from a box-shaped fragment of the input image (with margins if requested).

Applications: Reduction of the amount of image data to be stored in memory.

Syntax

C++
C#
 
void avl::CropImage
(
	const avl::Image& inImage,
	const avl::Box& inSelection,
	const avl::Pixel& inBorderColor,
	avl::Image& outImage
)

Parameters

Name Type Default Description
inImage const Image& Input image
inSelection const Box& Box defining a subimage to be cropped
inBorderColor const Pixel& Color used for locations outside the selection
outImage Image& Output image

Description

The operation extracts part of the inImage that corresponds to the inSelection box.

Hints

  • It is usually recommended to use Local Coordinate Systems rather than image cropping.

Examples

CropImage performed on the sample image.

Hardware Acceleration

This operation supports automatic parallelization for multicore and multiprocessor systems.

See Also