RenderEngine.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) 2017-2021 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 DWVISUALIZATION_RENDERENGINE_H_
#define DWVISUALIZATION_RENDERENGINE_H_

#include "Renderer.h"

#include <dwvisualization/image/Image.h>

#ifdef __cplusplus
extern "C" {
#endif

typedef struct dwRenderEngineObject* dwRenderEngineHandle_t;
typedef const struct dwRenderEngineObject* dwConstRenderEngineHandle_t;

typedef enum {
    DW_RENDER_ENGINE_FONT_VERDANA_8  = DW_RENDER_FONT_VERDANA_8,
    DW_RENDER_ENGINE_FONT_VERDANA_12 = DW_RENDER_FONT_VERDANA_12,
    DW_RENDER_ENGINE_FONT_VERDANA_16 = DW_RENDER_FONT_VERDANA_16,
    DW_RENDER_ENGINE_FONT_VERDANA_20 = DW_RENDER_FONT_VERDANA_20,
    DW_RENDER_ENGINE_FONT_VERDANA_24 = DW_RENDER_FONT_VERDANA_24,
    DW_RENDER_ENGINE_FONT_VERDANA_32 = DW_RENDER_FONT_VERDANA_32,
    DW_RENDER_ENGINE_FONT_VERDANA_48 = DW_RENDER_FONT_VERDANA_48,
    DW_RENDER_ENGINE_FONT_VERDANA_64 = DW_RENDER_FONT_VERDANA_64,
    DW_RENDER_ENGINE_FONT_COUNT      = DW_RENDER_FONT_COUNT
} dwRenderEngineFont;

const uint32_t DW_RENDER_ENGINE_MAX_TILE_COUNT = 55;

typedef enum {
    DW_RENDER_ENGINE_PRIMITIVE_TYPE_POINTS_2D,
    DW_RENDER_ENGINE_PRIMITIVE_TYPE_POINTS_3D,
    DW_RENDER_ENGINE_PRIMITIVE_TYPE_LINES_2D,
    DW_RENDER_ENGINE_PRIMITIVE_TYPE_LINES_3D,
    DW_RENDER_ENGINE_PRIMITIVE_TYPE_LINESTRIP_2D,
    DW_RENDER_ENGINE_PRIMITIVE_TYPE_LINESTRIP_3D,
    DW_RENDER_ENGINE_PRIMITIVE_TYPE_TRIANGLES_2D,
    DW_RENDER_ENGINE_PRIMITIVE_TYPE_TRIANGLES_3D,
    DW_RENDER_ENGINE_PRIMITIVE_TYPE_BOXES_2D,
    DW_RENDER_ENGINE_PRIMITIVE_TYPE_BOXES_3D,
    DW_RENDER_ENGINE_PRIMITIVE_TYPE_ORIENTED_BOXES_3D,
    DW_RENDER_ENGINE_PRIMITIVE_TYPE_ELLIPSES_2D,
    DW_RENDER_ENGINE_PRIMITIVE_TYPE_ELLIPSES_3D,
    DW_RENDER_ENGINE_PRIMITIVE_TYPE_ARROWS_2D,
    DW_RENDER_ENGINE_PRIMITIVE_TYPE_ARROWS_3D,

    DW_RENDER_ENGINE_PRIMITIVE_TYPE_COUNT
} dwRenderEnginePrimitiveType;

typedef enum {
    DW_RENDER_ENGINE_PLOT_TYPE_POINTS,
    DW_RENDER_ENGINE_PLOT_TYPE_LINESTRIP,
    DW_RENDER_ENGINE_PLOT_TYPE_HISTOGRAM
} dwRenderEnginePlotType;

#define DW_RENDER_ENGINE_MAX_PLOTS2D 20

typedef dwVector4f dwRenderEngineColorRGBA;

static const dwRenderEngineColorRGBA DW_RENDER_ENGINE_COLOR_RED        = {230.0f / 255.0f, 72.0f / 255.0f, 32.0f / 255.0f, 1.0f};
static const dwRenderEngineColorRGBA DW_RENDER_ENGINE_COLOR_DARKRED    = {180.0f / 255.0f, 5.0f / 255.0f, 0.0f / 255.0f, 1.0f};
static const dwRenderEngineColorRGBA DW_RENDER_ENGINE_COLOR_PURPLE     = {255.0f / 255.0f, 0.0f / 255.0f, 240.0f / 255.0f, 1.0f};
static const dwRenderEngineColorRGBA DW_RENDER_ENGINE_COLOR_BLUE       = {32.0f / 255.0f, 72.0f / 255.0f, 230.0f / 255.0f, 1.0f};
static const dwRenderEngineColorRGBA DW_RENDER_ENGINE_COLOR_GREEN      = {32.0f / 255.0f, 230.0f / 255.0f, 32.0f / 255.0f, 1.0f};
static const dwRenderEngineColorRGBA DW_RENDER_ENGINE_COLOR_WHITE      = {255.0f / 255.0f, 255.0f / 255.0f, 255.0f / 255.0f, 1.0f};
static const dwRenderEngineColorRGBA DW_RENDER_ENGINE_COLOR_DARKGREEN  = {45.0f / 255.0f, 100.0f / 255.0f, 44.0f / 255.0f, 1.0f};
static const dwRenderEngineColorRGBA DW_RENDER_ENGINE_COLOR_LIGHTGREEN = {118.0f / 255.0f, 185.0f / 255.0f, 0.0f / 255.0f, 1.0f};
static const dwRenderEngineColorRGBA DW_RENDER_ENGINE_COLOR_LIGHTGREY  = {185.0f / 255.0f, 185.0f / 255.0f, 185.0f / 255.0f, 1.0f};
static const dwRenderEngineColorRGBA DW_RENDER_ENGINE_COLOR_DARKGREY   = {72.0f / 255.0f, 72.0f / 255.0f, 72.0f / 255.0f, 1.0f};
static const dwRenderEngineColorRGBA DW_RENDER_ENGINE_COLOR_DARKBLUE   = {45.0f / 255.0f, 44.0f / 255.0f, 100.0f / 255.0f, 0.6f};
static const dwRenderEngineColorRGBA DW_RENDER_ENGINE_COLOR_YELLOW     = {230.0f / 255.0f, 230.0f / 255.0f, 10.0f / 255.0f, 1.0f};
static const dwRenderEngineColorRGBA DW_RENDER_ENGINE_COLOR_ORANGE     = {230.0f / 255.0f, 100.0f / 255.0f, 10.0f / 255.0f, 1.0f};
static const dwRenderEngineColorRGBA DW_RENDER_ENGINE_COLOR_LIGHTBLUE  = {51.0f / 255.0f, 153.0f / 255.0f, 255.0f / 255.0f, 0.6f};
static const dwRenderEngineColorRGBA DW_RENDER_ENGINE_COLOR_BLACK      = {0.0f / 255.0f, 0.0f / 255.0f, 0.0f / 255.0f, 1.0f};
static const dwRenderEngineColorRGBA DW_RENDER_ENGINE_COLOR_PINK       = {1.0f, 113.0f / 255.0f, 181.0f / 255.0f, 1.0f};
static const dwRenderEngineColorRGBA DW_RENDER_ENGINE_COLOR_CYAN       = {0.0f, 1.0f, 1.0f, 1.0f};
static const dwRenderEngineColorRGBA DW_RENDER_ENGINE_COLOR_DARKBROWN  = {101.0f / 255.0f, 67.0f / 255.0f, 33.0f / 255.0f, 1.0f};
static const dwRenderEngineColorRGBA DW_RENDER_ENGINE_COLOR_DARKPURPLE = {70.0f / 255.0f, 39.0f / 255.0f, 89.0f / 255.0f, 1.0f};

typedef enum {
    DW_RENDER_ENGINE_COLOR_BY_VALUE_COLOR,
    DW_RENDER_ENGINE_COLOR_BY_VALUE_MODE_DISTANCE,
    DW_RENDER_ENGINE_COLOR_BY_VALUE_MODE_X,
    DW_RENDER_ENGINE_COLOR_BY_VALUE_MODE_Y,
    DW_RENDER_ENGINE_COLOR_BY_VALUE_MODE_Z,
    DW_RENDER_ENGINE_COLOR_BY_VALUE_MODE_XY,
    DW_RENDER_ENGINE_COLOR_BY_VALUE_MODE_XZ,
    DW_RENDER_ENGINE_COLOR_BY_VALUE_MODE_YZ,
    DW_RENDER_ENGINE_COLOR_BY_VALUE_MODE_INTENSITY,
    DW_RENDER_ENGINE_COLOR_BY_VALUE_MODE_ATTRIBUTE_RGBA
} dwRenderEngineColorByValueMode;

typedef enum {
    DW_RENDER_ENGINE_TILE_LAYOUT_TYPE_ABSOLUTE,
    DW_RENDER_ENGINE_TILE_LAYOUT_TYPE_RELATIVE
} dwRenderEngineTileLayoutType;

typedef enum {
    DW_RENDER_ENGINE_TILE_POSITION_TYPE_TOP_LEFT,
    DW_RENDER_ENGINE_TILE_POSITION_TYPE_TOP_CENTER,
    DW_RENDER_ENGINE_TILE_POSITION_TYPE_TOP_RIGHT,
    DW_RENDER_ENGINE_TILE_POSITION_TYPE_BOTTOM_LEFT,
    DW_RENDER_ENGINE_TILE_POSITION_TYPE_BOTTOM_CENTER,
    DW_RENDER_ENGINE_TILE_POSITION_TYPE_BOTTOM_RIGHT,
    DW_RENDER_ENGINE_TILE_POSITION_TYPE_CENTER_LEFT,
    DW_RENDER_ENGINE_TILE_POSITION_TYPE_CENTER_RIGHT,
    DW_RENDER_ENGINE_TILE_POSITION_TYPE_CENTER,
    DW_RENDER_ENGINE_TILE_POSITION_TYPE_GRID
} dwRenderEngineTilePositionType;

typedef struct dwRenderEngineTileLayout
{
    dwRenderEngineTileLayoutType sizeLayout;
    dwRenderEngineTileLayoutType positionLayout;
    dwRenderEngineTilePositionType positionType;
    dwRectf viewport;
    float32_t aspectRatio;
    bool useAspectRatio;
} dwRenderEngineTileLayout;

typedef struct dwRenderEngineTileState
{
    dwRenderEngineTileLayout layout;
    dwMatrix4f modelViewMatrix;
    dwMatrix4f projectionMatrix;
    dwRenderEngineColorRGBA backgroundColor;
    dwRenderEngineColorRGBA color;
    dwRenderEngineColorByValueMode colorByValueMode;
    float32_t lineWidth;
    float32_t pointSize;
    dwRenderEngineFont font;
    dwVector2f coordinateRange2D;
} dwRenderEngineTileState;

typedef struct dwRenderEngineParams
{
    dwRectf bounds;
    dwRenderEngineTileState defaultTile;
    uint32_t bufferSize;
    uint32_t maxBufferCount;
} dwRenderEngineParams;

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_initDefaultParams(dwRenderEngineParams* params,
                                          uint32_t width, uint32_t height);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_initialize(dwRenderEngineHandle_t* engine,
                                   const dwRenderEngineParams* params,
                                   dwVisualizationContextHandle_t context);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_release(dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_reset(dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_resetTile(dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_addTile(uint32_t* tileId,
                                const dwRenderEngineTileState* params,
                                dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_initTileState(dwRenderEngineTileState* params);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_removeTile(uint32_t tileId,
                                   dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_addSplitScreenTiles(uint32_t* firstTileId,
                                            uint32_t* secondTileId,
                                            bool horizontal,
                                            const dwRenderEngineTileState* firstParams,
                                            const dwRenderEngineTileState* secondParams,
                                            dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_addTilesByCount(uint32_t* outTileIds,
                                        uint32_t tileCount,
                                        uint32_t maxPerRow,
                                        const dwRenderEngineTileState* paramsList,
                                        dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_getTile(uint32_t* tileId,
                                dwConstRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_setTile(uint32_t tileId,
                                dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_getState(dwRenderEngineTileState* state,
                                 dwConstRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_setState(const dwRenderEngineTileState* state,
                                 dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_getModelView(dwMatrix4f* modelViewMatrix,
                                     dwConstRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_setModelView(const dwMatrix4f* modelViewMatrix,
                                     dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_getProjection(dwMatrix4f* projectionMatrix,
                                      dwConstRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_setProjection(const dwMatrix4f* projectionMatrix,
                                      dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_setLookAt(dwVector3f eye,
                                  dwVector3f center,
                                  dwVector3f up,
                                  dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_setLookAtByAngles(float32_t xAngleRadians,
                                          float32_t yAngleRadians,
                                          float32_t distance,
                                          dwVector3f center,
                                          dwVector3f up,
                                          dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_setOrthoProjection(float32_t left, float32_t right,
                                           float32_t bottom, float32_t top,
                                           float32_t near, float32_t far,
                                           dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_setPerspectiveProjection(float32_t fovRadsY,
                                                 float32_t aspect,
                                                 float32_t near,
                                                 float32_t far,
                                                 dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_getViewport(dwRectf* viewport,
                                    dwConstRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_getRenderViewport(dwRectf* viewport,
                                          dwConstRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_setViewport(dwRectf viewport,
                                    dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_getBounds(dwRectf* bounds,
                                  dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_setBounds(dwRectf bounds,
                                  dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_getColor(dwRenderEngineColorRGBA* color,
                                 dwConstRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_setBackgroundColor(dwRenderEngineColorRGBA color, dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_getBackgroundColor(dwRenderEngineColorRGBA* color,
                                           dwConstRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_setColor(dwRenderEngineColorRGBA color, dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_setColorByValue(dwRenderEngineColorByValueMode mode,
                                        float32_t scale,
                                        dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_getFont(dwRenderEngineFont* font,
                                dwConstRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_setFont(dwRenderEngineFont font,
                                dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_getLineWidth(float32_t* lineWidth,
                                     dwConstRenderEngineHandle_t engine);
DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_setLineWidth(float32_t lineWidth,
                                     dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_getPointSize(float32_t* pointSize,
                                     dwConstRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_setPointSize(float32_t pointSize,
                                     dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_getCoordinateRange2D(dwVector2f* range,
                                             dwConstRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_setCoordinateRange2D(dwVector2f range,
                                             dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_getLayout(dwRenderEngineTileLayout* layout,
                                  dwConstRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_setLayout(dwRenderEngineTileLayout layout,
                                  dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_createBuffer(uint32_t* bufferId,
                                     dwRenderEnginePrimitiveType type,
                                     uint32_t vertexStrideBytes,
                                     uint32_t offsetBytes,
                                     uint32_t primitiveCount,
                                     dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_destroyBuffer(uint32_t bufferId,
                                      dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_getBufferMaxPrimitiveCount(uint32_t* maxPrimitiveCount,
                                                   uint32_t bufferId,
                                                   dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_setBuffer(uint32_t bufferId,
                                  dwRenderEnginePrimitiveType type,
                                  const void* buffer,
                                  uint32_t vertexStrideBytes,
                                  uint32_t offsetBytes,
                                  uint32_t primitiveCount,
                                  dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_mapBuffer(uint32_t bufferId,
                                  void** buffer,
                                  uint32_t offsetBytes,
                                  uint32_t sizeBytes,
                                  dwRenderEnginePrimitiveType type,
                                  dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_unmapBuffer(uint32_t bufferId,
                                    dwRenderEnginePrimitiveType type,
                                    dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_renderBuffer(uint32_t bufferId,
                                     uint32_t primitiveCount,
                                     dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_renderBufferWithLabels(uint32_t bufferId,
                                               dwRenderEnginePrimitiveType type,
                                               uint32_t vertexStrideBytes,
                                               uint32_t offsetBytes,
                                               const char** labels,
                                               uint32_t primitiveCount,
                                               dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_render(dwRenderEnginePrimitiveType type,
                               const void* buffer,
                               uint32_t vertexStrideBytes,
                               uint32_t offsetBytes,
                               uint32_t primitiveCount,
                               dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_renderWithLabels(dwRenderEnginePrimitiveType type,
                                         const void* buffer,
                                         uint32_t vertexStrideBytes,
                                         uint32_t offsetBytes,
                                         const char* labels[],
                                         uint32_t primitiveCount,
                                         dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_renderWithLabel(dwRenderEnginePrimitiveType type,
                                        const void* buffer,
                                        uint32_t vertexStrideBytes,
                                        uint32_t offsetBytes,
                                        const char* label,
                                        uint32_t primitiveCount,
                                        dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_createImageGLFromFile(dwImageGL* img,
                                              const char* filename,
                                              dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_destroyImageGL(const dwImageGL* image,
                                       dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_renderImage2D(const dwImageGL* img,
                                      dwRectf plane,
                                      dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_renderImage3D(const dwImageGL* img,
                                      dwRectf plane,
                                      const dwMatrix4f* modelMatrix,
                                      dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_renderText2D(const char* text,
                                     dwVector2f pos,
                                     dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_renderText3D(const char* text,
                                     dwVector3f pos,
                                     dwRenderEngineHandle_t engine);
DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_setBufferPlanarGrid2D(uint32_t bufferId,
                                              dwRectf plane,
                                              float32_t xSpacing,
                                              float32_t ySpacing,
                                              dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_renderPlanarGrid2D(dwRectf plane,
                                           float32_t xSpacing,
                                           float32_t ySpacing,
                                           dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_setBufferPlanarGrid3D(uint32_t bufferId,
                                              dwRectf plane,
                                              float32_t xSpacing,
                                              float32_t ySpacing,
                                              const dwMatrix4f* modelMatrix,
                                              dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_renderPlanarGrid3D(dwRectf plane,
                                           float32_t xSpacing,
                                           float32_t ySpacing,
                                           const dwMatrix4f* modelMatrix,
                                           dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_setBufferEllipticalGrid2D(uint32_t bufferId,
                                                  dwRectf plane,
                                                  float32_t xSpacing,
                                                  float32_t ySpacing,
                                                  dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_renderEllipticalGrid2D(dwRectf plane,
                                               float32_t xSpacing,
                                               float32_t ySpacing,
                                               dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_setBufferEllipticalGrid3D(uint32_t bufferId,
                                                  dwRectf plane,
                                                  float32_t xSpacing,
                                                  float32_t ySpacing,
                                                  const dwMatrix4f* modelMatrix,
                                                  dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_renderEllipticalGrid3D(dwRectf plane,
                                               float32_t xSpacing,
                                               float32_t ySpacing,
                                               const dwMatrix4f* modelMatrix,
                                               dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_renderPlot2D(dwRenderEnginePlotType type,
                                     const void* buffer,
                                     uint32_t vertexStrideBytes,
                                     uint32_t offsetBytes,
                                     uint32_t primitiveCount,
                                     const char* label,
                                     dwVector4f range,
                                     dwRectf plane,
                                     dwRenderEngineColorRGBA axesColor,
                                     float32_t axesWidth,
                                     const char* title,
                                     const char* xLabel,
                                     const char* yLabel,
                                     dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_renderPlots2D(const dwRenderEnginePlotType* types,
                                      const void** buffers,
                                      const uint32_t* vertexStridesBytes,
                                      const uint32_t* offsetsBytes,
                                      const uint32_t* bufferCounts,
                                      const dwRenderEngineColorRGBA* colors,
                                      const float32_t* lineWidths,
                                      const char** labels,
                                      uint32_t plotsCount,
                                      dwVector4f range,
                                      dwRectf plane,
                                      dwRenderEngineColorRGBA axesColor,
                                      float32_t axesWidth,
                                      const char* title,
                                      const char* xLabel,
                                      const char* yLabel,
                                      dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_screenToWorld3D(dwVector3f* worldPosition,
                                        dwVector2f pixelPosition,
                                        dwVector2f screenSize,
                                        dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_world3DToScreen(dwVector2f* pixelPosition,
                                        dwVector3f worldPosition,
                                        dwVector2f screenSize,
                                        dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_getTileByScreenCoordinates(uint32_t* tileId,
                                                   dwVector2f pixelPosition,
                                                   dwVector2f screenSize,
                                                   dwConstRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_beginTextBatch(dwRenderEngineHandle_t engine);

DW_VIZ_API_PUBLIC
dwStatus dwRenderEngine_endTextBatch(dwRenderEngineHandle_t engine);
#ifdef __cplusplus
}
#endif

#endif // DW_VISUALIZATION_RENDERENGINE_H_