blender/doc/python_api
Lukas Toenne 4638e5f99a Merge of the PyNodes branch (aka "custom nodes") into trunk.
PyNodes opens up the node system in Blender to scripters and adds a number of UI-level improvements.

=== Dynamic node type registration ===
Node types can now be added at runtime, using the RNA registration mechanism from python. This enables addons such as render engines to create a complete user interface with nodes.

Examples of how such nodes can be defined can be found in my personal wiki docs atm [1] and as a script template in release/scripts/templates_py/custom_nodes.py [2].

=== Node group improvements ===
Each node editor now has a tree history of edited node groups, which allows opening and editing nested node groups. The node editor also supports pinning now, so that different spaces can be used to edit different node groups simultaneously. For more ramblings and rationale see (really old) blog post on code.blender.org [3].

The interface of node groups has been overhauled. Sockets of a node group are no longer displayed in columns on either side, but instead special input/output nodes are used to mirror group sockets inside a node tree. This solves the problem of long node lines in groups and allows more adaptable node layout. Internal sockets can be exposed from a group by either connecting to the extension sockets in input/output nodes (shown as empty circle) or by adding sockets from the node property bar in the "Interface" panel. Further details such as the socket name can also be changed there.

[1] http://wiki.blender.org/index.php/User:Phonybone/Python_Nodes
[2] http://projects.blender.org/scm/viewvc.php/trunk/blender/release/scripts/templates_py/custom_nodes.py?view=markup&root=bf-blender
[3] http://code.blender.org/index.php/2012/01/improving-node-group-interface-editing/
2013-03-18 16:34:57 +00:00
..
blender-org fix [#28151] export OBJ don't save the extension 2011-08-03 05:32:07 +00:00
epy hide overly picky warnings from 'pylint' for pep8 script, indentation edits. 2011-11-19 16:17:35 +00:00
examples Merge of the PyNodes branch (aka "custom nodes") into trunk. 2013-03-18 16:34:57 +00:00
rst rst doc update: adding a link to Joystick class from bge.logic.joysticks 2013-02-28 05:18:47 +00:00
rst_from_bmesh_opdefines.py code cleanup: 2013-01-15 23:17:45 +00:00
sphinx_changelog_gen.py api changelog for 2.64 and 2.63 (which I missed last release) 2012-10-09 01:07:08 +00:00
sphinx_doc_gen_monkeypatch.py add python api docstring for 'bpy.types.Operator.bl_property' 2013-02-05 05:09:19 +00:00
sphinx_doc_gen.py edits to document uploading script so the latest release docs can always be found at: 2013-02-20 14:22:36 +00:00
sphinx_doc_gen.sh edits to document uploading script so the latest release docs can always be found at: 2013-02-20 14:22:36 +00:00