Codec.h

Go to the documentation of this file.

// This code contains NVIDIA Confidential Information and is disclosed
// under the Mutual Non-Disclosure Agreement.
//
// Notice
// ALL NVIDIA DESIGN SPECIFICATIONS AND CODE ("MATERIALS") ARE PROVIDED "AS IS" NVIDIA MAKES
// NO REPRESENTATIONS, WARRANTIES, EXPRESSED, IMPLIED, STATUTORY, OR OTHERWISE WITH RESPECT TO
// THE MATERIALS, AND EXPRESSLY DISCLAIMS ANY IMPLIED WARRANTIES OF NONINFRINGEMENT,
// MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE.
//
// NVIDIA Corporation assumes no responsibility for the consequences of use of such
// information or for any infringement of patents or other rights of third parties that may
// result from its use. No license is granted by implication or otherwise under any patent
// or patent rights of NVIDIA Corporation. No third party distribution is allowed unless
// expressly authorized by NVIDIA.  Details are subject to change without notice.
// This code supersedes and replaces all information previously supplied.
// NVIDIA Corporation products are not authorized for use as critical
// components in life support devices or systems without express written approval of
// NVIDIA Corporation.
//
// Copyright (c) 2020-2021 NVIDIA Corporation. All rights reserved.
//
// NVIDIA Corporation and its licensors retain all intellectual property and proprietary
// rights in and to this software and related documentation and any modifications thereto.
// Any use, reproduction, disclosure or distribution of this software and related
// documentation without an express license agreement from NVIDIA Corporation is
// strictly prohibited.
//

#ifndef DW_EXPERIMENTAL_CODECS_CODEC_H_
#define DW_EXPERIMENTAL_CODECS_CODEC_H_

#include <dw/core/base/Types.h>
#include <dw/sensors/camera/Camera.h>

#ifdef __cplusplus
extern "C" {
#endif

typedef enum {
    DW_MEDIA_TYPE_VIDEO      = 0,
    DW_MEDIA_TYPE_LIDAR      = 1,
    DW_MEDIA_TYPE_RADAR      = 2,
    DW_MEDIA_TYPE_IMU        = 3,
    DW_MEDIA_TYPE_GPS        = 4,
    DW_MEDIA_TYPE_CAN        = 5,
    DW_MEDIA_TYPE_DATA       = 6,
    DW_MEDIA_TYPE_TIME       = 7,
    DW_MEDIA_TYPE_ROADCAST   = 8,
    DW_MEDIA_TYPE_ULTRASONIC = 9,
    DW_MEDIA_TYPE_COUNT      = 10
} dwMediaType;

typedef enum {
    DW_CODEC_TYPE_VIDEO_H264                     = 0,
    DW_CODEC_TYPE_VIDEO_H265                     = 1,
    DW_CODEC_TYPE_VIDEO_VP9                      = 2,
    DW_CODEC_TYPE_VIDEO_AV1                      = 3,
    DW_CODEC_TYPE_VIDEO_LRAW                     = 4,
    DW_CODEC_TYPE_VIDEO_LRAW_V2                  = 5,
    DW_CODEC_TYPE_VIDEO_XRAW                     = 6,
    DW_CODEC_TYPE_VIDEO_RAW                      = 7,
    DW_CODEC_TYPE_LIDAR_CUSTOM                   = 8,
    DW_CODEC_TYPE_LIDAR_HESAI_P128               = 9,
    DW_CODEC_TYPE_LIDAR_HESAI_P128_V4P5          = 10,
    DW_CODEC_TYPE_LIDAR_LUMINAR_H                = 11,
    DW_CODEC_TYPE_LIDAR_OUSTER_OS1               = 12,
    DW_CODEC_TYPE_LIDAR_OUSTER_OS2_128           = 13,
    DW_CODEC_TYPE_LIDAR_VELODYNE_HDL32E          = 14,
    DW_CODEC_TYPE_LIDAR_VELODYNE_HDL64E          = 15,
    DW_CODEC_TYPE_LIDAR_VELODYNE_VLP16           = 16,
    DW_CODEC_TYPE_LIDAR_VELODYNE_VLP16HR         = 17,
    DW_CODEC_TYPE_LIDAR_VELODYNE_VLP32C          = 18,
    DW_CODEC_TYPE_LIDAR_VELODYNE_VLS128          = 19,
    DW_CODEC_TYPE_RADAR_CONTINENTAL_ARS430       = 20,
    DW_CODEC_TYPE_RADAR_CONTINENTAL_ARS430CAN    = 21,
    DW_CODEC_TYPE_RADAR_CONTINENTAL_ARS430RDI    = 22,
    DW_CODEC_TYPE_RADAR_CONTINENTAL_ARS430RDI_V2 = 23,
    DW_CODEC_TYPE_RADAR_CUSTOM                   = 24,
    DW_CODEC_TYPE_RADAR_DELPHI                   = 25,
    DW_CODEC_TYPE_IMU_BOSCH                      = 26,
    DW_CODEC_TYPE_IMU_CAN                        = 27,
    DW_CODEC_TYPE_IMU_CONTINENTAL                = 28,
    DW_CODEC_TYPE_IMU_CUSTOM                     = 29,
    DW_CODEC_TYPE_IMU_DATASPEED                  = 30,
    DW_CODEC_TYPE_IMU_NOVATEL_ASCII              = 31,
    DW_CODEC_TYPE_IMU_NOVATEL_BINARY             = 32,
    DW_CODEC_TYPE_IMU_NV_SIM                     = 33,
    DW_CODEC_TYPE_IMU_XSENS_BINARY               = 34,
    DW_CODEC_TYPE_IMU_XSENS_CAN                  = 35,
    DW_CODEC_TYPE_IMU_XSENS_NMEA                 = 36,
    DW_CODEC_TYPE_GPS_CUSTOM                     = 37,
    DW_CODEC_TYPE_GPS_DATASPEED                  = 38,
    DW_CODEC_TYPE_GPS_DW_BINARY                  = 39,
    DW_CODEC_TYPE_GPS_NMEA                       = 40,
    DW_CODEC_TYPE_GPS_NOVATEL                    = 41,
    DW_CODEC_TYPE_GPS_NOVATEL_BINARY             = 42,
    DW_CODEC_TYPE_GPS_NOVATEL_ASCII              = 43,
    DW_CODEC_TYPE_GPS_NV_SIM                     = 44,
    DW_CODEC_TYPE_GPS_UBLOX                      = 45,
    DW_CODEC_TYPE_GPS_XSENS_BINARY               = 46,
    DW_CODEC_TYPE_CAN_DW_BINARY                  = 47,
    DW_CODEC_TYPE_TIMESENSOR_DW_BINARY           = 48,
    DW_CODEC_TYPE_DATA_DW_BINARY                 = 49,
    DW_CODEC_TYPE_ION                            = 50,
    DW_CODEC_TYPE_ULTRASONIC_VALEO_USV           = 51,
    DW_CODEC_TYPE_RADAR_CUSTOM_EX                = 52,
    DW_CODEC_TYPE_LIDAR_CUSTOM_EX                = 53,
    DW_CODEC_TYPE_COUNT                          = 54,
} dwCodecType;

typedef enum {
    DW_CODEC_CAPABILITY_HARDWARE    = 0,
    DW_CODEC_CAPABILITY_SOFTWARE    = 1,
    DW_CODEC_CAPABILITY_UNSUPPORTED = 2,
} dwCodecCapability;

typedef struct dwCodecPacket
{
    /* Any flags necessary for the frame. */
    uint64_t flags;
    /* Presentation time stamp. */
    dwTime_t pts;
    /* Decoding time stamp. */
    dwTime_t dts;
    /* Encoded data. */
    uint8_t* data;
    /* Size of the data pointer in bytes. */
    uint64_t dataSizeBytes;
    void* reserved[4];
} dwCodecPacket;

typedef struct dwEncoderConfigRateControl
{
    uint32_t gopSize; // number of pictures in one GOP(Group Of Pictures)
    uint32_t bFrames; // Number of bFrames between two reference frames
    uint32_t pFrames; // whether there should be p frames; boolean value
    uint32_t quality; // Target quality, range(0 - 51)
    uint32_t profile; // MPEG-4 encoding Profile
    uint32_t level;   // MPEG-4 encoding Level range (1 - 6.2)
} dwEncoderConfigRateControl;

typedef struct dwEncoderConfigNVMedia
{
    uint8_t encoderInstance; // NVMedia-only
} dwEncoderConfigNVMedia;

typedef struct dwEncoderConfig
{
    dwEncoderConfigRateControl rateControl;
    dwEncoderConfigNVMedia nvMedia;
} dwEncoderConfig;

#ifdef __cplusplus
}
#endif

#endif // DW_EXPERIMENTAL_CODECS_CODEC_H_