Merge branch 'master' into blender2.8
[blender.git] / source / blender / editors / animation / keyframing.c
index 979e6df..25b3b4f 100644 (file)
@@ -29,7 +29,7 @@
  *  \ingroup edanimation
  */
 
+
 #include <stdio.h>
 #include <stddef.h>
 #include <string.h>
 short ANIM_get_keyframing_flags(Scene *scene, short incl_mode)
 {
        eInsertKeyFlags flag = INSERTKEY_NOFLAGS;
-       
+
        /* standard flags */
        {
                /* visual keying */
-               if (IS_AUTOKEY_FLAG(scene, AUTOMATKEY)) 
+               if (IS_AUTOKEY_FLAG(scene, AUTOMATKEY))
                        flag |= INSERTKEY_MATRIX;
-               
+
                /* only needed */
-               if (IS_AUTOKEY_FLAG(scene, INSERTNEEDED)) 
+               if (IS_AUTOKEY_FLAG(scene, INSERTNEEDED))
                        flag |= INSERTKEY_NEEDED;
-               
+
                /* default F-Curve color mode - RGB from XYZ indices */
-               if (IS_AUTOKEY_FLAG(scene, XYZ2RGB)) 
+               if (IS_AUTOKEY_FLAG(scene, XYZ2RGB))
                        flag |= INSERTKEY_XYZ2RGB;
        }
-               
+
        /* only if including settings from the autokeying mode... */
        if (incl_mode) {
                /* keyframing mode - only replace existing keyframes */
-               if (IS_AUTOKEY_MODE(scene, EDITKEYS)) 
+               if (IS_AUTOKEY_MODE(scene, EDITKEYS))
                        flag |= INSERTKEY_REPLACE;
        }
-               
+
        return flag;
 }
 
 /* ******************************************* */
 /* Animation Data Validation */
 
-/* Get (or add relevant data to be able to do so) the Active Action for the given 
+/* Get (or add relevant data to be able to do so) the Active Action for the given
  * Animation Data block, given an ID block where the Animation Data should reside.
  */
 bAction *verify_adt_action(ID *id, short add)
 {
        AnimData *adt;
-       
+
        /* init animdata if none available yet */
        adt = BKE_animdata_from_id(id);
        if ((adt == NULL) && (add))
@@ -146,10 +146,10 @@ bAction *verify_adt_action(ID *id, short add)
                /* init action name from name of ID block */
                char actname[sizeof(id->name) - 2];
                BLI_snprintf(actname, sizeof(actname), "%sAction", id->name + 2);
-               
+
                /* create action */
                adt->action = BKE_action_add(G.main, actname);
-               
+
                /* set ID-type from ID-block that this is going to be assigned to
                 * so that users can't accidentally break actions by assigning them
                 * to the wrong places
@@ -167,54 +167,54 @@ bAction *verify_adt_action(ID *id, short add)
        return adt->action;
 }
 
-/* Get (or add relevant data to be able to do so) F-Curve from the Active Action, 
+/* Get (or add relevant data to be able to do so) F-Curve from the Active Action,
  * for the given Animation Data block. This assumes that all the destinations are valid.
  */
-FCurve *verify_fcurve(bAction *act, const char group[], PointerRNA *ptr, 
+FCurve *verify_fcurve(bAction *act, const char group[], PointerRNA *ptr,
                       const char rna_path[], const int array_index, short add)
 {
        bActionGroup *agrp;
        FCurve *fcu;
-       
+
        /* sanity checks */
        if (ELEM(NULL, act, rna_path))
                return NULL;
-               
-       /* try to find f-curve matching for this setting 
+
+       /* try to find f-curve matching for this setting
         *      - add if not found and allowed to add one
         *              TODO: add auto-grouping support? how this works will need to be resolved
         */
        fcu = list_find_fcurve(&act->curves, rna_path, array_index);
-       
+
        if ((fcu == NULL) && (add)) {
                /* use default settings to make a F-Curve */
                fcu = MEM_callocN(sizeof(FCurve), "FCurve");
-               
+
                fcu->flag = (FCURVE_VISIBLE | FCURVE_SELECTED);
                fcu->auto_smoothing = FCURVE_SMOOTH_CONT_ACCEL;
                if (BLI_listbase_is_empty(&act->curves))
                        fcu->flag |= FCURVE_ACTIVE;  /* first one added active */
-                       
+
                /* store path - make copy, and store that */
                fcu->rna_path = BLI_strdup(rna_path);
                fcu->array_index = array_index;
-               
+
                /* if a group name has been provided, try to add or find a group, then add F-Curve to it */
                if (group) {
                        /* try to find group */
                        agrp = BKE_action_group_find_name(act, group);
-                       
+
                        /* no matching groups, so add one */
                        if (agrp == NULL) {
                                agrp = action_groups_add_new(act, group);
-                               
+
                                /* sync bone group colors if applicable */
                                if (ptr && (ptr->type == &RNA_PoseBone)) {
                                        Object *ob = (Object *)ptr->id.data;
                                        bPoseChannel *pchan = (bPoseChannel *)ptr->data;
                                        bPose *pose = ob->pose;
                                        bActionGroup *grp;
-                                       
+
                                        /* find bone group (if present), and use the color from that */
                                        grp = (bActionGroup *)BLI_findlink(&pose->agroups, (pchan->agrp_index - 1));
                                        if (grp) {
@@ -223,7 +223,7 @@ FCurve *verify_fcurve(bAction *act, const char group[], PointerRNA *ptr,
                                        }
                                }
                        }
-                       
+
                        /* add F-Curve to group */
                        action_groups_add_channel(act, agrp, fcu);
                }
@@ -232,7 +232,7 @@ FCurve *verify_fcurve(bAction *act, const char group[], PointerRNA *ptr,
                        BLI_addtail(&act->curves, fcu);
                }
        }
-       
+
        /* return the F-Curve */
        return fcu;
 }
@@ -285,10 +285,10 @@ void update_autoflags_fcurve(FCurve *fcu, bContext *C, ReportList *reports, Poin
                            idname, fcu->rna_path);
                return;
        }
-       
+
        /* update F-Curve flags */
        update_autoflags_fcurve_direct(fcu, prop);
-       
+
        if (old_flag != fcu->flag) {
                /* Same as if keyframes had been changed */
                WM_event_add_notifier(C, NC_ANIMATION | ND_KEYFRAME | NA_EDITED, NULL);
@@ -300,7 +300,7 @@ void update_autoflags_fcurve(FCurve *fcu, bContext *C, ReportList *reports, Poin
 
 /* -------------- BezTriple Insertion -------------------- */
 
-/* This function adds a given BezTriple to an F-Curve. It will allocate 
+/* This function adds a given BezTriple to an F-Curve. It will allocate
  * memory for the array if needed, and will insert the BezTriple into a
  * suitable place in chronological order.
  *
@@ -310,12 +310,12 @@ void update_autoflags_fcurve(FCurve *fcu, bContext *C, ReportList *reports, Poin
 int insert_bezt_fcurve(FCurve *fcu, const BezTriple *bezt, eInsertKeyFlags flag)
 {
        int i = 0;
-       
+
        /* are there already keyframes? */
        if (fcu->bezt) {
                bool replace;
                i = binarysearch_bezt_index(fcu->bezt, bezt->vec[1][0], fcu->totvert, &replace);
-               
+
                /* replace an existing keyframe? */
                if (replace) {
                        /* sanity check: 'i' may in rare cases exceed arraylen */
@@ -327,16 +327,16 @@ int insert_bezt_fcurve(FCurve *fcu, const BezTriple *bezt, eInsertKeyFlags flag)
                                        /* just change the values when replacing, so as to not overwrite handles */
                                        BezTriple *dst = (fcu->bezt + i);
                                        float dy = bezt->vec[1][1] - dst->vec[1][1];
-                                       
+
                                        /* just apply delta value change to the handle values */
                                        dst->vec[0][1] += dy;
                                        dst->vec[1][1] += dy;
                                        dst->vec[2][1] += dy;
-                                       
+
                                        dst->f1 = bezt->f1;
                                        dst->f2 = bezt->f2;
                                        dst->f3 = bezt->f3;
-                                       
+
                                        /* TODO: perform some other operations? */
                                }
                        }
@@ -345,29 +345,29 @@ int insert_bezt_fcurve(FCurve *fcu, const BezTriple *bezt, eInsertKeyFlags flag)
                else if ((flag & INSERTKEY_REPLACE) == 0) {
                        /* insert new - if we're not restricted to replacing keyframes only */
                        BezTriple *newb = MEM_callocN((fcu->totvert + 1) * sizeof(BezTriple), "beztriple");
-                       
+
                        /* add the beztriples that should occur before the beztriple to be pasted (originally in fcu) */
                        if (i > 0)
                                memcpy(newb, fcu->bezt, i * sizeof(BezTriple));
-                       
+
                        /* add beztriple to paste at index i */
                        *(newb + i) = *bezt;
-                       
+
                        /* add the beztriples that occur after the beztriple to be pasted (originally in fcu) */
-                       if (i < fcu->totvert) 
+                       if (i < fcu->totvert)
                                memcpy(newb + i + 1, fcu->bezt + i, (fcu->totvert - i) * sizeof(BezTriple));
-                       
+
                        /* replace (+ free) old with new, only if necessary to do so */
                        MEM_freeN(fcu->bezt);
                        fcu->bezt = newb;
-                       
+
                        fcu->totvert++;
                }
        }
        /* no keyframes already, but can only add if...
         *      1) keyframing modes say that keyframes can only be replaced, so adding new ones won't know
         *      2) there are no samples on the curve
-        *              // NOTE: maybe we may want to allow this later when doing samples -> bezt conversions, 
+        *              // NOTE: maybe we may want to allow this later when doing samples -> bezt conversions,
         *              // but for now, having both is asking for trouble
         */
        else if ((flag & INSERTKEY_REPLACE) == 0 && (fcu->fpt == NULL)) {
@@ -381,9 +381,9 @@ int insert_bezt_fcurve(FCurve *fcu, const BezTriple *bezt, eInsertKeyFlags flag)
                /* return error code -1 to prevent any misunderstandings */
                return -1;
        }
-       
-       
-       /* we need to return the index, so that some tools which do post-processing can 
+
+
+       /* we need to return the index, so that some tools which do post-processing can
         * detect where we added the BezTriple in the array
         */
        return i;
@@ -403,8 +403,8 @@ int insert_vert_fcurve(FCurve *fcu, float x, float y, eBezTriple_KeyframeType ke
        BezTriple beztr = {{{0}}};
        unsigned int oldTot = fcu->totvert;
        int a;
-       
-       /* set all three points, for nicer start position 
+
+       /* set all three points, for nicer start position
         * NOTE: +/- 1 on vec.x for left and right handles is so that 'free' handles work ok...
         */
        beztr.vec[0][0] = x - 1.0f;
@@ -414,7 +414,7 @@ int insert_vert_fcurve(FCurve *fcu, float x, float y, eBezTriple_KeyframeType ke
        beztr.vec[2][0] = x + 1.0f;
        beztr.vec[2][1] = y;
        beztr.f1 = beztr.f2 = beztr.f3 = SELECT;
-       
+
        /* set default handle types and interpolation mode */
        if (flag & INSERTKEY_NO_USERPREF) {
                /* for Py-API, we want scripts to have predictable behaviour,
@@ -426,11 +426,11 @@ int insert_vert_fcurve(FCurve *fcu, float x, float y, eBezTriple_KeyframeType ke
        else {
                /* for UI usage - defaults should come from the userprefs and/or toolsettings */
                beztr.h1 = beztr.h2 = U.keyhandles_new; /* use default handle type here */
-               
+
                /* use default interpolation mode, with exceptions for int/discrete values */
                beztr.ipo = U.ipo_new;
        }
-       
+
        /* interpolation type used is constrained by the type of values the curve can take */
        if (fcu->flag & FCURVE_DISCRETE_VALUES) {
                beztr.ipo = BEZT_IPO_CONST;
@@ -438,10 +438,10 @@ int insert_vert_fcurve(FCurve *fcu, float x, float y, eBezTriple_KeyframeType ke
        else if ((beztr.ipo == BEZT_IPO_BEZ) && (fcu->flag & FCURVE_INT_VALUES)) {
                beztr.ipo = BEZT_IPO_LIN;
        }
-       
+
        /* set keyframe type value (supplied), which should come from the scene settings in most cases */
        BEZKEYTYPE(&beztr) = keyframe_type;
-       
+
        /* set default values for "easing" interpolation mode settings
         * NOTE: Even if these modes aren't currently used, if users switch
         *       to these later, we want these to work in a sane way out of
@@ -449,48 +449,48 @@ int insert_vert_fcurve(FCurve *fcu, float x, float y, eBezTriple_KeyframeType ke
         */
        beztr.back = 1.70158f;     /* "back" easing - this value used to be used when overshoot=0, but that        */
                                   /*                 introduced discontinuities in how the param worked           */
-       
+
        beztr.amplitude = 0.8f;    /* "elastic" easing - values here were hand-optimised for a default duration of */
        beztr.period = 4.1f;       /*                    ~10 frames (typical mograph motion length)                */
-       
+
        /* add temp beztriple to keyframes */
        a = insert_bezt_fcurve(fcu, &beztr, flag);
-       
-       /* what if 'a' is a negative index? 
+
+       /* what if 'a' is a negative index?
         * for now, just exit to prevent any segfaults
         */
        if (a < 0) return -1;
-       
+
        /* don't recalculate handles if fast is set
         *      - this is a hack to make importers faster
         *      - we may calculate twice (due to autohandle needing to be calculated twice)
         */
-       if ((flag & INSERTKEY_FAST) == 0) 
+       if ((flag & INSERTKEY_FAST) == 0)
                calchandles_fcurve(fcu);
-       
+
        /* set handletype and interpolation */
        if ((fcu->totvert > 2) && (flag & INSERTKEY_REPLACE) == 0) {
                BezTriple *bezt = (fcu->bezt + a);
-               
-               /* set interpolation from previous (if available), but only if we didn't just replace some keyframe 
+
+               /* set interpolation from previous (if available), but only if we didn't just replace some keyframe
                 *  - replacement is indicated by no-change in number of verts
                 *      - when replacing, the user may have specified some interpolation that should be kept
                 */
                if (fcu->totvert > oldTot) {
-                       if (a > 0) 
+                       if (a > 0)
                                bezt->ipo = (bezt - 1)->ipo;
                        else if (a < fcu->totvert - 1)
                                bezt->ipo = (bezt + 1)->ipo;
                }
-                       
+
                /* don't recalculate handles if fast is set
                 *      - this is a hack to make importers faster
                 *      - we may calculate twice (due to autohandle needing to be calculated twice)
                 */
-               if ((flag & INSERTKEY_FAST) == 0) 
+               if ((flag & INSERTKEY_FAST) == 0)
                        calchandles_fcurve(fcu);
        }
-       
+
        /* return the index at which the keyframe was added */
        return a;
 }
@@ -515,34 +515,34 @@ static short new_key_needed(FCurve *fcu, float cFrame, float nValue)
        BezTriple *bezt = NULL, *prev = NULL;
        int totCount, i;
        float valA = 0.0f, valB = 0.0f;
-       
+
        /* safety checking */
        if (fcu == NULL) return KEYNEEDED_JUSTADD;
        totCount = fcu->totvert;
        if (totCount == 0) return KEYNEEDED_JUSTADD;
-       
+
        /* loop through checking if any are the same */
        bezt = fcu->bezt;
        for (i = 0; i < totCount; i++) {
                float prevPosi = 0.0f, prevVal = 0.0f;
                float beztPosi = 0.0f, beztVal = 0.0f;
-                       
+
                /* get current time+value */
                beztPosi = bezt->vec[1][0];
                beztVal = bezt->vec[1][1];
-                       
+
                if (prev) {
                        /* there is a keyframe before the one currently being examined */
-                       
+
                        /* get previous time+value */
                        prevPosi = prev->vec[1][0];
                        prevVal = prev->vec[1][1];
-                       
+
                        /* keyframe to be added at point where there are already two similar points? */
                        if (IS_EQF(prevPosi, cFrame) && IS_EQF(beztPosi, cFrame) && IS_EQF(beztPosi, prevPosi)) {
                                return KEYNEEDED_DONTADD;
                        }
-                       
+
                        /* keyframe between prev+current points ? */
                        if ((prevPosi <= cFrame) && (cFrame <= beztPosi)) {
                                /* is the value of keyframe to be added the same as keyframes on either side ? */
@@ -551,18 +551,18 @@ static short new_key_needed(FCurve *fcu, float cFrame, float nValue)
                                }
                                else {
                                        float realVal;
-                                       
+
                                        /* get real value of curve at that point */
                                        realVal = evaluate_fcurve(fcu, cFrame);
-                                       
+
                                        /* compare whether it's the same as proposed */
                                        if (IS_EQF(realVal, nValue))
                                                return KEYNEEDED_DONTADD;
-                                       else 
+                                       else
                                                return KEYNEEDED_JUSTADD;
                                }
                        }
-                       
+
                        /* new keyframe before prev beztriple? */
                        if (cFrame < prevPosi) {
                                /* A new keyframe will be added. However, whether the previous beztriple
@@ -571,18 +571,18 @@ static short new_key_needed(FCurve *fcu, float cFrame, float nValue)
                                 */
                                if (IS_EQF(prevVal, nValue) && IS_EQF(beztVal, nValue) && IS_EQF(prevVal, beztVal))
                                        return KEYNEEDED_DELNEXT;
-                               else 
+                               else
                                        return KEYNEEDED_JUSTADD;
                        }
                }
                else {
-                       /* just add a keyframe if there's only one keyframe 
+                       /* just add a keyframe if there's only one keyframe
                         * and the new one occurs before the existing one does.
                         */
                        if ((cFrame < beztPosi) && (totCount == 1))
                                return KEYNEEDED_JUSTADD;
                }
-               
+
                /* continue. frame to do not yet passed (or other conditions not met) */
                if (i < (totCount - 1)) {
                        prev = bezt;
@@ -591,7 +591,7 @@ static short new_key_needed(FCurve *fcu, float cFrame, float nValue)
                else
                        break;
        }
-       
+
        /* Frame in which to add a new-keyframe occurs after all other keys
         * -> If there are at least two existing keyframes, then if the values of the
         *    last two keyframes and the new-keyframe match, the last existing keyframe
@@ -601,15 +601,15 @@ static short new_key_needed(FCurve *fcu, float cFrame, float nValue)
         */
        bezt = (fcu->bezt + (fcu->totvert - 1));
        valA = bezt->vec[1][1];
-       
+
        if (prev)
                valB = prev->vec[1][1];
-       else 
+       else
                valB = bezt->vec[1][1] + 1.0f;
-               
+
        if (IS_EQF(valA, nValue) && IS_EQF(valA, valB))
                return KEYNEEDED_DELPREV;
-       else 
+       else
                return KEYNEEDED_JUSTADD;
 }
 
@@ -620,9 +620,9 @@ static float setting_get_rna_value(Depsgraph *depsgraph, PointerRNA *ptr, Proper
 {
        PointerRNA ptr_eval;
        float value = 0.0f;
-       
+
        DEG_get_evaluated_rna_pointer(depsgraph, ptr, &ptr_eval);
-       
+
        switch (RNA_property_type(prop)) {
                case PROP_BOOLEAN:
                        if (RNA_property_array_check(prop))
@@ -648,7 +648,7 @@ static float setting_get_rna_value(Depsgraph *depsgraph, PointerRNA *ptr, Proper
                default:
                        break;
        }
-       
+
        return value;
 }
 
@@ -662,7 +662,7 @@ enum {
        VISUALKEY_SCA,
 };
 
-/* This helper function determines if visual-keyframing should be used when  
+/* This helper function determines if visual-keyframing should be used when
  * inserting keyframes for the given channel. As visual-keyframing only works
  * on Object and Pose-Channel blocks, this should only get called for those
  * blocktypes, when using "standard" keying but 'Visual Keying' option in Auto-Keying
@@ -675,12 +675,12 @@ static bool visualkey_can_use(PointerRNA *ptr, PropertyRNA *prop)
        bool has_rigidbody = false;
        bool has_parent = false;
        const char *identifier = NULL;
-       
+
        /* validate data */
        if (ELEM(NULL, ptr, ptr->data, prop))
                return false;
-       
-       /* get first constraint and determine type of keyframe constraints to check for 
+
+       /* get first constraint and determine type of keyframe constraints to check for
         *  - constraints can be on either Objects or PoseChannels, so we only check if the
         *    ptr->type is RNA_Object or RNA_PoseBone, which are the RNA wrapping-info for
         *    those structs, allowing us to identify the owner of the data
@@ -689,27 +689,27 @@ static bool visualkey_can_use(PointerRNA *ptr, PropertyRNA *prop)
                /* Object */
                Object *ob = (Object *)ptr->data;
                RigidBodyOb *rbo = ob->rigidbody_object;
-               
+
                con = ob->constraints.first;
                identifier = RNA_property_identifier(prop);
                has_parent = (ob->parent != NULL);
-               
+
                /* active rigidbody objects only, as only those are affected by sim */
                has_rigidbody = ((rbo) && (rbo->type == RBO_TYPE_ACTIVE));
        }
        else if (ptr->type == &RNA_PoseBone) {
                /* Pose Channel */
                bPoseChannel *pchan = (bPoseChannel *)ptr->data;
-               
+
                con = pchan->constraints.first;
                identifier = RNA_property_identifier(prop);
                has_parent = (pchan->parent != NULL);
        }
-       
+
        /* check if any data to search using */
        if (ELEM(NULL, con, identifier) && (has_parent == false) && (has_rigidbody == false))
                return false;
-       
+
        /* location or rotation identifiers only... */
        if (identifier == NULL) {
                printf("%s failed: NULL identifier\n", __func__);
@@ -728,20 +728,20 @@ static bool visualkey_can_use(PointerRNA *ptr, PropertyRNA *prop)
                printf("%s failed: identifier - '%s'\n", __func__, identifier);
                return false;
        }
-       
-       
+
+
        /* only search if a searchtype and initial constraint are available */
        if (searchtype) {
                /* parent or rigidbody are always matching */
                if (has_parent || has_rigidbody)
                        return true;
-               
+
                /* constraints */
                for (; con; con = con->next) {
                        /* only consider constraint if it is not disabled, and has influence */
                        if (con->flag & CONSTRAINT_DISABLE) continue;
                        if (con->enforce == 0.0f) continue;
-                       
+
                        /* some constraints may alter these transforms */
                        switch (con->type) {
                                /* multi-transform constraints */
@@ -754,7 +754,7 @@ static bool visualkey_can_use(PointerRNA *ptr, PropertyRNA *prop)
                                        return true;
                                case CONSTRAINT_TYPE_KINEMATIC:
                                        return true;
-                               
+
                                /* single-transform constraits  */
                                case CONSTRAINT_TYPE_TRACKTO:
                                        if (searchtype == VISUALKEY_ROT) return true;
@@ -789,18 +789,18 @@ static bool visualkey_can_use(PointerRNA *ptr, PropertyRNA *prop)
                                case CONSTRAINT_TYPE_MINMAX:
                                        if (searchtype == VISUALKEY_LOC) return true;
                                        break;
-                               
+
                                default:
                                        break;
                        }
                }
        }
-       
+
        /* when some condition is met, this function returns, so that means we've got nothing */
        return false;
 }
 
-/* This helper function extracts the value to use for visual-keyframing 
+/* This helper function extracts the value to use for visual-keyframing
  * In the event that it is not possible to perform visual keying, try to fall-back
  * to using the default method. Assumes that all data it has been passed is valid.
  */
@@ -809,8 +809,8 @@ static float visualkey_get_value(Depsgraph *depsgraph, PointerRNA *ptr, Property
        const char *identifier = RNA_property_identifier(prop);
        float tmat[4][4];
        int rotmode;
-       
-       /* handle for Objects or PoseChannels only 
+
+       /* handle for Objects or PoseChannels only
         *  - only Location, Rotation or Scale keyframes are supported currently
         *  - constraints can be on either Objects or PoseChannels, so we only check if the
         *    ptr->type is RNA_Object or RNA_PoseBone, which are the RNA wrapping-info for
@@ -820,25 +820,25 @@ static float visualkey_get_value(Depsgraph *depsgraph, PointerRNA *ptr, Property
        if (ptr->type == &RNA_Object) {
                Object *ob = (Object *)ptr->data;
                const Object *ob_eval = DEG_get_evaluated_object(depsgraph, ob);
-               
+
                /* Loc code is specific... */
                if (strstr(identifier, "location")) {
                        return ob_eval->obmat[3][array_index];
                }
-               
+
                copy_m4_m4(tmat, ob_eval->obmat);
                rotmode = ob_eval->rotmode;
        }
        else if (ptr->type == &RNA_PoseBone) {
                Object *ob = (Object *)ptr->id.data;
                bPoseChannel *pchan = (bPoseChannel *)ptr->data;
-               
+
                const Object *ob_eval = DEG_get_evaluated_object(depsgraph, ob);
                bPoseChannel *pchan_eval = BKE_pose_channel_find_name(ob_eval->pose, pchan->name);
-               
+
                BKE_armature_mat_pose_to_bone(pchan_eval, pchan_eval->pose_mat, tmat);
                rotmode = pchan_eval->rotmode;
-               
+
                /* Loc code is specific... */
                if (strstr(identifier, "location")) {
                        /* only use for non-connected bones */
@@ -849,27 +849,27 @@ static float visualkey_get_value(Depsgraph *depsgraph, PointerRNA *ptr, Property
        else {
                return setting_get_rna_value(depsgraph, ptr, prop, array_index);
        }
-       
+
        /* Rot/Scale code are common! */
        if (strstr(identifier, "rotation_euler")) {
                float eul[3];
-               
+
                mat4_to_eulO(eul, rotmode, tmat);
                return eul[array_index];
        }
        else if (strstr(identifier, "rotation_quaternion")) {
                float mat3[3][3], quat[4];
-               
+
                copy_m3_m4(mat3, tmat);
                mat3_to_quat_is_ok(quat, mat3);
-               
+
                return quat[array_index];
        }
        else if (strstr(identifier, "rotation_axis_angle")) {
                float axis[3], angle;
-               
+
                mat4_to_axis_angle(axis, &angle, tmat);
-               
+
                /* w = 0, x,y,z = 1,2,3 */
                if (array_index == 0)
                        return angle;
@@ -878,19 +878,19 @@ static float visualkey_get_value(Depsgraph *depsgraph, PointerRNA *ptr, Property
        }
        else if (strstr(identifier, "scale")) {
                float scale[3];
-               
+
                mat4_to_size(scale, tmat);
-               
+
                return scale[array_index];
        }
-       
+
        /* as the function hasn't returned yet, read value from system in the default way */
        return setting_get_rna_value(depsgraph, ptr, prop, array_index);
 }
 
 /* ------------------------- Insert Key API ------------------------- */
 
-/* Secondary Keyframing API call: 
+/* Secondary Keyframing API call:
  *  Use this when validation of necessary animation data is not necessary, since an RNA-pointer to the necessary
  *     data being keyframed, and a pointer to the F-Curve to use have both been provided.
  *
@@ -903,7 +903,7 @@ static float visualkey_get_value(Depsgraph *depsgraph, PointerRNA *ptr, Property
 bool insert_keyframe_direct(Depsgraph *depsgraph, ReportList *reports, PointerRNA ptr, PropertyRNA *prop, FCurve *fcu, float cfra, eBezTriple_KeyframeType keytype, eInsertKeyFlags flag)
 {
        float curval = 0.0f;
-       
+
        /* no F-Curve to add keyframe to? */
        if (fcu == NULL) {
                BKE_report(reports, RPT_ERROR, "No F-Curve to add keyframes to");
@@ -911,13 +911,13 @@ bool insert_keyframe_direct(Depsgraph *depsgraph, ReportList *reports, PointerRN
        }
        /* F-Curve not editable? */
        if (fcurve_is_keyframable(fcu) == 0) {
-               BKE_reportf(reports, RPT_ERROR, 
+               BKE_reportf(reports, RPT_ERROR,
                            "F-Curve with path '%s[%d]' cannot be keyframed, ensure that it is not locked or sampled, "
                            "and try removing F-Modifiers",
                            fcu->rna_path, fcu->array_index);
                return false;
        }
-       
+
        /* if no property given yet, try to validate from F-Curve info */
        if ((ptr.id.data == NULL) && (ptr.data == NULL)) {
                BKE_report(reports, RPT_ERROR, "No RNA pointer available to retrieve values for keyframing from");
@@ -925,12 +925,12 @@ bool insert_keyframe_direct(Depsgraph *depsgraph, ReportList *reports, PointerRN
        }
        if (prop == NULL) {
                PointerRNA tmp_ptr;
-               
+
                /* try to get property we should be affecting */
                if (RNA_path_resolve_property(&ptr, fcu->rna_path, &tmp_ptr, &prop) == false) {
                        /* property not found... */
                        const char *idname = (ptr.id.data) ? ((ID *)ptr.id.data)->name : TIP_("<No ID pointer>");
-                       
+
                        BKE_reportf(reports, RPT_ERROR,
                                    "Could not insert keyframe, as RNA path is invalid for the given ID (ID = %s, path = %s)",
                                    idname, fcu->rna_path);
@@ -941,7 +941,7 @@ bool insert_keyframe_direct(Depsgraph *depsgraph, ReportList *reports, PointerRN
                        ptr = tmp_ptr;
                }
        }
-       
+
        /* update F-Curve flags to ensure proper behaviour for property type */
        update_autoflags_fcurve_direct(fcu, prop);
 
@@ -957,13 +957,13 @@ bool insert_keyframe_direct(Depsgraph *depsgraph, ReportList *reports, PointerRN
                        cfra = 0.0f;
                }
        }
-       
+
        /* obtain value to give keyframe */
-       if ( (flag & INSERTKEY_MATRIX) && 
+       if ( (flag & INSERTKEY_MATRIX) &&
             (visualkey_can_use(&ptr, prop)) )
        {
-               /* visual-keying is only available for object and pchan datablocks, as 
-                * it works by keyframing using a value extracted from the final matrix 
+               /* visual-keying is only available for object and pchan datablocks, as
+                * it works by keyframing using a value extracted from the final matrix
                 * instead of using the kt system to extract a value.
                 */
                curval = visualkey_get_value(depsgraph, &ptr, prop, fcu->array_index);
@@ -972,18 +972,18 @@ bool insert_keyframe_direct(Depsgraph *depsgraph, ReportList *reports, PointerRN
                /* read value from system */
                curval = setting_get_rna_value(depsgraph, &ptr, prop, fcu->array_index);
        }
-       
+
        /* only insert keyframes where they are needed */
        if (flag & INSERTKEY_NEEDED) {
                short insert_mode;
-               
+
                /* check whether this curve really needs a new keyframe */
                insert_mode = new_key_needed(fcu, cfra, curval);
-               
+
                /* insert new keyframe at current frame */
                if (insert_mode)
                        insert_vert_fcurve(fcu, cfra, curval, keytype, flag);
-               
+
                /* delete keyframe immediately before/after newly added */
                switch (insert_mode) {
                        case KEYNEEDED_DELPREV:
@@ -993,7 +993,7 @@ bool insert_keyframe_direct(Depsgraph *depsgraph, ReportList *reports, PointerRN
                                delete_fcurve_key(fcu, 1, 1);
                                break;
                }
-               
+
                /* only return success if keyframe added */
                if (insert_mode)
                        return true;
@@ -1001,11 +1001,11 @@ bool insert_keyframe_direct(Depsgraph *depsgraph, ReportList *reports, PointerRN
        else {
                /* just insert keyframe */
                insert_vert_fcurve(fcu, cfra, curval, keytype, flag);
-               
+
                /* return success */
                return true;
        }
-       
+
        /* failed */
        return false;
 }
@@ -1020,20 +1020,20 @@ bool insert_keyframe_direct(Depsgraph *depsgraph, ReportList *reports, PointerRN
  *     index of -1 keys all array indices
  */
 short insert_keyframe(Depsgraph *depsgraph, ReportList *reports, ID *id, bAction *act, const char group[], const char rna_path[], int array_index, float cfra, eBezTriple_KeyframeType keytype, eInsertKeyFlags flag)
-{      
+{
        PointerRNA id_ptr, ptr;
        PropertyRNA *prop = NULL;
        AnimData *adt;
        FCurve *fcu;
        int array_index_max = array_index + 1;
        int ret = 0;
-       
+
        /* validate pointer first - exit if failure */
        if (id == NULL) {
                BKE_reportf(reports, RPT_ERROR, "No ID block to insert keyframe in (path = %s)", rna_path);
                return 0;
        }
-       
+
        RNA_id_pointer_create(id, &id_ptr);
        if (RNA_path_resolve_property(&id_ptr, rna_path, &ptr, &prop) == false) {
                BKE_reportf(reports, RPT_ERROR,
@@ -1041,45 +1041,45 @@ short insert_keyframe(Depsgraph *depsgraph, ReportList *reports, ID *id, bAction
                            (id) ? id->name : TIP_("<Missing ID block>"), rna_path);
                return 0;
        }
-       
+
        /* if no action is provided, keyframe to the default one attached to this ID-block */
        if (act == NULL) {
                /* get action to add F-Curve+keyframe to */
                act = verify_adt_action(id, 1);
-               
+
                if (act == NULL) {
-                       BKE_reportf(reports, RPT_ERROR, 
+                       BKE_reportf(reports, RPT_ERROR,
                                    "Could not insert keyframe, as this type does not support animation data (ID = %s, path = %s)",
                                    id->name, rna_path);
                        return 0;
                }
        }
-       
+
        /* apply NLA-mapping to frame to use (if applicable) */
        adt = BKE_animdata_from_id(id);
        cfra = BKE_nla_tweakedit_remap(adt, cfra, NLATIME_CONVERT_UNMAP);
-       
+
        /* key entire array convenience method */
        if (array_index == -1) {
                array_index = 0;
                array_index_max = RNA_property_array_length(&ptr, prop);
-               
+
                /* for single properties, increase max_index so that the property itself gets included,
-                * but don't do this for standard arrays since that can cause corruption issues 
+                * but don't do this for standard arrays since that can cause corruption issues
                 * (extra unused curves)
                 */
                if (array_index_max == array_index)
                        array_index_max++;
        }
-       
+
        /* will only loop once unless the array index was -1 */
        for (; array_index < array_index_max; array_index++) {
-               /* make sure the F-Curve exists 
+               /* make sure the F-Curve exists
                 *      - if we're replacing keyframes only, DO NOT create new F-Curves if they do not exist yet
                 *        but still try to get the F-Curve if it exists...
                 */
                fcu = verify_fcurve(act, group, &ptr, rna_path, array_index, (flag & INSERTKEY_REPLACE) == 0);
-               
+
                /* we may not have a F-Curve when we're replacing only... */
                if (fcu) {
                        /* set color mode if the F-Curve is new (i.e. without any keyframes) */
@@ -1095,12 +1095,12 @@ short insert_keyframe(Depsgraph *depsgraph, ReportList *reports, ID *id, bAction
                                        fcu->color_mode = FCURVE_COLOR_AUTO_YRGB;
                                }
                        }
-                       
+
                        /* insert keyframe */
                        ret += insert_keyframe_direct(depsgraph, reports, ptr, prop, fcu, cfra, keytype, flag);
                }
        }
-       
+
        return ret;
 }
 
@@ -1149,13 +1149,13 @@ short delete_keyframe(ReportList *reports, ID *id, bAction *act, const char grou
        PropertyRNA *prop;
        int array_index_max = array_index + 1;
        int ret = 0;
-       
+
        /* sanity checks */
        if (ELEM(NULL, id, adt)) {
                BKE_report(reports, RPT_ERROR, "No ID block and/or AnimData to delete keyframe from");
                return 0;
        }
-       
+
        /* validate pointer first - exit if failure */
        RNA_id_pointer_create(id, &id_ptr);
        if (RNA_path_resolve_property(&id_ptr, rna_path, &ptr, &prop) == false) {
@@ -1164,18 +1164,18 @@ short delete_keyframe(ReportList *reports, ID *id, bAction *act, const char grou
                            id->name, rna_path);
                return 0;
        }
-       
+
        /* get F-Curve
         * Note: here is one of the places where we don't want new Action + F-Curve added!
         *      so 'add' var must be 0
         */
        if (act == NULL) {
-               /* if no action is provided, use the default one attached to this ID-block 
+               /* if no action is provided, use the default one attached to this ID-block
                 *  - if it doesn't exist, then we're out of options...
                 */
                if (adt->action) {
                        act = adt->action;
-                       
+
                        /* apply NLA-mapping to frame to use (if applicable) */
                        cfra = BKE_nla_tweakedit_remap(adt, cfra, NLATIME_CONVERT_UNMAP);
                }
@@ -1184,20 +1184,20 @@ short delete_keyframe(ReportList *reports, ID *id, bAction *act, const char grou
                        return 0;
                }
        }
-       
+
        /* key entire array convenience method */
        if (array_index == -1) {
                array_index = 0;
                array_index_max = RNA_property_array_length(&ptr, prop);
-               
+
                /* for single properties, increase max_index so that the property itself gets included,
-                * but don't do this for standard arrays since that can cause corruption issues 
+                * but don't do this for standard arrays since that can cause corruption issues
                 * (extra unused curves)
                 */
                if (array_index_max == array_index)
                        array_index_max++;
        }
-       
+
        /* will only loop once unless the array index was -1 */
        for (; array_index < array_index_max; array_index++) {
                FCurve *fcu = verify_fcurve(act, group, &ptr, rna_path, array_index, 0);
@@ -1216,7 +1216,7 @@ short delete_keyframe(ReportList *reports, ID *id, bAction *act, const char grou
                ret += delete_keyframe_fcurve(adt, fcu, cfra);
 
        }
-       
+
        /* return success/failure */
        return ret;
 }
@@ -1326,11 +1326,11 @@ static int modify_key_op_poll(bContext *C)
 {
        ScrArea *sa = CTX_wm_area(C);
        Scene *scene = CTX_data_scene(C);
-       
+
        /* if no area or active scene */
-       if (ELEM(NULL, sa, scene)) 
+       if (ELEM(NULL, sa, scene))
                return false;
-       
+
        /* should be fine */
        return true;
 }
@@ -1346,19 +1346,19 @@ static int insert_key_exec(bContext *C, wmOperator *op)
        int type = RNA_enum_get(op->ptr, "type");
        float cfra = (float)CFRA; // XXX for now, don't bother about all the yucky offset crap
        short success;
-       
+
        /* type is the Keying Set the user specified to use when calling the operator:
         *      - type == 0: use scene's active Keying Set
         *      - type > 0: use a user-defined Keying Set from the active scene
         *      - type < 0: use a builtin Keying Set
         */
-       if (type == 0) 
+       if (type == 0)
                type = scene->active_keyingset;
        if (type > 0)
                ks = BLI_findlink(&scene->keyingsets, type - 1);
        else
                ks = BLI_findlink(&builtin_keyingsets, -type - 1);
-               
+
        /* report failures */
        if (ks == NULL) {
                BKE_report(op->reports, RPT_ERROR, "No active keying set");
@@ -1372,12 +1372,12 @@ static int insert_key_exec(bContext *C, wmOperator *op)
                ED_object_mode_toggle(C, OB_MODE_EDIT);
                ob_edit_mode = true;
        }
-       
+
        /* try to insert keyframes for the channels specified by KeyingSet */
        success = ANIM_apply_keyingset(C, NULL, NULL, ks, MODIFYKEY_MODE_INSERT, cfra);
        if (G.debug & G_DEBUG)
                BKE_reportf(op->reports, RPT_INFO, "Keying set '%s' - successfully added %d keyframes", ks->name, success);
-       
+
        /* restore the edit mode if necessary */
        if (ob_edit_mode) {
                ED_object_mode_toggle(C, OB_MODE_EDIT);
@@ -1392,39 +1392,39 @@ static int insert_key_exec(bContext *C, wmOperator *op)
                /* if the appropriate properties have been set, make a note that we've inserted something */
                if (RNA_boolean_get(op->ptr, "confirm_success"))
                        BKE_reportf(op->reports, RPT_INFO, "Successfully added %d keyframes for keying set '%s'", success, ks->name);
-               
+
                /* send notifiers that keyframes have been changed */
                WM_event_add_notifier(C, NC_ANIMATION | ND_KEYFRAME | NA_ADDED, NULL);
        }
        else
                BKE_report(op->reports, RPT_WARNING, "Keying set failed to insert any keyframes");
-       
+
        return OPERATOR_FINISHED;
 }
 
 void ANIM_OT_keyframe_insert(wmOperatorType *ot)
 {
        PropertyRNA *prop;
-       
+
        /* identifiers */
        ot->name = "Insert Keyframe";
        ot->idname = "ANIM_OT_keyframe_insert";
        ot->description = "Insert keyframes on the current frame for all properties in the specified Keying Set";
-       
+
        /* callbacks */
-       ot->exec = insert_key_exec; 
+       ot->exec = insert_key_exec;
        ot->poll = modify_key_op_poll;
-       
+
        /* flags */
        ot->flag = OPTYPE_REGISTER | OPTYPE_UNDO;
-       
+
        /* keyingset to use (dynamic enum) */
        prop = RNA_def_enum(ot->srna, "type", DummyRNA_DEFAULT_items, 0, "Keying Set", "The Keying Set to use");
        RNA_def_enum_funcs(prop, ANIM_keying_sets_enum_itemf);
        RNA_def_property_flag(prop, PROP_HIDDEN);
        ot->prop = prop;
-       
-       /* confirm whether a keyframe was added by showing a popup 
+
+       /* confirm whether a keyframe was added by showing a popup
         *      - by default, this is enabled, since this operator is assumed to be called independently
         */
        prop = RNA_def_boolean(ot->srna, "confirm_success", 1, "Confirm Successful Insert",
@@ -1433,68 +1433,68 @@ void ANIM_OT_keyframe_insert(wmOperatorType *ot)
 }
 
 /* Insert Key Operator (With Menu) ------------------------ */
-/* This operator checks if a menu should be shown for choosing the KeyingSet to use, 
+/* This operator checks if a menu should be shown for choosing the KeyingSet to use,
  * then calls the menu if necessary before
  */
 
 static int insert_key_menu_invoke(bContext *C, wmOperator *op, const wmEvent *UNUSED(event))
 {
        Scene *scene = CTX_data_scene(C);
-       
+
        /* if prompting or no active Keying Set, show the menu */
        if ((scene->active_keyingset == 0) || RNA_boolean_get(op->ptr, "always_prompt")) {
                uiPopupMenu *pup;
                uiLayout *layout;
-               
+
                /* call the menu, which will call this operator again, hence the canceled */
                pup = UI_popup_menu_begin(C, RNA_struct_ui_name(op->type->srna), ICON_NONE);
                layout = UI_popup_menu_layout(pup);
                uiItemsEnumO(layout, "ANIM_OT_keyframe_insert_menu", "type");
                UI_popup_menu_end(C, pup);
-               
+
                return OPERATOR_INTERFACE;
        }
        else {
                /* just call the exec() on the active keyingset */
                RNA_enum_set(op->ptr, "type", 0);
                RNA_boolean_set(op->ptr, "confirm_success", true);
-               
+
                return op->type->exec(C, op);
        }
 }
+
 void ANIM_OT_keyframe_insert_menu(wmOperatorType *ot)
 {
        PropertyRNA *prop;
-       
+
        /* identifiers */
        ot->name = "Insert Keyframe Menu";
        ot->idname = "ANIM_OT_keyframe_insert_menu";
        ot->description = "Insert Keyframes for specified Keying Set, with menu of available Keying Sets if undefined";
-       
+
        /* callbacks */
        ot->invoke = insert_key_menu_invoke;
-       ot->exec = insert_key_exec; 
+       ot->exec = insert_key_exec;
        ot->poll = ED_operator_areaactive;
-       
+
        /* flags */
        ot->flag = OPTYPE_REGISTER | OPTYPE_UNDO;
-       
+
        /* keyingset to use (dynamic enum) */
        prop = RNA_def_enum(ot->srna, "type", DummyRNA_DEFAULT_items, 0, "Keying Set", "The Keying Set to use");
        RNA_def_enum_funcs(prop, ANIM_keying_sets_enum_itemf);
        RNA_def_property_flag(prop, PROP_HIDDEN);
        ot->prop = prop;
-       
-       /* confirm whether a keyframe was added by showing a popup 
+
+       /* confirm whether a keyframe was added by showing a popup
         *      - by default, this is disabled so that if a menu is shown, this doesn't come up too
         */
        // XXX should this just be always on?
        prop = RNA_def_boolean(ot->srna, "confirm_success", 0, "Confirm Successful Insert",
                               "Show a popup when the keyframes get successfully added");
        RNA_def_property_flag(prop, PROP_HIDDEN);
-       
-       /* whether the menu should always be shown 
+
+       /* whether the menu should always be shown
         *      - by default, the menu should only be shown when there is no active Keying Set (2.5 behavior),
         *        although in some cases it might be useful to always shown (pre 2.5 behavior)
         */
@@ -1511,30 +1511,30 @@ static int delete_key_exec(bContext *C, wmOperator *op)
        int type = RNA_enum_get(op->ptr, "type");
        float cfra = (float)CFRA; // XXX for now, don't bother about all the yucky offset crap
        short success;
-       
+
        /* type is the Keying Set the user specified to use when calling the operator:
         *      - type == 0: use scene's active Keying Set
         *      - type > 0: use a user-defined Keying Set from the active scene
         *      - type < 0: use a builtin Keying Set
         */
-       if (type == 0) 
+       if (type == 0)
                type = scene->active_keyingset;
        if (type > 0)
                ks = BLI_findlink(&scene->keyingsets, type - 1);
        else
                ks = BLI_findlink(&builtin_keyingsets, -type - 1);
-       
+
        /* report failure */
        if (ks == NULL) {
                BKE_report(op->reports, RPT_ERROR, "No active Keying Set");
                return OPERATOR_CANCELLED;
        }
-       
+
        /* try to delete keyframes for the channels specified by KeyingSet */
        success = ANIM_apply_keyingset(C, NULL, NULL, ks, MODIFYKEY_MODE_DELETE, cfra);
        if (G.debug & G_DEBUG)
                printf("KeyingSet '%s' - Successfully removed %d Keyframes\n", ks->name, success);
-       
+
        /* report failure or do updates? */
        if (success == MODIFYKEY_INVALID_CONTEXT) {
                BKE_report(op->reports, RPT_ERROR, "No suitable context info for active keying set");
@@ -1544,39 +1544,39 @@ static int delete_key_exec(bContext *C, wmOperator *op)
                /* if the appropriate properties have been set, make a note that we've inserted something */
                if (RNA_boolean_get(op->ptr, "confirm_success"))
                        BKE_reportf(op->reports, RPT_INFO, "Successfully removed %d keyframes for keying set '%s'", success, ks->name);
-               
+
                /* send notifiers that keyframes have been changed */
                WM_event_add_notifier(C, NC_ANIMATION | ND_KEYFRAME | NA_REMOVED, NULL);
        }
        else
                BKE_report(op->reports, RPT_WARNING, "Keying set failed to remove any keyframes");
-       
+
        return OPERATOR_FINISHED;
 }
 
 void ANIM_OT_keyframe_delete(wmOperatorType *ot)
 {
        PropertyRNA *prop;
-       
+
        /* identifiers */
        ot->name = "Delete Keying-Set Keyframe";
        ot->idname = "ANIM_OT_keyframe_delete";
        ot->description = "Delete keyframes on the current frame for all properties in the specified Keying Set";
-       
+
        /* callbacks */
-       ot->exec = delete_key_exec; 
+       ot->exec = delete_key_exec;
        ot->poll = modify_key_op_poll;
-       
+
        /* flags */
        ot->flag = OPTYPE_REGISTER | OPTYPE_UNDO;
-       
+
        /* keyingset to use (dynamic enum) */
        prop = RNA_def_enum(ot->srna, "type", DummyRNA_DEFAULT_items, 0, "Keying Set", "The Keying Set to use");
        RNA_def_enum_funcs(prop, ANIM_keying_sets_enum_itemf);
        RNA_def_property_flag(prop, PROP_HIDDEN);
        ot->prop = prop;
-       
-       /* confirm whether a keyframe was added by showing a popup 
+
+       /* confirm whether a keyframe was added by showing a popup
         *      - by default, this is enabled, since this operator is assumed to be called independently
         */
        RNA_def_boolean(ot->srna, "confirm_success", 1, "Confirm Successful Delete",
@@ -1587,7 +1587,7 @@ void ANIM_OT_keyframe_delete(wmOperatorType *ot)
 /* NOTE: Although this version is simpler than the more generic version for KeyingSets,
  * it is more useful for animators working in the 3D view.
  */
+
 static int clear_anim_v3d_exec(bContext *C, wmOperator *UNUSED(op))
 {
        bool changed = false;
@@ -1599,23 +1599,23 @@ static int clear_anim_v3d_exec(bContext *C, wmOperator *UNUSED(op))
                        AnimData *adt = ob->adt;
                        bAction *act = adt->action;
                        FCurve *fcu, *fcn;
-                       
+
                        for (fcu = act->curves.first; fcu; fcu = fcn) {
                                bool can_delete = false;
-                               
+
                                fcn = fcu->next;
-                               
+
                                /* in pose mode, only delete the F-Curve if it belongs to a selected bone */
                                if (ob->mode & OB_MODE_POSE) {
                                        if ((fcu->rna_path) && strstr(fcu->rna_path, "pose.bones[")) {
                                                bPoseChannel *pchan;
                                                char *bone_name;
-                                               
+
                                                /* get bone-name, and check if this bone is selected */
                                                bone_name = BLI_str_quoted_substrN(fcu->rna_path, "pose.bones[");
                                                pchan = BKE_pose_channel_find_name(ob->pose, bone_name);
                                                if (bone_name) MEM_freeN(bone_name);
-                                               
+
                                                /* delete if bone is selected*/
                                                if ((pchan) && (pchan->bone)) {
                                                        if (pchan->bone->flag & BONE_SELECTED)
@@ -1627,7 +1627,7 @@ static int clear_anim_v3d_exec(bContext *C, wmOperator *UNUSED(op))
                                        /* object mode - all of Object's F-Curves are affected */
                                        can_delete = true;
                                }
-                               
+
                                /* delete F-Curve completely */
                                if (can_delete) {
                                        ANIM_fcurve_delete_from_animdata(NULL, adt, fcu);
@@ -1645,7 +1645,7 @@ static int clear_anim_v3d_exec(bContext *C, wmOperator *UNUSED(op))
 
        /* send updates */
        WM_event_add_notifier(C, NC_OBJECT | ND_KEYS, NULL);
-       
+
        return OPERATOR_FINISHED;
 }
 
@@ -1655,13 +1655,13 @@ void ANIM_OT_keyframe_clear_v3d(wmOperatorType *ot)
        ot->name = "Remove Animation";
        ot->description = "Remove all keyframe animation for selected objects";
        ot->idname = "ANIM_OT_keyframe_clear_v3d";
-       
+
        /* callbacks */
        ot->invoke = WM_operator_confirm;
-       ot->exec = clear_anim_v3d_exec; 
-       
+       ot->exec = clear_anim_v3d_exec;
+
        ot->poll = ED_operator_areaactive;
-       
+
        /* flags */
        ot->flag = OPTYPE_REGISTER | OPTYPE_UNDO;
 }
@@ -1671,22 +1671,22 @@ static int delete_key_v3d_exec(bContext *C, wmOperator *op)
 {
        Scene *scene = CTX_data_scene(C);
        float cfra = (float)CFRA;
-       
+
        CTX_DATA_BEGIN (C, Object *, ob, selected_objects)
        {
                ID *id = &ob->id;
                int success = 0;
-               
+
                /* just those in active action... */
                if ((ob->adt) && (ob->adt->action)) {
                        AnimData *adt = ob->adt;
                        bAction *act = adt->action;
                        FCurve *fcu, *fcn;
                        const float cfra_unmap = BKE_nla_tweakedit_remap(adt, cfra, NLATIME_CONVERT_UNMAP);
-                       
+
                        for (fcu = act->curves.first; fcu; fcu = fcn) {
                                fcn = fcu->next;
-                               
+
                                /* don't touch protected F-Curves */
                                if (BKE_fcurve_is_protected(fcu)) {
                                        BKE_reportf(op->reports, RPT_WARNING,
@@ -1694,57 +1694,57 @@ static int delete_key_v3d_exec(bContext *C, wmOperator *op)
                                                    fcu->rna_path, id->name + 2);
                                        continue;
                                }
-                               
+
                                /* special exception for bones, as this makes this operator more convenient to use
                                 * NOTE: This is only done in pose mode. In object mode, we're dealign with the entire object.
                                 */
                                if ((ob->mode & OB_MODE_POSE) && strstr(fcu->rna_path, "pose.bones[\"")) {
                                        bPoseChannel *pchan;
                                        char *bone_name;
-                                       
+
                                        /* get bone-name, and check if this bone is selected */
                                        bone_name = BLI_str_quoted_substrN(fcu->rna_path, "pose.bones[");
                                        pchan = BKE_pose_channel_find_name(ob->pose, bone_name);
                                        if (bone_name) MEM_freeN(bone_name);
-                                       
+
                                        /* skip if bone is not selected */
                                        if ((pchan) && (pchan->bone)) {
                                                /* bones are only selected/editable if visible... */
                                                bArmature *arm = (bArmature *)ob->data;
-                                       
+
                                                /* skipping - not visible on currently visible layers */
                                                if ((arm->layer & pchan->bone->layer) == 0)
                                                        continue;
                                                /* skipping - is currently hidden */
                                                if (pchan->bone->flag & BONE_HIDDEN_P)
                                                        continue;
-                                               
+
                                                /* selection flag... */
                                                if ((pchan->bone->flag & BONE_SELECTED) == 0)
                                                        continue;
                                        }
                                }
-                               
-                               /* delete keyframes on current frame 
+
+                               /* delete keyframes on current frame
                                 * WARNING: this can delete the next F-Curve, hence the "fcn" copying
                                 */
                                success += delete_keyframe_fcurve(adt, fcu, cfra_unmap);
                        }
                }
-               
+
                /* report success (or failure) */
                if (success)
                        BKE_reportf(op->reports, RPT_INFO, "Object '%s' successfully had %d keyframes removed", id->name + 2, success);
                else
                        BKE_reportf(op->reports, RPT_ERROR, "No keyframes removed from Object '%s'", id->name + 2);
-               
+
                DEG_id_tag_update(&ob->id, OB_RECALC_OB);
        }
        CTX_DATA_END;
-       
+
        /* send updates */
        WM_event_add_notifier(C, NC_OBJECT | ND_KEYS, NULL);
-       
+
        return OPERATOR_FINISHED;
 }
 
@@ -1754,13 +1754,13 @@ void ANIM_OT_keyframe_delete_v3d(wmOperatorType *ot)
        ot->name = "Delete Keyframe";
        ot->description = "Remove keyframes on current frame for selected objects and bones";
        ot->idname = "ANIM_OT_keyframe_delete_v3d";
-       
+
        /* callbacks */
        ot->invoke = WM_operator_confirm;
-       ot->exec = delete_key_v3d_exec; 
-       
+       ot->exec = delete_key_v3d_exec;
+
        ot->poll = ED_operator_areaactive;
-       
+
        /* flags */
        ot->flag = OPTYPE_REGISTER | OPTYPE_UNDO;
 }
@@ -1783,16 +1783,16 @@ static int insert_key_button_exec(bContext *C, wmOperator *op)
        const bool all = RNA_boolean_get(op->ptr, "all");
        eInsertKeyFlags flag = INSERTKEY_NOFLAGS;
 
-       
+
        /* flags for inserting keyframes */
        flag = ANIM_get_keyframing_flags(scene, 1);
-       
+
        /* try to insert keyframe using property retrieved from UI */
        if (!(but = UI_context_active_but_prop_get(C, &ptr, &prop, &index))) {
                /* pass event on if no active button found */
                return (OPERATOR_CANCELLED | OPERATOR_PASS_THROUGH);
        }
-       
+
        if ((ptr.id.data && ptr.data && prop) && RNA_property_animateable(&ptr, prop)) {
                if (ptr.type == &RNA_NlaStrip) {
                        /* Handle special properties for NLA Strips, whose F-Curves are stored on the
@@ -1801,7 +1801,7 @@ static int insert_key_button_exec(bContext *C, wmOperator *op)
                         */
                        NlaStrip *strip = (NlaStrip *)ptr.data;
                        FCurve *fcu = list_find_fcurve(&strip->fcurves, RNA_property_identifier(prop), index);
-                       
+
                        if (fcu) {
                                success = insert_keyframe_direct(depsgraph, op->reports, ptr, prop, fcu, cfra, ts->keyframe_type, 0);
                        }
@@ -1814,9 +1814,9 @@ static int insert_key_button_exec(bContext *C, wmOperator *op)
                        /* Driven property - Find driver */
                        FCurve *fcu;
                        bool driven, special;
-                       
+
                        fcu = rna_get_fcurve_context_ui(C, &ptr, prop, index, NULL, NULL, &driven, &special);
-                       
+
                        if (fcu && driven) {
                                success = insert_keyframe_direct(depsgraph, op->reports, ptr, prop, fcu, cfra, ts->keyframe_type, INSERTKEY_DRIVER);
                        }
@@ -1824,11 +1824,11 @@ static int insert_key_button_exec(bContext *C, wmOperator *op)
                else {
                        /* standard properties */
                        path = RNA_path_from_ID_to_property(&ptr, prop);
-                       
+
                        if (path) {
                                const char *identifier = RNA_property_identifier(prop);
                                const char *group = NULL;
-                               
+
                                /* Special exception for keyframing transforms:
                                 * Set "group" for this manually, instead of having them appearing at the bottom (ungrouped)
                                 * part of the channels list. Leaving these ungrouped is not a nice user behaviour in this case.
@@ -1847,19 +1847,19 @@ static int insert_key_button_exec(bContext *C, wmOperator *op)
                                         */
                                        group = "Object Transforms";
                                }
-                               
-                               
+
+
                                if (all) {
                                        /* -1 indicates operating on the entire array (or the property itself otherwise) */
                                        index = -1;
                                }
-                               
+
                                success = insert_keyframe(depsgraph, op->reports, ptr.id.data, NULL, group, path, index, cfra, ts->keyframe_type, flag);
-                               
+
                                MEM_freeN(path);
                        }
                        else {
-                               BKE_report(op->reports, RPT_WARNING, 
+                               BKE_report(op->reports, RPT_WARNING,
                                           "Failed to resolve path to property, "
                                           "try manually specifying this using a Keying Set instead");
                        }
@@ -1867,7 +1867,7 @@ static int insert_key_button_exec(bContext *C, wmOperator *op)
        }
        else {
                if (prop && !RNA_property_animateable(&ptr, prop)) {
-                       BKE_reportf(op->reports, RPT_WARNING, 
+                       BKE_reportf(op->reports, RPT_WARNING,
                                   "\"%s\" property cannot be animated",
                                   RNA_property_identifier(prop));
                }
@@ -1877,15 +1877,15 @@ static int insert_key_button_exec(bContext *C, wmOperator *op)
                                    (void *)ptr.data, (void *)prop);
                }
        }
-       
+
        if (success) {
                /* send updates */
                UI_context_update_anim_flag(C);
-               
+
                /* send notifiers that keyframes have been changed */
                WM_event_add_notifier(C, NC_ANIMATION | ND_KEYFRAME | NA_ADDED, NULL);
        }
-       
+
        return (success) ? OPERATOR_FINISHED : OPERATOR_CANCELLED;
 }
 
@@ -1895,11 +1895,11 @@ void ANIM_OT_keyframe_insert_button(wmOperatorType *ot)
        ot->name = "Insert Keyframe (Buttons)";
        ot->idname = "ANIM_OT_keyframe_insert_button";
        ot->description = "Insert a keyframe for current UI-active property";
-       
+
        /* callbacks */
-       ot->exec = insert_key_button_exec; 
+       ot->exec = insert_key_button_exec;
        ot->poll = modify_key_op_poll;
-       
+
        /* flags */
        ot->flag = OPTYPE_UNDO | OPTYPE_INTERNAL;
 
@@ -1919,7 +1919,7 @@ static int delete_key_button_exec(bContext *C, wmOperator *op)
        short success = 0;
        int index;
        const bool all = RNA_boolean_get(op->ptr, "all");
-       
+
        /* try to insert keyframe using property retrieved from UI */
        if (!UI_context_active_but_prop_get(C, &ptr, &prop, &index)) {
                /* pass event on if no active button found */
@@ -1935,7 +1935,7 @@ static int delete_key_button_exec(bContext *C, wmOperator *op)
                        ID *id = ptr.id.data;
                        NlaStrip *strip = (NlaStrip *)ptr.data;
                        FCurve *fcu = list_find_fcurve(&strip->fcurves, RNA_property_identifier(prop), 0);
-                       
+
                        if (fcu) {
                                if (BKE_fcurve_is_protected(fcu)) {
                                        BKE_reportf(op->reports, RPT_WARNING,
@@ -1949,7 +1949,7 @@ static int delete_key_button_exec(bContext *C, wmOperator *op)
                                         */
                                        bool found = false;
                                        int i;
-                                       
+
                                        /* try to find index of beztriple to get rid of */
                                        i = binarysearch_bezt_index(fcu->bezt, cfra, fcu->totvert, &found);
                                        if (found) {
@@ -1963,13 +1963,13 @@ static int delete_key_button_exec(bContext *C, wmOperator *op)
                else {
                        /* standard properties */
                        path = RNA_path_from_ID_to_property(&ptr, prop);
-                       
+
                        if (path) {
                                if (all) {
                                        /* -1 indicates operating on the entire array (or the property itself otherwise) */
                                        index = -1;
                                }
-                               
+
                                success = delete_keyframe(op->reports, ptr.id.data, NULL, NULL, path, index, cfra, 0);
                                MEM_freeN(path);
                        }
@@ -1980,16 +1980,16 @@ static int delete_key_button_exec(bContext *C, wmOperator *op)
        else if (G.debug & G_DEBUG) {
                printf("ptr.data = %p, prop = %p\n", (void *)ptr.data, (void *)prop);
        }
-       
-       
+
+
        if (success) {
                /* send updates */
                UI_context_update_anim_flag(C);
-               
+
                /* send notifiers that keyframes have been changed */
                WM_event_add_notifier(C, NC_ANIMATION | ND_KEYFRAME | NA_REMOVED, NULL);
        }
-       
+
        return (success) ? OPERATOR_FINISHED : OPERATOR_CANCELLED;
 }
 
@@ -1999,11 +1999,11 @@ void ANIM_OT_keyframe_delete_button(wmOperatorType *ot)
        ot->name = "Delete Keyframe (Buttons)";
        ot->idname = "ANIM_OT_keyframe_delete_button";
        ot->description = "Delete current keyframe of current UI-active property";
-       
+
        /* callbacks */
-       ot->exec = delete_key_button_exec; 
+       ot->exec = delete_key_button_exec;
        ot->poll = modify_key_op_poll;
-       
+
        /* flags */
        ot->flag = OPTYPE_UNDO | OPTYPE_INTERNAL;
 
@@ -2031,13 +2031,13 @@ static int clear_key_button_exec(bContext *C, wmOperator *op)
 
        if (ptr.id.data && ptr.data && prop) {
                path = RNA_path_from_ID_to_property(&ptr, prop);
-               
+
                if (path) {
                        if (all) {
                                /* -1 indicates operating on the entire array (or the property itself otherwise) */
                                index = -1;
                        }
-                       
+
                        success += clear_keyframe(op->reports, ptr.id.data, NULL, NULL, path, index, 0);
                        MEM_freeN(path);
                }
@@ -2052,7 +2052,7 @@ static int clear_key_button_exec(bContext *C, wmOperator *op)
        if (success) {
                /* send updates */
                UI_context_update_anim_flag(C);
-               
+
                /* send notifiers that keyframes have been changed */
                WM_event_add_notifier(C, NC_ANIMATION | ND_KEYFRAME | NA_REMOVED, NULL);
        }
@@ -2084,11 +2084,11 @@ void ANIM_OT_keyframe_clear_button(wmOperatorType *ot)
 bool autokeyframe_cfra_can_key(Scene *scene, ID *id)
 {
        float cfra = (float)CFRA; // XXX for now, this will do
-       
+
        /* only filter if auto-key mode requires this */
        if (IS_AUTOKEY_ON(scene) == 0)
                return false;
-       
+
        if (IS_AUTOKEY_MODE(scene, EDITKEYS)) {
                /* Replace Mode:
                 * For whole block, only key if there's a keyframe on that frame already
@@ -2103,7 +2103,7 @@ bool autokeyframe_cfra_can_key(Scene *scene, ID *id)
                 * let's set the "normal" flag too, so that it will all be sane everywhere...
                 */
                scene->toolsettings->autokey_mode = AUTOKEY_MODE_NORMAL;
-               
+
                /* Can insert anytime we like... */
                return true;
        }
@@ -2120,12 +2120,12 @@ bool fcurve_frame_has_keyframe(FCurve *fcu, float frame, short filter)
        /* quick sanity check */
        if (ELEM(NULL, fcu, fcu->bezt))
                return false;
-       
+
        /* we either include all regardless of muting, or only non-muted  */
        if ((filter & ANIMFILTER_KEYS_MUTED) || (fcu->flag & FCURVE_MUTED) == 0) {
                bool replace;
                int i = binarysearch_bezt_index(fcu->bezt, frame, fcu->totvert, &replace);
-               
+
                /* binarysearch_bezt_index will set replace to be 0 or 1
                 * - obviously, 1 represents a match
                 */
@@ -2135,26 +2135,26 @@ bool fcurve_frame_has_keyframe(FCurve *fcu, float frame, short filter)
                                return true;
                }
        }
-       
+
        return false;
 }
 
-/* Checks whether an Action has a keyframe for a given frame 
+/* Checks whether an Action has a keyframe for a given frame
  * Since we're only concerned whether a keyframe exists, we can simply loop until a match is found...
  */
 static bool action_frame_has_keyframe(bAction *act, float frame, short filter)
 {
        FCurve *fcu;
-       
+
        /* can only find if there is data */
        if (act == NULL)
                return false;
-               
+
        /* if only check non-muted, check if muted */
        if ((filter & ANIMFILTER_KEYS_MUTED) || (act->flag & ACT_MUTED))
                return false;
-       
-       /* loop over F-Curves, using binary-search to try to find matches 
+
+       /* loop over F-Curves, using binary-search to try to find matches
         *      - this assumes that keyframes are only beztriples
         */
        for (fcu = act->curves.first; fcu; fcu = fcu->next) {
@@ -2164,7 +2164,7 @@ static bool action_frame_has_keyframe(bAction *act, float frame, short filter)
                                return true;
                }
        }
-       
+
        /* nothing found */
        return false;
 }
@@ -2175,27 +2175,27 @@ static bool object_frame_has_keyframe(Object *ob, float frame, short filter)
        /* error checking */
        if (ob == NULL)
                return false;
-       
+
        /* check own animation data - specifically, the action it contains */
        if ((ob->adt) && (ob->adt->action)) {
-               /* T41525 - When the active action is a NLA strip being edited, 
+               /* T41525 - When the active action is a NLA strip being edited,
                 * we need to correct the frame number to "look inside" the
                 * remapped action
                 */
                float ob_frame = BKE_nla_tweakedit_remap(ob->adt, frame, NLATIME_CONVERT_UNMAP);
-               
+
                if (action_frame_has_keyframe(ob->adt->action, ob_frame, filter))
                        return true;
        }
-       
+
        /* try shapekey keyframes (if available, and allowed by filter) */
        if (!(filter & ANIMFILTER_KEYS_LOCAL) && !(filter & ANIMFILTER_KEYS_NOSKEY)) {
                Key *key = BKE_key_from_object(ob);
-               
-               /* shapekeys can have keyframes ('Relative Shape Keys') 
-                * or depend on time (old 'Absolute Shape Keys') 
+
+               /* shapekeys can have keyframes ('Relative Shape Keys')
+                * or depend on time (old 'Absolute Shape Keys')
                 */
-                
+
                /* 1. test for relative (with keyframes) */
                if (id_frame_has_keyframe((ID *)key, frame, filter))
                        return true;
@@ -2209,24 +2209,24 @@ static bool object_frame_has_keyframe(Object *ob, float frame, short filter)
                /* if only active, then we can skip a lot of looping */
                if (filter & ANIMFILTER_KEYS_ACTIVE) {
                        Material *ma = give_current_material(ob, (ob->actcol + 1));
-                       
+
                        /* we only retrieve the active material... */
                        if (id_frame_has_keyframe((ID *)ma, frame, filter))
                                return true;
                }
                else {
                        int a;
-                       
+
                        /* loop over materials */
                        for (a = 0; a < ob->totcol; a++) {
                                Material *ma = give_current_material(ob, a + 1);
-                               
+
                                if (id_frame_has_keyframe((ID *)ma, frame, filter))
                                        return true;
                        }
                }
        }
-       
+
        /* nothing found */
        return false;
 }
@@ -2239,7 +2239,7 @@ bool id_frame_has_keyframe(ID *id, float frame, short filter)
        /* sanity checks */
        if (id == NULL)
                return false;
-       
+
        /* perform special checks for 'macro' types */
        switch (GS(id->name)) {
                case ID_OB: /* object */
@@ -2252,15 +2252,15 @@ bool id_frame_has_keyframe(ID *id, float frame, short filter)
                default:  /* 'normal type' */
                {
                        AnimData *adt = BKE_animdata_from_id(id);
-                       
+
                        /* only check keyframes in active action */
                        if (adt)
                                return action_frame_has_keyframe(adt->action, frame, filter);
                        break;
                }
        }
-       
-       
+
+
        /* no keyframe found */
        return false;
 }