NvMediaLdcRegionParameters Struct Reference

Detailed Description

Holds the NvMedia LDC region configuration.

This structure defines the layout of the control points in the destination image.

The control points are used as the basis for geometric transformation from source image to destination image. The remaining points are transformed based on the interpolation. Thus the density of the control points controls the quality of the geometric transformation.

This is an example of defining regions in the image:

         (dstRect->x1 - dstRect->x0)
      /                              \'
     /                                \'
    /                                  \'
 
regionWidth[0]             regionWidth[numRegionsX -1]
    /     \                     /      \'
   |-------|                   |--------|
   --------------------------------------                                      \'
   |******** ******** ...      ******** |--                                     \'
   |* +  + * *      * ...      *      * |   \                                    \'
   |* +  + * *      *          *      * | regionHeight[0]                         \'
   |* +  + * *      *          *      * |   /                                      \'
   |******** ********          ******** |--                                         \'
   |..                         ..       |                                            \'
   |..                         ..       |
   |..                         ..       |                           (dstRect->y1 - dstRect->y0)
   |                                    |
   |                                    |                                            /
   |******** ********...       ******** |--                                         /
   |*      * *      *...       *      * |  \                                       /
   |*      * *      *          *      * | regionHeight[numRegionsY -1]            /
   |*      * *      *          *      * |  /                                     /
   |******** ********          ******** |--                                     /
   --------------------------------------

This is an example of defining control points in one region:

*********
*  +  + *-- \'
*       *     (1 << controlPointYSpacingLog2)
*  +  + *-- /
*       *
*********
   |--|
 (1 << controlPointXSpacingLog2)

See NvMediaLdcWarpMapParameters for additional details of how the control points are organized.

Restrictions

• numRegionsX cannot exceed NVMEDIA_LDC_MAX_REGIONS_X.
• numRegionsY cannot exceed NVMEDIA_LDC_MAX_REGIONS_Y.
• Alignment restrictions:
  • regionWidth[N] must be equal or greater than and a multiple of 64 for each N, except N = numRegionsX - 1.
  • regionHeight[N] must be equal or greater than and a multiple of 16 for each N, except N = numRegionsY - 1.
• Region width/height restrictions:
  • The sum of regionWidth[] must be equal to the width of the dstRect argument passed to NvMediaLdcSetGeometry().
  • The sum of regionHeight[] must be equal to the height of dstRect argument passed to NvMediaLdcSetGeometry().

See also

NvMediaLdcIptParameters

NvMediaLdcWarpMapParameters

NvMediaLdcSetIptParameters()

NvMediaLdcSetWarpMapParameters()

Definition at line 301 of file nvmedia_ldc.h.

Data Fields
uint32_t	numRegionsX
	Holds the number of horizontal regions. More...
uint32_t	numRegionsY
	Holds the number of vertical regions. More...
uint32_t	regionWidth [NVMEDIA_LDC_MAX_REGIONS_X]
	Holds the width of regions. More...
uint32_t	regionHeight [NVMEDIA_LDC_MAX_REGIONS_Y]
	Holds the height of regions. More...
uint32_t	controlPointXSpacingLog2 [NVMEDIA_LDC_MAX_REGIONS_X]
	Holds the horizontal interval between the control points in each region in log2 space. More...
uint32_t	controlPointYSpacingLog2 [NVMEDIA_LDC_MAX_REGIONS_Y]
	Holds the vertical interval between the control points in each region in log2 space. More...

Field Documentation

controlPointXSpacingLog2

uint32_t NvMediaLdcRegionParameters::controlPointXSpacingLog2[NVMEDIA_LDC_MAX_REGIONS_X]

Holds the horizontal interval between the control points in each region in log2 space.

Definition at line 319 of file nvmedia_ldc.h.

controlPointYSpacingLog2

uint32_t NvMediaLdcRegionParameters::controlPointYSpacingLog2[NVMEDIA_LDC_MAX_REGIONS_Y]

Holds the vertical interval between the control points in each region in log2 space.

Definition at line 323 of file nvmedia_ldc.h.

numRegionsX

uint32_t NvMediaLdcRegionParameters::numRegionsX

Holds the number of horizontal regions.

Allowed values are [1, 4], inclusive.

Definition at line 305 of file nvmedia_ldc.h.

numRegionsY

uint32_t NvMediaLdcRegionParameters::numRegionsY

Holds the number of vertical regions.

Allowed values are [1, 4], inclusive.

Definition at line 309 of file nvmedia_ldc.h.

regionHeight

uint32_t NvMediaLdcRegionParameters::regionHeight[NVMEDIA_LDC_MAX_REGIONS_Y]

Holds the height of regions.

Definition at line 315 of file nvmedia_ldc.h.

regionWidth

uint32_t NvMediaLdcRegionParameters::regionWidth[NVMEDIA_LDC_MAX_REGIONS_X]

Holds the width of regions.

Definition at line 312 of file nvmedia_ldc.h.

---

The documentation for this struct was generated from the following file:

• nvmedia_ldc.h