Image Transformation

Functions for image transformation (transposition, rotation). More...

Enumerations
enum	SimdTransformType {   SimdTransformRotate0 = 0 ,   SimdTransformRotate90 ,   SimdTransformRotate180 ,   SimdTransformRotate270 ,   SimdTransformTransposeRotate0 ,   SimdTransformTransposeRotate90 ,   SimdTransformTransposeRotate180 ,   SimdTransformTransposeRotate270 }

Functions
SIMD_API void	SimdTransformImage (const uint8_t *src, size_t srcStride, size_t width, size_t height, size_t pixelSize, SimdTransformType transform, uint8_t *dst, size_t dstStride)
	Copies, rotates, mirrors or transposes an image according to SimdTransformType. More...
SIMD_INLINE Point< ptrdiff_t >	TransformSize (const Point< ptrdiff_t > &size, ::SimdTransformType transform)
	Returns the size of an image after transformation defined by SimdTransformType. More...
template<template< class > class A>
SIMD_INLINE void	TransformImage (const View< A > &src, ::SimdTransformType transform, View< A > &dst)
	Copies, rotates, mirrors or transposes an image according to SimdTransformType. More...

Detailed Description

Functions for image transformation (transposition, rotation).

Enumeration Type Documentation

SimdTransformType

enum SimdTransformType

Describes image transform type used by SimdTransformImage.

The transform maps an input image to an output image with the same pixel size. SimdTransformRotate90, SimdTransformRotate270, SimdTransformTransposeRotate0 and SimdTransformTransposeRotate180 swap output width and height. The other transform types keep the original size.

Enumerator
SimdTransformRotate0	Copy without rotation; output size equals input size.
SimdTransformRotate90	Rotate 90 degrees counterclockwise; output width/height are input height/width.
SimdTransformRotate180	Rotate 180 degrees; output size equals input size.
SimdTransformRotate270	Rotate 270 degrees counterclockwise; output width/height are input height/width.
SimdTransformTransposeRotate0	Transpose over the main diagonal; output width/height are input height/width.
SimdTransformTransposeRotate90	Transpose then rotate 90 degrees counterclockwise; equivalent to horizontal mirror.
SimdTransformTransposeRotate180	Transpose then rotate 180 degrees; output width/height are input height/width.
SimdTransformTransposeRotate270	Transpose then rotate 270 degrees counterclockwise; equivalent to vertical mirror.

Function Documentation

SimdTransformImage()

void SimdTransformImage	(	const uint8_t *	src,
		size_t	srcStride,
		size_t	width,
		size_t	height,
		size_t	pixelSize,
		SimdTransformType	transform,
		uint8_t *	dst,
		size_t	dstStride
	)

Copies, rotates, mirrors or transposes an image according to SimdTransformType.

The function supports pixels with size 1, 2, 3 or 4 bytes. For SimdTransformRotate0, SimdTransformRotate180, SimdTransformTransposeRotate90 and SimdTransformTransposeRotate270 the output image has the same width and height as the input image. For SimdTransformRotate90, SimdTransformRotate270, SimdTransformTransposeRotate0 and SimdTransformTransposeRotate180 the output image width and height are equal to input height and width.

Note

This function has a C++ wrappers: Simd::TransformImage(const View<A> & src, ::SimdTransformType transform, View<A> & dst).

Parameters

[in]	src	- a pointer to pixels data of input image.
[in]	srcStride	- a row size of input image.
[in]	width	- an input image width.
[in]	height	- an input image height.
[in]	pixelSize	- a pixel size in input and output images. It can be 1, 2, 3, 4.
[in]	transform	- a type of image transformation.
[out]	dst	- a pointer to pixels data of output image.
[in]	dstStride	- a row size of output image.

TransformSize()

Point< ptrdiff_t > TransformSize	(	const Point< ptrdiff_t > &	size,
		::SimdTransformType	transform
	)

Returns the size of an image after transformation defined by SimdTransformType.

For SimdTransformRotate0, SimdTransformRotate180, SimdTransformTransposeRotate90 and SimdTransformTransposeRotate270 the returned size is equal to size. For SimdTransformRotate90, SimdTransformRotate270, SimdTransformTransposeRotate0 and SimdTransformTransposeRotate180 width and height are swapped.

Parameters

[in]	size	- a size of input image.
[in]	transform	- a type of image transformation.

Returns

the size of transformed image.

TransformImage()

void TransformImage	(	const View< A > &	src,
		::SimdTransformType	transform,
		View< A > &	dst
	)

Copies, rotates, mirrors or transposes an image according to SimdTransformType.

Input and output images must have the same pixel format. Pixel size must be 1, 2, 3 or 4 bytes. For SimdTransformRotate0, SimdTransformRotate180, SimdTransformTransposeRotate90 and SimdTransformTransposeRotate270 the output image has the same width and height as the input image. For SimdTransformRotate90, SimdTransformRotate270, SimdTransformTransposeRotate0 and SimdTransformTransposeRotate180 the output image width and height are equal to input height and width. Use Simd::TransformSize to get the required output size for a given transform.

Note

This function is a C++ wrapper for function SimdTransformImage.

Parameters

[in]	src	- an input image.
[in]	transform	- a type of image transformation.
[out]	dst	- an output image with size returned by Simd::TransformSize for src size and transform.