vczh-libraries / GacUI

GacUI GPU Accelerated C++ User Interface, with: • Cross-platform supports (Windows, Linux, macos, HTML5) • Native Renderers • Hosted Mode to render all windows in one native window (optional) • Core/Renderer cross-process separation (optional) • Built-in powerful text processing libraries • Built-in data binding and MVVM features • XML UI description embedding Workflow script language • Dynamic loading with C++ dynamic reflection opt-in • Allow loading foreign UI with complex behavior in runtime • Generate XML and Workflow to C++ source files for static linking (recommended) • Allow C++ dyanmic reflection opt-out to significantly improve performance and reduce binary size • FFI Integration with other programming languages (under development) • Toolkit for developing with coding agents License **Read the LICENSE first.** This project is licensed under the License repo. Source code in this repo is for reference only, please use the source code in the Release repo. You are welcome to contribute to this repo by opening pull requests. Document For **Home Page**: click here For **Gaclib**: click here For **GacUI**: click here gaclib.net is a mirror to github pages above. Content of This Project • The Tutorial shows how to start using this marvelous GUI library. • The Demos section shows you all demos using this GUI library. Notice Using this library requires you to use C++ source files directly in • The Release folder for Vlpp, Workflow or GacUI. • The GacGen.exe if you prefer to use XML to build your UI. All other files are for library development only. Content This GUI library provides the following features: • Develop your GUI using pure C++, Workflow script, XML or even JavaScript (under construction). • Cross-platform abilities. • for **Windows**: Release repo • for **Linux**: XGac repo (beta release) • for **macOS**: iGac repo (beta release) • for running in **Browser** using WASM: (2.0) • Rich control library. Container controls supports MVC and virtual list mode. • Control template system. You can write your own. • GPU acceleration. • XML resource supports. • You can use the provided GacGen.exe to generate multiple XML files with binary resources (images) into a compressed binary format. • This program will also generate C++ code behind for you. You can fill event handlers (but we suggest you use MVVM and Data Binding instead) in generated C++ files. • If you update your UI, GacGen.exe will merge your modification in C++ code and modification in XML together to generate new C++ code behind. Your update will still exist. • **NOTE**: You will see a very obvious mark in the generated code. Here is where you want to add your code. All your modification outside of these places will be discarded on the next GacGen.exe run. • MVVM and Data Binding. • You can define interfaces that required to build your own MVVM pattern in XML and GacGen.exe will generate the C++ interface declaration for you. • You can also use Workflow expressions in Data Binding and statements in event handlers (instead of writing C++ code in code behind). https://gankra.github.io/blah/text-hates-you/ https://lord.io/text-editing-hates-you-too/ Remote Protocol Support GacUI Remote Protocol enables Core and Renderer to run in different process in any programming language. It is current under development, but if you are interested in it, there are demos to try. All text box related controls are not supported yet, but they are on the way! NamedPipe and Http In **GacUISrc.sln** there are two projects: • RemotingTest_Core.vcxproj • RemotingTest_Rendering_Win32.vcxproj You must offer the same command line argument to and then to play with the demo. • starts a GacUI process but delegates all rendering work to a remote process. • starts a renderer-only process handles 's requests. • One of or should be offered to both projects so that they can connect to each other. HTML By running with , you can even run GacUI in a browser! Unit Test With the power from Remote Protocol, you could make GacUI running and writing down snapshots as a trace of all UI activities. Check out UnitTest.vcxproj! After running all test cases (actually don't need to do that as all snapshots are already checked in), check out UnitTestViewer.vcxproj! Unit test facility and the viewer are released to the Release repo in: • GacUI.UnitTest.(h|cpp) • GacUI.UnitTest.UI(h|cpp) • GacUI.UnitTest.UIReflection(h|cpp): only needed when you run GacUI.UnitTest.UI.cpp without compiler option.