Home
Creating a Floating Animation with Blender 3D in Python

Creating a Floating Animation with Blender 3D in Python

February 10, 2025 HomeFurnishings

Creating a Floating Animation with Blender 3D in Python

Blender, an open-source 3D creation software, offers extensive possibilities for scripting and automation. This tutorial will guide you through creating a floating animation effect using Python within Blender 3D. By the end, you'll have a dynamic 3D scene with randomly placed objects that move in a sine wave motion along the z-axis.

Overview of the Script

The script is designed to create a 3D scene with randomly generated objects (spheres, cubes, and cylinders) and animate them with a sine wave motion. This is achieved using Blender's Python API (bpy) and essential Python modules (random and math).

Step-by-Step Guide

Step 1: Imports and Constants

First, we import necessary modules and define constants for the scene.

import bpyimport randomimport math# List of object types to generateobject_types  ['SPHERE', 'CUBE', 'CYLINDER']# Number of objects to generatenum_objects  10# Range of x and y coordinates to randomly generate objectsx_range  -10, 10y_range  -10, 10# Range of object scalescale_range  0.5, 1.5# List of material colorscolors  [{'name': 'red', 'color': (1.0, 0.0, 0.0, 1.0)},          {'name': 'green', 'color': (0.0, 1.0, 0.0, 1.0)},          {'name': 'blue', 'color': (0.0, 0.0, 1.0, 1.0)},          {'name': 'yellow', 'color': (1.0, 1.0, 0.0, 1.0)},          {'name': 'magenta', 'color': (1.0, 0.0, 1.0, 1.0)},          {'name': 'cyan', 'color': (0.0, 1.0, 1.0, 1.0)}]

Step 2: Object Generation and Animation

We then loop through the required number of objects to create them randomly in the scene. Each object is assigned a random type, position, scale, and color. Animation keyframes are added to create the floating effect.

Generate Random Values: 
for i in range(num_objects):
    x  random.uniform(x_range[0], x_range[1])
    y  random.uniform(y_range[0], y_range[1])
Generate Random Object Type: 
    obj_type  (object_types)
Create Object and Set Position and Scale: 
    if obj_type  'SPHERE':
        _uv_sphere_add(location(x, y, 0))
    elif obj_type  'CUBE':
        _cube_add(location(x, y, 0))
    elif obj_type  'CYLINDER':
        _cylinder_add(location(x, y, 0))
    obj  
      (random.uniform(scale_range[0], scale_range[1]),
                 random.uniform(scale_range[0], scale_range[1]),
                 random.uniform(scale_range[0], scale_range[1]))
Assign Random Material: 
    mat  (name"CustomMaterial_{}".format(i))
    (mat)
    mat.diffuse_color  (colors)['color']
Add Animation Keyframes: 
    num_frames  60
    z_offset  random.uniform(-1, 1)
    for frame in range(num_frames):
        z  frame / num_frames * math.pi * z_offset
        _set(frame)
        obj.location[2]  z
        _insert(data_path"location", index-1, frameframe)
        _insert(data_path"location", index-1, frameframe   1)

Explanation of the Animation

The sine wave motion along the z-axis is controlled by the calculation:

z frame / num_frames * math.pi * z_offset

This formula ensures that the objects oscillate up and down smoothly, giving the appearance of floating or bouncing gently in the scene.

Conclusion

This script provides a detailed process for creating a floating animation within Blender 3D using Python. By understanding the key steps, you can customize the script and apply similar techniques to create more complex and engaging animations. Whether you're a beginner in Blender or an experienced user looking to automate workflows, this tutorial will be a valuable resource.

Key Takeaways

Random Object Generation: Using the random module to generate objects with varying shapes, sizes, and colors. Python Scripting in Blender: Writing Python scripts to automate 3D modeling tasks and create complex animations. Sine Wave Motion: Implementing a sine wave to create a realistic floating effect.

Related Posts