NVIDIA DRIVE OS Linux API Reference

5.1.6.1 Release
For Test and Development only

 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
nvmedia_ldc.h File Reference

Detailed Description

NVIDIA Media Interface: Lens Distortion Correction (LDC)

Description: This file contains the NvMedia LDC API.

Definition in file nvmedia_ldc.h.

Go to the source code of this file.

Data Structures

struct  NvMediaCamIntriParams
 Holds NvMedia camera intrinsic parameters. More...
 
struct  NvMediaLensDistortion
 Holds distortion coefficients for the lens model. More...
 
struct  NvMediaCameraModel
 Holds NvMedia LDC camera parameter info. More...
 
struct  NvMediaLDCRegionConfig
 Holds the NvMedia LDC region configuration. More...
 
struct  NvMediaLDCBitMaskMap
 Holds the NvMedia mask map surface. More...
 
struct  NvMediaGeoTransParams
 Holds geometric transform initialization paramters. More...
 
struct  NvMediaTNR3Params
 Holds the TNR3 initialization paramters. More...
 
struct  NvMediaTNR2Params
 Holds the TNR2 initialization paramters. More...
 
struct  NvMediaLDCInitParams
 Holds the NvMedia LDC initialization paramters. More...
 
struct  NvMediaLDCSparseWarpMap
 Holds the NvMedia LDC defintion of a sparse warp map. More...
 
struct  NvMediaLDCCtrlParams
 Holds runtime control parameters for NvMediaLDCProcess(). More...
 

Macros

#define NVMEDIA_LDC_VERSION_MAJOR   2
 Major version number. More...
 
#define NVMEDIA_LDC_VERSION_MINOR   0
 Minor version number. More...
 
#define NVMEDIA_LDC_MAX_HOR_REGION   4u
 Maximum number of horizontal regions. More...
 
#define NVMEDIA_LDC_MAX_VER_REGION   4u
 Maximum number of vertical regions. More...
 
#define NVMEDIA_LDC_MIN_REGION_WIDTH   64u
 Minimum width of horizontal and vertical regions. More...
 
#define NVMEDIA_LDC_MIN_REGION_HEIGHT   16u
 Minimum height of horizontal and vertical regions. More...
 

Typedefs

typedef struct NvMediaLDC NvMediaLDC
 Defines the NvMedia LDC handle as an opaque struct. More...
 

Enumerations

enum  NvMediaLDCMode {
  NVMEDIA_LDC_MODE_GEOTRANS,
  NVMEDIA_LDC_MODE_TNR3,
  NVMEDIA_LDC_MODE_GEOTRANS_TNR3,
  NVMEDIA_LDC_MODE_TNR2
}
 Defines the NvMedia LDC operating modes. More...
 
enum  NvMediaGeoTransMode {
  NVMEDIA_GEOTRANS_MODE_GEN_MAPPING = 0,
  NVMEDIA_GEOTRANS_MODE_FEED_MAPPING,
  NVMEDIA_GEOTRANS_MODE_AFFINE_TRANSFORM,
  NVMEDIA_GEOTRANS_MODE_PERSPECTIVE_TRANSFORM
}
 Defines geometric transform operation modes. More...
 
enum  NvMediaLensModel {
  NVMEDIA_LDC_MODEL_POLYNOMIAL_DISTORTION,
  NVMEDIA_LDC_MODEL_FISHEYE_EQUIDISTANT,
  NVMEDIA_LDC_MODEL_FISHEYE_EQUISOLID,
  NVMEDIA_LDC_MODEL_FISHEYE_ORTHOGRAPHIC,
  NVMEDIA_LDC_MODEL_FISHEYE_STEREOGRAPHIC
}
 Defines supported lens models. More...
 
enum  NvMediaLDCDataFormat {
  NVMEDIA_LDC_DATAFORMAT_FLOAT_T,
  NVMEDIA_LDC_DATAFORMAT_FIXEDFLOAT_S15_5
}
 Defines the NvMedia LDC Data Format. More...
 
enum  NvMediaLDCSobelMode {
  NVMEDIA_GEOTRANS_DISABLE_XSOBEL_DISABLE_DS = 0,
  NVMEDIA_GEOTRANS_DISABLE_XSOBEL_ENABLE_DS,
  NVMEDIA_GEOTRANS_ENABLE_XSOBEL_DISABLE_DS,
  NVMEDIA_GEOTRANS_ENABLE_XSOBEL_ENABLE_DS
}
 Defines the xSobel working modes. More...
 

Functions

NvMediaStatus NvMediaLDCGetVersion (NvMediaVersion *version)
 Returns the version information of NvMedia LDC. More...
 
NvMediaStatus NvMediaLDCCreateNew (const NvMediaDevice *device, NvMediaLDC **pldc, const uint16_t srcWidth, const uint16_t srcHeight, const NvMediaRect *srcRect, const uint16_t dstWidth, const uint16_t dstHeight, const NvMediaRect *dstRect, const NvMediaLDCInitParams *initParams)
 Creates an NvMedia LDC handle. More...
 
NvMediaStatus NvMediaLDCDestroy (NvMediaLDC *ldc)
 Destroys an NvMedia LDC handle that was created by a call to NvMediaLDCCreateNew(). More...
 
NvMediaStatus NvMediaLDCFeedSparseWarpMap (NvMediaLDC *ldc, const NvMediaLDCSparseWarpMap *map)
 Feeds a sparse warp map to NvMedia LDC. More...
 
NvMediaStatus NvMediaLDCMappingGen (NvMediaLDC *ldc)
 Generates a sparse warp mapping based on NvMediaCameraModel. More...
 
NvMediaStatus NvMediaLDCUpdateTNR3Params (const NvMediaLDC *ldc, const NvMediaTNR3Params *tnr3Params)
 Updates TNR3 parameters after a call to NvMediaLDCCreateNew(). More...
 
NvMediaStatus NvMediaLDCProcess (const NvMediaLDC *ldc, NvMediaImage *prevSurface, NvMediaImage *curSurface, NvMediaImage *outputSurface, NvMediaImage *xSobel, NvMediaImage *downSample, const NvMediaLDCCtrlParams *ldcCtrlParams)
 Performs a specified LDC operation. More...