🎯 Overview

Welcome to the ScreenCraft 3D Workspace! This application helps you plan and visualize projection mapping setups in a 3D environment. You can add projectors from a professional library, create various screen types, and see realistic projections with projective texture mapping.

📽️ Adding Projectors

From Library: Click "Add from Library" to choose from a comprehensive database of professional projectors with accurate specifications including brightness, resolution, and throw ratios.

Generic Projector: Click "Add Generic Projector" to add a standard projector with default settings that you can customize.

Once added, projectors appear as 3D objects with visual frustums showing their projection area.

📺 Adding Screens

Choose from multiple screen types:

• Flat Screen: Traditional rectangular projection surface - ideal for standard setups
• Curved Screen: Cylindrical surface with adjustable arc (1-360°) - perfect for immersive panoramas
• Dome Screen: Hemispherical surface - used for planetarium-style projections
• Sphere Screen (Panadome): Full spherical surface - for complete 360° immersion

Click on any screen to see its properties in the panel on the right side, where you can adjust dimensions and type.

📷 Adding Cameras

From Library: Click "Add from Library" to choose from a comprehensive database of professional cameras with accurate specifications.

Generic Camera: Click "Add Generic Camera" to add a standard camera with default settings that you can customize.

Viewing Through Camera: Double-click on any camera in the scene to open a window showing the view from that camera's perspective. This helps you plan camera angles and compositions.

🎮 Camera Controls

• Left Mouse Button + Drag: Rotate camera around the scene
• Right Mouse Button + Drag: Pan camera (move viewpoint)
• Mouse Wheel / Scroll: Zoom in and out
• Reset Camera Button: Return camera to default position

🔧 Transform Controls

Select any object by clicking on it, then use these keyboard shortcuts:

• G Key: Enter Move mode - drag to reposition the object
• T Key: Enter Move mode - drag to reposition the object
• R Key: Enter Rotate mode - drag to rotate the object
• S Key: Enter Scale mode - drag to resize the object
• Delete Key: Remove the selected object from the scene

You can also drag the colored arrows/handles that appear on selected objects to transform them along specific axes.

✨ Projective Texture Mapping

The 3D workspace features realistic projective texture mapping:

• Projectors display a test pattern on screens within their frustum range
• Textures are perspective-corrected for accurate visualization
• Each screen shows projection from the closest projector
• Works with all screen types (flat, curved, dome, sphere)

This helps you preview how your projection setup will look before physical installation.

💾 Saving & Loading Projects

Auto-Save: Your work is automatically saved to browser local storage as you make changes.

Save Project: Save the current scene to a named project on the server.

Load Project: Browse and load a previously saved server project.

Export JSON: Download your project as a JSON file for backup or sharing

Equipment List: Export a detailed list of all projectors and their specifications

📏 Distance Measurement

The measurement tool helps you measure distances between points in your 3D scene:

• Measure Distance Button: Click to enable measurement mode
• M Key: Keyboard shortcut to toggle measurement mode
• In measurement mode, click on any point in the scene to set the first point
• Click a second point to complete the measurement and see the distance
• Measurements are displayed as colored lines with distance labels in meters
• Clear Measurements: Remove all measurement lines from the scene

This is useful for planning projector placement, checking throw distances, and verifying screen dimensions.

📋 Properties Panel

When you select a screen or other object, the Properties Panel appears on the bottom-right. Here you can:

• Change screen type (Flat, Curved, Dome, Sphere)
• Adjust dimensions (width, height, radius, arc angle)
• View object position and rotation

All changes are applied in real-time and auto-saved.

💡 Tips & Best Practices

• Start by adding screens to define your projection surfaces
• Position projectors at realistic throw distances (typically 5-15m for large screens)
• Use the grid and axes helpers for accurate positioning
• Check the Scene Info panel (top-right) for quick statistics
• Select objects from the Scene Objects list in the left toolbar
• Regularly export your project as JSON for backup