video_codec.h

/*
 *  Copyright (C) 2017-2018 Team Kodi
 *  This file is part of Kodi - https://kodi.tv
 *
 *  SPDX-License-Identifier: GPL-2.0-or-later
 *  See LICENSES/README.md for more information.
 */
 
#ifndef C_API_ADDONINSTANCE_VIDEOCODEC_H
#define C_API_ADDONINSTANCE_VIDEOCODEC_H
 
#include "../addon_base.h"
#include "inputstream/demux_packet.h"
#include "inputstream/stream_codec.h"
#include "inputstream/stream_crypto.h"
 
#ifdef __cplusplus
extern "C"
{
#endif /* __cplusplus */
 
  //============================================================================
 
  //============================================================================
  enum VIDEOCODEC_RETVAL
  {
    VC_NONE = 0,
 
    VC_ERROR,
 
    VC_BUFFER,
 
    VC_PICTURE,
 
    VC_EOF,
  };
  //----------------------------------------------------------------------------
 
  //============================================================================
  enum VIDEOCODEC_FORMAT
  {
    VIDEOCODEC_FORMAT_UNKNOWN = 0,
 
    VIDEOCODEC_FORMAT_YV12,
 
    VIDEOCODEC_FORMAT_I420,
 
    VIDEOCODEC_FORMAT_YUV420P9,
    VIDEOCODEC_FORMAT_YUV420P10,
    VIDEOCODEC_FORMAT_YUV420P12,
    VIDEOCODEC_FORMAT_YUV422P,
    VIDEOCODEC_FORMAT_YUV422P9,
    VIDEOCODEC_FORMAT_YUV422P10,
    VIDEOCODEC_FORMAT_YUV422P12,
    VIDEOCODEC_FORMAT_YUV444P,
    VIDEOCODEC_FORMAT_YUV444P9,
    VIDEOCODEC_FORMAT_YUV444P10,
    VIDEOCODEC_FORMAT_YUV444P12,
 
    VIDEOCODEC_FORMAT_NV12,
    VIDEOCODEC_FORMAT_P010,
    VIDEOCODEC_FORMAT_YUYV422,
    VIDEOCODEC_FORMAT_UYVY422,
 
    VIDEOCODEC_FORMAT_XRGB8888,
    VIDEOCODEC_FORMAT_XRGB2101010,
    VIDEOCODEC_FORMAT_XRGB16161616,
    VIDEOCODEC_FORMAT_XRGB16161616F,
 
    VIDEOCODEC_FORMAT_MAXFORMATS
  };
  //----------------------------------------------------------------------------
 
  //============================================================================
  enum VIDEOCODEC_TYPE
  {
    VIDEOCODEC_UNKNOWN = 0,
 
    VIDEOCODEC_VP8,
 
    VIDEOCODEC_H264,
 
    VIDEOCODEC_VP9,
 
    VIDEOCODEC_AV1,
 
    VIDEOCODEC_HEVC,
 
    VIDEOCODEC_RAWVIDEO,
  };
  //----------------------------------------------------------------------------
 
  //============================================================================
  enum VIDEOCODEC_PLANE
  {
    VIDEOCODEC_PICTURE_Y_PLANE = 0,
 
    VIDEOCODEC_PICTURE_U_PLANE,
 
    VIDEOCODEC_PICTURE_V_PLANE,
 
    VIDEOCODEC_PICTURE_MAXPLANES = 3,
  };
  //----------------------------------------------------------------------------
 
  //============================================================================
  enum VIDEOCODEC_PICTURE_FLAG
  {
    VIDEOCODEC_PICTURE_FLAG_NONE = 0,
 
    VIDEOCODEC_PICTURE_FLAG_DROP = (1 << 0),
 
    VIDEOCODEC_PICTURE_FLAG_DRAIN = (1 << 1),
  };
  //----------------------------------------------------------------------------
 
  //============================================================================
  enum VIDEOCODEC_HDR_TYPE
  {
    VIDEOCODEC_HDR_TYPE_NONE = 0,
 
    VIDEOCODEC_HDR_TYPE_HDR10,
 
    VIDEOCODEC_HDR_TYPE_DOLBYVISION,
 
    VIDEOCODEC_HDR_TYPE_HLG,
 
    VIDEOCODEC_HDR_TYPE_HDR10PLUS,
  };
  //----------------------------------------------------------------------------
 
  //============================================================================
  struct VIDEOCODEC_PICTURE
  {
    enum VIDEOCODEC_FORMAT videoFormat;
 
    uint32_t flags;
 
    uint32_t width;
 
    uint32_t height;
 
    uint8_t* decodedData;
 
    size_t decodedDataSize;
 
    uint32_t planeOffsets[VIDEOCODEC_PICTURE_MAXPLANES];
 
    uint32_t stride[VIDEOCODEC_PICTURE_MAXPLANES];
 
    int64_t pts;
 
    KODI_HANDLE videoBufferHandle;
 
    enum VIDEOCODEC_HDR_TYPE hdrType;
 
    enum VIDEOCODEC_HDR_TYPE hdrTypeAlt;
 
    char strDVELType[8];
  };
  //----------------------------------------------------------------------------
 
  //============================================================================
  enum VIDEOCODEC_PLATFORM_BUFFER_TYPE
  {
    VIDEOCODEC_PLATFORM_BUFFER_NONE = 0,
    VIDEOCODEC_PLATFORM_BUFFER_DRM_PRIME,
    VIDEOCODEC_PLATFORM_BUFFER_D3D11_TEXTURE,
    VIDEOCODEC_PLATFORM_BUFFER_IOSURFACE,
    VIDEOCODEC_PLATFORM_BUFFER_AHARDWAREBUFFER,
  };
  //----------------------------------------------------------------------------
 
  //============================================================================
#define KODI_DRM_MAX_PLANES 4
 
  struct KODI_DRM_PLANE
  {
    uint32_t object_index;
    uint32_t offset;
    uint32_t pitch;
  };
 
  struct KODI_DRM_OBJECT
  {
    int32_t fd;
    uint32_t size;
    uint64_t format_modifier;
  };
 
  struct KODI_DRM_LAYER
  {
    uint32_t format;
    uint32_t nb_planes;
    struct KODI_DRM_PLANE planes[KODI_DRM_MAX_PLANES];
  };
 
  struct KODI_DRM_FRAME_DESCRIPTOR
  {
    uint32_t nb_objects;
    struct KODI_DRM_OBJECT objects[KODI_DRM_MAX_PLANES];
    uint32_t nb_layers;
    struct KODI_DRM_LAYER layers[KODI_DRM_MAX_PLANES];
  };
  //----------------------------------------------------------------------------
 
  //============================================================================
  struct VIDEOCODEC_PLATFORM_BUFFER
  {
    enum VIDEOCODEC_PLATFORM_BUFFER_TYPE type;
    void* handle;
  };
  //----------------------------------------------------------------------------
  struct VIDEOCODEC_INITDATA
  {
    enum VIDEOCODEC_TYPE codec;
    enum STREAMCODEC_PROFILE codecProfile;
    enum VIDEOCODEC_FORMAT* videoFormats;
    uint32_t width;
    uint32_t height;
    const uint8_t* extraData;
    unsigned int extraDataSize;
    struct STREAM_CRYPTO_SESSION cryptoSession;
  };
 
  // this are properties given to the addon on create
  // at this time we have no parameters for the addon
  typedef struct AddonProps_VideoCodec
  {
    int dummy;
  } AddonProps_VideoCodec;
 
  struct AddonInstance_VideoCodec;
  typedef struct KodiToAddonFuncTable_VideoCodec
  {
    KODI_HANDLE addonInstance;
 
    bool(__cdecl* open)(const struct AddonInstance_VideoCodec* instance,
                        struct VIDEOCODEC_INITDATA* initData);
 
    bool(__cdecl* reconfigure)(const struct AddonInstance_VideoCodec* instance,
                               struct VIDEOCODEC_INITDATA* initData);
 
    bool(__cdecl* add_data)(const struct AddonInstance_VideoCodec* instance,
                            const struct DEMUX_PACKET* packet);
 
    enum VIDEOCODEC_RETVAL(__cdecl* get_picture)(const struct AddonInstance_VideoCodec* instance,
                                                 struct VIDEOCODEC_PICTURE* picture);
 
    const char*(__cdecl* get_name)(const struct AddonInstance_VideoCodec* instance);
 
    void(__cdecl* reset)(const struct AddonInstance_VideoCodec* instance);
  } KodiToAddonFuncTable_VideoCodec;
 
  typedef struct AddonToKodiFuncTable_VideoCodec
  {
    KODI_HANDLE kodiInstance;
    bool (*get_frame_buffer)(void* kodiInstance, struct VIDEOCODEC_PICTURE* picture);
    void (*release_frame_buffer)(void* kodiInstance, void* buffer);
    bool (*get_frame_buffer_platform_handle)(void* kodiInstance,
                                             KODI_HANDLE videoBufferHandle,
                                             struct VIDEOCODEC_PLATFORM_BUFFER* platformBuffer);
  } AddonToKodiFuncTable_VideoCodec;
 
  typedef struct AddonInstance_VideoCodec
  {
    struct AddonProps_VideoCodec* props;
    struct AddonToKodiFuncTable_VideoCodec* toKodi;
    struct KodiToAddonFuncTable_VideoCodec* toAddon;
  } AddonInstance_VideoCodec;
 
#ifdef __cplusplus
} /* extern "C" */
#endif /* __cplusplus */
 
#endif /* !C_API_ADDONINSTANCE_VIDEOCODEC_H */