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:
  • regionWidth[N] must be less than or equal to 16384 for each N.
  • regionHeight[N] must be less than or equal to 16384 for each N.
  • The sum of regionWidth[] must be equal to the width of the dstRect argument passed to NvMediaLdcSetGeometry(), and less than or equal to 16384.
  • The sum of regionHeight[] must be equal to the height of dstRect argument passed to NvMediaLdcSetGeometry(), and less than or equal to 16384.
• Control point interval restrictions:
  • controlPointXSpacingLog2[N] must be in range [0, 7] for each N.
  • controlPointYSpacingLog2[N] must be in range [0, 7] for each N.

See also

NvMediaLdcIptParameters

NvMediaLdcWarpMapParameters

NvMediaLdcSetIptParameters()

NvMediaLdcSetWarpMapParameters()

Definition at line 331 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 349 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 353 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 335 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 339 of file nvmedia_ldc.h.

regionHeight

uint32_t NvMediaLdcRegionParameters::regionHeight[NVMEDIA_LDC_MAX_REGIONS_Y]

Holds the height of regions.

Definition at line 345 of file nvmedia_ldc.h.

regionWidth

uint32_t NvMediaLdcRegionParameters::regionWidth[NVMEDIA_LDC_MAX_REGIONS_X]

Holds the width of regions.

Definition at line 342 of file nvmedia_ldc.h.

---

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

• nvmedia_ldc.h