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 */