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