Intel® Integrated Performance Primitives (Intel® IPP) Developer Guide and Reference

ID 790148
Date 3/22/2024
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

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_16s_C1V(const Ipp16s* pSrc, IpprVolume srcVolume, int srcStep, int srcPlaneStep, IpprCuboid srcVoi, Ipp16s* 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_16s_C1PV(const Ipp16s* const pSrc[], IpprVolume srcVolume, int srcStep, IpprCuboid srcVoi, Ipp16s* 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 the x, y, z dimensions of the source VOI are changed.

x-, y-, zShift

Shift values in the x, y, and z directions 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 volumeVOI.

Coordinates x', y', and z' in the resized volume are obtained from the equations:

x' = xFactor* x + xShift

y' = yFactor* y + 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.

Descriptor PV means working with non-contiguous volume data, where the location of the planes is passed to the function using pointers on the plane. In functions with descriptor V, the location of the planes is determined by the distance in bytes between the starting points of successive lines in each plane of the original volume (contiguous volume data).

In case of resize:

  • In IppStatus ipprResize_8u_C1V function V means:

    const Ipp8u* pSrc - Pointer to the source volume origin. srcPlaneStep - Distance, in bytes, between the planes of the source contiguous volume.
  • In IppStatus ipprResize_8u_C1PV function PV means:

    const Ipp8u* const pSrc[] - An array of pointers to the source planes for non-contiguous volume.

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 is NULL.

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 the xFactor, yFactor, zFactor pointers is less than, or equal to 0.

ippStsInterpolationErr

Indicates an error when interpolation has an illegal value.

ippStsWrongIntersectVOI

Indicates a warning when srcVoi has no intersection with the source volume, operation is not performed.

See Also