Settings

Application configuration panel for user preferences, display settings, and system options

🚧

Under Construction

This documentation is currently being developed and will be available soon.

Overview

The Settings panel is located on the right side, sharing tab space with Properties, Results, and Console panels. It provides comprehensive configuration options for display, performance, connection, editor preferences, and import/export settings. All settings are saved to browser local storage and persist across sessions.

Display Settings

Theme

Dark Mode
Dark background theme
Light Mode
Light background theme
Auto
Follow system preference

Viewport Quality

Preset Levels

Low
Basic rendering, best performance
Medium
Balanced quality/performance
High
Enhanced visuals
Ultra
Maximum quality

Custom Settings

  • • Shadow Resolution: Quality of shadow maps
  • • Anti-aliasing (MSAA): Edge smoothing quality
  • • Post-processing: Effects like bloom and tone mapping
  • • Texture Quality: Texture resolution and filtering

Grid & Helpers

  • • Grid: Toggle grid display on/off
  • • Grid Size: Adjust grid spacing
  • • Grid Divisions: Subdivisions per unit
  • • Axes Helper: Show coordinate axes (X, Y, Z)
  • • Scale Bar: Toggle scale indicator in corner

Performance

Rendering

  • • FPS Target: 30/60/120 fps
  • • VSync: Toggle vertical sync
  • • Frustum Culling: Auto-hide off-screen objects
  • • LOD: Level of detail settings
  • • Instancing: Optimize repeated objects

Memory

  • • Texture Cache: Size limit
  • • Mesh Cache: Geometry memory limit
  • • Clear Cache: Manual cache clearing

Connection

WebSocket

  • • Server URL: Backend connection address
  • • Auto-reconnect: Enable automatic reconnection
  • • Reconnect Delay: Time between attempts
  • • Connection Status: Current state indicator

Sync Options

  • • Camera Sync: Share camera position across clients
  • • Selection Sync: Share selected objects
  • • Real-time Updates: Instant vs batched updates

Editor Preferences

General

  • • Auto-save: Enable/disable automatic saving
  • • Save Interval: Minutes between auto-saves
  • • Undo Levels: History depth (number of undo steps)
  • • Confirm Delete: Show deletion warnings

Controls

  • • Mouse Sensitivity: Camera control speed
  • • Zoom Speed: Scroll wheel sensitivity
  • • Gizmo Size: Transform handle scale
  • • Snap Settings: Grid snapping values

Units

Distance
Meters / Feet / Custom
Angles
Degrees / Radians
Time
Seconds / Frames

Import/Export

File Handling

  • • Default Import Scale: Scale factor for imports
  • • Center on Import: Auto-center imported meshes
  • • Generate Normals: Auto-calculate if missing
  • • Texture Path: Default texture directory

Export Settings

  • • Format: Default export format
  • • Include Textures: Bundle textures with export
  • • Compression: File compression options

Data Storage

Local Storage

Settings are automatically saved to browser local storage and persist across sessions.

// Settings saved in browser
localStorage.setItem('rfdt-settings', JSON.stringify({
  theme: 'dark',
  quality: 'high',
  gridEnabled: true,
  autoSave: true,
  // ... more settings
}));

Settings Structure

interface Settings {
  display: {
    theme: 'dark' | 'light' | 'auto';
    quality: 'low' | 'medium' | 'high' | 'ultra';
    grid: boolean;
    axes: boolean;
  };
  performance: {
    targetFPS: number;
    frustumCulling: boolean;
    lod: boolean;
  };
  connection: {
    serverUrl: string;
    autoReconnect: boolean;
    syncCamera: boolean;
  };
  editor: {
    autoSave: boolean;
    saveInterval: number;
    undoLevels: number;
  };
}

Integration

With Application

  • • Settings applied globally
  • • Real-time updates without restart
  • • Persistent across sessions

With Other Panels

  • • Viewport: Quality settings applied
  • • Properties: Unit display
  • • Node Editor: Grid settings shared

Keyboard Shortcuts

Ctrl + ,Open settings
EscapeClose settings
Ctrl + SSave settings
Ctrl + RReset to defaults

Best Practices

1.
Performance: Start with medium quality preset, adjust as needed based on your hardware
2.
Auto-save: Enable auto-save for important work to prevent data loss
3.
Connection: Use stable server URL and enable auto-reconnect
4.
Shortcuts: Learn keyboard shortcuts for improved efficiency
5.
Profiles: Save different setting profiles for different workflows (future feature)

Troubleshooting

IssueSolution
Settings not savingCheck browser storage permissions
Performance issuesLower quality preset or disable effects
Connection problemsVerify server URL and network connection
Theme not changingClear browser cache and reload