Python RNA API
authorCampbell Barton <ideasman42@gmail.com>
Sat, 29 Nov 2008 13:36:08 +0000 (13:36 +0000)
committerCampbell Barton <ideasman42@gmail.com>
Sat, 29 Nov 2008 13:36:08 +0000 (13:36 +0000)
commitf23894c3658ca876c8591d564dd73df14135ae8e
tree89d31e82b304733073a692f51f91487373e84aa6
parentd1c0d0aa2c1472345c523d8258f732cc03747fdc
Python RNA API
* Matches the C/RNA api structure
* Thin wrapper ~(600 lines)
* No functions specific to any blender object type.
* Defines 2 types, BPy_StructRNA and BPy_PropertyRNA.
* Python 3.0 target (compatible with python 2.4,5,6)
* http://wiki.blender.org/index.php/BlenderDev/Blender2.5/PyRNA - continue docs/discussion here.

Todo
* Collection iterators
* Write access to data
* Define how constants should be accessed (as strings or some special type)
* Solve the "Python keeping invalid blender pointers" problem.
  This cant just be solved in the py api - we need blender to notify when ID's are removed

Examples
Here are some examples that work with the current implementation of the api.

 rna.lamps["Lamp.006"].energy -> (1.0)
 rna.lamps["Lamp.007"].shadow -> ("NOSHADOW")
 rna.materials.keys() -> ['flyingsquirrel_eye', 'frankie_skin', 'frankie_theeth']
 rna.scenes["hud"].objects["num_text_p2_4"].data.novnormalflip -> False
 rna.meshes["mymesh"].uv_layers.keys() -> ['UVTex', 'UVTex']
 rna.meshes.items()

For a dump of yo-frankie level see - http://pasteall.org/3294/python

Notes
* Added python back, can only execute scripts from the command line with -P script.py
* bpy_interface.c is just enough functionality to run a python file.
source/blender/editors/screen/stubs.c
source/blender/python/SConscript
source/blender/python/intern/bpy_compat.h [new file with mode: 0644]
source/blender/python/intern/bpy_interface.c [new file with mode: 0644]
source/blender/python/intern/bpy_rna.c [new file with mode: 0644]
source/blender/python/intern/bpy_rna.h [new file with mode: 0644]
source/blender/python/intern/bpy_scriptlink.c [moved from source/blender/python/intern/BPY_scriptlink.c with 100% similarity]
source/creator/creator.c