Resize
Resize
Resizes the source volume.
Syntax
IppStatus ipprResize_8u_C1V(const Ipp8u*
pSrc
, IpprVolume
srcVolume
, int
srcStep
, int
srcPlaneStep
, IpprCuboid
srcVoi
, Ipp8u*
pDst
, int
dstStep
, int
dstPlaneStep
, IpprCuboid
dstVoi
, double
xFactor
, double
yFactor
, double
zFactor
, double
xShift
, double
yShift
, double
zShift
, int
interpolation
, Ipp8u*
pBuffer
);
IppStatus ipprResize_16u_C1V(const Ipp16u*
pSrc
, IpprVolume
srcVolume
, int
srcStep
, int
srcPlaneStep
, IpprCuboid
srcVoi
, Ipp16u*
pDst
, int
dstStep
, int
dstPlaneStep
, IpprCuboid
dstVoi
, double
xFactor
, double
yFactor
, double
zFactor
, double
xShift
, double
yShift
, double
zShift
, int
interpolation
, Ipp8u*
pBuffer
);
IppStatus ipprResize_8u_C1PV(const Ipp8u* const
pSrc
[], IpprVolume
srcVolume
, int
srcStep
, IpprCuboid
srcVoi
, Ipp8u* const
pDst
[], int
dstStep
, IpprCuboid
dstVoi
, double
xFactor
, double
yFactor
, double
zFactor
, double
xShift
, double
yShift
, double
zShift
, int
interpolation
, Ipp8u*
pBuffer
);
IppStatus ipprResize_16u_C1PV(const Ipp16u* const
pSrc
[], IpprVolume
srcVolume
, int
srcStep
, IpprCuboid
srcVoi
, Ipp16u* const
pDst
[], int
dstStep
, IpprCuboid
dstVoi
, double
xFactor
, double
yFactor
, double
zFactor
, double
xShift
, double
yShift
, double
zShift
, int
interpolation
, Ipp8u*
pBuffer
);
IppStatus ipprResize_32f_C1PV(const Ipp32f* const
pSrc
[], IpprVolume
srcVolume
, int
srcStep
, IpprCuboid
srcVoi
, Ipp32f* const
pDst
[], int
dstStep
, IpprCuboid
dstVoi
, double
xFactor
, double
yFactor
, double
zFactor
, double
xShift
, double
yShift
, double
zShift
, int
interpolation
, Ipp8u*
pBuffer
);
IppStatus ipprResize_32f_C1V(const Ipp32f*
pSrc
, IpprVolume
srcVolume
, int
srcStep
, int
srcPlaneStep
, IpprCuboid
srcVoi
, Ipp32f*
pDst
, int
dstStep
, int
dstPlaneStep
, IpprCuboid
dstVoi
, double
xFactor
, double
yFactor
, double
zFactor
, double
xShift
, double
yShift
, double
zShift
, int
interpolation
, Ipp8u*
pBuffer
);
Include Files
ippi.h
Domain Dependencies
Headers:
ippcore.h
,
ippvm.h
,
ipps.h
Libraries:
ippcore.lib
,
ippvm.lib
,
ipps.lib
Parameters
- pSrc
- Pointer to the source volume origin. An array of pointers to the source planes for non-contiguous volume.
- srcVolume
- Size of the source volume.
- srcStep
- Distance, in bytes, between the starting points of consecutive lines in each plane of the source volume.
- srcPlaneStep
- Distance, in bytes, between the planes of the source contiguous volume.
- srcVoi
- Volume of interest of the source volume.
- pDst
- Pointer to the destination volume origin. An array of pointers to the destination planes for non-contiguous volume.
- dstStep
- Distance, in bytes, between the starting points of consecutive lines in each plane of the the destination volume.
- dstPlaneStep
- Distance, in bytes, between the planes of the destination contiguous volume.
- dstVoi
- Volume of interest of the destination volume.
- x-, y-, zFactor
- Factors by which thex,y,zdimensions of the source VOI are changed.
- x-, y-, zShift
- Shift values in thex,y, andzdirections respectively.
- interpolation
- Type of interpolation, the following values are possible:
- IPPI_INTER_NN-nearest neighbor interpolation,
- IPPI_INTER_LINEAR-trilinear interpolation,
- IPPI_INTER_CUBIC-tricubic interpolation,
- IPPI_INTER_CUBIC2P_BSPLINE-B-spline,
- IPPI_INTER_CUBIC2P_CATMULLROM-Catmull-Rom spline,
- IPPI_INTER_CUBIC2P_B05C03-special two-parameters filter (1/2, 3/10).
- pBuffer
- Pointer to the external buffer.
Description
This function operates with volume of interest (VOI).
This function resizes the source volume
srcVoi
by
xFactor
in the
x
direction,
yFactor
in the
y
direction and
zFactor
in the
z
direction. The volume size can be reduced or increased in each direction, depending on the values of
xFactor, yFactor, zFactor
. If the value of the certain factor is greater than 1, the volume size is increased, and if it is less than 1, the volume size is reduced in the corresponding direction. The result is resampled using the interpolation method specified by the
interpolation
parameter, and written to the destination volume
VOI.
Coordinates
x'
,
y'
, and
z'
in the resized volume are obtained from the equations:
x
' =
xFactor
*
x
+
xShift
y
' =
yFactor
*
x
+
yShift
z
' =
zFactor
*
z
+
zShift
where
x
,
y
, and
z
denote the coordinates of the element in the source volume. The right coordinate system (RCS) is used here.
Before using this function, compute the size of the external buffer
pBuffer
using
ipprResizeGetBufSize
.
Return Values
- ippStsNoErr
- Indicates no error. Any other value indicates an error or a warning.
- ippStsNullPtrErr
- Indicates an error when one of the specified pointers isNULL.
- ippStsSizeErr
- Indicates an error when width, or height, or depth of the source and destination volumes is less than or equal to 0.
- ippStsResizeFactorErr
- Indicates an error when one of thexFactor,yFactor,zFactorpointers is less than, or equal to 0.
- ippStsInterpolationErr
- Indicates an error wheninterpolationhas an illegal value.
- ippStsWrongIntersectVOI
- Indicates a warning whensrcVoihas no intersection with the source volume, operation is not performed.