Skip to content

carson-katri/geometry-script

Folders and files

NameName
Last commit message
Last commit date

Latest commit

96a1b29 · Oct 27, 2024

History

68 Commits
Dec 9, 2022
Nov 17, 2023
Nov 15, 2023
Dec 3, 2022
Nov 17, 2022
Dec 3, 2022
Dec 3, 2022
Nov 13, 2022
Apr 1, 2023
Dec 3, 2022
Nov 14, 2022
Nov 13, 2022
Oct 27, 2024

Repository files navigation

Geometry Script wordmark

A scripting API for Blender's Geometry Nodes:

from geometry_script import *

@tree("Repeat Grid")
def repeat_grid(geometry: Geometry, width: Int, height: Int):
    g = grid(
        size_x=width, size_y=height,
        vertices_x=width, vertices_y=height
    ).mesh.mesh_to_points()
    return g.instance_on_points(instance=geometry)

Generated node tree

Installation

  1. Download the source code
  2. Open Blender > Preferences > Add-ons
  3. Choose Install... and select the downloaded ZIP file

Or you can get it from the Blender Market.

What is Geometry Script?

Geometry Script is a robust yet easy to use Python API for creating Geometry Nodes with code.

At a certain point, Geometry Node trees become unmanagably large. Creating node trees in Python enables quicker editing and reorganization of large, complex trees.

Geometry Script has all of the performance and capabilities of Geometry Nodes, but in a more managable format. The scripts are converted directly to Geometry Node trees making them easy to tweak for others unfamiliar with scripting.

Read the documentation for more information on installation, syntax, and tutorials.