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

Snaps vertices to custom per-axis increments.
https://github.com/jeinselen/vf-blendervertexquantize

3d 3d-modelling blender blender-3d blender-addon blender-plugin blender3d grid increment quantise snap vertex

Last synced: about 1 year ago
JSON representation

Snaps vertices to custom per-axis increments.

• Host: GitHub
• URL: https://github.com/jeinselen/vf-blendervertexquantize
• Owner: jeinselen
• License: gpl-3.0
• Created: 2022-04-26T00:29:29.000Z (about 4 years ago)
• Default Branch: main
• Last Pushed: 2024-07-16T00:58:37.000Z (almost 2 years ago)
• Last Synced: 2025-04-22T23:06:59.393Z (about 1 year ago)
• Topics: 3d, 3d-modelling, blender, blender-3d, blender-addon, blender-plugin, blender3d, grid, increment, quantise, snap, vertex
• Language: Python
• Homepage:
• Size: 39.1 KB
• Stars: 4
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# VF Vertex Quantize

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).

Snaps vertices to custom per-axis increments, for when Blender's grid snap isn't granular enough. Quantization can be applied outside of edit mode so long as vertices within the active object are selected.

![screenshot of the Blender 3D view interface with the add-on installed, showing the uniform dimensions option enabled](images/uniform.png)

## Installation and Usage

- Download [VF_vertexQuantize.py](https://raw.githubusercontent.com/jeinselenVF/VF-BlenderVertexQuantize/main/VF_vertexQuantize.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

- Default keyboard shortcut is `Shift + Q`

## Settings

![screenshot of the Blender 3D view interface with the add-on installed, showing the uniform dimensions option enabled](images/nonuniform.png)

- `Uniform Dimensions`

	- Switches between uniform and non-uniform dimensions

- `Uniform Value`

	- When uniform is enabled, this defines the quantization grid (this periodic distances vertices will be snapped to)

- `XYZ Values`

	- When uniform is disabled, three input fields define the quantization steps for each axis individually

- `Vertex Quantize`

	- Click this to snap vertices to the closest defined increments

## Known Limitations

- Does not work on objects with shape keys

- When multiple objects are selected, only the _active_ selected object is affected (does not support batch processing multiple models)

- Removing the shortcut key will prevent adding a new one later using the Blender UI (this may be a limitation of the Blender Python API, seems like plugin classes cannot have keyboard shortcuts added by default)