Canvas: Add IMGUIEX_CANVAS_API to support building canvas as a shared library (#189)

Author: thedmd

docs/CHANGELOG.txt

@@ -4,6 +4,8 @@ v0.9.2 (WIP):
 
     NEW: Editor: Add IMGUI_NODE_EDITOR_API to support building editor as a shared library (#189)
 
+    NEW: Canvas: Add IMGUIEX_CANVAS_API to support building canvas as a shared library (#189)
+
     CHANGE: Editor: Support ImGui r18836 after SetItemUsingMouseWheel removal (#218), thanks @ocornut
 
     CHANGE: Editor: Define IMGUI_DEFINE_MATH_OPERATORS before <imgui.h> (#209), thanks @ocornut

imgui_canvas.h

@@ -51,6 +51,10 @@
 # include <imgui.h>
 # include <imgui_internal.h> // ImRect, ImFloor
 
+#ifndef IMGUIEX_CANVAS_API
+#define IMGUIEX_CANVAS_API
+#endif
+
 namespace ImGuiEx {
 
 struct CanvasView
@@ -106,64 +110,64 @@ struct Canvas
     //
     // You can query size of the canvas while it is being drawn
     // by calling Rect().
-    bool Begin(const char* id, const ImVec2& size);
-    bool Begin(ImGuiID id, const ImVec2& size);
+    IMGUIEX_CANVAS_API bool Begin(const char* id, const ImVec2& size);
+    IMGUIEX_CANVAS_API bool Begin(ImGuiID id, const ImVec2& size);
 
     // Ends interaction with canvas plane.
     //
     // Must be called only when Begin() retuned true.
-    void End();
+    IMGUIEX_CANVAS_API void End();
 
     // Sets visible region of canvas plane.
     //
     // Origin is an offset of infinite plane origin from top left
     // corner of the canvas.
     //
     // Scale greater than 1 make canvas content be bigger, less than 1 smaller.
-    void SetView(const ImVec2& origin, float scale);
-    void SetView(const CanvasView& view);
+    IMGUIEX_CANVAS_API void SetView(const ImVec2& origin, float scale);
+    IMGUIEX_CANVAS_API void SetView(const CanvasView& view);
 
     // Centers view over specific point on canvas plane.
     //
     // View will be centered on specific point by changing origin
     // but not scale.
-    void CenterView(const ImVec2& canvasPoint);
+    IMGUIEX_CANVAS_API void CenterView(const ImVec2& canvasPoint);
 
     // Calculates view over specific point on canvas plane.
-    CanvasView CalcCenterView(const ImVec2& canvasPoint) const;
+    IMGUIEX_CANVAS_API CanvasView CalcCenterView(const ImVec2& canvasPoint) const;
 
     // Centers view over specific rectangle on canvas plane.
     //
     // Whole rectangle will fit in canvas view. This will affect both
     // origin and scale.
-    void CenterView(const ImRect& canvasRect);
+    IMGUIEX_CANVAS_API void CenterView(const ImRect& canvasRect);
 
     // Calculates view over specific rectangle on canvas plane.
-    CanvasView CalcCenterView(const ImRect& canvasRect) const;
+    IMGUIEX_CANVAS_API CanvasView CalcCenterView(const ImRect& canvasRect) const;
 
     // Suspends canvas by returning to normal ImGui transformation space.
     // While suspended UI will not be drawn on canvas plane.
     //
     // Calls to Suspend()/Resume() are symetrical. Each call to Suspend()
     // must be matched with call to Resume().
-    void Suspend();
-    void Resume();
+    IMGUIEX_CANVAS_API void Suspend();
+    IMGUIEX_CANVAS_API void Resume();
 
     // Transforms point from canvas plane to ImGui.
-    ImVec2 FromLocal(const ImVec2& point) const;
-    ImVec2 FromLocal(const ImVec2& point, const CanvasView& view) const;
+    IMGUIEX_CANVAS_API ImVec2 FromLocal(const ImVec2& point) const;
+    IMGUIEX_CANVAS_API ImVec2 FromLocal(const ImVec2& point, const CanvasView& view) const;
 
     // Transforms vector from canvas plant to ImGui.
-    ImVec2 FromLocalV(const ImVec2& vector) const;
-    ImVec2 FromLocalV(const ImVec2& vector, const CanvasView& view) const;
+    IMGUIEX_CANVAS_API ImVec2 FromLocalV(const ImVec2& vector) const;
+    IMGUIEX_CANVAS_API ImVec2 FromLocalV(const ImVec2& vector, const CanvasView& view) const;
 
     // Transforms point from ImGui to canvas plane.
-    ImVec2 ToLocal(const ImVec2& point) const;
-    ImVec2 ToLocal(const ImVec2& point, const CanvasView& view) const;
+    IMGUIEX_CANVAS_API ImVec2 ToLocal(const ImVec2& point) const;
+    IMGUIEX_CANVAS_API ImVec2 ToLocal(const ImVec2& point, const CanvasView& view) const;
 
     // Transforms vector from ImGui to canvas plane.
-    ImVec2 ToLocalV(const ImVec2& vector) const;
-    ImVec2 ToLocalV(const ImVec2& vector, const CanvasView& view) const;
+    IMGUIEX_CANVAS_API ImVec2 ToLocalV(const ImVec2& vector) const;
+    IMGUIEX_CANVAS_API ImVec2 ToLocalV(const ImVec2& vector, const CanvasView& view) const;
 
     // Returns widget bounds.
     //
@@ -175,7 +179,7 @@ struct Canvas
     const ImRect& ViewRect() const { return m_ViewRect; }
 
     // Calculates visible region for view.
-    ImRect CalcViewRect(const CanvasView& view) const;
+    IMGUIEX_CANVAS_API ImRect CalcViewRect(const CanvasView& view) const;
 
     // Returns current view.
     const CanvasView& View() const { return m_View; }