Add Lattice Magic to Addons #48

Merged
Nick Alberelli merged 36 commits from feature/lattice_magic into main 2023-05-17 20:48:52 +02:00
Showing only changes of commit 0fcb5fe2d5 - Show all commits

View File

@ -3,10 +3,11 @@ This addon adds some Lattice-based utilities to Blender.
Install like any other Blender addon: Download this repository as a .zip archive, then in Blender go to Edit->Preferences->Addons->Install Addon from File, and browse the zip you downloaded, and enable the checkbox for the addon. Install like any other Blender addon: Download this repository as a .zip archive, then in Blender go to Edit->Preferences->Addons->Install Addon from File, and browse the zip you downloaded, and enable the checkbox for the addon.
After that, you can find the Lattice Magic panel in the 3D Viewport's Sidebar, which you can bring up by pressing the N key. After that, you can find the Lattice Magic panel in the 3D Viewport's Sidebar, which you can bring up by pressing the N key.
![](docs/lattice_magic.png) ![](docs/lattice_magic.png)
# Tweak Lattice # Tweak Lattice
Tweak Lattice lets you create a lattice setup at the 3D cursor to make deformation adjustments to the selected objects. Tweak Lattice lets you create a lattice setup at the 3D cursor to make deformation adjustments to the selected objects.
![](docs/tweak_lattice.gif) ![](docs/tweak_lattice.gif)
@ -35,22 +36,27 @@ Camera Lattice lets you create a lattice in a camera's view frame and deform a c
### Creation ### Creation
At first the Camera Lattice UI just shows an empty list. You can add an entry with the + icon. Each entry corresponds to deforming a single collection with a single lattice object from the perspective of a single camera. At first the Camera Lattice UI just shows an empty list. You can add an entry with the + icon. Each entry corresponds to deforming a single collection with a single lattice object from the perspective of a single camera.
You must select a collection and a camera, then hit Generate Lattice. Note that you cannot change the resolution after the fact, so find a resolution that you're happy with, as you will be locked into that. You must select a collection and a camera, then hit Generate Lattice. Note that you cannot change the resolution after the fact, so find a resolution that you're happy with, as you will be locked into that.
### Parenting
Although on creation, the lattice is parented to the camera, you can feel free to remove or change this parenting to your heart's desire, it shouldn't cause any issues. The lattice object also has a Damped Track constraint, the same applies there: You can remove it if you want.
### Animation ### Animation
Animating the lattice is possible using shape keys. The addon provides some UI and helper operators for this, but at the end of the day it's up to you how you organize and keyframe these shape keys. Feel free to animate the lattice in object mode as you wish, although unless the above mentioned Damped Track constraint is enabled, you will only be able to rotate it on one axis.
Animating the lattice's vertices is possible using shape keys. The addon provides some UI and helper operators for this, but at the end of the day it's up to you how you organize and keyframe these shape keys.
The intended workflow is that a shape key should only be active for a single frame. To help with this, shape keys are named when they are added, according to the current frame. There are also some buttons above the list: The intended workflow is that a shape key should only be active for a single frame. To help with this, shape keys are named when they are added, according to the current frame. There are also some buttons above the list:
- Zero All Shape Keys: Operator to set all shape key values to 0.0. This does not insert a keyframe! - Zero All Shape Keys: Operator to set all shape key values to 0.0. This does not insert a keyframe!
- Keyframe All Shape Keys: Operator to inserts a keyframe for all shape keys on the current frame with their current value. - Keyframe All Shape Keys: Operator to inserts a keyframe for all shape keys on the current frame with their current value.
- Update Active Shape key: Toggle to automatically change the active shape key based on the current frame. - Update Active Shape key: Toggle to automatically change the active shape key based on the current frame.
### Deletion ### Deletion
Similar to Tweak Lattice, never ever delete a lattice setup the usual way by simply pressing the X or Del keys, as this will leave behind a huge mess that Blender won't be happy about. Instead use the various ways of deletion in the addon's own UI: The "Delete Lattice" button, or the "-" (minus) button in the top list. Similar to Tweak Lattice, never ever delete a lattice setup the usual way by simply pressing the X or Del keys, as this will leave behind a huge mess that Blender won't be happy about. Instead use the various ways of deletion in the addon's own UI: The "Delete Lattice" button, or the "-" (minus) button in the top list.
Note: If you want to delete a lattice, make sure to do it through the addon's UI, which is in the sidebar. This will make sure to delete all modifiers, drivers and animation datablocks that were created along with the lattice. Note: If you want to delete a lattice, make sure to do it through the addon's UI, which is in the sidebar. This will make sure to delete all modifiers, drivers and animation datablocks that were created along with the lattice.
### TODO ### TODO
Some things not implemented yet: Some things not implemented yet:
- Automatically inserting new shape key in the correct place in the list. Eg., when Frame 1 and Frame 10 already exist, creating a shape key on Frame 5 should insert it in between them. - Automatically inserting new shape key in the correct place in the list. Eg., when Frame 1 and Frame 10 already exist, creating a shape key on Frame 5 should insert it in between them.
- Adding or removing objects to the influence of the lattice is not currently possible. - Adding or removing objects to the influence of the lattice is not currently possible.