c_api_gui.h - Engine C API Reference

c_api_gui.h
  1. #pragma once
  3. #include "c_api_types.h"
  5. #ifdef __cplusplus
  6. extern "C" {
  7. #endif
  9. struct GuiCApi
  10. {
  11.     unsigned (*triangle) (GuiPtr, ConstVector3Ptr p0, ConstVector3Ptr p1, ConstVector3Ptr p2, unsigned layer, ConstVector4Ptr optional_color,
  12.                           MaterialPtr optional, ConstVector2Ptr optional_uv0, ConstVector2Ptr optional_uv1, ConstVector2Ptr optional_uv2);
  13.     void     (*update_triangle) (GuiPtr, unsigned id, ConstVector3Ptr p0, ConstVector3Ptr p1, ConstVector3Ptr p2, unsigned layer, ConstVector4Ptr optional_color);
  14.     void     (*destroy_triangle) (GuiPtr, unsigned id);
  16.     unsigned (*rect) (GuiPtr, ConstVector2Ptr position, unsigned layer, ConstVector2Ptr size, ConstVector4Ptr optional_color, MaterialPtr optional_material);
  17.     void     (*update_rect) (GuiPtr, unsigned id, ConstVector2Ptr position, unsigned layer, ConstVector2Ptr size, ConstVector4Ptr optional_color);
  18.     void     (*destroy_rect) (GuiPtr, unsigned id);
  20.     unsigned (*rect_3d) (GuiPtr, ConstMatrix4x4Ptr transform, ConstVector3Ptr position, unsigned layer, ConstVector2Ptr size, ConstVector4Ptr optional_color, MaterialPtr optional_material);
  21.     void     (*update_rect_3d) (GuiPtr, unsigned id, ConstMatrix4x4Ptr transform, ConstVector3Ptr position, unsigned layer, ConstVector2Ptr size, ConstVector4Ptr optional_color);
  22.     void     (*destroy_rect_3d) (GuiPtr, unsigned id);
  24.     unsigned (*bitmap) (GuiPtr, MaterialPtr, ConstVector2Ptr position, unsigned layer, ConstVector2Ptr size, ConstVector4Ptr optional_color, ConstVector2Ptr optional_uv00, ConstVector2Ptr optional_uv11);
  25.     void     (*update_bitmap) (GuiPtr, unsigned id, MaterialPtr, ConstVector2Ptr position, unsigned layer,
  26.                 ConstVector2Ptr size, ConstVector4Ptr optional_color, ConstVector2Ptr optional_uv00, ConstVector2Ptr optional_uv11);
  27.     void     (*destroy_bitmap) (GuiPtr, unsigned id);
  29.     unsigned (*bitmap_3d) (GuiPtr, ConstMatrix4x4Ptr transform, MaterialPtr, ConstVector3Ptr position, unsigned layer, ConstVector2Ptr size,
  30.                 ConstVector4Ptr optional_color, ConstVector2Ptr optional_uv00, ConstVector2Ptr optional_uv11);
  31.     void     (*update_bitmap_3d) (GuiPtr, unsigned id, ConstMatrix4x4Ptr transform, MaterialPtr, ConstVector3Ptr position, unsigned layer,
  32.                 ConstVector2Ptr size, ConstVector4Ptr optional_color, ConstVector2Ptr optional_uv00, ConstVector2Ptr optional_uv11);
  33.     void     (*destroy_bitmap_3d) (GuiPtr, unsigned id);
  36.     unsigned (*text) (GuiPtr, const char* text, uint64_t font, float font_size, MaterialPtr, ConstVector2Ptr position, unsigned layer, float letter_spacing, ConstVector4Ptr optional_color);
  37.     void     (*update_text) (GuiPtr, unsigned id, const char* text, uint64_t font, float font_size, MaterialPtr, ConstVector2Ptr position, unsigned layer, float letter_spacing, ConstVector4Ptr optional_color);
  38.     void     (*destroy_text) (GuiPtr, unsigned id);
  40.     unsigned (*text_3d) (GuiPtr, const char* text_3d, uint64_t font, float font_size, MaterialPtr, ConstMatrix4x4Ptr transform,
  41.                 ConstVector3Ptr position, unsigned layer, ConstVector4Ptr optional_color, float letter_spacing);
  42.     void     (*update_text_3d) (GuiPtr, unsigned id, const char* text, uint64_t font, float font_size, MaterialPtr, ConstMatrix4x4Ptr transform,
  43.                 ConstVector3Ptr position, unsigned layer, ConstVector4Ptr optional_color, float letter_spacing);
  44.     void     (*destroy_text_3d) (GuiPtr, unsigned id);
  46.     struct TextExtentsResult (*text_extents) (GuiPtr, const char* text, uint64_t font, float font_size, float letter_spacing);
  48.     /*  Fills the row_length_buffer with the length of each row after having processed the text with word wrapping.
  49.         Returns the total number of rows.   */
  50.     unsigned (*word_wrap) (GuiPtr, const char* text, uint64_t font, float font_size, float width, const char* whitespace,
  51.         const char* soft_dividers, const char* return_dividers, float letter_spacing, unsigned* row_length_buffer, unsigned buffer_size);
  53.     unsigned (*video)(GuiPtr gui_pointer, VideoPlayerPtr video_player, MaterialPtr material_pointer,
  54.         ConstVector2Ptr pos, unsigned layer, ConstVector2Ptr opt_size, ConstVector4Ptr opt_color);
  55.     void (*update_video)(GuiPtr gui_pointer, unsigned id, VideoPlayerPtr video_player, MaterialPtr material_pointer,
  56.         ConstVector2Ptr pos, unsigned layer, ConstVector2Ptr opt_size, ConstVector4Ptr opt_color);
  57.     void (*destroy_video)(GuiPtr gui_pointer, unsigned id);
  59.     unsigned (*video_3d)(GuiPtr gui_pointer, VideoPlayerPtr video_player, ConstMatrix4x4Ptr transform, MaterialPtr material_pointer,
  60.         ConstVector3Ptr pos, unsigned layer, ConstVector2Ptr opt_size, ConstVector4Ptr opt_color);
  61.     void (*update_video_3d)(GuiPtr gui_pointer, unsigned id, VideoPlayerPtr video_player, ConstMatrix4x4Ptr transform, MaterialPtr material_pointer,
  62.         ConstVector3Ptr pos, unsigned layer, ConstVector2Ptr opt_size, ConstVector4Ptr opt_color);
  63.     void (*destroy_video_3d)(GuiPtr gui_pointer, unsigned id);
  65.     void    (*set_visible) (GuiPtr, int visible);
  66.     int     (*is_visible) (GuiPtr);
  68.     MaterialPtr (*material)(GuiPtr gui_pointer, uint64_t material_id64, const char *optional_debug_material_name);
  69.     MaterialPtr (*create_material)(GuiPtr gui_pointer, uint64_t material_id64, const char *optional_debug_material_name);
  71.     int     (*has_all_glyphs) (GuiPtr, const char* text, uint64_t font);
  72.     void    (*move) (GuiPtr, float x, float y);
  73.     void    (*move_3d) (GuiPtr, ConstMatrix4x4Ptr transform);
  74.     void    (*reset) (GuiPtr);
  76.     void            (*resolution) (ViewportPtr optional_viewport, ConstWindowPtr optional_window, unsigned int *out_width, unsigned int *out_height);
  77.     CApiMatrix4x4   (*rotation_2d) (ConstVector2Ptr position_pointer, float angle, ConstVector2Ptr optional_pivot);
  79.     /*  Equivalent to vector4(255, r, g, b).    */
  80.     CApiVector4 (*color_rgb) (float r, float g, float b);
  81.     /*  Equivalent to vector4(a, r, g, b).      */
  82.     CApiVector4 (*color_argb) (float a, float r, float g, float b);
  84.     unsigned(*get_id) (GuiPtr);
  86.     void (*set_video_playback_speed)(VideoPlayerPtr video_player, float speed);
  87.     void (*set_video_loop)(VideoPlayerPtr video_player, unsigned loop);
  88.     unsigned (*video_has_audio)(VideoPlayerPtr video_player);
  89.     StreamSourcePtr (*video_sound_stream_source)(VideoPlayerPtr video_player);
  90.     void (*set_video_sound_stream_enabled)(VideoPlayerPtr video_player, unsigned enabled);
  91.     unsigned (*video_number_of_frames)(VideoPlayerPtr video_player);
  92.     unsigned (*video_current_frame)(VideoPlayerPtr video_player);
  93.     unsigned (*video_times_looped)(VideoPlayerPtr video_player);
  95.     /*  Not available in Release builds.    */
  96.     unsigned (*texture_size) (uint64_t resource_id64, unsigned int *out_width, unsigned int *out_height);
  97.     GuiThumbnailPtr (*thumbnail_load_texture)(unsigned num_textures, uint64_t* names_id64);
  98.     GuiThumbnailPtr (*thumbnail_load_dds)(const char *path, uint64_t name_id64);
  99.     void (*thumbnail_unload)(GuiThumbnailPtr thumbnail);
  100. };
  102. #ifdef __cplusplus
  103. }
  104. #endif
Please send us your comment about this page