Useful Tools
CLI Tool |
Layout Designer
Mainly testing on Windows and Ubuntu. Feel free to test on other platforms.
Check out this sample calculator app on CeruleanUI.
Should also work on OSX, but you need to install SDL2 and the other libraries to your frameworks folder.
Bundle your needed fonts in a folder called "Fonts" in the build directory as the font loader is jank with OSX.
Warning This section is heavily under-construction. Use a release build instead if available.
-
Download a release build here and extract the archive.
-
Add the
crn
executable to your binaries folder or add the containing folder to the%PATH%
environment variable. -
Create your new app via:
crn new <app_name>
-
Build the project.
crn build
This should automatically build the XMLs, the dotnet project, and bundle the needed dependencies.
Currently, the bundler only works on a Windows build target for now. Support for other operating systems will come in a later update.
See "Important Notes" below on how to bundle and install dependencies for other OSs.
-
Run the app via:
crn run
If you run into DllNotFound errors, try running
crn bundle
.
- .NET 6 is required for the CLI tool.
- .NET 6 or newer projects are compatible with CeruleanUI.
- By default, the CLI should use the latest .NET SDK and creates a project with the same version.
- Use the appropriate SDL2 binaries for your app/system.
- On Any CPU, use the binaries appropriate for your system's architecture.
- On x86, use x86.
- On x64, use x64.
- On Windows, use the runtime binaries available at libsdl.org.
- On Ubuntu, simply do:
sudo apt-get install libsdl2-dev sudo apt-get install libsdl2-ttf-dev sudo apt-get install libsdl2-image-dev
- NOTE: the snap version of
dotnet
will NOT find the SDL2 library. Please install dotnet with APT.- See installing dotnet on MSDN.
- Relevant issue: exelix11/SysDVR (#118).
- NOTE: the snap version of
- Fonts will be searched first in a folder called
Fonts
in the environment's current directory, and then the system's font directory.- The default font for the Label component is
Arial
(Subject to change). - The library will find the first font with a filename of
Arial.ttf
orArial.otf
, this is case-insensitive. - If not found, it will simply throw a
GeneralAPIException: "Font not found."
.
- The default font for the Label component is
- Window Events
- Styler Element
- Functional Components
- Timer
- Pointer
- Dialog Components
- Message Box
- Open File Dialog
- Save File Dialog
- Folder Select Dialog
- Graphical Components
- Rectangle
- Image
- Progress Bar
- Label
- Input Components
- TextBox
- MultiTextBox
- Button
- Check Box
- Radio Button
- Drop Down List
- Container Components
- Grid
- Panel
- Stack Panel
- Group Tab
- Style Builder
- C# Snippet Element
- Project Builder/Scaffolder
This is a WIP project, please do not use in commercial projects.
This project uses the MIT License. SDL2 and SDL2-CS, dependencies of this project, are released under the zlib license.