User Manual

Composing the shot before you press render.

ProFrame overlays composition guides, platform-accurate crop formats, and a light compositor pipeline directly onto your camera view — built for product photographers and social/e-commerce creators working in Blender.

The ProFrame panel, collapsed by default
The ProFrame panel, collapsed by default
Version 1.0.0 Requires Blender 5.0 or newer Location View3D › Sidebar (N) › ProFrame tab
Setup

Installing ProFrame

  1. 1Open Blender, then go to Edit › Preferences › Add-ons.
  2. 2Click the dropdown in the top-right and choose Install from Disk…, then select proframe.py.
  3. 3Enable the checkbox next to ProFrame in the add-on list.
  4. 4In the 3D Viewport, press N to open the sidebar, then click the ProFrame tab on the right edge.
Before you start: ProFrame needs a Blender Camera in the scene, and the viewport set to Camera view (Numpad 0), to draw anything. Everything in this manual assumes you're looking through a camera.
Orientation

Interface Tour

Every ProFrame feature lives in one collapsible panel, opened and closed section by section so you only see what you're using. The master switch is the ProFrame ON/OFF toggle at the very top — turning it off hides every overlay instantly without losing any of your settings.

Section boxes

Camera, Guides, Platform, Render, Scale Refs, Compositor, Drawing Tool, and more — each is its own collapsible box with a ▶/▼ arrow showing its state. Every section starts collapsed on a fresh scene, so the panel opens clean; click a header to expand it.

"?" help buttons

Every section header has a small ? icon that opens this manual scrolled straight to that section — each link on the left matches one of those buttons exactly.

Active Guide Settings

Turning on a guide adds a compact settings row for it under "Active Guide Settings" — colour swatch, a reset icon, and an expand arrow for opacity/transform/extra controls.

Flash-hide

Hold \ anywhere in the viewport to instantly hide every guide and check the clean shot — see Flash-Hide Hotkey for rebinding it.

Section

Camera

Quick camera controls so you rarely need to leave the viewport:

  • Cam to View — locks the active camera to your current viewport angle, so orbiting the view moves the camera live (same as Blender's own "Lock Camera to View", surfaced here for convenience).
  • Render Region — toggles Blender's render border; Draw lets you drag a new one directly.
  • Set Selected as Camera / the Scene Cameras list — jump between multiple cameras in one click.
  • Direct access to Focal Length, Sensor Width, Clip Start/End, Passepartout, and Depth of Field (focus object/distance, f-stop) without opening the Object Data Properties tab.
Section

Guides

Twenty-one composition guides across seven categories. Click an icon to toggle a guide on — its settings appear below under "Active Guide Settings." Every guide has its own colour, opacity, and transform (rotation, offset, scale, invert), independent of the others.

Guides panel with Per-Camera Guides enabled, and Active Guide Settings showing Thirds set to Dashed and Golden Ratio left on Use Global
Guides section expanded — Per-Camera Guides on, Thirds set to Dashed, Golden Ratio left on Use Global

Line Style

The Line Style dropdown next to Line Width, at the top of the panel, sets a global default — Solid, Dashed, or Dotted — that every guide follows unless overridden. Each guide's own settings (under "Active Guide Settings") have their own Line Style dropdown too, defaulting to Use Global; switch it to Solid/Dashed/Dotted instead to make just that one guide differ — a dotted Custom Grid alongside solid Thirds, for example.

The Drawing Tool and 3D Guidelines both get this same Line Style control.

Per-Camera Guides

By default every camera in the scene shares one guide setup. Turn on Per-Camera Guides (the toggle at the top of this section) to give each camera its own — every guide's on/off state, colour, opacity, transform, and Line Style, stored separately per camera. Switching the active camera automatically swaps in that camera's own guide setup, and a label under the toggle shows which camera you're currently editing.

Guide Presets save and load whichever guide set is currently active — the shared one, or the active camera's own, depending on this toggle.

Categories

▦ Grids & Alignment
ThirdsThe classic rule-of-thirds grid.
Safe ZoneAdjustable inset margin (X/Y%, independently or linked) marking the area safe from UI/crop overlap.
Custom GridConfigurable columns × rows. "Camera Frame" mode fits the camera bounds; "Free 2D" covers the full viewport regardless of camera.
◎ Golden Ratio
Golden RatioThree templates: Lines, Spiral, and Rectangles (with an optional rectangle overlay and a start-corner toggle).
◺ Triangles & Harmony
Triangle A / BDynamic-symmetry triangle guides, mirrored variants.
Harmony A / BBaroque-diagonal harmonic armature lines.
〰 Curves & Lines
S-CurveA flowing S-shaped guide line.
C-ShapeA single sweeping arc.
V-ShapeTwo lines converging toward the bottom.
DiagonalCorner-to-corner cross lines.
✳ Symmetry & Radial
SymmetryVertical / Horizontal / Diagonal / Radial axes, independently toggled; Radial's spoke count is adjustable (2–24).
Circle GuidesConcentric, Thirds-centred, or Golden-centred circles; count and radius adjustable.
CircularA single centred circle.
Center CrossSimple centre crosshair.
◭ Framing Shapes
L-ShapeCorner-framing L guide.
PyramidTriangular framing guide.
⟁ Perspective
1 / 2 / 3-PointSee below — vanishing-point construction guides for architectural and product perspective.

Perspective Guides, in detail

These are the guides most worth understanding fully, since real vanishing points don't behave like the other symmetric overlays.

1-Point

A single vanishing point radiating spokes evenly around the frame's perimeter. VP X / VP Y move the point anywhere (even outside the frame); Lines sets the spoke count (3–32).

2-Point

Two vanishing points sit on a horizon line, deliberately extended beyond the frame edges — that's correct, not a bug: real vanishing points genuinely sit off-camera. Each VP's fan crosses the whole frame to the opposite edge. Horizon, VP Spread, and Lines are all adjustable.

3-Point

The 2-point pair plus a third vanishing point above the frame (fanning to the bottom edge — the "looking up" convention) or, with Below Frame enabled, below it fanning to the top edge ("looking down"). VP3 X and VP3 Distance control its position.

Guide Presets

Save the exact state of every guide — on/off, colour, opacity, transform, and every sub-setting — under a name, and recall it instantly later. Useful for switching between shoot types ("Product Shot," "Portrait Setup") without re-toggling everything by hand.

  • Type a name in the field under Presets and click + to save the current setup.
  • Pick a saved preset from the dropdown, then click the (import) icon to load it, or the trash icon to delete it.
  • Presets are stored per-user (not per-file), so they follow you across every .blend you open.

Built-in presets

PresetWhat it sets up
★ NoneHides every guide and resets all colours/settings to default — a clean slate.
★ Product ShotThirds + Safe Zone.
★ Portrait (Golden Spiral)Golden Ratio, Spiral template.
★ Symmetrical ObjectSymmetry + Center Cross.
★ Instagram SquareThirds + a 3×3 Custom Grid.
Built-in presets (marked ★) can't be deleted — only your own saved presets can.

Export & Import

Click Export (next to the Presets fields) to save every preset you've made to one .json file — handy for backing them up or sharing your setup with someone else. Import loads presets from a file the same way; presets with a matching name are overwritten, everything else is added alongside what you already have. Both buttons are also available in Edit › Preferences › Add-ons › ProFrame, in case that's easier to reach.

Guides panel with Export / Import
Guides panel with Export / Import
Section

3D Guidelines

Unlike the 2D overlays above, this is a real object placed in your scene. Click Add to spawn two small sphere empties (A at the world origin, B offset); move either one in 3D space to define a guide line that projects correctly onto the camera view from any angle. Give each its own colour. Clear All removes every 3D guideline at once, or delete a single one from its list entry.

Each guideline in the list also gets its own Hide toggle (the eye icon) and Line Style button. Hide switches a guideline off without deleting it — its empties stay in the scene, ready to bring back later — and the Style button cycles Use Global → Solid → Dashed → Dotted for that one guideline, independent of every other guide's Line Style.

3D Guidelines list showing two guides — one hidden via the eye icon, the other set to Dashed
3D Guidelines — each guide gets its own Hide toggle and Line Style
Section

3D Grid

A real, camera-facing grid mesh (built with geometry nodes) you can position and scale like any other object. Set columns, rows, width and height before adding; existing grids keep whatever settings they were created with.

Section

Drawing Tool

Freehand annotation directly on the camera view — for sketching a pose, marking a crop, or roughing out a layout before you shoot.

Drawing Tool section with the Line Style dropdown set to Dashed, alongside Color, Alpha and Width
Drawing Tool section — Line Style dropdown alongside Color, Alpha and Width

Tools

Line, Rectangle, Circle, Curve (click points, click again to finish), Freehand.

Snapping

None, Grid (uses your Custom Grid's subdivisions), Thirds, or Frame (corners + centre).

Controls

Colour, opacity, line width, and Line Style per stroke; Undo Last Shape and Clear All.

Toggle Drawing Mode on, then click in the viewport to draw with the selected tool — a cursor circle shows you're active.

The Line Style dropdown (Use Global / Solid / Dashed / Dotted, same as every other guide) seeds the next shape you draw — but since there's no way to select an individual shape afterward, changing it also retroactively restyles every shape already drawn on the current camera. Reach for it to switch your whole sketch from solid to dashed at once, not just what you draw from that point on.

Section

Platform Overlays

Shows exactly what will be cropped, cut off by UI, or safely visible when your image lands on a specific platform. Choose a Mode — Social Media, E-Commerce, or Custom — from the Platform section.

Platform section expanded, Social Media mode
Platform section expanded, Social Media mode

Social Media

11 platforms, 23 formats.

PlatformFormatResolutionAspect
InstagramSquare 1:11080×10801:1
InstagramPortrait 4:51080×13504:5
InstagramStory / Reels1080×19209:16
TikTokFeed1080×19209:16
YouTubeThumbnail 16:91920×108016:9
YouTubeShorts 9:161080×19209:16
YouTubeChannel Banner2560×144016:9
YouTubeCommunity Post1200×12001:1
PinterestPin 2:31000×15002:3
FacebookPost 1.91:11200×6301.91:1
FacebookStory 9:161080×19209:16
FacebookCover Photo820×3122.63:1
LinkedInPost 1.91:11200×6281.91:1
LinkedInProfile Banner1584×3964:1
LinkedInCompany Banner1128×1915.9:1
Twitter / XPost 16:91200×67516:9
Twitter / XHeader1500×5003:1
SnapchatStory / Ad1080×19209:16
ThreadsPost 4:51080×13504:5
DiscordServer Banner960×54016:9
DiscordServer Icon512×5121:1
TwitchChannel Banner1200×4802.5:1
TwitchClip Thumbnail1280×72016:9

Each format also carries its own safe-zone/headroom margins — shown as a dashed inner box so you can see what stays clear of UI overlap before you export. (YouTube's Channel Banner uses the platform's real "safe area" spec — the box shows exactly what survives cropping on TV, desktop, and mobile.)

E-Commerce

3 platforms, 15 formats.

ShopFormatResolutionAspect
AmazonMain Product2000×20001:1
AmazonSwatch1000×10001:1
AmazonA+ Hero1464×600122:50
AmazonA+ 3-Module300×3001:1
AmazonA+ Feature300×4003:4
AmazonStorefront Hero3000×6005:1
AmazonBrand Story1080×10801:1
ShopifyProduct2048×20481:1
ShopifySlideshow Hero1200×4003:1
ShopifyBlog Featured1200×6301.91:1
ShopifyLogo512×5121:1
EtsyListing Primary2000×20001:1
EtsyShop Banner1600×2131600:213
EtsyShop Icon500×5001:1
EtsyAd Campaign1200×12001:1

A Official Guidelines button links straight to each platform's own image-spec page.

Custom Formats

Any format not listed above — set Platform Mode to Custom, then:

  1. 1Enter a Name, Width, Height, Safe Margin %, and Headroom %.
  2. 2Click Save — it's added to the dropdown above and drawn as a distinct violet overlay.
  3. 3Select any saved format from the dropdown to switch to it instantly; Delete Selected removes it.

Advanced Margins

By default, Safe Margin % applies to both top and bottom, and Headroom % to both left and right. Toggle Advanced Margins to set all four edges independently instead — useful when a platform's real UI isn't symmetric (a bottom navigation bar taller than the top status bar, for example). Whatever you're editing updates the viewport overlay immediately, whether or not the format has been saved yet; Save just persists the current live values under a name.

Custom Format with Advanced Margins
Custom Format with Advanced Margins

The same Export / Import pattern as Guide Presets applies here — one .json file holds every custom format you've saved, shareable or backed up the same way, and also reachable from Add-on Preferences.

Custom formats are stored per-user, the same way presets are, so they persist across projects.

Reference Layout

Drop in a screenshot of the real app UI you're targeting — Instagram's post composer, a client's storefront, whatever the shot needs to sit inside — as a reference overlay on the camera itself, so you can compose against exactly how it'll look once it lands there. This is Blender's own camera background-image system; ProFrame just surfaces Scale, Rotation, Offset, and Opacity directly in the panel instead of Object Data Properties.

Reference Layout loaded and adjusted
Reference Layout loaded and adjusted
Viewport shading: the reference image only draws in Solid or Material Preview shading — Blender's Rendered (Cycles/EEVEE) viewport doesn't composite camera background images the same way. Compose against it in Solid, then switch to Rendered for the final look.

Remove clears both the image and Blender's background-image toggle in one click, so it won't linger visibly in the viewport after you're done with it.

Section

Render Settings

Common render setup in one place, applied directly to the scene: Focal Length presets (24/35/50/85/135mm), Resolution presets (from HD up through 8K, plus vertical/square/Amazon/Shopify presets), Frame Rate, and output Format (PNG, JPEG, WebP, EXR, TIFF).

Section

Scale References

Drop a correctly-proportioned silhouette into the scene so viewers get an instant sense of real-world scale next to your product:

ReferenceReal-world size
Human1.75 m
Hand18 cm
Coin25 mm

Clear Refs removes every scale reference at once.

Section

Export Guidelines

Exports exactly what's visible in camera view — guide overlays and all — as a standalone image, without needing a full scene render. Set an Output Path, choose Format (PNG/JPEG/WebP) and whether resolution should Match Render Settings or use a Custom width/height, then click Export.

ProFrame renders this internally using either Pillow (if installed) or a built-in numpy fallback — either way, the output looks identical; the fallback just means no extra install step is required.
Section

Compositor

A light post-processing pipeline built from Blender's own compositor nodes — automatically wired up behind the scenes when you click any of the buttons below. Requires Use Nodes enabled in a Compositing workspace (ProFrame will prompt you if it isn't).

Compositor section expanded
Compositor section expanded

Quick Filters & Custom LUT

30 built-in color-grade presets, grouped below by character. Pick one from the dropdown and click Apply Filter.

FilterCharacter
WarmBrighter, warmer highlights and shadows
CoolBlue-leaning shadows and highlights
FadeLifted blacks, reduced contrast — washed look
MatteCrushed contrast, slightly desaturated
VibrantPunched-up brightness, contrast and saturation
B&WFully desaturated
Teal & OrangeCyan shadows, warm-orange highlights — cinematic grade
Bleach BypassHeavy desaturation, high contrast — skip-bleach film look
Vintage FilmFaded contrast, warm sepia-leaning tone
CinematicCool shadows, warm highlights, mild desaturation
Cross ProcessGreen shadows, yellow highlights, high contrast
Golden HourWarm golden cast, soft contrast lift
Day for NightBlue-tinted, darkened, desaturated — day-for-night film technique
CyberpunkMagenta shadows, cyan highlights, high saturation
SepiaClassic warm brown monochrome tint
NoirHigh-contrast black & white, deep blacks
PastelSoft, light, low contrast, desaturated
PolaroidFaded, warm-yellow cast, lifted blacks
KodachromePunchy saturated reds/yellows, classic film look
ArcticStrong cool-blue cast, clean highlights
DesertWarm sandy tones, orange/yellow cast
Moody BlueDark, blue-shadow heavy, desaturated
High KeyBright, low contrast, lifted shadows — airy
Low KeyDark, high contrast, crushed shadows — dramatic
AutumnWarm orange/red cast, boosted saturation
ForestGreen-tinted shadows, natural earthy highlights
Rose GoldPink-warm highlights, soft glow
SteelCool grey-blue, desaturated, industrial
SunsetWarm orange highlights, magenta-leaning shadows
DreamyVery low contrast, lifted blacks, soft glow

Filters and a Custom LUT (a .cube file, with adjustable strength) are mutually exclusive — applying one clears the other. Guide Overlay bakes your current guides into the compositor as a static image layer, useful for a final render that includes them.

Watermark

Two modes, switchable at any time:

  • Image — load a PNG/logo file.
  • Text — type a string directly (e.g. © Your Studio); rendered with your chosen font size and colour, no external image needed.

Both share Position (9-point grid: corners, edges, centre), Scale, and Opacity — all of which update live as you drag them, no need to re-click Add. Position is calculated from the watermark's actual rendered size, so it always stays fully inside the frame regardless of text length or scale.

The small ↩ button next to Add / Remove resets position, scale, opacity, font size and colour back to defaults — without touching your chosen type or content.

Section

Flash-Hide Hotkey

Hold \ anywhere in the 3D Viewport to instantly hide every guide overlay — release to bring them back exactly as they were. Useful for checking the clean shot without losing your setup.

To use a different key: go to Edit › Preferences › Add-ons › ProFrame, click the key field under Flash Hide Guides Hotkey, then press whatever key (with any modifiers) you'd rather use.

Help

Frequently Asked Questions

Nothing is drawing in my viewport — why?

Three things ProFrame needs: a Camera object in the scene, the viewport set to Camera view (Numpad 0), and the ProFrame ON toggle at the top of the panel switched on. Also check that the specific guide you expect is actually enabled under Guides.

My 2-point/3-point perspective lines run off the edge of the viewport — is that a bug?

No — that's correct. Real vanishing points genuinely sit outside the visible frame; that's the whole reason they're called "vanishing." You can pull them closer with the VP Spread slider if you want a tighter view.

Where are my presets and custom platform formats stored?

In your Blender user config folder, not inside the .blend file — so they follow you between projects. That also means they don't travel with the file if you send it to someone else; they'd need ProFrame installed with their own presets.

The Compositor section says "Open Compositing workspace first" — what do I do?

Switch to the Compositing workspace tab at the top of Blender, enable Use Nodes, then come back and click the button again (or use Enable Compositor Nodes directly in the panel).

Can I use ProFrame's guides without a camera, just in the regular viewport?

Not currently — every guide is drawn relative to the active camera's frame, so you'll need to be in Camera view. The one exception is the Custom Grid's "Free 2D" mode, which covers the full viewport regardless of camera.

Does exporting guidelines require Pillow (PIL) installed?

No. ProFrame checks for Pillow and uses it if present, but falls back to a built-in numpy-based renderer automatically — the output is visually identical either way.