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