Rotation3d_Axis

Interpolation function

SYNOPSIS

#include "dip_interpolation.h"

dip_Error dip_Rotation3d_Axis ( in, out, angle, axis, method, bgval )

DATA TYPES

binary, integer, float

FUNCTION

This function rotates an 3-D image in over angle around axis to out using three skews. The rotation axis is 0 (x), 1 (y) or 2 (z). The function implements the rotation in the mathmetical sense, but note the Y-axis is positive downwards! The rotation is over the centre of the image.

For backwards compatability, the macro Rotation3dAxis calls the function Rotation3d_Axis but uses 1, 2 and 3 to select the axis of rotation.

ARGUMENTS

Data type	Name	Description
`dip_Image`	`in`	Input image
`dip_Image`	`out`	Output image
`dip_float`	`angle (radians)`	Rotation angle
`dip_int`	`axis`	Rotation axis
`dipf_Interpolation`	`method`	Interpolation method
`dip_BackgroundValue`	`bgval`	Background value

The enumerator dip_FilterShape contains the following constants:

Name	Description
`DIP_FLT_SHAPE_DEFAULT`	default structuring element, same as `DIP_FLT_SHAPE_RECTANGULAR`
`DIP_FLT_SHAPE_RECTANGULAR`	rectangular structuring element
`DIP_FLT_SHAPE_ELLIPTIC`	elliptic structuring element
`DIP_FLT_SHAPE_DIAMOND`	diamond shaped structuring element
`DIP_FLT_SHAPE_PARABOLIC`	parabolic structuring element
`DIP_FLT_SHAPE_STRUCTURING_ELEMENT`	use `se` as structuring element

The dip_BackgroundValue enumaration consists of the following flags:

Name	Description
`DIP_BGV_DEFAULT`	Default: fill with zeros
`DIP_BGV_ZERO`	Fill with zeros
`DIP_BGV_MAX_VALUE`	Fill with maximum value for data type
`DIP_BGV_MIN_VALUE`	Fill with minimum value for data type

KNOWN BUGS