doxygen: prevent GPL license block from being parsed as doxygen comment.
[blender.git] / source / blender / editors / transform / transform.h
1 /*
2  * $Id$
3  *
4  * ***** BEGIN GPL LICENSE BLOCK *****
5  *
6  * This program is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU General Public License
8  * as published by the Free Software Foundation; either version 2
9  * of the License, or (at your option) any later version.
10  *
11  * This program is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with this program; if not, write to the Free Software Foundation,
18  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
19  *
20  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
21  * All rights reserved.
22  *
23  * The Original Code is: all of this file.
24  *
25  * Contributor(s): none yet.
26  *
27  * ***** END GPL LICENSE BLOCK *****
28  */
29
30 #ifndef TRANSFORM_H
31 #define TRANSFORM_H
32
33 #include "ED_transform.h"
34 #include "ED_numinput.h"
35
36 #include "DNA_listBase.h"
37
38 #include "BLI_editVert.h"
39
40 /* ************************** Types ***************************** */
41
42 struct TransInfo;
43 struct TransData;
44 struct TransformOrientation;
45 struct TransSnap;
46 struct NumInput;
47 struct Object;
48 struct View3D;
49 struct ScrArea;
50 struct Scene;
51 struct bPose;
52 struct bConstraint;
53 struct BezTriple;
54 struct wmOperatorType;
55 struct wmOperator;
56 struct wmWindowManager;
57 struct wmKeyMap;
58 struct wmKeyConfig;
59 struct bContext;
60 struct wmEvent;
61 struct wmTimer;
62 struct ARegion;
63 struct ReportList;
64
65 typedef struct NDofInput {
66         int             flag;
67         int             axis;
68         float   fval[7];
69         float   factor[3];
70 } NDofInput;
71
72
73 /*
74         The ctrl value has different meaning:
75                 0                       : No value has been typed
76
77                 otherwise, |value| - 1 is where the cursor is located after the period
78                 Positive        : number is positive
79                 Negative        : number is negative
80 */
81
82 typedef struct TransSnapPoint {
83         struct TransSnapPoint *next,*prev;
84         float co[3];
85 } TransSnapPoint;
86
87 typedef struct TransSnap {
88         short   mode;
89         short   target;
90         short   modePoint;
91         short   modeSelect;
92         short   align;
93         short   project;
94         short   peel;
95         short   status;
96         float   snapPoint[3]; /* snapping from this point */
97         float   snapTarget[3]; /* to this point */
98         float   snapNormal[3];
99         float   snapTangent[3];
100         ListBase points;
101         float   dist; // Distance from snapPoint to snapTarget
102         double  last;
103         void  (*applySnap)(struct TransInfo *, float *);
104         void  (*calcSnap)(struct TransInfo *, float *);
105         void  (*targetSnap)(struct TransInfo *);
106         float  (*distance)(struct TransInfo *, float p1[3], float p2[3]); // Get the transform distance between two points (used by Closest snap)
107 } TransSnap;
108
109 typedef struct TransCon {
110         short orientation;       /**/
111         char  text[50];      /* Description of the Constraint for header_print                            */
112         float mtx[3][3];     /* Matrix of the Constraint space                                            */
113         float imtx[3][3];    /* Inverse Matrix of the Constraint space                                    */
114         float pmtx[3][3];    /* Projection Constraint Matrix (same as imtx with some axis == 0)           */
115         float center[3];     /* transformation center to define where to draw the view widget
116                                                         ALWAYS in global space. Unlike the transformation center                  */
117         short imval[2];      /* initial mouse value for visual calculation                                */
118                                                  /* the one in TransInfo is not garanty to stay the same (Rotates change it)  */
119         int   mode;          /* Mode flags of the Constraint                                              */
120         void  (*drawExtra)(struct TransInfo *);
121                                                  /* For constraints that needs to draw differently from the other
122                                                         uses this instead of the generic draw function                                                    */
123         void  (*applyVec)(struct TransInfo *, struct TransData *, float *, float *, float *);
124                                                  /* Apply function pointer for linear vectorial transformation                */
125                                                  /* The last three parameters are pointers to the in/out/printable vectors    */
126         void  (*applySize)(struct TransInfo *, struct TransData *, float [3][3]);
127                                                  /* Apply function pointer for size transformation */
128         void  (*applyRot)(struct TransInfo *, struct TransData *, float [3], float *);
129                                                  /* Apply function pointer for rotation transformation */
130 } TransCon;
131
132 typedef struct TransDataExtension {
133         float drot[3];           /* Initial object drot */
134         // float drotAngle;      /* Initial object drotAngle,    TODO: not yet implimented */
135         // float drotAxis[3];    /* Initial object drotAxis, TODO: not yet implimented */
136         float dquat[4];          /* Initial object dquat */
137         float dsize[3];          /* Initial object dsize */
138         float *rot;          /* Rotation of the data to transform (Faculative)                                 */
139         float  irot[3];      /* Initial rotation                                                               */
140         float *quat;         /* Rotation quaternion of the data to transform (Faculative)                      */
141         float  iquat[4];         /* Initial rotation quaternion                                                    */
142         float *rotAngle;         /* Rotation angle of the data to transform (Faculative)                                                 */
143         float  irotAngle;        /* Initial rotation angle                                                                                               */
144         float *rotAxis;          /* Rotation axis of the data to transform (Faculative)                                                  */
145         float  irotAxis[4];      /* Initial rotation axis                                                                                                        */
146         float *size;         /* Size of the data to transform (Faculative)                                     */
147         float  isize[3];         /* Initial size                                                                   */
148         float  obmat[4][4];      /* Object matrix */
149         float  l_smtx[3][3]; /* use instead of td->smtx, It is the same but without the 'bone->bone_mat', see TD_PBONE_LOCAL_MTX_C */
150         int    rotOrder;        /* rotation mode,  as defined in eRotationModes (DNA_action_types.h) */
151 } TransDataExtension;
152
153 typedef struct TransData2D {
154         float loc[3];           /* Location of data used to transform (x,y,0) */
155         float *loc2d;           /* Pointer to real 2d location of data */
156
157         float *h1, *h2;     /* Pointer to handle locations, if handles aren't being moved independantly*/
158         float ih1[2], ih2[2];
159 } TransData2D;
160
161 /* we need to store 2 handles for each transdata incase the other handle wasnt selected */
162 typedef struct TransDataCurveHandleFlags {
163         char ih1, ih2;
164         char *h1, *h2;
165 } TransDataCurveHandleFlags;
166
167 /* for sequencer transform */
168 typedef struct TransDataSeq {
169         struct Sequence *seq;
170         int flag;               /* a copy of seq->flag that may be modified for nested strips */
171         int start_offset; /* use this so we can have transform data at the strips start, but apply correctly to the start frame  */
172         short sel_flag; /* one of SELECT, SEQ_LEFTSEL and SEQ_RIGHTSEL */
173
174 } TransDataSeq;
175
176 /* for NLA transform (stored in td->extra pointer) */
177 typedef struct TransDataNla {
178         ID *id;                                         /* ID-block NLA-data is attached to */
179         
180         struct NlaTrack *oldTrack;      /* Original NLA-Track that the strip belongs to */
181         struct NlaTrack *nlt;           /* Current NLA-Track that the strip belongs to */
182         
183         struct NlaStrip *strip;         /* NLA-strip this data represents */
184         
185         /* dummy values for transform to write in - must have 3 elements... */
186         float h1[3];                            /* start handle */
187         float h2[3];                            /* end handle */
188         
189         int trackIndex;                         /* index of track that strip is currently in */
190         int handle;                                     /* handle-index: 0 for dummy entry, -1 for start, 1 for end, 2 for both ends */
191 } TransDataNla;
192
193 struct LinkNode;
194 struct EditEdge;
195 struct EditVert;
196 struct GHash;
197 typedef struct TransDataSlideUv {
198         float origuv[2];
199         float *uv_up, *uv_down;
200         //float *fuv[4];
201         struct LinkNode *fuv_list;
202 } TransDataSlideUv;
203
204 typedef struct TransDataSlideVert {
205         struct EditEdge *up, *down;
206         struct EditVert origvert;
207 } TransDataSlideVert;
208
209 typedef struct SlideData {
210         TransDataSlideUv *slideuv, *suv_last;
211         int totuv, uvlay_tot;
212         struct GHash *vhash, **uvhash;
213         struct EditVert *nearest;
214         struct LinkNode *edgelist, *vertlist;
215         short start[2], end[2];
216 } SlideData;
217
218 typedef struct TransData {
219         float  dist;         /* Distance needed to affect element (for Proportionnal Editing)                  */
220         float  rdist;        /* Distance to the nearest element (for Proportionnal Editing)                    */
221         float  factor;       /* Factor of the transformation (for Proportionnal Editing)                       */
222         float *loc;          /* Location of the data to transform                                              */
223         float  iloc[3];      /* Initial location                                                               */
224         float *val;          /* Value pointer for special transforms */
225         float  ival;         /* Old value*/
226         float  center[3];        /* Individual data center                                                         */
227         float  mtx[3][3];    /* Transformation matrix from data space to global space                          */
228         float  smtx[3][3];   /* Transformation matrix from global space to data space                          */
229         float  axismtx[3][3];/* Axis orientation matrix of the data                                            */
230         struct Object *ob;
231         struct bConstraint *con;        /* for objects/bones, the first constraint in its constraint stack */
232         TransDataExtension *ext;        /* for objects, poses. 1 single malloc per TransInfo! */
233         TransDataCurveHandleFlags *hdata; /* for curves, stores handle flags for modification/cancel */
234         void  *extra;            /* extra data (mirrored element pointer, in editmode mesh to EditVert) (editbone for roll fixing) (...) */
235         int  flag;         /* Various flags */
236         short  protectflag;      /* If set, copy of Object or PoseChannel protection */
237 } TransData;
238
239 typedef struct MouseInput {
240         void    (*apply)(struct TransInfo *, struct MouseInput *, short [2], float [3]);
241         void    (*post)(struct TransInfo *, float [3]);
242
243         short   imval[2];               /* initial mouse position                */
244         char    precision;
245         short   precision_mval[2];      /* mouse position when precision key was pressed */
246         int             center[2];
247         float   factor;
248         void    *data; /* additional data, if needed by the particular function */
249 } MouseInput;
250
251 typedef struct TransInfo {
252         int         mode;           /* current mode                         */
253         int             flag;           /* generic flags for special behaviors  */
254         int                     modifiers;              /* special modifiers, by function, not key */
255         short           state;                  /* current state (running, canceled,...)*/
256         int         options;        /* current context/options for transform                      */
257         float       val;            /* init value for some transformations (and rotation angle)  */
258         float       fac;            /* factor for distance based transform  */
259         int       (*transform)(struct TransInfo *, short *);
260                                                                 /* transform function pointer           */
261         int       (*handleEvent)(struct TransInfo *, struct wmEvent *);
262                                                                 /* event handler function pointer  RETURN 1 if redraw is needed */
263         int         total;          /* total number of transformed data     */
264         TransData  *data;           /* transformed data (array)             */
265         TransDataExtension *ext;        /* transformed data extension (array)   */
266         TransData2D *data2d;            /* transformed data for 2d (array)      */
267         TransCon    con;            /* transformed constraint               */
268         TransSnap       tsnap;
269         NumInput    num;            /* numerical input                      */
270         NDofInput   ndof;           /* ndof input                           */
271         MouseInput      mouse;                  /* mouse input                          */
272         char        redraw;         /* redraw flag                          */
273         float           prop_size;              /* proportional circle radius           */
274         char            proptext[20];   /* proportional falloff text                    */
275         float       center[3];      /* center of transformation             */
276         int         center2d[2];    /* center in screen coordinates         */
277         short       imval[2];       /* initial mouse position               */
278         short           event_type;             /* event->type used to invoke transform */
279         short       idx_max;            /* maximum index on the input vector    */
280         float           snap[3];                /* Snapping Gears                                               */
281         char            frame_side;             /* Mouse side of the cfra, 'L', 'R' or 'B' */
282
283         float           viewmat[4][4];  /* copy from G.vd, prevents feedback,   */
284         float           viewinv[4][4];  /* and to make sure we don't have to    */
285         float           persmat[4][4];  /* access G.vd from other space types   */
286         float           persinv[4][4];
287         short           persp;
288         short           around;
289         char            spacetype;              /* spacetype where transforming is      */
290         char            helpline;               /* helpline modes (not to be confused with hotline) */
291
292         float           vec[3];                 /* translation, to show for widget      */
293         float           mat[3][3];              /* rot/rescale, to show for widget      */
294
295         char            *undostr;               /* if set, uses this string for undo            */
296         float           spacemtx[3][3]; /* orientation matrix of the current space      */
297         char            spacename[32];  /* name of the current space                            */
298
299         struct Object *poseobj;         /* if t->flag & T_POSE, this denotes pose object */
300
301         void       *customData;         /* Per Transform custom data */
302         void      (*customFree)(struct TransInfo *); /* if a special free function is needed */
303
304         /*************** NEW STUFF *********************/
305         short           launch_event;   /* event type used to launch transform */
306
307         short           current_orientation;
308         short           twtype;                 /* backup from view3d, to restore on end */
309
310         short           prop_mode;
311         
312         short           mirror;
313
314         float           values[4];
315         float           auto_values[4];
316         float           axis[3];
317         float           axis_orig[3];   /* TransCon can change 'axis', store the original value here */
318
319         void            *view;
320         struct bContext *context; /* Only valid (non null) during an operator called function. */
321         struct ScrArea  *sa;
322         struct ARegion  *ar;
323         struct Scene    *scene;
324         struct ToolSettings *settings;
325         struct wmTimer *animtimer;
326         short       mval[2];        /* current mouse position               */
327         struct Object   *obedit;
328         void            *draw_handle_apply;
329         void            *draw_handle_view;
330         void            *draw_handle_pixel;
331         void            *draw_handle_cursor;
332 } TransInfo;
333
334
335 /* ******************** Macros & Prototypes *********************** */
336
337 /* NDOFINPUT FLAGS */
338 #define NDOF_INIT                       1
339
340 /* transinfo->state */
341 #define TRANS_STARTING  0
342 #define TRANS_RUNNING   1
343 #define TRANS_CONFIRM   2
344 #define TRANS_CANCEL    3
345
346 /* transinfo->redraw */
347 #define TREDRAW_NOTHING         0
348 #define TREDRAW_HARD            1
349 #define TREDRAW_SOFT            2
350
351
352 /* transinfo->flag */
353 #define T_OBJECT                (1 << 0)
354 #define T_EDIT                  (1 << 1)
355 #define T_POSE                  (1 << 2)
356 #define T_TEXTURE               (1 << 3)
357 #define T_CAMERA                (1 << 4)
358                  // trans on points, having no rotation/scale
359 #define T_POINTS                (1 << 6)
360                 // for manipulator exceptions, like scaling using center point, drawing help lines
361 #define T_USES_MANIPULATOR      (1 << 7)
362
363         /* restrictions flags */
364 #define T_ALL_RESTRICTIONS      ((1 << 8)|(1 << 9)|(1 << 10))
365 #define T_NO_CONSTRAINT         (1 << 8)
366 #define T_NULL_ONE                      (1 << 9)
367 #define T_NO_ZERO                       (1 << 10)
368
369 #define T_PROP_EDIT                     (1 << 11)
370 #define T_PROP_CONNECTED        (1 << 12)
371
372 #define T_V3D_ALIGN                     (1 << 14)
373         /* for 2d views like uv or ipo */
374 #define T_2D_EDIT                       (1 << 15)
375 #define T_CLIP_UV                       (1 << 16)
376
377 #define T_FREE_CUSTOMDATA       (1 << 17)
378         /* auto-ik is on */
379 #define T_AUTOIK                        (1 << 18)
380
381 #define T_MIRROR                        (1 << 19)
382
383 #define T_AUTOVALUES            (1 << 20)
384
385         /* to specificy if we save back settings at the end */
386 #define T_MODAL                         (1 << 21)
387
388         /* no retopo */
389 #define T_NO_PROJECT            (1 << 22)
390
391 #define T_RELEASE_CONFIRM       (1 << 23)
392
393 /* TransInfo->modifiers */
394 #define MOD_CONSTRAINT_SELECT   0x01
395 #define MOD_PRECISION                   0x02
396 #define MOD_SNAP                                0x04
397 #define MOD_SNAP_INVERT                 0x08
398 #define MOD_CONSTRAINT_PLANE    0x10
399
400
401 /* ******************************************************************************** */
402
403 /* transinfo->helpline */
404 #define HLP_NONE                0
405 #define HLP_SPRING              1
406 #define HLP_ANGLE               2
407 #define HLP_HARROW              3
408 #define HLP_VARROW              4
409 #define HLP_TRACKBALL   5
410
411 /* transinfo->con->mode */
412 #define CON_APPLY               1
413 #define CON_AXIS0               2
414 #define CON_AXIS1               4
415 #define CON_AXIS2               8
416 #define CON_SELECT              16
417 #define CON_NOFLIP              32      /* does not reorient vector to face viewport when on */
418 #define CON_USER                64
419
420 /* transdata->flag */
421 #define TD_SELECTED                     1
422 #define TD_ACTIVE                       (1 << 1)
423 #define TD_NOACTION                     (1 << 2)
424 #define TD_USEQUAT                      (1 << 3)
425 #define TD_NOTCONNECTED         (1 << 4)
426 #define TD_SINGLESIZE           (1 << 5)        /* used for scaling of MetaElem->rad */
427 /*#define TD_TIMEONLY                   (1 << 8) */ /*UNUSED*/
428 #define TD_NOCENTER                     (1 << 9)
429 #define TD_NO_EXT                       (1 << 10)       /* ext abused for particle key timing */
430 #define TD_SKIP                         (1 << 11)       /* don't transform this data */
431 #define TD_BEZTRIPLE            (1 << 12)       /* if this is a bez triple, we need to restore the handles, if this is set transdata->misc.hdata needs freeing */
432 #define TD_NO_LOC                       (1 << 13)       /* when this is set, don't apply translation changes to this element */
433 #define TD_NOTIMESNAP           (1 << 14)       /* for Graph Editor autosnap, indicates that point should not undergo autosnapping */
434 #define TD_INTVALUES            (1 << 15)       /* for Graph Editor - curves that can only have int-values need their keyframes tagged with this */
435 #define TD_MIRROR_EDGE          (1 << 16)       /* For editmode mirror, clamp to x = 0 */
436 #define TD_MOVEHANDLE1          (1 << 17)       /* For fcurve handles, move them along with their keyframes */
437 #define TD_MOVEHANDLE2          (1 << 18)
438 #define TD_PBONE_LOCAL_MTX_P (1 << 19)  /* exceptional case with pose bone rotating when a parent bone has 'Local Location' option enabled and rotating also transforms it. */
439 #define TD_PBONE_LOCAL_MTX_C (1 << 20)  /* same as above but for a child bone */
440
441 /* transsnap->status */
442 #define SNAP_FORCED             1
443 #define TARGET_INIT             2
444 #define POINT_INIT              4
445 #define MULTI_POINTS    8
446
447 void TRANSFORM_OT_transform(struct wmOperatorType *ot);
448
449 int initTransform(struct bContext *C, struct TransInfo *t, struct wmOperator *op, struct wmEvent *event, int mode);
450 void saveTransform(struct bContext *C, struct TransInfo *t, struct wmOperator *op);
451 int  transformEvent(TransInfo *t, struct wmEvent *event);
452 void transformApply(struct bContext *C, TransInfo *t);
453 int  transformEnd(struct bContext *C, TransInfo *t);
454
455 void setTransformViewMatrices(TransInfo *t);
456 void convertViewVec(TransInfo *t, float *vec, short dx, short dy);
457 void projectIntView(TransInfo *t, float *vec, int *adr);
458 void projectFloatView(TransInfo *t, float *vec, float *adr);
459
460 void applyAspectRatio(TransInfo *t, float *vec);
461 void removeAspectRatio(TransInfo *t, float *vec);
462
463 void initWarp(TransInfo *t);
464 int handleEventWarp(TransInfo *t, struct wmEvent *event);
465 int Warp(TransInfo *t, short mval[2]);
466
467 void initShear(TransInfo *t);
468 int handleEventShear(TransInfo *t, struct wmEvent *event);
469 int Shear(TransInfo *t, short mval[2]);
470
471 void initResize(TransInfo *t);
472 int Resize(TransInfo *t, short mval[2]);
473
474 void initTranslation(TransInfo *t);
475 int Translation(TransInfo *t, short mval[2]);
476
477 void initToSphere(TransInfo *t);
478 int ToSphere(TransInfo *t, short mval[2]);
479
480 void initRotation(TransInfo *t);
481 int Rotation(TransInfo *t, short mval[2]);
482
483 void initShrinkFatten(TransInfo *t);
484 int ShrinkFatten(TransInfo *t, short mval[2]);
485
486 void initTilt(TransInfo *t);
487 int Tilt(TransInfo *t, short mval[2]);
488
489 void initCurveShrinkFatten(TransInfo *t);
490 int CurveShrinkFatten(TransInfo *t, short mval[2]);
491
492 void initTrackball(TransInfo *t);
493 int Trackball(TransInfo *t, short mval[2]);
494
495 void initPushPull(TransInfo *t);
496 int PushPull(TransInfo *t, short mval[2]);
497
498 void initBevel(TransInfo *t);
499 int handleEventBevel(TransInfo *t, struct wmEvent *event);
500 int Bevel(TransInfo *t, short mval[2]);
501
502 void initBevelWeight(TransInfo *t);
503 int BevelWeight(TransInfo *t, short mval[2]);
504
505 void initCrease(TransInfo *t);
506 int Crease(TransInfo *t, short mval[2]);
507
508 void initBoneSize(TransInfo *t);
509 int BoneSize(TransInfo *t, short mval[2]);
510
511 void initBoneEnvelope(TransInfo *t);
512 int BoneEnvelope(TransInfo *t, short mval[2]);
513
514 void initBoneRoll(TransInfo *t);
515 int BoneRoll(TransInfo *t, short mval[2]);
516
517 void initEdgeSlide(TransInfo *t);
518 int EdgeSlide(TransInfo *t, short mval[2]);
519
520 void initTimeTranslate(TransInfo *t);
521 int TimeTranslate(TransInfo *t, short mval[2]);
522
523 void initTimeSlide(TransInfo *t);
524 int TimeSlide(TransInfo *t, short mval[2]);
525
526 void initTimeScale(TransInfo *t);
527 int TimeScale(TransInfo *t, short mval[2]);
528
529 void initBakeTime(TransInfo *t);
530 int BakeTime(TransInfo *t, short mval[2]);
531
532 void initMirror(TransInfo *t);
533 int Mirror(TransInfo *t, short mval[2]);
534
535 void initAlign(TransInfo *t);
536 int Align(TransInfo *t, short mval[2]);
537
538 void initSeqSlide(TransInfo *t);
539 int SeqSlide(TransInfo *t, short mval[2]);
540
541 void drawPropCircle(const struct bContext *C, TransInfo *t);
542
543 struct wmKeyMap *transform_modal_keymap(struct wmKeyConfig *keyconf);
544
545
546 /*********************** transform_conversions.c ********** */
547 struct ListBase;
548
549 void flushTransGPactionData(TransInfo *t);
550 void flushTransGraphData(TransInfo *t);
551 void remake_graph_transdata(TransInfo *t, struct ListBase *anim_data);
552 void flushTransUVs(TransInfo *t);
553 void flushTransParticles(TransInfo *t);
554 int clipUVTransform(TransInfo *t, float *vec, int resize);
555 void flushTransNodes(TransInfo *t);
556 void flushTransSeq(TransInfo *t);
557
558 /*********************** exported from transform_manipulator.c ********** */
559 int gimbal_axis(struct Object *ob, float gmat[][3]); /* return 0 when no gimbal for selection */
560 int calc_manipulator_stats(const struct bContext *C);
561
562 /*********************** TransData Creation and General Handling *********** */
563 void createTransData(struct bContext *C, TransInfo *t);
564 void sort_trans_data_dist(TransInfo *t);
565 void add_tdi_poin(float *poin, float *old, float delta);
566 void special_aftertrans_update(struct bContext *C, TransInfo *t);
567
568 void transform_autoik_update(TransInfo *t, short mode);
569
570 int count_set_pose_transflags(int *out_mode, short around, struct Object *ob);
571
572 /* auto-keying stuff used by special_aftertrans_update */
573 void autokeyframe_ob_cb_func(struct bContext *C, struct Scene *scene, struct View3D *v3d, struct Object *ob, int tmode);
574 void autokeyframe_pose_cb_func(struct bContext *C, struct Scene *scene, struct View3D *v3d, struct Object *ob, int tmode, short targetless_ik);
575
576 /*********************** Constraints *****************************/
577
578 void drawConstraint(TransInfo *t);
579
580 void getConstraintMatrix(TransInfo *t);
581 void setConstraint(TransInfo *t, float space[3][3], int mode, const char text[]);
582 void setLocalConstraint(TransInfo *t, int mode, const char text[]);
583 void setUserConstraint(TransInfo *t, short orientation, int mode, const char text[]);
584
585 void constraintNumInput(TransInfo *t, float vec[3]);
586
587 int isLockConstraint(TransInfo *t);
588 int getConstraintSpaceDimension(TransInfo *t);
589 char constraintModeToChar(TransInfo *t);
590
591 void startConstraint(TransInfo *t);
592 void stopConstraint(TransInfo *t);
593
594 void initSelectConstraint(TransInfo *t, float mtx[3][3]);
595 void selectConstraint(TransInfo *t);
596 void postSelectConstraint(TransInfo *t);
597
598 void setNearestAxis(TransInfo *t);
599
600 /*********************** Snapping ********************************/
601
602 typedef enum {
603         NO_GEARS        = 0,
604         BIG_GEARS       = 1,
605         SMALL_GEARS     = 2
606 } GearsType;
607
608 void snapGrid(TransInfo *t, float *val);
609 void snapGridAction(TransInfo *t, float *val, GearsType action);
610
611 int activeSnap(TransInfo *t);
612 int validSnap(TransInfo *t);
613
614 void initSnapping(struct TransInfo *t, struct wmOperator *op);
615 void applyProject(TransInfo *t);
616 void applySnapping(TransInfo *t, float *vec);
617 void resetSnapping(TransInfo *t);
618 int  handleSnapping(TransInfo *t, struct wmEvent *event);
619 void drawSnapping(const struct bContext *C, TransInfo *t);
620 int usingSnappingNormal(TransInfo *t);
621 int validSnappingNormal(TransInfo *t);
622
623 void getSnapPoint(TransInfo *t, float vec[3]);
624 void addSnapPoint(TransInfo *t);
625 void removeSnapPoint(TransInfo *t);
626
627 /********************** Mouse Input ******************************/
628
629 typedef enum {
630         INPUT_NONE,
631         INPUT_VECTOR,
632         INPUT_SPRING,
633         INPUT_SPRING_FLIP,
634         INPUT_ANGLE,
635         INPUT_TRACKBALL,
636         INPUT_HORIZONTAL_RATIO,
637         INPUT_HORIZONTAL_ABSOLUTE,
638         INPUT_VERTICAL_RATIO,
639         INPUT_VERTICAL_ABSOLUTE,
640         INPUT_CUSTOM_RATIO
641 } MouseInputMode;
642
643 void initMouseInput(TransInfo *t, MouseInput *mi, int center[2], short mval[2]);
644 void initMouseInputMode(TransInfo *t, MouseInput *mi, MouseInputMode mode);
645 int handleMouseInput(struct TransInfo *t, struct MouseInput *mi, struct wmEvent *event);
646 void applyMouseInput(struct TransInfo *t, struct MouseInput *mi, short mval[2], float output[3]);
647
648 void setCustomPoints(TransInfo *t, MouseInput *mi, short start[2], short end[2]);
649 void setInputPostFct(MouseInput *mi, void       (*post)(struct TransInfo *, float [3]));
650
651 /*********************** Generics ********************************/
652
653 int initTransInfo(struct bContext *C, TransInfo *t, struct wmOperator *op, struct wmEvent *event);
654 void postTrans (struct bContext *C, TransInfo *t);
655 void resetTransRestrictions(TransInfo *t);
656
657 void drawLine(TransInfo *t, float *center, float *dir, char axis, short options);
658
659 TransDataCurveHandleFlags *initTransDataCurveHandes(TransData *td, struct BezTriple *bezt);
660
661 /* DRAWLINE options flags */
662 #define DRAWLIGHT       1
663
664 void applyTransObjects(TransInfo *t);
665 void restoreTransObjects(TransInfo *t);
666 void restoreTransNodes(TransInfo *t);
667 void recalcData(TransInfo *t);
668
669 void calculateCenter(TransInfo *t);
670 void calculateCenter2D(TransInfo *t);
671 void calculateCenterBound(TransInfo *t);
672 void calculateCenterMedian(TransInfo *t);
673 void calculateCenterCursor(TransInfo *t);
674
675 void calculateCenterCursor2D(TransInfo *t);
676 void calculatePropRatio(TransInfo *t);
677
678 void getViewVector(TransInfo *t, float coord[3], float vec[3]);
679
680 /*********************** NDofInput ********************************/
681
682 void initNDofInput(NDofInput *n);
683 int hasNDofInput(NDofInput *n);
684 void applyNDofInput(NDofInput *n, float *vec);
685 int handleNDofInput(NDofInput *n, struct wmEvent *event);
686
687 /* handleNDofInput return values */
688 #define NDOF_REFRESH    1
689 #define NDOF_NOMOVE             2
690 #define NDOF_CONFIRM    3
691 #define NDOF_CANCEL             4
692
693
694 /*********************** Transform Orientations ******************************/
695
696 void initTransformOrientation(struct bContext *C, TransInfo *t);
697
698 struct TransformOrientation *createObjectSpace(struct bContext *C, struct ReportList *reports, char *name, int overwrite);
699 struct TransformOrientation *createMeshSpace(struct bContext *C, struct ReportList *reports, char *name, int overwrite);
700 struct TransformOrientation *createBoneSpace(struct bContext *C, struct ReportList *reports, char *name, int overwrite);
701
702 /* Those two fill in mat and return non-zero on success */
703 int createSpaceNormal(float mat[3][3], float normal[3]);
704 int createSpaceNormalTangent(float mat[3][3], float normal[3], float tangent[3]);
705
706 struct TransformOrientation *addMatrixSpace(struct bContext *C, float mat[3][3], char name[], int overwrite);
707 int addObjectSpace(struct bContext *C, struct Object *ob);
708 void applyTransformOrientation(const struct bContext *C, float mat[3][3], char *name);
709
710 #define ORIENTATION_NONE        0
711 #define ORIENTATION_NORMAL      1
712 #define ORIENTATION_VERT        2
713 #define ORIENTATION_EDGE        3
714 #define ORIENTATION_FACE        4
715
716 int getTransformOrientation(const struct bContext *C, float normal[3], float plane[3], int activeOnly);
717
718 void freeSlideVerts(TransInfo *t);
719
720 #endif