nvmedia_eglstream.h

Go to the documentation of this file.

/*
 * Copyright (c) 2013-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_EGLSTREAM_H
#define _NVMEDIA_EGLSTREAM_H

#ifdef __cplusplus
extern "C" {
#endif

#include "nvmedia_core.h"
#include "nvmedia_surface.h"
#include "nvmedia_video.h"
#include "nvmedia_image.h"
#include <EGL/egl.h>
#include <EGL/eglext.h>

#define NVMEDIA_EGLSTREAM_VERSION_MAJOR   1

#define NVMEDIA_EGLSTREAM_VERSION_MINOR   3

#define NVMEDIA_EGL_STREAM_TIMEOUT_INFINITE  0xFFFFFFFF

typedef struct NvMediaEGLStreamProducer {
    NvMediaSurfaceType type;
    EGLint width;
    EGLint height;
} NvMediaEGLStreamProducer;

NvMediaStatus
NvMediaEglStreamGetVersion(
    NvMediaVersion *version
);

NvMediaEGLStreamProducer *
NvMediaEglStreamProducerCreate(
    NvMediaDevice *device,
    EGLDisplay eglDisplay,
    EGLStreamKHR eglStream,
    NvMediaSurfaceType type,
    EGLint width,
    EGLint height
);

typedef struct {
    NvMediaBool multiSend;
} NvMediaEglStreamProducerAttributes;

#define NVMEDIA_EGL_STREAM_PRODUCER_ATTRIBUTE_MULTISEND       (1 << 0)

void
NvMediaEglStreamProducerSetAttributes(
    NvMediaEGLStreamProducer *producer,
    uint32_t attributeMask,
    NvMediaEglStreamProducerAttributes *attributes
);
void
NvMediaEglStreamProducerDestroy(
    NvMediaEGLStreamProducer *producer
);

NvMediaStatus
NvMediaEglStreamProducerPostSurface(
    NvMediaEGLStreamProducer *producer,
    NvMediaVideoSurface *surface,
    NvMediaTime *timeStamp
);

NvMediaStatus
NvMediaEglStreamProducerGetSurface(
    NvMediaEGLStreamProducer *producer,
    NvMediaVideoSurface **surface,
    uint32_t millisecondTimeout
);

typedef struct NvMediaEGLStreamConsumer {
    NvMediaSurfaceType type;
} NvMediaEGLStreamConsumer;

NvMediaEGLStreamConsumer *
NvMediaEglStreamConsumerCreate(
    NvMediaDevice *device,
    EGLDisplay dpy,
    EGLStreamKHR stream,
    NvMediaSurfaceType type
);

void
NvMediaEglStreamConsumerDestroy(
    NvMediaEGLStreamConsumer *consumer
);

NvMediaStatus
NvMediaEglStreamConsumerAcquireSurface(
    NvMediaEGLStreamConsumer *consumer,
    NvMediaVideoSurface **surface,
    uint32_t millisecondTimeout,
    NvMediaTime *timeStamp
);

NvMediaStatus
NvMediaEglStreamConsumerReleaseSurface(
    NvMediaEGLStreamConsumer *consumer,
    NvMediaVideoSurface* surface
);

#define NvMediaVideoSurfaceStreamProducerCreate NvMediaEglStreamProducerCreate

#define NvMediaVideoSurfaceStreamProducerDestroy NvMediaEglStreamProducerDestroy

#define NvMediaPostSurface NvMediaEglStreamProducerPostSurface

#define NvMediaGetSurface NvMediaEglStreamProducerGetSurface

#define NvMediaEglConsumerCreate NvMediaEglStreamConsumerCreate

#define NvMediaEglConsumerDestroy NvMediaEglStreamConsumerDestroy

#define NvMediaEglConsumerSurfaceAcquire NvMediaEglStreamConsumerAcquireSurface

#define NvMediaEglConsumerSurfaceRelease NvMediaEglStreamConsumerReleaseSurface

NvMediaStatus
NvMediaEglStreamProducerPostImage(
    NvMediaEGLStreamProducer *producer,
    NvMediaImage *image,
    NvMediaTime *timeStamp
);

NvMediaStatus
NvMediaEglStreamProducerGetImage(
    NvMediaEGLStreamProducer *producer,
    NvMediaImage **image,
    uint32_t millisecondTimeout
);

NvMediaStatus
NvMediaEglStreamConsumerAcquireImage(
    NvMediaEGLStreamConsumer *consumer,
    NvMediaImage **image,
    uint32_t millisecondTimeout,
    NvMediaTime *timeStamp
);

NvMediaStatus
NvMediaEglStreamConsumerReleaseImage(
    NvMediaEGLStreamConsumer *consumer,
    NvMediaImage* image
);

NvMediaStatus
NvMediaEglStreamProducerPostMetaData(
    NvMediaEGLStreamProducer *producer,
    uint32_t blockIdx,
    const void *dataBuf,
    uint32_t offset,
    uint32_t size
);

NvMediaStatus
NvMediaEglStreamConsumerAcquireMetaData(
    NvMediaEGLStreamConsumer *consumer,
    uint32_t blockIdx,
    void *dataBuf,
    uint32_t offset,
    uint32_t size
);

/*
 * \defgroup history_nvmedia_eglstream History
 * Provides change history for the NvMedia EglStream API.
 *
 * \section history_nvmedia_eglstream Version History
 *
 * <b> Version 1.0 </b> October 1, 2015
 * - Initial release
 *
 * <b> Version 1.1 </b> May 11, 2016
 * - Added \ref NvMediaEglStreamCheckVersion API
 *
 * <b> Version 1.2 </b> May 12, 2017
 * - Added \ref NvMediaEglStreamGetVersion API to get the version of NvMedia EglStream library
 * - NvMediaEglStreamCheckVersion is deprecated. Use NvMediaEglStreamGetVersion() instead
 * - All NvMedia data types are moved to standard data types
 */

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

#endif /* _NVMEDIA_EGLSTREAM_H */