201 lines
8.4 KiB
C
201 lines
8.4 KiB
C
/**********************************************************************************************
|
|
*
|
|
* raylibExtras * Utilities and Shared Components for Raylib
|
|
*
|
|
* rlImGui * basic ImGui integration
|
|
*
|
|
* LICENSE: ZLIB
|
|
*
|
|
* Copyright (c) 2024 Jeffery Myers
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
* of this software and associated documentation files (the "Software"), to deal
|
|
* in the Software without restriction, including without limitation the rights
|
|
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
* copies of the Software, and to permit persons to whom the Software is
|
|
* furnished to do so, subject to the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be included in all
|
|
* copies or substantial portions of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
* SOFTWARE.
|
|
*
|
|
**********************************************************************************************/
|
|
|
|
#pragma once
|
|
|
|
#include "raylib.h"
|
|
|
|
// Function specifiers in case library is build/used as a shared library
|
|
// NOTE: Microsoft specifiers to tell compiler that symbols are imported/exported from a .dll
|
|
// NOTE: visibility("default") attribute makes symbols "visible" when compiled with -fvisibility=hidden
|
|
#if defined(_WIN32)
|
|
#if defined(__TINYC__)
|
|
#define __declspec(x) __attribute__((x))
|
|
#endif
|
|
#if defined(BUILD_LIBTYPE_SHARED)
|
|
#define RLIMGUIAPI __declspec(dllexport) // We are building the library as a Win32 shared library (.dll)
|
|
#elif defined(USE_LIBTYPE_SHARED)
|
|
#define RLIMGUIAPI __declspec(dllimport) // We are using the library as a Win32 shared library (.dll)
|
|
#endif
|
|
#else
|
|
#if defined(BUILD_LIBTYPE_SHARED)
|
|
#define RLIMGUIAPI __attribute__((visibility("default"))) // We are building as a Unix shared library (.so/.dylib)
|
|
#endif
|
|
#endif
|
|
|
|
#ifndef RLIMGUIAPI
|
|
#define RLIMGUIAPI // Functions defined as 'extern' by default (implicit specifiers)
|
|
#endif
|
|
|
|
#ifndef NO_FONT_AWESOME
|
|
#include "IconsFontAwesome6.h"
|
|
#ifndef FONT_AWESOME_ICON_SIZE
|
|
#define FONT_AWESOME_ICON_SIZE 11
|
|
#endif
|
|
#endif
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
// High level API. This API is designed in the style of raylib and meant to work with reaylib code.
|
|
// It will manage it's own ImGui context and call common ImGui functions (like NewFrame and Render) for you
|
|
// for a lower level API that matches the other ImGui platforms, please see imgui_impl_raylib.h
|
|
|
|
/// <summary>
|
|
/// Sets up ImGui, loads fonts and themes
|
|
/// Calls ImGui_ImplRaylib_Init and sets the theme. Will install Font awesome by default
|
|
/// </summary>
|
|
/// <param name="darkTheme">when true(default) the dark theme is used, when false the light theme is used</param>
|
|
RLIMGUIAPI void rlImGuiSetup(bool darkTheme);
|
|
|
|
/// <summary>
|
|
/// Starts a new ImGui Frame
|
|
/// Calls ImGui_ImplRaylib_NewFrame, ImGui_ImplRaylib_ProcessEvents, and ImGui::NewFrame together
|
|
/// </summary>
|
|
RLIMGUIAPI void rlImGuiBegin(void);
|
|
|
|
/// <summary>
|
|
/// Ends an ImGui frame and submits all ImGui drawing to raylib for processing.
|
|
/// Calls ImGui:Render, an d ImGui_ImplRaylib_RenderDrawData to draw to the current raylib render target
|
|
/// </summary>
|
|
RLIMGUIAPI void rlImGuiEnd(void);
|
|
|
|
/// <summary>
|
|
/// Cleanup ImGui and unload font atlas
|
|
/// Calls ImGui_ImplRaylib_Shutdown
|
|
/// </summary>
|
|
RLIMGUIAPI void rlImGuiShutdown(void);
|
|
|
|
// Advanced StartupAPI
|
|
|
|
/// <summary>
|
|
/// Custom initialization. Not needed if you call rlImGuiSetup. Only needed if you want to add custom setup code.
|
|
/// must be followed by rlImGuiEndInitImGui
|
|
/// Called by ImGui_ImplRaylib_Init, and does the first part of setup, before fonts are rendered
|
|
/// </summary>
|
|
RLIMGUIAPI void rlImGuiBeginInitImGui(void);
|
|
|
|
/// <summary>
|
|
/// End Custom initialization. Not needed if you call rlImGuiSetup. Only needed if you want to add custom setup code.
|
|
/// must be proceeded by rlImGuiBeginInitImGui
|
|
/// Called by ImGui_ImplRaylib_Init and does the second part of setup, and renders fonts.
|
|
/// </summary>
|
|
RLIMGUIAPI void rlImGuiEndInitImGui(void);
|
|
|
|
/// <summary>
|
|
/// Forces the font texture atlas to be recomputed and re-cached
|
|
/// </summary>
|
|
RLIMGUIAPI void rlImGuiReloadFonts(void);
|
|
|
|
// Advanced Update API
|
|
|
|
/// <summary>
|
|
/// Starts a new ImGui Frame with a specified delta time
|
|
/// </summary>
|
|
/// <param name="dt">delta time, any value < 0 will use raylib GetFrameTime</param>
|
|
RLIMGUIAPI void rlImGuiBeginDelta(float deltaTime);
|
|
|
|
// ImGui Image API extensions
|
|
// Purely for convenience in working with raylib textures as images.
|
|
// If you want to call ImGui image functions directly, simply pass them the pointer to the texture.
|
|
|
|
/// <summary>
|
|
/// Draw a texture as an image in an ImGui Context
|
|
/// Uses the current ImGui Cursor position and the full texture size.
|
|
/// </summary>
|
|
/// <param name="image">The raylib texture to draw</param>
|
|
RLIMGUIAPI void rlImGuiImage(const Texture *image);
|
|
|
|
/// <summary>
|
|
/// Draw a texture as an image in an ImGui Context at a specific size
|
|
/// Uses the current ImGui Cursor position and the specified width and height
|
|
/// The image will be scaled up or down to fit as needed
|
|
/// </summary>
|
|
/// <param name="image">The raylib texture to draw</param>
|
|
/// <param name="width">The width of the drawn image</param>
|
|
/// <param name="height">The height of the drawn image</param>
|
|
RLIMGUIAPI void rlImGuiImageSize(const Texture *image, int width, int height);
|
|
|
|
/// <summary>
|
|
/// Draw a texture as an image in an ImGui Context at a specific size
|
|
/// Uses the current ImGui Cursor position and the specified size
|
|
/// The image will be scaled up or down to fit as needed
|
|
/// </summary>
|
|
/// <param name="image">The raylib texture to draw</param>
|
|
/// <param name="size">The size of drawn image</param>
|
|
RLIMGUIAPI void rlImGuiImageSizeV(const Texture* image, Vector2 size);
|
|
|
|
/// <summary>
|
|
/// Draw a portion texture as an image in an ImGui Context at a defined size
|
|
/// Uses the current ImGui Cursor position and the specified size
|
|
/// The image will be scaled up or down to fit as needed
|
|
/// </summary>
|
|
/// <param name="image">The raylib texture to draw</param>
|
|
/// <param name="destWidth">The width of the drawn image</param>
|
|
/// <param name="destHeight">The height of the drawn image</param>
|
|
/// <param name="sourceRect">The portion of the texture to draw as an image. Negative values for the width and height will flip the image</param>
|
|
RLIMGUIAPI void rlImGuiImageRect(const Texture* image, int destWidth, int destHeight, Rectangle sourceRect);
|
|
|
|
/// <summary>
|
|
/// Draws a render texture as an image an ImGui Context, automatically flipping the Y axis so it will show correctly on screen
|
|
/// </summary>
|
|
/// <param name="image">The render texture to draw</param>
|
|
RLIMGUIAPI void rlImGuiImageRenderTexture(const RenderTexture* image);
|
|
|
|
/// <summary>
|
|
/// Draws a render texture as an image an ImGui Context, automatically flipping the Y axis so it will show correctly on screen
|
|
/// Fits the render texture to the available content area
|
|
/// </summary>
|
|
/// <param name="image">The render texture to draw</param>
|
|
/// <param name="center">When true the image will be centered in the content area</param>
|
|
RLIMGUIAPI void rlImGuiImageRenderTextureFit(const RenderTexture* image, bool center);
|
|
|
|
/// <summary>
|
|
/// Draws a texture as an image button in an ImGui context. Uses the current ImGui cursor position and the full size of the texture
|
|
/// </summary>
|
|
/// <param name="name">The display name and ImGui ID for the button</param>
|
|
/// <param name="image">The texture to draw</param>
|
|
/// <returns>True if the button was clicked</returns>
|
|
bool rlImGuiImageButton(const char* name, const Texture* image);
|
|
|
|
/// <summary>
|
|
/// Draws a texture as an image button in an ImGui context. Uses the current ImGui cursor position and the specified size.
|
|
/// </summary>
|
|
/// <param name="name">The display name and ImGui ID for the button</param>
|
|
/// <param name="image">The texture to draw</param>
|
|
/// <param name="size">The size of the button</param>
|
|
/// <returns>True if the button was clicked</returns>
|
|
RLIMGUIAPI bool rlImGuiImageButtonSize(const char* name, const Texture* image, struct ImVec2 size);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|