How fragglet/wadgadget works
Main System Components
a. User Interface Layer
• Ncurses-based TUI components (src/ui/)
• Browser, pager, and dialog subsystems
• Two-pane interface design
b. Core Processing Layer
• File System Handler (src/fs/)
• Conversion Utilities (src/conv/)
• Texture Management (src/textures/)
• Palette Management (src/palette/)
c. File Format Support
• WAD file handling
• Import/Export capabilities
• File system integration
Component Relationships
[User Input] → [UI Layer] → [Core Processing] → [File System]
• ↑ ↑ ↓
• ┴───────[Data Flow]─┘
Specific Implementation Details
a. UI Components (src/ui/):
• Actions Bar
• Pane
• Text Input
• Title Bar
• Dialog System
• Stack Management
b. File System Handlers (src/fs/):
• Virtual File System (VFS)
• WAD Directory Handler
• Real Directory Handler
• File Set Management
c. Conversion Modules (src/conv/):
• Audio Processing
• Graphic Conversion
• Palette Management
• MUS to MIDI Conversion
• PNG Support
Important Architectural Patterns
Highlight:
• The MVC-like pattern used in the browser/pager components
• The plugin-style architecture for different file formats
• The virtual file system abstraction layer
Technical Details
• Support for:
• WAD file operations
• File system integration
• Import/export capabilities
• Palette management
• Texture handling
Integration Points
Indicate:
• External editor integration
• File system interaction
• Import/export interfaces
• Audio/visual processing capabilities
Key Considerations:
• Two-pane interface as a central architectural feature
• Separation between UI and core processing
• Virtual file system abstraction
• Data flow directions for all major operations
• Relationship between different subsystems