nvmedia_iofa.h

Go to the documentation of this file.

/*
 * SPDX-FileCopyrightText: Copyright (c) 2021-2022 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
 * SPDX-License-Identifier: LicenseRef-NvidiaProprietary
 *
 * NVIDIA CORPORATION, its affiliates and licensors retain all intellectual
 * property and proprietary rights in and to this material, related
 * documentation and any modifications thereto. Any use, reproduction,
 * disclosure or distribution of this material and related documentation
 * without an express license agreement from NVIDIA CORPORATION or
 * its affiliates is strictly prohibited.
 */
 
#ifndef NVMEDIA_IOFA_H
#define NVMEDIA_IOFA_H
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include <stdint.h>
#include <stdbool.h>
 
#include "nvmedia_core.h"
#include "nvscisync.h"
#include "nvscibuf.h"
 
#define NVMEDIA_IOFA_VERSION_MAJOR            1
 
#define NVMEDIA_IOFA_VERSION_MINOR            1
 
#define NVMEDIA_IOFA_VERSION_PATCH            0
 
#define NVMEDIA_IOFA_MAX_PYD_LEVEL            5U
 
#define NVMEDIA_IOFA_MAX_ROI_SUPPORTED        32U
 
#define NVMEDIA_IOFA_MAX_PRENVSCISYNCFENCES  (8U)
 
typedef enum
{
    NVMEDIA_IOFA_MODE_STEREO = 0U,
    NVMEDIA_IOFA_MODE_PYDOF  = 1U,
    NVMEDIA_IOFA_MODE_EPIOF  = 2U,
} NvMediaIofaMode;
 
typedef enum
{
    NVMEDIA_IOFA_GRIDSIZE_1X1 = 0U,
    NVMEDIA_IOFA_GRIDSIZE_2X2 = 1U,
    NVMEDIA_IOFA_GRIDSIZE_4X4 = 2U,
    NVMEDIA_IOFA_GRIDSIZE_8X8 = 3U,
} NvMediaIofaGridSize;
 
typedef enum
{
    NVMEDIA_IOFA_PYD_FRAME_MODE = 0U,
    NVMEDIA_IOFA_PYD_LEVEL_MODE = 1U,
} NvMediaIofaPydMode;
 
typedef enum
{
    NVMEDIA_IOFA_DISPARITY_RANGE_128 = 0U,
    NVMEDIA_IOFA_DISPARITY_RANGE_256 = 1U,
} NvMediaIofaDisparityRange;
 
typedef enum
{
    NVMEDIA_IOFA_PROFILE_DISABLED     = 0U,
    NVMEDIA_IOFA_PROFILE_ENABLED      = 1U,
    NVMEDIA_IOFA_PROFILE_SYNC_ENABLED = 2U,
} NvMediaIofaProfileMode;
 
typedef enum
{
    NVMEDIA_IOFA_PRESET_HQ = 0U,
    NVMEDIA_IOFA_PRESET_HP = 1U,
} NvMediaIofaPreset;
 
typedef enum
{
    NvSciSyncTaskStatusOFA_Success                = 0U,
    NvSciSyncTaskStatusOFA_Error                  = 1U,
    NvSciSyncTaskStatusOFA_Execution_Start        = 2U,
    NvSciSyncTaskStatusOFA_Error_CRC_Mismatch     = 3U,
    NvSciSyncTaskStatusOFA_Error_Timeout          = 4U,
    NvSciSyncTaskStatusOFA_Error_HW               = 5U,
    NvSciSyncTaskStatusOFA_Error_Input_TaskStatus = 6U,
    NvSciSyncTaskStatusOFA_Error_SW               = 7U,
    NvSciSyncTaskStatusOFA_Invalid                = 0XFFFFU
} NvSciSyncTaskStatusOFA;
typedef struct
{
    float   F_Matrix[3][3];
    float   H_Matrix[3][3];
    int32_t epipole_x;
    int32_t epipole_y;
    uint8_t direction;
} NvMediaIofaEpipolarInfo;
 
typedef struct
{
    uint16_t startX;
    uint16_t startY;
    uint16_t endX;
    uint16_t endY;
} NvMediaIofaROIRectParams;
 
typedef struct
{
    uint32_t                numOfROIs;
    NvMediaIofaROIRectParams rectROIParams[NVMEDIA_IOFA_MAX_ROI_SUPPORTED];
} NvMediaIofaROIParams;
 
typedef struct
{
    uint16_t minWidth;
    uint16_t minHeight;
    uint16_t maxWidth;
    uint16_t maxHeight;
} NvMediaIofaCapability;
 
typedef struct NvMediaIofa
{
    struct NvMediaIofaPriv *ofaPriv;
} NvMediaIofa;
 
typedef struct
{
    NvMediaIofaMode           ofaMode;
    uint8_t                   ofaPydLevel;
    uint16_t                 width[NVMEDIA_IOFA_MAX_PYD_LEVEL];
    uint16_t                 height[NVMEDIA_IOFA_MAX_PYD_LEVEL];
    NvMediaIofaGridSize       gridSize[NVMEDIA_IOFA_MAX_PYD_LEVEL];
    uint16_t                  outWidth[NVMEDIA_IOFA_MAX_PYD_LEVEL];
    uint16_t                  outHeight[NVMEDIA_IOFA_MAX_PYD_LEVEL];
    NvMediaIofaDisparityRange dispRange;
    NvMediaIofaPydMode        pydMode;
    NvMediaIofaProfileMode    profiling;
    bool                      vprMode;
    NvMediaIofaPreset         preset;
 
} NvMediaIofaInitParams;
 
typedef struct
{
    uint8_t     penalty1[NVMEDIA_IOFA_MAX_PYD_LEVEL];
    uint8_t     penalty2[NVMEDIA_IOFA_MAX_PYD_LEVEL];
    bool adaptiveP2[NVMEDIA_IOFA_MAX_PYD_LEVEL];
    uint8_t     alphaLog2[NVMEDIA_IOFA_MAX_PYD_LEVEL];
    bool enableDiag[NVMEDIA_IOFA_MAX_PYD_LEVEL];
    uint8_t     numPasses[NVMEDIA_IOFA_MAX_PYD_LEVEL];
} NvMediaIofaSGMParams;
 
typedef struct
{
    NvSciBufObj inputSurface[NVMEDIA_IOFA_MAX_PYD_LEVEL];
    NvSciBufObj refSurface[NVMEDIA_IOFA_MAX_PYD_LEVEL];
    NvSciBufObj pydHintSurface[NVMEDIA_IOFA_MAX_PYD_LEVEL];
    NvSciBufObj outSurface[NVMEDIA_IOFA_MAX_PYD_LEVEL];
    NvSciBufObj costSurface[NVMEDIA_IOFA_MAX_PYD_LEVEL];
} NvMediaIofaBufArray;
 
typedef struct
{
    bool pydHintMagnitudeScale2x;
    bool pydHintWidth2x;
    bool pydHintHeight2x;
} NvMediaIofaPydHintParams;
 
typedef struct
{
    bool                    rightDispMap;
    uint8_t                 currentPydLevel;
    bool                     noopMode;
    NvMediaIofaPydHintParams pydHintParams;
} NvMediaIofaProcessParams;
 
typedef struct
{
    bool        validProfData;
    uint32_t    swTimeInUS;
    uint32_t    hwTimeInUS;
    uint32_t    syncWaitTimeInUS;
} NvMediaIofaProfileData;
 
NvMediaStatus
NvMediaIOFAGetVersion (
    NvMediaVersion *version
);
 
NvMediaIofa *
NvMediaIOFACreate (
    void
);
 
NvMediaStatus
NvMediaIOFAInit (
    NvMediaIofa                 *ofaPubl,
    const NvMediaIofaInitParams *initParams,
    const uint8_t              maxInputBuffering
);
 
NvMediaStatus
NvMediaIOFAProcessFrame (
    const NvMediaIofa              *ofaPubl,
    const NvMediaIofaBufArray      *pSurfArray,
    const NvMediaIofaProcessParams *processParams,
    const NvMediaIofaEpipolarInfo  *pEpiInfo,
    const NvMediaIofaROIParams     *pROIParams
);
 
NvMediaStatus
NvMediaIOFADestroy (
    const NvMediaIofa *ofaPubl
);
 
NvMediaStatus
NvMediaIOFARegisterNvSciBufObj (
    const NvMediaIofa *ofaPubl,
    NvSciBufObj        bufObj
);
 
NvMediaStatus
NvMediaIOFAUnregisterNvSciBufObj (
    const NvMediaIofa *ofaPubl,
    NvSciBufObj       bufObj
);
 
NvMediaStatus
NvMediaIOFAGetSGMConfigParams (
    const NvMediaIofa    *ofaPubl,
    NvMediaIofaSGMParams *pSGMParams
);
 
NvMediaStatus
NvMediaIOFASetSGMConfigParams (
    const NvMediaIofa          *ofaPubl,
    const NvMediaIofaSGMParams *pSGMParams
);
 
NvMediaStatus
NvMediaIOFAGetProfileData (
    const NvMediaIofa      *ofaPubl,
    NvMediaIofaProfileData *pProfData
);
 
NvMediaStatus
NvMediaIOFAGetCapability (
    const NvMediaIofa     *ofaPubl,
    const NvMediaIofaMode mode,
    NvMediaIofaCapability *pCapability
);
 
NvMediaStatus
NvMediaIOFAFillNvSciBufAttrList (
    NvSciBufAttrList attrlist
);
 
NvMediaStatus
NvMediaIOFAFillNvSciSyncAttrList (
    const NvMediaIofa          *ofaPubl,
    NvSciSyncAttrList          attrlist,
    NvMediaNvSciSyncClientType clienttype
);
 
NvMediaStatus
NvMediaIOFARegisterNvSciSyncObj (
    const NvMediaIofa       *ofaPubl,
    NvMediaNvSciSyncObjType syncobjtype,
    NvSciSyncObj            nvscisync
);
 
NvMediaStatus
NvMediaIOFAUnregisterNvSciSyncObj (
    const NvMediaIofa *ofaPubl,
    NvSciSyncObj      nvscisync
);
 
NvMediaStatus
NvMediaIOFASetNvSciSyncObjforEOF (
    const NvMediaIofa *ofaPubl,
    NvSciSyncObj      nvscisyncEOF
);
 
NvMediaStatus
NvMediaIOFAInsertPreNvSciSyncFence (
    const NvMediaIofa    *ofaPubl,
    const NvSciSyncFence *prenvscisyncfence
);
 
NvMediaStatus
NvMediaIOFAGetEOFNvSciSyncFence (
    const NvMediaIofa *ofaPubl,
    NvSciSyncObj      eofnvscisyncobj,
    NvSciSyncFence    *eofnvscisyncfence
);
 
NvMediaStatus
NvMediaIOFASetNvSciSyncObjforSOF (
    const NvMediaIofa *ofaPubl,
    NvSciSyncObj      nvscisyncSOF
);
 
NvMediaStatus
NvMediaIOFAGetSOFNvSciSyncFence (
    const NvMediaIofa *ofaPubl,
    NvSciSyncObj      sofnvscisyncobj,
    NvSciSyncFence    *sofnvscisyncfence
);
 
/*
 * \defgroup 6x_history_nvmedia_iofa History
 * Provides change history for the NvMedia IOFA API.
 *
 * \section 6x_history_nvmedia_iofa Version History
 *
 * <b> Version 1.0 </b> September 28, 2021
 * - Initial release
 *
 */
 
#ifdef __cplusplus
}     /* extern "C" */
#endif
 
#endif // NVMEDIA_IOFA_H