CyfrowyNomada/BlenderRetroRipper
Watch
1
0
Fork
You've already forked BlenderRetroRipper
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
6 commits 1 branch 0 tags 51 KiB
  • Python 100%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
CyfrowyNomada 7526df6705 Pass mouse releases outside the region through so Confirm Rip fires (v1.3.1) 
The modal consumed every LEFTMOUSE RELEASE, so sidebar buttons received the
press but never the release and never activated. Releases over UI regions
now pass through.
2026-09-09 18:11:56 +02:00
.gitignore RetroRipper: perspective-rip photo quads into packed textures in the open .blend 2026-09-09 15:14:34 +02:00
__init__.py Pass mouse releases outside the region through so Confirm Rip fires (v1.3.1) 2026-09-09 18:11:56 +02:00
blender_manifest.toml Pass mouse releases outside the region through so Confirm Rip fires (v1.3.1) 2026-09-09 18:11:56 +02:00
pyrightconfig.json RetroRipper: perspective-rip photo quads into packed textures in the open .blend 2026-09-09 15:14:34 +02:00
README.md Close the quad visually, add Confirm Rip button (v1.2.0) 2026-09-09 17:10:10 +02:00
ripper_math.py Convert normalized view coords to image pixels; full-res 1:1 rip (v1.3.0) 2026-09-09 17:56:04 +02:00
test_blender_e2e.py Fix region/canvas bugs, add drag-adjust with live preview (v1.1.0) 2026-09-09 15:38:05 +02:00
test_ripper_math.py Convert normalized view coords to image pixels; full-res 1:1 rip (v1.3.0) 2026-09-09 17:56:04 +02:00

README.md

RetroRipper (BlenderRetroRipper)

PocketRipper's ripping workflow, inside Blender 5.2.

Open a photographed surface in the Image Editor, click its four corners, and RetroRipper straightens the perspective quad into a clean texture — stored as a packed image datablock inside the currently open .blend, not on disk.

Install

Blender 5.2 (or 4.2+): Get Extensions → Install from Disk → select this folder (or a zip of blender_manifest.toml, __init__.py, ripper_math.py).

Use

  1. Image Editor → Image → Open a photo.
  2. Sidebar (N) → RetroRipper → Rip Texture.
  3. Click the four corners of the surface — the 4th click closes the quad and a live preview of the straightened texture appears in the corner. Drag any corner to adjust until it looks right.
  4. Press Confirm Rip in the sidebar (or Enter). Backspace removes a corner, Esc cancels. The result <image>_rip is packed into the .blend — just save the file.

Development

python test_ripper_math.py                                # pure-math self-check
blender --background --python test_blender_e2e.py         # warp+pack+save in Blender
blender --background --python test_blender_e2e.py -- verify  # reopen and verify

Produced by Cyfrowy Nomada.