2002-10-12 11:37:38 +00:00
|
|
|
/**
|
|
|
|
|
* blenlib/BKE_ipo.h (mar-2001 nzc)
|
|
|
|
|
*
|
|
|
|
|
* $Id$
|
|
|
|
|
*
|
2008-04-16 22:40:48 +00:00
|
|
|
* ***** BEGIN GPL LICENSE BLOCK *****
|
2002-10-12 11:37:38 +00:00
|
|
|
*
|
|
|
|
|
* This program is free software; you can redistribute it and/or
|
|
|
|
|
* modify it under the terms of the GNU General Public License
|
|
|
|
|
* as published by the Free Software Foundation; either version 2
|
2008-04-16 22:40:48 +00:00
|
|
|
* of the License, or (at your option) any later version.
|
2002-10-12 11:37:38 +00:00
|
|
|
*
|
|
|
|
|
* This program is distributed in the hope that it will be useful,
|
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
|
* GNU General Public License for more details.
|
|
|
|
|
*
|
|
|
|
|
* You should have received a copy of the GNU General Public License
|
|
|
|
|
* along with this program; if not, write to the Free Software Foundation,
|
|
|
|
|
* Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
|
|
|
|
|
*
|
|
|
|
|
* The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
|
|
|
|
|
* All rights reserved.
|
|
|
|
|
*
|
|
|
|
|
* The Original Code is: all of this file.
|
|
|
|
|
*
|
|
|
|
|
* Contributor(s): none yet.
|
|
|
|
|
*
|
2008-04-16 22:40:48 +00:00
|
|
|
* ***** END GPL LICENSE BLOCK *****
|
2002-10-12 11:37:38 +00:00
|
|
|
*/
|
|
|
|
|
#ifndef BKE_IPO_H
|
|
|
|
|
#define BKE_IPO_H
|
|
|
|
|
|
2008-06-24 22:19:00 +00:00
|
|
|
#ifdef __cplusplus
|
|
|
|
|
extern "C" {
|
|
|
|
|
#endif
|
|
|
|
|
|
2002-10-12 11:37:38 +00:00
|
|
|
typedef struct CfraElem {
|
|
|
|
|
struct CfraElem *next, *prev;
|
|
|
|
|
float cfra;
|
|
|
|
|
int sel;
|
|
|
|
|
} CfraElem;
|
|
|
|
|
|
|
|
|
|
struct Ipo;
|
|
|
|
|
struct IpoCurve;
|
|
|
|
|
struct MTex;
|
|
|
|
|
struct Material;
|
|
|
|
|
struct Object;
|
|
|
|
|
struct Sequence;
|
|
|
|
|
struct ListBase;
|
|
|
|
|
struct BezTriple;
|
2005-08-17 17:56:54 +00:00
|
|
|
struct ID;
|
2005-10-10 18:05:30 +00:00
|
|
|
struct bPoseChannel;
|
|
|
|
|
struct bActionChannel;
|
|
|
|
|
struct rctf;
|
2002-10-12 11:37:38 +00:00
|
|
|
|
|
|
|
|
float frame_to_float(int cfra);
|
Version 1.0 of IpoDrivers.
First note that this is new functionality, unfinished, and only for
testing and feedback purposes. I'll list below what works, and what will
need work still.
This text is also in cms: http://www.blender.org/cms/Ipo_Drivers.680.0.html
An IpoDriver is like an IpoCurve, but instead of a Bezier curve, it allows
to connect a property of other Objects as input for the "channel". For
example, IpoDrivers can be used to have a Shape Key being "driven" by
the rotation of a Bone. Or the RGB colors of a Material get driven by the
XYZ location of an Object.
Editing of Drivers happens in the IpoWindow. Here you can notice that the
channels (right hand window) now have an "active" channel indicator.
To add a Driver, you have to use the "Transform Properties" Panel (Nkey).
Here you can add or remove a Driver to the active channel, and use the
buttons to fill in what kind of relationship you want to establish.
Driver Objects
Note that any Ipo Channel can become driven now, but that only Object
transformation or Pose Bone transformation can be used to become a
Driver now.
At this moment, only the local transformation is taken into account.
For Objects that means the location/rotation/scale value without Parent
transform (as shown in "Transform Properties" Panel for Objects).
For Pose Bones it means that only the Pose transform (changes of rest
position) is Driver information (also as shown in Transform Property
Panel in Pose Mode).
Mapping of Drivers
When an Ipo Channel is "driven", the mapping is by default one-to-one.
It is only restricted by already built-in limits for Channels, like
for Material the "R" value can only range from 0.0 to 1.0.
Also note that when mapping rotations, the actual rotation values
in Ipos are scaled down with a factor 10.0. (180 degrees actually has
in the Ipo system a value of 18.0). This is an ancient year zero
convention in Blender... it is a bit hidden, because the ruler
(vertical as well as horizontal) displays the virtual values correctly.
Only the Properties panel shows the actual value.
When you draw an IpoCurve in a Driven channel, this curve will define
the mapping between the Driver output (horizontal) and Driven input
(vertical, as usual).
A nice new option to use is "Insert one-to-one curve" (press I-key,
or in pulldown menu). This will also zoom the display in exactly to
fill the window, allowing easy edit. If you use this option with
degrees, it will map 180 degree rotation to a range of 1.0 unit.
Live updates
Since the Drivers are integrated in the Ipo system, they will always
be updated whenever an Ipo is evaluated. This happens at least on
frame changes.
For interactive feedback, updates while transforming objects were
added in these cases:
- Driven Object Ipos, by other Objects or Pose Bones
- Driven Shape Key Ipos, by other Objects or Pose Bones
You can also insert Drivers on Action Ipos, but these are only evaluated
on frame change now.
Todo
- Drivers can also get a text button, allowing a 1 line Python script
to be executed.
- Make UI for it a bit less hidden... maybe with visualization in 3D?
- Allowing global transform coordinates as Driver too.
Issues
- renaming Bones won't rename drivers
- (file) appending the Ipo won't append the linked driver Objects
2005-10-02 20:51:35 +00:00
|
|
|
|
|
|
|
|
void free_ipo_curve(struct IpoCurve *icu);
|
2002-10-12 11:37:38 +00:00
|
|
|
void free_ipo(struct Ipo *ipo);
|
2005-10-10 18:05:30 +00:00
|
|
|
void ipo_default_v2d_cur(int blocktype, struct rctf *cur);
|
2002-10-12 11:37:38 +00:00
|
|
|
struct Ipo *add_ipo(char *name, int idcode);
|
|
|
|
|
struct Ipo *copy_ipo(struct Ipo *ipo);
|
2007-03-11 12:14:50 +00:00
|
|
|
void ipo_idnew(struct Ipo *ipo);
|
2002-10-12 11:37:38 +00:00
|
|
|
void make_local_obipo(struct Ipo *ipo);
|
|
|
|
|
void make_local_matipo(struct Ipo *ipo);
|
|
|
|
|
void make_local_keyipo(struct Ipo *ipo);
|
|
|
|
|
void make_local_ipo(struct Ipo *ipo);
|
2008-09-28 15:37:37 +00:00
|
|
|
struct IpoCurve *find_ipocurve(struct Ipo *ipo, int adrcode);
|
2005-09-26 15:34:21 +00:00
|
|
|
|
2002-10-12 11:37:38 +00:00
|
|
|
void calchandles_ipocurve(struct IpoCurve *icu);
|
|
|
|
|
void testhandles_ipocurve(struct IpoCurve *icu);
|
|
|
|
|
void sort_time_ipocurve(struct IpoCurve *icu);
|
|
|
|
|
int test_time_ipocurve(struct IpoCurve *icu);
|
|
|
|
|
void correct_bezpart(float *v1, float *v2, float *v3, float *v4);
|
|
|
|
|
int findzero(float x, float q0, float q1, float q2, float q3, float *o);
|
|
|
|
|
void berekeny(float f1, float f2, float f3, float f4, float *o, int b);
|
|
|
|
|
void berekenx(float *f, float *o, int b);
|
|
|
|
|
float eval_icu(struct IpoCurve *icu, float ipotime);
|
|
|
|
|
void calc_icu(struct IpoCurve *icu, float ctime);
|
|
|
|
|
float calc_ipo_time(struct Ipo *ipo, float ctime);
|
|
|
|
|
void calc_ipo(struct Ipo *ipo, float ctime);
|
|
|
|
|
void write_ipo_poin(void *poin, int type, float val);
|
|
|
|
|
float read_ipo_poin(void *poin, int type);
|
2008-09-28 12:01:41 +00:00
|
|
|
void *give_mtex_poin(struct MTex *mtex, int adrcode );
|
2008-09-28 15:37:37 +00:00
|
|
|
|
2008-09-28 12:01:41 +00:00
|
|
|
void *get_ipo_poin(struct ID *id, struct IpoCurve *icu, int *type);
|
2008-09-28 15:37:37 +00:00
|
|
|
void *get_pchan_ipo_poin(struct bPoseChannel *pchan, int adrcode);
|
2005-10-10 18:05:30 +00:00
|
|
|
|
2002-10-12 11:37:38 +00:00
|
|
|
void set_icu_vars(struct IpoCurve *icu);
|
2005-10-10 18:05:30 +00:00
|
|
|
|
2002-10-12 11:37:38 +00:00
|
|
|
void execute_ipo(struct ID *id, struct Ipo *ipo);
|
2005-10-10 18:05:30 +00:00
|
|
|
void execute_action_ipo(struct bActionChannel *achan, struct bPoseChannel *pchan);
|
Version 1.0 of IpoDrivers.
First note that this is new functionality, unfinished, and only for
testing and feedback purposes. I'll list below what works, and what will
need work still.
This text is also in cms: http://www.blender.org/cms/Ipo_Drivers.680.0.html
An IpoDriver is like an IpoCurve, but instead of a Bezier curve, it allows
to connect a property of other Objects as input for the "channel". For
example, IpoDrivers can be used to have a Shape Key being "driven" by
the rotation of a Bone. Or the RGB colors of a Material get driven by the
XYZ location of an Object.
Editing of Drivers happens in the IpoWindow. Here you can notice that the
channels (right hand window) now have an "active" channel indicator.
To add a Driver, you have to use the "Transform Properties" Panel (Nkey).
Here you can add or remove a Driver to the active channel, and use the
buttons to fill in what kind of relationship you want to establish.
Driver Objects
Note that any Ipo Channel can become driven now, but that only Object
transformation or Pose Bone transformation can be used to become a
Driver now.
At this moment, only the local transformation is taken into account.
For Objects that means the location/rotation/scale value without Parent
transform (as shown in "Transform Properties" Panel for Objects).
For Pose Bones it means that only the Pose transform (changes of rest
position) is Driver information (also as shown in Transform Property
Panel in Pose Mode).
Mapping of Drivers
When an Ipo Channel is "driven", the mapping is by default one-to-one.
It is only restricted by already built-in limits for Channels, like
for Material the "R" value can only range from 0.0 to 1.0.
Also note that when mapping rotations, the actual rotation values
in Ipos are scaled down with a factor 10.0. (180 degrees actually has
in the Ipo system a value of 18.0). This is an ancient year zero
convention in Blender... it is a bit hidden, because the ruler
(vertical as well as horizontal) displays the virtual values correctly.
Only the Properties panel shows the actual value.
When you draw an IpoCurve in a Driven channel, this curve will define
the mapping between the Driver output (horizontal) and Driven input
(vertical, as usual).
A nice new option to use is "Insert one-to-one curve" (press I-key,
or in pulldown menu). This will also zoom the display in exactly to
fill the window, allowing easy edit. If you use this option with
degrees, it will map 180 degree rotation to a range of 1.0 unit.
Live updates
Since the Drivers are integrated in the Ipo system, they will always
be updated whenever an Ipo is evaluated. This happens at least on
frame changes.
For interactive feedback, updates while transforming objects were
added in these cases:
- Driven Object Ipos, by other Objects or Pose Bones
- Driven Shape Key Ipos, by other Objects or Pose Bones
You can also insert Drivers on Action Ipos, but these are only evaluated
on frame change now.
Todo
- Drivers can also get a text button, allowing a 1 line Python script
to be executed.
- Make UI for it a bit less hidden... maybe with visualization in 3D?
- Allowing global transform coordinates as Driver too.
Issues
- renaming Bones won't rename drivers
- (file) appending the Ipo won't append the linked driver Objects
2005-10-02 20:51:35 +00:00
|
|
|
|
2002-10-12 11:37:38 +00:00
|
|
|
void do_ipo_nocalc(struct Ipo *ipo);
|
|
|
|
|
void do_ipo(struct Ipo *ipo);
|
|
|
|
|
void do_mat_ipo(struct Material *ma);
|
|
|
|
|
void do_ob_ipo(struct Object *ob);
|
2007-12-23 21:27:12 +00:00
|
|
|
void do_seq_ipo(struct Sequence *seq, int cfra);
|
2006-07-04 10:19:26 +00:00
|
|
|
void do_ob_ipodrivers(struct Object *ob, struct Ipo *ipo, float ctime);
|
Version 1.0 of IpoDrivers.
First note that this is new functionality, unfinished, and only for
testing and feedback purposes. I'll list below what works, and what will
need work still.
This text is also in cms: http://www.blender.org/cms/Ipo_Drivers.680.0.html
An IpoDriver is like an IpoCurve, but instead of a Bezier curve, it allows
to connect a property of other Objects as input for the "channel". For
example, IpoDrivers can be used to have a Shape Key being "driven" by
the rotation of a Bone. Or the RGB colors of a Material get driven by the
XYZ location of an Object.
Editing of Drivers happens in the IpoWindow. Here you can notice that the
channels (right hand window) now have an "active" channel indicator.
To add a Driver, you have to use the "Transform Properties" Panel (Nkey).
Here you can add or remove a Driver to the active channel, and use the
buttons to fill in what kind of relationship you want to establish.
Driver Objects
Note that any Ipo Channel can become driven now, but that only Object
transformation or Pose Bone transformation can be used to become a
Driver now.
At this moment, only the local transformation is taken into account.
For Objects that means the location/rotation/scale value without Parent
transform (as shown in "Transform Properties" Panel for Objects).
For Pose Bones it means that only the Pose transform (changes of rest
position) is Driver information (also as shown in Transform Property
Panel in Pose Mode).
Mapping of Drivers
When an Ipo Channel is "driven", the mapping is by default one-to-one.
It is only restricted by already built-in limits for Channels, like
for Material the "R" value can only range from 0.0 to 1.0.
Also note that when mapping rotations, the actual rotation values
in Ipos are scaled down with a factor 10.0. (180 degrees actually has
in the Ipo system a value of 18.0). This is an ancient year zero
convention in Blender... it is a bit hidden, because the ruler
(vertical as well as horizontal) displays the virtual values correctly.
Only the Properties panel shows the actual value.
When you draw an IpoCurve in a Driven channel, this curve will define
the mapping between the Driver output (horizontal) and Driven input
(vertical, as usual).
A nice new option to use is "Insert one-to-one curve" (press I-key,
or in pulldown menu). This will also zoom the display in exactly to
fill the window, allowing easy edit. If you use this option with
degrees, it will map 180 degree rotation to a range of 1.0 unit.
Live updates
Since the Drivers are integrated in the Ipo system, they will always
be updated whenever an Ipo is evaluated. This happens at least on
frame changes.
For interactive feedback, updates while transforming objects were
added in these cases:
- Driven Object Ipos, by other Objects or Pose Bones
- Driven Shape Key Ipos, by other Objects or Pose Bones
You can also insert Drivers on Action Ipos, but these are only evaluated
on frame change now.
Todo
- Drivers can also get a text button, allowing a 1 line Python script
to be executed.
- Make UI for it a bit less hidden... maybe with visualization in 3D?
- Allowing global transform coordinates as Driver too.
Issues
- renaming Bones won't rename drivers
- (file) appending the Ipo won't append the linked driver Objects
2005-10-02 20:51:35 +00:00
|
|
|
|
2008-09-28 15:37:37 +00:00
|
|
|
int has_ipo_code(struct Ipo *ipo, int code);
|
Result of 2 weeks of quiet coding work in Greece :)
Aim was to get a total refresh of the animation system. This
is needed because;
- we need to upgrade it with 21st century features
- current code is spaghetti/hack combo, and hides good design
- it should become lag-free with using dependency graphs
A full log, with complete code API/structure/design explanation
will follow, that's a load of work... so here below the list with
hot changes;
- The entire object update system (matrices, geometry) is now
centralized. Calls to where_is_object and makeDispList are
forbidden, instead we tag objects 'changed' and let the
depgraph code sort it out
- Removed all old "Ika" code
- Depgraph is aware of all relationships, including meta balls,
constraints, bevelcurve, and so on.
- Made depgraph aware of relation types and layers, to do smart
flushing of 'changed' events. Nothing gets calculated too often!
- Transform uses depgraph to detect changes
- On frame-advance, depgraph flushes animated changes
Armatures;
Almost all armature related code has been fully built from scratch.
It now reveils the original design much better, with a very clean
implementation, lag free without even calculating each Bone more than
once. Result is quite a speedup yes!
Important to note is;
1) Armature is data containing the 'rest position'
2) Pose is the changes of rest position, and always on object level.
That way more Objects can use same Pose. Also constraints are in Pose
3) Actions only contain the Ipos to change values in Poses.
- Bones draw unrotated now
- Drawing bones speedup enormously (10-20 times)
- Bone selecting in EditMode, selection state is saved for PoseMode,
and vice-versa
- Undo in editmode
- Bone renaming does vertexgroups, constraints, posechannels, actions,
for all users of Armature in entire file
- Added Bone renaming in NKey panel
- Nkey PoseMode shows eulers now
- EditMode and PoseMode now have 'active' bone too (last clicked)
- Parenting in EditMode' CTRL+P, ALT+P, with nice options!
- Pose is added in Outliner now, with showing that constraints are in
the Pose, not Armature
- Disconnected IK solving from constraints. It's a separate phase now,
on top of the full Pose calculations
- Pose itself has a dependency graph too, so evaluation order is lag free.
TODO NOW;
- Rotating in Posemode has incorrect inverse transform (Martin will fix)
- Python Bone/Armature/Pose API disabled... needs full recode too
(wait for my doc!)
- Game engine will need upgrade too
- Depgraph code needs revision, cleanup, can be much faster!
(But, compliments for Jean-Luc, it works like a charm!)
- IK changed, it now doesnt use previous position to advance to next
position anymore. That system looks nice (no flips) but is not well
suited for NLA and background render.
TODO LATER;
We now can do loadsa new nifty features as well; like:
- Kill PoseMode (can be option for armatures itself)
- Make B-Bones (Bezier, Bspline, like for spines)
- Move all silly button level edit to 3d window (like CTRL+I = add
IK)
- Much better & informative drawing
- Fix action/nla editors
- Put all ipos in Actions (object, mesh key, lamp color)
- Add hooks
- Null bones
- Much more advanced constraints...
Bugfixes;
- OGL render (view3d header) had wrong first frame on anim render
- Ipo 'recording' mode had wrong playback speed
- Vertex-key mode now sticks to show 'active key', until frame change
-Ton-
2005-07-03 17:35:38 +00:00
|
|
|
void do_all_data_ipos(void);
|
2008-09-28 15:37:37 +00:00
|
|
|
int calc_ipo_spec(struct Ipo *ipo, int adrcode, float *ctime);
|
2002-10-12 11:37:38 +00:00
|
|
|
void clear_delta_obipo(struct Ipo *ipo);
|
2008-09-28 15:37:37 +00:00
|
|
|
void add_to_cfra_elem(struct ListBase *lb, struct BezTriple *bezt);
|
|
|
|
|
void make_cfra_list(struct Ipo *ipo, struct ListBase *elems);
|
2005-10-10 18:05:30 +00:00
|
|
|
|
2008-09-28 15:37:37 +00:00
|
|
|
/* the sort is an IPO_Channel... */
|
|
|
|
|
int IPO_GetChannels(struct Ipo *ipo, short *channels);
|
2002-10-12 11:37:38 +00:00
|
|
|
|
2008-09-28 15:37:37 +00:00
|
|
|
float IPO_GetFloatValue(struct Ipo *ipo,
|
|
|
|
|
/* struct IPO_Channel channel, */
|
|
|
|
|
/* channels are shorts... bit ugly for now*/
|
|
|
|
|
short c,
|
|
|
|
|
float ctime);
|
2002-10-12 11:37:38 +00:00
|
|
|
|
2008-06-24 22:19:00 +00:00
|
|
|
#ifdef __cplusplus
|
|
|
|
|
};
|
|
|
|
|
#endif
|
|
|
|
|
|
2002-10-12 11:37:38 +00:00
|
|
|
#endif
|
2002-10-30 02:07:20 +00:00
|
|
|
|
