diff options
author | Willian Padovani Germano <wpgermano@gmail.com> | 2003-10-24 21:08:59 +0400 |
---|---|---|
committer | Willian Padovani Germano <wpgermano@gmail.com> | 2003-10-24 21:08:59 +0400 |
commit | 5f26e16c51819f6fb6cfed705fce8f667e1b667c (patch) | |
tree | 709a84d281419375bd7ce3eabd493379176d05a9 /source/blender/python/api2_2x/doc/Scene.py | |
parent | 6c9f9d0716f4a277a1b2af09176f1e31a874faef (diff) |
Exppython: fixed crash caused by linking to a scene objects with NULL obdata, caused by recent (2.28c) internal changes to avoid unneded creation of obdata.
Diffstat (limited to 'source/blender/python/api2_2x/doc/Scene.py')
-rw-r--r-- | source/blender/python/api2_2x/doc/Scene.py | 18 |
1 files changed, 15 insertions, 3 deletions
diff --git a/source/blender/python/api2_2x/doc/Scene.py b/source/blender/python/api2_2x/doc/Scene.py index 425cafe85b6..a9fc8c65e4e 100644 --- a/source/blender/python/api2_2x/doc/Scene.py +++ b/source/blender/python/api2_2x/doc/Scene.py @@ -15,13 +15,25 @@ Example:: camdata = Camera.New('ortho') # create new camera data camdata.setName('newCam') camdata.setLens(16.0) - camobj = Object.New('Camera') # create a new camera object - camobj.link(camdata) # link data to object scene = Scene.New('NewScene') # create a new scene - scene.link(camobj) # link object to scene + camobj = Object.New('Camera') # create a new camera object + camobj.link(camdata) # (*) link data to object first + scene.link(camobj) # and then link object to scene scene.frameSettings(1, 100 ,1) # set start, end and current frames scene.setWinSize(640, 480) # set the render window dimensions scene.makeCurrent() # make this the current scene + +@warn: as done in the example (*), it's recommended to first link object data to + objects and only after that link objects to scene. This is because if + there is no object data linked to an object ob, scene.link(ob) will + automatically create the missing data. This is ok on its own, but I{if + after that} this object is linked to obdata, the automatically created one + will be discarded -- as expected -- but will stay in Blender's memory + space until the program is exited, since Blender doesn't really get rid of + most kinds of data. So first linking obdata to object, then object to + scene is a tiny tiny bit faster than the other way around and also saves + some realtime memory (if many objects are created from scripts, the + savings become important). """ def New (name = 'Scene'): |