Modern welcome screen with project grid and quick actions. More...
#include <welcome_screen.h>

Classes | |
| struct | Particle |
Public Member Functions | |
| WelcomeScreen () | |
| bool | Show (bool *p_open) |
| Show the welcome screen. | |
| void | SetOpenRomCallback (std::function< void()> callback) |
| Set callback for opening ROM. | |
| void | SetNewProjectCallback (std::function< void()> callback) |
| Set callback for creating new project. | |
| void | SetNewProjectWithTemplateCallback (std::function< void(const std::string &)> callback) |
| Set callback for creating project with template. | |
| void | SetOpenProjectCallback (std::function< void(const std::string &)> callback) |
| Set callback for opening project. | |
| void | SetOpenAgentCallback (std::function< void()> callback) |
| Set callback for opening AI Agent. | |
| void | SetOpenPrototypeResearchCallback (std::function< void()> callback) |
| Open the graphics editor focused on prototype research (no ROM). | |
| void | SetOpenAssemblyEditorNoRomCallback (std::function< void()> callback) |
| Open the assembly editor for file/folder work (no ROM required). | |
| void | SetOpenProjectDialogCallback (std::function< void()> callback) |
| Set callback for opening the project file dialog. | |
| void | SetOpenProjectManagementCallback (std::function< void()> callback) |
| Set callback for showing project management. | |
| void | SetOpenProjectFileEditorCallback (std::function< void()> callback) |
| Set callback for showing the project file editor. | |
| void | RefreshRecentProjects (bool force=false) |
| Refresh recent projects list from the project manager. | |
| void | UpdateAnimations () |
| Update animation time for dynamic effects. | |
| bool | ShouldShow () const |
| Check if screen should be shown. | |
| void | MarkManuallyClosed () |
| Mark as manually closed (don't show again this session) | |
| void | SetLayoutOffsets (float left, float right) |
| Set layout offsets for sidebar awareness. | |
| void | SetContextState (bool has_rom, bool has_project) |
| Set context state for gating actions. | |
| void | SetUserSettings (UserSettings *settings) |
| Wire persisted user settings so animation tweaks survive restart. | |
| RecentProjectsModel & | recent_projects () |
| Accessor used by command-palette wiring so the same recent list drives both the visual cards and the palette's per-entry actions. | |
| const RecentProjectsModel & | recent_projects () const |
Private Types | |
| enum class | RecentAnnotationKind { None , Rename , EditNotes } |
Private Member Functions | |
| void | DrawHeader () |
| void | DrawQuickActions () |
| void | DrawRecentProjects () |
| void | DrawProjectPanel (const RecentProject &project, int index, const ImVec2 &card_size) |
| void | DrawTemplatesSection () |
| void | DrawTipsSection () |
| void | DrawWhatsNew () |
| void | DrawFirstRunGuide () |
| void | DrawRecentAnnotationPopup () |
| void | DrawUndoRemovalBanner () |
| void | PersistAnimationSettings () |
Static Private Attributes | |
| static constexpr float | kEntryAnimDuration = 0.4f |
| static constexpr float | kEntryStaggerDelay = 0.08f |
| static constexpr int | kNumTriforces = 6 |
| static constexpr int | kMaxParticles = 50 |
Modern welcome screen with project grid and quick actions.
Definition at line 20 of file welcome_screen.h.
|
strongprivate |
| Enumerator | |
|---|---|
| None | |
| Rename | |
| EditNotes | |
Definition at line 247 of file welcome_screen.h.
| yaze::editor::WelcomeScreen::WelcomeScreen | ( | ) |
Definition at line 270 of file welcome_screen.cc.
References RefreshRecentProjects().

| bool yaze::editor::WelcomeScreen::Show | ( | bool * | p_open | ) |
Show the welcome screen.
| p_open | Pointer to open state |
Definition at line 316 of file welcome_screen.cc.
References active_particle_count_, yaze::editor::WelcomeScreen::Particle::alpha, animation_time_, DrawFirstRunGuide(), DrawHeader(), DrawQuickActions(), DrawRecentProjects(), DrawTipsSection(), DrawWhatsNew(), entry_animations_started_, entry_time_, yaze::TimingManager::Get(), yaze::TimingManager::GetDeltaTime(), kMaxParticles, kNumTriforces, left_offset_, yaze::editor::WelcomeScreen::Particle::lifetime, M_PI, yaze::editor::WelcomeScreen::Particle::max_lifetime, particle_spawn_accumulator_, particle_spawn_rate_, particles_, particles_enabled_, yaze::editor::WelcomeScreen::Particle::position, right_offset_, yaze::editor::WelcomeScreen::Particle::size, triforce_alpha_multiplier_, triforce_base_positions_, triforce_mouse_repel_enabled_, triforce_positions_, triforce_positions_initialized_, triforce_size_multiplier_, triforce_speed_multiplier_, UpdateAnimations(), and yaze::editor::WelcomeScreen::Particle::velocity.
|
inline |
Set callback for opening ROM.
Definition at line 34 of file welcome_screen.h.
References open_rom_callback_.
Referenced by yaze::editor::EditorManager::SetupWelcomeScreenCallbacks().
|
inline |
Set callback for creating new project.
Definition at line 41 of file welcome_screen.h.
References new_project_callback_.
Referenced by yaze::editor::EditorManager::SetupWelcomeScreenCallbacks().
|
inline |
Set callback for creating project with template.
Definition at line 48 of file welcome_screen.h.
References new_project_with_template_callback_.
Referenced by yaze::editor::EditorManager::SetupWelcomeScreenCallbacks().
|
inline |
Set callback for opening project.
Definition at line 56 of file welcome_screen.h.
References open_project_callback_.
Referenced by yaze::editor::EditorManager::SetupWelcomeScreenCallbacks().
|
inline |
Set callback for opening AI Agent.
Definition at line 64 of file welcome_screen.h.
References open_agent_callback_.
Referenced by yaze::editor::EditorManager::SetupWelcomeScreenCallbacks().
|
inline |
Open the graphics editor focused on prototype research (no ROM).
Definition at line 71 of file welcome_screen.h.
References open_prototype_research_callback_.
Referenced by yaze::editor::EditorManager::SetupWelcomeScreenCallbacks().
|
inline |
Open the assembly editor for file/folder work (no ROM required).
Definition at line 78 of file welcome_screen.h.
References open_assembly_editor_no_rom_callback_.
Referenced by yaze::editor::EditorManager::SetupWelcomeScreenCallbacks().
|
inline |
Set callback for opening the project file dialog.
Definition at line 85 of file welcome_screen.h.
References open_project_dialog_callback_.
Referenced by yaze::editor::EditorManager::SetupWelcomeScreenCallbacks().
|
inline |
Set callback for showing project management.
Definition at line 92 of file welcome_screen.h.
References open_project_management_callback_.
Referenced by yaze::editor::EditorManager::SetupWelcomeScreenCallbacks().
|
inline |
Set callback for showing the project file editor.
Definition at line 99 of file welcome_screen.h.
References open_project_file_editor_callback_.
Referenced by yaze::editor::EditorManager::SetupWelcomeScreenCallbacks().
| void yaze::editor::WelcomeScreen::RefreshRecentProjects | ( | bool | force = false | ) |
Refresh recent projects list from the project manager.
Cheap on the no-op path: compares the RecentFilesManager generation counter against a cached value and short-circuits when unchanged. Pass force=true to bypass the cache (e.g. on manual "Refresh").
Definition at line 680 of file welcome_screen.cc.
References recent_projects_model_, and yaze::editor::RecentProjectsModel::Refresh().
Referenced by WelcomeScreen().

| void yaze::editor::WelcomeScreen::UpdateAnimations | ( | ) |
Update animation time for dynamic effects.
Definition at line 666 of file welcome_screen.cc.
References animation_time_, card_hover_scale_, and hovered_card_.
Referenced by Show().
|
inline |
Check if screen should be shown.
Definition at line 120 of file welcome_screen.h.
References manually_closed_.
|
inline |
Mark as manually closed (don't show again this session)
Definition at line 125 of file welcome_screen.h.
References manually_closed_.
|
inline |
Set layout offsets for sidebar awareness.
| left | Left sidebar width (0 if hidden) |
| right | Right panel width (0 if hidden) |
Definition at line 132 of file welcome_screen.h.
References left_offset_, and right_offset_.
|
inline |
Set context state for gating actions.
Definition at line 140 of file welcome_screen.h.
References has_project_, and has_rom_.
| void yaze::editor::WelcomeScreen::SetUserSettings | ( | UserSettings * | settings | ) |
Wire persisted user settings so animation tweaks survive restart.
Call once after construction (from UICoordinator). Animation sliders then load initial values from the preferences and write back + trigger Save() whenever the user adjusts them.
Definition at line 274 of file welcome_screen.cc.
References particles_enabled_, yaze::editor::UserSettings::prefs(), triforce_alpha_multiplier_, triforce_mouse_repel_enabled_, triforce_size_multiplier_, triforce_speed_multiplier_, user_settings_, and yaze::editor::UserSettings::Preferences::welcome_triforce_alpha.

|
inline |
Accessor used by command-palette wiring so the same recent list drives both the visual cards and the palette's per-entry actions.
Definition at line 158 of file welcome_screen.h.
References recent_projects_model_.
|
inline |
Definition at line 159 of file welcome_screen.h.
References recent_projects_model_.
|
private |
Definition at line 684 of file welcome_screen.cc.
References entry_time_, yaze::editor::GetStaggeredEntryProgress(), yaze::gui::GetTextDisabledVec4(), yaze::gui::GetTextSecondaryVec4(), ICON_MD_CASTLE, kEntryAnimDuration, kEntryStaggerDelay, and YAZE_VERSION_STRING.
Referenced by Show().

|
private |
Definition at line 832 of file welcome_screen.cc.
References yaze::editor::RecentProjectsModel::entries(), entry_time_, yaze::editor::RecentProject::filepath, yaze::editor::GetStaggeredEntryProgress(), yaze::gui::GetTextSecondaryVec4(), ICON_MD_BOLT, ICON_MD_CODE, ICON_MD_CONSTRUCTION, ICON_MD_FOLDER_OPEN, ICON_MD_INFO, ICON_MD_PLAY_ARROW, yaze::editor::RecentProject::item_type, kEntryAnimDuration, kEntryStaggerDelay, yaze::editor::RecentProject::name, open_assembly_editor_no_rom_callback_, open_project_callback_, open_prototype_research_callback_, open_rom_callback_, and recent_projects_model_.
Referenced by Show().

|
private |
Definition at line 1015 of file welcome_screen.cc.
References yaze::editor::GetStaggeredEntryProgress(), yaze::gui::GetTextSecondaryVec4(), ICON_MD_DELETE_SWEEP, ICON_MD_EXPLORE, ICON_MD_FOLDER_SPECIAL, and ICON_MD_HISTORY.
Referenced by Show().

|
private |
Definition at line 1271 of file welcome_screen.cc.
References yaze::gui::ColoredText(), yaze::gui::ColoredTextF(), yaze::editor::RecentProject::display_name_override, yaze::editor::RecentProject::filepath, yaze::gui::GetOnSurfaceVec4(), yaze::gui::GetSurfaceVariantVec4(), yaze::gui::GetSurfaceVec4(), yaze::gui::GetTextDisabledVec4(), yaze::gui::GetTextSecondaryVec4(), ICON_MD_CONTENT_COPY, ICON_MD_DELETE_SWEEP, ICON_MD_EDIT, ICON_MD_INFO, ICON_MD_INSERT_DRIVE_FILE, ICON_MD_NOTE, ICON_MD_OPEN_IN_NEW, ICON_MD_PUSH_PIN, ICON_MD_SEARCH, ICON_MD_TOUCH_APP, yaze::editor::RecentProject::is_missing, yaze::editor::RecentProject::item_icon, yaze::editor::RecentProject::item_type, yaze::editor::RecentProject::last_modified, yaze::editor::RecentProject::metadata_summary, yaze::editor::RecentProject::name, yaze::editor::RecentProject::notes, yaze::editor::RecentProject::pinned, yaze::editor::RecentProject::rom_title, yaze::util::FileDialogWrapper::ShowOpenFileDialog(), and yaze::editor::RecentProject::unavailable.
|
private |
Definition at line 1496 of file welcome_screen.cc.
References yaze::editor::GetStaggeredEntryProgress(), yaze::gui::GetTextSecondaryVec4(), ICON_MD_AUTO_AWESOME, ICON_MD_AUTO_FIX_HIGH, ICON_MD_CHECK_CIRCLE, ICON_MD_CLOSE, ICON_MD_COTTAGE, ICON_MD_EDIT, ICON_MD_INFO, ICON_MD_LAYERS, ICON_MD_LIGHTBULB, ICON_MD_MAP, ICON_MD_MOUSE, ICON_MD_OPACITY, ICON_MD_REFRESH, ICON_MD_ROCKET_LAUNCH, ICON_MD_SHUFFLE, ICON_MD_SPEED, ICON_MD_STAR, ICON_MD_TERRAIN, and ICON_MD_TUNE.

|
private |
Definition at line 1791 of file welcome_screen.cc.
References yaze::editor::GetStaggeredEntryProgress(), ICON_MD_CLOSE, and ICON_MD_LIGHTBULB.
Referenced by Show().

|
private |
Definition at line 1831 of file welcome_screen.cc.
References yaze::editor::GetStaggeredEntryProgress(), yaze::gui::GetTextSecondaryVec4(), ICON_MD_ACCOUNT_TREE, ICON_MD_API, ICON_MD_ARCHIVE, ICON_MD_AUTO_AWESOME, ICON_MD_BUG_REPORT, ICON_MD_BUILD, ICON_MD_CASTLE, ICON_MD_COLOR_LENS, ICON_MD_DASHBOARD, ICON_MD_FACT_CHECK, ICON_MD_GRID_VIEW, ICON_MD_HISTORY, ICON_MD_MEMORY, ICON_MD_NEW_RELEASES, ICON_MD_OPEN_IN_NEW, ICON_MD_PALETTE, ICON_MD_PUBLIC, ICON_MD_ROCKET_LAUNCH, ICON_MD_RULE, ICON_MD_SEARCH, ICON_MD_SHIELD, ICON_MD_SYNC, ICON_MD_TABLET, ICON_MD_TERMINAL, ICON_MD_TRAM, ICON_MD_TUNE, ICON_MD_UNDO, ICON_MD_VERIFIED, ICON_MD_VISIBILITY, and YAZE_VERSION_STRING.
Referenced by Show().

|
private |
Definition at line 771 of file welcome_screen.cc.
References yaze::editor::RecentProjectsModel::entries(), entry_time_, yaze::editor::GetStaggeredEntryProgress(), yaze::gui::GetTextSecondaryVec4(), has_rom_, ICON_MD_AUTO_AWESOME, ICON_MD_EDIT, ICON_MD_LAYERS, ICON_MD_MEMORY, kEntryAnimDuration, kEntryStaggerDelay, and recent_projects_model_.
Referenced by Show().

|
private |
Definition at line 1140 of file welcome_screen.cc.
References yaze::gui::GetTextSecondaryVec4(), ICON_MD_CHECK, ICON_MD_CLOSE, ICON_MD_EDIT, and ICON_MD_NOTE.

|
private |
Definition at line 1217 of file welcome_screen.cc.
References yaze::gui::ConvertColorToImVec4(), yaze::gui::ThemeManager::Get(), ICON_MD_CLOSE, ICON_MD_INFO, and ICON_MD_UNDO.

|
private |
Definition at line 286 of file welcome_screen.cc.
References LOG_WARN, particles_enabled_, yaze::editor::UserSettings::prefs(), yaze::editor::UserSettings::Save(), triforce_alpha_multiplier_, triforce_mouse_repel_enabled_, triforce_size_multiplier_, triforce_speed_multiplier_, user_settings_, and yaze::editor::UserSettings::Preferences::welcome_triforce_alpha.

|
private |
Definition at line 176 of file welcome_screen.h.
Referenced by DrawFirstRunGuide(), DrawQuickActions(), recent_projects(), recent_projects(), and RefreshRecentProjects().
|
private |
Definition at line 177 of file welcome_screen.h.
Referenced by MarkManuallyClosed(), and ShouldShow().
|
private |
Definition at line 180 of file welcome_screen.h.
Referenced by DrawQuickActions(), and SetOpenRomCallback().
|
private |
Definition at line 181 of file welcome_screen.h.
Referenced by SetNewProjectCallback().
|
private |
Definition at line 182 of file welcome_screen.h.
Referenced by DrawQuickActions(), and SetOpenProjectCallback().
|
private |
Definition at line 183 of file welcome_screen.h.
Referenced by SetNewProjectWithTemplateCallback().
|
private |
Definition at line 184 of file welcome_screen.h.
Referenced by SetOpenAgentCallback().
|
private |
Definition at line 185 of file welcome_screen.h.
Referenced by DrawQuickActions(), and SetOpenPrototypeResearchCallback().
|
private |
Definition at line 186 of file welcome_screen.h.
Referenced by DrawQuickActions(), and SetOpenAssemblyEditorNoRomCallback().
|
private |
Definition at line 187 of file welcome_screen.h.
Referenced by SetOpenProjectDialogCallback().
|
private |
Definition at line 188 of file welcome_screen.h.
Referenced by SetOpenProjectManagementCallback().
|
private |
Definition at line 189 of file welcome_screen.h.
Referenced by SetOpenProjectFileEditorCallback().
|
private |
Definition at line 192 of file welcome_screen.h.
|
private |
Definition at line 195 of file welcome_screen.h.
Referenced by Show(), and UpdateAnimations().
|
private |
Definition at line 196 of file welcome_screen.h.
Referenced by UpdateAnimations().
|
private |
Definition at line 197 of file welcome_screen.h.
Referenced by UpdateAnimations().
|
private |
Definition at line 200 of file welcome_screen.h.
Referenced by Show().
|
private |
Definition at line 201 of file welcome_screen.h.
Referenced by DrawFirstRunGuide(), DrawHeader(), DrawQuickActions(), and Show().
|
staticconstexprprivate |
Definition at line 202 of file welcome_screen.h.
Referenced by DrawFirstRunGuide(), DrawHeader(), and DrawQuickActions().
|
staticconstexprprivate |
Definition at line 203 of file welcome_screen.h.
Referenced by DrawFirstRunGuide(), DrawHeader(), and DrawQuickActions().
|
staticconstexprprivate |
Definition at line 206 of file welcome_screen.h.
Referenced by Show().
|
private |
Definition at line 207 of file welcome_screen.h.
Referenced by Show().
|
private |
Definition at line 208 of file welcome_screen.h.
Referenced by Show().
|
private |
Definition at line 209 of file welcome_screen.h.
Referenced by Show().
|
staticconstexprprivate |
Definition at line 212 of file welcome_screen.h.
Referenced by Show().
|
private |
Definition at line 221 of file welcome_screen.h.
Referenced by Show().
|
private |
Definition at line 222 of file welcome_screen.h.
Referenced by Show().
|
private |
Definition at line 226 of file welcome_screen.h.
Referenced by Show().
|
private |
Definition at line 229 of file welcome_screen.h.
|
private |
Definition at line 230 of file welcome_screen.h.
Referenced by PersistAnimationSettings(), SetUserSettings(), and Show().
|
private |
Definition at line 231 of file welcome_screen.h.
Referenced by PersistAnimationSettings(), SetUserSettings(), and Show().
|
private |
Definition at line 232 of file welcome_screen.h.
Referenced by PersistAnimationSettings(), SetUserSettings(), and Show().
|
private |
Definition at line 233 of file welcome_screen.h.
Referenced by PersistAnimationSettings(), SetUserSettings(), and Show().
|
private |
Definition at line 234 of file welcome_screen.h.
Referenced by PersistAnimationSettings(), SetUserSettings(), and Show().
|
private |
Definition at line 235 of file welcome_screen.h.
Referenced by Show().
|
private |
Definition at line 238 of file welcome_screen.h.
Referenced by SetLayoutOffsets(), and Show().
|
private |
Definition at line 239 of file welcome_screen.h.
Referenced by SetLayoutOffsets(), and Show().
|
private |
Definition at line 242 of file welcome_screen.h.
Referenced by DrawFirstRunGuide(), and SetContextState().
|
private |
Definition at line 243 of file welcome_screen.h.
Referenced by SetContextState().
|
private |
Definition at line 248 of file welcome_screen.h.
|
private |
Definition at line 249 of file welcome_screen.h.
|
private |
Definition at line 250 of file welcome_screen.h.
|
private |
Definition at line 251 of file welcome_screen.h.
|
private |
Definition at line 255 of file welcome_screen.h.
Referenced by PersistAnimationSettings(), and SetUserSettings().