Cam Guides Pro Documentation
Cam Guides Pro is a professional-grade composition guides addon that provides cinematographers, photographers, and 3D artists with an extensive toolkit for creating visually compelling shots. With over 20 composition guides, interactive placement tools, and advanced features, this addon transforms Blender into a powerful composition planning tool.
🎯 15+ Composition Guides
From basic Rule of Thirds to advanced S-curves and leading lines, access a comprehensive library of composition tools.
🎨 Advanced Styling
Individual colors, glow effects, shadows, and line styles give you complete control over guide appearance.
📸 Per-Camera Settings
Configure different guide setups for each camera in your scene for complex multi-camera projects.
🖱️ Interactive Tools
Click-and-drag positioning for focal points, vanishing points, and custom lines with real-time feedback.
💾 Preset System
Save and share custom guide configurations with a comprehensive preset management system.
⚡ Optimized Performance
GPU-accelerated drawing with caching and threading ensures smooth viewport performance.
Key Highlights
- Professional Tools: Z-depth visualization, aspect ratio masks, and broadcast-safe areas
- Interactive Placement: Real-time guide positioning with mouse controls
- Flexible Workflow: Scene-based or per-camera settings
- Export/Import: Share presets between projects and users
- Modern Interface: Clean, intuitive UI with collapsible sections
- Comprehensive Documentation: Detailed help for every feature
Installation & Setup #
Requirements
Blender: 3.6+ or higher
Installation Steps
- Download the Addon: Get the
cam_guides_pro.zipfile from your purchase - Open Blender Preferences: Go to Edit → Preferences → Add-ons
- Install Addon: Click
Install...and select the ZIP file - Enable Addon: Check the box next to "Cam Guides Pro" in the addon list
- Save Preferences: Click the hamburger menu and select "Save Preferences"
First Time Setup
- Switch to Camera View: Press Numpad 0 or use
View → Camera - Open Addon Panel: Find "Cam Guides Pro" in the sidebar (N key)
- Enable Addon: Click the main "Enable Cam Guides Pro" button
- Test Basic Guide: Enable "Rule of Thirds" to verify installation
Troubleshooting Installation
- Addon not appearing: Ensure you're looking in the 3D Viewport sidebar, not other editors
- Import error: Check that you're using Blender 3.6 or higher
- Missing panel: Press N to show the sidebar
Getting Started #
Basic Workflow
Follow these steps to start using Cam Guides Pro effectively:
-
Enter Camera View
Press Numpad 0 or use
View → Camera. Guides are only visible in camera view. -
Enable the Addon
Click the main "Enable Cam Guides Pro" toggle button in the addon panel.
-
Choose Your Guides
Enable desired composition guides from the various sections (Basic, Advanced, Professional).
-
Adjust Settings
Customize colors, opacity, line styles, and positioning to match your needs.
-
Save Your Setup
Use the preset system to save your favorite configurations for future use.
Important Concepts
📷 Camera View Required
Composition guides are only visible when viewing through a camera. This ensures accurate framing relative to your final render.
🎬 Scene-Based Settings
Each Blender scene maintains independent guide settings, allowing different setups for different shots.
🎥 Per-Camera Mode
Optional feature that allows different guide configurations for each camera in your scene.
⚡ Performance Considerations
Complex guides with high quality settings may impact viewport performance on older hardware.
Quick Start Guide
Here's a simple example to get you started:
1. Create a new scene with a camera
2. Press Numpad 0 to enter camera view
3. Open the Cam Guides Pro panel (N key → Cam Guides Pro tab)
4. Click "Enable Cam Guides Pro"
5. Enable "Rule of Thirds" in the Basic Guides section
6. Adjust the line color and opacity in Style Settings
7. Position your subject at one of the intersection points
8. Save your setup as a preset for future use
Interface Overview #
The Cam Guides Pro interface is organized into logical sections with a clean, modern design. Each section can be collapsed to save space and reduce clutter.
Main Panel Structure
Header Section
- Enable Toggle: Master on/off switch for all guides
- Preset Menu Button: Quick access to preset management
- Camera View Warning: Helpful reminder when not in camera view
Style Settings Section
Global visual settings that affect all guides unless individually overridden:
- Line Color: Global color picker with alpha channel
- Line Width: Thickness of guide lines (1-10 pixels)
- Opacity: Overall transparency slider
- Line Style: Solid, dashed, or dotted lines
- Visual Effects: Glow and shadow options
Individual Colors Section
Override global colors for specific guide types:
- Enable/disable individual color overrides
- Per-guide color pickers with alpha
- Organized list of all available guides
Guide Sections
Organized into three main categories:
- Basic Guides: Fundamental composition rules
- Advanced Guides: Complex geometric patterns
- Professional Features: Specialized tools and overlays
UI Navigation Tips
- Click the arrow icons to expand/collapse sections
- Click the "?" info icons for detailed help about each feature
- Use Tab to navigate between input fields
- Right-click on values to manually enter precise numbers
- The interface dynamically shows/hides options based on enabled features
Interface Elements
| Element | Description | Interaction |
|---|---|---|
| Toggle Buttons | Enable/disable features | Single click to toggle |
| Sliders | Adjust numeric values | Drag or click to set |
| Color Pickers | Select colors | Click to open picker |
| Dropdown Menus | Select from options | Click to expand |
| Number Fields | Enter precise values | Click to edit |
| Interactive Buttons | Launch interactive tools | Click to activate |
Scale Reference Guide #
Scale Reference adds 2D human silhouettes to your camera view for judging size and proportion. Each figure has individual height, units, position, and color settings.
What Each Figure Stores
- Height: Actual height with accurate measurement (0.5m to 3m range)
- Units: Individual units per figure (meters, feet, centimeters, inches)
- Position: 3D location where the figure stands in your scene
- Color: Custom color for each figure or use global color
- Name: Custom labels like "Average Person" or "Figure 1"
Key Features
- Accurate Scaling: Figures appear correctly sized based on distance from camera
- Individual Units: Each figure can display height in different units
- Feet Display: Imperial units show both decimal and ft+inch format (e.g., "6.56 ft (6' 6.7")")
- Per-Figure Colors: Each figure can have its own color override
Controls
- Show Scale Reference: Toggle all figures on/off
- Active Figure: Select which figure to edit
- Height Slider: Adjust the selected figure's height
- Units: Change display units for the active figure
- Color Override: Enable custom color for the active figure
- Add/Remove: Create new figures or delete selected ones
How to Use
- Enable "Show Scale Reference"
- Add figures where you need scale reference
- Set each figure's height using the slider
- Choose appropriate units (meters, feet, etc.)
- Optionally set custom colors for different figure types
Works With
- Presets: Figures are saved and loaded with presets
- Guide Capture: Figures appear in captured guide images
- Camera Bookmarks: Figure positions saved with camera setups
Basic Composition Guides #
Basic composition guides provide fundamental tools for creating well-balanced and visually appealing compositions. These guides are based on classical art and photography principles that have been proven effective over centuries.
Rule of Thirds #
The most fundamental composition principle, dividing the frame into nine equal sections with two horizontal and two vertical lines.
Controls
- Show Rule of Thirds: Enable/disable the grid
- Show Power Points: Highlight the four intersection points
- Individual Color Override: Custom color for this guide
Usage Tips
- Place important subjects along the lines or at intersection points
- Use horizontal lines for horizons (upper third for landscapes, lower third for sky emphasis)
- Position vertical subjects (people, trees, buildings) along vertical lines
- The intersection points (power points) are the strongest compositional positions
Golden Ratio #
A mathematically derived proportion (1.618:1) found throughout nature and classical art, creating naturally pleasing compositions.
Controls
- Show Golden Ratio: Enable the golden ratio grid
- Show Golden Rectangles: Display nested golden rectangles
- Individual Color Override: Custom color settings
Best Practices
- More subtle than rule of thirds, creating a slightly off-center composition
- Excellent for organic, natural subjects
- Use the golden rectangles to frame important elements
- Works well for portraits, placing eyes at golden ratio intersections
Center Cross #
Simple horizontal and vertical lines through the exact center of the frame.
Controls
- Show Center: Enable center cross lines
- Individual Color Override: Custom color for center lines
Applications
- Perfect for symmetrical compositions
- Architectural photography requiring precise alignment
- Centering subjects for formal portraits or product shots
- Checking balance in asymmetrical compositions
Diagonals #
Corner-to-corner diagonal lines that create dynamic movement and energy in compositions.
Controls
- Show Diagonals: Enable diagonal lines
- Individual Color Override: Custom color settings
Creative Uses
- Create dynamic tension in otherwise static scenes
- Guide the viewer's eye through the frame
- Balance elements across the composition
- Enhance depth by placing elements along receding diagonals
Circle Compositions #
Circular and radial composition guides for creating focused, centered compositions and drawing the viewer's eye.
Controls
- Show Circle Compositions: Enable circular guides
- Circle Type: Choose from several circular patterns
- Circle Count: Number of concentric circles (1-6)
- Individual Color Override: Custom color settings
Circle Types
| Type | Description | Best Use |
|---|---|---|
| Concentric | Multiple nested circles from the center | Creating a strong focal point or layered depth |
| Thirds Centers | Circles placed at Rule of Thirds intersections | Highlighting off-center subjects with radial focus |
| Golden Circles | Circles positioned at Golden Ratio points | Creating natural, aesthetically pleasing compositions |
Applications
- Creating a strong sense of radial balance
- Drawing attention to a central subject (spotlight effect)
- Framing subjects within circular arrangements
- Guiding eye movement in a circular pattern
Triangle Compositions #
Geometric triangular guides for creating stable, structured, or dynamic compositions.
Controls
- Show Triangle: Enable triangle guides
- Triangle Type: Choose from 8 different configurations
- Individual Color Override: Custom color settings
Triangle Types
| Type | Description | Best Use |
|---|---|---|
| Classic | A traditional pyramid shape for stability. | Creating a strong, grounded, and balanced feeling. |
| Golden Triangle | Uses diagonals and perpendicular lines for dynamic balance. | Professional photography and dynamic, yet harmonious shots. |
| Implied Triangle | Connects three custom points of interest. | Arranging subjects in group portraits or product shots. |
| Inverted | An upside-down triangle that creates unease or tension. | Portraying instability, conflict, or suspense. |
| Diagonal | Corner-to-corner triangles for high energy. | Action shots and compositions with strong directional flow. |
| Nested | Multiple triangles within each other for depth. | Creating a sense of layering or leading the eye inward. |
| Mirrored Golden | Golden Triangle with perpendiculars on the opposite diagonal. | Creating a complex and balanced composition. |
| Custom | A fully transformable triangle with user-defined parameters. | Specific or abstract compositional needs. |
Custom Triangle Parameters
When using the 'Custom' triangle type, you can adjust:
- Base Width: The width of the triangle's base.
- Apex X/Y: The horizontal and vertical position of the top point.
- Base Y: The vertical position of the base.
- Rotation: Rotate the entire triangle.
Symmetry Lines #
Guidelines for creating perfectly symmetrical and balanced compositions.
Controls
- Show Symmetry Lines: Enable symmetry guides
- Symmetry Type: Choose from horizontal, vertical, diagonal, or radial symmetry
- Individual Color Override: Custom color settings
Symmetry Types
- All: Shows horizontal, vertical, and both diagonal lines.
- Horizontal: A single line across the center, for reflections.
- Vertical: A single line down the center, for balanced portraits.
- Diagonal: Both diagonal lines, for dynamic symmetry.
- Radial: 8 lines radiating from the center for circular balance.
Use Cases
- Architectural shots requiring perfect balance.
- Reflection compositions (e.g., across water or mirrors).
- Formal portraits and product shots with centered subjects.
- Creating mandalas or other radially balanced designs.
Advanced Composition Tools #
Advanced composition tools provide sophisticated geometric patterns and customizable grid systems for complex compositional needs. These tools offer precise control over mathematical relationships and spatial arrangements.
Golden Spiral #
The famous Fibonacci spiral based on golden ratio proportions, creating natural eye-flow patterns.
Controls
- Show Golden Spiral: Enable the spiral guide
- Spiral Rotation: Rotate in 90° increments (0°, 90°, 180°, 270°)
- Spiral Type: Different spiral variations
- Offset X/Y: Fine-tune spiral position
- Scale: Adjust spiral size (0.1-2.0)
- Invert: Flip spiral direction
- Quality: Smoothness vs. performance balance
Advanced Settings
- Multiple Rotations: Layer spirals at different angles
- Custom Positioning: Precise placement within frame
- Quality Control: 20-200 segments for curve smoothness
Creative Applications
- Natural subject flow (shells, flowers, galaxies)
- Eye movement guidance through the composition
- Dynamic portrait positioning
- Landscape compositions with natural curves
Custom Grid System #
Flexible grid system with advanced subdivision options for precise compositional control.
Controls
- Show Custom Grid: Enable custom grid
- Grid Subdivisions: Number of divisions (2-20)
- Overlay Grid: Additional subdivision overlay
- Individual Color Override: Custom color settings
Grid Types
| Type | Description | Best Use |
|---|---|---|
| Basic Grid | Simple rectangular divisions | General composition planning |
| Overlay Grid | Additional fine divisions | Precise element positioning |
| Custom Ratios | User-defined proportions | Specific aspect requirements |
Use Cases
- Architectural visualization with precise alignments
- Product photography layouts
- Multi-element compositions requiring structure
- Technical drawings and diagrams
3D Floor Grid #
Three-dimensional grid system providing spatial reference in 3D space.
Controls
- Show Grid: Enable 3D floor grid
- Grid Type: Floor, ceiling, or both
- Floor Grid Size: Scale of individual grid squares
- Floor Grid Extent: How far the grid extends
- Show Axes: Display X/Y axis lines
- Opacity: Grid transparency (0.0-1.0)
Applications
- Architectural visualization and walkthroughs
- Product placement and scale reference
- Character positioning and movement
- Spatial relationship visualization
Camera Grid Transform #
Advanced 3D grid with full transform controls for complex spatial compositions.
Transform Controls
- Camera Grid Subdivisions: Grid density (2-50)
- Offset X/Y: Position adjustment (-2.0 to 2.0)
- Rotation: Primary rotation angle (-180° to 180°)
- Rotation X/Y: Additional rotation axes
- Scale X/Y: Non-uniform scaling (0.1-5.0)
- Uniform Scale: Proportional scaling
- Reset Transform: Return to default settings
Advanced Features
- Non-Uniform Scaling: Different X and Y scale factors
- Multi-Axis Rotation: Complex 3D orientations
- Precise Positioning: Decimal precision for exact placement
- Transform Presets: Save common transform configurations
Professional Uses
- Perspective correction and planning
- Complex architectural alignments
- Multi-plane compositions
- Technical illustration grids
Professional Features #
Professional features provide specialized tools for advanced cinematography, photography, and visualization work. These tools are designed for industry professionals requiring precise control and advanced functionality.
Leading Lines System #
Advanced vanishing point and parallel line system for dynamic compositions and perspective control.
Vanishing Points (Up to 10)
Create sophisticated perspective compositions with multiple vanishing points:
| Control | Range | Description |
|---|---|---|
| Position X/Y | -2.0 to 2.0 | Placement within or outside frame |
| Angle Offset | -180° to 180° | Rotation of line pattern |
| Line Count | 1-12 | Number of lines from this point |
| Spacing | 1°-90° | Angular spacing between lines |
| Length | 0.1-2.0 | How far lines extend |
Pattern Types
- Vanishing Point: Lines converge to focal points
- Parallel: Multiple parallel lines
- Custom: User-defined line placement
Interactive Placement
- Click "Place VP" buttons for interactive positioning
- Real-time visual feedback during placement
- Mouse wheel adjustments for line parameters
- Modifier keys for different parameter control
Custom Lines (Up to 8)
Precise line control with multiple modes:
- Point to Point: Define exact start and end points
- Edge to Point: Lines from frame edges to target points
- Through Points: Lines passing through two points
S-Curve System #
Flowing curved lines for dynamic, organic compositions with mathematical precision.
S-Curve Parameters (Up to 6 curves)
| Parameter | Range | Effect |
|---|---|---|
| Amplitude | 0.0-1.0 | Wave height/curve intensity |
| Frequency | 0.25-8.0 | Number of S-curves |
| Steepness | 0.3-3.0 | Sharpness of transitions |
| Phase | -180° to 180° | Wave phase shift |
| Rotation | -180° to 180° | Curve rotation angle |
| Scale | 0.1-2.0 | Overall size multiplier |
Global Settings
- Curve Count: Number of active curves (1-6)
- Segments: Smoothness quality (20-200)
- Mirror: Create mirrored copies
Interactive Controls
- Mouse Wheel: Adjust amplitude
- Shift + Wheel: Adjust rotation
- Alt + Wheel: Adjust frequency
- Ctrl + Wheel: Adjust scale
- M Key: Toggle mirror mode
- R Key: Reset to defaults
Focal Points System #
Visual focal point indicators for precise subject placement and composition guidance.
Focal Point Controls (Up to 6 points)
- Position X/Y: Precise placement coordinates
- Radius: Size of the focal point indicator
- Individual Color: Unique color per point
Focal Point Styles
| Style | Description | Best Use |
|---|---|---|
| Circle | Simple circle outline | General subject marking |
| Crosshair | Circle with center cross | Precise positioning |
| Thirds Target | Circle with rule of thirds markers | Compositional reference |
| Dashed | Dashed circle outline | Subtle marking |
| Dot | Simple center dot | Minimal interference |
Z-Depth Visualization #
Professional depth visualization using Blender's mist pass for composition analysis.
Controls
- Show Z-Depth: Enable depth visualization
- Toggle Mist Pass: Quick switch to mist pass rendering
- Depth Start: Near clipping distance
- Depth Range: Depth visualization range
- Falloff: Depth gradient falloff
Professional Applications
- Analyze depth composition and layering
- Plan focus stacking and depth of field
- Visualize depth of field effects
- Ensure proper depth separation between elements
Aspect Ratio System #
Professional aspect ratio tools and masks for various output formats. The addon includes over 50 presets to match any delivery requirement, from cinema to social media.
Controls
- Show Aspect Ratio: Enable aspect ratio guides
- Aspect Ratio Type: Choose from a comprehensive list of presets
- Show Label: Display ratio information on the overlay
- Mask Opacity: Transparency of the letterbox/pillarbox areas
- Use as Bounds: Constrain other guides to fit within the aspect ratio frame
- Affect Camera: Automatically apply the selected resolution to the camera and render settings
Available Aspect Ratio Presets
The following is a complete list of aspect ratio presets available in the addon, grouped by category.
🎬 Cinema & Professional
- HDTV/YouTube (16:9)
- Traditional TV (4:3)
- CinemaScope (2.35:1)
- Academy Flat (1.85:1)
- Modern Anamorphic (2.39:1)
- 8K UHD (7680×4320)
- 4K UHD (3840×2160)
- 4K DCI (4096×2160)
- 2K DCI (2048×1080)
- Full HD (1920×1080)
📱 Social Media & Mobile
- Instagram Square (1:1)
- Instagram Portrait (4:5)
- Instagram Stories (9:16)
- TikTok / YouTube Shorts (9:16)
- Facebook & Twitter Posts
- iPhone 15 Pro & SE
- Samsung S24
- iPad Pro 12.9"
🎪 IMAX & Broadcast
- IMAX Digital & GT
- IMAX Film (1.43:1)
- PAL & NTSC SD
- HD 1080i Broadcast
- 8K UHD Broadcast
🖥️ Monitors & Other Formats
- 4K & 5K Monitors
- Ultrawide QHD (21:9)
- European Widescreen (1.66:1)
- Academy Standard (1.37:1)
- Ultra Panavision (2.76:1)
- ... and many more.
Safe Areas #
Broadcast-safe area indicators for professional video production.
Controls
- Show Safe Areas: Enable safe area guides
- Action Safe: 90% safe area for action and movement
- Title Safe: 80% safe area for text and graphics
- Individual Color Override: Custom colors for each area
Professional Standards
- Action Safe (90%): Keep all important action within this area
- Title Safe (80%): Keep all text and graphics within this area
- Broadcast Compliance: Ensures content displays correctly on all devices
Applications
- Broadcast television production
- Streaming video content
- Professional video editing
- Title and graphic placement
Style & Customization #
Comprehensive styling options allow you to customize the appearance of all composition guides to match your workflow and aesthetic preferences.
Global Style Settings
These settings affect all guides unless individually overridden:
Basic Styling
- Line Color: RGB color picker with alpha channel
- Line Width: Thickness of guide lines (1-10 pixels)
- Opacity: Overall transparency (0.0-1.0)
Line Styles
Choose from multiple line styles to change the appearance of your guides. Solid lines offer high visibility, while dashed or dotted lines provide more subtle guidance.
| Style | Description | Best Use |
|---|---|---|
| Solid | A continuous, unbroken line. | General purpose, maximum visibility. |
| Dashed | A line made of short, evenly spaced segments. | Subtle guidance that is less distracting. |
| Dotted | A line made of dots. | Minimal visual impact, for very subtle framing. |
| Double | Two parallel solid lines. | Creating tramlines or strong visual tracks. |
Visual Effects
Enhance the visibility of your guides against any background with glow and shadow effects.
- Glow Effect: Adds a soft glow around guide lines, perfect for making them stand
out in dark or cluttered scenes.
- Intensity: Controls the strength and size of the glow.
- Drop Shadow: Renders a subtle shadow behind guide lines, improving readability
on bright or complex backgrounds.
- Offset: Sets the distance of the shadow from the lines.
- Shadow Color: Controls the color and transparency of the shadow.
Individual Color System
Override global colors for specific guide types with precise control:
Supported Guides
Basic Guides
- Rule of Thirds
- Golden Ratio
- Golden Spiral
- Center Cross
- Diagonals
Advanced Guides
- Triangle
- Circle Compositions
- Symmetry Lines
- Custom Grid
Professional Tools
- Safe Areas
- Image Overlay
- Interactive Custom Guides
Color Override Controls
Each guide type provides:
- Enable Override: Checkbox to enable individual color
- Color Picker: RGB color with alpha channel
- Alpha Slider: Separate opacity control
Image Overlay #
The Image Overlay feature allows you to import reference images directly into your viewport, perfect for matching compositions, recreating shots, or using photo references for 3D work.
How to Use Image Overlay
- Navigate to the Professional Features section in the addon panel
- Enable Show Image Overlay
- Click the folder icon to browse and select your reference image
- Adjust the overlay settings to match your needs
Overlay Controls
- Image File: Select your reference image (PNG, JPG, EXR, TIFF supported)
- Opacity: Control transparency of the overlay (0.0-1.0)
- Scale: Resize the overlay to fit your composition
- Position X/Y: Fine-tune overlay placement
- Rotation: Rotate the overlay to match your camera angle
Creative Applications
- Photo Matching: Recreate real-world shots in 3D
- Concept Art Reference: Use concept art as composition guides
- Storyboard Matching: Match pre-planned storyboard frames
- Product Photography: Recreate existing product shots
- Architecture Visualization: Match reference photos of buildings
Best Practices
- Use high-resolution images for better detail
- Adjust opacity to see your 3D scene underneath
- Consider image aspect ratio when setting up your camera
- Use the overlay for positioning, then disable for final render
Guide Capture & Compositor Overlay #
Guide Capture saves your current composition guides as an image file and can automatically add them to the Blender Compositor for render overlays.
What Gets Captured
- All Active Guides: Every enabled guide with its current settings
- Individual Colors: Custom colors for each guide type are preserved
- Scale Reference Figures: All visible figures with their heights and colors
- Leading Lines: Vanishing points, grids, and parallel lines
- S-Curves & Focal Points: All professional composition tools
What's NOT Captured
- Image Overlay: Reference images are excluded
- Z-Depth Visualization: Mist pass is not captured
- 3D Scene Objects: Only guides, not your models
Quality Features
- High Quality: Smooth, crisp lines in captured images
- Multiple Formats: Save as PNG, JPEG, or TIFF
- Transparent Background: PNG format supports transparency
Compositor Integration
Automatically set up guides as render overlays:
- Auto Setup: Creates compositor nodes automatically
- Update Compositor: Regenerates and updates the guide overlay
- Render Size: Automatically matches your render resolution
How to Use
- Set up your composition guides
- Choose capture resolution and format
- Click "Capture Guides" to save an image
- Use "Update Compositor" to add guides to renders
- Render your scene with guide overlay
Requirements
Guide capture requires PIL (Pillow) library. The addon will install it automatically when needed.
Best For
- Creating reference images for other software
- Adding guides to final renders
- Sharing composition setups with team members
- Client presentations with visible guides
Per-Camera Settings #
Per-camera settings allow different guide configurations for each camera in your scene, perfect for complex multi-camera projects.
Enabling Per-Camera Mode
- Enable "Use Per-Camera Settings" in the main panel
- Select target camera from the dropdown
- Adjust settings for that specific camera
- Switch cameras to see different configurations
Camera Management
- Camera Dropdown: Lists all cameras in the scene
- Refresh Button: Update camera list after adding/removing cameras
- Auto-Switch: Automatically switch settings when changing active camera
Syncing Operations
| Operation | Description | Use Case |
|---|---|---|
| Sync to Camera | Save current scene settings to selected camera | Apply current setup to specific camera |
| Load from Camera | Load camera-specific settings to scene | Restore camera's saved configuration |
| Sync All | Apply current settings to all cameras | Uniform setup across all cameras |
Workflow Examples
- Multi-Camera Setups: Different guides for wide shots vs. close-ups
- Shot-Specific Composition: Tailored guides for each camera angle
- Director's Workflow: Preset configurations for different camera positions
Camera Bookmarks #
Camera Bookmarks save complete camera setups for easy recall. Each bookmark captures your camera position, settings, render options, and current guide configuration.
What Gets Saved
- Camera Position & Rotation: Exact camera location and orientation
- Camera Settings: Focal length, sensor size, clipping distances
- Render Settings: Resolution, render percentage, border settings
- Current Guides: All enabled guides with their colors and settings
- Scale Figures: All reference figures with their positions and heights
Controls
- Add Bookmark: Save the current camera setup
- Update Bookmark: Update selected bookmark with current settings
- Load/Go To: Restore a saved camera setup
- Remove: Delete the selected bookmark
- Clear All: Remove all bookmarks in the scene
How to Use
- Set up your camera position and composition guides
- Click "Add Bookmark" to save everything
- Try different camera angles or guide settings
- Use "Load/Go To" to switch back to saved setups
- Use "Update Bookmark" to save improvements
Best For
- Comparing different camera angles
- Saving multiple shot options for review
- Switching between different aspect ratios
- Preserving approved camera positions
Preset System #
Save, load, and share guide configurations with 30+ built-in professional presets and custom preset management.
Built-in Presets
Access presets via the preset icon (📋) next to the main toggle:
📸 Photography
- Basic Photography
- Portrait Photography
- Street Photography
- Landscape Photography
- Macro Photography
- Product Photography
- Documentary
🎬 Cinematography
- Professional Cinema
- Film Noir
- 2K/4K DCI Cinema
- IMAX Digital
- Anamorphic Widescreen
- CinemaScope Classic
- Television Broadcast
📱 Social Media
- Instagram Stories/Square
- TikTok Vertical
- YouTube Content
- Facebook Cover
- Twitter/X Post
🎨 Artistic
- Golden Spiral
- Dynamic Composition
- Classic S-Curve
- Vanishing Point
- Minimalist
- VFX Plate
- Modern Geometric
Custom Presets
Manage your own presets in the "Preset Management" section:
- Save: Click "Save Preset", enter name, saves all current settings
- Load: Select from dropdown and click "Load"
- Export/Import: Share presets as JSON files
- Manage: View, delete, or rename saved presets
Preset Files
Presets are JSON files stored in the installed addon folder cam_guides_pro/presets
containing guide settings, styles, and metadata.
Interactive Tools #
Interactive Tools provide real-time, mouse-driven control over guide placement and positioning. These tools allow you to visually adjust composition guides directly in the viewport for precise control.
Available Interactive Tools
Interactive Custom Guide
Draw custom composition lines directly in the viewport using your mouse.
- Enable Custom Guide: Activate the interactive drawing mode
- Click and Drag: Draw lines directly in the viewport
- Multiple Lines: Add up to 10 custom lines
- Real-time Feedback: See lines update as you draw
Interactive Focal Point Placement
Place focal points by clicking directly in the viewport.
- Click to Place: Single click to position focal points
- Drag to Adjust: Move existing points by dragging
- Visual Feedback: See placement in real-time
- Multiple Points: Place up to 6 focal points
Interactive Leading Lines
Position leading lines interactively for dynamic compositions.
- Vanishing Point Placement: Click to set vanishing points
- Line Direction: Drag to adjust line angles
- Real-time Preview: See lines update as you adjust
- Multiple Vanishing Points: Create complex perspective systems
How to Use Interactive Tools
- Enable the desired guide system (Custom Guide, Focal Points, or Leading Lines)
- Look for the "Interactive" or "Place" button in the guide's controls
- Click the button to enter interactive mode
- Use your mouse to position elements in the viewport
- Press Enter to confirm or Escape to cancel
Interactive Controls
| Action | Control | Description |
|---|---|---|
| Place Element | Left Click | Position guides, focal points, or vanishing points |
| Adjust Position | Click & Drag | Move existing elements to new positions |
| Confirm Changes | Enter Key | Accept current positioning and exit interactive mode |
| Cancel Changes | Escape Key | Discard changes and exit interactive mode |
| Reset Position | R Key | Reset elements to default positions |
Tips for Interactive Tools
- Camera View Required: Interactive tools only work in camera view
- Visual Feedback: Look for cursor changes and visual indicators
- Precision: Use small mouse movements for fine adjustments
- Workflow: Use interactive tools for initial placement, then fine-tune with numeric controls
Troubleshooting #
Common Issues
Guides Not Visible
Solutions:
- Ensure you're in Camera View (Numpad 0)
- Check that "Enable Cam Guides Pro" is activated
- Verify that specific guides are enabled
- Check opacity settings (may be too low)
- Ensure camera is selected and active
Performance Issues
Solutions:
- Reduce Golden Spiral Quality setting
- Lower S-Curve Segments count
- Disable unused guides
- Reduce grid subdivisions
- Close other heavy applications
Interactive Tools Not Working
Solutions:
- Ensure you're in Camera View
- Check that the specific guide system is enabled
- Try restarting the interactive tool
- Verify mouse and keyboard input
- Check for conflicting addons
Error Messages
| Error | Cause | Solution |
|---|---|---|
| "Not in Camera View" | Viewing from 3D viewport instead of camera | Press Numpad 0 to enter camera view |
| "No Active Camera" | No camera selected or no camera in scene | Add a camera and set it as active |
| "Invalid Image Format" | Unsupported image file for overlay | Use PNG, JPG, EXR, or other supported formats |
Performance Optimization
- Quality Settings: Use lower quality for complex guides
- Feature Management: Disable unused features
- Subdivision Limits: Reduce grid density for better performance
- Line Styles: Use solid lines instead of dashed/dotted for better performance
Tips & Best Practices #
Composition Guidelines
Rule of Thirds
- Place horizons on third lines, not center
- Position subjects at intersection points (power points)
- Use for both horizontal and vertical elements
- Combine with other guides for complexity
Golden Ratio & Spiral
- More subtle than rule of thirds
- Excellent for natural, organic compositions
- Use golden rectangles to frame elements
- Spiral works well for eye-flow guidance
Leading Lines
- Use to guide viewer's eye to subject
- Diagonal lines create dynamic tension
- Converging lines add depth
- Parallel lines create stability
Workflow Tips
Setup Workflow
- Start with basic guides (Rule of Thirds)
- Add complexity gradually
- Test different combinations
- Save successful configurations as presets
- Develop personal style library
Multi-Camera Projects
- Use per-camera settings for different shots
- Create presets for common camera positions
- Sync settings across similar cameras
- Export/import presets between projects
Creative Applications
🎬 Cinematography
- Aspect ratio masks for different formats
- Leading lines for dynamic camera moves
- Z-depth for focus planning
- Safe areas for broadcast work
📸 Photography
- Golden ratio for natural subjects
- Rule of thirds for general composition
- Focal points for subject placement
- Symmetry lines for architectural work
🏗️ Architectural Visualization
- Custom grids for structural alignment
- 3D floor grids for spatial reference
- Symmetry lines for building facades
- Aspect ratios for presentation formats
📦 Product Visualization
- Center cross for product centering
- Circle compositions for radial arrangements
- Custom lines for product features
- Image overlays for reference matching
Professional Tips
Color Coding System
- Red: Primary composition elements
- Blue: Secondary elements
- Green: Reference lines
- Yellow: Focal points
- White/Gray: Structural guides
Project Management
- Create project-specific preset collections
- Use per-camera settings for shot lists
- Export configurations for archival
- Maintain version control for presets
- Document custom configurations
Performance Tuning
While Cam Guides Pro is highly optimized, complex scenes with multiple high-quality guides can affect viewport performance on some systems. Use these settings to maintain a smooth experience.
- Golden Spiral Quality: Found under Advanced Guides → Golden Spiral. This setting controls the number of line segments used to draw the spiral. For smoother navigation, use 'Medium' or 'High'. 'Ultra' provides the best visual quality for final composition but is more demanding.
- S-Curve Segments: Found under Professional Features → S-Curve. This slider controls the smoothness of the S-Curve. A lower value (e.g., 50-80) will improve performance during interactive placement, while a higher value (e.g., 150+) is better for final framing.
-
General Tips:
- Disable guides you are not actively using.
- Use 'Solid' line styles instead of 'Dashed' or 'Dotted' when performance is critical.
- Reduce grid subdivisions in the Custom Grid when not needed.
Feedback & Support #
Your feedback is invaluable for improving Cam Guides Pro. If you encounter any bugs, have a feature request, or just want to share your thoughts, please don't hesitate to reach out.
Reporting Bugs
If you believe you have found a bug, please include the following information in your report to help resolve the issue as quickly as possible:
- Your Blender version (e.g., Blender 4.1).
- The Cam Guides Pro addon version (e.g., v1.0.0).
- A clear description of the steps needed to reproduce the bug.
- Any error messages that appear in the Blender system console (you can open this from
Window > Toggle System Console). - Screenshots or a short video demonstrating the issue are also extremely helpful.
Feature Requests & General Feedback
Ideas for new guides, features, or improvements to the user interface are always welcome. Your suggestions help shape the future of the addon.
Contact Information
Conclusion
Cam Guides Pro provides a comprehensive toolkit for composition guidance in Blender. From basic rule of thirds to advanced interactive tools, the addon supports both beginners learning composition principles and professionals requiring precise control over their visual storytelling.
The key to mastering the addon is to start simple and gradually incorporate more advanced features as your needs grow. Use the preset system to build a library of configurations that match your style and workflow requirements.
Happy composing!