From 16a11e91af274881a6a272cc35ac15d2b4d7ee46 Mon Sep 17 00:00:00 2001 From: Carson Katri Date: Fri, 9 Dec 2022 15:51:38 -0500 Subject: [PATCH 01/23] Handle dict output --- api/tree.py | 20 ++++++++++++++------ 1 file changed, 14 insertions(+), 6 deletions(-) diff --git a/api/tree.py b/api/tree.py index a85e80d..c9ed29d 100644 --- a/api/tree.py +++ b/api/tree.py @@ -98,12 +98,20 @@ def tree(name): outputs = builder(**builder_inputs) # Create the output sockets - for i, result in enumerate(_as_iterable(outputs)): - if not issubclass(type(result), Type): - result = Type(value=result) - # raise Exception(f"Return value '{result}' is not a valid 'Type' subclass.") - node_group.outputs.new(result.socket_type, 'Result') - link = node_group.links.new(result._socket, group_output_node.inputs[i]) + if isinstance(outputs, dict): + # Use a dict to name each return value + for i, (k, v) in enumerate(outputs.items()): + if not issubclass(type(v), Type): + v = Type(value=v) + node_group.outputs.new(v.socket_type, k) + node_group.links.new(v._socket, group_output_node.inputs[i]) + else: + for i, result in enumerate(_as_iterable(outputs)): + if not issubclass(type(result), Type): + result = Type(value=result) + # raise Exception(f"Return value '{result}' is not a valid 'Type' subclass.") + node_group.outputs.new(result.socket_type, 'Result') + node_group.links.new(result._socket, group_output_node.inputs[i]) _arrange(node_group) From 840701d91622a6046c0cd6f8267b27b07336fac4 Mon Sep 17 00:00:00 2001 From: Carson Katri Date: Fri, 9 Dec 2022 15:55:32 -0500 Subject: [PATCH 02/23] Document named outputs syntax --- .../src/api/basics/cube_tree_named_outputs.png | Bin 0 -> 110814 bytes book/src/api/basics/tree-functions.md | 13 +++++++++++++ 2 files changed, 13 insertions(+) create mode 100644 book/src/api/basics/cube_tree_named_outputs.png diff --git a/book/src/api/basics/cube_tree_named_outputs.png b/book/src/api/basics/cube_tree_named_outputs.png new file mode 100644 index 0000000000000000000000000000000000000000..a029c080db4bffc9aa77f922999f0b4e13770ddb GIT binary patch literal 110814 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 literal 0 HcmV?d00001 diff --git a/book/src/api/basics/tree-functions.md b/book/src/api/basics/tree-functions.md index c77ba00..888bcec 100644 --- a/book/src/api/basics/tree-functions.md +++ b/book/src/api/basics/tree-functions.md @@ -41,6 +41,19 @@ def cube_tree(): ![](./cube_tree_int.png) +By default, each output is named 'Result'. To customize the name, return a dictionary. + +```python +@tree("Cube Tree") +def cube_tree(): + return { + "My Cube": cube(), + "Scale Constant": 5 + } +``` + +![](./cube_tree_named_outputs.png) + ## Group Input All arguments in a tree function must be annotated with a valid socket type. These types are provided by Geometry Script, and are not equivalent to Python's built-in types. Let's add a size argument to our Cube Tree. From 775f8fa4669382dc76c9c43afba35e5452ef75ec Mon Sep 17 00:00:00 2001 From: Carson Katri Date: Fri, 9 Dec 2022 16:02:30 -0500 Subject: [PATCH 03/23] Add deploy preview step --- .github/workflows/github_pages.yml | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/.github/workflows/github_pages.yml b/.github/workflows/github_pages.yml index f883519..dca5b18 100644 --- a/.github/workflows/github_pages.yml +++ b/.github/workflows/github_pages.yml @@ -5,6 +5,12 @@ on: branches: - main pull_request: + - opened + - reopened + - synchronize + - closed + +concurrency: preview-${{ github.ref }} jobs: deploy: @@ -28,3 +34,9 @@ jobs: with: github_token: ${{ secrets.GITHUB_TOKEN }} publish_dir: ./book/book + + - name: Deploy preview + uses: rossjrw/pr-preview-action@v1 + if: ${{ github.ref != 'refs/heads/main' }} + with: + source-dir: ./book/book \ No newline at end of file From 34c1eb50c89aaf182868b6f003b9f9f5772157b7 Mon Sep 17 00:00:00 2001 From: Carson Katri Date: Fri, 9 Dec 2022 16:03:40 -0500 Subject: [PATCH 04/23] Fix actions --- .github/workflows/github_pages.yml | 4 ---- 1 file changed, 4 deletions(-) diff --git a/.github/workflows/github_pages.yml b/.github/workflows/github_pages.yml index dca5b18..b60cf98 100644 --- a/.github/workflows/github_pages.yml +++ b/.github/workflows/github_pages.yml @@ -5,10 +5,6 @@ on: branches: - main pull_request: - - opened - - reopened - - synchronize - - closed concurrency: preview-${{ github.ref }} From 87793fe8d1edb439fb468a39286118aba6d8959e Mon Sep 17 00:00:00 2001 From: Carson Katri Date: Sun, 12 Feb 2023 11:08:20 -0500 Subject: [PATCH 05/23] Use isinstance for Named Attribute --- api/static/attribute.py | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/api/static/attribute.py b/api/static/attribute.py index 8038a5e..009a890 100644 --- a/api/static/attribute.py +++ b/api/static/attribute.py @@ -44,12 +44,19 @@ class Attribute: """ Creates a "Named Attribute" node with the correct arguments passed, and returns the "Attribute" socket. """ - from geometry_script import named_attribute - return named_attribute(data_type=self.data_type, name=self.name, *args, **kwargs).attribute + from geometry_script import named_attribute, Type + result = named_attribute(data_type=self.data_type, name=self.name, *args, **kwargs) + # Handle Blender 3.5+, which includes an `exists` result. + if isinstance(result, Type): + return result + else: + return result.attribute def exists(self, *args, **kwargs): """ Creates a "Named Attribute" node with the correct arguments passed, and returns the "Exists" socket. + + > Only available in Blender 3.5+ """ from geometry_script import named_attribute return named_attribute(data_type=self.data_type, name=self.name, *args, **kwargs).exists From bfe5aae3cda26acd5ebc31a69bcedf34d032b406 Mon Sep 17 00:00:00 2001 From: Carson Katri Date: Sun, 12 Feb 2023 11:11:03 -0500 Subject: [PATCH 06/23] Fix capture --- api/types.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api/types.py b/api/types.py index e1e9611..d8346bc 100644 --- a/api/types.py +++ b/api/types.py @@ -175,8 +175,8 @@ class Type(metaclass=_TypeMeta): def capture(self, value, **kwargs): data_type = socket_type_to_data_type(value._socket.type) - geometry, attribute = self.capture_attribute(data_type=data_type, value=value, **kwargs) - return geometry, attribute + res = self.capture_attribute(data_type=data_type, value=value, **kwargs) + return res.geometry, res.attribute def transfer(self, attribute, **kwargs): data_type = socket_type_to_data_type(attribute._socket.type) return self.transfer_attribute(data_type=data_type, attribute=attribute, **kwargs) From 258a7c51c65a66564f6117a304b08d2903a4e23a Mon Sep 17 00:00:00 2001 From: Carson Katri Date: Sat, 1 Apr 2023 16:29:14 -0400 Subject: [PATCH 07/23] Update for Blender 3.5 release --- README.md | 2 +- api/node_mapper.py | 48 +++++++++++++--------------------------------- 2 files changed, 14 insertions(+), 36 deletions(-) diff --git a/README.md b/README.md index 786e8c6..c548a26 100644 --- a/README.md +++ b/README.md @@ -16,7 +16,7 @@ def repeat_grid(geometry: Geometry, width: Int, height: Int): g = grid( size_x=width, size_y=height, vertices_x=width, vertices_y=height - ).mesh_to_points() + ).mesh.mesh_to_points() return g.instance_on_points(instance=geometry) ``` diff --git a/api/node_mapper.py b/api/node_mapper.py index 876540b..1b32b5d 100644 --- a/api/node_mapper.py +++ b/api/node_mapper.py @@ -1,8 +1,8 @@ import bpy -import bl_ui import itertools import enum import re +import os from .state import State from .types import * from .static.input_group import InputGroup @@ -105,35 +105,13 @@ def register_node(node_type, category_path=None): enum_type = enum.Enum(enum_type_name, { map_case_name(i): i.identifier for i in prop.enum_items }) setattr(globals()[node_namespace_name], enum_type_name, enum_type) registered_nodes.add(node_type) -for category_name in list(filter(lambda x: x.startswith('NODE_MT_category_GEO_'), dir(bpy.types))): - category = getattr(bpy.types, category_name) - if not hasattr(category, 'category'): - category_path = category.bl_label.lower().replace(' ', '_') - add_node_type = bl_ui.node_add_menu.add_node_type - draw_node_group_add_menu = bl_ui.node_add_menu.draw_node_group_add_menu - draw_assets_for_catalog = bl_ui.node_add_menu.draw_assets_for_catalog - bl_ui.node_add_menu.add_node_type = lambda _layout, node_type_name: register_node(getattr(bpy.types, node_type_name), category_path) - bl_ui.node_add_menu.draw_node_group_add_menu = lambda _context, _layout: None - bl_ui.node_add_menu.draw_assets_for_catalog = lambda _context, _layout: None - class CategoryStub: - bl_label = "" - def __init__(self): - self.layout = Layout() - class Layout: - def separator(self): pass - category.draw(CategoryStub(), None) - bl_ui.node_add_menu.add_node_type = add_node_type - bl_ui.node_add_menu.draw_node_group_add_menu = draw_node_group_add_menu - bl_ui.node_add_menu.draw_assets_for_catalog = draw_assets_for_catalog - else: - category_path = category.category.name.lower().replace(' ', '_') - for node in category.category.items(None): - node_type = getattr(bpy.types, node.nodetype) - register_node(node_type, category_path) -for node_type_name in list(filter(lambda x: 'GeometryNode' in x, dir(bpy.types))): + +denylist = {'filter'} # some nodes should be excluded. +for node_type_name in dir(bpy.types): node_type = getattr(bpy.types, node_type_name) - if issubclass(node_type, bpy.types.GeometryNode): - register_node(node_type) + if isinstance(node_type, type) and issubclass(node_type, bpy.types.Node): + if node_type.is_registered_node_type() and node_type.bl_rna.name.lower() not in denylist: + register_node(node_type) def create_documentation(): temp_node_group = bpy.data.node_groups.new('temp_node_group', 'GeometryNodeTree') @@ -155,6 +133,7 @@ def create_documentation(): docstrings = [] symbols = [] enums = {} + skipped_nodes = [] for func in sorted(documentation.keys()): try: method = documentation[func] @@ -261,12 +240,8 @@ def create_documentation(): {output_symbol_separator.join(output_symbols)}""") return_type_hint = list(symbol_outputs.values())[0] if len(output_symbols) == 1 else f"{node_namespace_name}.Result" symbols.append(f"""def {func}({', '.join(symbol_args)}) -> {return_type_hint}: \"\"\"![]({image}.webp)\"\"\"""") - except Exception as e: - import os, sys - print(e) - exc_type, exc_obj, exc_tb = sys.exc_info() - fname = os.path.split(exc_tb.tb_frame.f_code.co_filename)[1] - print(exc_type, fname, exc_tb.tb_lineno) + except: + skipped_nodes.append(documentation[func].bl_node_type.__name__) continue bpy.data.node_groups.remove(temp_node_group) html = f""" @@ -362,6 +337,9 @@ class Type: fpyi.write(contents) fpy.write(contents) + if len(skipped_nodes) > 0: + pass # This could be reported later. + def create_docs(): create_documentation() bpy.app.timers.register(create_docs) \ No newline at end of file From f42e0ba4564ebf96dde34e46c4aa7d7877503389 Mon Sep 17 00:00:00 2001 From: Adam P Date: Thu, 6 Apr 2023 17:42:59 +0200 Subject: [PATCH 08/23] Fix some cases of node name collisions Some compositor and texture nodes share names with the geometry nodes versions. This change sorts them so that the geometry ones are registered last, overriding the incorrect ones. The Math node is handled separately, because here the ShaderNodeMath is the correct one to use, for some reason. --- api/node_mapper.py | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/api/node_mapper.py b/api/node_mapper.py index 1b32b5d..e150d8d 100644 --- a/api/node_mapper.py +++ b/api/node_mapper.py @@ -107,11 +107,16 @@ def register_node(node_type, category_path=None): registered_nodes.add(node_type) denylist = {'filter'} # some nodes should be excluded. +class_denylist = {'CompositorNodeMath', 'TextureNodeMath'} +node_types_to_register = [] for node_type_name in dir(bpy.types): node_type = getattr(bpy.types, node_type_name) if isinstance(node_type, type) and issubclass(node_type, bpy.types.Node): - if node_type.is_registered_node_type() and node_type.bl_rna.name.lower() not in denylist: - register_node(node_type) + if node_type.is_registered_node_type() and node_type.bl_rna.name.lower() not in denylist and node_type.__name__ not in class_denylist: + node_types_to_register.append(node_type) +node_types_to_register.sort(key=lambda node_type: node_type.__name__.startswith("GeometryNode")) +for node_type in node_types_to_register: + register_node(node_type) def create_documentation(): temp_node_group = bpy.data.node_groups.new('temp_node_group', 'GeometryNodeTree') @@ -342,4 +347,4 @@ class Type: def create_docs(): create_documentation() -bpy.app.timers.register(create_docs) \ No newline at end of file +bpy.app.timers.register(create_docs) From 1ffed551841019344d2b30c03ef47e61a0019834 Mon Sep 17 00:00:00 2001 From: Alfredo Date: Fri, 7 Jul 2023 17:57:24 -0400 Subject: [PATCH 09/23] support more math dunder methods --- api/types.py | 41 ++++++++++++++++++++++++++++++++++++++--- 1 file changed, 38 insertions(+), 3 deletions(-) diff --git a/api/types.py b/api/types.py index d8346bc..620e17a 100644 --- a/api/types.py +++ b/api/types.py @@ -57,10 +57,15 @@ class Type(metaclass=_TypeMeta): self.socket_type = type(socket).__name__ def _math(self, other, operation, reverse=False): - if self._socket.type == 'VECTOR': - return geometry_script.vector_math(operation=operation, vector=(other, self) if reverse else (self, other)) + if other is None: + vector_or_value = self else: - return geometry_script.math(operation=operation, value=(other, self) if reverse else (self, other)) + vector_or_value = (other, self) if reverse else (self, other) + + if self._socket.type == 'VECTOR': + return geometry_script.vector_math(operation=operation, vector=vector_or_value) + else: + return geometry_script.math(operation=operation, value=vector_or_value) def __add__(self, other): return self._math(other, 'ADD') @@ -92,6 +97,36 @@ class Type(metaclass=_TypeMeta): def __rmod__(self, other): return self._math(other, 'MODULO', True) + def __floordiv__(self, other): + return self._math(other, 'DIVIDE')._math(None,'FLOOR') + + def __rfloordiv__(self, other): + return self._math(other, 'DIVIDE',True)._math(None,'FLOOR') + + def __pow__(self, other): + return self._math(other, 'POWER') + + def __rpow__(self, other): + return self._math(other, 'POWER', True) + + def __matmul__(self, other): + return self._math(other, 'DOT_PRODUCT') + + def __rmatmul__(self, other): + return self._math(other, 'DOT_PRODUCT', True) + + def __abs__(self): + return self._math(None,'ABSOLUTE') + + def __neg__(self): + return self._math(-1, 'MULTIPLY') + + def __pos__(self): + return self + + def __round__(self): + return self._math(None,'ROUND') + def _compare(self, other, operation): return geometry_script.compare(operation=operation, a=self, b=other) From 467ae71ec6688681165f7d1aeb96a01d71d1983c Mon Sep 17 00:00:00 2001 From: Carson Katri Date: Sun, 12 Feb 2023 11:43:16 -0500 Subject: [PATCH 10/23] Add curve support --- api/node_mapper.py | 8 +++ api/static/curve.py | 54 ++++++++++++++++++ api/tree.py | 1 + book/src/SUMMARY.md | 1 + book/src/api/advanced-scripting/curves.md | 32 +++++++++++ .../api/advanced-scripting/float_curve.png | Bin 0 -> 36448 bytes 6 files changed, 96 insertions(+) create mode 100644 api/static/curve.py create mode 100644 book/src/api/advanced-scripting/curves.md create mode 100644 book/src/api/advanced-scripting/float_curve.png diff --git a/api/node_mapper.py b/api/node_mapper.py index e150d8d..54321bc 100644 --- a/api/node_mapper.py +++ b/api/node_mapper.py @@ -6,6 +6,7 @@ import os from .state import State from .types import * from .static.input_group import InputGroup +from .static.curve import Curve from ..absolute_path import absolute_path class OutputsList(dict): @@ -28,6 +29,13 @@ def build_node(node_type): argname = prop.identifier.lower().replace(' ', '_') if argname in kwargs: value = kwargs[argname] + if isinstance(value, list) and len(value) > 0 and isinstance(value[0], Curve): + for i, curve in enumerate(value): + curve.apply(getattr(node, prop.identifier).curves[i]) + continue + if isinstance(value, Curve): + value.apply(getattr(node, prop.identifier).curves[0]) + continue if isinstance(value, enum.Enum): value = value.value setattr(node, prop.identifier, value) diff --git a/api/static/curve.py b/api/static/curve.py new file mode 100644 index 0000000..e53a282 --- /dev/null +++ b/api/static/curve.py @@ -0,0 +1,54 @@ +from typing import List +import enum + +class HandleType(enum.Enum): + AUTO = 'AUTO' + VECTOR = 'VECTOR' + AUTO_CLAMPED = 'AUTO_CLAMPED' + +class Point: + """ + A single point on a curve + """ + + x: float + y: float + handle_type: HandleType + + def __init__(self, x: float, y: float, handle_type: HandleType = HandleType.AUTO): + self.x = x + self.y = y + self.handle_type = handle_type + +class Curve: + """ + A class that represents a curve. + + Create a curve from a set of `Point`s. + ```python + my_curve = Curve( + Point(0, 0, Handle.AUTO_CLAMPED), + Point(0.2, 0.3, Handle.AUTO), + Point(1, 1, Handle.VECTOR) + ) + ``` + """ + + points: List[Point] + + def __init__(self, *points: Point): + if len(points) == 1 and isinstance(points[0], list): + self.points = points[0] + else: + self.points = list(points) + + def apply(self, curve): + """ + Apply the points to a curve object. + """ + for i, point in enumerate(self.points): + if len(curve.points) > i: + curve.points[i].location = (point.x, point.y) + curve.points[i].handle_type = point.handle_type.value + else: + curve.points.new(point.x, point.y).handle_type = point.handle_type.value \ No newline at end of file diff --git a/api/tree.py b/api/tree.py index c9ed29d..9b2ccad 100644 --- a/api/tree.py +++ b/api/tree.py @@ -8,6 +8,7 @@ from .state import State from .types import * from .node_mapper import * from .static.attribute import * +from .static.curve import * from .static.expression import * from .static.input_group import * from .static.sample_mode import * diff --git a/book/src/SUMMARY.md b/book/src/SUMMARY.md index 64be5ea..45b7f80 100644 --- a/book/src/SUMMARY.md +++ b/book/src/SUMMARY.md @@ -21,6 +21,7 @@ - [Input Groups](./api/advanced-scripting/input-groups.md) - [Attributes](./api/advanced-scripting/attributes.md) - [Boolean Math](./api/advanced-scripting/boolean-math.md) + - [Curves](./api/advanced-scripting/curves.md) - [Drivers](./api/advanced-scripting/drivers.md) - [Simulation](./api/advanced-scripting/simulation.md) diff --git a/book/src/api/advanced-scripting/curves.md b/book/src/api/advanced-scripting/curves.md new file mode 100644 index 0000000..3a007c3 --- /dev/null +++ b/book/src/api/advanced-scripting/curves.md @@ -0,0 +1,32 @@ +# Curves + +Some nodes, such as *Float Curve* take a curve as a property. You can create a curve with the `Curve` class. + +```python +float_curve( + mapping=Curve( + Point(0, 0), + Point(0.5, 0.25), + Point(1, 1, HandleType.VECTOR), # Optionally specify a handle type, such as `AUTO`, `VECTOR`, or `AUTO_CLAMPED`. + ) +) +``` + +![](./float_curve.png) + +You can also pass the points as a list to `Curve`. + +```python +points = [Point(0, 0), Point(1, 1)] +float_curve( + mapping=Curve(points) +) +``` + +If a node has multiple curve properties, such as the *Vector Curves* node, pass a list of curves to the node. + +```python +vector_curves( + mapping=[x_curve, y_curve, z_curve] +) +``` \ No newline at end of file diff --git a/book/src/api/advanced-scripting/float_curve.png b/book/src/api/advanced-scripting/float_curve.png new file mode 100644 index 0000000000000000000000000000000000000000..53bb1c9c1b5be91fa241ffc3eeecdeece8ad172a GIT binary patch literal 36448 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