diff options
| author | Campbell Barton <ideasman42@gmail.com> | 2021-06-24 08:56:58 +0300 |
|---|---|---|
| committer | Campbell Barton <ideasman42@gmail.com> | 2021-06-24 08:59:34 +0300 |
| commit | 4b9ff3cd42be427e478743648e9951bf8c189a04 (patch) | |
| tree | b0cb1462a8fdae38df4a0a1067349f3118d56a43 /source/blender/editors | |
| parent | 2e99a74df9ecfa18c4081cdcc82227e2e24f14b1 (diff) | |
Cleanup: comment blocks, trailing space in comments
Diffstat (limited to 'source/blender/editors')
115 files changed, 290 insertions, 285 deletions
diff --git a/source/blender/editors/animation/anim_channels_defines.c b/source/blender/editors/animation/anim_channels_defines.c index 0b587191807..f69830fc015 100644 --- a/source/blender/editors/animation/anim_channels_defines.c +++ b/source/blender/editors/animation/anim_channels_defines.c @@ -502,7 +502,7 @@ static bool acf_summary_setting_valid(bAnimContext *UNUSED(ac), return (setting == ACHANNEL_SETTING_EXPAND); } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_summary_setting_flag(bAnimContext *UNUSED(ac), eAnimChannel_Settings setting, bool *neg) @@ -595,7 +595,7 @@ static bool acf_scene_setting_valid(bAnimContext *ac, } } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_scene_setting_flag(bAnimContext *UNUSED(ac), eAnimChannel_Settings setting, bool *neg) @@ -766,7 +766,7 @@ static bool acf_object_setting_valid(bAnimContext *ac, } } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_object_setting_flag(bAnimContext *UNUSED(ac), eAnimChannel_Settings setting, bool *neg) @@ -949,7 +949,7 @@ static bool acf_group_setting_valid(bAnimContext *ac, } } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_group_setting_flag(bAnimContext *ac, eAnimChannel_Settings setting, bool *neg) { /* clear extra return data first */ @@ -1086,7 +1086,7 @@ static bool acf_fcurve_setting_valid(bAnimContext *ac, } } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_fcurve_setting_flag(bAnimContext *UNUSED(ac), eAnimChannel_Settings setting, bool *neg) @@ -1212,7 +1212,7 @@ static bool acf_nla_controls_setting_valid(bAnimContext *UNUSED(ac), } } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_nla_controls_setting_flag(bAnimContext *UNUSED(ac), eAnimChannel_Settings setting, bool *neg) @@ -1330,7 +1330,7 @@ static bool acf_fillactd_setting_valid(bAnimContext *UNUSED(ac), } } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_fillactd_setting_flag(bAnimContext *UNUSED(ac), eAnimChannel_Settings setting, bool *neg) @@ -1425,7 +1425,7 @@ static bool acf_filldrivers_setting_valid(bAnimContext *UNUSED(ac), } } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_filldrivers_setting_flag(bAnimContext *UNUSED(ac), eAnimChannel_Settings setting, bool *neg) @@ -1489,7 +1489,7 @@ static int acf_dsmat_icon(bAnimListElem *UNUSED(ale)) return ICON_MATERIAL_DATA; } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_dsmat_setting_flag(bAnimContext *UNUSED(ac), eAnimChannel_Settings setting, bool *neg) @@ -1568,7 +1568,7 @@ static int acf_dslight_icon(bAnimListElem *UNUSED(ale)) return ICON_LIGHT_DATA; } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_dslight_setting_flag(bAnimContext *UNUSED(ac), eAnimChannel_Settings setting, bool *neg) @@ -1656,7 +1656,7 @@ static short acf_dstex_offset(bAnimContext *UNUSED(ac), bAnimListElem *UNUSED(al return 14; /* XXX: simply include this in indention instead? */ } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_dstex_setting_flag(bAnimContext *UNUSED(ac), eAnimChannel_Settings setting, bool *neg) @@ -1736,7 +1736,7 @@ static int acf_dscachefile_icon(bAnimListElem *ale) return ICON_FILE; } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_dscachefile_setting_flag(bAnimContext *ac, eAnimChannel_Settings setting, bool *neg) { /* clear extra return data first */ @@ -1818,7 +1818,7 @@ static int acf_dscam_icon(bAnimListElem *UNUSED(ale)) return ICON_CAMERA_DATA; } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_dscam_setting_flag(bAnimContext *UNUSED(ac), eAnimChannel_Settings setting, bool *neg) @@ -1911,7 +1911,7 @@ static int acf_dscur_icon(bAnimListElem *ale) } } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_dscur_setting_flag(bAnimContext *UNUSED(ac), eAnimChannel_Settings setting, bool *neg) @@ -2009,7 +2009,7 @@ static bool acf_dsskey_setting_valid(bAnimContext *ac, } } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_dsskey_setting_flag(bAnimContext *UNUSED(ac), eAnimChannel_Settings setting, bool *neg) @@ -2088,7 +2088,7 @@ static int acf_dswor_icon(bAnimListElem *UNUSED(ale)) return ICON_WORLD_DATA; } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_dswor_setting_flag(bAnimContext *UNUSED(ac), eAnimChannel_Settings setting, bool *neg) @@ -2167,7 +2167,7 @@ static int acf_dspart_icon(bAnimListElem *UNUSED(ale)) return ICON_PARTICLE_DATA; } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_dspart_setting_flag(bAnimContext *UNUSED(ac), eAnimChannel_Settings setting, bool *neg) @@ -2246,7 +2246,7 @@ static int acf_dsmball_icon(bAnimListElem *UNUSED(ale)) return ICON_META_DATA; } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_dsmball_setting_flag(bAnimContext *UNUSED(ac), eAnimChannel_Settings setting, bool *neg) @@ -2327,7 +2327,7 @@ static int acf_dsarm_icon(bAnimListElem *UNUSED(ale)) return ICON_ARMATURE_DATA; } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_dsarm_setting_flag(bAnimContext *UNUSED(ac), eAnimChannel_Settings setting, bool *neg) @@ -2417,7 +2417,7 @@ static short acf_dsntree_offset(bAnimContext *ac, bAnimListElem *ale) return offset; } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_dsntree_setting_flag(bAnimContext *UNUSED(ac), eAnimChannel_Settings setting, bool *neg) @@ -2498,7 +2498,7 @@ static int acf_dslinestyle_icon(bAnimListElem *UNUSED(ale)) return ICON_LINE_DATA; } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_dslinestyle_setting_flag(bAnimContext *UNUSED(ac), eAnimChannel_Settings setting, bool *neg) @@ -2579,7 +2579,7 @@ static int acf_dsmesh_icon(bAnimListElem *UNUSED(ale)) return ICON_MESH_DATA; } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_dsmesh_setting_flag(bAnimContext *UNUSED(ac), eAnimChannel_Settings setting, bool *neg) @@ -2659,7 +2659,7 @@ static int acf_dslat_icon(bAnimListElem *UNUSED(ale)) return ICON_LATTICE_DATA; } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_dslat_setting_flag(bAnimContext *UNUSED(ac), eAnimChannel_Settings setting, bool *neg) @@ -2739,7 +2739,7 @@ static int acf_dsspk_icon(bAnimListElem *UNUSED(ale)) return ICON_SPEAKER; } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_dsspk_setting_flag(bAnimContext *UNUSED(ac), eAnimChannel_Settings setting, bool *neg) @@ -2818,7 +2818,7 @@ static int acf_dshair_icon(bAnimListElem *UNUSED(ale)) return ICON_HAIR_DATA; } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_dshair_setting_flag(bAnimContext *UNUSED(ac), eAnimChannel_Settings setting, bool *neg) @@ -2897,7 +2897,7 @@ static int acf_dspointcloud_icon(bAnimListElem *UNUSED(ale)) return ICON_POINTCLOUD_DATA; } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_dspointcloud_setting_flag(bAnimContext *UNUSED(ac), eAnimChannel_Settings setting, bool *neg) @@ -2978,7 +2978,7 @@ static int acf_dsvolume_icon(bAnimListElem *UNUSED(ale)) return ICON_VOLUME_DATA; } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_dsvolume_setting_flag(bAnimContext *UNUSED(ac), eAnimChannel_Settings setting, bool *neg) @@ -3137,7 +3137,7 @@ static int acf_dsgpencil_icon(bAnimListElem *UNUSED(ale)) return ICON_GREASEPENCIL; } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_dsgpencil_setting_flag(bAnimContext *UNUSED(ac), eAnimChannel_Settings setting, bool *neg) @@ -3218,7 +3218,7 @@ static int acf_dsmclip_icon(bAnimListElem *UNUSED(ale)) return ICON_SEQUENCE; } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_dsmclip_setting_flag(bAnimContext *UNUSED(ac), eAnimChannel_Settings setting, bool *neg) @@ -3343,7 +3343,7 @@ static bool acf_shapekey_setting_valid(bAnimContext *UNUSED(ac), } } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_shapekey_setting_flag(bAnimContext *UNUSED(ac), eAnimChannel_Settings setting, bool *neg) @@ -3437,7 +3437,7 @@ static bool acf_gpd_setting_valid(bAnimContext *UNUSED(ac), } } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_gpd_setting_flag(bAnimContext *UNUSED(ac), eAnimChannel_Settings setting, bool *neg) { /* clear extra return data first */ @@ -3530,7 +3530,7 @@ static bool acf_gpl_setting_valid(bAnimContext *UNUSED(ac), } } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_gpl_setting_flag(bAnimContext *UNUSED(ac), eAnimChannel_Settings setting, bool *neg) { /* clear extra return data first */ @@ -3616,7 +3616,7 @@ static bool acf_mask_setting_valid(bAnimContext *UNUSED(ac), } } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_mask_setting_flag(bAnimContext *UNUSED(ac), eAnimChannel_Settings setting, bool *neg) @@ -3713,7 +3713,7 @@ static bool acf_masklay_setting_valid(bAnimContext *UNUSED(ac), } } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_masklay_setting_flag(bAnimContext *UNUSED(ac), eAnimChannel_Settings setting, bool *neg) @@ -3849,7 +3849,7 @@ static bool acf_nlatrack_setting_valid(bAnimContext *UNUSED(ac), } } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_nlatrack_setting_flag(bAnimContext *UNUSED(ac), eAnimChannel_Settings setting, bool *neg) @@ -4038,7 +4038,7 @@ static bool acf_nlaaction_setting_valid(bAnimContext *UNUSED(ac), } } -/* get the appropriate flag(s) for the setting when it is valid */ +/* Get the appropriate flag(s) for the setting when it is valid. */ static int acf_nlaaction_setting_flag(bAnimContext *UNUSED(ac), eAnimChannel_Settings setting, bool *neg) @@ -4415,7 +4415,7 @@ void ANIM_channel_draw( /* set blending again, as may not be set in previous step */ GPU_blend(GPU_BLEND_ALPHA); - /* step 1) draw backdrop ........................................... */ + /* step 1) draw backdrop ........................................... */ if (acf->draw_backdrop) { acf->draw_backdrop(ac, ale, yminc, ymaxc); } @@ -5096,7 +5096,7 @@ static void draw_setting_widget(bAnimContext *ac, /* set call to send relevant notifiers and/or perform type-specific updates */ if (but) { switch (setting) { - /* settings needing flushing up/down hierarchy */ + /* Settings needing flushing up/down hierarchy. */ case ACHANNEL_SETTING_VISIBLE: /* Graph Editor - 'visibility' toggles */ case ACHANNEL_SETTING_PROTECT: /* General - protection flags */ case ACHANNEL_SETTING_MUTE: /* General - muting flags */ @@ -5184,12 +5184,12 @@ void ANIM_channel_draw_widgets(const bContext *C, if ((ac->spacetype == SPACE_GRAPH) && (acf->has_setting(ac, ale, ACHANNEL_SETTING_VISIBLE) || acf->has_setting(ac, ale, ACHANNEL_SETTING_ALWAYS_VISIBLE))) { - /* pin toggle */ + /* Pin toggle. */ if (acf->has_setting(ac, ale, ACHANNEL_SETTING_ALWAYS_VISIBLE)) { draw_setting_widget(ac, ale, acf, block, offset, ymid, ACHANNEL_SETTING_ALWAYS_VISIBLE); offset += ICON_WIDTH; } - /* visibility toggle */ + /* Visibility toggle. */ if (acf->has_setting(ac, ale, ACHANNEL_SETTING_VISIBLE)) { /* For F-curves, add the extra space for the color bands. */ if (ELEM(ale->type, ANIMTYPE_FCURVE, ANIMTYPE_NLACURVE)) { diff --git a/source/blender/editors/animation/anim_channels_edit.c b/source/blender/editors/animation/anim_channels_edit.c index 061fe0b07c5..58e257259c2 100644 --- a/source/blender/editors/animation/anim_channels_edit.c +++ b/source/blender/editors/animation/anim_channels_edit.c @@ -1685,7 +1685,7 @@ static void animchannels_group_channels(bAnimContext *ac, agrp = action_groups_add_new(act, name); BLI_assert(agrp != NULL); - /* transfer selected F-Curves across to new group */ + /* Transfer selected F-Curves across to new group. */ for (ale = anim_data.first; ale; ale = ale->next) { FCurve *fcu = (FCurve *)ale->data; bActionGroup *grp = fcu->grp; @@ -1726,7 +1726,7 @@ static int animchannels_group_exec(bContext *C, wmOperator *op) bAnimListElem *ale; int filter; - /* handle each animdata block separately, so that the regrouping doesn't flow into blocks */ + /* Handle each animdata block separately, so that the regrouping doesn't flow into blocks. */ filter = (ANIMFILTER_DATA_VISIBLE | ANIMFILTER_LIST_VISIBLE | ANIMFILTER_ANIMDATA | ANIMFILTER_NODUPLIS); ANIM_animdata_filter(&ac, &anim_data, filter, ac.data, ac.datatype); diff --git a/source/blender/editors/animation/anim_deps.c b/source/blender/editors/animation/anim_deps.c index 31284e41b18..42fdb714127 100644 --- a/source/blender/editors/animation/anim_deps.c +++ b/source/blender/editors/animation/anim_deps.c @@ -93,9 +93,9 @@ void ANIM_list_elem_update(Main *bmain, Scene *scene, bAnimListElem *ale) fcu = (ale->datatype == ALE_FCURVE) ? ale->key_data : NULL; if (fcu && fcu->rna_path) { - /* if we have an fcurve, call the update for the property we + /* If we have an fcurve, call the update for the property we * are editing, this is then expected to do the proper redraws - * and depsgraph updates */ + * and depsgraph updates. */ PointerRNA id_ptr, ptr; PropertyRNA *prop; diff --git a/source/blender/editors/animation/anim_draw.c b/source/blender/editors/animation/anim_draw.c index aca332ff0fe..d5c7ff07274 100644 --- a/source/blender/editors/animation/anim_draw.c +++ b/source/blender/editors/animation/anim_draw.c @@ -168,7 +168,7 @@ void ANIM_draw_framerange(Scene *scene, View2D *v2d) } /* *************************************************** */ -/* NLA-MAPPING UTILITIES (required for drawing and also editing keyframes) */ +/* NLA-MAPPING UTILITIES (required for drawing and also editing keyframes). */ /** * Obtain the AnimData block providing NLA-mapping for the given channel (if applicable). diff --git a/source/blender/editors/animation/drivers.c b/source/blender/editors/animation/drivers.c index 43d5efe9ea9..ecc1b4b4523 100644 --- a/source/blender/editors/animation/drivers.c +++ b/source/blender/editors/animation/drivers.c @@ -568,7 +568,7 @@ bool ANIM_remove_driver(ReportList *UNUSED(reports), FCurve *fcu_iter = adt->drivers.first; while ((fcu = BKE_fcurve_iter_step(fcu_iter, rna_path)) != NULL) { - /* store the next fcurve for looping */ + /* Store the next fcurve for looping. */ fcu_iter = fcu->next; /* remove F-Curve from driver stack, then free it */ diff --git a/source/blender/editors/animation/fmodifier_ui.c b/source/blender/editors/animation/fmodifier_ui.c index 653bd72b364..31552330071 100644 --- a/source/blender/editors/animation/fmodifier_ui.c +++ b/source/blender/editors/animation/fmodifier_ui.c @@ -246,7 +246,7 @@ static PanelType *fmodifier_subpanel_register(ARegionType *region_type, #define B_REDR 1 #define B_FMODIFIER_REDRAW 20 -/* callback to remove the given modifier */ +/* Callback to remove the given modifier. */ typedef struct FModifierDeleteContext { ID *owner_id; ListBase *modifiers; diff --git a/source/blender/editors/animation/keyframes_edit.c b/source/blender/editors/animation/keyframes_edit.c index 636f0d3cbea..badd7a4e3b6 100644 --- a/source/blender/editors/animation/keyframes_edit.c +++ b/source/blender/editors/animation/keyframes_edit.c @@ -1109,7 +1109,7 @@ static short set_bezier_auto_clamped(KeyframeEditData *UNUSED(ked), BezTriple *b return 0; } -/* Sets the selected bezier handles to type 'vector' */ +/* Sets the selected bezier handles to type 'vector'. */ static short set_bezier_vector(KeyframeEditData *UNUSED(ked), BezTriple *bezt) { /* If the key is selected, always apply to both handles. */ @@ -1164,7 +1164,7 @@ static short set_bezier_align(KeyframeEditData *UNUSED(ked), BezTriple *bezt) return 0; } -/* Sets selected bezier handles to type 'free' */ +/* Sets selected bezier handles to type 'free'. */ static short set_bezier_free(KeyframeEditData *UNUSED(ked), BezTriple *bezt) { /* If the key is selected, always apply to both handles. */ diff --git a/source/blender/editors/animation/keyframes_general.c b/source/blender/editors/animation/keyframes_general.c index b2d74376102..e1ae6526347 100644 --- a/source/blender/editors/animation/keyframes_general.c +++ b/source/blender/editors/animation/keyframes_general.c @@ -193,7 +193,7 @@ void clean_fcurve(struct bAnimContext *ac, bAnimListElem *ale, float thresh, boo BezTriple *lastb; int totCount, i; - /* check if any points */ + /* Check if any points. */ if ((fcu == NULL) || (fcu->bezt == NULL) || (fcu->totvert == 0) || (!cleardefault && fcu->totvert == 1)) { return; @@ -408,7 +408,7 @@ bool decimate_fcurve(bAnimListElem *ale, float remove_ratio, float error_sq_max) { FCurve *fcu = (FCurve *)ale->key_data; - /* Check if the curve actually has any points */ + /* Check if the curve actually has any points. */ if (fcu == NULL || fcu->bezt == NULL || fcu->totvert == 0) { return true; } @@ -588,7 +588,7 @@ typedef struct TempFrameValCache { float frame, val; } TempFrameValCache; -/* Evaluates the curves between each selected keyframe on each frame, and keys the value */ +/* Evaluates the curves between each selected keyframe on each frame, and keys the value. */ void sample_fcurve(FCurve *fcu) { BezTriple *bezt, *start = NULL, *end = NULL; @@ -600,7 +600,7 @@ void sample_fcurve(FCurve *fcu) return; } - /* find selected keyframes... once pair has been found, add keyframes */ + /* Find selected keyframes... once pair has been found, add keyframes. */ for (i = 0, bezt = fcu->bezt; i < fcu->totvert; i++, bezt++) { /* check if selected, and which end this is */ if (BEZT_ISSEL_ANY(bezt)) { diff --git a/source/blender/editors/animation/keyframing.c b/source/blender/editors/animation/keyframing.c index f229d48b4eb..e795d6fb774 100644 --- a/source/blender/editors/animation/keyframing.c +++ b/source/blender/editors/animation/keyframing.c @@ -952,7 +952,7 @@ static bool visualkey_can_use(PointerRNA *ptr, PropertyRNA *prop) case CONSTRAINT_TYPE_KINEMATIC: return true; - /* single-transform constraints */ + /* Single-transform constraints. */ case CONSTRAINT_TYPE_TRACKTO: if (searchtype == VISUALKEY_ROT) { return true; @@ -2817,7 +2817,7 @@ bool fcurve_frame_has_keyframe(FCurve *fcu, float frame, short filter) return false; } - /* we either include all regardless of muting, or only non-muted */ + /* 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 = BKE_fcurve_bezt_binarysearch_index(fcu->bezt, frame, fcu->totvert, &replace); diff --git a/source/blender/editors/armature/armature_relations.c b/source/blender/editors/armature/armature_relations.c index 66ca38ce218..59780bf011e 100644 --- a/source/blender/editors/armature/armature_relations.c +++ b/source/blender/editors/armature/armature_relations.c @@ -457,7 +457,7 @@ static void separated_armature_fix_links(Main *bmain, Object *origArm, Object *n bConstraint *con; ListBase *opchans, *npchans; - /* get reference to list of bones in original and new armatures */ + /* Get reference to list of bones in original and new armatures. */ opchans = &origArm->pose->chanbase; npchans = &newArm->pose->chanbase; @@ -576,7 +576,7 @@ static void separate_armature_bones(Main *bmain, Object *ob, const bool is_selec /* check if bone needs to be removed */ if (is_select == (EBONE_VISIBLE(arm, curbone) && (curbone->flag & BONE_SELECTED))) { - /* clear the bone->parent var of any bone that had this as its parent */ + /* Clear the bone->parent var of any bone that had this as its parent. */ LISTBASE_FOREACH (EditBone *, ebo, arm->edbo) { if (ebo->parent == curbone) { ebo->parent = NULL; diff --git a/source/blender/editors/armature/pose_edit.c b/source/blender/editors/armature/pose_edit.c index f5daa427149..f86cc1159d5 100644 --- a/source/blender/editors/armature/pose_edit.c +++ b/source/blender/editors/armature/pose_edit.c @@ -224,7 +224,7 @@ void ED_pose_recalculate_paths(bContext *C, Scene *scene, Object *ob, ePosePathC #endif /* For a single frame update it's faster to re-use existing dependency graph and avoid overhead - * of building all the relations and so on for a temporary one. */ + * of building all the relations and so on for a temporary one. */ if (range == POSE_PATH_CALC_RANGE_CURRENT_FRAME) { /* NOTE: Dependency graph will be evaluated at all the frames, but we first need to access some * nested pointers, like animation data. */ @@ -455,7 +455,7 @@ static void ED_pose_clear_paths(Object *ob, bool only_selected) DEG_id_tag_update(&ob->id, ID_RECALC_COPY_ON_WRITE); } -/* operator callback - wrapper for the backend function */ +/* Operator callback - wrapper for the back-end function. */ static int pose_clear_paths_exec(bContext *C, wmOperator *op) { Object *ob = BKE_object_pose_armature_get(CTX_data_active_object(C)); @@ -663,7 +663,7 @@ static int pose_bone_rotmode_exec(bContext *C, wmOperator *op) const int mode = RNA_enum_get(op->ptr, "type"); Object *prev_ob = NULL; - /* set rotation mode of selected bones */ + /* Set rotation mode of selected bones. */ CTX_DATA_BEGIN_WITH_ID (C, bPoseChannel *, pchan, selected_pose_bones, Object *, ob) { /* use API Method for conversions... */ BKE_rotMode_change_values( diff --git a/source/blender/editors/armature/pose_lib.c b/source/blender/editors/armature/pose_lib.c index 21fcbf8886b..f63334b25ba 100644 --- a/source/blender/editors/armature/pose_lib.c +++ b/source/blender/editors/armature/pose_lib.c @@ -863,7 +863,7 @@ typedef struct tPoseLib_PreviewData { /** active area. */ ScrArea *area; - /** RNA-Pointer to Object 'ob' .*/ + /** RNA-Pointer to Object 'ob'. */ PointerRNA rna_ptr; /** object to work on. */ Object *ob; @@ -1100,7 +1100,7 @@ static void poselib_keytag_pose(bContext *C, Scene *scene, tPoseLib_PreviewData /* start tagging/keying */ for (agrp = act->groups.first; agrp; agrp = agrp->next) { - /* only for selected bones unless there aren't any selected, in which case all are included */ + /* Only for selected bones unless there aren't any selected, in which case all are included. */ pchan = BKE_pose_channel_find_name(pose, agrp->name); if (pchan) { diff --git a/source/blender/editors/armature/pose_slide.c b/source/blender/editors/armature/pose_slide.c index d32faf9a9ea..4e8c969f705 100644 --- a/source/blender/editors/armature/pose_slide.c +++ b/source/blender/editors/armature/pose_slide.c @@ -1513,7 +1513,7 @@ static int pose_slide_modal(bContext *C, wmOperator *op, const wmEvent *event) } if (event->val == KM_PRESS) { switch (event->type) { - /* Transform Channel Limits */ + /* Transform Channel Limits. */ /* XXX: Replace these hard-coded hotkeys with a modal-map that can be customized. */ case EVT_GKEY: /* Location */ { diff --git a/source/blender/editors/armature/pose_transform.c b/source/blender/editors/armature/pose_transform.c index 6466773daac..e597fd46106 100644 --- a/source/blender/editors/armature/pose_transform.c +++ b/source/blender/editors/armature/pose_transform.c @@ -1383,7 +1383,7 @@ static int pose_clear_user_transforms_exec(bContext *C, wmOperator *op) BKE_animsys_evaluate_animdata( &workob.id, workob.adt, &anim_eval_context, ADT_RECALC_ANIM, false); - /* copy back values, but on selected bones only */ + /* Copy back values, but on selected bones only. */ for (pchan = dummyPose->chanbase.first; pchan; pchan = pchan->next) { pose_bone_do_paste(ob, pchan, only_select, 0); } diff --git a/source/blender/editors/armature/pose_utils.c b/source/blender/editors/armature/pose_utils.c index 8eae5288f7a..500b9663a6c 100644 --- a/source/blender/editors/armature/pose_utils.c +++ b/source/blender/editors/armature/pose_utils.c @@ -144,7 +144,9 @@ Object *poseAnim_object_get(Object *ob_) return NULL; } -/* get sets of F-Curves providing transforms for the bones in the Pose */ +/** + * Get sets of F-Curves providing transforms for the bones in the Pose. + */ void poseAnim_mapping_get(bContext *C, ListBase *pfLinks) { /* for each Pose-Channel which gets affected, get the F-Curves for that channel @@ -190,7 +192,7 @@ void poseAnim_mapping_get(bContext *C, ListBase *pfLinks) } } -/* free F-Curve <-> PoseChannel links */ +/* Free F-Curve <-> PoseChannel links. */ void poseAnim_mapping_free(ListBase *pfLinks) { tPChanFCurveLink *pfl, *pfln = NULL; diff --git a/source/blender/editors/curve/editcurve.c b/source/blender/editors/curve/editcurve.c index 2999ac784ba..58cd69781a7 100644 --- a/source/blender/editors/curve/editcurve.c +++ b/source/blender/editors/curve/editcurve.c @@ -3747,8 +3747,8 @@ static void subdividenurb(Object *obedit, View3D *v3d, int number_cuts) } if (sel) { /* U ! */ - /* Inserting U points is sort of 'default' Flat curves only get */ - /* U points inserted in them. */ + /* Inserting U points is sort of 'default' Flat curves only get + * U points inserted in them. */ bpn = bpnew = MEM_mallocN((sel + nu->pntsu) * nu->pntsv * sizeof(BPoint), "subdivideNurb4"); bp = nu->bp; @@ -3786,7 +3786,7 @@ static void subdividenurb(Object *obedit, View3D *v3d, int number_cuts) MEM_freeN(usel); MEM_freeN(vsel); - } /* End of 'if (nu->type == CU_NURBS)' */ + } /* End of `if (nu->type == CU_NURBS)`. */ } } diff --git a/source/blender/editors/curve/editcurve_query.c b/source/blender/editors/curve/editcurve_query.c index 56392aab5bf..a8fd3ea2803 100644 --- a/source/blender/editors/curve/editcurve_query.c +++ b/source/blender/editors/curve/editcurve_query.c @@ -168,8 +168,8 @@ bool ED_curve_pick_vert(ViewContext *vc, void ED_curve_nurb_vert_selected_find( Curve *cu, View3D *v3d, Nurb **r_nu, BezTriple **r_bezt, BPoint **r_bp) { - /* in nu and (bezt or bp) selected are written if there's 1 sel. */ - /* if more points selected in 1 spline: return only nu, bezt and bp are 0 */ + /* In nu and (bezt or bp) selected are written if there's 1 sel. */ + /* If more points selected in 1 spline: return only nu, bezt and bp are 0. */ ListBase *editnurb = &cu->editnurb->nurbs; BezTriple *bezt1; BPoint *bp1; diff --git a/source/blender/editors/curve/editcurve_select.c b/source/blender/editors/curve/editcurve_select.c index 90cefef38ee..e1dc2ec30ca 100644 --- a/source/blender/editors/curve/editcurve_select.c +++ b/source/blender/editors/curve/editcurve_select.c @@ -885,10 +885,10 @@ static void curve_select_more(Object *obedit) int a; short sel = 0; - /* note that NURBS surface is a special case because we mimic */ - /* the behavior of "select more" of mesh tools. */ - /* The algorithm is designed to work in planar cases so it */ - /* may not be optimal always (example: end of NURBS sphere) */ + /* NOTE: NURBS surface is a special case because we mimic + * the behavior of "select more" of mesh tools. + * The algorithm is designed to work in planar cases so it + * may not be optimal always (example: end of NURBS sphere). */ if (obedit->type == OB_SURF) { LISTBASE_FOREACH (Nurb *, nu, editnurb) { BLI_bitmap *selbpoints; diff --git a/source/blender/editors/curve/editcurve_undo.c b/source/blender/editors/curve/editcurve_undo.c index b07c3c85f4a..88f6398567d 100644 --- a/source/blender/editors/curve/editcurve_undo.c +++ b/source/blender/editors/curve/editcurve_undo.c @@ -97,7 +97,7 @@ static void undocurve_to_editcurve(Main *bmain, UndoCurve *ucu, Curve *cu, short BKE_fcurves_copy(&ad->drivers, &ucu->drivers); } - /* copy */ + /* Copy. */ for (nu = undobase->first; nu; nu = nu->next) { newnu = BKE_nurb_duplicate(nu); @@ -139,7 +139,7 @@ static void undocurve_from_editcurve(UndoCurve *ucu, Curve *cu, const short shap BKE_fcurves_copy(&ucu->drivers, &ad->drivers); } - /* copy */ + /* Copy. */ for (nu = nubase->first; nu; nu = nu->next) { newnu = BKE_nurb_duplicate(nu); diff --git a/source/blender/editors/gizmo_library/gizmo_library_utils.c b/source/blender/editors/gizmo_library/gizmo_library_utils.c index 847f3e3916c..77c65cd1bb8 100644 --- a/source/blender/editors/gizmo_library/gizmo_library_utils.c +++ b/source/blender/editors/gizmo_library/gizmo_library_utils.c @@ -118,10 +118,10 @@ void gizmo_property_data_update(wmGizmo *gz, const bool inverted) { if (gz_prop->custom_func.value_get_fn != NULL) { - /* pass */ + /* Pass. */ } else if (gz_prop->prop != NULL) { - /* pass */ + /* Pass. */ } else { data->offset = 0.0f; diff --git a/source/blender/editors/gpencil/annotate_paint.c b/source/blender/editors/gpencil/annotate_paint.c index e3c6fd8f878..69b21731284 100644 --- a/source/blender/editors/gpencil/annotate_paint.c +++ b/source/blender/editors/gpencil/annotate_paint.c @@ -908,7 +908,7 @@ static void annotation_stroke_newfrombuffer(tGPsdata *p) CLAMP(pt->strength, GPENCIL_STRENGTH_MIN, 1.0f); pt->time = ptc->time; - /** Create arrow strokes. **/ + /** Create arrow strokes. */ /* End arrow stroke. */ if ((runtime.sbuffer_sflag & GP_STROKE_USE_ARROW_END) && (runtime.arrow_end_style != GP_STROKE_ARROWSTYLE_NONE)) { diff --git a/source/blender/editors/gpencil/editaction_gpencil.c b/source/blender/editors/gpencil/editaction_gpencil.c index 166111c582c..92f1629f7f7 100644 --- a/source/blender/editors/gpencil/editaction_gpencil.c +++ b/source/blender/editors/gpencil/editaction_gpencil.c @@ -268,7 +268,7 @@ void ED_gpencil_layer_frames_duplicate(bGPDlayer *gpl) return; } - /* duplicate selected frames */ + /* Duplicate selected frames. */ LISTBASE_FOREACH_MUTABLE (bGPDframe *, gpf, &gpl->frames) { /* duplicate this frame */ @@ -421,7 +421,7 @@ bool ED_gpencil_anim_copybuf_paste(bAnimContext *ac, const short offset_mode) return false; } - /* check if single channel in buffer (disregard names if so) */ + /* Check if single channel in buffer (disregard names if so). */ if (gpencil_anim_copybuf.first == gpencil_anim_copybuf.last) { no_name = true; } diff --git a/source/blender/editors/gpencil/gpencil_data.c b/source/blender/editors/gpencil/gpencil_data.c index d9a807d17ab..b4afeb4ed8a 100644 --- a/source/blender/editors/gpencil/gpencil_data.c +++ b/source/blender/editors/gpencil/gpencil_data.c @@ -2865,7 +2865,7 @@ int ED_gpencil_join_objects_exec(bContext *C, wmOperator *op) BKE_gpencil_object_material_ensure(bmain, ob_dst, tmp_ma); } - /* duplicate bGPDlayers */ + /* Duplicate #bGPDlayers. */ tJoinGPencil_AdtFixData afd = {0}; afd.src_gpd = gpd_src; afd.tar_gpd = gpd_dst; diff --git a/source/blender/editors/gpencil/gpencil_edit.c b/source/blender/editors/gpencil/gpencil_edit.c index 21fa3ad3967..71e03f093b4 100644 --- a/source/blender/editors/gpencil/gpencil_edit.c +++ b/source/blender/editors/gpencil/gpencil_edit.c @@ -3555,7 +3555,7 @@ static int gpencil_stroke_join_exec(bContext *C, wmOperator *op) BLI_assert(ELEM(type, GP_STROKE_JOIN, GP_STROKE_JOINCOPY)); int tot_strokes = 0; - /** Alloc memory */ + /** Alloc memory. */ tJoinStrokes *strokes_list = MEM_malloc_arrayN(sizeof(tJoinStrokes), max_join_strokes, __func__); tJoinStrokes *elem = NULL; /* Read all selected strokes to create a list. */ diff --git a/source/blender/editors/gpencil/gpencil_fill.c b/source/blender/editors/gpencil/gpencil_fill.c index 5c4e2de6aa8..6e6ecfa583b 100644 --- a/source/blender/editors/gpencil/gpencil_fill.c +++ b/source/blender/editors/gpencil/gpencil_fill.c @@ -125,7 +125,7 @@ typedef struct tGPDfill { struct bGPDframe *gpf; /** Temp mouse position stroke. */ struct bGPDstroke *gps_mouse; - /** Pointer to report messages. */ + /** Pointer to report messages. */ struct ReportList *reports; /** flags */ short flag; diff --git a/source/blender/editors/gpencil/gpencil_intern.h b/source/blender/editors/gpencil/gpencil_intern.h index 276e8c81e0f..39be3db71b9 100644 --- a/source/blender/editors/gpencil/gpencil_intern.h +++ b/source/blender/editors/gpencil/gpencil_intern.h @@ -637,7 +637,7 @@ struct GP_EditableStrokes_Iter { if (ED_gpencil_stroke_material_editable(obact_, gpl, gps) == false) { \ continue; \ } \ - /* ... Do Stuff With Strokes ... */ + /* ... Do Stuff With Strokes ... */ #define GP_EDITABLE_STROKES_END(gpstroke_iter) \ } \ @@ -687,7 +687,7 @@ struct GP_EditableStrokes_Iter { if (gps->editcurve == NULL) \ continue; \ bGPDcurve *gpc = gps->editcurve; \ - /* ... Do Stuff With Strokes ... */ + /* ... Do Stuff With Strokes ... */ #define GP_EDITABLE_CURVES_END(gpstroke_iter) \ } \ @@ -738,7 +738,7 @@ struct GP_EditableStrokes_Iter { if (ED_gpencil_stroke_material_editable(obact_, gpl, gps) == false) { \ continue; \ } \ - /* ... Do Stuff With Strokes ... */ + /* ... Do Stuff With Strokes ... */ #define GP_EVALUATED_STROKES_END(gpstroke_iter) \ } \ diff --git a/source/blender/editors/gpencil/gpencil_paint.c b/source/blender/editors/gpencil/gpencil_paint.c index 638994bbc2a..7e0ec9b957c 100644 --- a/source/blender/editors/gpencil/gpencil_paint.c +++ b/source/blender/editors/gpencil/gpencil_paint.c @@ -3178,7 +3178,7 @@ static void gpencil_guide_event_handling(bContext *C, guide->type = GP_GUIDE_CIRCULAR; } } - /* Change line angle */ + /* Change line angle. */ else if (ELEM(event->type, EVT_JKEY, EVT_KKEY) && (event->val == KM_RELEASE)) { add_notifier = true; float angle = guide->angle; @@ -3460,7 +3460,7 @@ static void gpencil_add_arc_points(tGPsdata *p, const float mval[2], int segment interp_v4_v4v4( pt->vert_color, pt_before->vert_color, pt_prev->vert_color, stepcolor * (i + 1)); - /* Apply angle of stroke to brush size to interpolated points but slightly attenuated.. */ + /* Apply angle of stroke to brush size to interpolated points but slightly attenuated. */ if (brush_settings->draw_angle_factor != 0.0f) { gpencil_brush_angle_segment(p, pt_step, pt); CLAMP(pt->pressure, pt_prev->pressure * 0.5f, 1.0f); @@ -3771,7 +3771,7 @@ static int gpencil_draw_modal(bContext *C, wmOperator *op, const wmEvent *event) } } else if (p->region) { - /* Perform bounds check using */ + /* Perform bounds check using. */ const rcti *region_rect = ED_region_visible_rect(p->region); in_bounds = BLI_rcti_isect_pt_v(region_rect, event->mval); } diff --git a/source/blender/editors/gpencil/gpencil_sculpt_paint.c b/source/blender/editors/gpencil/gpencil_sculpt_paint.c index 2b8800e5136..864231e6aab 100644 --- a/source/blender/editors/gpencil/gpencil_sculpt_paint.c +++ b/source/blender/editors/gpencil/gpencil_sculpt_paint.c @@ -2020,7 +2020,7 @@ static int gpencil_sculpt_brush_modal(bContext *C, wmOperator *op, const wmEvent /* The operator can be in 2 states: Painting and Idling */ if (gso->is_painting) { - /* Painting */ + /* Painting. */ switch (event->type) { /* Mouse Move = Apply somewhere else */ case MOUSEMOVE: diff --git a/source/blender/editors/gpencil/gpencil_trace_utils.c b/source/blender/editors/gpencil/gpencil_trace_utils.c index 12c38fb2744..970afc3ff6b 100644 --- a/source/blender/editors/gpencil/gpencil_trace_utils.c +++ b/source/blender/editors/gpencil/gpencil_trace_utils.c @@ -250,7 +250,7 @@ void ED_gpencil_trace_data_to_strokes(Main *bmain, const int32_t thickness) { #define MAX_LENGTH 100.0f - /* Find materials and create them if not found. */ + /* Find materials and create them if not found. */ int32_t mat_fill_idx = BKE_gpencil_material_find_index_by_name_prefix(ob, "Stroke"); int32_t mat_mask_idx = BKE_gpencil_material_find_index_by_name_prefix(ob, "Holdout"); diff --git a/source/blender/editors/gpencil/gpencil_utils.c b/source/blender/editors/gpencil/gpencil_utils.c index 4da21bd05ee..31f5972fdf8 100644 --- a/source/blender/editors/gpencil/gpencil_utils.c +++ b/source/blender/editors/gpencil/gpencil_utils.c @@ -2215,7 +2215,7 @@ void ED_gpencil_tpoint_to_point(ARegion *region, void ED_gpencil_update_color_uv(Main *bmain, Material *mat) { Material *gps_ma = NULL; - /* read all strokes */ + /* Read all strokes. */ for (Object *ob = bmain->objects.first; ob; ob = ob->id.next) { if (ob->type == OB_GPENCIL) { bGPdata *gpd = ob->data; @@ -2478,7 +2478,7 @@ int ED_gpencil_select_stroke_segment(bGPdata *gpd, return 0; } - /* convert all gps points to 2d and save in a hash to avoid recalculation */ + /* Convert all gps points to 2d and save in a hash to avoid recalculation. */ int direction = 0; float(*points2d)[2] = MEM_mallocN(sizeof(*points2d) * gps->totpoints, "GP Stroke temp 2d points"); @@ -3302,7 +3302,7 @@ bGPDstroke *ED_gpencil_stroke_nearest_to_ends(bContext *C, return gps_rtn; } -/* Join two stroke using a contact point index and trimming the rest. */ +/* Join two stroke using a contact point index and trimming the rest. */ bGPDstroke *ED_gpencil_stroke_join_and_trim( bGPdata *gpd, bGPDframe *gpf, bGPDstroke *gps, bGPDstroke *gps_dst, const int pt_index) { diff --git a/source/blender/editors/gpencil/gpencil_vertex_paint.c b/source/blender/editors/gpencil/gpencil_vertex_paint.c index a05cc3c4dbd..3d99b314f7e 100644 --- a/source/blender/editors/gpencil/gpencil_vertex_paint.c +++ b/source/blender/editors/gpencil/gpencil_vertex_paint.c @@ -1335,7 +1335,7 @@ static int gpencil_vertexpaint_brush_modal(bContext *C, wmOperator *op, const wm /* The operator can be in 2 states: Painting and Idling */ if (gso->is_painting) { - /* Painting */ + /* Painting. */ switch (event->type) { /* Mouse Move = Apply somewhere else */ case MOUSEMOVE: diff --git a/source/blender/editors/gpencil/gpencil_weight_paint.c b/source/blender/editors/gpencil/gpencil_weight_paint.c index a3e5ece5862..6fb98b4a8ac 100644 --- a/source/blender/editors/gpencil/gpencil_weight_paint.c +++ b/source/blender/editors/gpencil/gpencil_weight_paint.c @@ -774,7 +774,7 @@ static int gpencil_weightpaint_brush_modal(bContext *C, wmOperator *op, const wm /* The operator can be in 2 states: Painting and Idling */ if (gso->is_painting) { - /* Painting */ + /* Painting. */ switch (event->type) { /* Mouse Move = Apply somewhere else */ case MOUSEMOVE: diff --git a/source/blender/editors/include/ED_keyframes_edit.h b/source/blender/editors/include/ED_keyframes_edit.h index cf90a21f799..e29ff3ed890 100644 --- a/source/blender/editors/include/ED_keyframes_edit.h +++ b/source/blender/editors/include/ED_keyframes_edit.h @@ -160,7 +160,7 @@ typedef struct KeyframeEditData { /* generic properties/data access */ /** temp list for storing custom list of data to check */ ListBase list; - /** pointer to current scene - many tools need access to cfra/etc. */ + /** pointer to current scene - many tools need access to cfra/etc. */ struct Scene *scene; /** pointer to custom data - usually 'Object' but also 'rectf', but could be other types too */ void *data; diff --git a/source/blender/editors/include/ED_keyframing.h b/source/blender/editors/include/ED_keyframing.h index 179c9d5b30d..08d19318d4c 100644 --- a/source/blender/editors/include/ED_keyframing.h +++ b/source/blender/editors/include/ED_keyframing.h @@ -434,7 +434,7 @@ void ANIM_copy_as_driver(struct ID *target_id, const char *target_path, const ch /* check if auto-keyframing is enabled (per scene takes precedence) */ #define IS_AUTOKEY_ON(scene) \ ((scene) ? ((scene)->toolsettings->autokey_mode & AUTOKEY_ON) : (U.autokey_mode & AUTOKEY_ON)) -/* check the mode for auto-keyframing (per scene takes precedence) */ +/* Check the mode for auto-keyframing (per scene takes precedence). */ #define IS_AUTOKEY_MODE(scene, mode) \ ((scene) ? ((scene)->toolsettings->autokey_mode == AUTOKEY_MODE_##mode) : \ (U.autokey_mode == AUTOKEY_MODE_##mode)) diff --git a/source/blender/editors/include/UI_icons.h b/source/blender/editors/include/UI_icons.h index f0a4b3c462e..484e083c111 100644 --- a/source/blender/editors/include/UI_icons.h +++ b/source/blender/editors/include/UI_icons.h @@ -989,7 +989,7 @@ DEF_ICON_VECTOR(COLLECTION_COLOR_06) DEF_ICON_VECTOR(COLLECTION_COLOR_07) DEF_ICON_VECTOR(COLLECTION_COLOR_08) -/* Events */ +/* Events. */ DEF_ICON_COLOR(EVENT_A) DEF_ICON_COLOR(EVENT_B) DEF_ICON_COLOR(EVENT_C) diff --git a/source/blender/editors/include/UI_view2d.h b/source/blender/editors/include/UI_view2d.h index 999f42efe65..16729873b4e 100644 --- a/source/blender/editors/include/UI_view2d.h +++ b/source/blender/editors/include/UI_view2d.h @@ -288,7 +288,7 @@ void UI_view2d_smooth_view(struct bContext *C, /* Gizmo Types */ /* view2d_gizmo_navigate.c */ -/* Caller passes in own idname. */ +/* Caller passes in own idname. */ void VIEW2D_GGT_navigate_impl(struct wmGizmoGroupType *gzgt, const char *idname); /* Edge pan */ diff --git a/source/blender/editors/interface/interface.c b/source/blender/editors/interface/interface.c index f5528638bec..90639878958 100644 --- a/source/blender/editors/interface/interface.c +++ b/source/blender/editors/interface/interface.c @@ -1198,7 +1198,7 @@ static bool ui_but_event_operator_string_from_menu(const bContext *C, /* annoying, create a property */ const IDPropertyTemplate val = {0}; - IDProperty *prop_menu = IDP_New(IDP_GROUP, &val, __func__); /* dummy, name is unimportant */ + IDProperty *prop_menu = IDP_New(IDP_GROUP, &val, __func__); /* Dummy, name is unimportant. */ IDP_AddToGroup(prop_menu, IDP_NewString(mt->idname, "name", sizeof(mt->idname))); if (WM_key_event_operator_string( @@ -1223,7 +1223,7 @@ static bool ui_but_event_operator_string_from_panel(const bContext *C, /* annoying, create a property */ const IDPropertyTemplate val = {0}; - IDProperty *prop_panel = IDP_New(IDP_GROUP, &val, __func__); /* dummy, name is unimportant */ + IDProperty *prop_panel = IDP_New(IDP_GROUP, &val, __func__); /* Dummy, name is unimportant. */ IDP_AddToGroup(prop_panel, IDP_NewString(pt->idname, "name", sizeof(pt->idname))); IDP_AddToGroup(prop_panel, IDP_New(IDP_INT, @@ -1804,7 +1804,7 @@ void UI_block_update_from_old(const bContext *C, uiBlock *block) static void ui_but_validate(const uiBut *but) { /* Number buttons must have a click-step, - * assert instead of correcting the value to ensure the caller knows what they're doing. */ + * assert instead of correcting the value to ensure the caller knows what they're doing. */ if (but->type == UI_BTYPE_NUM) { uiButNumber *number_but = (uiButNumber *)but; @@ -3578,7 +3578,7 @@ static void ui_but_build_drawstr_float(uiBut *but, double value) subtype = RNA_property_subtype(but->rnaprop); } - /* Change negative zero to regular zero, without altering anything else. */ + /* Change negative zero to regular zero, without altering anything else. */ value += +0.0f; if (value == (double)FLT_MAX) { @@ -4146,7 +4146,7 @@ static uiBut *ui_def_but(uiBlock *block, } #ifdef WITH_PYTHON - /* if the 'UI_OT_editsource' is running, extract the source info from the button */ + /* If the 'UI_OT_editsource' is running, extract the source info from the button. */ if (UI_editsource_enable_check()) { UI_editsource_active_but_test(but); } @@ -4184,7 +4184,7 @@ static void ui_def_but_rna__menu(bContext *UNUSED(C), uiLayout *layout, void *bu uiPopupBlockHandle *handle = block->handle; uiBut *but = (uiBut *)but_p; - /* see comment in ui_item_enum_expand, re: uiname */ + /* see comment in ui_item_enum_expand, re: `uiname`. */ const EnumPropertyItem *item_array; UI_block_flag_enable(block, UI_BLOCK_MOVEMOUSE_QUIT); diff --git a/source/blender/editors/interface/interface_draw.c b/source/blender/editors/interface/interface_draw.c index 40cfcaea883..05b6fcdded1 100644 --- a/source/blender/editors/interface/interface_draw.c +++ b/source/blender/editors/interface/interface_draw.c @@ -69,8 +69,7 @@ static int roundboxtype = UI_CNR_ALL; void UI_draw_roundbox_corner_set(int type) { /* Not sure the roundbox function is the best place to change this - * if this is undone, it's not that big a deal, only makes curves edges - * square for the */ + * if this is undone, it's not that big a deal, only makes curves edges square. */ roundboxtype = type; } diff --git a/source/blender/editors/interface/interface_handlers.c b/source/blender/editors/interface/interface_handlers.c index 1c55ce0f348..34465502c71 100644 --- a/source/blender/editors/interface/interface_handlers.c +++ b/source/blender/editors/interface/interface_handlers.c @@ -3068,7 +3068,7 @@ static bool ui_textedit_insert_buf(uiBut *but, if ((len + step >= data->maxlen) && (data->maxlen - (len + 1) > 0)) { if (UI_but_is_utf8(but)) { - /* shorten 'step' to a utf8 aligned size that fits */ + /* Shorten 'step' to a utf8 aligned size that fits. */ BLI_strnlen_utf8_ex(buf, data->maxlen - (len + 1), &step); } else { diff --git a/source/blender/editors/interface/interface_intern.h b/source/blender/editors/interface/interface_intern.h index 23856c41ceb..19ab36cef42 100644 --- a/source/blender/editors/interface/interface_intern.h +++ b/source/blender/editors/interface/interface_intern.h @@ -137,19 +137,19 @@ extern const short ui_radial_dir_to_angle[8]; /** #PieMenuData.flags */ enum { - /** pie menu item collision is detected at 90 degrees */ + /** Pie menu item collision is detected at 90 degrees. */ UI_PIE_DEGREES_RANGE_LARGE = (1 << 0), - /** use initial center of pie menu to calculate direction */ + /** Use initial center of pie menu to calculate direction. */ UI_PIE_INITIAL_DIRECTION = (1 << 1), - /** pie menu is drag style */ + /** Pie menu is drag style. */ UI_PIE_DRAG_STYLE = (1 << 2), - /** mouse not far enough from center position */ + /** Mouse not far enough from center position. */ UI_PIE_INVALID_DIR = (1 << 3), - /** pie menu changed to click style, click to confirm */ + /** Pie menu changed to click style, click to confirm. */ UI_PIE_CLICK_STYLE = (1 << 4), - /** pie animation finished, do not calculate any more motion */ + /** Pie animation finished, do not calculate any more motion. */ UI_PIE_ANIMATION_FINISHED = (1 << 5), - /** pie gesture selection has been done, now wait for mouse motion to end */ + /** Pie gesture selection has been done, now wait for mouse motion to end. */ UI_PIE_GESTURE_END_WAIT = (1 << 6), }; diff --git a/source/blender/editors/interface/interface_layout.c b/source/blender/editors/interface/interface_layout.c index c04432a2912..1ab6d050b4d 100644 --- a/source/blender/editors/interface/interface_layout.c +++ b/source/blender/editors/interface/interface_layout.c @@ -2346,7 +2346,7 @@ void uiItemFullR(uiLayout *layout, * In this case we want the ability not to have an icon. * * We could pass an argument not to set the icon to begin with however this is the one case - * the functionality is needed. */ + * the functionality is needed. */ if (but && no_icon) { if ((icon == ICON_NONE) && (but->icon != ICON_NONE)) { ui_def_but_icon_clear(but); @@ -2860,7 +2860,7 @@ static uiBut *ui_item_menu(uiLayout *layout, int w = ui_text_icon_width(layout, name, icon, 1); const int h = UI_UNIT_Y; - if (layout->root->type == UI_LAYOUT_HEADER) { /* ugly .. */ + if (layout->root->type == UI_LAYOUT_HEADER) { /* Ugly! */ if (icon == ICON_NONE && force_menu) { /* pass */ } @@ -2893,7 +2893,7 @@ static uiBut *ui_item_menu(uiLayout *layout, } if (argN) { - /* ugly .. */ + /* ugly! */ if (arg != argN) { but->poin = (char *)but; } diff --git a/source/blender/editors/interface/interface_region_tooltip.c b/source/blender/editors/interface/interface_region_tooltip.c index accfb78ab94..bf3425dd3eb 100644 --- a/source/blender/editors/interface/interface_region_tooltip.c +++ b/source/blender/editors/interface/interface_region_tooltip.c @@ -188,11 +188,11 @@ static void ui_tooltip_region_draw_cb(const bContext *UNUSED(C), ARegion *region /* tone_fg = rgb_to_grayscale(main_color); */ /* mix the colors */ - rgb_tint(value_color, 0.0f, 0.0f, tone_bg, 0.2f); /* light gray */ - rgb_tint(active_color, 0.6f, 0.2f, tone_bg, 0.2f); /* light blue */ - rgb_tint(normal_color, 0.0f, 0.0f, tone_bg, 0.4f); /* gray */ - rgb_tint(python_color, 0.0f, 0.0f, tone_bg, 0.5f); /* dark gray */ - rgb_tint(alert_color, 0.0f, 0.8f, tone_bg, 0.1f); /* red */ + rgb_tint(value_color, 0.0f, 0.0f, tone_bg, 0.2f); /* Light gray. */ + rgb_tint(active_color, 0.6f, 0.2f, tone_bg, 0.2f); /* Light blue. */ + rgb_tint(normal_color, 0.0f, 0.0f, tone_bg, 0.4f); /* Gray. */ + rgb_tint(python_color, 0.0f, 0.0f, tone_bg, 0.5f); /* Dark gray. */ + rgb_tint(alert_color, 0.0f, 0.8f, tone_bg, 0.1f); /* Red. */ /* draw text */ BLF_wordwrap(data->fstyle.uifont_id, data->wrap_width); diff --git a/source/blender/editors/interface/interface_templates.c b/source/blender/editors/interface/interface_templates.c index 3990ad68c4d..fc3af525d45 100644 --- a/source/blender/editors/interface/interface_templates.c +++ b/source/blender/editors/interface/interface_templates.c @@ -344,7 +344,7 @@ typedef struct TemplateID { float scale; } TemplateID; -/* Search browse menu, assign */ +/* Search browse menu, assign. */ static void template_ID_set_property_exec_fn(bContext *C, void *arg_template, void *item) { TemplateID *template_ui = (TemplateID *)arg_template; @@ -5883,7 +5883,7 @@ static void uilist_prepare(uiList *ui_list, } /* If list length changes or list is tagged to check this, - * and active is out of view, scroll to it .*/ + * and active is out of view, scroll to it. */ if (ui_list->list_last_len != len || ui_list->flag & UILST_SCROLL_TO_ACTIVE_ITEM) { if (activei_row < ui_list->list_scroll) { ui_list->list_scroll = activei_row; diff --git a/source/blender/editors/interface/interface_undo.c b/source/blender/editors/interface/interface_undo.c index 304d2254a81..40f196d9b45 100644 --- a/source/blender/editors/interface/interface_undo.c +++ b/source/blender/editors/interface/interface_undo.c @@ -107,7 +107,7 @@ void ui_textedit_undo_push(uiUndoStack_Text *stack, const char *text, int cursor } } - /* Create the new state */ + /* Create the new state. */ const int text_size = strlen(text) + 1; stack->current = MEM_mallocN(sizeof(uiUndoStack_Text_State) + text_size, __func__); stack->current->cursor_index = cursor_index; diff --git a/source/blender/editors/interface/interface_widgets.c b/source/blender/editors/interface/interface_widgets.c index ce1109ad9df..9212a0a7d9d 100644 --- a/source/blender/editors/interface/interface_widgets.c +++ b/source/blender/editors/interface/interface_widgets.c @@ -1531,14 +1531,14 @@ static void ui_text_clip_right_ex(const uiFontStyle *fstyle, int l_end = BLF_width_to_strlen(fstyle->uifont_id, str, max_len, okwidth - sep_strwidth, NULL); if (l_end > 0) { - /* At least one character, so clip and add the ellipsis. */ + /* At least one character, so clip and add the ellipsis. */ memcpy(str + l_end, sep, sep_len + 1); /* +1 for trailing '\0'. */ if (r_final_len) { *r_final_len = (size_t)(l_end) + sep_len; } } else { - /* Otherwise fit as much as we can without adding an ellipsis. */ + /* Otherwise fit as much as we can without adding an ellipsis. */ l_end = BLF_width_to_strlen(fstyle->uifont_id, str, max_len, okwidth, NULL); str[l_end] = '\0'; if (r_final_len) { diff --git a/source/blender/editors/interface/view2d.c b/source/blender/editors/interface/view2d.c index 224993555bf..5eb20ae601b 100644 --- a/source/blender/editors/interface/view2d.c +++ b/source/blender/editors/interface/view2d.c @@ -535,7 +535,7 @@ static void ui_view2d_curRect_validate_resize(View2D *v2d, bool resize) curRatio = height / width; winRatio = winy / winx; - /* both sizes change (area/region maximized) */ + /* Both sizes change (area/region maximized). */ if (do_x == do_y) { if (do_x && do_y) { /* here is 1,1 case, so all others must be 0,0 */ @@ -1738,15 +1738,15 @@ bool UI_view2d_view_to_region_clip( void UI_view2d_view_to_region( const View2D *v2d, float x, float y, int *r_region_x, int *r_region_y) { - /* step 1: express given coordinates as proportional values */ + /* Step 1: express given coordinates as proportional values. */ x = (x - v2d->cur.xmin) / BLI_rctf_size_x(&v2d->cur); y = (y - v2d->cur.ymin) / BLI_rctf_size_y(&v2d->cur); - /* step 2: convert proportional distances to screen coordinates */ + /* Step 2: convert proportional distances to screen coordinates. */ x = v2d->mask.xmin + (x * BLI_rcti_size_x(&v2d->mask)); y = v2d->mask.ymin + (y * BLI_rcti_size_y(&v2d->mask)); - /* although we don't clamp to lie within region bounds, we must avoid exceeding size of ints */ + /* Although we don't clamp to lie within region bounds, we must avoid exceeding size of ints. */ *r_region_x = clamp_float_to_int(x); *r_region_y = clamp_float_to_int(y); } @@ -1769,13 +1769,13 @@ void UI_view2d_view_to_region_rcti(const View2D *v2d, const rctf *rect_src, rcti const float mask_size[2] = {BLI_rcti_size_x(&v2d->mask), BLI_rcti_size_y(&v2d->mask)}; rctf rect_tmp; - /* step 1: express given coordinates as proportional values */ + /* Step 1: express given coordinates as proportional values. */ rect_tmp.xmin = (rect_src->xmin - v2d->cur.xmin) / cur_size[0]; rect_tmp.xmax = (rect_src->xmax - v2d->cur.xmin) / cur_size[0]; rect_tmp.ymin = (rect_src->ymin - v2d->cur.ymin) / cur_size[1]; rect_tmp.ymax = (rect_src->ymax - v2d->cur.ymin) / cur_size[1]; - /* step 2: convert proportional distances to screen coordinates */ + /* Step 2: convert proportional distances to screen coordinates. */ rect_tmp.xmin = v2d->mask.xmin + (rect_tmp.xmin * mask_size[0]); rect_tmp.xmax = v2d->mask.xmin + (rect_tmp.xmax * mask_size[0]); rect_tmp.ymin = v2d->mask.ymin + (rect_tmp.ymin * mask_size[1]); @@ -1800,7 +1800,7 @@ bool UI_view2d_view_to_region_rcti_clip(const View2D *v2d, const rctf *rect_src, BLI_assert(rect_src->xmin <= rect_src->xmax && rect_src->ymin <= rect_src->ymax); - /* step 1: express given coordinates as proportional values */ + /* Step 1: express given coordinates as proportional values. */ rect_tmp.xmin = (rect_src->xmin - v2d->cur.xmin) / cur_size[0]; rect_tmp.xmax = (rect_src->xmax - v2d->cur.xmin) / cur_size[0]; rect_tmp.ymin = (rect_src->ymin - v2d->cur.ymin) / cur_size[1]; @@ -1808,7 +1808,7 @@ bool UI_view2d_view_to_region_rcti_clip(const View2D *v2d, const rctf *rect_src, if (((rect_tmp.xmax < 0.0f) || (rect_tmp.xmin > 1.0f) || (rect_tmp.ymax < 0.0f) || (rect_tmp.ymin > 1.0f)) == 0) { - /* step 2: convert proportional distances to screen coordinates */ + /* Step 2: convert proportional distances to screen coordinates. */ rect_tmp.xmin = v2d->mask.xmin + (rect_tmp.xmin * mask_size[0]); rect_tmp.xmax = v2d->mask.ymin + (rect_tmp.xmax * mask_size[0]); rect_tmp.ymin = v2d->mask.ymin + (rect_tmp.ymin * mask_size[1]); diff --git a/source/blender/editors/interface/view2d_gizmo_navigate.c b/source/blender/editors/interface/view2d_gizmo_navigate.c index 8d3f1beb947..30b4a7c097a 100644 --- a/source/blender/editors/interface/view2d_gizmo_navigate.c +++ b/source/blender/editors/interface/view2d_gizmo_navigate.c @@ -113,7 +113,7 @@ static struct NavigateGizmoInfo *navigate_params_from_space_type(short space_typ case SPACE_CLIP: return g_navigate_params_for_space_clip; default: - /* Used for sequencer. */ + /* Used for sequencer. */ return g_navigate_params_for_view2d; } } diff --git a/source/blender/editors/interface/view2d_ops.c b/source/blender/editors/interface/view2d_ops.c index 7ad28cd6069..69acfc657dc 100644 --- a/source/blender/editors/interface/view2d_ops.c +++ b/source/blender/editors/interface/view2d_ops.c @@ -187,7 +187,7 @@ static void view_pan_apply(bContext *C, wmOperator *op) view_pan_apply_ex(C, vpd, RNA_int_get(op->ptr, "deltax"), RNA_int_get(op->ptr, "deltay")); } -/* cleanup temp customdata */ +/* Cleanup temp custom-data. */ static void view_pan_exit(wmOperator *op) { MEM_SAFE_FREE(op->customdata); @@ -805,7 +805,7 @@ static void view_zoomstep_apply(bContext *C, wmOperator *op) /** \name View Zoom Operator (single step) * \{ */ -/* cleanup temp customdata */ +/* Cleanup temp custom-data. */ static void view_zoomstep_exit(wmOperator *op) { UI_view2d_zoom_cache_reset(); @@ -1034,7 +1034,7 @@ static void view_zoomdrag_apply(bContext *C, wmOperator *op) UI_view2d_sync(CTX_wm_screen(C), CTX_wm_area(C), v2d, V2D_LOCK_COPY); } -/* cleanup temp customdata */ +/* Cleanup temp custom-data. */ static void view_zoomdrag_exit(bContext *C, wmOperator *op) { UI_view2d_zoom_cache_reset(); @@ -1914,7 +1914,7 @@ static void scroller_activate_init(bContext *C, ED_region_tag_redraw_no_rebuild(region); } -/* cleanup temp customdata */ +/* Cleanup temp custom-data. */ static void scroller_activate_exit(bContext *C, wmOperator *op) { if (op->customdata) { @@ -2056,7 +2056,7 @@ static int scroller_activate_modal(bContext *C, wmOperator *op, const wmEvent *e return OPERATOR_FINISHED; } - /* otherwise, end the drag action */ + /* Otherwise, end the drag action. */ if (vsm->lastx || vsm->lasty) { scroller_activate_exit(C, op); return OPERATOR_FINISHED; diff --git a/source/blender/editors/mask/mask_editaction.c b/source/blender/editors/mask/mask_editaction.c index 1792f0e13bc..03f3f438829 100644 --- a/source/blender/editors/mask/mask_editaction.c +++ b/source/blender/editors/mask/mask_editaction.c @@ -283,25 +283,25 @@ void ED_masklayer_frames_duplicate(MaskLayer *mask_layer) { MaskLayerShape *mask_layer_shape, *gpfn; - /* error checking */ + /* Error checking. */ if (mask_layer == NULL) { return; } - /* duplicate selected frames */ + /* Duplicate selected frames. */ for (mask_layer_shape = mask_layer->splines_shapes.first; mask_layer_shape; mask_layer_shape = gpfn) { gpfn = mask_layer_shape->next; - /* duplicate this frame */ + /* Duplicate this frame. */ if (mask_layer_shape->flag & MASK_SHAPE_SELECT) { MaskLayerShape *mask_shape_dupe; - /* duplicate frame, and deselect self */ + /* Duplicate frame, and deselect self. */ mask_shape_dupe = BKE_mask_layer_shape_duplicate(mask_layer_shape); mask_layer_shape->flag &= ~MASK_SHAPE_SELECT; - /* XXX - how to handle duplicate frames? */ + /* XXX: how to handle duplicate frames? */ BLI_insertlinkafter(&mask_layer->splines_shapes, mask_layer_shape, mask_shape_dupe); } } diff --git a/source/blender/editors/mask/mask_ops.c b/source/blender/editors/mask/mask_ops.c index 1a6ac8597ae..3476f1ca735 100644 --- a/source/blender/editors/mask/mask_ops.c +++ b/source/blender/editors/mask/mask_ops.c @@ -83,7 +83,9 @@ Mask *ED_mask_new(bContext *C, const char *name) return mask; } -/* Get ative layer. Will create mask/layer to be sure there's an active layer. */ +/** + * Get active layer. Will create mask/layer to be sure there's an active layer. + */ MaskLayer *ED_mask_layer_ensure(bContext *C, bool *r_added_mask) { Mask *mask = CTX_data_edit_mask(C); diff --git a/source/blender/editors/mask/mask_query.c b/source/blender/editors/mask/mask_query.c index 401b6eac4f2..cd51026d20c 100644 --- a/source/blender/editors/mask/mask_query.c +++ b/source/blender/editors/mask/mask_query.c @@ -169,7 +169,7 @@ bool ED_mask_find_nearest_diff_point(const bContext *C, } if (r_u) { - /* TODO(sergey): Projection fails in some weirdo cases.. */ + /* TODO(sergey): Projection fails in some weirdo cases. */ if (use_project) { u = BKE_mask_spline_project_co(point_spline, point, u, normal_co, MASK_PROJ_ANY); } diff --git a/source/blender/editors/mesh/editmesh_knife.c b/source/blender/editors/mesh/editmesh_knife.c index 2ba1d30900a..af4ce0abe5f 100644 --- a/source/blender/editors/mesh/editmesh_knife.c +++ b/source/blender/editors/mesh/editmesh_knife.c @@ -1160,7 +1160,7 @@ static void knife_add_single_cut(KnifeTool_OpData *kcd, } else if (lh1->kfe) { kfe->v1 = knife_split_edge(kcd, lh1->kfe, lh1->hit, lh1->cagehit, &kfe2); - lh1->v = kfe->v1; /* record the KnifeVert for this hit */ + lh1->v = kfe->v1; /* Record the #KnifeVert for this hit. */ } else { BLI_assert(lh1->f); @@ -1168,7 +1168,7 @@ static void knife_add_single_cut(KnifeTool_OpData *kcd, kfe->v1->is_cut = true; kfe->v1->is_face = true; knife_append_list(kcd, &kfe->v1->faces, lh1->f); - lh1->v = kfe->v1; /* record the KnifeVert for this hit */ + lh1->v = kfe->v1; /* Record the #KnifeVert for this hit. */ } if (lh2->v) { diff --git a/source/blender/editors/mesh/editmesh_rip.c b/source/blender/editors/mesh/editmesh_rip.c index 615590c51c6..8626520ec37 100644 --- a/source/blender/editors/mesh/editmesh_rip.c +++ b/source/blender/editors/mesh/editmesh_rip.c @@ -270,7 +270,7 @@ static EdgeLoopPair *edbm_ripsel_looptag_helper(BMesh *bm) break; } - /* initialize */ + /* Initialize. */ e_first = e; v_step = e_first->v1; e_step = NULL; /* quiet warning, will never remain this value */ diff --git a/source/blender/editors/mesh/editmesh_select.c b/source/blender/editors/mesh/editmesh_select.c index 46abf71c4e2..fc32a2d9bab 100644 --- a/source/blender/editors/mesh/editmesh_select.c +++ b/source/blender/editors/mesh/editmesh_select.c @@ -2983,7 +2983,7 @@ bool EDBM_select_interior_faces(BMEditMesh *em) int i_b = BM_elem_index_get(l_pair[1]->f); if (i_a != i_b) { /* Only for predictable results that don't depend on the order of radial loops, - * not essential. */ + * not essential. */ if (i_a > i_b) { SWAP(int, i_a, i_b); } diff --git a/source/blender/editors/mesh/editmesh_tools.c b/source/blender/editors/mesh/editmesh_tools.c index c09ce126b7f..ea4bdc551a2 100644 --- a/source/blender/editors/mesh/editmesh_tools.c +++ b/source/blender/editors/mesh/editmesh_tools.c @@ -4038,7 +4038,7 @@ static float bm_edge_seg_isect(const float sco_a[2], b2 = ((x22 * y21) - (x21 * y22)) / xdiff2; } else { - m2 = MAXSLOPE; /* Vertical slope */ + m2 = MAXSLOPE; /* Vertical slope. */ b2 = x22; } @@ -4088,7 +4088,7 @@ static float bm_edge_seg_isect(const float sco_a[2], /* Calculate the distance from point to line. */ if (m2 != MAXSLOPE) { - /* sqrt(m2 * m2 + 1); Only looking for change in sign. Skip extra math .*/ + /* `sqrt(m2 * m2 + 1);` Only looking for change in sign. Skip extra math. */ dist = (y12 - m2 * x12 - b2); } else { @@ -4110,8 +4110,8 @@ static float bm_edge_seg_isect(const float sco_a[2], m1 = MAXSLOPE; b1 = x12; } - x2max = max_ff(x21, x22) + 0.001f; /* prevent missed edges */ - x2min = min_ff(x21, x22) - 0.001f; /* due to round off error */ + x2max = max_ff(x21, x22) + 0.001f; /* Prevent missed edges. */ + x2min = min_ff(x21, x22) - 0.001f; /* Due to round off error. */ y2max = max_ff(y21, y22) + 0.001f; y2min = min_ff(y21, y22) - 0.001f; @@ -8219,7 +8219,7 @@ enum { EDBM_CLNOR_MODAL_POINTTO_SET_USE_SELECTED = 114, }; -/* called in transform_ops.c, on each regeneration of keymaps */ +/* Called in transform_ops.c, on each regeneration of key-maps. */ wmKeyMap *point_normals_modal_keymap(wmKeyConfig *keyconf) { static const EnumPropertyItem modal_items[] = { diff --git a/source/blender/editors/mesh/editmesh_utils.c b/source/blender/editors/mesh/editmesh_utils.c index 9c97bdd6fde..54a7b0dd22e 100644 --- a/source/blender/editors/mesh/editmesh_utils.c +++ b/source/blender/editors/mesh/editmesh_utils.c @@ -474,7 +474,7 @@ void EDBM_select_more(BMEditMesh *em, const bool use_face_step) use_faces, use_face_step); BMO_op_exec(em->bm, &bmop); - /* don't flush selection in edge/vertex mode */ + /* Don't flush selection in edge/vertex mode. */ BMO_slot_buffer_hflag_enable( em->bm, bmop.slots_out, "geom.out", BM_ALL_NOLOOP, BM_ELEM_SELECT, use_faces ? true : false); BMO_op_finish(em->bm, &bmop); @@ -496,7 +496,7 @@ void EDBM_select_less(BMEditMesh *em, const bool use_face_step) use_faces, use_face_step); BMO_op_exec(em->bm, &bmop); - /* don't flush selection in edge/vertex mode */ + /* Don't flush selection in edge/vertex mode. */ BMO_slot_buffer_hflag_disable( em->bm, bmop.slots_out, "geom.out", BM_ALL_NOLOOP, BM_ELEM_SELECT, use_faces ? true : false); BMO_op_finish(em->bm, &bmop); diff --git a/source/blender/editors/mesh/mesh_data.c b/source/blender/editors/mesh/mesh_data.c index d736510abd0..222476e6971 100644 --- a/source/blender/editors/mesh/mesh_data.c +++ b/source/blender/editors/mesh/mesh_data.c @@ -1096,7 +1096,7 @@ static void mesh_add_edges(Mesh *mesh, int len) totedge = mesh->totedge + len; - /* update customdata */ + /* Update custom-data. */ CustomData_copy(&mesh->edata, &edata, CD_MASK_MESH.emask, CD_DEFAULT, totedge); CustomData_copy_data(&mesh->edata, &edata, 0, 0, mesh->totedge); diff --git a/source/blender/editors/object/object_add.c b/source/blender/editors/object/object_add.c index b677a2f96c3..3f2356fa774 100644 --- a/source/blender/editors/object/object_add.c +++ b/source/blender/editors/object/object_add.c @@ -1854,7 +1854,7 @@ static int object_speaker_add_exec(bContext *C, wmOperator *op) /* hook them up */ BKE_nlatrack_add_strip(nlt, strip, is_liboverride); - /* auto-name the strip, and give the track an interesting name */ + /* Auto-name the strip, and give the track an interesting name. */ BLI_strncpy(nlt->name, DATA_("SoundTrack"), sizeof(nlt->name)); BKE_nlastrip_validate_name(adt, strip); @@ -2794,11 +2794,11 @@ static int object_convert_exec(bContext *C, wmOperator *op) basen = duplibase_for_convert(bmain, depsgraph, scene, view_layer, base, NULL); newob = basen->object; - /* decrement original mesh's usage count */ + /* Decrement original mesh's usage count. */ Mesh *me = newob->data; id_us_min(&me->id); - /* make a new copy of the mesh */ + /* Make a new copy of the mesh. */ newob->data = BKE_id_copy(bmain, &me->id); } else { @@ -2868,11 +2868,11 @@ static int object_convert_exec(bContext *C, wmOperator *op) basen = duplibase_for_convert(bmain, depsgraph, scene, view_layer, base, NULL); newob = basen->object; - /* decrement original mesh's usage count */ + /* Decrement original mesh's usage count. */ Mesh *me = newob->data; id_us_min(&me->id); - /* make a new copy of the mesh */ + /* Make a new copy of the mesh. */ newob->data = BKE_id_copy(bmain, &me->id); } else { @@ -2893,11 +2893,11 @@ static int object_convert_exec(bContext *C, wmOperator *op) basen = duplibase_for_convert(bmain, depsgraph, scene, view_layer, base, NULL); newob = basen->object; - /* decrement original mesh's usage count */ + /* Decrement original mesh's usage count. */ Mesh *me = newob->data; id_us_min(&me->id); - /* make a new copy of the mesh */ + /* Make a new copy of the mesh. */ newob->data = BKE_id_copy(bmain, &me->id); } else { @@ -2926,10 +2926,10 @@ static int object_convert_exec(bContext *C, wmOperator *op) basen = duplibase_for_convert(bmain, depsgraph, scene, view_layer, base, NULL); newob = basen->object; - /* decrement original curve's usage count */ + /* Decrement original curve's usage count. */ id_us_min(&((Curve *)newob->data)->id); - /* make a new copy of the curve */ + /* Make a new copy of the curve. */ newob->data = BKE_id_copy(bmain, ob->data); } else { @@ -3007,7 +3007,7 @@ static int object_convert_exec(bContext *C, wmOperator *op) basen = duplibase_for_convert(bmain, depsgraph, scene, view_layer, base, NULL); newob = basen->object; - /* decrement original curve's usage count */ + /* Decrement original curve's usage count. */ id_us_min(&((Curve *)newob->data)->id); /* make a new copy of the curve */ @@ -3091,11 +3091,11 @@ static int object_convert_exec(bContext *C, wmOperator *op) basen = duplibase_for_convert(bmain, depsgraph, scene, view_layer, base, NULL); newob = basen->object; - /* decrement original pointclouds's usage count */ + /* Decrement original point-cloud's usage count. */ PointCloud *pointcloud = newob->data; id_us_min(&pointcloud->id); - /* make a new copy of the pointcloud */ + /* Make a new copy of the point-cloud. */ newob->data = BKE_id_copy(bmain, &pointcloud->id); } else { diff --git a/source/blender/editors/object/object_constraint.c b/source/blender/editors/object/object_constraint.c index 06d6f2b94f3..a7aa6b4d6a4 100644 --- a/source/blender/editors/object/object_constraint.c +++ b/source/blender/editors/object/object_constraint.c @@ -547,7 +547,7 @@ static void test_constraint( else { Curve *cu = ct->tar->data; - /* auto-set 'Path' setting on curve so this works */ + /* auto-set 'Path' setting on curve so this works. */ cu->flag |= CU_PATH; } } @@ -1977,7 +1977,7 @@ static bool get_new_constraint_target( (!only_curve && !only_mesh)) { /* Only use the object & bone if the bone is visible & selected - * since we may have multiple objects in pose mode at once. */ + * since we may have multiple objects in pose mode at once. */ bPoseChannel *pchan = BKE_pose_channel_active_or_first_selected(ob); if (pchan != NULL) { *tar_pchan = pchan; @@ -2100,7 +2100,7 @@ static int constraint_add_exec( } } - /* do type-specific tweaking to the constraint settings */ + /* Do type-specific tweaking to the constraint settings. */ switch (type) { case CONSTRAINT_TYPE_PYTHON: /* FIXME: this code is not really valid anymore */ { diff --git a/source/blender/editors/object/object_edit.c b/source/blender/editors/object/object_edit.c index c8923bb55c1..9c2a4fb1880 100644 --- a/source/blender/editors/object/object_edit.c +++ b/source/blender/editors/object/object_edit.c @@ -1152,7 +1152,7 @@ void ED_objects_recalculate_paths(bContext *C, Scene *scene, eObjectPathCalcRang Depsgraph *depsgraph; bool free_depsgraph = false; /* For a single frame update it's faster to re-use existing dependency graph and avoid overhead - * of building all the relations and so on for a temporary one. */ + * of building all the relations and so on for a temporary one. */ if (range == OBJECT_PATH_CALC_RANGE_CURRENT_FRAME) { /* NOTE: Dependency graph will be evaluated at all the frames, but we first need to access some * nested pointers, like animation data. */ diff --git a/source/blender/editors/object/object_hook.c b/source/blender/editors/object/object_hook.c index 7122fd09892..fcee2818b22 100644 --- a/source/blender/editors/object/object_hook.c +++ b/source/blender/editors/object/object_hook.c @@ -772,7 +772,7 @@ void OBJECT_OT_hook_remove(wmOperatorType *ot) /* flags */ /* this operator removes modifier which isn't stored in local undo stack, - * so redoing it from redo panel gives totally weird results */ + * so redoing it from redo panel gives totally weird results. */ ot->flag = /*OPTYPE_REGISTER|*/ OPTYPE_UNDO; /* properties */ @@ -931,7 +931,7 @@ void OBJECT_OT_hook_assign(wmOperatorType *ot) /* flags */ /* this operator changes data stored in modifier which doesn't get pushed to undo stack, - * so redoing it from redo panel gives totally weird results */ + * so redoing it from redo panel gives totally weird results. */ ot->flag = /*OPTYPE_REGISTER|*/ OPTYPE_UNDO; /* properties */ diff --git a/source/blender/editors/object/object_modifier.c b/source/blender/editors/object/object_modifier.c index e14e5cbd44b..c336f77eaa9 100644 --- a/source/blender/editors/object/object_modifier.c +++ b/source/blender/editors/object/object_modifier.c @@ -2147,7 +2147,7 @@ static int multires_external_pack_exec(bContext *C, wmOperator *UNUSED(op)) return OPERATOR_CANCELLED; } - /* XXX don't remove.. */ + /* XXX don't remove. */ CustomData_external_remove(&me->ldata, &me->id, CD_MDISPS, me->totloop); return OPERATOR_FINISHED; diff --git a/source/blender/editors/object/object_ops.c b/source/blender/editors/object/object_ops.c index b50fc3c88fd..00ef439c18a 100644 --- a/source/blender/editors/object/object_ops.c +++ b/source/blender/editors/object/object_ops.c @@ -322,7 +322,7 @@ void ED_keymap_object(wmKeyConfig *keyconf) keymap = WM_keymap_ensure(keyconf, "Object Non-modal", 0, 0); /* Object Mode ---------------------------------------------------------------- */ - /* Note: this keymap gets disabled in non-objectmode, */ + /* Note: this keymap gets disabled in non-objectmode. */ keymap = WM_keymap_ensure(keyconf, "Object Mode", 0, 0); keymap->poll = object_mode_poll; } diff --git a/source/blender/editors/object/object_remesh.c b/source/blender/editors/object/object_remesh.c index c04c91d21b5..05f9980e0ab 100644 --- a/source/blender/editors/object/object_remesh.c +++ b/source/blender/editors/object/object_remesh.c @@ -588,7 +588,7 @@ static int voxel_size_edit_invoke(bContext *C, wmOperator *op, const wmEvent *ev /* Write the text position into the matrix. */ copy_v3_v3(cd->text_mat[3], text_pos); - /* Scale the text. */ + /* Scale the text. */ float text_pos_word_space[3]; mul_v3_m4v3(text_pos_word_space, active_object->obmat, text_pos); const float pixelsize = ED_view3d_pixel_size(rv3d, text_pos_word_space); diff --git a/source/blender/editors/object/object_vgroup.c b/source/blender/editors/object/object_vgroup.c index 3f40d637188..ae6ccf8d6a7 100644 --- a/source/blender/editors/object/object_vgroup.c +++ b/source/blender/editors/object/object_vgroup.c @@ -516,14 +516,14 @@ static void mesh_defvert_mirror_update_internal(Object *ob, const int def_nr) { if (def_nr == -1) { - /* all vgroups, add groups where needed */ + /* All vgroups, add groups where needed. */ int flip_map_len; int *flip_map = BKE_object_defgroup_flip_map(ob, &flip_map_len, true); BKE_defvert_sync_mapped(dvert_dst, dvert_src, flip_map, flip_map_len, true); MEM_freeN(flip_map); } else { - /* single vgroup */ + /* Single vgroup. */ MDeformWeight *dw = BKE_defvert_ensure_index(dvert_dst, BKE_object_defgroup_flip_index(ob, def_nr, 1)); if (dw) { diff --git a/source/blender/editors/physics/particle_edit.c b/source/blender/editors/physics/particle_edit.c index 2bf0f842623..accb9d9ef14 100644 --- a/source/blender/editors/physics/particle_edit.c +++ b/source/blender/editors/physics/particle_edit.c @@ -3955,7 +3955,7 @@ static void brush_puff(PEData *data, int point_index, float mouse_distance) /* keep the same distance from the root or we get glitches T35406. */ dist_ensure_v3_v3fl(co, co_root, length_accum); - /* re-use dco to compare before and after translation and add to the offset */ + /* Re-use dco to compare before and after translation and add to the offset. */ copy_v3_v3(dco, key->co); mul_v3_m4v3(key->co, imat, co); @@ -3974,7 +3974,7 @@ static void brush_puff(PEData *data, int point_index, float mouse_distance) /* this is simple but looks bad, adds annoying kinks */ add_v3_v3(key->co, ofs); #else - /* translate (not rotate) the rest of the hair if its not selected */ + /* Translate (not rotate) the rest of the hair if its not selected. */ { /* NOLINTNEXTLINE: readability-redundant-preprocessor */ # if 0 /* kindof works but looks worse than what's below */ diff --git a/source/blender/editors/render/render_opengl.c b/source/blender/editors/render/render_opengl.c index 48f937fb4ec..aa1a2a6b867 100644 --- a/source/blender/editors/render/render_opengl.c +++ b/source/blender/editors/render/render_opengl.c @@ -645,7 +645,7 @@ static int gather_frames_to_render_for_id(LibraryIDLinkCallbackData *cb_data) case ID_WM: /* WindowManager */ case ID_LS: /* FreestyleLineStyle */ case ID_PAL: /* Palette */ - case ID_PC: /* PaintCurve */ + case ID_PC: /* PaintCurve */ case ID_CF: /* CacheFile */ case ID_WS: /* WorkSpace */ /* Only follow pointers to specific datablocks, to avoid ending up in diff --git a/source/blender/editors/render/render_preview.c b/source/blender/editors/render/render_preview.c index 0b0009c2a2f..f36ce7408b5 100644 --- a/source/blender/editors/render/render_preview.c +++ b/source/blender/editors/render/render_preview.c @@ -955,7 +955,7 @@ static void shader_preview_texture(ShaderPreview *sp, Tex *tex, Scene *sce, Rend for (int x = 0; x < width; x++) { tex_coord[0] = ((float)x / (float)height) * 2.0f - 1.0f; - /* Evaluate texture at tex_coord .*/ + /* Evaluate texture at tex_coord. */ TexResult texres = {0}; BKE_texture_get_value_ex(sce, tex, tex_coord, &texres, img_pool, color_manage); diff --git a/source/blender/editors/render/render_update.c b/source/blender/editors/render/render_update.c index 3e8a1bda2f0..80b5623b9c3 100644 --- a/source/blender/editors/render/render_update.c +++ b/source/blender/editors/render/render_update.c @@ -216,7 +216,7 @@ void ED_render_view_layer_changed(Main *bmain, bScreen *screen) /***************************** Updates *********************************** * ED_render_id_flush_update gets called from DEG_id_tag_update, to do * * editor level updates when the ID changes. when these ID blocks are in * - * the dependency graph, we can get rid of the manual dependency checks */ + * the dependency graph, we can get rid of the manual dependency checks. */ static void material_changed(Main *UNUSED(bmain), Material *ma) { diff --git a/source/blender/editors/render/render_view.c b/source/blender/editors/render/render_view.c index eb4a040e891..97ecb67d6cc 100644 --- a/source/blender/editors/render/render_view.c +++ b/source/blender/editors/render/render_view.c @@ -51,9 +51,11 @@ /*********************** utilities for finding areas *************************/ -/* returns biggest area that is not uv/image editor. Note that it uses buttons */ -/* window as the last possible alternative. */ -/* would use BKE_screen_find_big_area(...) but this is too specific */ +/** + * Returns biggest area that is not uv/image editor. Note that it uses buttons + * window as the last possible alternative. + * would use #BKE_screen_find_big_area(...) but this is too specific. + */ static ScrArea *biggest_non_image_area(bContext *C) { bScreen *screen = CTX_wm_screen(C); diff --git a/source/blender/editors/screen/area.c b/source/blender/editors/screen/area.c index 377cc60f9db..299201d3042 100644 --- a/source/blender/editors/screen/area.c +++ b/source/blender/editors/screen/area.c @@ -3325,10 +3325,10 @@ void ED_region_header_layout(const bContext *C, ARegion *region) maxco += UI_HEADER_OFFSET; } - /* always as last */ + /* Always as last. */ UI_view2d_totRect_set(®ion->v2d, maxco, region->winy); - /* restore view matrix */ + /* Restore view matrix. */ UI_view2d_view_restore(C); } diff --git a/source/blender/editors/sculpt_paint/paint_cursor.c b/source/blender/editors/sculpt_paint/paint_cursor.c index 7e111905883..ab2b2f4b16b 100644 --- a/source/blender/editors/sculpt_paint/paint_cursor.c +++ b/source/blender/editors/sculpt_paint/paint_cursor.c @@ -940,7 +940,7 @@ static void paint_draw_curve_cursor(Brush *brush, ViewContext *vc) int j; PaintCurvePoint *cp_next = cp + 1; float data[(PAINT_CURVE_NUM_SEGMENTS + 1) * 2]; - /* Use color coding to distinguish handles vs curve segments. */ + /* Use color coding to distinguish handles vs curve segments. */ draw_bezier_handle_lines(pos, selec_col, &cp->bez); draw_tri_point(pos, selec_col, pivot_col, &cp->bez.vec[1][0], 10.0f, cp->bez.f2); draw_rect_point( diff --git a/source/blender/editors/sculpt_paint/paint_image_2d.c b/source/blender/editors/sculpt_paint/paint_image_2d.c index f0923cf3d28..392f39bbb94 100644 --- a/source/blender/editors/sculpt_paint/paint_image_2d.c +++ b/source/blender/editors/sculpt_paint/paint_image_2d.c @@ -745,7 +745,7 @@ static void brush_painter_2d_tex_mapping(ImagePaintState *s, mapping->ymax = (ymax - ymin) / (float)diameter; } else if (mapmode == MTEX_MAP_MODE_3D) { - /* 3D mapping, just mapping to canvas 0..1 */ + /* 3D mapping, just mapping to canvas 0..1. */ mapping->xmin = 2.0f * (ipos[0] * invw - 0.5f); mapping->ymin = 2.0f * (ipos[1] * invh - 0.5f); mapping->xmax = 2.0f * invw; diff --git a/source/blender/editors/sculpt_paint/paint_image_proj.c b/source/blender/editors/sculpt_paint/paint_image_proj.c index c83e4de281a..fc08b7cd1b4 100644 --- a/source/blender/editors/sculpt_paint/paint_image_proj.c +++ b/source/blender/editors/sculpt_paint/paint_image_proj.c @@ -576,7 +576,9 @@ static Image *project_paint_face_clone_image(const ProjPaintState *ps, int tri_i return slot ? slot->ima : ps->clone_ima; } -/* fast projection bucket array lookup, use the safe version for bound checking */ +/** + * Fast projection bucket array lookup, use the safe version for bound checking. + */ static int project_bucket_offset(const ProjPaintState *ps, const float projCoSS[2]) { /* If we were not dealing with screen-space 2D coords we could simple do... @@ -2969,7 +2971,7 @@ static void project_paint_face_init(const ProjPaintState *ps, ImBuf *ibuf, ImBuf **tmpibuf) { - /* Projection vars, to get the 3D locations into screen space */ + /* Projection vars, to get the 3D locations into screen space. */ MemArena *arena = ps->arena_mt[thread_index]; LinkNode **bucketPixelNodes = ps->bucketRect + bucket_index; LinkNode *bucketFaceNodes = ps->bucketFaces[bucket_index]; @@ -3011,7 +3013,7 @@ static void project_paint_face_init(const ProjPaintState *ps, rcti bounds_px; /* Variables for getting UV-space bounds. */ - /* bucket bounds in UV space so we can init pixels only for this face, */ + /* Bucket bounds in UV space so we can init pixels only for this face. */ float lt_uv_pxoffset[3][2]; float xhalfpx, yhalfpx; const float ibuf_xf = (float)ibuf->x, ibuf_yf = (float)ibuf->y; @@ -4516,8 +4518,8 @@ static void project_paint_begin(const bContext *C, reset_threads = true; } - /* really high values could cause problems since it has to allocate a few - * (ps->buckets_x*ps->buckets_y) sized arrays */ + /* Really high values could cause problems since it has to allocate a few + * `(ps->buckets_x * ps->buckets_y)` sized arrays. */ CLAMP(ps->buckets_x, PROJ_BUCKET_RECT_MIN, PROJ_BUCKET_RECT_MAX); CLAMP(ps->buckets_y, PROJ_BUCKET_RECT_MIN, PROJ_BUCKET_RECT_MAX); @@ -5364,7 +5366,7 @@ static void do_projectpaint_thread(TaskPool *__restrict UNUSED(pool), void *ph_v float texrgb[3]; float mask; - /* Extra mask for normal, layer stencil, .. */ + /* Extra mask for normal, layer stencil, etc. */ float custom_mask = ((float)projPixel->mask) * (1.0f / 65535.0f); /* Mask texture. */ @@ -5447,7 +5449,7 @@ static void do_projectpaint_thread(TaskPool *__restrict UNUSED(pool), void *ph_v } /* end copy */ - /* validate undo tile, since we will modify t*/ + /* Validate undo tile, since we will modify it. */ *projPixel->valid = true; last_partial_redraw_cell = last_projIma->partRedrawRect + projPixel->bb_cell_index; diff --git a/source/blender/editors/sculpt_paint/paint_stroke.c b/source/blender/editors/sculpt_paint/paint_stroke.c index 59a5ad63f0e..de01bc3a474 100644 --- a/source/blender/editors/sculpt_paint/paint_stroke.c +++ b/source/blender/editors/sculpt_paint/paint_stroke.c @@ -541,7 +541,7 @@ static void paint_brush_stroke_add_step(bContext *C, * It's strange that only texpaint had these guards. */ #if 0 /* special exception here for too high pressure values on first touch in - * windows for some tablets, then we just skip first touch .. */ + * windows for some tablets, then we just skip first touch. */ if (tablet && (pressure >= 0.99f) && ((pop->s.brush->flag & BRUSH_SPACING_PRESSURE) || BKE_brush_use_alpha_pressure(pop->s.brush) || @@ -1115,7 +1115,7 @@ bool paint_supports_dynamic_tex_coords(Brush *br, ePaintMode mode) #define PAINT_STROKE_MODAL_CANCEL 1 -/* called in paint_ops.c, on each regeneration of keymaps */ +/* Called in paint_ops.c, on each regeneration of key-maps. */ struct wmKeyMap *paint_stroke_modal_keymap(struct wmKeyConfig *keyconf) { static struct EnumPropertyItem modal_items[] = { diff --git a/source/blender/editors/sculpt_paint/paint_vertex_weight_ops.c b/source/blender/editors/sculpt_paint/paint_vertex_weight_ops.c index 0fafd3589fe..7991987ae1f 100644 --- a/source/blender/editors/sculpt_paint/paint_vertex_weight_ops.c +++ b/source/blender/editors/sculpt_paint/paint_vertex_weight_ops.c @@ -791,7 +791,7 @@ static int paint_weight_gradient_exec(bContext *C, wmOperator *op) wpaint_prev_create( &((WPGradient_vertStoreBase *)gesture->user_data.data)->wpp, me->dvert, me->totvert); - /* on init only, convert face -> vert sel */ + /* On initialization only, convert face -> vert sel. */ if (me->editflag & ME_EDIT_PAINT_FACE_SEL) { BKE_mesh_flush_select_from_polys(me); } diff --git a/source/blender/editors/sculpt_paint/sculpt_intern.h b/source/blender/editors/sculpt_paint/sculpt_intern.h index e2ee4c9fed3..b39fbe5ba1a 100644 --- a/source/blender/editors/sculpt_paint/sculpt_intern.h +++ b/source/blender/editors/sculpt_paint/sculpt_intern.h @@ -977,7 +977,7 @@ typedef struct StrokeCache { /* Symmetry index between 0 and 7 bit combo 0 is Brush only; * 1 is X mirror; 2 is Y mirror; 3 is XY; 4 is Z; 5 is XZ; 6 is YZ; 7 is XYZ */ int symmetry; - int mirror_symmetry_pass; /* the symmetry pass we are currently on between 0 and 7*/ + int mirror_symmetry_pass; /* The symmetry pass we are currently on between 0 and 7. */ float true_view_normal[3]; float view_normal[3]; diff --git a/source/blender/editors/sculpt_paint/sculpt_uv.c b/source/blender/editors/sculpt_paint/sculpt_uv.c index 219a8303674..2825639bb3d 100644 --- a/source/blender/editors/sculpt_paint/sculpt_uv.c +++ b/source/blender/editors/sculpt_paint/sculpt_uv.c @@ -101,9 +101,9 @@ typedef struct UVInitialStroke { /* custom data for uv smoothing brush */ typedef struct UvSculptData { - /* Contains the first of each set of coincident uvs. + /* Contains the first of each set of coincident UV's. * These will be used to perform smoothing on and propagate the changes - * to their coincident uvs */ + * to their coincident UV's */ UvAdjacencyElement *uv; /* ...Is what it says */ @@ -121,7 +121,7 @@ typedef struct UvSculptData { /* timer to be used for airbrush-type brush */ wmTimer *timer; - /* to determine quickly adjacent uvs */ + /* to determine quickly adjacent UV's */ UvElementMap *elementMap; /* uvsmooth Paint for fast reference */ @@ -550,7 +550,7 @@ static UvSculptData *uv_sculpt_stroke_init(bContext *C, wmOperator *op, const wm island_index = element->island; } - /* Count 'unique' uvs */ + /* Count 'unique' UV's */ for (i = 0; i < data->elementMap->totalUVs; i++) { if (data->elementMap->buf[i].separate && (!do_island_optimization || data->elementMap->buf[i].island == island_index)) { @@ -627,8 +627,8 @@ static UvSculptData *uv_sculpt_stroke_init(bContext *C, wmOperator *op, const wm offset2 = uniqueUv[itmp2]; edges[counter].flag = 0; - /* using an order policy, sort uvs according to address space. This avoids - * Having two different UvEdges with the same uvs on different positions */ + /* Using an order policy, sort UV's according to address space. + * This avoids having two different UvEdges with the same UV's on different positions. */ if (offset1 < offset2) { edges[counter].uv1 = offset1; edges[counter].uv2 = offset2; @@ -674,7 +674,7 @@ static UvSculptData *uv_sculpt_stroke_init(bContext *C, wmOperator *op, const wm BLI_ghash_free(edgeHash, NULL, NULL); MEM_freeN(edges); - /* transfer boundary edge property to uvs */ + /* transfer boundary edge property to UV's */ if (ts->uv_sculpt_settings & UV_SCULPT_LOCK_BORDERS) { for (i = 0; i < data->totalUvEdges; i++) { if (!data->uvedges[i].flag) { diff --git a/source/blender/editors/space_action/action_data.c b/source/blender/editors/space_action/action_data.c index efa714e315d..9e69b0a72db 100644 --- a/source/blender/editors/space_action/action_data.c +++ b/source/blender/editors/space_action/action_data.c @@ -723,7 +723,7 @@ static NlaStrip *action_layer_get_nlastrip(ListBase *strips, float ctime) return NULL; } -/* Switch NLA Strips/Actions */ +/* Switch NLA Strips/Actions. */ static void action_layer_switch_strip( AnimData *adt, NlaTrack *old_track, NlaStrip *old_strip, NlaTrack *nlt, NlaStrip *strip) { diff --git a/source/blender/editors/space_action/action_draw.c b/source/blender/editors/space_action/action_draw.c index 5036f22fd0e..d305f7504f3 100644 --- a/source/blender/editors/space_action/action_draw.c +++ b/source/blender/editors/space_action/action_draw.c @@ -83,7 +83,7 @@ void draw_channel_names(bContext *C, bAnimContext *ac, ARegion *region) /* need to do a view-sync here, so that the keys area doesn't jump around (it must copy this) */ UI_view2d_sync(NULL, ac->area, v2d, V2D_LOCK_COPY); - /* loop through channels, and set up drawing depending on their type */ + /* Loop through channels, and set up drawing depending on their type. */ { /* first pass: just the standard GL-drawing for backdrop + text */ size_t channel_index = 0; float ymax = ACHANNEL_FIRST_TOP(ac); diff --git a/source/blender/editors/space_action/action_edit.c b/source/blender/editors/space_action/action_edit.c index fea62f0d9c2..eea895297f2 100644 --- a/source/blender/editors/space_action/action_edit.c +++ b/source/blender/editors/space_action/action_edit.c @@ -1137,7 +1137,7 @@ void ACTION_OT_clean(wmOperatorType *ot) /* ******************** Sample Keyframes Operator *********************** */ -/* Evaluates the curves between each selected keyframe on each frame, and keys the value */ +/* Evaluates the curves between each selected keyframe on each frame, and keys the value. */ static void sample_action_keys(bAnimContext *ac) { ListBase anim_data = {NULL, NULL}; @@ -1149,7 +1149,7 @@ static void sample_action_keys(bAnimContext *ac) ANIMFILTER_FOREDIT /*| ANIMFILTER_CURVESONLY*/ | ANIMFILTER_NODUPLIS); ANIM_animdata_filter(ac, &anim_data, filter, ac->data, ac->datatype); - /* loop through filtered data and add keys between selected keyframes on every frame */ + /* Loop through filtered data and add keys between selected keyframes on every frame. */ for (ale = anim_data.first; ale; ale = ale->next) { sample_fcurve((FCurve *)ale->key_data); diff --git a/source/blender/editors/space_action/action_select.c b/source/blender/editors/space_action/action_select.c index fea01ab5330..2ab109c738d 100644 --- a/source/blender/editors/space_action/action_select.c +++ b/source/blender/editors/space_action/action_select.c @@ -470,7 +470,7 @@ static void box_select_action(bAnimContext *ac, const rcti rect, short mode, sho filter = (ANIMFILTER_DATA_VISIBLE | ANIMFILTER_LIST_VISIBLE | ANIMFILTER_LIST_CHANNELS); ANIM_animdata_filter(ac, &anim_data, filter, ac->data, ac->datatype); - /* get beztriple editing/validation funcs */ + /* Get beztriple editing/validation funcs. */ sel_data.select_cb = ANIM_editkeyframes_select(selectmode); if (ELEM(mode, ACTKEYS_BORDERSEL_FRAMERANGE, ACTKEYS_BORDERSEL_ALLKEYS)) { @@ -708,7 +708,7 @@ static void region_select_action_keys( filter = (ANIMFILTER_DATA_VISIBLE | ANIMFILTER_LIST_VISIBLE | ANIMFILTER_LIST_CHANNELS); ANIM_animdata_filter(ac, &anim_data, filter, ac->data, ac->datatype); - /* get beztriple editing/validation funcs */ + /* Get beztriple editing/validation funcs. */ sel_data.select_cb = ANIM_editkeyframes_select(selectmode); sel_data.ok_cb = ANIM_editkeyframes_ok(mode); @@ -1497,7 +1497,7 @@ void ACTION_OT_select_leftright(wmOperatorType *ot) ot->idname = "ACTION_OT_select_leftright"; ot->description = "Select keyframes to the left or the right of the current frame"; - /* api callbacks */ + /* api callbacks */ ot->invoke = actkeys_select_leftright_invoke; ot->exec = actkeys_select_leftright_exec; ot->poll = ED_operator_action_active; diff --git a/source/blender/editors/space_buttons/buttons_context.c b/source/blender/editors/space_buttons/buttons_context.c index aeb2c04656e..8772af1d98b 100644 --- a/source/blender/editors/space_buttons/buttons_context.c +++ b/source/blender/editors/space_buttons/buttons_context.c @@ -1220,7 +1220,7 @@ static void buttons_panel_context_draw(const bContext *C, Panel *panel) continue; } - /* Add icon and name .*/ + /* Add icon and name. */ int icon = RNA_struct_ui_icon(ptr->type); char namebuf[128]; char *name = RNA_struct_name_get_alloc(ptr, namebuf, sizeof(namebuf), NULL); diff --git a/source/blender/editors/space_clip/clip_utils.c b/source/blender/editors/space_clip/clip_utils.c index dbf733413e5..7194e78e940 100644 --- a/source/blender/editors/space_clip/clip_utils.c +++ b/source/blender/editors/space_clip/clip_utils.c @@ -398,7 +398,7 @@ void clip_delete_plane_track(bContext *C, MovieClip *clip, MovieTrackingPlaneTra DEG_id_tag_update(&clip->id, 0); } -/* Calculate space clip offset to be centered at the given point. */ +/* Calculate space clip offset to be centered at the given point. */ void clip_view_offset_for_center_to_point( SpaceClip *sc, const float x, const float y, float *r_offset_x, float *r_offset_y) { diff --git a/source/blender/editors/space_file/file_ops.c b/source/blender/editors/space_file/file_ops.c index 0ac03c4c307..0584e2ff938 100644 --- a/source/blender/editors/space_file/file_ops.c +++ b/source/blender/editors/space_file/file_ops.c @@ -86,7 +86,7 @@ static FileSelection find_file_mouse_rect(SpaceFile *sfile, BLI_rctf_rcti_copy(&rect_region_fl, rect_region); - /* Okay, manipulating v2d rects here is hacky... */ + /* Okay, manipulating v2d rects here is hacky... */ v2d->mask.ymax -= sfile->layout->offset_top; v2d->cur.ymax -= sfile->layout->offset_top; UI_view2d_region_to_view_rctf(v2d, &rect_region_fl, &rect_view_fl); diff --git a/source/blender/editors/space_file/filelist.c b/source/blender/editors/space_file/filelist.c index e43000d3f64..8862b2db4da 100644 --- a/source/blender/editors/space_file/filelist.c +++ b/source/blender/editors/space_file/filelist.c @@ -785,12 +785,12 @@ static bool is_filtered_hidden(const char *filename, const FileListInternEntry *file) { if ((filename[0] == '.') && (filename[1] == '\0')) { - return true; /* Ignore . */ + return true; /* Ignore. */ } if (filter->flags & FLF_HIDE_PARENT) { if (filename[0] == '.' && filename[1] == '.' && filename[2] == '\0') { - return true; /* Ignore .. */ + return true; /* Ignore. */ } } diff --git a/source/blender/editors/space_graph/graph_draw.c b/source/blender/editors/space_graph/graph_draw.c index c5358cdfa5b..dc237c1340a 100644 --- a/source/blender/editors/space_graph/graph_draw.c +++ b/source/blender/editors/space_graph/graph_draw.c @@ -1428,7 +1428,7 @@ void graph_draw_channel_names(bContext *C, bAnimContext *ac, ARegion *region) height = ACHANNEL_TOT_HEIGHT(ac, items); v2d->tot.ymin = -height; - /* loop through channels, and set up drawing depending on their type */ + /* Loop through channels, and set up drawing depending on their type. */ { /* first pass: just the standard GL-drawing for backdrop + text */ size_t channel_index = 0; float ymax = ACHANNEL_FIRST_TOP(ac); diff --git a/source/blender/editors/space_graph/graph_select.c b/source/blender/editors/space_graph/graph_select.c index 50d14d18be9..f5df60454eb 100644 --- a/source/blender/editors/space_graph/graph_select.c +++ b/source/blender/editors/space_graph/graph_select.c @@ -597,7 +597,7 @@ static bool box_select_graphkeys(bAnimContext *ac, initialize_box_select_key_editing_data( sipo, incl_handles, mode, ac, data, &scaled_rectf, &ked, &mapping_flag); - /* Get beztriple editing/validation funcs. */ + /* Get beztriple editing/validation funcs. */ const KeyframeEditFunc select_cb = ANIM_editkeyframes_select(selectmode); const KeyframeEditFunc ok_cb = ANIM_editkeyframes_ok(mode); @@ -1611,7 +1611,7 @@ void GRAPH_OT_select_leftright(wmOperatorType *ot) ot->idname = "GRAPH_OT_select_leftright"; ot->description = "Select keyframes to the left or the right of the current frame"; - /* api callbacks */ + /* api callbacks */ ot->invoke = graphkeys_select_leftright_invoke; ot->exec = graphkeys_select_leftright_exec; ot->poll = graphop_visible_keyframes_poll; diff --git a/source/blender/editors/space_graph/space_graph.c b/source/blender/editors/space_graph/space_graph.c index 0c6d904de01..3ebf58a2119 100644 --- a/source/blender/editors/space_graph/space_graph.c +++ b/source/blender/editors/space_graph/space_graph.c @@ -759,7 +759,7 @@ static void graph_refresh(const bContext *C, ScrArea *area) break; } - case SIPO_MODE_DRIVERS: /* drivers only */ + case SIPO_MODE_DRIVERS: /* Drivers only. */ { break; } diff --git a/source/blender/editors/space_nla/nla_draw.c b/source/blender/editors/space_nla/nla_draw.c index 7d4011e0812..0fd1a1318e8 100644 --- a/source/blender/editors/space_nla/nla_draw.c +++ b/source/blender/editors/space_nla/nla_draw.c @@ -734,7 +734,7 @@ void draw_nla_main_data(bAnimContext *ac, SpaceNla *snla, ARegion *region) int height = NLACHANNEL_TOT_HEIGHT(ac, items); v2d->tot.ymin = -height; - /* loop through channels, and set up drawing depending on their type */ + /* Loop through channels, and set up drawing depending on their type. */ float ymax = NLACHANNEL_FIRST_TOP(ac); for (bAnimListElem *ale = anim_data.first; ale; ale = ale->next, ymax -= NLACHANNEL_STEP(snla)) { @@ -894,7 +894,7 @@ void draw_nla_channel_list(const bContext *C, bAnimContext *ac, ARegion *region) /* set blending again, as may not be set in previous step */ GPU_blend(GPU_BLEND_ALPHA); - /* loop through channels, and set up drawing depending on their type */ + /* Loop through channels, and set up drawing depending on their type. */ for (ale = anim_data.first; ale; ale = ale->next, ymax -= NLACHANNEL_STEP(snla), channel_index++) { float ymin = ymax - NLACHANNEL_HEIGHT(snla); diff --git a/source/blender/editors/space_nla/nla_edit.c b/source/blender/editors/space_nla/nla_edit.c index dd381cc92fb..3ca3aa15cd3 100644 --- a/source/blender/editors/space_nla/nla_edit.c +++ b/source/blender/editors/space_nla/nla_edit.c @@ -1397,7 +1397,7 @@ static void nlaedit_split_strip_actclip( nstrip->start = splitframe; if ((splitaframe > strip->actstart) && (splitaframe < strip->actend)) { - /* only do this if we're splitting down the middle... */ + /* only do this if we're splitting down the middle... */ strip->actend = splitaframe; nstrip->actstart = splitaframe; } @@ -1412,7 +1412,7 @@ static void nlaedit_split_strip_actclip( /* split a given Meta strip */ static void nlaedit_split_strip_meta(NlaTrack *nlt, NlaStrip *strip) { - /* simply ungroup it for now... */ + /* simply ungroup it for now... */ BKE_nlastrips_clear_metastrip(&nlt->strips, strip); } @@ -1528,7 +1528,7 @@ static int nlaedit_toggle_mute_exec(bContext *C, wmOperator *UNUSED(op)) NlaTrack *nlt = (NlaTrack *)ale->data; NlaStrip *strip; - /* for every selected strip, toggle muting */ + /* For every selected strip, toggle muting. */ for (strip = nlt->strips.first; strip; strip = strip->next) { if (strip->flag & NLASTRIP_FLAG_SELECT) { /* just flip the mute flag for now */ diff --git a/source/blender/editors/space_nla/nla_select.c b/source/blender/editors/space_nla/nla_select.c index 87ad09fe2f9..dc95a01a021 100644 --- a/source/blender/editors/space_nla/nla_select.c +++ b/source/blender/editors/space_nla/nla_select.c @@ -577,7 +577,7 @@ void NLA_OT_select_leftright(wmOperatorType *ot) ot->idname = "NLA_OT_select_leftright"; ot->description = "Select strips to the left or the right of the current frame"; - /* api callbacks */ + /* api callbacks */ ot->invoke = nlaedit_select_leftright_invoke; ot->exec = nlaedit_select_leftright_exec; ot->poll = ED_operator_nla_active; diff --git a/source/blender/editors/space_node/drawnode.cc b/source/blender/editors/space_node/drawnode.cc index 1d4c3b67387..72fe786ad83 100644 --- a/source/blender/editors/space_node/drawnode.cc +++ b/source/blender/editors/space_node/drawnode.cc @@ -135,7 +135,7 @@ static void node_buts_mix_rgb(uiLayout *layout, bContext *UNUSED(C), PointerRNA static void node_buts_time(uiLayout *layout, bContext *UNUSED(C), PointerRNA *ptr) { #if 0 - /* XXX no context access here .. */ + /* XXX no context access here. */ bNode *node = (bNode*)ptr->data; CurveMapping *cumap = node->storage; diff --git a/source/blender/editors/space_outliner/outliner_draw.c b/source/blender/editors/space_outliner/outliner_draw.c index 328a787c768..cb61e548d53 100644 --- a/source/blender/editors/space_outliner/outliner_draw.c +++ b/source/blender/editors/space_outliner/outliner_draw.c @@ -3125,7 +3125,7 @@ static void outliner_draw_tree_element(bContext *C, *te_edit = te; } - /* Icons can be ui buts, we don't want it to overlap with restrict .*/ + /* Icons can be UI buts, we don't want it to overlap with restrict. */ if (restrict_column_width > 0) { xmax -= restrict_column_width + UI_UNIT_X; } diff --git a/source/blender/editors/space_outliner/outliner_select.c b/source/blender/editors/space_outliner/outliner_select.c index 50f089f894a..b14a3cdb91d 100644 --- a/source/blender/editors/space_outliner/outliner_select.c +++ b/source/blender/editors/space_outliner/outliner_select.c @@ -1816,7 +1816,7 @@ static TreeElement *outliner_find_rightmost_visible_child(SpaceOutliner *space_o return te; } -/* Find previous visible element in the tree */ +/* Find previous visible element in the tree. */ static TreeElement *outliner_find_previous_element(SpaceOutliner *space_outliner, TreeElement *te) { if (te->prev) { diff --git a/source/blender/editors/space_sequencer/sequencer_draw.c b/source/blender/editors/space_sequencer/sequencer_draw.c index b6929f12cc0..8341dbe6014 100644 --- a/source/blender/editors/space_sequencer/sequencer_draw.c +++ b/source/blender/editors/space_sequencer/sequencer_draw.c @@ -1056,7 +1056,7 @@ static void draw_seq_fcurve_overlay( continue; } - /* If some frames were skipped above, we need to close the shape. */ + /* If some frames were skipped above, we need to close the shape. */ if (skip) { fcurve_batch_add_verts( vbo, y1, y2, y_height, timeline_frame - eval_step, prev_val, &vert_count); diff --git a/source/blender/editors/space_statusbar/space_statusbar.c b/source/blender/editors/space_statusbar/space_statusbar.c index 0b4f483c114..bf2a5534e0b 100644 --- a/source/blender/editors/space_statusbar/space_statusbar.c +++ b/source/blender/editors/space_statusbar/space_statusbar.c @@ -39,7 +39,7 @@ #include "WM_message.h" #include "WM_types.h" -/* ******************** default callbacks for statusbar space ******************** */ +/* ******************** default callbacks for statusbar space ******************** */ static SpaceLink *statusbar_create(const ScrArea *UNUSED(area), const Scene *UNUSED(scene)) { diff --git a/source/blender/editors/space_view3d/view3d_camera_control.c b/source/blender/editors/space_view3d/view3d_camera_control.c index 0b232d525fa..638c8a49ffd 100644 --- a/source/blender/editors/space_view3d/view3d_camera_control.c +++ b/source/blender/editors/space_view3d/view3d_camera_control.c @@ -278,7 +278,7 @@ void ED_view3d_cameracontrol_update(View3DCameraControl *vctrl, mul_m4_m4m4(parent_mat, diff_mat, vctrl->root_parent->obmat); if (object_apply_mat4_with_protect(vctrl->root_parent, parent_mat, false, rv3d, view_mat)) { - /* Calculate again since the view locking changes the matrix. */ + /* Calculate again since the view locking changes the matrix. */ ED_view3d_to_m4(view_mat, rv3d->ofs, rv3d->viewquat, rv3d->dist); } diff --git a/source/blender/editors/space_view3d/view3d_edit.c b/source/blender/editors/space_view3d/view3d_edit.c index 53fc7eed43b..50e9a9fb805 100644 --- a/source/blender/editors/space_view3d/view3d_edit.c +++ b/source/blender/editors/space_view3d/view3d_edit.c @@ -611,7 +611,7 @@ enum { VIEWROT_MODAL_SWITCH_ROTATE = 6, }; -/* called in transform_ops.c, on each regeneration of keymaps */ +/* Called in transform_ops.c, on each regeneration of key-maps. */ void viewrotate_modal_keymap(wmKeyConfig *keyconf) { static const EnumPropertyItem modal_items[] = { @@ -1686,7 +1686,7 @@ void VIEW3D_OT_ndof_all(struct wmOperatorType *ot) /* NOTE: these defines are saved in keymap files, do not change values but just add new ones */ -/* called in transform_ops.c, on each regeneration of keymaps */ +/* Called in transform_ops.c, on each regeneration of key-maps. */ void viewmove_modal_keymap(wmKeyConfig *keyconf) { static const EnumPropertyItem modal_items[] = { @@ -1881,8 +1881,8 @@ void VIEW3D_OT_move(wmOperatorType *ot) /** \name View Zoom Operator * \{ */ -/* viewdolly_modal_keymap has an exact copy of this, apply fixes to both */ -/* called in transform_ops.c, on each regeneration of keymaps */ +/* #viewdolly_modal_keymap has an exact copy of this, apply fixes to both. */ +/* Called in transform_ops.c, on each regeneration of key-maps. */ void viewzoom_modal_keymap(wmKeyConfig *keyconf) { static const EnumPropertyItem modal_items[] = { @@ -2445,8 +2445,8 @@ void VIEW3D_OT_zoom(wmOperatorType *ot) * which avoids #RegionView3D.dist approaching zero. * \{ */ -/* this is an exact copy of viewzoom_modal_keymap */ -/* called in transform_ops.c, on each regeneration of keymaps */ +/* This is an exact copy of #viewzoom_modal_keymap. */ +/* Called in transform_ops.c, on each regeneration of key-maps. */ void viewdolly_modal_keymap(wmKeyConfig *keyconf) { static const EnumPropertyItem modal_items[] = { diff --git a/source/blender/editors/space_view3d/view3d_fly.c b/source/blender/editors/space_view3d/view3d_fly.c index d42746c168c..91f3388cac9 100644 --- a/source/blender/editors/space_view3d/view3d_fly.c +++ b/source/blender/editors/space_view3d/view3d_fly.c @@ -101,7 +101,7 @@ typedef enum eFlyPanState { FLY_AXISLOCK_STATE_ACTIVE = 2, } eFlyPanState; -/* called in transform_ops.c, on each regeneration of keymaps */ +/* Called in transform_ops.c, on each regeneration of key-maps. */ void fly_modal_keymap(wmKeyConfig *keyconf) { static const EnumPropertyItem modal_items[] = { @@ -610,8 +610,7 @@ static void flyEvent(FlyInfo *fly, const wmEvent *event) fly->pan_view = false; break; - /* implement WASD keys, - * comments only for 'forward '*/ + /* Implement WASD keys, comments only for 'forward'. */ case FLY_MODAL_DIR_FORWARD: if (fly->axis == 2 && fly->speed < 0.0f) { /* reverse direction stops, tap again to continue */ diff --git a/source/blender/editors/space_view3d/view3d_placement.c b/source/blender/editors/space_view3d/view3d_placement.c index 04f382de56b..2186cdb3162 100644 --- a/source/blender/editors/space_view3d/view3d_placement.c +++ b/source/blender/editors/space_view3d/view3d_placement.c @@ -584,7 +584,7 @@ static bool calc_bbox(struct InteractivePlaceData *ipd, BoundBox *bounds) delta_a[x_axis] = 0.0f; delta_b[y_axis] = 0.0f; - /* Assign here in case secondary */ + /* Assign here in case secondary. */ fixed_aspect_dimension = max_ff(fabsf(delta_a[y_axis]), fabsf(delta_b[x_axis])); if (ipd->step[0].is_fixed_aspect) { @@ -1196,7 +1196,7 @@ static void view3d_interactive_add_begin(bContext *C, wmOperator *op, const wmEv } else { /* If the user runs this as an operator they should set the 'primitive_type', - * however running from operator search will end up at this point. */ + * however running from operator search will end up at this point. */ ipd->primitive_type = PLACE_PRIMITIVE_TYPE_CUBE; ipd->use_tool = false; } @@ -1830,7 +1830,7 @@ static void gizmo_plane_update_cursor(const bContext *C, /* This ensures the snap gizmo has settings from this tool. * This function call could be moved a more appropriate place, * responding to the setting being changed for example, - * however setting the value isn't expensive, so do it here. */ + * however setting the value isn't expensive, so do it here. */ idp_snap_gizmo_update_snap_elements(scene, snap_to, snap_gizmo); view3d_interactive_add_calc_plane((bContext *)C, diff --git a/source/blender/editors/space_view3d/view3d_utils.c b/source/blender/editors/space_view3d/view3d_utils.c index ea0b1f396c3..4f8b0fa4685 100644 --- a/source/blender/editors/space_view3d/view3d_utils.c +++ b/source/blender/editors/space_view3d/view3d_utils.c @@ -260,7 +260,7 @@ bool ED_view3d_context_activate(bContext *C) return false; } - /* bad context switch .. */ + /* Bad context switch. */ CTX_wm_area_set(C, area); CTX_wm_region_set(C, region); diff --git a/source/blender/editors/space_view3d/view3d_view.c b/source/blender/editors/space_view3d/view3d_view.c index 056b2507745..e17acd2f9c8 100644 --- a/source/blender/editors/space_view3d/view3d_view.c +++ b/source/blender/editors/space_view3d/view3d_view.c @@ -1261,7 +1261,7 @@ static bool view3d_localview_init(const Depsgraph *depsgraph, if (local_view_bit == 0) { /* TODO(dfelinto): We can kick one of the other 3D views out of local view - * specially if it is not being used. */ + * specially if it is not being used. */ BKE_report(reports, RPT_ERROR, "No more than 16 local views"); ok = false; } diff --git a/source/blender/editors/space_view3d/view3d_walk.c b/source/blender/editors/space_view3d/view3d_walk.c index ab4cf0c2135..fd99619f9e2 100644 --- a/source/blender/editors/space_view3d/view3d_walk.c +++ b/source/blender/editors/space_view3d/view3d_walk.c @@ -129,7 +129,7 @@ typedef enum eWalkGravityState { WALK_GRAVITY_STATE_ON, } eWalkGravityState; -/* called in transform_ops.c, on each regeneration of keymaps */ +/* Called in transform_ops.c, on each regeneration of key-maps. */ void walk_modal_keymap(wmKeyConfig *keyconf) { static const EnumPropertyItem modal_items[] = { diff --git a/source/blender/editors/transform/transform.c b/source/blender/editors/transform/transform.c index 17bfc23aea7..b03fb2c370f 100644 --- a/source/blender/editors/transform/transform.c +++ b/source/blender/editors/transform/transform.c @@ -650,7 +650,7 @@ static bool transform_modal_item_poll(const wmOperator *op, int value) return true; } -/* called in transform_ops.c, on each regeneration of keymaps */ +/* Called in transform_ops.c, on each regeneration of key-maps. */ wmKeyMap *transform_modal_keymap(wmKeyConfig *keyconf) { static const EnumPropertyItem modal_items[] = { diff --git a/source/blender/editors/transform/transform_convert.c b/source/blender/editors/transform/transform_convert.c index 9e285dd2d26..99368a40225 100644 --- a/source/blender/editors/transform/transform_convert.c +++ b/source/blender/editors/transform/transform_convert.c @@ -816,7 +816,7 @@ bool constraints_list_needinv(TransInfo *t, ListBase *list) /* only consider constraint if it is enabled, and has influence on result */ if ((con->flag & CONSTRAINT_DISABLE) == 0 && (con->enforce != 0.0f)) { /* (affirmative) returns for specific constraints here... */ - /* constraints that require this regardless */ + /* constraints that require this regardless. */ if (ELEM(con->type, CONSTRAINT_TYPE_FOLLOWPATH, CONSTRAINT_TYPE_CLAMPTO, diff --git a/source/blender/editors/transform/transform_convert_action.c b/source/blender/editors/transform/transform_convert_action.c index 8204264e105..3c302aac954 100644 --- a/source/blender/editors/transform/transform_convert_action.c +++ b/source/blender/editors/transform/transform_convert_action.c @@ -554,7 +554,7 @@ void createTransActionData(bContext *C, TransInfo *t) /** \name Action Transform Flush * \{ */ -/* This function helps flush transdata written to tempdata into the gp-frames */ +/* This function helps flush transdata written to tempdata into the gp-frames. */ static void flushTransIntFrameActionData(TransInfo *t) { TransDataContainer *tc = TRANS_DATA_CONTAINER_FIRST_SINGLE(t); diff --git a/source/blender/editors/transform/transform_convert_armature.c b/source/blender/editors/transform/transform_convert_armature.c index f29f323558a..1f1b1f8db97 100644 --- a/source/blender/editors/transform/transform_convert_armature.c +++ b/source/blender/editors/transform/transform_convert_armature.c @@ -1610,10 +1610,10 @@ static short apply_targetless_ik(Object *ob) Bone *bone; float mat[4][4]; - /* pose_mat(b) = pose_mat(b-1) * offs_bone * channel * constraint * IK */ - /* we put in channel the entire result of mat = (channel * constraint * IK) */ - /* pose_mat(b) = pose_mat(b-1) * offs_bone * mat */ - /* mat = pose_mat(b) * inv(pose_mat(b-1) * offs_bone ) */ + /* `pose_mat(b) = pose_mat(b-1) * offs_bone * channel * constraint * IK` */ + /* We put in channel the entire result of: `mat = (channel * constraint * IK)` */ + /* `pose_mat(b) = pose_mat(b-1) * offs_bone * mat` */ + /* `mat = pose_mat(b) * inv(pose_mat(b-1) * offs_bone)` */ parchan = chanlist[segcount - 1]; bone = parchan->bone; diff --git a/source/blender/editors/transform/transform_convert_curve.c b/source/blender/editors/transform/transform_convert_curve.c index cc3091ae70e..575e0da21a4 100644 --- a/source/blender/editors/transform/transform_convert_curve.c +++ b/source/blender/editors/transform/transform_convert_curve.c @@ -278,7 +278,7 @@ void createTransCurveVerts(TransInfo *t) td->ext = NULL; /* TODO - make points scale */ - if (t->mode == TFM_CURVE_SHRINKFATTEN) { /* || t->mode==TFM_RESIZE) {*/ + if (t->mode == TFM_CURVE_SHRINKFATTEN /* `|| t->mode == TFM_RESIZE` */) { td->val = &(bezt->radius); td->ival = bezt->radius; } diff --git a/source/blender/editors/transform/transform_convert_sequencer.c b/source/blender/editors/transform/transform_convert_sequencer.c index a67d18db37b..6a23b10b079 100644 --- a/source/blender/editors/transform/transform_convert_sequencer.c +++ b/source/blender/editors/transform/transform_convert_sequencer.c @@ -599,7 +599,7 @@ static void flushTransSeq(TransInfo *t) TransDataContainer *tc = TRANS_DATA_CONTAINER_FIRST_SINGLE(t); - /* flush to 2d vector from internally used 3d vector */ + /* Flush to 2D vector from internally used 3D vector. */ for (a = 0, td = tc->data, td2d = tc->data_2d; a < tc->data_len; a++, td++, td2d++) { tdsq = (TransDataSeq *)td->extra; seq = tdsq->seq; @@ -615,13 +615,13 @@ static void flushTransSeq(TransInfo *t) CLAMP(seq->machine, 1, MAXSEQ); break; - case SEQ_LEFTSEL: /* no vertical transform */ + case SEQ_LEFTSEL: /* No vertical transform. */ SEQ_transform_set_left_handle_frame(seq, new_frame); SEQ_transform_handle_xlimits(seq, tdsq->flag & SEQ_LEFTSEL, tdsq->flag & SEQ_RIGHTSEL); SEQ_transform_fix_single_image_seq_offsets(seq); SEQ_time_update_sequence(t->scene, seq); break; - case SEQ_RIGHTSEL: /* no vertical transform */ + case SEQ_RIGHTSEL: /* No vertical transform. */ SEQ_transform_set_right_handle_frame(seq, new_frame); SEQ_transform_handle_xlimits(seq, tdsq->flag & SEQ_LEFTSEL, tdsq->flag & SEQ_RIGHTSEL); SEQ_transform_fix_single_image_seq_offsets(seq); diff --git a/source/blender/editors/transform/transform_generics.c b/source/blender/editors/transform/transform_generics.c index 71c91221fbb..00b36f6653b 100644 --- a/source/blender/editors/transform/transform_generics.c +++ b/source/blender/editors/transform/transform_generics.c @@ -359,7 +359,7 @@ void initTransInfo(bContext *C, TransInfo *t, wmOperator *op, const wmEvent *eve if (op && (prop = RNA_struct_find_property(op->ptr, "value")) && RNA_property_is_set(op->ptr, prop)) { - float values[4] = {0}; /* in case value isn't length 4, avoid uninitialized memory */ + float values[4] = {0}; /* in case value isn't length 4, avoid uninitialized memory. */ if (RNA_property_array_check(prop)) { RNA_float_get_array(op->ptr, "value", values); t_values_set_is_array = true; diff --git a/source/blender/editors/transform/transform_mode_edge_slide.c b/source/blender/editors/transform/transform_mode_edge_slide.c index d255a7d5660..93d58b8dbe4 100644 --- a/source/blender/editors/transform/transform_mode_edge_slide.c +++ b/source/blender/editors/transform/transform_mode_edge_slide.c @@ -1220,7 +1220,7 @@ void drawEdgeSlide(TransInfo *t) immUniformThemeColorShadeAlpha(TH_EDGE_SELECT, 80, alpha_shade); immBegin(GPU_PRIM_LINES, sld->totsv * 2); - /* TODO(campbell): Loop over all verts */ + /* TODO(campbell): Loop over all verts. */ sv = sld->sv; for (i = 0; i < sld->totsv; i++, sv++) { float a[3], b[3]; diff --git a/source/blender/editors/uvedit/uvedit_ops.c b/source/blender/editors/uvedit/uvedit_ops.c index 7b034af1438..e18bbe0d7c2 100644 --- a/source/blender/editors/uvedit/uvedit_ops.c +++ b/source/blender/editors/uvedit/uvedit_ops.c @@ -624,7 +624,7 @@ static void uv_weld_align(bContext *C, eUVWeldAlign tool) } } else { - /* error - not a line, needs 3+ points */ + /* error - not a line, needs 3+ points. */ } if (eve_line) { @@ -632,7 +632,7 @@ static void uv_weld_align(bContext *C, eUVWeldAlign tool) } } else { - /* error - can't find an endpoint */ + /* error - can't find an endpoint. */ } } @@ -1194,8 +1194,8 @@ static bool uv_snap_uvs_to_adjacent_unselected(Scene *scene, Object *obedit) int uv_tot = 0; BM_ITER_ELEM (lsub, &lsubiter, l->v, BM_LOOPS_OF_VERT) { - if (BM_elem_flag_test(lsub->f, BM_ELEM_TAG) && /* face: visible */ - !BM_elem_flag_test(lsub, BM_ELEM_TAG)) /* loop: unselected */ + if (BM_elem_flag_test(lsub->f, BM_ELEM_TAG) && /* face: visible. */ + !BM_elem_flag_test(lsub, BM_ELEM_TAG)) /* loop: unselected. */ { luv = BM_ELEM_CD_GET_VOID_P(lsub, cd_loop_uv_offset); add_v2_v2(uv, luv->uv); diff --git a/source/blender/editors/uvedit/uvedit_rip.c b/source/blender/editors/uvedit/uvedit_rip.c index f8b53879ac4..631b831411f 100644 --- a/source/blender/editors/uvedit/uvedit_rip.c +++ b/source/blender/editors/uvedit/uvedit_rip.c @@ -907,7 +907,7 @@ static int uv_rip_exec(bContext *C, wmOperator *op) float aspx, aspy; { - /* Note that we only want to run this on the */ + /* Note that we only want to run this on the. */ Object *obedit = CTX_data_edit_object(C); ED_uvedit_get_aspect(obedit, &aspx, &aspy); } diff --git a/source/blender/editors/uvedit/uvedit_smart_stitch.c b/source/blender/editors/uvedit/uvedit_smart_stitch.c index 8ebf000baaa..0918717e051 100644 --- a/source/blender/editors/uvedit/uvedit_smart_stitch.c +++ b/source/blender/editors/uvedit/uvedit_smart_stitch.c @@ -1069,8 +1069,7 @@ static int stitch_process_data(StitchStateContainer *ssc, } } - /* remember stitchable candidates as places the 'I' button */ - /* will stop at. */ + /* Remember stitchable candidates as places the 'I' button will stop at. */ for (int island_idx = 0; island_idx < state->element_map->totalIslands; island_idx++) { state->island_is_stitchable[island_idx] = island_stitch_data[island_idx].stitchableCandidate ? true : @@ -2007,8 +2006,8 @@ static StitchState *stitch_init(bContext *C, all_edges[counter].first = NULL; all_edges[counter].flag = 0; all_edges[counter].element = element; - /* using an order policy, sort uvs according to address space. This avoids - * Having two different UvEdges with the same uvs on different positions */ + /* Using an order policy, sort UV's according to address space. + * This avoids having two different UvEdges with the same UV's on different positions. */ if (offset1 < offset2) { all_edges[counter].uv1 = offset1; all_edges[counter].uv2 = offset2; @@ -2381,9 +2380,9 @@ static int stitch_init_all(bContext *C, wmOperator *op) StitchState *state = ssc->states[ssc->active_object_index]; ssc->static_island %= state->element_map->totalIslands; - /* If the initial active object doesn't have any stitchable islands */ - /* then no active island will be seen in the UI. Make sure we're on */ - /* a stitchable object and island. */ + /* If the initial active object doesn't have any stitchable islands + * then no active island will be seen in the UI. + * Make sure we're on a stitchable object and island. */ if (!state->island_is_stitchable[ssc->static_island]) { goto_next_island(ssc); state = ssc->states[ssc->active_object_index]; |