Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jeinselen/vf-blenderplanaruv

Numerical planar projection of 3D meshes into UV space.
https://github.com/jeinselen/vf-blenderplanaruv

3d blender blender-3d blender-addon blender-plugin blender3d numeric numerical orthographic planar precise projection uv uv-map uv-mapping uvmap uvmapping

Last synced: 3 months ago
JSON representation

Numerical planar projection of 3D meshes into UV space.

Awesome Lists containing this project

README 

        
# VF Planar UV



This add-on was designed for Blender version 2.8-4.1 (though not all previous versions may be fully supported). For Blender 4.2 and onwards, [please see the new Mesh Kit extension](https://github.com/jeinselen/Blender-MeshKit).



Numerical planar projection of 3D meshes into UV space, allowing for accurate and replicable results instead of relying on Blender's "Project From View" (which is either non-repeatable by default or non-customisable in "orthographic" mode).



![screenshot of Blender 3D and UV editor interfaces showing the plugin mapping a standard monkey head with X axis planar projection](images/screenshot0.png)



## Installation and Usage



- Download [VF_planarUV.py](https://raw.githubusercontent.com/jeinselenVF/VF-BlenderPlanarUV/main/VF_planarUV.py)

- Open Blender Preferences and navigate to the "Add-ons" tab

- Install and enable the Add-on

- It will show up in the 3D view `VF Tools` tab



## Settings



![screenshot of Blender 3D and UV editor interfaces showing the plugin mapping half of a standard monkey head with Y axis planar projection mapping rotated 180° and flipped](images/screenshot1.png)



### Main Settings



- `Axis` sets the direction of the planar projection: `X`, `Y`, or `Z`

- `Centre` sets the centre point of the projection space, allowing for any specific location to be mapped

- `Size` defines the scale of the projection, allowing for known numerical translation from object space into UV space

- `Space` sets local or world space for both loading selection settings and generating the UV map



### Advanced Settings



- `Load Selection Settings` calculates the bounding box of all selected vertices and sets the centre and size settings to exactly contain the selection (particularly helpful for mesh elements that aren't centred with the object pivot)

- `Rotation` swizzles the input coordinates to offer 90° variations in mapping orientation (this is akin to rotating a camera capturing the geometry; it efficiently rotates the space the coordinates are loaded in)

- `Flip` takes the resulting UV mapping and flips the U values (this operates before alignment and works reliably with both options below)

- `Alignment` determines how the mesh will be aligned to UV space

  - `Image` is standard UV map usage, where the centre of the defined area will be aligned to 0.5, 0.5 in UV space

  - `Zero` is for situations where standard UV mapping principles may not apply, and the centre of the defined are should align to 0.0, 0.0 in UV space for reliable data storage within a UV map



![screenshot of Blender 3D and UV editor interfaces showing the plugin mapping a standard monkey head with Y axis planar projection mapping aligned to UV 0,0 instead of centred within the UV frame](images/screenshot2.png)



Note that this add-on operates in _**object space,**_ not _**world space.**_ Planar projection settings `centre` and `size` will not take into account the object's position, rotation, or scale in world space.



This software is provided without guarantee or warranty.