- â
ď¸Â IMPORTANT INFORMATION ABOUT ANIMATIONS
ROLLFLOW'S AUTOMATIC ANIMATIONS WORK ONLY WITH CIRCULAR LAYOUTS:
Layout
Carousel
Animation Support Animation Type
â
 FULL SUPPORT Continuous horizontal rotation
Ferris Wheel â
 FULL SUPPORT Continuous vertical rotation
Grid
â NOT SUPPORTED Use manual animation
This means that:
â˘The "Enable Animation" option only works with Carousel and Ferris Wheel
â˘For Grid layouts, you need to create animations manually
â˘The "Animate as Group" button only appears in circular layouts
đ TABLE OF CONTENTS
1.Overview
2.Installation
3.Getting Started
4.Step-by-Step Workflow
5.Essential Configuration
6.Visual Effects
7.Troubleshooting
8.Professional Tips
đ Overview
RollFlow is a Blender add-on that transforms photos and videos into interactive 3D
layouts. Create impressive presentations with advanced visual effects.
Key Features:
⢠â
3 layout types: Grid, Carousel, Ferris Wheel
⢠â
Automatic photo and video import
⢠â
3D Parallax effects
⢠â
Complete manual rotation control
â˘â
 Automatic animations (Carousel/Ferris Wheel only)
⢠â
Intuitive interface in Portuguese/English
đĽÂ Installation
Portuguese Version
1.DownloadÂ
RollFlow_PT.zip
2.Blender >Â
Edit > Preferences > Add-ons
3.ClickÂ
Install... and select the ZIP file
4.Enable the checkbox
English Version
1.DownloadÂ
RollFlow_EN.py
2.Follow the same steps above
3.Use only ONE version at a time!
đŻÂ Getting Started
Photo Preparation
For correct ordering, name files like this:
text
â
CORRECT: 01_photo.jpg, 02_photo.jpg, 03_photo.jpg...
â INCORRECT: 1_photo.jpg, 2_photo.jpg... (10 will come before 2)
Location in Blender
â˘Right sidebar panel (pressÂ
â˘"RollFlow" tab
N)
đ¸Â Step-by-Step Workflow
STEP 1: Import Media
text
đ
ď¸ Media
âââ Media Folder: [Select]
âââ Button: "Import Media"
STEP 2: Choose Layout
Layout
Grid
Best for
Animation
Portfolios, grids â Manual
Carousel
Presentations
â
Automatic
Ferris Wheel Dramatic effects â
Automatic
STEP 3: Configure Parameters
Common Settings:
â˘Reverse Order: For reverse sequence
â˘Global Scale: Adjusts size of all media
â˘Spacing: Distance between elements
Specific Settings:
â˘Grid: Rows and Columns
â˘Carousel: Radius, Height, Tilt
â˘Ferris Wheel: Radius, Base Height, Tilt
STEP 4: MANDATORY CONFIGURATION
To make photos follow the camera:
1.Select all planes (
A)
2.AddÂ
Track To constraint:
text
Target: [Your Camera]
To: -Z
Up: Y
3.Apply to all planes
For Carousel/Ferris Wheel:
text
đŹ Animation (ONLY for circular layouts)
âââ Enable Animation: [ ]
âââ Speed: 1.0
â
âââ Duration: 120 frames
âââ Direction: Clockwise / Counterclockwise
How it works:
1.Layout rotates continuously like a real carousel
2.Speed controls rotation speed
3.Duration defines frames for one complete rotation
4.Not available for Grid layout
For Grid (manual animation):
1.Apply layout normally
2.Create manual keyframes for:
â˘Entry position
â˘Individual rotation
â˘Scale effects
3.UseÂ
IÂ to insert keyframes
đ Visual Effects
Parallax (3D Effect)
Creates random depth between photos:
â˘Intensity: 0.0-5.0 (recommended: 0.3-1.0)
â˘Seed: Controls random pattern
Manual Rotation
Adjust angles in X, Y, Z:
â˘X: Side tilt
â˘Y: Front tilt
â˘Z: Spin on own axis
â˘Order: Application sequence
â
ď¸Â Advanced Settings
-
ď¸ Advanced Settings
âââ Auto-Center Group: [ ] â Recommended
â
âââ Preserve Individual Scale: [ ] â Maintains proportions
â
âââ Smooth Rotation: [ ] â Smooth animation
â
âââ Debug Info: [ ] â Development only
âââ Preview Mode: [ ] â Quick preview
đŹÂ Practical Examples
Example 1: Animated Carousel
1.10 photos namedÂ
01.jpg toÂ
10.jpg
2.Layout: Carousel (Radius: 6.0)
3.AddÂ
Track To constraint to all
4.Animation: Speed 1.5, Duration 180, Clockwise
5.Parallax: Intensity 0.5
6.Apply Layout
7.Position camera in center
Example 2: Portfolio Grid
1.15 sequential photos
2.Layout: Grid (4 rows, 4 columns)
3.Spacing: 2.5
4.Manual animation:Â Create sequential entry
5.Render as static image
Example 3: Dramatic Ferris Wheel
1.8 vertical photos
2.Layout: Ferris Wheel (Radius: 8.0)
3.Tilt: 15° for dynamic effect
4.Animation: Speed 0.8, Counterclockwise
5.Slow camera movement
ďż˝
� Troubleshooting
Problem: Animations not working
Solution:Â Check if:
⢠â
Layout is Carousel or Ferris Wheel
⢠â
"Enable Animation" option is checked
⢠â
Not using "Grid" layout
Problem: Photos in wrong order
Solution:Â Rename with leading zeros:
bash
Before: 1.jpg, 2.jpg, 10.jpg
After: 01.jpg, 02.jpg, 10.jpg
Problem: Photos not facing camera
Solution:
1.Select all planes
2.AddÂ
Track To constraint
3.Target: Your active camera
4.Configure: To: -Z, Up: Y
Problem: Layout not centered
Solution: Enable "Auto-Center Group"
ďż˝
� Professional Tips
For Videos:
â˘Combine photos and videos in same layout
â˘Videos maintain playback during animations
â˘Adjust scale for different aspect ratios
For Rendering:
1.Circular layouts: Render 360° animation
2.Grid: Use smooth camera movement
3.Experiment with different camera angles
Performance Optimization:
â˘Preview Mode for quick adjustments
â˘Reduce resolution during testing
â˘Use proxies for long videos
đ Quick Reference Table
Parameter
Rows/Columns
Radius
Height
Tilt
Grid Carousel Ferris Wheel
â
â â
â â
â
â â
â
â â
â
Auto Animation â â
Camera Constraint â
â
â
â
ďż˝
� Useful Shortcuts
Action
Open panel
Shortcut RollFlow Panel
N
Open/Close
Select all A "Select All"
Render F12
Insert Keyframe I
For manual animation
đ Recommended Project Structure
text
MyProject/
âââ assets/
â âââ photos/ (01.jpg, 02.jpg...)
â âââ videos/ (optional)
âââ blender/
â âââ rollflow_project.blend
âââ renders/
âââ animation_sequence/
âââ stills/
đ¤Â Support
Online Documentation:Â [Documentation URL]
Report Bugs:Â [Issues URL]
Community:Â [Forum/Social media]
đ Pre-Render Checklist
â˘Photos correctly named (01, 02, 03...)
â˘T
rack To constraints applied
â˘Layout applied and centered
â˘Animation configured (if circular)
â˘Camera positioned
â˘Render settings defined
â
ď¸Â FINAL REMINDER
ROLLFLOW'S AUTOMATIC ANIMATIONS WORK ONLY WITH THESE LAYOUTS:
â˘â
 Carousel - Continuous horizontal rotation
â˘â
 Ferris Wheel - Continuous vertical rotation
â˘â Grid - Requires manual animation
Choose the appropriate layout for your animation needs!
đHave fun creating! RollFlow transforms your photos into memorable 3D
experiences.