From 67c8d97db36b285303abc5dce83b1bc8dc209651 Mon Sep 17 00:00:00 2001 From: Campbell Barton Date: Sun, 14 Feb 2021 20:58:04 +1100 Subject: Cleanup: spelling --- source/blender/blenfont/intern/blf.c | 2 +- source/blender/blenfont/intern/blf_dir.c | 2 +- source/blender/blenlib/intern/dot_export.cc | 2 +- source/blender/blenloader/intern/versioning_250.c | 2 +- source/blender/blenloader/intern/versioning_280.c | 2 +- .../blender/blenloader/intern/versioning_legacy.c | 2 +- source/blender/draw/engines/eevee/eevee_render.c | 2 +- source/blender/draw/engines/overlay/overlay_grid.c | 2 +- source/blender/editors/curve/editcurve.c | 2 +- source/blender/editors/curve/editcurve_select.c | 4 +- source/blender/editors/curve/editfont_undo.c | 2 +- source/blender/editors/gpencil/gpencil_data.c | 2 +- source/blender/editors/gpencil/gpencil_edit.c | 13 +- source/blender/editors/gpencil/gpencil_intern.h | 4 +- source/blender/editors/gpencil/gpencil_mesh.c | 2 +- source/blender/editors/gpencil/gpencil_paint.c | 4 +- source/blender/editors/gpencil/gpencil_select.c | 24 +-- source/blender/editors/gpencil/gpencil_undo.c | 2 +- source/blender/editors/include/ED_view3d.h | 4 +- .../interface/interface_region_menu_popup.c | 2 +- source/blender/editors/mesh/editmesh_undo.c | 2 +- source/blender/editors/object/object_add.c | 2 +- source/blender/editors/object/object_ops.c | 2 +- source/blender/editors/object/object_remesh.c | 2 +- source/blender/editors/screen/screen_edit.c | 2 +- .../sculpt_paint/paint_vertex_weight_utils.c | 2 +- .../editors/space_outliner/outliner_select.c | 2 +- source/blender/editors/space_view3d/view3d_view.c | 7 +- .../blender/freestyle/intern/geometry/FitCurve.cpp | 2 +- .../StrokeShader/BPy_PolygonalizationShader.cpp | 2 +- .../gpencil_modifiers/intern/MOD_gpencilnoise.c | 4 +- .../gpencil_modifiers/intern/MOD_gpencilsmooth.c | 4 +- source/blender/makesdna/DNA_anim_types.h | 2 +- source/blender/makesdna/DNA_boid_types.h | 2 +- source/blender/makesdna/DNA_cloth_types.h | 19 ++- .../makesdna/DNA_gpencil_modifier_defaults.h | 2 +- source/blender/makesdna/DNA_gpencil_types.h | 24 +-- source/blender/makesdna/DNA_lightprobe_types.h | 2 +- source/blender/makesdna/DNA_mask_types.h | 2 +- source/blender/makesdna/DNA_modifier_types.h | 2 +- source/blender/makesdna/DNA_object_force_types.h | 2 +- source/blender/makesdna/DNA_rigidbody_types.h | 4 +- source/blender/makesdna/DNA_scene_types.h | 184 +++++++++++---------- source/blender/makesdna/DNA_windowmanager_types.h | 2 +- source/blender/windowmanager/WM_toolsystem.h | 2 +- source/blender/windowmanager/WM_types.h | 2 +- source/blender/windowmanager/intern/wm_init_exit.c | 14 +- source/blender/windowmanager/intern/wm_keymap.c | 2 +- source/blender/windowmanager/intern/wm_playanim.c | 4 +- 49 files changed, 200 insertions(+), 185 deletions(-) (limited to 'source/blender') diff --git a/source/blender/blenfont/intern/blf.c b/source/blender/blenfont/intern/blf.c index 48f283e67b9..4d483934717 100644 --- a/source/blender/blenfont/intern/blf.c +++ b/source/blender/blenfont/intern/blf.c @@ -560,7 +560,7 @@ void BLF_draw_ascii_ex(int fontid, const char *str, size_t len, struct ResultBLF if (font) { blf_draw_gl__start(font); if (font->flags & BLF_WORD_WRAP) { - /* use non-ascii draw function for word-wrap */ + /* Use non-ASCII draw function for word-wrap. */ blf_font_draw__wrap(font, str, len, r_info); } else { diff --git a/source/blender/blenfont/intern/blf_dir.c b/source/blender/blenfont/intern/blf_dir.c index 25235097505..4fa915826b3 100644 --- a/source/blender/blenfont/intern/blf_dir.c +++ b/source/blender/blenfont/intern/blf_dir.c @@ -140,7 +140,7 @@ char *blf_dir_search(const char *file) } if (!s) { - /* Assume file is either an abslute path, or a relative path to current directory. */ + /* Assume file is either an absolute path, or a relative path to current directory. */ BLI_strncpy(full_path, file, sizeof(full_path)); BLI_path_abs(full_path, BKE_main_blendfile_path(G_MAIN)); if (BLI_exists(full_path)) { diff --git a/source/blender/blenlib/intern/dot_export.cc b/source/blender/blenlib/intern/dot_export.cc index 13a2341a9d5..93075a23c07 100644 --- a/source/blender/blenlib/intern/dot_export.cc +++ b/source/blender/blenlib/intern/dot_export.cc @@ -221,7 +221,7 @@ void Attributes::export__as_bracket_list(std::stringstream &ss) const ss << "["; attributes_.foreach_item([&](StringRef key, StringRef value) { if (StringRef(value).startswith("<")) { - /* Don't draw the quotes, this is an html-like value. */ + /* Don't draw the quotes, this is an HTML-like value. */ ss << key << "=" << value << ", "; } else { diff --git a/source/blender/blenloader/intern/versioning_250.c b/source/blender/blenloader/intern/versioning_250.c index 23f46e15f51..983fdce15f1 100644 --- a/source/blender/blenloader/intern/versioning_250.c +++ b/source/blender/blenloader/intern/versioning_250.c @@ -412,7 +412,7 @@ static void do_versions_windowmanager_2_50(bScreen *screen) area_add_window_regions(area, area->spacedata.first, &area->regionbase); - /* space imageselect is deprecated */ + /* Space image-select is deprecated. */ for (sl = area->spacedata.first; sl; sl = sl->next) { if (sl->spacetype == SPACE_IMASEL) { sl->spacetype = SPACE_EMPTY; /* spacedata then matches */ diff --git a/source/blender/blenloader/intern/versioning_280.c b/source/blender/blenloader/intern/versioning_280.c index 0e90d9b6045..ef2e196094e 100644 --- a/source/blender/blenloader/intern/versioning_280.c +++ b/source/blender/blenloader/intern/versioning_280.c @@ -4912,7 +4912,7 @@ void blo_do_versions_280(FileData *fd, Library *UNUSED(lib), Main *bmain) } } - /* Boundary Edges Automasking. */ + /* Boundary Edges Auto-masking. */ if (!DNA_struct_elem_find( fd->filesdna, "Brush", "int", "automasking_boundary_edges_propagation_steps")) { for (Brush *br = bmain->brushes.first; br; br = br->id.next) { diff --git a/source/blender/blenloader/intern/versioning_legacy.c b/source/blender/blenloader/intern/versioning_legacy.c index 5bbdb2ccfd1..e43f8153bd1 100644 --- a/source/blender/blenloader/intern/versioning_legacy.c +++ b/source/blender/blenloader/intern/versioning_legacy.c @@ -2378,7 +2378,7 @@ void blo_do_versions_pre250(FileData *fd, Library *lib, Main *bmain) Object *ob; bActionStrip *strip; - /* nla-strips - scale */ + /* NLA-strips - scale. */ for (ob = bmain->objects.first; ob; ob = ob->id.next) { for (strip = ob->nlastrips.first; strip; strip = strip->next) { float length, actlength, repeat; diff --git a/source/blender/draw/engines/eevee/eevee_render.c b/source/blender/draw/engines/eevee/eevee_render.c index 66e3d8ebd22..bc05b7915c3 100644 --- a/source/blender/draw/engines/eevee/eevee_render.c +++ b/source/blender/draw/engines/eevee/eevee_render.c @@ -157,7 +157,7 @@ void EEVEE_render_view_sync(EEVEE_Data *vedata, RenderEngine *engine, struct Dep { EEVEE_PrivateData *g_data = vedata->stl->g_data; - /* Set the pers & view matrix. */ + /* Set the perspective & view matrix. */ float winmat[4][4], viewmat[4][4], viewinv[4][4]; /* TODO(sergey): Shall render hold pointer to an evaluated camera instead? */ struct Object *ob_camera_eval = DEG_get_evaluated_object(depsgraph, g_data->cam_original_ob); diff --git a/source/blender/draw/engines/overlay/overlay_grid.c b/source/blender/draw/engines/overlay/overlay_grid.c index 87aa013f03a..5bb157ed081 100644 --- a/source/blender/draw/engines/overlay/overlay_grid.c +++ b/source/blender/draw/engines/overlay/overlay_grid.c @@ -93,7 +93,7 @@ void OVERLAY_grid_init(OVERLAY_Data *vedata) DRW_view_viewmat_get(NULL, viewmat, false); DRW_view_viewmat_get(NULL, viewinv, true); - /* if perps */ + /* If perspective view or non-axis aligned view. */ if (winmat[3][3] == 0.0f || rv3d->view == RV3D_VIEW_USER) { if (show_axis_x) { shd->grid_flag |= PLANE_XY | SHOW_AXIS_X; diff --git a/source/blender/editors/curve/editcurve.c b/source/blender/editors/curve/editcurve.c index 8ebc2077619..439515ed80f 100644 --- a/source/blender/editors/curve/editcurve.c +++ b/source/blender/editors/curve/editcurve.c @@ -2474,7 +2474,7 @@ static void adduplicateflagNurb( memcpy(&newnu->bp[b * newu], &nu->bp[b * nu->pntsu], newu * sizeof(BPoint)); } - /* check for actvert in the unused cyclicuv selection */ + /* Check for `actvert` in the unused cyclic-UV selection. */ if (cu->actnu == i) { if (cu->actvert == -1) { calc_duplicate_actnurb(editnurb, newnurb, cu); diff --git a/source/blender/editors/curve/editcurve_select.c b/source/blender/editors/curve/editcurve_select.c index 82f7b456284..d362ec23370 100644 --- a/source/blender/editors/curve/editcurve_select.c +++ b/source/blender/editors/curve/editcurve_select.c @@ -501,7 +501,7 @@ void CURVE_OT_de_select_first(wmOperatorType *ot) ot->idname = "CURVE_OT_de_select_first"; ot->description = "(De)select first of visible part of each NURBS"; - /* api cfirstbacks */ + /* api callbacks */ ot->exec = de_select_first_exec; ot->poll = ED_operator_editcurve; @@ -535,7 +535,7 @@ void CURVE_OT_de_select_last(wmOperatorType *ot) ot->idname = "CURVE_OT_de_select_last"; ot->description = "(De)select last of visible part of each NURBS"; - /* api clastbacks */ + /* api callbacks */ ot->exec = de_select_last_exec; ot->poll = ED_operator_editcurve; diff --git a/source/blender/editors/curve/editfont_undo.c b/source/blender/editors/curve/editfont_undo.c index 07f062e7a53..88f3ed0582c 100644 --- a/source/blender/editors/curve/editfont_undo.c +++ b/source/blender/editors/curve/editfont_undo.c @@ -279,7 +279,7 @@ static void *undofont_from_editfont(UndoFont *uf, Curve *cu) ((LinkData *)uf_arraystore.local_links.last)->data : NULL; - /* add oursrlves */ + /* Add ourselves. */ BLI_addtail(&uf_arraystore.local_links, BLI_genericNodeN(uf)); uf_arraystore_compact_with_info(uf, uf_ref); diff --git a/source/blender/editors/gpencil/gpencil_data.c b/source/blender/editors/gpencil/gpencil_data.c index d33545f5b22..4c9bde77103 100644 --- a/source/blender/editors/gpencil/gpencil_data.c +++ b/source/blender/editors/gpencil/gpencil_data.c @@ -1589,7 +1589,7 @@ static int gpencil_stroke_arrange_exec(bContext *C, wmOperator *op) continue; } } - /* some stroke is already at botom */ + /* Some stroke is already at bottom. */ if (ELEM(direction, GP_STROKE_MOVE_BOTTOM, GP_STROKE_MOVE_DOWN)) { if (gps == gpf->strokes.first) { gpf_lock = true; diff --git a/source/blender/editors/gpencil/gpencil_edit.c b/source/blender/editors/gpencil/gpencil_edit.c index aeff2acb04d..bf1aff5a34a 100644 --- a/source/blender/editors/gpencil/gpencil_edit.c +++ b/source/blender/editors/gpencil/gpencil_edit.c @@ -1111,7 +1111,7 @@ static void gpencil_add_move_points(bGPdata *gpd, bGPDframe *gpf, bGPDstroke *gp BKE_gpencil_stroke_geometry_update(gpd, gps); BKE_gpencil_stroke_geometry_update(gpd, gps_new); - /* deselect orinal point */ + /* Deselect original point. */ pt->flag &= ~GP_SPOINT_SELECT; } } @@ -1241,7 +1241,7 @@ static void gpencil_curve_extrude_points(bGPdata *gpd, } } - /* Edgcase for single curve point. */ + /* Edge-case for single curve point. */ if (gpc->tot_curve_points == 1) { last_select = false; } @@ -1331,7 +1331,7 @@ static int gpencil_extrude_exec(bContext *C, wmOperator *op) changed = true; } - /* if not multiedit, exit loop*/ + /* If not multi-edit, exit loop. */ if (!is_multiedit) { break; } @@ -1379,8 +1379,11 @@ void GPENCIL_OT_extrude(wmOperatorType *ot) * from several different layers into a single layer. * \{ */ -/* list of bGPDstroke instances */ -/* NOTE: is exposed within the editors/gpencil module so that other tools can use it too */ +/** + * list of #bGPDstroke instances + * + * \note is exposed within the editors/gpencil module so that other tools can use it too. + */ ListBase gpencil_strokes_copypastebuf = {NULL, NULL}; /* Hash for hanging on to all the colors used by strokes in the buffer diff --git a/source/blender/editors/gpencil/gpencil_intern.h b/source/blender/editors/gpencil/gpencil_intern.h index f3e6129b8ae..454f8d21590 100644 --- a/source/blender/editors/gpencil/gpencil_intern.h +++ b/source/blender/editors/gpencil/gpencil_intern.h @@ -611,7 +611,7 @@ typedef struct bActListElem { struct bActionGroup *grp; /* action group that owns the channel */ - void *owner; /* will either be an action channel or fake ipo-channel (for keys) */ + void *owner; /* will either be an action channel or fake IPO-channel (for keys) */ short ownertype; /* type of owner */ } bActListElem; @@ -624,7 +624,7 @@ typedef enum ACTFILTER_FLAGS { ACTFILTER_SEL = (1 << 1), /* should channels be selected */ ACTFILTER_FOREDIT = (1 << 2), /* does editable status matter */ ACTFILTER_CHANNELS = (1 << 3), /* do we only care that it is a channel */ - ACTFILTER_IPOKEYS = (1 << 4), /* only channels referencing ipo's */ + ACTFILTER_IPOKEYS = (1 << 4), /* only channels referencing IPO's */ ACTFILTER_ONLYICU = (1 << 5), /* only reference ipo-curves */ ACTFILTER_FORDRAWING = (1 << 6), /* make list for interface drawing */ ACTFILTER_ACTGROUPED = (1 << 7), /* belongs to the active group */ diff --git a/source/blender/editors/gpencil/gpencil_mesh.c b/source/blender/editors/gpencil/gpencil_mesh.c index ffe676f0520..7e6b42f284b 100644 --- a/source/blender/editors/gpencil/gpencil_mesh.c +++ b/source/blender/editors/gpencil/gpencil_mesh.c @@ -318,7 +318,7 @@ static int gpencil_bake_mesh_animation_exec(bContext *C, wmOperator *op) use_seams, use_faces); - /* Reproject all untaged created strokes. */ + /* Reproject all un-tagged created strokes. */ if (project_type != GP_REPROJECT_KEEP) { LISTBASE_FOREACH (bGPDlayer *, gpl, &gpd->layers) { bGPDframe *gpf = gpl->actframe; diff --git a/source/blender/editors/gpencil/gpencil_paint.c b/source/blender/editors/gpencil/gpencil_paint.c index 33910c057b3..974f51ff90b 100644 --- a/source/blender/editors/gpencil/gpencil_paint.c +++ b/source/blender/editors/gpencil/gpencil_paint.c @@ -1877,7 +1877,7 @@ static void gpencil_init_drawing_brush(bContext *C, tGPsdata *p) BKE_brush_gpencil_paint_presets(bmain, ts, true); changed = true; } - /* Be sure curves are initializated. */ + /* Be sure curves are initialized. */ BKE_curvemapping_init(paint->brush->gpencil_settings->curve_sensitivity); BKE_curvemapping_init(paint->brush->gpencil_settings->curve_strength); BKE_curvemapping_init(paint->brush->gpencil_settings->curve_jitter); @@ -1888,7 +1888,7 @@ static void gpencil_init_drawing_brush(bContext *C, tGPsdata *p) BKE_curvemapping_init(paint->brush->gpencil_settings->curve_rand_saturation); BKE_curvemapping_init(paint->brush->gpencil_settings->curve_rand_value); - /* assign to temp tGPsdata */ + /* Assign to temp #tGPsdata */ p->brush = paint->brush; if (paint->brush->gpencil_tool != GPAINT_TOOL_ERASE) { p->eraser = gpencil_get_default_eraser(p->bmain, ts); diff --git a/source/blender/editors/gpencil/gpencil_select.c b/source/blender/editors/gpencil/gpencil_select.c index a85b84f462f..d1d8abd6775 100644 --- a/source/blender/editors/gpencil/gpencil_select.c +++ b/source/blender/editors/gpencil/gpencil_select.c @@ -120,7 +120,8 @@ static bool gpencil_select_poll(bContext *C) } } - /* we just need some visible strokes, and to be in editmode or other modes only to catch event */ + /* We just need some visible strokes, + * and to be in edit-mode or other modes only to catch event. */ if (GPENCIL_ANY_MODE(gpd)) { /* TODO: include a check for visible strokes? */ if (gpd->layers.first) { @@ -220,7 +221,8 @@ static bool gpencil_select_all_poll(bContext *C) { bGPdata *gpd = ED_gpencil_data_get_active(C); - /* we just need some visible strokes, and to be in editmode or other modes only to catch event */ + /* We just need some visible strokes, + * and to be in edit-mode or other modes only to catch event. */ if (GPENCIL_ANY_MODE(gpd)) { if (gpd->layers.first) { return true; @@ -241,7 +243,7 @@ static int gpencil_select_all_exec(bContext *C, wmOperator *op) return OPERATOR_CANCELLED; } - /* if not edit/sculpt mode, the event is catched but not processed */ + /* If not edit/sculpt mode, the event has been caught but not processed. */ if (GPENCIL_NONE_EDIT_MODE(gpd)) { return OPERATOR_CANCELLED; } @@ -305,7 +307,7 @@ static int gpencil_select_linked_exec(bContext *C, wmOperator *op) return OPERATOR_CANCELLED; } - /* if not edit/sculpt mode, the event is catched but not processed */ + /* If not edit/sculpt mode, the event has been caught but not processed. */ if (GPENCIL_NONE_EDIT_MODE(gpd)) { return OPERATOR_CANCELLED; } @@ -382,7 +384,7 @@ static int gpencil_select_alternate_exec(bContext *C, wmOperator *op) return OPERATOR_CANCELLED; } - /* if not edit/sculpt mode, the event is catched but not processed */ + /* If not edit/sculpt mode, the event has been caught but not processed. */ if (GPENCIL_NONE_EDIT_MODE(gpd)) { return OPERATOR_CANCELLED; } @@ -659,7 +661,7 @@ static int gpencil_select_grouped_exec(bContext *C, wmOperator *op) { eGP_SelectGrouped mode = RNA_enum_get(op->ptr, "type"); bGPdata *gpd = ED_gpencil_data_get_active(C); - /* if not edit/sculpt mode, the event is catched but not processed */ + /* If not edit/sculpt mode, the event has been caught but not processed. */ if (GPENCIL_NONE_EDIT_MODE(gpd)) { return OPERATOR_CANCELLED; } @@ -729,7 +731,7 @@ static int gpencil_select_first_exec(bContext *C, wmOperator *op) bGPdata *gpd = ED_gpencil_data_get_active(C); const bool is_curve_edit = (bool)GPENCIL_CURVE_EDIT_SESSIONS_ON(gpd); - /* if not edit/sculpt mode, the event is catched but not processed */ + /* If not edit/sculpt mode, the event has been caught but not processed. */ if (GPENCIL_NONE_EDIT_MODE(gpd)) { return OPERATOR_CANCELLED; } @@ -836,7 +838,7 @@ static int gpencil_select_last_exec(bContext *C, wmOperator *op) bGPdata *gpd = ED_gpencil_data_get_active(C); const bool is_curve_edit = (bool)GPENCIL_CURVE_EDIT_SESSIONS_ON(gpd); - /* if not edit/sculpt mode, the event is catched but not processed */ + /* If not edit/sculpt mode, the event has been caught but not processed. */ if (GPENCIL_NONE_EDIT_MODE(gpd)) { return OPERATOR_CANCELLED; } @@ -943,7 +945,7 @@ static int gpencil_select_more_exec(bContext *C, wmOperator *UNUSED(op)) { bGPdata *gpd = ED_gpencil_data_get_active(C); const bool is_curve_edit = (bool)GPENCIL_CURVE_EDIT_SESSIONS_ON(gpd); - /* if not edit/sculpt mode, the event is catched but not processed */ + /* If not edit/sculpt mode, the event has been caught but not processed. */ if (GPENCIL_NONE_EDIT_MODE(gpd)) { return OPERATOR_CANCELLED; } @@ -1083,7 +1085,7 @@ static int gpencil_select_less_exec(bContext *C, wmOperator *UNUSED(op)) bGPdata *gpd = ED_gpencil_data_get_active(C); const bool is_curve_edit = (bool)GPENCIL_CURVE_EDIT_SESSIONS_ON(gpd); - /* if not edit/sculpt mode, the event is catched but not processed */ + /* If not edit/sculpt mode, the event has been caught but not processed. */ if (GPENCIL_NONE_EDIT_MODE(gpd)) { return OPERATOR_CANCELLED; } @@ -1434,7 +1436,7 @@ static int gpencil_circle_select_exec(bContext *C, wmOperator *op) const float scale = ts->gp_sculpt.isect_threshold; - /* if not edit/sculpt mode, the event is catched but not processed */ + /* If not edit/sculpt mode, the event has been caught but not processed. */ if (GPENCIL_NONE_EDIT_MODE(gpd)) { return OPERATOR_CANCELLED; } diff --git a/source/blender/editors/gpencil/gpencil_undo.c b/source/blender/editors/gpencil/gpencil_undo.c index 4e172104ce7..583878883fa 100644 --- a/source/blender/editors/gpencil/gpencil_undo.c +++ b/source/blender/editors/gpencil/gpencil_undo.c @@ -132,7 +132,7 @@ void gpencil_undo_push(bGPdata *gpd) // printf("\t\tGP - undo push\n"); if (cur_node) { - /* remove all un-done nodes from stack */ + /* Remove all undone nodes from stack. */ undo_node = cur_node->next; while (undo_node) { diff --git a/source/blender/editors/include/ED_view3d.h b/source/blender/editors/include/ED_view3d.h index a4856845a65..a63b133cc22 100644 --- a/source/blender/editors/include/ED_view3d.h +++ b/source/blender/editors/include/ED_view3d.h @@ -465,7 +465,7 @@ float ED_view3d_radius_to_dist(const struct View3D *v3d, void imm_drawcircball(const float cent[3], float rad, const float tmat[4][4], unsigned int pos); -/* backbuffer select and draw support */ +/* Back-buffer select and draw support. */ void ED_view3d_backbuf_depth_validate(struct ViewContext *vc); int ED_view3d_backbuf_sample_size_clamp(struct ARegion *region, const float dist); @@ -479,7 +479,7 @@ bool ED_view3d_autodist(struct Depsgraph *depsgraph, const bool alphaoverride, const float fallback_depth_pt[3]); -/* only draw so ED_view3d_autodist_simple can be called many times after */ +/* Only draw so #ED_view3d_autodist_simple can be called many times after. */ void ED_view3d_autodist_init(struct Depsgraph *depsgraph, struct ARegion *region, struct View3D *v3d, diff --git a/source/blender/editors/interface/interface_region_menu_popup.c b/source/blender/editors/interface/interface_region_menu_popup.c index 1789af2d2ce..f234f0fbbf5 100644 --- a/source/blender/editors/interface/interface_region_menu_popup.c +++ b/source/blender/editors/interface/interface_region_menu_popup.c @@ -188,7 +188,7 @@ static uiBlock *ui_block_func_POPUP(bContext *C, uiPopupBlockHandle *handle, voi minwidth = uiLayoutGetUnitsX(pup->layout) * UI_UNIT_X; } else if (pup->but) { - /* minimum width to enforece */ + /* Minimum width to enforce. */ if (pup->but->drawstr[0]) { minwidth = BLI_rctf_size_x(&pup->but->rect); } diff --git a/source/blender/editors/mesh/editmesh_undo.c b/source/blender/editors/mesh/editmesh_undo.c index dd51d63961c..cea006f0faa 100644 --- a/source/blender/editors/mesh/editmesh_undo.c +++ b/source/blender/editors/mesh/editmesh_undo.c @@ -565,7 +565,7 @@ static void *undomesh_from_editmesh(UndoMesh *um, BMEditMesh *em, Key *key) ((LinkData *)um_arraystore.local_links.last)->data : NULL; - /* add oursrlves */ + /* Add ourselves. */ BLI_addtail(&um_arraystore.local_links, BLI_genericNodeN(um)); # ifdef USE_ARRAY_STORE_THREAD diff --git a/source/blender/editors/object/object_add.c b/source/blender/editors/object/object_add.c index 5c69e21e14e..82c0316093a 100644 --- a/source/blender/editors/object/object_add.c +++ b/source/blender/editors/object/object_add.c @@ -1854,7 +1854,7 @@ void ED_object_base_free_and_unlink(Main *bmain, Scene *scene, Object *ob) ID_EXTRA_USERS(ob) == 0) { /* We cannot delete indirectly used object... */ printf( - "WARNING, undeletable object '%s', should have been catched before reaching this " + "WARNING, undeletable object '%s', should have been caught before reaching this " "function!", ob->id.name + 2); return; diff --git a/source/blender/editors/object/object_ops.c b/source/blender/editors/object/object_ops.c index 2124d242ee2..57676cf5c76 100644 --- a/source/blender/editors/object/object_ops.c +++ b/source/blender/editors/object/object_ops.c @@ -154,7 +154,7 @@ void ED_operatortypes_object(void) WM_operatortype_append(OBJECT_OT_gpencil_modifier_copy); WM_operatortype_append(OBJECT_OT_gpencil_modifier_copy_to_selected); - /* shader fx */ + /* Shader FX. */ WM_operatortype_append(OBJECT_OT_shaderfx_add); WM_operatortype_append(OBJECT_OT_shaderfx_remove); WM_operatortype_append(OBJECT_OT_shaderfx_move_up); diff --git a/source/blender/editors/object/object_remesh.c b/source/blender/editors/object/object_remesh.c index f55ce88b426..9ef2cce875f 100644 --- a/source/blender/editors/object/object_remesh.c +++ b/source/blender/editors/object/object_remesh.c @@ -467,7 +467,7 @@ static int voxel_size_edit_invoke(bContext *C, wmOperator *op, const wmEvent *ev cd->voxel_size = mesh->remesh_voxel_size; op->customdata = cd; - /* Select the front facing face of the mesh boundig box. */ + /* Select the front facing face of the mesh bounding box. */ BoundBox *bb = BKE_mesh_boundbox_get(cd->active_object); /* Indices of the Bounding Box faces. */ diff --git a/source/blender/editors/screen/screen_edit.c b/source/blender/editors/screen/screen_edit.c index c25b572d200..1735b02ffe3 100644 --- a/source/blender/editors/screen/screen_edit.c +++ b/source/blender/editors/screen/screen_edit.c @@ -1556,7 +1556,7 @@ void ED_screen_animation_timer(bContext *C, int redraws, int sync, int enable) /* Seek audio to ensure playback in preview range with AV sync. */ DEG_id_tag_update(&scene->id, ID_RECALC_AUDIO_SEEK); - /* notifier catched by top header, for button */ + /* Notifier caught by top header, for button. */ WM_event_add_notifier(C, NC_SCREEN | ND_ANIMPLAY, NULL); } diff --git a/source/blender/editors/sculpt_paint/paint_vertex_weight_utils.c b/source/blender/editors/sculpt_paint/paint_vertex_weight_utils.c index a65895a3405..a8ba87ac483 100644 --- a/source/blender/editors/sculpt_paint/paint_vertex_weight_utils.c +++ b/source/blender/editors/sculpt_paint/paint_vertex_weight_utils.c @@ -276,7 +276,7 @@ BLI_INLINE float wval_exclusion(float weight, float paintval, float fac) /** * \param weight: Typically the current weight: #MDeformWeight.weight * - * \return The final weight, not that this is _not_ clamped from [0-1]. + * \return The final weight, note that this is _not_ clamped from [0-1]. * Clamping must be done on the final #MDeformWeight.weight * * \note vertex-paint has an equivalent function: #ED_vpaint_blend_tool diff --git a/source/blender/editors/space_outliner/outliner_select.c b/source/blender/editors/space_outliner/outliner_select.c index 4a58736966c..c09334b0e86 100644 --- a/source/blender/editors/space_outliner/outliner_select.c +++ b/source/blender/editors/space_outliner/outliner_select.c @@ -718,7 +718,7 @@ static eOLDrawState tree_element_active_bone(bContext *C, return OL_DRAWSEL_NONE; } -/* ebones only draw in editmode armature */ +/** Edit-bones only draw in edit-mode armature. */ static void tree_element_active_ebone__sel(bContext *C, bArmature *arm, EditBone *ebone, short sel) { if (sel) { diff --git a/source/blender/editors/space_view3d/view3d_view.c b/source/blender/editors/space_view3d/view3d_view.c index 5c0ca1582a6..21cb8560e9b 100644 --- a/source/blender/editors/space_view3d/view3d_view.c +++ b/source/blender/editors/space_view3d/view3d_view.c @@ -277,8 +277,7 @@ void ED_view3d_smooth_view_ex( if (rv3d->smooth_timer) { WM_event_remove_timer(wm, win, rv3d->smooth_timer); } - /* TIMER1 is hardcoded in keymap */ - /* max 30 frs/sec */ + /* #TIMER1 is hard-coded in key-map. */ rv3d->smooth_timer = WM_event_add_timer(wm, win, TIMER1, 1.0 / 100.0); ok = true; @@ -1210,8 +1209,8 @@ static uint free_localview_bit(Main *bmain) ushort local_view_bits = 0; - /* sometimes we lose a localview: when an area is closed */ - /* check all areas: which localviews are in use? */ + /* Sometimes we lose a local-view: when an area is closed. + * Check all areas: which local-views are in use? */ for (screen = bmain->screens.first; screen; screen = screen->id.next) { for (area = screen->areabase.first; area; area = area->next) { SpaceLink *sl = area->spacedata.first; diff --git a/source/blender/freestyle/intern/geometry/FitCurve.cpp b/source/blender/freestyle/intern/geometry/FitCurve.cpp index 5768f88e95f..7c0b3bf0224 100644 --- a/source/blender/freestyle/intern/geometry/FitCurve.cpp +++ b/source/blender/freestyle/intern/geometry/FitCurve.cpp @@ -134,7 +134,7 @@ static BezierCurve GenerateBezier( double alpha_l; /* Alpha values, left and right */ double alpha_r; Vector2 tmp; /* Utility variable */ - BezierCurve bezCurve; /* RETURN bezier curve ctl pts */ + BezierCurve bezCurve; /* RETURN bezier curve control points. */ bezCurve = (Vector2 *)malloc(4 * sizeof(Vector2)); nPts = last - first + 1; diff --git a/source/blender/freestyle/intern/python/StrokeShader/BPy_PolygonalizationShader.cpp b/source/blender/freestyle/intern/python/StrokeShader/BPy_PolygonalizationShader.cpp index a576bc35006..68c14e1151c 100644 --- a/source/blender/freestyle/intern/python/StrokeShader/BPy_PolygonalizationShader.cpp +++ b/source/blender/freestyle/intern/python/StrokeShader/BPy_PolygonalizationShader.cpp @@ -43,7 +43,7 @@ static char PolygonalizationShader___doc__[] = "\n" " :arg error: The error we want our polygonal approximation to have\n" " with respect to the original geometry. The smaller, the closer\n" - " the new stroke is to the orinal one. This error corresponds to\n" + " the new stroke is to the original one. This error corresponds to\n" " the maximum distance between the new stroke and the old one.\n" " :type error: float\n" "\n" diff --git a/source/blender/gpencil_modifiers/intern/MOD_gpencilnoise.c b/source/blender/gpencil_modifiers/intern/MOD_gpencilnoise.c index f80ad60eb07..686bd8c38e5 100644 --- a/source/blender/gpencil_modifiers/intern/MOD_gpencilnoise.c +++ b/source/blender/gpencil_modifiers/intern/MOD_gpencilnoise.c @@ -124,7 +124,9 @@ BLI_INLINE float table_sample(float *table, float x) return interpf(table[(int)ceilf(x)], table[(int)floor(x)], fractf(x)); } -/* aply noise effect based on stroke direction */ +/** + * Apply noise effect based on stroke direction. + */ static void deformStroke(GpencilModifierData *md, Depsgraph *depsgraph, Object *ob, diff --git a/source/blender/gpencil_modifiers/intern/MOD_gpencilsmooth.c b/source/blender/gpencil_modifiers/intern/MOD_gpencilsmooth.c index df2c838140e..54ff8d21633 100644 --- a/source/blender/gpencil_modifiers/intern/MOD_gpencilsmooth.c +++ b/source/blender/gpencil_modifiers/intern/MOD_gpencilsmooth.c @@ -83,7 +83,9 @@ static void copyData(const GpencilModifierData *md, GpencilModifierData *target) tgmd->curve_intensity = BKE_curvemapping_copy(gmd->curve_intensity); } -/* aply smooth effect based on stroke direction */ +/** + * Apply smooth effect based on stroke direction. + */ static void deformStroke(GpencilModifierData *md, Depsgraph *UNUSED(depsgraph), Object *ob, diff --git a/source/blender/makesdna/DNA_anim_types.h b/source/blender/makesdna/DNA_anim_types.h index c66618c0acd..4e37a6652a5 100644 --- a/source/blender/makesdna/DNA_anim_types.h +++ b/source/blender/makesdna/DNA_anim_types.h @@ -82,7 +82,7 @@ typedef enum eFModifier_Types { FMODIFIER_TYPE_ENVELOPE = 3, FMODIFIER_TYPE_CYCLES = 4, FMODIFIER_TYPE_NOISE = 5, - /** Unimplemented - for applying: fft, high/low pass filters, etc. */ + /** Unimplemented - for applying: FFT, high/low pass filters, etc. */ FMODIFIER_TYPE_FILTER = 6, FMODIFIER_TYPE_PYTHON = 7, FMODIFIER_TYPE_LIMITS = 8, diff --git a/source/blender/makesdna/DNA_boid_types.h b/source/blender/makesdna/DNA_boid_types.h index 7e010f27ce6..882d4eb1b3b 100644 --- a/source/blender/makesdna/DNA_boid_types.h +++ b/source/blender/makesdna/DNA_boid_types.h @@ -35,7 +35,7 @@ typedef enum eBoidRuleType { eBoidRuleType_Goal = 1, /** get away from assigned object or loudest assigned signal source */ eBoidRuleType_Avoid = 2, - /** manoeuver to avoid collisions with other boids and deflector object in near future */ + /** Maneuver to avoid collisions with other boids and deflector object in near future. */ eBoidRuleType_AvoidCollision = 3, /** keep from going through other boids */ eBoidRuleType_Separate = 4, diff --git a/source/blender/makesdna/DNA_cloth_types.h b/source/blender/makesdna/DNA_cloth_types.h index 386590ad26c..aae29e5fddc 100644 --- a/source/blender/makesdna/DNA_cloth_types.h +++ b/source/blender/makesdna/DNA_cloth_types.h @@ -104,16 +104,19 @@ typedef struct ClothSimSettings { float shrink_max; /* Air pressure */ - /* The uniform pressure that is constanty applied to the mesh. Can be negative */ + /** The uniform pressure that is constantly applied to the mesh. Can be negative. */ float uniform_pressure_force; - /* User set volume. This is the volume the mesh wants to expand to (the equilibrium volume). */ + /** User set volume. This is the volume the mesh wants to expand to (the equilibrium volume). */ float target_volume; - /* The scaling factor to apply to the actual pressure. - * pressure=( (current_volume/target_volume) - 1 + uniform_pressure_force) * - * pressure_factor */ + /** + * The scaling factor to apply to the actual pressure. + * `pressure = ((current_volume/target_volume) - 1 + uniform_pressure_force) * pressure_factor` + */ float pressure_factor; - /* Density of the fluid inside or outside the object for use in the hydrostatic pressure - * gradient. */ + /** + * Density of the fluid inside or outside the object + * for use in the hydro-static pressure gradient. + */ float fluid_density; short vgroup_pressure; char _pad7[6]; @@ -168,7 +171,7 @@ typedef struct ClothSimSettings { /** The maximum length an internal spring can have during creation. */ float internal_spring_max_length; - /** How much the interal spring can diverge from the vertex normal during creation. */ + /** How much the internal spring can diverge from the vertex normal during creation. */ float internal_spring_max_diversion; /** Vertex group for scaling structural stiffness. */ short vgroup_intern; diff --git a/source/blender/makesdna/DNA_gpencil_modifier_defaults.h b/source/blender/makesdna/DNA_gpencil_modifier_defaults.h index 399bf6f0a6d..11d4ee1b2cd 100644 --- a/source/blender/makesdna/DNA_gpencil_modifier_defaults.h +++ b/source/blender/makesdna/DNA_gpencil_modifier_defaults.h @@ -20,7 +20,7 @@ #pragma once -/* Note that some struct members for colormapping and colorbands are not initialized here. */ +/* Note that some struct members for color-mapping and color-bands are not initialized here. */ /* Struct members on own line. */ /* clang-format off */ diff --git a/source/blender/makesdna/DNA_gpencil_types.h b/source/blender/makesdna/DNA_gpencil_types.h index e02757c1249..835761bf6e9 100644 --- a/source/blender/makesdna/DNA_gpencil_types.h +++ b/source/blender/makesdna/DNA_gpencil_types.h @@ -102,7 +102,7 @@ typedef struct bGPDspoint { bGPDspoint_Runtime runtime; } bGPDspoint; -/* bGPDspoint->flag */ +/** #bGPDspoint.flag */ typedef enum eGPDspoint_Flag { /* stroke point is selected (for editing) */ GP_SPOINT_SELECT = (1 << 0), @@ -144,7 +144,7 @@ typedef struct bGPDpalettecolor { char _pad[6]; } bGPDpalettecolor; -/* bGPDpalettecolor->flag */ +/** #bGPDpalettecolor.flag */ typedef enum eGPDpalettecolor_Flag { /* color is active */ /* PC_COLOR_ACTIVE = (1 << 0), */ /* UNUSED */ @@ -171,7 +171,7 @@ typedef struct bGPDpalette { char _pad[6]; } bGPDpalette; -/* bGPDpalette->flag */ +/** #bGPDpalette.flag */ typedef enum eGPDpalette_Flag { /* palette is active */ PL_PALETTE_ACTIVE = (1 << 0), @@ -319,7 +319,7 @@ typedef struct bGPDstroke { bGPDstroke_Runtime runtime; } bGPDstroke; -/* bGPDstroke->flag */ +/** #bGPDstroke.flag */ typedef enum eGPDstroke_Flag { /* stroke is in 3d-space */ GP_STROKE_3DSPACE = (1 << 0), @@ -347,19 +347,19 @@ typedef enum eGPDstroke_Flag { GP_STROKE_ERASER = (1 << 15), } eGPDstroke_Flag; -/* bGPDstroke->caps */ +/** #bGPDstroke.caps */ typedef enum eGPDstroke_Caps { /* type of extreme */ GP_STROKE_CAP_ROUND = 0, GP_STROKE_CAP_FLAT = 1, - /* Keeo last. */ + /* Keep last. */ GP_STROKE_CAP_MAX, } GPDstroke_Caps; /* Arrows ----------------------- */ -/* bGPDataRuntime.arrowstyle */ +/** #bGPDataRuntime.arrowstyle */ typedef enum eGPDstroke_Arrowstyle { GP_STROKE_ARROWSTYLE_NONE = 0, GP_STROKE_ARROWSTYLE_SEGMENT = 2, @@ -553,13 +553,13 @@ typedef enum eGPDlayer_Flag { GP_LAYER_IS_RULER = (1 << 14), } eGPDlayer_Flag; -/* bGPDlayer->onion_flag */ +/** #bGPDlayer.onion_flag */ typedef enum eGPDlayer_OnionFlag { /* do onion skinning */ GP_LAYER_ONIONSKIN = (1 << 0), } eGPDlayer_OnionFlag; -/* layer blend_mode */ +/** #bGPDlayer.blend_mode */ typedef enum eGPLayerBlendModes { eGplBlendMode_Regular = 0, eGplBlendMode_HardLight = 1, @@ -706,8 +706,10 @@ typedef struct bGPdata { bGPdata_Runtime runtime; } bGPdata; -/* bGPdata->flag */ -/* NOTE: A few flags have been deprecated since early 2.5, +/** + * #bGPdata.flag + * + * NOTE: A few flags have been deprecated since early 2.5, * since they have been made redundant by interaction * changes made during the porting process. */ diff --git a/source/blender/makesdna/DNA_lightprobe_types.h b/source/blender/makesdna/DNA_lightprobe_types.h index 4fdce6d5f45..48e3c44e2c9 100644 --- a/source/blender/makesdna/DNA_lightprobe_types.h +++ b/source/blender/makesdna/DNA_lightprobe_types.h @@ -141,7 +141,7 @@ typedef struct LightGridCache { float visibility_bias, visibility_bleed, visibility_range, _pad5; } LightGridCache; -/* These are used as ubo data. They need to be aligned to size of vec4. */ +/* These are used as UBO data. They need to be aligned to size of vec4. */ BLI_STATIC_ASSERT_ALIGN(LightProbeCache, 16) BLI_STATIC_ASSERT_ALIGN(LightGridCache, 16) diff --git a/source/blender/makesdna/DNA_mask_types.h b/source/blender/makesdna/DNA_mask_types.h index 79ac655300e..8868ac1ea12 100644 --- a/source/blender/makesdna/DNA_mask_types.h +++ b/source/blender/makesdna/DNA_mask_types.h @@ -131,7 +131,7 @@ typedef struct MaskLayerShape { /** U coordinate along spline segment and weight of this point. */ float *data; - /** To ensure no buffer overruns's: alloc size is (tot_vert * MASK_OBJECT_SHAPE_ELEM_SIZE). */ + /** To ensure no buffer overrun's: alloc size is `(tot_vert * MASK_OBJECT_SHAPE_ELEM_SIZE)`. */ int tot_vert; /** Different flags of this point. */ int frame; diff --git a/source/blender/makesdna/DNA_modifier_types.h b/source/blender/makesdna/DNA_modifier_types.h index 6e1c00bfca8..dbcb6ce45ea 100644 --- a/source/blender/makesdna/DNA_modifier_types.h +++ b/source/blender/makesdna/DNA_modifier_types.h @@ -1721,7 +1721,7 @@ typedef enum eRemeshModifierMode { typedef struct RemeshModifierData { ModifierData modifier; - /* floodfill option, controls how small components can be before they are removed */ + /** Flood-fill option, controls how small components can be before they are removed. */ float threshold; /* ratio between size of model and grid */ diff --git a/source/blender/makesdna/DNA_object_force_types.h b/source/blender/makesdna/DNA_object_force_types.h index 7812ff6a4f1..37013f5b4d6 100644 --- a/source/blender/makesdna/DNA_object_force_types.h +++ b/source/blender/makesdna/DNA_object_force_types.h @@ -224,7 +224,7 @@ typedef struct SoftBody { * rather find them by name tag to find it -> jow20090613. * MAX_VGROUP_NAME */ char namedVG_Mass[64]; - /** Softbody amount of gravitaion to apply. */ + /** Softbody amount of gravitation to apply. */ float grav; /** Friction to env. */ float mediafrict; diff --git a/source/blender/makesdna/DNA_rigidbody_types.h b/source/blender/makesdna/DNA_rigidbody_types.h index 9a3b9e7d365..740dc35517a 100644 --- a/source/blender/makesdna/DNA_rigidbody_types.h +++ b/source/blender/makesdna/DNA_rigidbody_types.h @@ -312,7 +312,7 @@ typedef enum eRigidBodyCon_Type { RBC_TYPE_HINGE = 1, /** simulates wheel suspension */ /* RBC_TYPE_HINGE2 = 2, */ /* UNUSED */ - /** restricts movent to a specified axis */ + /** Restricts moment to a specified axis. */ RBC_TYPE_SLIDER = 3, /** lets object rotate within a specified cone */ /* RBC_TYPE_CONE_TWIST = 4, */ /* UNUSED */ @@ -329,7 +329,7 @@ typedef enum eRigidBodyCon_Type { /** Simplified spring constraint with only once axis that's * automatically placed between the connected bodies */ /* RBC_TYPE_SPRING = 10, */ /* UNUSED */ - /** dirves bodies by applying linear and angular forces */ + /** Drives bodies by applying linear and angular forces. */ RBC_TYPE_MOTOR = 11, } eRigidBodyCon_Type; diff --git a/source/blender/makesdna/DNA_scene_types.h b/source/blender/makesdna/DNA_scene_types.h index 33d31df4210..2362686cfce 100644 --- a/source/blender/makesdna/DNA_scene_types.h +++ b/source/blender/makesdna/DNA_scene_types.h @@ -231,7 +231,7 @@ typedef struct SceneRenderLayer { struct FreestyleConfig freestyleConfig DNA_DEPRECATED; } SceneRenderLayer; -/* SceneRenderLayer.layflag */ +/** #SceneRenderLayer.layflag */ #define SCE_LAY_SOLID (1 << 0) #define SCE_LAY_ZTRA (1 << 1) #define SCE_LAY_HALO (1 << 2) @@ -249,7 +249,7 @@ typedef struct SceneRenderLayer { #define SCE_LAY_ZMASK (1 << 18) #define SCE_LAY_NEG_ZMASK (1 << 19) -/* SceneRenderLayer.passflag */ +/** #SceneRenderLayer.passflag */ typedef enum eScenePassType { SCE_PASS_COMBINED = (1 << 0), SCE_PASS_Z = (1 << 1), @@ -334,16 +334,16 @@ typedef struct SceneRenderView { } SceneRenderView; -/* SceneRenderView.viewflag */ +/** #SceneRenderView.viewflag */ #define SCE_VIEW_DISABLE (1 << 0) -/* RenderData.views_format */ +/** #RenderData.views_format */ enum { SCE_VIEWS_FORMAT_STEREO_3D = 0, SCE_VIEWS_FORMAT_MULTIVIEW = 1, }; -/* ImageFormatData.views_format (also used for Sequence.views_format) */ +/** #ImageFormatData.views_format (also used for #Sequence.views_format) */ enum { R_IMF_VIEWS_INDIVIDUAL = 0, R_IMF_VIEWS_STEREO_3D = 1, @@ -361,7 +361,7 @@ typedef struct Stereo3dFormat { char _pad[3]; } Stereo3dFormat; -/* Stereo3dFormat.display_mode */ +/** #Stereo3dFormat.display_mode */ typedef enum eStereoDisplayMode { S3D_DISPLAY_ANAGLYPH = 0, S3D_DISPLAY_INTERLACE = 1, @@ -370,21 +370,21 @@ typedef enum eStereoDisplayMode { S3D_DISPLAY_TOPBOTTOM = 4, } eStereoDisplayMode; -/* Stereo3dFormat.flag */ +/** #Stereo3dFormat.flag */ typedef enum eStereo3dFlag { S3D_INTERLACE_SWAP = (1 << 0), S3D_SIDEBYSIDE_CROSSEYED = (1 << 1), S3D_SQUEEZED_FRAME = (1 << 2), } eStereo3dFlag; -/* Stereo3dFormat.anaglyph_type */ +/** #Stereo3dFormat.anaglyph_type */ typedef enum eStereo3dAnaglyphType { S3D_ANAGLYPH_REDCYAN = 0, S3D_ANAGLYPH_GREENMAGENTA = 1, S3D_ANAGLYPH_YELLOWBLUE = 2, } eStereo3dAnaglyphType; -/* Stereo3dFormat.interlace_type */ +/** #Stereo3dFormat.interlace_type */ typedef enum eStereo3dInterlaceType { S3D_INTERLACE_ROW = 0, S3D_INTERLACE_COLUMN = 1, @@ -449,26 +449,26 @@ typedef struct ImageFormatData { ColorManagedDisplaySettings display_settings; } ImageFormatData; -/* ImageFormatData.imtype */ +/** #ImageFormatData.imtype */ #define R_IMF_IMTYPE_TARGA 0 #define R_IMF_IMTYPE_IRIS 1 -/* #define R_HAMX 2 */ /* hamx is nomore */ -/* #define R_FTYPE 3 */ /* ftype is nomore */ +/* #define R_HAMX 2 */ /* DEPRECATED */ +/* #define R_FTYPE 3 */ /* DEPRECATED */ #define R_IMF_IMTYPE_JPEG90 4 -/* #define R_MOVIE 5 */ /* movie is nomore */ +/* #define R_MOVIE 5 */ /* DEPRECATED */ #define R_IMF_IMTYPE_IRIZ 7 #define R_IMF_IMTYPE_RAWTGA 14 #define R_IMF_IMTYPE_AVIRAW 15 #define R_IMF_IMTYPE_AVIJPEG 16 #define R_IMF_IMTYPE_PNG 17 -/* #define R_IMF_IMTYPE_AVICODEC 18 */ /* avicodec is nomore */ -/* #define R_IMF_IMTYPE_QUICKTIME 19 */ /* quicktime is nomore */ +/* #define R_IMF_IMTYPE_AVICODEC 18 */ /* DEPRECATED */ +/* #define R_IMF_IMTYPE_QUICKTIME 19 */ /* DEPRECATED */ #define R_IMF_IMTYPE_BMP 20 #define R_IMF_IMTYPE_RADHDR 21 #define R_IMF_IMTYPE_TIFF 22 #define R_IMF_IMTYPE_OPENEXR 23 #define R_IMF_IMTYPE_FFMPEG 24 -/* #define R_IMF_IMTYPE_FRAMESERVER 25 */ /* frame server is nomore */ +/* #define R_IMF_IMTYPE_FRAMESERVER 25 */ /* DEPRECATED */ #define R_IMF_IMTYPE_CINEON 26 #define R_IMF_IMTYPE_DPX 27 #define R_IMF_IMTYPE_MULTILAYER 28 @@ -481,12 +481,12 @@ typedef struct ImageFormatData { #define R_IMF_IMTYPE_INVALID 255 -/* ImageFormatData.flag */ +/** #ImageFormatData.flag */ #define R_IMF_FLAG_ZBUF (1 << 0) /* was R_OPENEXR_ZBUF */ #define R_IMF_FLAG_PREVIEW_JPG (1 << 1) /* was R_PREVIEW_JPG */ -/* return values from BKE_imtype_valid_depths, note this is depts per channel */ -/* ImageFormatData.depth */ +/* Return values from #BKE_imtype_valid_depths, note this is depths per channel. */ +/** #ImageFormatData.depth */ typedef enum eImageFormatDepth { /* 1bits (unused) */ R_IMF_CHAN_DEPTH_1 = (1 << 0), @@ -504,12 +504,12 @@ typedef enum eImageFormatDepth { R_IMF_CHAN_DEPTH_32 = (1 << 6), } eImageFormatDepth; -/* ImageFormatData.planes */ +/** #ImageFormatData.planes */ #define R_IMF_PLANES_RGB 24 #define R_IMF_PLANES_RGBA 32 #define R_IMF_PLANES_BW 8 -/* ImageFormatData.exr_codec */ +/** #ImageFormatData.exr_codec */ #define R_IMF_EXR_CODEC_NONE 0 #define R_IMF_EXR_CODEC_PXR24 1 #define R_IMF_EXR_CODEC_ZIP 2 @@ -522,19 +522,19 @@ typedef enum eImageFormatDepth { #define R_IMF_EXR_CODEC_DWAB 9 #define R_IMF_EXR_CODEC_MAX 10 -/* ImageFormatData.jp2_flag */ +/** #ImageFormatData.jp2_flag */ #define R_IMF_JP2_FLAG_YCC (1 << 0) /* when disabled use RGB */ /* was R_JPEG2K_YCC */ #define R_IMF_JP2_FLAG_CINE_PRESET (1 << 1) /* was R_JPEG2K_CINE_PRESET */ #define R_IMF_JP2_FLAG_CINE_48 (1 << 2) /* was R_JPEG2K_CINE_48FPS */ -/* ImageFormatData.jp2_codec */ +/** #ImageFormatData.jp2_codec */ #define R_IMF_JP2_CODEC_JP2 0 #define R_IMF_JP2_CODEC_J2K 1 -/* ImageFormatData.cineon_flag */ +/** #ImageFormatData.cineon_flag */ #define R_IMF_CINEON_FLAG_LOG (1 << 0) /* was R_CINEON_LOG */ -/* ImageFormatData.tiff_codec */ +/** #ImageFormatData.tiff_codec */ enum { R_IMF_TIFF_CODEC_DEFLATE = 0, R_IMF_TIFF_CODEC_LZW = 1, @@ -565,7 +565,7 @@ typedef struct BakeData { struct Object *cage_object; } BakeData; -/* BakeData.normal_swizzle (char) */ +/** #BakeData.normal_swizzle (char) */ typedef enum eBakeNormalSwizzle { R_BAKE_POSX = 0, R_BAKE_POSY = 1, @@ -575,19 +575,19 @@ typedef enum eBakeNormalSwizzle { R_BAKE_NEGZ = 5, } eBakeNormalSwizzle; -/* BakeData.target (char) */ +/** #BakeData.target (char) */ typedef enum eBakeTarget { R_BAKE_TARGET_IMAGE_TEXTURES = 0, R_BAKE_TARGET_VERTEX_COLORS = 1, } eBakeTarget; -/* BakeData.save_mode (char) */ +/** #BakeData.save_mode (char) */ typedef enum eBakeSaveMode { R_BAKE_SAVE_INTERNAL = 0, R_BAKE_SAVE_EXTERNAL = 1, } eBakeSaveMode; -/* BakeData.pass_filter */ +/** #BakeData.pass_filter */ typedef enum eBakePassFilter { R_BAKE_PASS_FILTER_NONE = 0, R_BAKE_PASS_FILTER_AO = (1 << 0), @@ -794,7 +794,7 @@ typedef enum eHairType { } eHairType; /* *************************************************************** */ -/* Render Conversion/Simplfication Settings */ +/* Render Conversion/Simplification Settings */ /* control render convert and shading engine */ typedef struct RenderProfile { @@ -812,11 +812,11 @@ typedef struct RenderProfile { } RenderProfile; /* UV Paint */ -/* ToolSettings.uv_sculpt_settings */ +/** #ToolSettings.uv_sculpt_settings */ #define UV_SCULPT_LOCK_BORDERS 1 #define UV_SCULPT_ALL_ISLANDS 2 -/* ToolSettings.uv_relax_method */ +/** #ToolSettings.uv_relax_method */ #define UV_SCULPT_TOOL_RELAX_LAPLACIAN 1 #define UV_SCULPT_TOOL_RELAX_HC 2 @@ -1010,7 +1010,7 @@ typedef struct GpPaint { int mode; } GpPaint; -/* GpPaint.flag */ +/** #GpPaint.flag */ enum { GPPAINT_FLAG_USE_MATERIAL = 0, GPPAINT_FLAG_USE_VERTEXCOLOR = 1, @@ -1049,7 +1049,7 @@ typedef struct VPaint { int radial_symm[3]; } VPaint; -/* VPaint.flag */ +/** #VPaint.flag */ enum { /* weight paint only */ VP_FLAG_VGROUP_RESTRICT = (1 << 7), @@ -1152,7 +1152,7 @@ typedef struct GP_Interpolate_Settings { struct CurveMapping *custom_ipo; } GP_Interpolate_Settings; -/* GP_Interpolate_Settings.flag */ +/** #GP_Interpolate_Settings.flag */ typedef enum eGP_Interpolate_SettingsFlag { /* apply interpolation to all layers */ GP_TOOLFLAG_INTERPOLATE_ALL_LAYERS = (1 << 0), @@ -1160,7 +1160,7 @@ typedef enum eGP_Interpolate_SettingsFlag { GP_TOOLFLAG_INTERPOLATE_ONLY_SELECTED = (1 << 1), } eGP_Interpolate_SettingsFlag; -/* GP_Interpolate_Settings.type */ +/** #GP_Interpolate_Settings.type */ typedef enum eGP_Interpolate_Type { /* Traditional Linear Interpolation */ GP_IPO_LINEAR = 0, @@ -1295,7 +1295,7 @@ typedef struct CurvePaintSettings { float corner_angle; } CurvePaintSettings; -/* CurvePaintSettings.flag */ +/** #CurvePaintSettings.flag */ enum { CURVE_PAINT_FLAG_CORNERS_DETECT = (1 << 0), CURVE_PAINT_FLAG_PRESSURE_RADIUS = (1 << 1), @@ -1303,19 +1303,19 @@ enum { CURVE_PAINT_FLAG_DEPTH_STROKE_OFFSET_ABS = (1 << 3), }; -/* CurvePaintSettings.fit_method */ +/** #CurvePaintSettings.fit_method */ enum { CURVE_PAINT_FIT_METHOD_REFIT = 0, CURVE_PAINT_FIT_METHOD_SPLIT = 1, }; -/* CurvePaintSettings.depth_mode */ +/** #CurvePaintSettings.depth_mode */ enum { CURVE_PAINT_PROJECT_CURSOR = 0, CURVE_PAINT_PROJECT_SURFACE = 1, }; -/* CurvePaintSettings.surface_plane */ +/** #CurvePaintSettings.surface_plane */ enum { CURVE_PAINT_SURFACE_PLANE_NORMAL_VIEW = 0, CURVE_PAINT_SURFACE_PLANE_NORMAL_SURFACE = 1, @@ -1361,7 +1361,7 @@ typedef enum eSeqImageFitMethod { /* *************************************************************** */ /* Tool Settings */ -/* CurvePaintSettings.surface_plane */ +/** #CurvePaintSettings.surface_plane */ enum { AUTO_MERGE = 1 << 0, AUTO_MERGE_AND_SPLIT = 1 << 1, @@ -1938,7 +1938,7 @@ enum { }; /* bake_mode: same as RE_BAKE_xxx defines */ -/* RenderData.bake_flag */ +/** #RenderData.bake_flag */ #define R_BAKE_CLEAR (1 << 0) /* #define R_BAKE_OSA (1 << 1) */ /* deprecated */ #define R_BAKE_TO_ACTIVE (1 << 2) @@ -1951,19 +1951,19 @@ enum { #define R_BAKE_SPLIT_MAT (1 << 9) #define R_BAKE_AUTO_NAME (1 << 10) -/* RenderData.bake_normal_space */ +/** #RenderData.bake_normal_space */ #define R_BAKE_SPACE_CAMERA 0 #define R_BAKE_SPACE_WORLD 1 #define R_BAKE_SPACE_OBJECT 2 #define R_BAKE_SPACE_TANGENT 3 -/* RenderData.line_thickness_mode */ +/** #RenderData.line_thickness_mode */ #define R_LINE_THICKNESS_ABSOLUTE 1 #define R_LINE_THICKNESS_RELATIVE 2 /* sequencer seq_prev_type seq_rend_type */ -/* RenderData.engine (scene.c) */ +/** #RenderData.engine (scene.c) */ extern const char *RE_engine_id_BLENDER_EEVEE; extern const char *RE_engine_id_BLENDER_WORKBENCH; extern const char *RE_engine_id_CYCLES; @@ -2025,25 +2025,25 @@ extern const char *RE_engine_id_CYCLES; /* Base.flag is in DNA_object_types.h */ -/* ToolSettings.transform_flag */ +/** #ToolSettings.transform_flag */ enum { SCE_XFORM_AXIS_ALIGN = (1 << 0), SCE_XFORM_DATA_ORIGIN = (1 << 1), SCE_XFORM_SKIP_CHILDREN = (1 << 2), }; -/* ToolSettings.object_flag */ +/** #ToolSettings.object_flag */ enum { SCE_OBJECT_MODE_LOCK = (1 << 0), }; -/* ToolSettings.workspace_tool_flag */ +/** #ToolSettings.workspace_tool_flag */ enum { SCE_WORKSPACE_TOOL_FALLBACK = 0, SCE_WORKSPACE_TOOL_DEFAULT = 1, }; -/* ToolSettings.snap_flag */ +/** #ToolSettings.snap_flag */ #define SCE_SNAP (1 << 0) #define SCE_SNAP_ROTATE (1 << 1) #define SCE_SNAP_PEEL_OBJECT (1 << 2) @@ -2052,13 +2052,13 @@ enum { #define SCE_SNAP_ABS_GRID (1 << 5) #define SCE_SNAP_BACKFACE_CULLING (1 << 6) -/* ToolSettings.snap_target */ +/** #ToolSettings.snap_target */ #define SCE_SNAP_TARGET_CLOSEST 0 #define SCE_SNAP_TARGET_CENTER 1 #define SCE_SNAP_TARGET_MEDIAN 2 #define SCE_SNAP_TARGET_ACTIVE 3 -/* ToolSettings.snap_mode */ +/** #ToolSettings.snap_mode */ #define SCE_SNAP_MODE_VERTEX (1 << 0) #define SCE_SNAP_MODE_EDGE (1 << 1) #define SCE_SNAP_MODE_FACE (1 << 2) @@ -2067,11 +2067,11 @@ enum { #define SCE_SNAP_MODE_EDGE_MIDPOINT (1 << 5) #define SCE_SNAP_MODE_EDGE_PERPENDICULAR (1 << 6) -/* ToolSettings.snap_node_mode */ +/** #ToolSettings.snap_node_mode */ #define SCE_SNAP_MODE_NODE_X (1 << 5) #define SCE_SNAP_MODE_NODE_Y (1 << 6) -/* ToolSettings.snap_mode and ToolSettings.snap_node_mode */ +/** #ToolSettings.snap_mode and #ToolSettings.snap_node_mode */ #define SCE_SNAP_MODE_GRID (1 << 7) /** #ToolSettings.snap_transform_mode_flag */ @@ -2081,24 +2081,24 @@ enum { SCE_SNAP_TRANSFORM_MODE_SCALE = (1 << 2), }; -/* ToolSettings.selectmode */ +/** #ToolSettings.selectmode */ #define SCE_SELECT_VERTEX (1 << 0) /* for mesh */ #define SCE_SELECT_EDGE (1 << 1) #define SCE_SELECT_FACE (1 << 2) -/* MeshStatVis.type */ +/** #MeshStatVis.type */ #define SCE_STATVIS_OVERHANG 0 #define SCE_STATVIS_THICKNESS 1 #define SCE_STATVIS_INTERSECT 2 #define SCE_STATVIS_DISTORT 3 #define SCE_STATVIS_SHARP 4 -/* ParticleEditSettings.selectmode for particles */ +/** #ParticleEditSettings.selectmode for particles */ #define SCE_SELECT_PATH (1 << 0) #define SCE_SELECT_POINT (1 << 1) #define SCE_SELECT_END (1 << 2) -/* ToolSettings.prop_mode (proportional falloff) */ +/** #ToolSettings.prop_mode (proportional falloff) */ #define PROP_SMOOTH 0 #define PROP_SPHERE 1 #define PROP_ROOT 2 @@ -2116,7 +2116,7 @@ enum { PROP_EDIT_PROJECTED = (1 << 2), }; -/* ToolSettings.weightuser */ +/** #ToolSettings.weightuser */ enum { OB_DRAW_GROUPUSER_NONE = 0, OB_DRAW_GROUPUSER_ACTIVE = 1, @@ -2124,7 +2124,7 @@ enum { }; /* object_vgroup.c */ -/* ToolSettings.vgroupsubset */ +/** #ToolSettings.vgroupsubset */ typedef enum eVGroupSelect { WT_VGROUP_ALL = 0, WT_VGROUP_ACTIVE = 1, @@ -2137,7 +2137,7 @@ typedef enum eVGroupSelect { ((1 << WT_VGROUP_ACTIVE) | (1 << WT_VGROUP_BONE_SELECT) | (1 << WT_VGROUP_BONE_DEFORM) | \ (1 << WT_VGROUP_BONE_DEFORM_OFF) | (1 << WT_VGROUP_ALL)) -/* Scene.flag */ +/** #Scene.flag */ #define SCE_DS_SELECTED (1 << 0) #define SCE_DS_COLLAPSED (1 << 1) #define SCE_NLA_EDIT_ON (1 << 2) @@ -2151,13 +2151,13 @@ typedef enum eVGroupSelect { #define F_SCENE 1 #define F_DUPLI 3 -/* AudioData.flag */ +/** #AudioData.flag */ #define AUDIO_MUTE (1 << 0) #define AUDIO_SYNC (1 << 1) #define AUDIO_SCRUB (1 << 2) #define AUDIO_VOLUME_ANIMATED (1 << 3) -/* FFMpegCodecData.flags */ +/** #FFMpegCodecData.flags */ enum { #ifdef DNA_DEPRECATED_ALLOW FFMPEG_MULTIPLEX_AUDIO = (1 << 0), /* deprecated, you can choose none as audiocodec now */ @@ -2167,7 +2167,7 @@ enum { FFMPEG_USE_MAX_B_FRAMES = (1 << 3), }; -/* Paint.flags */ +/** #Paint.flags */ typedef enum ePaintFlags { PAINT_SHOW_BRUSH = (1 << 0), PAINT_FAST_NAVIGATE = (1 << 1), @@ -2176,8 +2176,10 @@ typedef enum ePaintFlags { PAINT_SCULPT_DELAY_UPDATES = (1 << 4), } ePaintFlags; -/* Paint.symmetry_flags - * (for now just a duplicate of sculpt symmetry flags) */ +/** + * #Paint.symmetry_flags + * (for now just a duplicate of sculpt symmetry flags). + */ typedef enum ePaintSymmetryFlags { PAINT_SYMM_X = (1 << 0), PAINT_SYMM_Y = (1 << 1), @@ -2190,8 +2192,10 @@ typedef enum ePaintSymmetryFlags { #define PAINT_SYMM_AXIS_ALL (PAINT_SYMM_X | PAINT_SYMM_Y | PAINT_SYMM_Z) -/* Sculpt.flags */ -/* These can eventually be moved to paint flags? */ +/** + * #Sculpt.flags + * These can eventually be moved to paint flags? + */ typedef enum eSculptFlags { SCULPT_FLAG_UNUSED_0 = (1 << 0), /* cleared */ SCULPT_FLAG_UNUSED_1 = (1 << 1), /* cleared */ @@ -2228,25 +2232,25 @@ typedef enum eSculptFlags { SCULPT_HIDE_FACE_SETS = (1 << 17), } eSculptFlags; -/* ImagePaintSettings.mode */ +/** #ImagePaintSettings.mode */ typedef enum eImagePaintMode { IMAGEPAINT_MODE_MATERIAL = 0, /* detect texture paint slots from the material */ IMAGEPAINT_MODE_IMAGE = 1, /* select texture paint image directly */ } eImagePaintMode; -/* ImagePaintSettings.interp */ +/** #ImagePaintSettings.interp */ enum { IMAGEPAINT_INTERP_LINEAR = 0, IMAGEPAINT_INTERP_CLOSEST = 1, }; -/* ImagePaintSettings.flag */ +/** #ImagePaintSettings.flag */ #define IMAGEPAINT_DRAWING (1 << 0) // #define IMAGEPAINT_DRAW_TOOL (1 << 1) /* deprecated */ // #define IMAGEPAINT_DRAW_TOOL_DRAWING (1 << 2) /* deprecated */ /* projection painting only */ -/* ImagePaintSettings.flag */ +/** #ImagePaintSettings.flag */ #define IMAGEPAINT_PROJECT_XRAY (1 << 4) #define IMAGEPAINT_PROJECT_BACKFACE (1 << 5) #define IMAGEPAINT_PROJECT_FLAT (1 << 6) @@ -2254,13 +2258,13 @@ enum { #define IMAGEPAINT_PROJECT_LAYER_STENCIL (1 << 8) #define IMAGEPAINT_PROJECT_LAYER_STENCIL_INV (1 << 9) -/* ImagePaintSettings.missing_data */ +/** #ImagePaintSettings.missing_data */ #define IMAGEPAINT_MISSING_UVS (1 << 0) #define IMAGEPAINT_MISSING_MATERIAL (1 << 1) #define IMAGEPAINT_MISSING_TEX (1 << 2) #define IMAGEPAINT_MISSING_STENCIL (1 << 3) -/* ToolSettings.uvcalc_flag */ +/** #ToolSettings.uvcalc_flag */ #define UVCALC_FILLHOLES (1 << 0) /** would call this UVCALC_ASPECT_CORRECT, except it should be default with old file */ #define UVCALC_NO_ASPECT_CORRECT (1 << 1) @@ -2273,17 +2277,17 @@ enum { /** Keep equal values merged while correcting custom-data. */ #define UVCALC_TRANSFORM_CORRECT_KEEP_CONNECTED (1 << 5) -/* ToolSettings.uv_flag */ +/** #ToolSettings.uv_flag */ #define UV_SYNC_SELECTION 1 #define UV_SHOW_SAME_IMAGE 2 -/* ToolSettings.uv_selectmode */ +/** #ToolSettings.uv_selectmode */ #define UV_SELECT_VERTEX 1 #define UV_SELECT_EDGE 2 #define UV_SELECT_FACE 4 #define UV_SELECT_ISLAND 8 -/* ToolSettings.gpencil_flags */ +/** #ToolSettings.gpencil_flags */ typedef enum eGPencil_Flags { /* When creating new frames, the last frame gets used as the basis for the new one */ GP_TOOL_FLAG_RETAIN_LAST = (1 << 1), @@ -2297,7 +2301,7 @@ typedef enum eGPencil_Flags { GP_TOOL_FLAG_AUTOMERGE_STROKE = (1 << 5), } eGPencil_Flags; -/* scene->r.simplify_gpencil */ +/** #Scene.r.simplify_gpencil */ typedef enum eGPencil_SimplifyFlags { /* Simplify */ SIMPLIFY_GPENCIL_ENABLE = (1 << 0), @@ -2315,7 +2319,7 @@ typedef enum eGPencil_SimplifyFlags { SIMPLIFY_GPENCIL_AA = (1 << 8), } eGPencil_SimplifyFlags; -/* ToolSettings.gpencil_*_align - Stroke Placement mode flags */ +/** `ToolSettings.gpencil_*_align` - Stroke Placement mode flags */ typedef enum eGPencil_Placement_Flags { /* New strokes are added in viewport/data space (i.e. not screen space) */ GP_PROJECT_VIEWSPACE = (1 << 0), @@ -2333,14 +2337,14 @@ typedef enum eGPencil_Placement_Flags { GP_PROJECT_DEPTH_STROKE_FIRST = (1 << 6), } eGPencil_Placement_Flags; -/* ToolSettings.gpencil_selectmode */ +/** #ToolSettings.gpencil_selectmode */ typedef enum eGPencil_Selectmode_types { GP_SELECTMODE_POINT = 0, GP_SELECTMODE_STROKE = 1, GP_SELECTMODE_SEGMENT = 2, } eGPencil_Selectmode_types; -/* ToolSettings.gpencil_guide_types */ +/** #ToolSettings.gpencil_guide_types */ typedef enum eGPencil_GuideTypes { GP_GUIDE_CIRCULAR = 0, GP_GUIDE_RADIAL = 1, @@ -2349,14 +2353,14 @@ typedef enum eGPencil_GuideTypes { GP_GUIDE_ISO = 4, } eGPencil_GuideTypes; -/* ToolSettings.gpencil_guide_references */ +/** #ToolSettings.gpencil_guide_references */ typedef enum eGPencil_Guide_Reference { GP_GUIDE_REF_CURSOR = 0, GP_GUIDE_REF_CUSTOM = 1, GP_GUIDE_REF_OBJECT = 2, } eGPencil_Guide_Reference; -/* ToolSettings.particle flag */ +/** #ToolSettings.particle flag */ #define PE_KEEP_LENGTHS (1 << 0) #define PE_LOCK_FIRST (1 << 1) #define PE_DEFLECT_EMITTER (1 << 2) @@ -2366,7 +2370,7 @@ typedef enum eGPencil_Guide_Reference { #define PE_FADE_TIME (1 << 7) #define PE_AUTO_VELOCITY (1 << 8) -/* ParticleEditSettings.brushtype */ +/** #ParticleEditSettings.brushtype */ #define PE_BRUSH_NONE -1 #define PE_BRUSH_COMB 0 #define PE_BRUSH_CUT 1 @@ -2376,15 +2380,15 @@ typedef enum eGPencil_Guide_Reference { #define PE_BRUSH_SMOOTH 5 #define PE_BRUSH_WEIGHT 6 -/* ParticleBrushData.flag */ +/** #ParticleBrushData.flag */ #define PE_BRUSH_DATA_PUFF_VOLUME 1 -/* ParticleBrushData.edittype */ +/** #ParticleBrushData.edittype */ #define PE_TYPE_PARTICLES 0 #define PE_TYPE_SOFTBODY 1 #define PE_TYPE_CLOTH 2 -/* PhysicsSettings.flag */ +/** #PhysicsSettings.flag */ #define PHYS_GLOBAL_GRAVITY 1 /* UnitSettings */ @@ -2398,7 +2402,7 @@ typedef enum eGPencil_Guide_Reference { #define USER_UNIT_OPT_SPLIT 1 #define USER_UNIT_ROT_RADIANS 2 -/* SceneEEVEE->flag */ +/** #SceneEEVEE.flag */ enum { // SCE_EEVEE_VOLUMETRIC_ENABLED = (1 << 0), /* Unused */ SCE_EEVEE_VOLUMETRIC_LIGHTS = (1 << 1), @@ -2426,21 +2430,21 @@ enum { SCE_EEVEE_DOF_JITTER = (1 << 23), }; -/* SceneEEVEE->shadow_method */ +/** #SceneEEVEE.shadow_method */ enum { SHADOW_ESM = 1, /* SHADOW_VSM = 2, */ /* UNUSED */ /* SHADOW_METHOD_MAX = 3, */ /* UNUSED */ }; -/* SceneEEVEE->motion_blur_position */ +/** #SceneEEVEE.motion_blur_position */ enum { SCE_EEVEE_MB_CENTER = 0, SCE_EEVEE_MB_START = 1, SCE_EEVEE_MB_END = 2, }; -/* SceneDisplay->render_aa, SceneDisplay->viewport_aa */ +/** #SceneDisplay->render_aa and #SceneDisplay->viewport_aa */ enum { SCE_DISPLAY_AA_OFF = 0, SCE_DISPLAY_AA_FXAA = 1, diff --git a/source/blender/makesdna/DNA_windowmanager_types.h b/source/blender/makesdna/DNA_windowmanager_types.h index a3aaf3ee937..1635aa7646b 100644 --- a/source/blender/makesdna/DNA_windowmanager_types.h +++ b/source/blender/makesdna/DNA_windowmanager_types.h @@ -472,7 +472,7 @@ typedef struct wmKeyConfig { /** Unique name. */ char idname[64]; - /** Idname of configuration this is derives from, "" if none. */ + /** ID-name of configuration this is derives from, "" if none. */ char basename[64]; ListBase keymaps; diff --git a/source/blender/windowmanager/WM_toolsystem.h b/source/blender/windowmanager/WM_toolsystem.h index 451f0ecd424..d2e2b9c8f3b 100644 --- a/source/blender/windowmanager/WM_toolsystem.h +++ b/source/blender/windowmanager/WM_toolsystem.h @@ -42,7 +42,7 @@ struct wmOperatorType; #define WM_TOOLSYSTEM_SPACE_MASK \ ((1 << SPACE_IMAGE) | (1 << SPACE_NODE) | (1 << SPACE_VIEW3D) | (1 << SPACE_SEQ)) -/* Values that define a categoey of active tool. */ +/* Values that define a category of active tool. */ typedef struct bToolKey { int space_type; int mode; diff --git a/source/blender/windowmanager/WM_types.h b/source/blender/windowmanager/WM_types.h index 0a32d2f0405..24aa5bc4869 100644 --- a/source/blender/windowmanager/WM_types.h +++ b/source/blender/windowmanager/WM_types.h @@ -549,7 +549,7 @@ typedef struct wmEvent { /** Event code itself (short, is also in keymap). */ short type; - /** Press, release, scrollvalue. */ + /** Press, release, scroll-value. */ short val; /** Mouse pointer position, screen coord. */ int x, y; diff --git a/source/blender/windowmanager/intern/wm_init_exit.c b/source/blender/windowmanager/intern/wm_init_exit.c index 918836041df..56fd51ac6fd 100644 --- a/source/blender/windowmanager/intern/wm_init_exit.c +++ b/source/blender/windowmanager/intern/wm_init_exit.c @@ -624,13 +624,13 @@ void WM_exit_ex(bContext *C, const bool do_python) #ifdef WITH_PYTHON /* option not to close python so we can use 'atexit' */ if (do_python && ((C == NULL) || CTX_py_init_get(C))) { - /* XXX - old note */ - /* before BKE_blender_free so py's gc happens while library still exists */ - /* needed at least for a rare sigsegv that can happen in pydrivers */ - - /* Update for blender 2.5, move after BKE_blender_free because Blender now holds references to - * PyObject's so decref'ing them after python ends causes bad problems every time - * the py-driver bug can be fixed if it happens again we can deal with it then. */ + /* NOTE: (old note) + * before BKE_blender_free so Python's garbage-collection happens while library still exists. + * Needed at least for a rare crash that can happen in python-drivers. + * + * Update for Blender 2.5, move after #BKE_blender_free because Blender now holds references + * to #PyObject's so #Py_DECREF'ing them after Python ends causes bad problems every time + * the python-driver bug can be fixed if it happens again we can deal with it then. */ BPY_python_end(); } #else diff --git a/source/blender/windowmanager/intern/wm_keymap.c b/source/blender/windowmanager/intern/wm_keymap.c index fcb13fff0a5..6cc9a4c9b64 100644 --- a/source/blender/windowmanager/intern/wm_keymap.c +++ b/source/blender/windowmanager/intern/wm_keymap.c @@ -1333,7 +1333,7 @@ static wmKeyMapItem *wm_keymap_item_find_in_keymap(wmKeyMap *keymap, if (IDP_EqualsProperties_ex(properties, properties_default, is_strict)) { char kmi_str[128]; WM_keymap_item_to_string(kmi, false, kmi_str, sizeof(kmi_str)); - /* Note gievn properties could come from other things than menu entry... */ + /* NOTE: given properties could come from other things than menu entry. */ printf( "%s: Some set values in menu entry match default op values, " "this might not be desired!\n", diff --git a/source/blender/windowmanager/intern/wm_playanim.c b/source/blender/windowmanager/intern/wm_playanim.c index 1b1ebc70fd9..02a8951e60e 100644 --- a/source/blender/windowmanager/intern/wm_playanim.c +++ b/source/blender/windowmanager/intern/wm_playanim.c @@ -1146,7 +1146,6 @@ static char *wm_main_playanim_intern(int argc, const char **argv) PlayState ps = {0}; - /* ps.doubleb = true;*/ /* UNUSED */ ps.go = true; ps.direction = true; ps.next_frame = 1; @@ -1162,7 +1161,6 @@ static char *wm_main_playanim_intern(int argc, const char **argv) ps.indicator = false; ps.dropped_file[0] = 0; ps.zoom = 1.0f; - /* resetmap = false */ ps.draw_flip[0] = false; ps.draw_flip[1] = false; @@ -1423,7 +1421,7 @@ static char *wm_main_playanim_intern(int argc, const char **argv) #endif #ifdef USE_FRAME_CACHE_LIMIT - /* really basic memory conservation scheme. Keep frames in a fifo queue */ + /* Really basic memory conservation scheme. Keep frames in a FIFO queue. */ node = inmempicsbase.last; while (node && added_images > PLAY_FRAME_CACHE_MAX) { -- cgit v1.2.3