render_target.h

Go to the documentation of this file.

 
#ifndef MAPLIBRE_NATIVE_C_RENDER_TARGET_H
#define MAPLIBRE_NATIVE_C_RENDER_TARGET_H
 
#include <stdint.h>
 
#include "base.h"
 
#ifdef __cplusplus
extern "C" {
#endif

typedef uint64_t mln_vulkan_non_dispatchable_handle;

#define MLN_VULKAN_NON_DISPATCHABLE_HANDLE_NULL UINT64_C(0)

typedef struct mln_render_target_extent {
  uint32_t size;
  uint32_t width;
  uint32_t height;
  double scale_factor;
} mln_render_target_extent;

typedef struct mln_metal_context_descriptor {
  uint32_t size;
  void* device;
} mln_metal_context_descriptor;

typedef struct mln_vulkan_context_descriptor {
  uint32_t size;
  void* instance;
  void* physical_device;
  void* device;
  void* graphics_queue;
  uint32_t graphics_queue_family_index;
  void* get_instance_proc_addr;
  void* get_device_proc_addr;
} mln_vulkan_context_descriptor;

typedef struct mln_webgpu_context_descriptor {
  uint32_t size;
  void* instance;
  void* device;
  void* queue;
} mln_webgpu_context_descriptor;

typedef enum mln_opengl_context_provider_flag : uint32_t {
  MLN_OPENGL_CONTEXT_PROVIDER_FLAG_WGL = 1u << 0u,
  MLN_OPENGL_CONTEXT_PROVIDER_FLAG_EGL = 1u << 1u,
  MLN_OPENGL_CONTEXT_PROVIDER_FLAG_WEBGL = 1u << 2u,
} mln_opengl_context_provider_flag;

typedef enum mln_opengl_context_platform : uint32_t {
  MLN_OPENGL_CONTEXT_PLATFORM_UNSPECIFIED = 0u,
  MLN_OPENGL_CONTEXT_PLATFORM_WGL = 1u,
  MLN_OPENGL_CONTEXT_PLATFORM_EGL = 2u,
  MLN_OPENGL_CONTEXT_PLATFORM_WEBGL = 3u,
} mln_opengl_context_platform;

typedef enum mln_opengl_context_ownership : uint32_t {
  MLN_OPENGL_CONTEXT_OWNERSHIP_SHARED = 0u,
  MLN_OPENGL_CONTEXT_OWNERSHIP_DEDICATED = 1u,
} mln_opengl_context_ownership;

typedef enum mln_opengl_client_api : uint32_t {
  MLN_OPENGL_CLIENT_API_UNSPECIFIED = 0u,
  MLN_OPENGL_CLIENT_API_GL = 1u,
  MLN_OPENGL_CLIENT_API_GLES = 2u,
} mln_opengl_client_api;

typedef struct mln_wgl_context_descriptor {
  uint32_t size;
  void* device_context;
  void* share_context;
  void* get_proc_address;
} mln_wgl_context_descriptor;

typedef struct mln_egl_context_descriptor {
  uint32_t size;
  void* display;
  void* config;
  void* share_context;
  mln_opengl_client_api client_api;
  void* get_proc_address;
} mln_egl_context_descriptor;

typedef struct mln_webgl_context_descriptor {
  uint32_t size;
  int32_t context;
} mln_webgl_context_descriptor;

typedef struct mln_opengl_context_descriptor {
  uint32_t size;
  mln_opengl_context_platform platform;
  mln_opengl_context_ownership ownership;
  union {
    mln_wgl_context_descriptor wgl;
    mln_egl_context_descriptor egl;
    mln_webgl_context_descriptor webgl;
  } data;
} mln_opengl_context_descriptor;

MLN_API mln_status mln_render_target_extent_physical_size(
  const mln_render_target_extent* extent, uint32_t* out_width,
  uint32_t* out_height
) MLN_NOEXCEPT;

MLN_API uint32_t mln_opengl_supported_context_provider_mask(void) MLN_NOEXCEPT;
 
#ifdef __cplusplus
}
#endif
 
#endif  // MAPLIBRE_NATIVE_C_RENDER_TARGET_H