map.h

Go to the documentation of this file.

 
#ifndef MAPLIBRE_NATIVE_C_MAP_H
#define MAPLIBRE_NATIVE_C_MAP_H
 
#ifndef __cplusplus
#include <stdbool.h>
#endif
 
#include <stddef.h>
#include <stdint.h>
 
#include "base.h"
#include "completion.h"
#include "runtime.h"
 
#ifdef __cplusplus
extern "C" {
#endif

typedef enum MLN_BINDING("kind=bitmask") mln_camera_option_field : uint32_t {
  MLN_CAMERA_OPTION_CENTER = 1U << 0U,
  MLN_CAMERA_OPTION_ZOOM = 1U << 1U,
  MLN_CAMERA_OPTION_BEARING = 1U << 2U,
  MLN_CAMERA_OPTION_PITCH = 1U << 3U,
  MLN_CAMERA_OPTION_CENTER_ALTITUDE = 1U << 4U,
  MLN_CAMERA_OPTION_PADDING = 1U << 5U,
  MLN_CAMERA_OPTION_ANCHOR = 1U << 6U,
  MLN_CAMERA_OPTION_ROLL = 1U << 7U,
  MLN_CAMERA_OPTION_FOV = 1U << 8U,
} mln_camera_option_field;

typedef enum MLN_BINDING("kind=bitmask") mln_animation_option_field : uint32_t {
  MLN_ANIMATION_OPTION_DURATION = 1U << 0U,
  MLN_ANIMATION_OPTION_VELOCITY = 1U << 1U,
  MLN_ANIMATION_OPTION_MIN_ZOOM = 1U << 2U,
  MLN_ANIMATION_OPTION_EASING = 1U << 3U,
  MLN_ANIMATION_OPTION_TRANSITION_ID = 1U << 4U,
} mln_animation_option_field;

typedef enum MLN_BINDING(
  "kind=bitmask"
) mln_camera_fit_option_field : uint32_t {
  MLN_CAMERA_FIT_OPTION_PADDING = 1U << 0U,
  MLN_CAMERA_FIT_OPTION_BEARING = 1U << 1U,
  MLN_CAMERA_FIT_OPTION_PITCH = 1U << 2U,
} mln_camera_fit_option_field;

typedef enum MLN_BINDING("kind=bitmask") mln_bound_option_field : uint32_t {
  MLN_BOUND_OPTION_BOUNDS = 1U << 0U,
  MLN_BOUND_OPTION_MIN_ZOOM = 1U << 1U,
  MLN_BOUND_OPTION_MAX_ZOOM = 1U << 2U,
  MLN_BOUND_OPTION_MIN_PITCH = 1U << 3U,
  MLN_BOUND_OPTION_MAX_PITCH = 1U << 4U,
  MLN_BOUND_OPTION_UNBOUNDED = 1U << 5U,
} mln_bound_option_field;

typedef enum MLN_BINDING(
  "kind=bitmask"
) mln_free_camera_option_field : uint32_t {
  MLN_FREE_CAMERA_OPTION_POSITION = 1U << 0U,
  MLN_FREE_CAMERA_OPTION_ORIENTATION = 1U << 1U,
} mln_free_camera_option_field;

typedef enum MLN_BINDING("kind=bitmask") mln_projection_mode_field : uint32_t {
  MLN_PROJECTION_MODE_AXONOMETRIC = 1U << 0U,
  MLN_PROJECTION_MODE_X_SKEW = 1U << 1U,
  MLN_PROJECTION_MODE_Y_SKEW = 1U << 2U,
} mln_projection_mode_field;

typedef enum MLN_BINDING("kind=bitmask") mln_map_debug_option : uint32_t {
  MLN_MAP_DEBUG_TILE_BORDERS = 1U << 1U,
  MLN_MAP_DEBUG_PARSE_STATUS = 1U << 2U,
  MLN_MAP_DEBUG_TIMESTAMPS = 1U << 3U,
  MLN_MAP_DEBUG_COLLISION = 1U << 4U,
  MLN_MAP_DEBUG_OVERDRAW = 1U << 5U,
  MLN_MAP_DEBUG_STENCIL_CLIP = 1U << 6U,
  MLN_MAP_DEBUG_DEPTH_BUFFER = 1U << 7U,
} mln_map_debug_option;

typedef enum mln_north_orientation : uint32_t {
  MLN_NORTH_ORIENTATION_UP = 0,
  MLN_NORTH_ORIENTATION_RIGHT = 1,
  MLN_NORTH_ORIENTATION_DOWN = 2,
  MLN_NORTH_ORIENTATION_LEFT = 3,
} mln_north_orientation;

typedef enum mln_constrain_mode : uint32_t {
  MLN_CONSTRAIN_MODE_NONE = 0,
  MLN_CONSTRAIN_MODE_HEIGHT_ONLY = 1,
  MLN_CONSTRAIN_MODE_WIDTH_AND_HEIGHT = 2,
  MLN_CONSTRAIN_MODE_SCREEN = 3,
} mln_constrain_mode;

typedef enum mln_viewport_mode : uint32_t {
  MLN_VIEWPORT_MODE_DEFAULT = 0,
  MLN_VIEWPORT_MODE_FLIPPED_Y = 1,
} mln_viewport_mode;

typedef enum MLN_BINDING(
  "kind=bitmask"
) mln_map_viewport_option_field : uint32_t {
  MLN_MAP_VIEWPORT_OPTION_NORTH_ORIENTATION = 1U << 0U,
  MLN_MAP_VIEWPORT_OPTION_CONSTRAIN_MODE = 1U << 1U,
  MLN_MAP_VIEWPORT_OPTION_VIEWPORT_MODE = 1U << 2U,
  MLN_MAP_VIEWPORT_OPTION_FRUSTUM_OFFSET = 1U << 3U,
} mln_map_viewport_option_field;

typedef enum mln_tile_lod_mode : uint32_t {
  MLN_TILE_LOD_MODE_DEFAULT = 0,
  MLN_TILE_LOD_MODE_DISTANCE = 1,
} mln_tile_lod_mode;

typedef enum MLN_BINDING("kind=bitmask") mln_map_tile_option_field : uint32_t {
  MLN_MAP_TILE_OPTION_PREFETCH_ZOOM_DELTA = 1U << 0U,
  MLN_MAP_TILE_OPTION_LOD_MIN_RADIUS = 1U << 1U,
  MLN_MAP_TILE_OPTION_LOD_SCALE = 1U << 2U,
  MLN_MAP_TILE_OPTION_LOD_PITCH_THRESHOLD = 1U << 3U,
  MLN_MAP_TILE_OPTION_LOD_ZOOM_SHIFT = 1U << 4U,
  MLN_MAP_TILE_OPTION_LOD_MODE = 1U << 5U,
} mln_map_tile_option_field;

typedef enum mln_map_mode : uint32_t {
  MLN_MAP_MODE_CONTINUOUS = 0,
  MLN_MAP_MODE_STATIC = 1,
  MLN_MAP_MODE_TILE = 2,
} mln_map_mode;

typedef struct mln_logical_extent {
  uint32_t width;
  uint32_t height;
  double scale_factor;
} mln_logical_extent;

MLN_API mln_logical_extent mln_logical_extent_default(void) MLN_NOEXCEPT;

typedef struct mln_map_options {
  uint32_t size;
  mln_logical_extent initial_extent;
  uint32_t map_mode MLN_BINDING("enum=mln_map_mode");
  bool fast_pfor_enabled;
  uint64_t event_mask MLN_BINDING("enum=mln_runtime_event_mask");
} mln_map_options;

typedef struct mln_screen_point {
  double x;
  double y;
} mln_screen_point;

typedef struct mln_edge_insets {
  double top;
  double left;
  double bottom;
  double right;
} mln_edge_insets;

typedef struct mln_lat_lng {
  double latitude;
  double longitude;
} mln_lat_lng;

typedef struct mln_camera_options {
  uint32_t size;
  uint32_t fields MLN_BINDING("enum=mln_camera_option_field");
  mln_lat_lng center MLN_BINDING("mask=fields;bit=MLN_CAMERA_OPTION_CENTER");
  double center_altitude
    MLN_BINDING("mask=fields;bit=MLN_CAMERA_OPTION_CENTER_ALTITUDE");
  mln_edge_insets padding
    MLN_BINDING("mask=fields;bit=MLN_CAMERA_OPTION_PADDING");
  mln_screen_point anchor
    MLN_BINDING("mask=fields;bit=MLN_CAMERA_OPTION_ANCHOR");
  double zoom MLN_BINDING("mask=fields;bit=MLN_CAMERA_OPTION_ZOOM");
  double bearing MLN_BINDING("mask=fields;bit=MLN_CAMERA_OPTION_BEARING");
  double pitch MLN_BINDING("mask=fields;bit=MLN_CAMERA_OPTION_PITCH");
  double roll MLN_BINDING("mask=fields;bit=MLN_CAMERA_OPTION_ROLL");
  double field_of_view MLN_BINDING("mask=fields;bit=MLN_CAMERA_OPTION_FOV");
} mln_camera_options;

typedef struct mln_unit_bezier {
  double x1;
  double y1;
  double x2;
  double y2;
} mln_unit_bezier;

typedef enum mln_camera_transition_outcome : uint32_t {
  MLN_CAMERA_TRANSITION_OUTCOME_COMPLETED = 0,
  MLN_CAMERA_TRANSITION_OUTCOME_CANCELLED = 1,
  MLN_CAMERA_TRANSITION_OUTCOME_CLOSED = 2,
} mln_camera_transition_outcome;

typedef struct mln_camera_transition_end {
  uint32_t size;
  uint32_t outcome MLN_BINDING("enum=mln_camera_transition_outcome");
  uint64_t generation;
} mln_camera_transition_end;

MLN_BINDING("delivery=MLN_DELIVERY_TYPE_CAMERA_TRANSITION_END")
typedef void (*mln_camera_transition_end_callback)(
  void* user_data, const mln_camera_transition_end* end
);

typedef struct mln_camera_transition_handler {
  mln_camera_transition_end_callback callback MLN_BINDING("nullable=true");
  void* user_data MLN_BINDING("kind=context");
  mln_user_data_release release_user_data;
  mln_delivery_queue queue MLN_BINDING("kind=delivery_queue");
} mln_camera_transition_handler MLN_BINDING(
  "kind=callback_registration;release=release_user_data"
);

typedef struct mln_animation_options {
  uint32_t fields MLN_BINDING("enum=mln_animation_option_field");
  double duration_ms
    MLN_BINDING("mask=fields;bit=MLN_ANIMATION_OPTION_DURATION");
  double velocity MLN_BINDING("mask=fields;bit=MLN_ANIMATION_OPTION_VELOCITY");
  double min_zoom MLN_BINDING("mask=fields;bit=MLN_ANIMATION_OPTION_MIN_ZOOM");
  mln_unit_bezier easing
    MLN_BINDING("mask=fields;bit=MLN_ANIMATION_OPTION_EASING");
  uint64_t transition_id
    MLN_BINDING("mask=fields;bit=MLN_ANIMATION_OPTION_TRANSITION_ID");
  mln_camera_transition_handler end_handler;
} mln_animation_options;

typedef enum mln_camera_update_mode : uint32_t {
  MLN_CAMERA_UPDATE_MODE_JUMP = 0,
  MLN_CAMERA_UPDATE_MODE_EASE = 1,
  MLN_CAMERA_UPDATE_MODE_FLY = 2,
} mln_camera_update_mode;

typedef enum mln_gesture_phase : uint32_t {
  MLN_GESTURE_PHASE_NONE = 0,
  MLN_GESTURE_PHASE_BEGIN = 1,
  MLN_GESTURE_PHASE_UPDATE = 2,
  MLN_GESTURE_PHASE_END = 3,
  MLN_GESTURE_PHASE_CANCEL = 4,
} mln_gesture_phase;

typedef enum MLN_BINDING("kind=bitmask") mln_camera_delta_field : uint32_t {
  MLN_CAMERA_DELTA_OFFSET = 1U << 0U,
  MLN_CAMERA_DELTA_SCALE = 1U << 1U,
  MLN_CAMERA_DELTA_BEARING = 1U << 2U,
  MLN_CAMERA_DELTA_PITCH = 1U << 3U,
  MLN_CAMERA_DELTA_ANCHOR = 1U << 4U,
} mln_camera_delta_field;

typedef struct mln_camera_delta {
  uint32_t size;
  uint32_t fields MLN_BINDING("enum=mln_camera_delta_field");
  mln_screen_point offset
    MLN_BINDING("mask=fields;bit=MLN_CAMERA_DELTA_OFFSET");
  double scale MLN_BINDING("mask=fields;bit=MLN_CAMERA_DELTA_SCALE");
  double bearing MLN_BINDING("mask=fields;bit=MLN_CAMERA_DELTA_BEARING");
  double pitch MLN_BINDING("mask=fields;bit=MLN_CAMERA_DELTA_PITCH");
  mln_screen_point anchor
    MLN_BINDING("mask=fields;bit=MLN_CAMERA_DELTA_ANCHOR");
  mln_animation_options animation;
  uint32_t gesture_phase MLN_BINDING("enum=mln_gesture_phase");
  uint32_t reserved MLN_BINDING("kind=reserved");
} mln_camera_delta;

typedef struct mln_camera_update {
  uint32_t size;
  uint32_t mode MLN_BINDING("enum=mln_camera_update_mode");
  mln_camera_options camera;
  mln_animation_options animation;
  uint32_t gesture_phase MLN_BINDING("enum=mln_gesture_phase");
  uint32_t reserved MLN_BINDING("kind=reserved");
} mln_camera_update;

typedef struct mln_camera_fit_options {
  uint32_t size;
  uint32_t fields MLN_BINDING("enum=mln_camera_fit_option_field");
  mln_edge_insets padding
    MLN_BINDING("mask=fields;bit=MLN_CAMERA_FIT_OPTION_PADDING");
  double bearing MLN_BINDING("mask=fields;bit=MLN_CAMERA_FIT_OPTION_BEARING");
  double pitch MLN_BINDING("mask=fields;bit=MLN_CAMERA_FIT_OPTION_PITCH");
} mln_camera_fit_options;

typedef struct mln_vec3 {
  double x;
  double y;
  double z;
} mln_vec3;

typedef struct mln_quaternion {
  double x;
  double y;
  double z;
  double w;
} mln_quaternion;

typedef struct mln_free_camera_options {
  uint32_t size;
  uint32_t fields MLN_BINDING("enum=mln_free_camera_option_field");
  mln_vec3 position
    MLN_BINDING("mask=fields;bit=MLN_FREE_CAMERA_OPTION_POSITION");
  mln_quaternion orientation
    MLN_BINDING("mask=fields;bit=MLN_FREE_CAMERA_OPTION_ORIENTATION");
} mln_free_camera_options;

typedef enum MLN_BINDING(
  "kind=bitmask"
) mln_feature_state_selector_field : uint32_t {
  MLN_FEATURE_STATE_SELECTOR_SOURCE_LAYER_ID = 1U << 0U,
  MLN_FEATURE_STATE_SELECTOR_FEATURE_ID = 1U << 1U,
  MLN_FEATURE_STATE_SELECTOR_STATE_KEY = 1U << 2U,
} mln_feature_state_selector_field;

typedef struct mln_feature_state_selector {
  uint32_t size;
  uint32_t fields MLN_BINDING("enum=mln_feature_state_selector_field");
  mln_buffer_view source_id;
  mln_buffer_view source_layer_id
    MLN_BINDING("mask=fields;bit=MLN_FEATURE_STATE_SELECTOR_SOURCE_LAYER_ID");
  mln_buffer_view feature_id
    MLN_BINDING("mask=fields;bit=MLN_FEATURE_STATE_SELECTOR_FEATURE_ID");
  mln_buffer_view state_key
    MLN_BINDING("mask=fields;bit=MLN_FEATURE_STATE_SELECTOR_STATE_KEY");
} mln_feature_state_selector;

typedef struct mln_lat_lng_bounds {
  mln_lat_lng southwest;
  mln_lat_lng northeast;
} mln_lat_lng_bounds;

typedef struct mln_bound_options {
  uint32_t size;
  uint32_t fields MLN_BINDING("enum=mln_bound_option_field");
  mln_lat_lng_bounds bounds
    MLN_BINDING("mask=fields;bit=MLN_BOUND_OPTION_BOUNDS");
  double min_zoom MLN_BINDING("mask=fields;bit=MLN_BOUND_OPTION_MIN_ZOOM");
  double max_zoom MLN_BINDING("mask=fields;bit=MLN_BOUND_OPTION_MAX_ZOOM");
  double min_pitch MLN_BINDING("mask=fields;bit=MLN_BOUND_OPTION_MIN_PITCH");
  double max_pitch MLN_BINDING("mask=fields;bit=MLN_BOUND_OPTION_MAX_PITCH");
} mln_bound_options;

typedef struct mln_offline_tile_pyramid_region_definition {
  mln_buffer_view style_url;
  mln_lat_lng_bounds bounds;
  double min_zoom;
  double max_zoom;
  float pixel_ratio;
  bool include_ideographs;
} mln_offline_tile_pyramid_region_definition;

typedef struct mln_offline_geometry_region_definition {
  mln_buffer_view style_url;
  mln_buffer_view geometry MLN_BINDING("encoding=json");
  double min_zoom;
  double max_zoom;
  float pixel_ratio;
  bool include_ideographs;
} mln_offline_geometry_region_definition;

typedef union mln_offline_region_definition_data {
  mln_offline_tile_pyramid_region_definition tile_pyramid
    MLN_BINDING("variant=MLN_OFFLINE_REGION_DEFINITION_TILE_PYRAMID");
  mln_offline_geometry_region_definition geometry
    MLN_BINDING("variant=MLN_OFFLINE_REGION_DEFINITION_GEOMETRY");
} mln_offline_region_definition_data;

typedef struct mln_offline_region_definition {
  uint32_t size;
  uint32_t type MLN_BINDING("enum=mln_offline_region_definition_type");
  mln_offline_region_definition_data data MLN_BINDING("tag=type");
} mln_offline_region_definition;

typedef struct mln_offline_region_info {
  mln_offline_region_id id;
  mln_offline_region_definition definition;
  const uint8_t* metadata MLN_BINDING("length=metadata_size;encoding=bytes");
  size_t metadata_size;
} mln_offline_region_info;

MLN_BINDING("execution=operation;result=mln_offline_region_info")
MLN_API mln_status mln_runtime_create_offline_region(
  mln_runtime runtime, const mln_offline_region_definition* definition,
  const uint8_t* metadata MLN_BINDING("length=metadata_size;encoding=bytes"),
  size_t metadata_size, const mln_completion* completion,
  mln_diagnostic* out_diagnostic
) MLN_NOEXCEPT;

MLN_BINDING("execution=query;result=mln_offline_region_info;nullable=true")
MLN_API mln_status mln_runtime_get_offline_region(
  mln_runtime runtime, mln_offline_region_id region_id,
  const mln_completion* completion, mln_diagnostic* out_diagnostic
) MLN_NOEXCEPT;

MLN_BINDING("execution=query;result=mln_offline_region_info;shape=array")
MLN_API mln_status mln_runtime_list_offline_regions(
  mln_runtime runtime, const mln_completion* completion,
  mln_diagnostic* out_diagnostic
) MLN_NOEXCEPT;

MLN_BINDING("execution=operation;result=mln_offline_region_info;shape=array")
MLN_API mln_status mln_runtime_merge_offline_regions(
  mln_runtime runtime, mln_buffer_view side_database_path,
  const mln_completion* completion, mln_diagnostic* out_diagnostic
) MLN_NOEXCEPT;

MLN_BINDING("execution=operation;result=mln_offline_region_info")
MLN_API mln_status mln_runtime_update_offline_region_metadata(
  mln_runtime runtime, mln_offline_region_id region_id,
  const uint8_t* metadata MLN_BINDING("length=metadata_size;encoding=bytes"),
  size_t metadata_size, const mln_completion* completion,
  mln_diagnostic* out_diagnostic
) MLN_NOEXCEPT;

MLN_BINDING("execution=query;result=mln_offline_region_status")
MLN_API mln_status mln_runtime_get_offline_region_status(
  mln_runtime runtime, mln_offline_region_id region_id,
  const mln_completion* completion, mln_diagnostic* out_diagnostic
) MLN_NOEXCEPT;

MLN_BINDING("execution=operation")
MLN_API mln_status mln_runtime_set_offline_region_observed(
  mln_runtime runtime, mln_offline_region_id region_id, bool observed,
  const mln_completion* completion, mln_diagnostic* out_diagnostic
) MLN_NOEXCEPT;

MLN_BINDING("execution=operation")
MLN_API mln_status mln_runtime_set_offline_region_download_state(
  mln_runtime runtime, mln_offline_region_id region_id,
  uint32_t state MLN_BINDING("enum=mln_offline_region_download_state"),
  const mln_completion* completion, mln_diagnostic* out_diagnostic
) MLN_NOEXCEPT;

MLN_BINDING("execution=operation")
MLN_API mln_status mln_runtime_invalidate_offline_region(
  mln_runtime runtime, mln_offline_region_id region_id,
  const mln_completion* completion, mln_diagnostic* out_diagnostic
) MLN_NOEXCEPT;

MLN_BINDING("execution=operation")
MLN_API mln_status mln_runtime_delete_offline_region(
  mln_runtime runtime, mln_offline_region_id region_id,
  const mln_completion* completion, mln_diagnostic* out_diagnostic
) MLN_NOEXCEPT;

typedef struct mln_projected_meters {
  double northing;
  double easting;
} mln_projected_meters;

typedef struct mln_projection_mode {
  uint32_t size;
  uint32_t fields MLN_BINDING("enum=mln_projection_mode_field");
  bool axonometric
    MLN_BINDING("mask=fields;bit=MLN_PROJECTION_MODE_AXONOMETRIC");
  double x_skew MLN_BINDING("mask=fields;bit=MLN_PROJECTION_MODE_X_SKEW");
  double y_skew MLN_BINDING("mask=fields;bit=MLN_PROJECTION_MODE_Y_SKEW");
} mln_projection_mode;

typedef struct mln_map_viewport_options {
  uint32_t size;
  uint32_t fields MLN_BINDING("enum=mln_map_viewport_option_field");
  uint32_t north_orientation MLN_BINDING(
    "mask=fields;bit=MLN_MAP_VIEWPORT_OPTION_NORTH_ORIENTATION;"
    "enum=mln_north_orientation"
  );
  uint32_t constrain_mode MLN_BINDING(
    "mask=fields;bit=MLN_MAP_VIEWPORT_OPTION_CONSTRAIN_MODE;"
    "enum=mln_constrain_mode"
  );
  uint32_t viewport_mode MLN_BINDING(
    "mask=fields;bit=MLN_MAP_VIEWPORT_OPTION_VIEWPORT_MODE;"
    "enum=mln_viewport_mode"
  );
  mln_edge_insets frustum_offset
    MLN_BINDING("mask=fields;bit=MLN_MAP_VIEWPORT_OPTION_FRUSTUM_OFFSET");
} mln_map_viewport_options;

typedef struct mln_map_view {
  uint32_t size;
  mln_camera_options camera;
  mln_logical_extent extent;
  mln_projection_mode projection_mode;
  mln_map_viewport_options viewport;
} mln_map_view;

typedef struct mln_map_tile_options {
  uint32_t size;
  uint32_t fields MLN_BINDING("enum=mln_map_tile_option_field");
  uint32_t prefetch_zoom_delta
    MLN_BINDING("mask=fields;bit=MLN_MAP_TILE_OPTION_PREFETCH_ZOOM_DELTA");
  double lod_min_radius
    MLN_BINDING("mask=fields;bit=MLN_MAP_TILE_OPTION_LOD_MIN_RADIUS");
  double lod_scale MLN_BINDING("mask=fields;bit=MLN_MAP_TILE_OPTION_LOD_SCALE");
  double lod_pitch_threshold
    MLN_BINDING("mask=fields;bit=MLN_MAP_TILE_OPTION_LOD_PITCH_THRESHOLD");
  double lod_zoom_shift
    MLN_BINDING("mask=fields;bit=MLN_MAP_TILE_OPTION_LOD_ZOOM_SHIFT");
  uint32_t lod_mode MLN_BINDING(
    "mask=fields;bit=MLN_MAP_TILE_OPTION_LOD_MODE;enum=mln_tile_lod_mode"
  );
} mln_map_tile_options;

typedef struct mln_map_snapshot {
  uint32_t size;
  uint32_t debug_options MLN_BINDING("enum=mln_map_debug_option");
  uint64_t generation;
  bool fully_loaded;
  bool rendering_stats_view_enabled;
  bool gesture_in_progress;
  bool transition_in_progress;
  uint64_t event_mask MLN_BINDING("enum=mln_runtime_event_mask");
  uint64_t latest_render_update_generation;
  mln_map_tile_options tile;
  mln_bound_options bounds;
  mln_free_camera_options free_camera;
  mln_map_view view;
} mln_map_snapshot;

typedef struct mln_camera_query_result {
  uint64_t generation;
  mln_camera_options camera;
} mln_camera_query_result;

MLN_API mln_map_options mln_map_options_default(void) MLN_NOEXCEPT;

MLN_BINDING("execution=lifecycle;result=mln_map")
MLN_API mln_status mln_runtime_create_map(
  mln_runtime runtime, const mln_map_options* options,
  const mln_completion* completion, mln_diagnostic* out_diagnostic
) MLN_NOEXCEPT;

MLN_BINDING("execution=snapshot")
MLN_API mln_status mln_map_get_snapshot(
  mln_map map, mln_map_snapshot* out_snapshot MLN_BINDING("direction=out"),
  mln_diagnostic* out_diagnostic
) MLN_NOEXCEPT;

MLN_BINDING("execution=command")
MLN_API mln_status mln_map_resize(
  mln_map map, mln_logical_extent extent, const mln_completion* completion,
  mln_diagnostic* out_diagnostic
) MLN_NOEXCEPT;

MLN_BINDING("execution=command")
MLN_API mln_status mln_map_request_repaint(
  mln_map map, const mln_completion* completion, mln_diagnostic* out_diagnostic
) MLN_NOEXCEPT;

MLN_BINDING("execution=command")
MLN_API mln_status mln_map_begin_command_group(
  mln_map map, const mln_completion* completion, mln_diagnostic* out_diagnostic
) MLN_NOEXCEPT;

MLN_BINDING("execution=command")
MLN_API mln_status mln_map_end_command_group(
  mln_map map, const mln_completion* completion, mln_diagnostic* out_diagnostic
) MLN_NOEXCEPT;

MLN_BINDING("execution=command")
MLN_API mln_status mln_map_set_feature_state(
  mln_map map, const mln_feature_state_selector* selector,
  mln_buffer_view state MLN_BINDING("encoding=json"),
  const mln_completion* completion, mln_diagnostic* out_diagnostic
) MLN_NOEXCEPT;

MLN_BINDING("execution=query;result=mln_buffer_view;encoding=json")
MLN_API mln_status mln_map_get_feature_state(
  mln_map map, const mln_feature_state_selector* selector,
  const mln_completion* completion, mln_diagnostic* out_diagnostic
) MLN_NOEXCEPT;

MLN_BINDING("execution=command")
MLN_API mln_status mln_map_remove_feature_state(
  mln_map map, const mln_feature_state_selector* selector,
  const mln_completion* completion, mln_diagnostic* out_diagnostic
) MLN_NOEXCEPT;

MLN_BINDING("execution=operation")
MLN_API mln_status mln_map_request_still_image(
  mln_map map, const mln_completion* completion, mln_diagnostic* out_diagnostic
) MLN_NOEXCEPT;

MLN_BINDING("execution=lifecycle")
MLN_API mln_status mln_map_release(
  mln_map map, const mln_completion* completion, mln_diagnostic* out_diagnostic
) MLN_NOEXCEPT;

MLN_API mln_status
mln_map_dispose(mln_map map, mln_diagnostic* out_diagnostic) MLN_NOEXCEPT;

MLN_BINDING("execution=command")
MLN_API mln_status mln_map_set_style_url(
  mln_map map, mln_buffer_view url, const mln_completion* completion,
  mln_diagnostic* out_diagnostic
) MLN_NOEXCEPT;

MLN_BINDING("execution=command")
MLN_API mln_status mln_map_set_style_json(
  mln_map map, mln_buffer_view json MLN_BINDING("encoding=json"),
  const mln_completion* completion, mln_diagnostic* out_diagnostic
) MLN_NOEXCEPT;

MLN_BINDING("execution=query;result=mln_buffer_view;encoding=json")
MLN_API mln_status mln_map_get_loaded_style_json(
  mln_map map, const mln_completion* completion, mln_diagnostic* out_diagnostic
) MLN_NOEXCEPT;

MLN_BINDING("execution=query;result=mln_buffer_view")
MLN_API mln_status mln_map_get_style_url(
  mln_map map, const mln_completion* completion, mln_diagnostic* out_diagnostic
) MLN_NOEXCEPT;

MLN_BINDING("execution=command")
MLN_API mln_status mln_map_set_event_mask(
  mln_map map, uint64_t mask MLN_BINDING("enum=mln_runtime_event_mask"),
  const mln_completion* completion, mln_diagnostic* out_diagnostic
) MLN_NOEXCEPT;
 
#ifdef __cplusplus
}
#endif
 
#endif  // MAPLIBRE_NATIVE_C_MAP_H