ColorCorrection.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) 2016-2019 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_IMAGEPROCESSING_COLOR_CORRECTION_H_
#define DW_IMAGEPROCESSING_COLOR_CORRECTION_H_

#include <dw/core/base/Exports.h>
#include <dw/core/base/Types.h>
#include <dw/core/base/Status.h>
#include <dw/core/context/Context.h>
#include <dw/image/Image.h>
#include <dw/rig/Rig.h>

#ifdef __cplusplus
extern "C" {
#endif

typedef struct dwColorCorrectObject* dwColorCorrectHandle_t;

typedef struct dwColorCorrectParameters
{
    uint32_t cameraWidth;

    uint32_t cameraHeight;

    uint32_t projectionWidth;

    uint32_t projectionHeight;

} dwColorCorrectParameters;

DW_API_PUBLIC
dwStatus dwColorCorrect_initializeFromRig(dwColorCorrectHandle_t* obj,
                                          const dwColorCorrectParameters* parameters,
                                          dwRigHandle_t rigConfig,
                                          dwContextHandle_t ctx);

DW_API_PUBLIC
dwStatus dwColorCorrect_initializeFromProjectionMap(dwColorCorrectHandle_t* obj, dwContextHandle_t ctx,
                                                    const uint32_t cameraCount, const dwVector2f* pProjToGroundMap,
                                                    const dwColorCorrectParameters* params);
DW_API_PUBLIC
dwStatus dwColorCorrect_release(dwColorCorrectHandle_t obj);

DW_API_PUBLIC
dwStatus dwColorCorrect_reset(dwColorCorrectHandle_t obj);

DW_API_PUBLIC
dwStatus dwColorCorrect_setCUDAStream(cudaStream_t stream,
                                      dwColorCorrectHandle_t obj);

DW_API_PUBLIC
dwStatus dwColorCorrect_getCUDAStream(cudaStream_t* stream,
                                      dwColorCorrectHandle_t obj);

DW_API_PUBLIC
dwStatus dwColorCorrect_setReferenceCameraView(const dwImageHandle_t referenceImage,
                                               uint32_t cameraIdx,
                                               dwColorCorrectHandle_t obj);

DW_API_PUBLIC
dwStatus dwColorCorrect_correctByReferenceView(dwImageHandle_t image,
                                               uint32_t curCameraIdx,
                                               float32_t factor,
                                               dwColorCorrectHandle_t obj);

#ifdef __cplusplus
}
#endif

#endif // DW_IMAGEPROCESSING_COLOR_CORRECTION_H_