FrameCapture.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) 2019-2020 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_FRAMECAPTURE_H_
#define DW_FRAMECAPTURE_H_

#include <dw/sensors/SensorSerializer.h>

#include "Image.h"

#ifdef __cplusplus
extern "C" {
#endif

typedef struct dwFrameCaptureObject* dwFrameCaptureHandle_t;

typedef enum dwFrameCaptureMode {
    DW_FRAMECAPTURE_MODE_SCREENCAP = 1 << 0,
    DW_FRAMECAPTURE_MODE_SERIALIZE = 1 << 1,
} dwFrameCaptureMode;

typedef struct
{
    uint32_t width;

    uint32_t height;

    bool captureCustom;

    uint32_t mode;

    bool serializeGL;

    dwSerializerParams params;
} dwFrameCaptureParams;

DW_VIZ_API_PUBLIC
dwStatus dwFrameCapture_initialize(dwFrameCaptureHandle_t* obj,
                                   const dwFrameCaptureParams* params,
                                   dwSALHandle_t sal,
                                   dwContextHandle_t ctx);

DW_VIZ_API_PUBLIC
dwStatus dwFrameCapture_release(dwFrameCaptureHandle_t framecapture);

DW_VIZ_API_PUBLIC
dwStatus dwFrameCapture_screenCapture(const dwImageGL** imageGL, const dwRect roi,
                                      dwFrameCaptureHandle_t framecapture);

DW_VIZ_API_PUBLIC
dwStatus dwFrameCapture_screenCaptureCustom(dwImageGL* imageGL, const dwRect roi,
                                            dwFrameCaptureHandle_t framecapture);

DW_VIZ_API_PUBLIC
dwStatus dwFrameCapture_appendFrame(const dwImageHandle_t img, dwFrameCaptureHandle_t framecapture);

DW_VIZ_API_PUBLIC
dwStatus dwFrameCapture_appendFrameCUDA(const dwImageCUDA* img, dwFrameCaptureHandle_t framecapture);

#ifndef VIBRANTE

DW_VIZ_API_PUBLIC
dwStatus dwFrameCapture_appendFrameCPU(const dwImageCPU* img, dwFrameCaptureHandle_t framecapture);
#else

DW_VIZ_API_PUBLIC
dwStatus dwFrameCapture_appendFrameNvMedia(const dwImageNvMedia* img, dwFrameCaptureHandle_t framecapture);
#endif

DW_VIZ_API_PUBLIC
dwStatus dwFrameCapture_appendFrameGL(const dwImageGL* img, dwFrameCaptureHandle_t framecapture);

#ifdef __cplusplus
}
#endif

#endif // DW_FRAMECAPTURE_H_