Skip to content

btitkin/UVfromView

Repository files navigation

UVfromView

UVfromView is a Blender 4.2+ add-on for automatic UV projection from global-axis and multi-axis view directions, aimed at hard-surface artists using tileable textures and trimsheet workflows.

It matters when a model needs quick, consistent UV projection with texel-density controls rather than hand-built UVs for every face.

Preview

Screenshots / GIF demo coming soon.

The repository includes a technical PDF generated from technical_documentation.tex, but no UI screenshot or usage GIF yet.

Features

  • Single-file Blender add-on: UVfromView.py.
  • Blender 4.2+ metadata in bl_info.
  • Angle-based face clustering.
  • 6-axis, 12-axis and 32-axis projection modes.
  • Global-axis aligned projection matrix logic.
  • Target texel-density and texture-size controls.
  • Optional grid layout for UV islands.
  • Optional auto-rotation for narrow faces.
  • N-panel UI under View3D > N-Panel > Auto UV.
  • Technical documentation source in LaTeX.

Installation

  1. Download or clone this repository.
  2. In Blender, open Edit > Preferences > Add-ons.
  3. Click Install....
  4. Select UVfromView.py.
  5. Enable the add-on.

Installation instructions are based on the current repository structure and should be verified in Blender 4.2+.

Quick Start

  1. Select a mesh object.
  2. Enter Edit Mode.
  3. Open the N-panel with N.
  4. Go to the Auto UV tab.
  5. Choose a projection mode and texel-density settings.
  6. Run Auto Map Entire Model.

Examples / Use Cases

  • Quick UV projection for hard-surface blockouts.
  • Tileable material UVs aligned to global axes.
  • Trimsheet preparation where consistent texel density matters.
  • Early environment-art prototyping before detailed manual UV cleanup.

Roadmap

  • Add screenshots or a short Blender usage GIF.
  • Add a root license file.
  • Add a packaged release ZIP for Blender installation.
  • Add example meshes or before/after UV captures.
  • Verify behavior across Blender point releases.

Status

Experimental: the repository currently contains a single Blender add-on file and technical documentation, but no automated tests, packaged release or visual examples.

License

No license file is currently present. Reuse terms should be clarified before depending on this add-on in shared or commercial workflows.

About

Utility for generating or working with UVs from camera/view-based projection workflows.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Packages

 
 
 

Contributors