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

Creates location keyframes for selected items based on vertices from a source mesh.
https://github.com/jeinselen/vf-blendervertexlocationkeyframes

3d 3d-animation animation blender blender-3d blender3d location object-position physics position vertex

Last synced: 2 months ago
JSON representation

Creates location keyframes for selected items based on vertices from a source mesh.

• Host: GitHub
• URL: https://github.com/jeinselen/vf-blendervertexlocationkeyframes
• Owner: jeinselen
• License: gpl-3.0
• Created: 2021-07-09T14:46:45.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2023-08-25T21:54:53.000Z (almost 2 years ago)
• Last Synced: 2025-04-22T23:06:59.334Z (2 months ago)
• Topics: 3d, 3d-animation, animation, blender, blender-3d, blender3d, location, object-position, physics, position, vertex
• Language: Python
• Homepage:
• Size: 1.79 MB
• Stars: 9
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# VF Vertex Location Keyframes

Creates location keyframes for selected items based on vertices from a source mesh.

![a collection of spheres animate into the outlines of different shapes](images/promo.gif)

## Installation and Usage

- Download, install, and activate [VF_vertexLocationKeyframes.py](https://raw.githubusercontent.com/jeinselenVF/VF-BlenderVertexLocationKeyframes/main/VF_vertexLocationKeyframes.py)

- In object mode, select the target items

  - These can be items of any type, including empties, meshes, and lights

- Set the source mesh as the active object

  - This _must_ be a mesh object containing one or more vertices

  - The number of selected objects and the number of source mesh vertices should typically match, but the add-on will always work with the smaller of the two numbers

- Customise settings as needed, including frame offset

  - See the list of settings below for more details

- Navigate to the point in the timeline where you want the keyframes to start

- Click "Create Keyframes"

- Repeat as needed to build the entire animation sequence

If the order of the vertices isn't working for you, try re-sorting them using one of the available commands (while in edit mode) found in the `Mesh > Sort Elements` menu.

![screenshot of the add-on interface in Blender](images/screenshot.png)

## Settings

- `Location X` toggles keyframing for the target item X channel (uncheck this if you want to preserve an existing location value)

- `Location Y` toggles keyframing for the target item Y channel (uncheck this if you want to preserve an existing location value)

- `Location Z` toggles keyframing for the target item Z channel (uncheck this if you want to preserve an existing location value)

- `World Space` determines if the vertex locations are relative to the source mesh object or to world space

- `Shuffle Order` randomises the order that target items are associated with source vertices

  - This can create a much more chaotic animation (see the examples below)

- `Shuffle Timing` randomises the sequence in which the target items animate

  - This can create more ordered chaos (see the examples below)

- `Frame Offset` increments the keyframe position of each item, starting at the current frame

  - Example: to create sequential keyframes for 4 items over a duration of 30 frames, this offset should be set to `10`

- The feedback box will show how many vertices are in the source mesh and how many target items are selected

- `Create Keyframes` will generate keyframes in the selected channels of all selected target items starting at the current frame

## Examples

### Frame Offset

![four spheres animate between left and right sides with no timing offset](images/example1.gif)

With `Frame Offset` set to 0, the keyframes will all be set on the same frame.

![four spheres animate between left and right sides with a 5 frame timing offset between each one](images/example2.gif)

With `Frame Offset` set to 5, each keyframe will be set 5 frames later than the previous.

### Shuffle Order

![four spheres animate between left and right sides with randomised target locations](images/example3.gif)

To create hold keyframes in a particular arrangement, keyframes must be duplicated in the timeline. Creating new keyframes from the same source mesh will result in a differently randomised order each time.

### Shuffle Timing

![four spheres animate between left and right sides with randomised start and stop times](images/example4.gif)

This can give a feeling of randomisation while still maintaining the reliability of known pairings between items and vertices. Note that it will also randomise the timing when transitioning from one set of vertex locations to another, since the timing order changes each time keyframes are generated (the elements will move at different speeds because their start and end keyframes aren't in the same sequential order).

### Paired with physics simulation

![four spheres animate between left and right sides with randomised target locations and physically simulated interactions](images/example5.gif)

As demonstrated at the top, this is the intended purpose of the add-on; to help simplify a slightly complicated workflow. Though animating a source mesh using mesh keys while attaching target items with vertex groups works, it doesn't support sequential vertex delays and randomisation. This add-on is a plausible solution when forming shape arrays out of physically simulated objects.

In this case, the target items are passive rigid body objects with animation enabled, and the rendered objects are active rigid bodies, with each pair attached using spring constraints. Download the demo file to try it out for yourself.

[demo.blend](images/demo.blend)