SoftISP.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) 2015-2017 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_SOFT_ISP_H__
#define DW_SOFT_ISP_H__

#include <dw/core/Config.h>
#include <dw/core/Context.h>
#include <dw/core/Exports.h>
#include <dw/core/Types.h>
#include <dw/image/Image.h>
#include <dw/sensors/camera/Camera.h>
#include <dw/isp/Tonemap.h>
#include <stdint.h>

#ifdef __cplusplus
extern "C" {
#endif

typedef struct dwSoftISPObject *dwSoftISPHandle_t;

typedef enum dwSoftISPDemosaicMethod {
    DW_SOFT_ISP_DEMOSAIC_METHOD_INTERPOLATION,
    DW_SOFT_ISP_DEMOSAIC_METHOD_DOWNSAMPLE
} dwSoftISPDemosaicMethod;

typedef enum dwSoftISPDenoiseMethod {
    DW_SOFT_ISP_DENOISE_METHOD_NONE,
    DW_SOFT_ISP_DENOISE_METHOD_BILATERAL
} dwSoftISPDenoiseMethod;

typedef enum dwSoftISPProcessType {
    DW_SOFT_ISP_PROCESS_TYPE_BAYER    = 1 << 0,
    DW_SOFT_ISP_PROCESS_TYPE_DEMOSAIC = 1 << 1,
    DW_SOFT_ISP_PROCESS_TYPE_TONEMAP  = 1 << 2,
} dwSoftISPProcessType;

typedef struct dwSoftISPParams {
    uint32_t width;
    uint32_t height;
    dwCameraRawFormat rawFormat;
    dwTonemapType type;
} dwSoftISPParams;

DW_API_PUBLIC
dwStatus dwSoftISP_initParamsFromCamera(dwSoftISPParams *params,
                                        const dwCameraProperties cameraProps);

DW_API_PUBLIC
dwStatus dwSoftISP_initialize(dwSoftISPHandle_t *obj,
                              const dwSoftISPParams params,
                              const dwContextHandle_t ctx);

DW_API_PUBLIC
dwStatus dwSoftISP_reset(dwSoftISPHandle_t obj);

DW_API_PUBLIC
dwStatus dwSoftISP_release(dwSoftISPHandle_t *obj);

DW_API_PUBLIC
dwStatus dwSoftISP_getBayerImageProperties(dwImageProperties * imageProperties,
                                           dwSoftISPHandle_t obj);

DW_API_PUBLIC
dwStatus dwSoftISP_getDemosaicImageProperties(dwImageProperties * imageProperties,
                                              dwSoftISPHandle_t obj);

DW_API_PUBLIC
dwStatus dwSoftISP_bindBayerOutput(dwImageCUDA *bayerImage,
                                   dwSoftISPHandle_t obj);

DW_API_PUBLIC
dwStatus dwSoftISP_bindDemosaicOutput(dwImageCUDA *demosaicImage,
                                      dwSoftISPHandle_t obj);

DW_API_PUBLIC
dwStatus dwSoftISP_bindTonemapOutput(dwImageCUDA *tonemappedImage,
                                        dwSoftISPHandle_t obj);

DW_API_PUBLIC
dwStatus dwSoftISP_bindRawInput(const dwImageCUDA *rawImage, dwSoftISPHandle_t obj);

DW_API_PUBLIC
dwStatus dwSoftISP_processDeviceAsync(const int32_t type, dwSoftISPHandle_t obj);

DW_API_PUBLIC
dwStatus dwSoftISP_setCUDAStream(cudaStream_t stream, dwSoftISPHandle_t obj);

DW_API_PUBLIC
dwStatus dwSoftISP_getCUDAStream(cudaStream_t* stream, dwSoftISPHandle_t obj);

DW_API_PUBLIC
dwStatus dwSoftISP_setDemosaicMethod(dwSoftISPDemosaicMethod method, dwSoftISPHandle_t obj);

DW_API_PUBLIC
dwStatus dwSoftISP_getDemosaicMethod(dwSoftISPDemosaicMethod* method, dwSoftISPHandle_t obj);

DW_API_PUBLIC
dwStatus dwSoftISP_setDemosaicROI(dwRect cropRegion, dwSoftISPHandle_t obj);

DW_API_PUBLIC
dwStatus dwSoftISP_getDemosaicROI(dwRect* cropRegion, dwSoftISPHandle_t obj);


DW_API_PUBLIC
dwStatus dwSoftISP_setDenoiseMethod(dwSoftISPDenoiseMethod method, dwSoftISPHandle_t obj);

DW_API_PUBLIC
dwStatus dwSoftISP_getDenoiseMethod(dwSoftISPDenoiseMethod* method, dwSoftISPHandle_t obj);

DW_API_PUBLIC
dwStatus dwSoftISP_getTonemapType(dwTonemapType* type, dwSoftISPHandle_t obj);

DW_API_PUBLIC
dwStatus dwSoftISP_setTonemapType(dwTonemapType type, dwSoftISPHandle_t obj);

DW_API_PUBLIC
dwStatus dwSoftISP_copyTonemapCUDA(dwImageCUDA *output, const dwImageCUDA *input,
                                   dwSoftISPHandle_t obj, cudaStream_t stream);

#ifdef __cplusplus
}
#endif

#endif // DW_soft_ISP_H__