nvmedia_core.h

Go to the documentation of this file.

/*
 * Copyright (c) 2017, NVIDIA CORPORATION. All rights reserved. All
 * information contained herein is proprietary and confidential to NVIDIA
 * Corporation.  Any use, reproduction, or disclosure without the written
 * permission of NVIDIA Corporation is prohibited.
 */


#ifndef _NVMEDIA_CORE_H
#define _NVMEDIA_CORE_H

#ifdef __cplusplus
extern "C" {
#endif

#include <math.h>
#include <stdint.h>
#include <time.h>

#if !defined(__NVM_DEPRECATED__)
    #if defined(__GNUC__) && (__GNUC__ >= 4) && (__GNUC_MINOR__ >= 6)
        /*
         * deprecated as build time warnings to prompt developers to migrate
         * from older API to new one gradually. Should be removed once API
         * transition is done(ie: no warnings).
         */

        #pragma GCC diagnostic warning "-Wdeprecated-declarations"
        #define __NVM_DEPRECATED_MSG__(fmt) __attribute__((deprecated(fmt)))
    #else
        #define __NVM_DEPRECATED__
        #define __NVM_DEPRECATED_MSG__(fmt) __NVM_DEPRECATED__
    #endif
#else
    #define __NVM_DEPRECATED_MSG__(fmt) __NVM_DEPRECATED__
#endif

#define NVMEDIA_RELEASE_VERSION_MAJOR   2

#define NVMEDIA_RELEASE_VERSION_MINOR   0

#define NVMEDIA_CORE_VERSION_MAJOR   1

#define NVMEDIA_CORE_VERSION_MINOR   5

#define NVMEDIA_TRUE  (0 == 0)

#define NVMEDIA_FALSE (0 == 1)

typedef uint32_t NvMediaBool;

typedef struct timespec NvMediaTime;

typedef uint64_t NvMediaGlobalTime;

typedef enum {
    NVMEDIA_TIME_BASE_CLOCK_PTP = 0,
    NVMEDIA_TIME_BASE_CLOCK_MONOTONIC,
    NVMEDIA_TIME_BASE_CLOCK_USER_DEFINED,
} NvMediaTimeBase;

typedef struct {
    float_t red;
    float_t green;
    float_t blue;
    float_t alpha;
} NvMediaColor;

typedef enum {
    NVMEDIA_COLOR_STANDARD_ITUR_BT_601,
    NVMEDIA_COLOR_STANDARD_ITUR_BT_709,
    NVMEDIA_COLOR_STANDARD_SMPTE_240M,
    NVMEDIA_COLOR_STANDARD_ITUR_BT_601_ER,
    NVMEDIA_COLOR_STANDARD_ITUR_BT_709_ER
} NvMediaColorStandard;

typedef struct {
    uint16_t x0;
    uint16_t y0;
    uint16_t x1;
    uint16_t y1;
} NvMediaRect;

typedef struct {
    int32_t x;
    int32_t y;
} NvMediaPoint;

typedef struct {
    int32_t left;
    int32_t top;
    int32_t right;
    int32_t bottom;
} NvMediaROI;

typedef enum {
    NVMEDIA_STATUS_OK = 0,
    NVMEDIA_STATUS_BAD_PARAMETER,
    NVMEDIA_STATUS_PENDING,
    NVMEDIA_STATUS_TIMED_OUT,
    NVMEDIA_STATUS_OUT_OF_MEMORY,
    NVMEDIA_STATUS_NOT_INITIALIZED,
    NVMEDIA_STATUS_NOT_SUPPORTED,
    NVMEDIA_STATUS_ERROR,
    NVMEDIA_STATUS_NONE_PENDING,
    NVMEDIA_STATUS_INSUFFICIENT_BUFFERING,
    NVMEDIA_STATUS_INVALID_SIZE,
    NVMEDIA_STATUS_INCOMPATIBLE_VERSION,
    NVMEDIA_STATUS_CANCELLED,
    NVMEDIA_STATUS_UNDEFINED_STATE,
} NvMediaStatus;

typedef struct {
    NvMediaStatus status;
    uint64_t endTimestamp;
} NvMediaTaskStatus;

typedef struct {
    uint8_t major;
    uint8_t minor;
} NvMediaVersion;

NvMediaStatus
NvMediaReleaseGetVersion(
    NvMediaVersion *version
);

NvMediaStatus
NvMediaCoreGetVersion(
    NvMediaVersion *version
);

typedef void NvMediaDevice;

NvMediaDevice *
NvMediaDeviceCreate(
    void
);

void
NvMediaDeviceDestroy(
    NvMediaDevice *device
);

/*
 * \defgroup history_nvmedia_core History
 * Provides change history for the NvMedia Common Types.
 *
 * \section history_nvmedia_core Version History
 *
 * <b> Version 1.0 </b> March 21, 2017
 * - Initial release
 *
 * <b> Version 1.1 </b> April 18, 2017
 * - NVMEDIA_VERSION_MAJOR is renamed to NVMEDIA_CORE_VERSION_MAJOR.
 * - NVMEDIA_VERSION_MINOR is renamed to NVMEDIA_CORE_VERSION_MINOR.
 * - NvMediaBool is now changed from "int" to "uint32_t" type.
 * - NvMediaRect is now changed from "unsigned short" to "uint16_t".
 * - All NvMedia data types are moved to standard data types from <stdint.h>
 * - NvMediaVersionInfo is now deprecated. Use module specific GetVersion()
     API to query the module versions.
 * - NvMediaGetVersionInfo is now deprecated. Use NvMediaCoreGetVersion()
     or NvMediaReleaseGetVersion()
 * - NvMediaCheckVersion is now deprecated. Applications are expected
     to check their version using above GetVersion() APIs.
 * - NVMEDIA_SET_VERSION macro is now deprecated.
 *
 * <b> Version 1.2 </b> May 4, 2017
 * - Added \ref NvMediaROI and \ref NvMediaTaskStatus.
 *
 * <b> Version 1.3 </b> May 17, 2017
 * - Added macros to generate build warnings for deprecated APIs
 * - Changed the size of \ref NvMediaPoint members
 *
 * <b> Version 1.4 </b> September 14, 2017
 * - Added \ref NvMediaTimeBase
 *
 * <b> Version 1.5 </b> December 12, 2017
 * - Deprecated the following palette related APIs:
 *   NvMediaPaletteCreate
 *   NvMediaPaletteDestroy
 *   NvMediaPaletteLoad
 */

#ifdef __cplusplus
};     /* extern "C" */
#endif

#endif /* _NVMEDIA_CORE_H */