Showcase

The editor-style app in the README screenshot. It uses most of the library.

• It is a test bed for features, not a tidy example.
• To learn one part of the library, read the small examples instead.

Source: examples/showcase.

Running it

Run it from any folder, or double-click it:

bin\Debug\showcase.exe                  rem Windows
bin/Debug/showcase                      # Linux and macOS

• Unlike the small examples, it needs files on disk. They live in workdirectory/:
  • themes/showcase.css, its own style file
  • its icons
  • the optional Noto fallback fonts, for other scripts, emoji and symbols
• It finds them through its resource root, the folder TachyonUI loads files from:
  • SetResourceRoot sets it, before Initialize
  • TACHYON_RESOURCE_DIR is the folder with these files, defined by the build

// Its own style file, icons, fallback fonts and saved state live in workdirectory/,
// so it runs from any folder.
application->SetResourceRoot(TACHYON_RESOURCE_DIR);

Command-line options:

Option	Effect
--ui-scale <factor>	Zooms the UI on top of the OS display scale, e.g. 1.5.
--theme <palette>	Starting palette, e.g. themes/light.css.
--panel <title>	Brings that panel to the front of its tab group. Repeatable.
--float <title>	Starts that panel in its own window. Repeatable.
--files <folder>	Folder the Files panel shows instead of the workdirectory. Read only.

• The window and dock layout are saved to workdirectory/ui_state.json on quit.
• They are restored on the next start, with RestoreUIState.

// After Run returns: write the saved UI state into the resource root.
const std::filesystem::path stateFile = std::filesystem::path(application->GetResourceRoot()) / "ui_state.json";
if (std::ofstream file(stateFile, std::ios::binary); file)
    file << application->SaveUIState();

Where to look

File	Shows
application.h, application.cpp	Setup: style files, icons, commands and shortcuts, dock layout, toolbars, saved UI state.
panel_hierarchy.cpp	Scene tree of tree cells in a virtual table.
panel_inspector.cpp	Inspector: fields, menus, context menus.
panel_files.cpp	File browser over a copy of the workdirectory (or --files <folder>): folder tree, file grid with OS icons, renaming, drag and drop. Changes stay in memory.
panel_console.cpp	Log in a virtual table, with level filters.
panel_node_view.cpp	Node graph editor with undo.
panel_table.cpp, panel_split_scroll.cpp, panel_tree_table.cpp	Tables: sizing, a 50,000-row virtual table, frozen columns, tree rows.
panel_profiler_tree.cpp	Profiler frame tree with custom-drawn bars.
panel_settings.cpp	Settings panel, including shortcuts.
panel_reorderable.cpp	Lists, tabs and wrapped groups reorderable by dragging.
panel_view.cpp	Viewport with docked toolbars.
panel_misc.cpp, panel_box_test.cpp	Custom drawing, images, icon placement, box layout.

workdirectory/themes/showcase.css loads after styles.css, as in Custom theme:

const std::string_view styleFiles[] = { "styles.css", "showcase.css" };
SetStyleFiles(styleFiles);

---

Previous: Host device | Examples