3D Video Generation Test Mode

Overview

The 3D video generation now supports two modes to balance quality and generation speed:

🏃‍♂️ 720p Test Mode (Fast)

Resolution: 1280x720 pixels
Frame Rate: 30 FPS
Entry Sequence: 60 frames (2 seconds)
Route Frames: 2x per GPS point
Generation Speed: ~3x faster than production mode
File Size: ~1/4 of production mode
Best For: Quick previews, debugging routes, testing changes

🎯 2K Production Mode (High Quality)

Resolution: 2560x1440 pixels (2K)
Frame Rate: 60 FPS
Entry Sequence: 120 frames (4 seconds)
Route Frames: 3x per GPS point
Generation Speed: Full quality processing
File Size: Full size for maximum quality
Best For: Final videos, presentations, high-quality output

How to Use

In the App UI

Click "Generate 3D Video" button
Choose from the popup:
- "Generate 720p Test Video" for fast testing
- "Generate 2K Production Video" for final quality

In Code

# Test mode (720p, faster)
generate_3d_video_animation(project_name, resources_folder, label, progress, popup, clock, test_mode=True)

# Production mode (2K, high quality)
generate_3d_video_animation(project_name, resources_folder, label, progress, popup, clock, test_mode=False)

# Or use convenience functions
generate_3d_video_animation_test_mode(...)
generate_3d_video_animation_production_mode(...)

Performance Comparison

Aspect	720p Test Mode	2K Production Mode
Resolution	1280x720	2560x1440
Total Pixels	~0.9 megapixels	~3.7 megapixels
Frame Rate	30 FPS	60 FPS
Space Entry	2 seconds	4 seconds
Processing Time	~3x faster	Full quality
File Size	~1/4 size	Full size
Quality	Good for preview	Cinema quality

When to Use Each Mode

Use 720p Test Mode When:

✅ Testing route visualization
✅ Debugging GPS data issues
✅ Iterating on video parameters
✅ Quick previews for clients
✅ Development and testing
✅ Limited storage space
✅ Faster upload/sharing needed

Use 2K Production Mode When:

✅ Creating final deliverable videos
✅ Professional presentations
✅ High-quality demos
✅ Maximum visual impact needed
✅ Detailed route analysis required
✅ Large screen display planned

File Naming Convention

Generated videos will include the mode in the filename:

Test mode: project_720p_test_20250708_142815.mp4
Production mode: project_2K_production_20250708_142815.mp4

Technical Details

Test Mode Optimizations:

Reduced frame generation (60 vs 120 for entry)
Lower resolution reduces processing per frame
Fewer intermediate frames per GPS point
30 FPS reduces total frame count
Optimized rendering pipeline

Production Mode Features:

Ultra-high resolution Earth rendering
Extended space entry sequence
Maximum detail in atmospheric effects
Professional-grade visual effects
Cinema-quality color grading
Smooth 60 FPS motion

Tips for Best Results

Start with Test Mode: Always preview your route in 720p test mode first
Iterate Quickly: Use test mode to adjust route parameters
Final Production: Once satisfied, generate the 2K production version
Storage Planning: Test mode files are ~25% the size of production files
Time Management: Test mode generates ~3x faster than production mode

This dual-mode approach allows for rapid iteration during development while maintaining the ability to produce ultra-high-quality final videos.

3.6 KiB Raw Blame History