nodes/jandan520-ComfyUI-AdvancedCameraPrompts
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Update README with improved documentation

Browse Source
This commit is contained in:
Jianghong Zhu
2025-11-12 11:05:59 -08:00
parent 2191efcfcd
commit 37e36655ca
1 changed files with 93 additions and 72 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+93 -72
View File
@@ -1,115 +1,136 @@
# ComfyUI Advanced Camera Prompts
Advanced camera control prompt generator for ComfyUI that reads camera information from 3D nodes and generates precise, professional camera control prompts.
Advanced camera control prompt generator for ComfyUI, optimized for dx8152's MultiAngle LoRA. A ComfyUI custom node that automatically generates professional camera control prompts by analyzing 3D camera data. This node reads camera information from Load 3D nodes and converts it into detailed, cinematography-accurate descriptions suitable for image generation workflows.
## What It Does
This node takes camera position and orientation data from your 3D scene and automatically generates:
- Professional shot type classifications (close-up, medium shot, wide shot, etc.)
- Camera angle descriptions (high angle, low angle, bird's eye, etc.)
- Camera movement and positioning information
- Technical camera parameters (focal length, FOV, distance)
All of this is output as both human-readable prompts and structured JSON data.
## Features
- **Automatic Camera Detection**: Reads camera position, target, and angles from Load 3D nodes
- **Professional Shot Types**: Automatically classifies shots (extreme close-up, close-up, medium shot, wide shot, etc.)
- **Camera Angle Recognition**: Detects high angle, low angle, bird's eye, dutch angle, and more
- **Focal Length Support**: Calculate FOV from focal length (1-1000mm)
- **Framing-Based Classification**: Optional object scale input for accurate shot type detection
- **Dual Output**: Generates both human-readable prompts and structured JSON data
- **Industry Standard**: Based on cinematography standards for shot types and camera angles
- **Smart Camera Analysis**: Automatically extracts camera position, target, and rotation from 3D nodes
- **Intelligent Shot Classification**: Determines shot types using distance, focal length, FOV, or object framing
- **Angle Detection**: Recognizes various camera angles including high/low angles, dutch angles, and special views
- **Flexible Input**: Supports custom focal length settings and optional object scale for precise framing calculations
- **Dual Output Format**: Provides both natural language prompts and structured JSON data
- **Cinematography Standards**: Based on industry-standard shot types and camera angle definitions
## Installation
1. Clone this repository into your `ComfyUI/custom_nodes/` folder:
1. Navigate to your ComfyUI custom nodes directory:
```bash
cd ComfyUI/custom_nodes
```
2. Clone this repository:
```bash
git clone https://github.com/jandan520/ComfyUI-AdvancedCameraPrompts.git
```
2. Restart ComfyUI
3. Restart ComfyUI to load the new node
## Usage
## How to Use
### Node Inputs
### Connecting the Node
1. Add a **Load 3D** or **Load 3D - Animation** node to your workflow
2. Add the **Advanced Camera Control Prompt Generator** node
3. Connect the camera output from your 3D node to the "Camera Info" input
### Input Parameters
**Required:**
- **Camera Info** (`LOAD3D_CAMERA`): Camera information from Load 3D or Load 3D - Animation nodes
- **Camera Info**: Connect the camera output from your Load 3D node
**Optional:**
- **Focal Length (mm)** (`FLOAT`, default: 50.0): Camera lens focal length (1-1000mm)
- **Object Scale (meters)** (`FLOAT`, default: 1.0): Object size in meters for framing-based shot classification
- **Custom Description** (`STRING`): Additional text to append to the prompt
- **Focal Length (mm)**: Set your camera's focal length (default: 50mm, range: 1-1000mm)
- This affects FOV calculation and shot type classification
- **Object Scale (meters)**: Specify the size of your subject in meters (default: 1.0m)
- Enables framing-based shot classification for more accurate results
- **Custom Description**: Add any additional text to append to the generated prompt
### Node Outputs
### Outputs
1. **Prompt** (`STRING`): Human-readable camera control prompt
2. **Camera JSON** (`STRING`): Structured JSON with all camera parameters
The node provides two outputs:
## Example Output
1. **Prompt** (String): A natural language description of the camera setup
- Example: `Pan the camera 45 degrees to the right, high angle medium shot (camera distance 2.5 m 50mm FOV 40°)`
**Prompt:**
```
Pan the camera 45 degrees to the right, high angle medium shot (camera distance 2.5 m 50mm FOV 40°)
```
2. **Camera JSON** (String): Structured data with all camera parameters
```json
{
"camera": {
"focal_length_mm": 50,
"sensor_width_mm": 36,
"sensor_height_mm": 24,
"distance_m": 2.5,
"tilt_deg": "tilt down 15.0",
"pan_deg": "pan to right 45.0",
"roll_deg": 0.0,
"shot_type": "medium_shot"
}
}
```
**Camera JSON:**
```json
{
"camera": {
"focal_length_mm": 50,
"sensor_width_mm": 36,
"sensor_height_mm": 24,
"distance_m": 2.5,
"tilt_deg": "tilt down 15.0",
"pan_deg": "pan to right 45.0",
"roll_deg": 0.0,
"shot_type": "medium_shot"
}
}
```
## Shot Type Classification
## Shot Types
The node automatically determines shot types based on multiple factors:
The node automatically classifies shots based on distance, focal length, FOV, or framing:
- Extreme Close-Up
- Close-Up
- Medium Close-Up
- Medium Shot
- Medium Long Shot
- Full Shot
- Wide Shot
- Extreme Wide Shot
| Shot Type | Typical Distance | Focal Length Range | FOV Range |
|-----------|------------------|-------------------|-----------|
| Extreme Close-Up | 0.3-0.6m | 85-135mm | 10-20° |
| Close-Up | 0.6-1.2m | 50-85mm | 20-30° |
| Medium Close-Up | 1.0-1.8m | 35-50mm | 30-40° |
| Medium Shot | 1.5-3.0m | 28-50mm | 35-45° |
| Medium Long Shot | 2.5-4.0m | 24-35mm | 45-55° |
| Full Shot | 3.0-5.0m | 24-35mm | 50-60° |
| Wide Shot | 5.0-10.0m | 18-24mm | 60-90° |
| Extreme Wide Shot | 10-50m | 14-20mm | 90-120° |
## Camera Angles
Recognized camera angles:
The node recognizes these camera angles:
- Eye Level
- High Angle
- Slight Low Angle
- Standard Low Angle
- Deep Low Angle
- Extreme Low Angle (Worm's Eye)
- Bird's Eye
- Dutch Angle
- Dutch Low Angle
- **Eye Level**: Neutral perspective (-5° to +5°)
- **High Angle**: Camera looking down (-20° to -45°)
- **Slight Low Angle**: Just below eye level (5° to 15°)
- **Standard Low Angle**: Waist-chest level (15° to 30°)
- **Deep Low Angle**: Knee-waist level (30° to 45°)
- **Extreme Low Angle**: Ground level, worm's-eye view (45° to 90°)
- **Bird's Eye**: Directly overhead (-80° to -90°)
- **Dutch Angle**: Camera tilted sideways (5° to 30° roll)
- **Dutch Low Angle**: Combination of low angle and roll
## Technical Details
## Use Cases
- **Coordinate System**: Z-axis points at camera, X-axis is horizontal, Y-axis is vertical
- **Image Generation**: Generate accurate camera prompts for AI image models
- **3D to 2D Workflows**: Convert 3D camera setups into 2D image generation prompts
- **Cinematography Analysis**: Analyze and document camera setups from 3D scenes
- **Workflow Automation**: Automatically generate camera descriptions for batch processing
## Technical Specifications
- **Coordinate System**: Z-axis points toward camera, X-axis is horizontal, Y-axis is vertical
- **Sensor Format**: 35mm full-frame equivalent (36mm × 24mm)
- **Distance Scale**: 1 grid unit = 4 meters
- **FOV Calculation**: Uses standard formula: `FOV = 2 × arctan(sensor_dim / (2 × focal_length))`
- **Distance Scaling**: 1 grid unit = 4 meters
- **FOV Formula**: `FOV = 2 × arctan(sensor_dimension / (2 × focal_length))`
## Requirements
- ComfyUI (latest versions)
- Python 3.8+
- Load 3D nodes (for camera input)
- ComfyUI (latest version recommended)
- Python 3.8 or higher
- Load 3D nodes (for providing camera input)
## License
MIT
MIT License
## Author
Jianghong Zhu
## Credits
Optimized for use with dx8152's MultiAngle LoRA and similar camera control workflows.