About This Module

The Image Transformation submodule implements basic image processing operations, such as image scaling.

Image Scaling

Image scaling is performed using NvMedia's VIC engine if the input is DW_IMAGE_NVMEDIA and CUDA if the input is DW_IMAGE_CUDA. The scaling engine is also able to format convert the image if the input and output pixel format differ. The supported conversions are a subset of the ones obtainable via dwImage_copyConvert. However this operation allows conversion and ROI handling, so it is suitable for a different class of use cases.

Table for supported inputs and outputs that do not perform conversions

In	Out
`DW_IMAGE_FORMAT_R_UINT8`	`DW_IMAGE_FORMAT_R_UINT8`
`DW_IMAGE_FORMAT_R_UINT16`	`DW_IMAGE_FORMAT_R_UINT16`
`DW_IMAGE_FORMAT_R_UINT16`	`DW_IMAGE_FORMAT_R_UINT8`
`DW_IMAGE_FORMAT_R_FLOAT16`	`DW_IMAGE_FORMAT_R_FLOAT16`
`DW_IMAGE_FORMAT_R_FLOAT16`	`DW_IMAGE_FORMAT_R_UINT8`
`DW_IMAGE_FORMAT_RGB_UINT8_PLANAR`	`DW_IMAGE_FORMAT_RGB_UINT8_PLANAR`
`DW_IMAGE_FORMAT_RGB_UINT16_PLANAR`	`DW_IMAGE_FORMAT_RGB_UINT16_PLANAR`
`DW_IMAGE_FORMAT_RGB_UINT16_PLANAR`	`DW_IMAGE_FORMAT_RGB_UINT8_PLANAR`
`DW_IMAGE_FORMAT_RGB_FLOAT16_PLANAR`	`DW_IMAGE_FORMAT_RGB_FLOAT16_PLANAR`
`DW_IMAGE_FORMAT_RGB_FLOAT16_PLANAR`	`DW_IMAGE_FORMAT_RGB_UINT8_PLANAR`
`DW_IMAGE_FORMAT_RGBA_UINT8`	`DW_IMAGE_FORMAT_RGBA_UINT8`
`DW_IMAGE_FORMAT_RGBA_UINT16`	`DW_IMAGE_FORMAT_RGBA_UINT16`
`DW_IMAGE_FORMAT_RGBA_UINT16`	`DW_IMAGE_FORMAT_RGBA_UINT8`
`DW_IMAGE_FORMAT_RGBA_FLOAT16`	`DW_IMAGE_FORMAT_RGBA_FLOAT16`
`DW_IMAGE_FORMAT_RGBA_FLOAT16`	`DW_IMAGE_FORMAT_RGBA_UINT8`
`DW_IMAGE_FORMAT_YUV420_UINT8_PLANAR`	`DW_IMAGE_FORMAT_YUV420_UINT8_PLANAR`
`DW_IMAGE_FORMAT_YUV420_UINT8_SEMIPLANAR`	`DW_IMAGE_FORMAT_YUV420_UINT8_SEMIPLANAR`
`DW_IMAGE_FORMAT_YUV420_UINT16_SEMIPLANAR`	`DW_IMAGE_FORMAT_YUV420_UINT16_SEMIPLANAR`
`DW_IMAGE_FORMAT_YUV420_UINT16_SEMIPLANAR`	`DW_IMAGE_FORMAT_YUV420_UINT8_SEMIPLANAR`
`DW_IMAGE_FORMAT_YUV_UINT8_PLANAR`	`DW_IMAGE_FORMAT_YUV_UINT8_PLANAR`
`DW_IMAGE_FORMAT_YUV_UINT16_PLANAR`	`DW_IMAGE_FORMAT_YUV_UINT16_PLANAR`
`DW_IMAGE_FORMAT_YUV_UINT16_PLANAR`	`DW_IMAGE_FORMAT_YUV_UINT8_PLANAR`

Table for supported inputs and outputs that perform also conversions

In	Out
`DW_IMAGE_FORMAT_RGB_UINT8_PLANAR`	`DW_IMAGE_FORMAT_RGBA_UINT8`
`DW_IMAGE_FORMAT_RGB_FLOAT16_PLANAR`	`DW_IMAGE_FORMAT_RGBA_UINT8`
`DW_IMAGE_FORMAT_RGB_UINT8_PLANAR`	`DW_IMAGE_FORMAT_RGB_FLOAT16`
`DW_IMAGE_FORMAT_RGB_UINT8_PLANAR`	`DW_IMAGE_FORMAT_RGB_UINT8_PLANAR`
`DW_IMAGE_FORMAT_RGB_UINT8_PLANAR`	`DW_IMAGE_FORMAT_YUV420_UINT8_PLANAR`
`DW_IMAGE_FORMAT_RGBA_UINT8`	`DW_IMAGE_FORMAT_YUV_UINT8_PLANAR`
`DW_IMAGE_FORMAT_RGBA_UINT8`	`DW_IMAGE_FORMAT_YUV420_UINT8_PLANAR`
`DW_IMAGE_FORMAT_RGBA_UINT8`	`DW_IMAGE_FORMAT_YUV420_UINT8_SEMIPLANAR`
`DW_IMAGE_FORMAT_RGBA_UINT8`	`DW_IMAGE_FORMAT_R_UINT8`
`DW_IMAGE_FORMAT_RGBA_UINT8`	`DW_IMAGE_FORMAT_RGB_UINT8_PLANAR`
`DW_IMAGE_FORMAT_RGBA_UINT8`	`DW_IMAGE_FORMAT_RGB_FLOAT16_PLANAR`
`DW_IMAGE_FORMAT_RGBA_FLOAT16`	`DW_IMAGE_FORMAT_RGB_FLOAT16_PLANAR`
`DW_IMAGE_FORMAT_YUV420_UINT8_SEMIPLANAR`	`DW_IMAGE_FORMAT_YUV420_UINT8_PLANAR`
`DW_IMAGE_FORMAT_YUV420_UINT8_SEMIPLANAR`	`DW_IMAGE_FORMAT_R_UINT8`
`DW_IMAGE_FORMAT_YUV420_UINT8_SEMIPLANAR`	`DW_IMAGE_FORMAT_RGBA_UINT8`
`DW_IMAGE_FORMAT_YUV420_UINT16_SEMIPLANAR`	`DW_IMAGE_FORMAT_RGBA_UINT8`
`DW_IMAGE_FORMAT_YUV420_UINT8_SEMIPLANAR`	`DW_IMAGE_FORMAT_RGB_UINT8_PLANAR`
`DW_IMAGE_FORMAT_YUV420_UINT8_SEMIPLANAR`	`DW_IMAGE_FORMAT_RGB_FLOAT16_PLANAR`
`DW_IMAGE_FORMAT_YUV420_UINT16_SEMIPLANAR`	`DW_IMAGE_FORMAT_RGB_FLOAT16_PLANAR`
`DW_IMAGE_FORMAT_YUV420_UINT8_PLANAR`	`DW_IMAGE_FORMAT_RGBA_UINT8`
`DW_IMAGE_FORMAT_YUV420_UINT8_PLANAR`	`DW_IMAGE_FORMAT_YUV420_UINT8_SEMIPLANAR`
`DW_IMAGE_FORMAT_YUV420_UINT8_PLANAR`	`DW_IMAGE_FORMAT_R_UINT8`
`DW_IMAGE_FORMAT_YUV420_UINT8_PLANAR`	`DW_IMAGE_FORMAT_RGB_UINT8_PLANAR`
`DW_IMAGE_FORMAT_YUV420_UINT8_PLANAR`	`DW_IMAGE_FORMAT_RGB_FLOAT16_PLANAR`
`DW_IMAGE_FORMAT_YUV_UINT8_PLANAR`	`DW_IMAGE_FORMAT_RGBA_UINT8`
`DW_IMAGE_FORMAT_YUV_UINT8_PLANAR`	`DW_IMAGE_FORMAT_RGB_UINT8_PLANAR`
`DW_IMAGE_FORMAT_YUV_UINT16_PLANAR`	`DW_IMAGE_FORMAT_RGBA_FLOAT16`
`DW_IMAGE_FORMAT_YUV_UINT16_PLANAR`	`DW_IMAGE_FORMAT_RGB_FLOAT16_PLANAR`

Relevant Tutorials

Image Scaling

APIs

Image Transformation Interface