Blender (software): Difference between revisions

From David's Wiki
Line 81: Line 81:
# Add material to an object
# Add material to an object
my_object.data.materials.append(my_material)
my_object.data.materials.append(my_material)
</syntaxhighlight>
====Images====
<syntaxhighlight lang="python">
# Add an image
image_bpy = bpy.data.images.new("my_image", width=width, height=height, alpha=(channels==4), float_buffer=False)
image_bpy.pixels = image_np.ravel()
my_material.node_tree.links.new(image_bpy.outputs['Color'], my_bsdf.inputs['Base Color'])
</syntaxhighlight>
</syntaxhighlight>



Revision as of 16:53, 7 February 2022

Blender is an open-source 3D modelling software.
It can be used for creating 3D models for games, creating 2D/3D animations, and even creating video games.

Getting Started

Installation

Windows

Direct Download
From chocolatey:

choco install blender
Ubuntu

Blender is available on the Snap store

sudo snap install blender --classic

Modelling

Geometry Nodes

Blender Manual Geometry Nodes

Geometry nodes allow you to procedurally modify the geometry of the object.
Some things it can do include instancing of objects, moving vertices, and arithmetic.
Note that Geometry nodes are available in Blender 2.92+ with some nodes introduced in 2.93 LTS.

See some references:

Animations

Rendering and Compositing

Press <key>F12</key> to render.

Denoising

  1. In the view layer properties, check Denoising Data
  2. Switch to the compositor layout.
  3. Add a denoise node, under filter.
  4. Attach the denoising normal, denoising albedo, and denoising depth.

Scripting

Blender Python API

Getting Started

Blender supports scripting as an alternative means of interaction. Most things are available in the bpy module.

See one of the following resources to get started:

Meshes

vertices = [(-1, -1, 0), (1, -1, 0),
            (-1, 1, 0), (1, 1, 0)]
edges = [(0,1), (1,2), (2,3), (3,0)]
faces = [(0,1,2), (1,2,3)]
uvs = [(0, 0), (1, 0),
       (0, 1), (1, 1)]

# Create a new mesh
new_mesh = bpy.data.meshes.new(mesh_name)
new_mesh.from_pydata(vertices, edges, faces)
new_mesh.update()

# Add UVs
uv_layer = new_mesh.uv_layers.new()
for face in new_mesh.polygons:
  for vert_idx, loop_idx in zip(face.vertices, face.loop_indices):
    uv_layer.data[loop_idx].uv = uvs[vert_idx]

Materials

# Create a new material
my_material = bpy.data.materials.new("My New Material")
my_material.use_nodes = True

# Add material to an object
my_object.data.materials.append(my_material)

Images

# Add an image
image_bpy = bpy.data.images.new("my_image", width=width, height=height, alpha=(channels==4), float_buffer=False)
image_bpy.pixels = image_np.ravel()
my_material.node_tree.links.new(image_bpy.outputs['Color'], my_bsdf.inputs['Base Color'])

Saving scripts outside

See using external ide and run external scripts.

By default, everything is stored in the .blend file including your custom scripts. If you want to store your scripts outside or use another IDE, you will need to have the script inside Blender call the script outside:

import bpy
filepath = bpy.path.abspath("//myscript.py")
exec(compile(open(filepath).read(), filename, 'exec'))

Rendering

def render_to_file(filepath, width, height):
    # Set device to GPU
    bpy.context.scene.cycles.device = "GPU"
    # Set resolution
    bpy.context.scene.render.resolution_x = width
    bpy.context.scene.render.resolution_y = height
    bpy.context.scene.render.resolution_percentage = 100
    # Set output file path
    bpy.context.scene.render.filepath = filepath
    # Do render
    bpy.ops.render.render(write_still=True)

MVP matrices

Example python code

# Model matrix
my_object.matrix_world

# View matrix
bpy.context.scene.camera.matrix_world.inverted()

# Projection matrix
projection_matrix = bpy.context.scene.camera.calc_matrix_camera(
     bpy.context.evaluated_depsgraph_get(), x=WIDTH, y=HEIGHT)

Compiling Blender

See https://wiki.blender.org/wiki/Building_Blender/Linux/Ubuntu,

Note that Blender has a github mirror which may be faster to clone.

Resources