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