Heaps/HashLink native binding for Dear ImGui
First, make sure that HashLink, CMake and a C/C++ compiler are installed on your system.
Then the native extension needs to be built with these commands:
cd extension
mkdir build
cd build
cmake ..
cmake --build .
It builds a the target hdll file, and copy it to the root of the project.
Another method is to build it inside Visual Studio Code with CMake Tools extension installed, so you don't have to deal with the command line.
To add this library to your project, you need to include these files:
- The previously compiled
hlimgui.hdllfile. imgui/ImGuiDrawable.hx: this class derives from the standard HeapsDrawableclass and contains/displays all ImGui widgets.imgui/ImGui.hx: interface to the native extension.
See Main.hx to see how to implement this library.
Most of the ImGui functionalities are supported and binded. Look at https://github.com/ocornut/imgui to get documentation on exposed functions AND how ImGui works.
Here is a list of unsupported features and changes:
- Custom fonts aren't implemented.
- As Haxe doesn't support function overloading, so if two original functions have the same name, the second one in Haxe has a suffix
2to disguish it. For example:
public static function treeNode(label : String) : Bool {return false;}
public static function treeNode2(str_id : String, label : String) : Bool {return false;}-
ImGui has several functions which take a variable number of parameters in order to format strings. This feature isn't supported in Haxe, so all string formatting must be done in Haxe before passing it to ImGui.
-
InputTextfunction takes a byte buffer as parameter. This needs to be converted to a string like this example:
var input_text_buffer = new hl.Bytes(128);
if (ImGui.inputText('Text', input_text_buffer, 128)) {
var st = @:privateAccess String.fromUTF8(input_text_buffer);
trace(st);
}-
The function
setIniFilenamedoesn't exist in ImGui, it has been added to modify the filename of the default ini file saved by ImGui (pass null to turn off this feature). -
Due to type conversions between Haxe and ImGui, editing the object returned from
getStyledoes not immediately update the default styles. ThesetStylemethod has been added to provide that functionality. For example:
var style:ImGuiStyle = ImGui.getStyle();
style.WindowBorderSize = 0;
style.WindowRounding = 0;
ImGui.setStyle(style);If you find bugs, please report them on the GitHub project page. Most of the binded functions have been tested, but as it's a new library some bugs might remain.
I would like to thanks Aidan63 for their Haxe/cpp binding. I have borrowed all the structure declaration code which remains the same between the two bindings.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent