Animato - Drivers with Multiple Targets:
authorJoshua Leung <aligorith@gmail.com>
Thu, 16 Apr 2009 07:37:06 +0000 (07:37 +0000)
committerJoshua Leung <aligorith@gmail.com>
Thu, 16 Apr 2009 07:37:06 +0000 (07:37 +0000)
commit079304d199f7619f7eb0e8c256953505df1fcb53
treeb6b101f1ce5dae1b4f8af5eeb7729aaacda67be7
parent88d394d47dc0d1933faa06b50068f761d79a97ba
Animato - Drivers with Multiple Targets:

Drivers now support multiple targets which act as 'variables'. The targets have a short 'name' (see later), and reference some property (in much the same way as F-Curves do, using RNA-Paths) which acts as the 'value'.

These named variables can then be used in a Python Expression which relates them to each other for more fine-grained control over the result of the driver. By using only the names of these variables in the expressions, we are able to define expressions/relationships in a much more readable way, as data access is separated from data use. This makes the underlying relationships easier to understand.

By default, if no Python Expression is given, the variables are simply averaged together, so old files won't break. :)

For example, check the following diagram (thanks Cessen/Nathan V from Peach team):
http://download.blender.org/ftp/incoming/250_drivers_mockup_cessen.png

TODO List:
* Depsgraph building for new driver relationships doesn't work yet. This needs to be recoded again, but this new system makes this much easier, since the targets are clearly defined (i.e. no need to parse py expressions to get list of objects)
* Graph Editor interface for editing these needs to be rewritten
* Python function for evaluating these expressions is needed (Campbell?)
source/blender/blenkernel/BKE_fcurve.h
source/blender/blenkernel/intern/depsgraph.c
source/blender/blenkernel/intern/fcurve.c
source/blender/blenkernel/intern/ipo.c
source/blender/blenloader/intern/readfile.c
source/blender/blenloader/intern/writefile.c
source/blender/editors/space_graph/graph_buttons.c
source/blender/editors/space_outliner/outliner.c
source/blender/makesdna/DNA_anim_types.h
source/blender/makesrna/RNA_access.h
source/blender/makesrna/intern/rna_action.c