Baltor Get started

Gallery / Godot components

Shot framing helpers: thirds, safe areas and coverage

In your harnessGodot componentMIT

Check and adjust shot composition: rule-of-thirds points and offsets, action and title safe areas, lead room in front of a subject, screen bounds of 3D points through a Camera3D, and screen coverage.

Files, names only

  • ATTRIBUTION.md
  • LICENSE
  • README.md
  • baltor_test.gd
  • component.json
  • framing_guide.gd
  • inspect_gdscript.py
  • run_tests.gd
  • test_package.py
  • tests/test_framing_guide.gd
  • verification/native.json

Full files in your harness.

What it takes and gives

Class
BaltorFraming, extends RefCounted
Methods
thirds_points(size: Vector2) -> PackedVector2Array; nearest_third_point(point: Vector2, size: Vector2) -> Vector2; safe_area(size: Vector2, fraction: float) -> Rect2; is_inside_safe_area(point: Vector2, size: Vector2, fraction: float) -> bool; offset_to_nearest_third(subject: Vector2, size: Vector2) -> Vector2; lead_room(subject: Vector2, facing: Vector2, size: Vector2) -> float;…
Placement
res://baltor/godot_components/framing_guide/

Limits. Measures and suggests; it does not move cameras. Coverage uses axis-aligned screen rectangles, not silhouettes. Points behind the camera are skipped rather than clipped. Verified with Godot 4.7.2 headless; written against the Godot 4.3 API.

Details

Kind
Godot component
Engine
Godot 4.3 or later
Files
11 files, 76.0 KB
Licence
MIT
Declared effects
reads files, runs commands
Checked with
Godot 4.7.2, headless
Checks
godot parse check only, godot gdscript tests, godot tests reject gutted component, godot editor import, godot contract reflection, godot readme usage compiles
Techniques
rule of thirds, title and action safe areas, perspective projection bounds
Tags
camera, composition, rule of thirds, safe area, cinematics, framing
Identity
library.supply.creative_originals.7ba0f8d3325dab8bd28fb750.a9867e34dc97e8d0
Version
a9867e34dc97e8d06f158553c92f6562d1dfcfc192cdd4ccfee1d17a5fc31aaf

The version is the SHA-256 of the item your harness downloads; every file in it names its own checksum.

Something wrong with this item, its rights or its safety? Report it on the support page, or from your harness after a download.