OFFICIAL USER MANUAL • v1.0.0
IMAGE TO MESH PRO
1-Click PNG, Logo & Clipboard to 3D Mesh • 60 FPS GPU Viewport HUD
Compatible with Blender 4.2 LTS, 4.3, 5.0 & 5.1+ • Created by JESUS / JUSTVFX
1. Installation Guide (30 Seconds)
- Download
image_to_mesh_pro_1.0.0.zip from your Blender Market downloads page (do not unzip the file). - Open Blender (4.2 LTS, 5.0, or 5.1+) and go to Edit → Preferences → Add-ons (or Get Extensions).
- Click the top-right dropdown arrow (∨) and select Install from Disk...
- Select
image_to_mesh_pro_1.0.0.zip and enable the checkbox next to Image to Mesh Pro. - Your new objects will automatically organize inside a dedicated ImageToMesh collection in the Outliner.
2. Quick Start: 3 Ways to Convert Any Image to 3D
⚡ Method A: Instant Clipboard Paste
Right-click any PNG, logo, or image in your web browser, Discord, or image viewer and click Copy Image. Inside Blender's 3D Viewport, press Ctrl + Shift + V to launch the live 3D studio immediately.
📁 Method B: N-Panel Studio Tab
Press N in the 3D Viewport to open the Sidebar and click the ImageToMesh tab. Choose Paste Image from Clipboard or Load Image File (PNG / JPG / WEBP / BMP).
➕ Method C: Shift + A Add Menu
Press Shift + A in the 3D Viewport → Mesh → Image to Mesh Pro to quickly import from clipboard or browse local disk files.
3. Interactive 60 FPS GPU HUD Controls
Once an image is loaded, the non-blocking OpenGL GPU Studio Dock appears at the bottom of your 3D Viewport. You can freely orbit, pan, and zoom the 3D Viewport using your standard Blender navigation while sculpting the mesh in real time:
🧊 3 Sculpting Modes (Keys 1 / 2 / 3)
• Solid 3D (1): Watertight extruded 3D geometry with separate Front & Side materials.
• Outline (2): Choose between ◯ Neon Tube (emissive 3D pipe), ▭ Flat Frame (extruded ribbon border), or ☡ Pure Wire (1D polyline loop).
• Stamp (3): Generates a solid backing base plate ideal for 3D printing, cookie cutters, medallions, and badges.
🎯 Outer Contour vs Full Cut (Key C)
• Full Cut (All Holes): Cuts both the exterior background and internal transparent/white holes.
• Outer Contour Only: Traces only the external silhouette boundary so white interior details (eyes, text, inner logo rings) stay 100% solid and intact!
📐 Planar CAD vs Curved Bézier (Key D)
• Low-Poly CAD: Collinear vertex decimation removes up to 85% of redundant vertices along straight edges while keeping corners razor-sharp.
• Curved Bézier: High-resolution organic spline smoothing for curved illustrations and calligraphy.
🎨 Live Material & 1:1 Photo UV (Key T)
• 🖼 Photo Texture (T): Projects the original image onto the front cap with automatic 1:1 UV alignment.
• 💧 2D Eyedropper & RGB Bar: Pick colors directly from the 2D Cutout preview or drag the RGB Spectrum & Brightness bars for Front and Side slots.
4. Interactive Keyboard Shortcuts Reference
| Shortcut / Action | Control Name | Function Description |
| Ctrl + Shift + V | Quick Clipboard Paste | Launches Image to Mesh Pro directly from system clipboard image. |
| 1 / 2 / 3 | Sculpting Mode | Switch between Solid 3D (1), Outline (2), and Stamp Base (3). |
| C | Boundary Cut Mode | Toggle between Full Cut (All Holes) and Outer Contour Only. |
| D | Fidelity Mode | Toggle between Low-Poly CAD and Curved Bézier smoothing. |
| R | Output Object Type | Toggle between Clean Mesh and editable Blender Vector Curve. |
| M | Background Mask Mode | Cycle between Auto Alpha, Color Flood-Fill, and B&W Stencil. |
| I | Invert Cutout | Invert positive/negative mask regions for stencil cutouts. |
| O | Mesh Orientation | Toggle between Standing Front (Z-Up) and Flat on Floor. |
| T | 1:1 Photo Texture | Project original image texture onto the front face with auto-UVs. |
| H | Hide / Show HUD | Collapse or expand the bottom GPU HUD dock to inspect the viewport. |
| L | Language Switcher | Cycle through 7 native languages (EN, ES, ZH, JA, KO, DE, FR) live. |
| Space / Enter | Confirm & Bake 3D Mesh | Finalizes the 3D object, applies materials/UVs, and exits modal mode. |
| Esc / Right-Click | Cancel Session | Cancels the session and cleans up temporary preview data. |
5. Troubleshooting & Pro Tips
• My logo has white interior parts (like eyes or inner rings) that are getting cut out as holes. How do I keep them solid?
Press C (or click Outer Contour (C) in the HUD). This switches the engine to trace only the outer silhouette boundary, keeping all interior details 100% solid.
• How do I create a flat 2D decal or sticker with zero extrusion thickness?
Drag the Thickness (Z) slider all the way to 0.00m (Flat) and enable 🖼 Photo (T). The addon will generate a single-sided planar mesh cut to the exact silhouette of your image.
• Does it require any external Python libraries (like OpenCV or Pillow)?
No! Image to Mesh Pro is 100% self-contained and uses zero external dependencies. It installs and runs out of the box on Windows, macOS, and Linux.
Need help or feature requests? Contact JESUS / JUSTVFX directly via Blender Market support messages.