NvMedia2DLdcRegionParameters 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 NvMedia2DLdcWarpMapParameters for additional details of how the control points are organized.

Restrictions

• numRegionsX cannot exceed NVMEDIA_2D_MAX_LDC_REGIONS_X.
• numRegionsY cannot exceed NVMEDIA_2D_MAX_LDC_REGIONS_Y.
• Alignment restrictions:
  • regionWidth[N] must be equal or greater than and a multiple of NvMedia2DCapabilities::tileWidth for each N, except N = numRegionsX - 1.
  • regionHeight[N] must be equal or greater than and a multiple of NvMedia2DCapabilities::tileHeight 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 NvMedia2DSetSrcGeometry(), and less than or equal to 16384.
  • The sum of regionHeight[] must be equal to the height of dstRect argument passed to NvMedia2DSetSrcGeometry(), 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

NvMedia2DCapabilities

NvMedia2DLdcTransformMatrix

NvMedia2DLdcWarpMapParameters

NvMedia2DFillLdcWarpMap()

NvMedia2DSetSrcLdcTransformMatrix()

Definition at line 712 of file nvmedia_2d.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_2D_MAX_LDC_REGIONS_X]
	Holds the width of regions. More...
uint32_t	regionHeight [NVMEDIA_2D_MAX_LDC_REGIONS_Y]
	Holds the height of regions. More...
uint32_t	controlPointXSpacingLog2 [NVMEDIA_2D_MAX_LDC_REGIONS_X]
	Holds the horizontal interval between the control points in each region in log2 space. More...
uint32_t	controlPointYSpacingLog2 [NVMEDIA_2D_MAX_LDC_REGIONS_Y]
	Holds the vertical interval between the control points in each region in log2 space. More...

Field Documentation

controlPointXSpacingLog2

uint32_t NvMedia2DLdcRegionParameters::controlPointXSpacingLog2[NVMEDIA_2D_MAX_LDC_REGIONS_X]

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

Definition at line 730 of file nvmedia_2d.h.

controlPointYSpacingLog2

uint32_t NvMedia2DLdcRegionParameters::controlPointYSpacingLog2[NVMEDIA_2D_MAX_LDC_REGIONS_Y]

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

Definition at line 734 of file nvmedia_2d.h.

numRegionsX

uint32_t NvMedia2DLdcRegionParameters::numRegionsX

Holds the number of horizontal regions.

Allowed values are [1, 4], inclusive.

Definition at line 716 of file nvmedia_2d.h.

numRegionsY

uint32_t NvMedia2DLdcRegionParameters::numRegionsY

Holds the number of vertical regions.

Allowed values are [1, 4], inclusive.

Definition at line 720 of file nvmedia_2d.h.

regionHeight

uint32_t NvMedia2DLdcRegionParameters::regionHeight[NVMEDIA_2D_MAX_LDC_REGIONS_Y]

Holds the height of regions.

Definition at line 726 of file nvmedia_2d.h.

regionWidth

uint32_t NvMedia2DLdcRegionParameters::regionWidth[NVMEDIA_2D_MAX_LDC_REGIONS_X]

Holds the width of regions.

Definition at line 723 of file nvmedia_2d.h.

---

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

• nvmedia_2d.h