109 lines
3.6 KiB
Markdown
109 lines
3.6 KiB
Markdown
# 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
|
|
1. Click "Generate 3D Video" button
|
|
2. Choose from the popup:
|
|
- **"Generate 720p Test Video"** for fast testing
|
|
- **"Generate 2K Production Video"** for final quality
|
|
|
|
### In Code
|
|
```python
|
|
# 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
|
|
|
|
1. **Start with Test Mode**: Always preview your route in 720p test mode first
|
|
2. **Iterate Quickly**: Use test mode to adjust route parameters
|
|
3. **Final Production**: Once satisfied, generate the 2K production version
|
|
4. **Storage Planning**: Test mode files are ~25% the size of production files
|
|
5. **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.
|