Init Repo

2026-06-03 09:00:11 +08:00
commit 9be48d8b9e
155 changed files with 14827 additions and 0 deletions
@@ -0,0 +1,2 @@
+schema: spec-driven
+created: 2026-05-08
@@ -0,0 +1,28 @@
+## Context
+
+The USD Layer Manager application uses ImGui for its user interface. Currently, ImGui uses its default font, which is functional but not optimized for modern UI aesthetics. The proposal outlines changing to the Inter font to improve readability and visual appeal.
+
+## Goals / Non-Goals
+
+**Goals:**
+- Load and apply the Inter font in ImGui initialization
+- Ensure consistent font usage across the application UI
+- Minimal performance impact on startup
+
+**Non-Goals:**
+- Implement font selection options for users
+- Support multiple font weights or styles beyond regular
+- Modify font rendering beyond basic loading
+
+## Decisions
+
+- **Font Choice**: Use Inter Regular (Inter-Regular.ttf) as it provides excellent readability for UI text. Considered alternatives like Roboto, but Inter is specifically designed for interfaces and is more modern.
+- **Loading Location**: Load the font in the main application initialization, likely in src/main.cpp where ImGui context is set up, to ensure it's available before any UI rendering.
+- **Font Size**: Maintain default ImGui font size (13pt) to avoid layout changes.
+- **Fallback**: If Inter font fails to load, fall back to default font to prevent application failure.
+
+## Risks / Trade-offs
+
+- **Font File Dependency**: Requires Inter-Regular.ttf to be included in project assets. Risk of missing file → Mitigation: Add to version control and build process checks.
+- **Startup Performance**: Loading a custom font may add slight delay to initialization. Risk: Negligible impact expected, as font loading is typically fast.
+- **Cross-Platform Compatibility**: Font rendering may vary slightly on different platforms. Risk: Test on target platforms (Windows primarily).
@@ -0,0 +1,23 @@
+## Why
+
+The current ImGui interface uses the default font, which may not provide the best readability and modern aesthetics. Changing to Inter, a popular and highly readable typeface designed for user interfaces, will improve the overall user experience and visual appeal of the USD Layer Manager application.
+
+## What Changes
+
+- Update ImGui font initialization to load and use the Inter font face instead of the default font.
+- Add Inter font file to the project resources.
+- Ensure the font is properly loaded at application startup.
+
+## Capabilities
+
+### New Capabilities
+- `inter-font-setup`: Configure ImGui to use the Inter font for improved UI readability and aesthetics.
+
+### Modified Capabilities
+<!-- No existing capabilities are being modified -->
+
+## Impact
+
+- UI rendering system will use Inter font, affecting all text display in the application.
+- Requires adding Inter font file to project assets.
+- No breaking changes to APIs or existing functionality.
@@ -0,0 +1,23 @@
+## ADDED Requirements
+
+### Requirement: Load Inter Font
+The system SHALL load the Inter-Regular.ttf font file from the project assets during application initialization.
+
+#### Scenario: Font file exists
+- **WHEN** the application starts up and Inter-Regular.ttf is present in the assets
+- **THEN** the font SHALL be loaded successfully into ImGui
+
+#### Scenario: Font file missing
+- **WHEN** the application starts up and Inter-Regular.ttf is not found
+- **THEN** the system SHALL fall back to the default ImGui font and log a warning
+
+### Requirement: Apply Inter Font as Default
+The system SHALL set the loaded Inter font as the default font for all ImGui text rendering.
+
+#### Scenario: Font loaded successfully
+- **WHEN** the Inter font is loaded successfully
+- **THEN** all UI text SHALL render using the Inter font face
+
+#### Scenario: Font loading fails
+- **WHEN** the Inter font fails to load
+- **THEN** the system SHALL continue with the default ImGui font
@@ -0,0 +1,13 @@
+## 1. Asset Preparation
+
+- [x] 1.1 Download Inter-Regular.ttf and add to project assets directory
+
+## 2. Code Implementation
+
+- [x] 2.1 Modify src/main.cpp to load Inter font during ImGui initialization
+- [x] 2.2 Implement fallback to default font if Inter loading fails
+
+## 3. Verification
+
+- [x] 3.1 Build the application and verify Inter font is displayed
+- [x] 3.2 Test font loading error handling by temporarily removing font file