diff options
Diffstat (limited to 'source/blender/blenkernel')
50 files changed, 148 insertions, 147 deletions
diff --git a/source/blender/blenkernel/BKE_idcode.h b/source/blender/blenkernel/BKE_idcode.h index 964a49435f1..2400d02a21d 100644 --- a/source/blender/blenkernel/BKE_idcode.h +++ b/source/blender/blenkernel/BKE_idcode.h @@ -47,7 +47,7 @@ int BKE_idcode_to_index(const short idcode); /** * Return an ID code and steps the index forward 1. * - * \param index start as 0. + * \param index: start as 0. * \return the code, 0 when all codes have been returned. */ short BKE_idcode_iter_step(int *index); diff --git a/source/blender/blenkernel/intern/action.c b/source/blender/blenkernel/intern/action.c index 7612e9a3fdb..bbd7511842f 100644 --- a/source/blender/blenkernel/intern/action.c +++ b/source/blender/blenkernel/intern/action.c @@ -126,7 +126,7 @@ void BKE_action_free(bAction *act) * * WARNING! This function will not handle ID user count! * - * \param flag Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). + * \param flag: Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). */ void BKE_action_copy_data(Main *UNUSED(bmain), bAction *act_dst, const bAction *act_src, const int UNUSED(flag)) { @@ -531,7 +531,7 @@ const char *BKE_pose_ikparam_get_name(bPose *pose) * Allocate a new pose on the heap, and copy the src pose and it's channels * into the new pose. *dst is set to the newly allocated structure, and assumed to be NULL. * - * \param dst Should be freed already, makes entire duplicate. + * \param dst: Should be freed already, makes entire duplicate. */ void BKE_pose_copy_data_ex(bPose **dst, const bPose *src, const int flag, const bool copy_constraints) { diff --git a/source/blender/blenkernel/intern/anim.c b/source/blender/blenkernel/intern/anim.c index d5f269b82a8..45e1de49092 100644 --- a/source/blender/blenkernel/intern/anim.c +++ b/source/blender/blenkernel/intern/anim.c @@ -129,9 +129,9 @@ void animviz_free_motionpath(bMotionPath *mpath) * Setup motion paths for the given data. * \note Only used when explicitly calculating paths on bones which may/may not be consider already * - * \param scene Current scene (for frame ranges, etc.) - * \param ob Object to add paths for (must be provided) - * \param pchan Posechannel to add paths for (optional; if not provided, object-paths are assumed) + * \param scene: Current scene (for frame ranges, etc.) + * \param ob: Object to add paths for (must be provided) + * \param pchan: Posechannel to add paths for (optional; if not provided, object-paths are assumed) */ bMotionPath *animviz_verify_motionpaths(ReportList *reports, Scene *scene, Object *ob, bPoseChannel *pchan) { diff --git a/source/blender/blenkernel/intern/anim_sys.c b/source/blender/blenkernel/intern/anim_sys.c index 500ece2a735..d0262579663 100644 --- a/source/blender/blenkernel/intern/anim_sys.c +++ b/source/blender/blenkernel/intern/anim_sys.c @@ -409,8 +409,8 @@ void BKE_animdata_merge_copy( /** * Helper heuristic for determining if a path is compatible with the basepath * - * \param path Full RNA-path from some data (usually an F-Curve) to compare - * \param basepath Shorter path fragment to look for + * \param path: Full RNA-path from some data (usually an F-Curve) to compare + * \param basepath: Shorter path fragment to look for * \return Whether there is a match */ static bool animpath_matches_basepath(const char path[], const char basepath[]) @@ -582,9 +582,9 @@ void BKE_animdata_separate_by_basepath( * such drivers by rerouting all paths through the active object instead so that * they will get picked up by the dependency system. * - * \param C Context pointer - for getting active data + * \param C: Context pointer - for getting active data * \param[in,out] ptr RNA pointer for property's datablock. May be modified as result of path remapping. - * \param prop RNA definition of property to add for + * \param prop: RNA definition of property to add for * \return MEM_alloc'd string representing the path to the property from the given #PointerRNA */ char *BKE_animdata_driver_path_hack(bContext *C, PointerRNA *ptr, PropertyRNA *prop, char *base_path) diff --git a/source/blender/blenkernel/intern/appdir.c b/source/blender/blenkernel/intern/appdir.c index 8d6c34222d7..ecd37c8dab5 100644 --- a/source/blender/blenkernel/intern/appdir.c +++ b/source/blender/blenkernel/intern/appdir.c @@ -182,10 +182,10 @@ static bool test_env_path(char *path, const char *envvar) * Constructs in \a targetpath the name of a directory relative to a version-specific * subdirectory in the parent directory of the Blender executable. * - * \param targetpath String to return path - * \param folder_name Optional folder name within version-specific directory - * \param subfolder_name Optional subfolder name within folder_name - * \param ver To construct name of version-specific directory within bprogdir + * \param targetpath: String to return path + * \param folder_name: Optional folder name within version-specific directory + * \param subfolder_name: Optional subfolder name within folder_name + * \param ver: To construct name of version-specific directory within bprogdir * \return true if such a directory exists. */ static bool get_path_local( @@ -273,10 +273,10 @@ static bool get_path_environment( * Returns the path of a folder within the user-files area. * * - * \param targetpath String to return path - * \param folder_name default name of folder within user area - * \param subfolder_name optional name of subfolder within folder - * \param ver Blender version, used to construct a subdirectory name + * \param targetpath: String to return path + * \param folder_name: default name of folder within user area + * \param subfolder_name: optional name of subfolder within folder + * \param ver: Blender version, used to construct a subdirectory name * \return true if it was able to construct such a path. */ static bool get_path_user( @@ -314,10 +314,10 @@ static bool get_path_user( /** * Returns the path of a folder within the Blender installation directory. * - * \param targetpath String to return path - * \param folder_name default name of folder within installation area - * \param subfolder_name optional name of subfolder within folder - * \param ver Blender version, used to construct a subdirectory name + * \param targetpath: String to return path + * \param folder_name: default name of folder within installation area + * \param subfolder_name: optional name of subfolder within folder + * \param ver: Blender version, used to construct a subdirectory name * \return true if it was able to construct such a path. */ static bool get_path_system( @@ -542,9 +542,9 @@ const char *BKE_appdir_folder_id_version(const int folder_id, const int ver, con * the name to its 8.3 version to prevent problems with * spaces and stuff. Final result is returned in fullname. * - * \param fullname The full path and full name of the executable + * \param fullname: The full path and full name of the executable * (must be FILE_MAX minimum) - * \param name The name of the executable (usually argv[0]) to be checked + * \param name: The name of the executable (usually argv[0]) to be checked */ static void where_am_i(char *fullname, const size_t maxlen, const char *name) { @@ -744,10 +744,10 @@ bool BKE_appdir_app_template_id_search(const char *app_template, char *path, siz * * Also make sure the temp dir has a trailing slash * - * \param fullname The full path to the temporary temp directory - * \param basename The full path to the persistent temp directory (may be NULL) - * \param maxlen The size of the fullname buffer - * \param userdir Directory specified in user preferences + * \param fullname: The full path to the temporary temp directory + * \param basename: The full path to the persistent temp directory (may be NULL) + * \param maxlen: The size of the fullname buffer + * \param userdir: Directory specified in user preferences */ static void where_is_temp(char *fullname, char *basename, const size_t maxlen, char *userdir) { diff --git a/source/blender/blenkernel/intern/armature.c b/source/blender/blenkernel/intern/armature.c index 0f9c79c5e3e..65b6b2fe3b2 100644 --- a/source/blender/blenkernel/intern/armature.c +++ b/source/blender/blenkernel/intern/armature.c @@ -181,7 +181,7 @@ static void copy_bonechildren( * * WARNING! This function will not handle ID user count! * - * \param flag Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). + * \param flag: Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). */ void BKE_armature_copy_data(Main *UNUSED(bmain), bArmature *arm_dst, const bArmature *arm_src, const int flag) { diff --git a/source/blender/blenkernel/intern/autoexec.c b/source/blender/blenkernel/intern/autoexec.c index bde06b02ae8..708820877d9 100644 --- a/source/blender/blenkernel/intern/autoexec.c +++ b/source/blender/blenkernel/intern/autoexec.c @@ -43,7 +43,7 @@ #include "BKE_autoexec.h" /* own include */ /** - * \param path The path to check against. + * \param path: The path to check against. * \return Success */ bool BKE_autoexec_match(const char *path) diff --git a/source/blender/blenkernel/intern/brush.c b/source/blender/blenkernel/intern/brush.c index 5b76d75f261..e59c0231d84 100644 --- a/source/blender/blenkernel/intern/brush.c +++ b/source/blender/blenkernel/intern/brush.c @@ -181,7 +181,7 @@ struct Brush *BKE_brush_first_search(struct Main *bmain, const eObjectMode ob_mo * * WARNING! This function will not handle ID user count! * - * \param flag Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). + * \param flag: Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). */ void BKE_brush_copy_data(Main *UNUSED(bmain), Brush *brush_dst, const Brush *brush_src, const int flag) { diff --git a/source/blender/blenkernel/intern/bvhutils.c b/source/blender/blenkernel/intern/bvhutils.c index 151d697d891..e615fdfccbc 100644 --- a/source/blender/blenkernel/intern/bvhutils.c +++ b/source/blender/blenkernel/intern/bvhutils.c @@ -499,9 +499,9 @@ BVHTree *bvhtree_from_editmesh_verts( /** * Builds a bvh tree where nodes are the given vertices (note: does not copy given mverts!). - * \param vert_allocated if true, vert freeing will be done when freeing data. - * \param verts_mask if not null, true elements give which vert to add to BVH tree. - * \param verts_num_active if >= 0, number of active verts to add to BVH tree (else will be computed from mask). + * \param vert_allocated: if true, vert freeing will be done when freeing data. + * \param verts_mask: if not null, true elements give which vert to add to BVH tree. + * \param verts_num_active: if >= 0, number of active verts to add to BVH tree (else will be computed from mask). */ BVHTree *bvhtree_from_mesh_verts_ex( BVHTreeFromMesh *data, const MVert *vert, const int verts_num, const bool vert_allocated, @@ -651,9 +651,10 @@ BVHTree *bvhtree_from_editmesh_edges( /** * Builds a bvh tree where nodes are the given edges . - * \param vert/edge_allocated if true, elem freeing will be done when freeing data. - * \param edges_mask if not null, true elements give which vert to add to BVH tree. - * \param edges_num_active if >= 0, number of active edges to add to BVH tree (else will be computed from mask). + * \param vert, vert_allocated: If true, elem freeing will be done when freeing data. + * \param edge, edge_allocated: If true, elem freeing will be done when freeing data. + * \param edges_mask: if not null, true elements give which vert to add to BVH tree. + * \param edges_num_active: if >= 0, number of active edges to add to BVH tree (else will be computed from mask). */ BVHTree *bvhtree_from_mesh_edges_ex( BVHTreeFromMesh *data, diff --git a/source/blender/blenkernel/intern/cachefile.c b/source/blender/blenkernel/intern/cachefile.c index 5f7759c7b55..8f5a08d66a9 100644 --- a/source/blender/blenkernel/intern/cachefile.c +++ b/source/blender/blenkernel/intern/cachefile.c @@ -105,7 +105,7 @@ void BKE_cachefile_free(CacheFile *cache_file) * * WARNING! This function will not handle ID user count! * - * \param flag Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). + * \param flag: Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). */ void BKE_cachefile_copy_data( Main *UNUSED(bmain), CacheFile *cache_file_dst, const CacheFile *UNUSED(cache_file_src), const int UNUSED(flag)) diff --git a/source/blender/blenkernel/intern/camera.c b/source/blender/blenkernel/intern/camera.c index 3e6e88c5f44..5dd60e8dd73 100644 --- a/source/blender/blenkernel/intern/camera.c +++ b/source/blender/blenkernel/intern/camera.c @@ -98,7 +98,7 @@ void *BKE_camera_add(Main *bmain, const char *name) * * WARNING! This function will not handle ID user count! * - * \param flag Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). + * \param flag: Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). */ void BKE_camera_copy_data(Main *UNUSED(bmain), Camera *UNUSED(cam_dst), const Camera *UNUSED(cam_src), const int UNUSED(flag)) { diff --git a/source/blender/blenkernel/intern/cdderivedmesh.c b/source/blender/blenkernel/intern/cdderivedmesh.c index ed2b8cddc14..16d131330cd 100644 --- a/source/blender/blenkernel/intern/cdderivedmesh.c +++ b/source/blender/blenkernel/intern/cdderivedmesh.c @@ -2947,15 +2947,15 @@ static bool poly_gset_compare_fn(const void *k1, const void *k2) * * This frees dm, and returns a new one. * - * \param vtargetmap The table that maps vertices to target vertices. a value of -1 + * \param vtargetmap: The table that maps vertices to target vertices. a value of -1 * indicates a vertex is a target, and is to be kept. * This array is aligned with 'dm->numVertData' * \warning \a vtergatmap must **not** contain any chained mapping (v1 -> v2 -> v3 etc.), this is not supported * and will likely generate corrupted geometry. * - * \param tot_vtargetmap The number of non '-1' values in vtargetmap. (not the size) + * \param tot_vtargetmap: The number of non '-1' values in vtargetmap. (not the size) * - * \param merge_mode enum with two modes. + * \param merge_mode: enum with two modes. * - #CDDM_MERGE_VERTS_DUMP_IF_MAPPED * When called by the Mirror Modifier, * In this mode it skips any faces that have all vertices merged (to avoid creating pairs diff --git a/source/blender/blenkernel/intern/colortools.c b/source/blender/blenkernel/intern/colortools.c index ff4795afe87..459c97d1b01 100644 --- a/source/blender/blenkernel/intern/colortools.c +++ b/source/blender/blenkernel/intern/colortools.c @@ -925,8 +925,8 @@ void curvemapping_evaluateRGBF(const CurveMapping *cumap, float vecout[3], const * * Use in conjunction with #curvemapping_set_black_white_ex * - * \param black Use instead of cumap->black - * \param bwmul Use instead of cumap->bwmul + * \param black: Use instead of cumap->black + * \param bwmul: Use instead of cumap->bwmul */ void curvemapping_evaluate_premulRGBF_ex(const CurveMapping *cumap, float vecout[3], const float vecin[3], const float black[3], const float bwmul[3]) diff --git a/source/blender/blenkernel/intern/context.c b/source/blender/blenkernel/intern/context.c index c9468c7d95c..bdaa2e7fbfa 100644 --- a/source/blender/blenkernel/intern/context.c +++ b/source/blender/blenkernel/intern/context.c @@ -467,10 +467,10 @@ static void data_dir_add(ListBase *lb, const char *member, const bool use_all) } /** - * \param C Context - * \param use_store Use 'C->wm.store' - * \param use_rna Use Include the properties from 'RNA_Context' - * \param use_all Don't skip values (currently only "scene") + * \param C: Context + * \param use_store: Use 'C->wm.store' + * \param use_rna: Use Include the properties from 'RNA_Context' + * \param use_all: Don't skip values (currently only "scene") */ ListBase CTX_data_dir_get_ex(const bContext *C, const bool use_store, const bool use_rna, const bool use_all) { diff --git a/source/blender/blenkernel/intern/curve.c b/source/blender/blenkernel/intern/curve.c index b395df49061..7c27b9bf9f5 100644 --- a/source/blender/blenkernel/intern/curve.c +++ b/source/blender/blenkernel/intern/curve.c @@ -196,7 +196,7 @@ Curve *BKE_curve_add(Main *bmain, const char *name, int type) * * WARNING! This function will not handle ID user count! * - * \param flag Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). + * \param flag: Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). */ void BKE_curve_copy_data(Main *bmain, Curve *cu_dst, const Curve *cu_src, const int flag) { @@ -1356,9 +1356,9 @@ void BKE_nurb_makeFaces(const Nurb *nu, float *coord_array, int rowstride, int r } /** - * \param coord_array Has to be 3 * 4 * pntsu * resolu in size and zero-ed - * \param tilt_array set when non-NULL - * \param radius_array set when non-NULL + * \param coord_array: Has to be 3 * 4 * pntsu * resolu in size and zero-ed + * \param tilt_array: set when non-NULL + * \param radius_array: set when non-NULL */ void BKE_nurb_makeCurve( const Nurb *nu, float *coord_array, float *tilt_array, float *radius_array, float *weight_array, diff --git a/source/blender/blenkernel/intern/customdata.c b/source/blender/blenkernel/intern/customdata.c index 8fa117dfce1..1016568f7ec 100644 --- a/source/blender/blenkernel/intern/customdata.c +++ b/source/blender/blenkernel/intern/customdata.c @@ -2321,7 +2321,7 @@ void CustomData_interp(const CustomData *source, CustomData *dest, * This only applies to item types that may store several sub-item data (e.g. corner data [UVs, VCol, ...] of * tessellated faces). * - * \param corner_indices A mapping 'new_index -> old_index' of sub-item data. + * \param corner_indices: A mapping 'new_index -> old_index' of sub-item data. */ void CustomData_swap_corners(struct CustomData *data, int index, const int *corner_indices) { @@ -3191,7 +3191,7 @@ void CustomData_bmesh_set_default(CustomData *data, void **block) } /** - * \param use_default_init initializes data which can't be copied, + * \param use_default_init: initializes data which can't be copied, * typically you'll want to use this if the BM_xxx create function * is called with BM_CREATE_SKIP_CD flag */ @@ -3303,11 +3303,11 @@ void CustomData_file_write_info(int type, const char **r_struct_name, int *r_str /** * Prepare given custom data for file writing. * - * \param data the customdata to tweak for .blend file writing (modified in place). - * \param r_write_layers contains a reduced set of layers to be written to file, use it with writestruct_at_address() + * \param data: the customdata to tweak for .blend file writing (modified in place). + * \param r_write_layers: contains a reduced set of layers to be written to file, use it with writestruct_at_address() * (caller must free it if != \a write_layers_buff). - * \param write_layers_buff an optional buffer for r_write_layers (to avoid allocating it). - * \param write_layers_size the size of pre-allocated \a write_layer_buff. + * \param write_layers_buff: an optional buffer for r_write_layers (to avoid allocating it). + * \param write_layers_size: the size of pre-allocated \a write_layer_buff. * * \warning After this func has ran, given custom data is no more valid from Blender PoV (its totlayer is invalid). * This func shall always be called with localized data (as it is in write_meshes()). diff --git a/source/blender/blenkernel/intern/displist.c b/source/blender/blenkernel/intern/displist.c index dea1a3718dd..2e10697f315 100644 --- a/source/blender/blenkernel/intern/displist.c +++ b/source/blender/blenkernel/intern/displist.c @@ -451,9 +451,9 @@ static void curve_to_displist(Curve *cu, ListBase *nubase, ListBase *dispbase, } /** - * \param normal_proj Optional normal thats used to project the scanfill verts into 2d coords. + * \param normal_proj: Optional normal thats used to project the scanfill verts into 2d coords. * Pass this along if known since it saves time calculating the normal. - * \param flipnormal Flip the normal (same as passing \a normal_proj negated) + * \param flipnormal: Flip the normal (same as passing \a normal_proj negated) */ void BKE_displist_fill(ListBase *dispbase, ListBase *to, const float normal_proj[3], const bool flipnormal) { diff --git a/source/blender/blenkernel/intern/gpencil.c b/source/blender/blenkernel/intern/gpencil.c index a0d759118ec..a88794fea64 100644 --- a/source/blender/blenkernel/intern/gpencil.c +++ b/source/blender/blenkernel/intern/gpencil.c @@ -759,7 +759,7 @@ bGPDlayer *BKE_gpencil_layer_duplicate(const bGPDlayer *gpl_src) * * WARNING! This function will not handle ID user count! * - * \param flag Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). + * \param flag: Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). */ void BKE_gpencil_copy_data(Main *UNUSED(bmain), bGPdata *gpd_dst, const bGPdata *gpd_src, const int UNUSED(flag)) { diff --git a/source/blender/blenkernel/intern/group.c b/source/blender/blenkernel/intern/group.c index 62f608f8565..3f4c62069f8 100644 --- a/source/blender/blenkernel/intern/group.c +++ b/source/blender/blenkernel/intern/group.c @@ -95,7 +95,7 @@ Group *BKE_group_add(Main *bmain, const char *name) * * WARNING! This function will not handle ID user count! * - * \param flag Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). + * \param flag: Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). */ void BKE_group_copy_data(Main *UNUSED(bmain), Group *group_dst, const Group *group_src, const int flag) { diff --git a/source/blender/blenkernel/intern/idcode.c b/source/blender/blenkernel/intern/idcode.c index d995dce1259..68acd9e1234 100644 --- a/source/blender/blenkernel/intern/idcode.c +++ b/source/blender/blenkernel/intern/idcode.c @@ -163,7 +163,7 @@ const char *BKE_idcode_to_name(short idcode) /** * Convert a name into an idcode (ie. ID_SCE) * - * \param name The name to convert. + * \param name: The name to convert. * \return The code for the name, or 0 if invalid. */ short BKE_idcode_from_name(const char *name) @@ -341,7 +341,7 @@ const char *BKE_idcode_to_translation_context(short idcode) /** * Return an ID code and steps the index forward 1. * - * \param index start as 0. + * \param index: start as 0. * \return the code, 0 when all codes have been returned. */ short BKE_idcode_iter_step(int *index) diff --git a/source/blender/blenkernel/intern/idprop.c b/source/blender/blenkernel/intern/idprop.c index 7a526d31567..6fe0c9b3cc6 100644 --- a/source/blender/blenkernel/intern/idprop.c +++ b/source/blender/blenkernel/intern/idprop.c @@ -330,9 +330,9 @@ static IDProperty *IDP_CopyArray(const IDProperty *prop, const int flag) /** * - * \param st The string to assign. - * \param name The property name. - * \param maxlen The size of the new string (including the \0 terminator). + * \param st: The string to assign. + * \param name: The property name. + * \param maxlen: The size of the new string (including the \0 terminator). * \return The new string property. */ IDProperty *IDP_NewString(const char *st, const char *name, int maxlen) @@ -810,7 +810,7 @@ IDProperty *IDP_GetProperties(ID *id, const bool create_if_needed) } /** - * \param is_strict When false treat missing items as a match */ + * \param is_strict: When false treat missing items as a match */ bool IDP_EqualsProperties_ex(IDProperty *prop1, IDProperty *prop2, const bool is_strict) { if (prop1 == NULL && prop2 == NULL) diff --git a/source/blender/blenkernel/intern/image.c b/source/blender/blenkernel/intern/image.c index 1d209dec935..2da33d4e1bc 100644 --- a/source/blender/blenkernel/intern/image.c +++ b/source/blender/blenkernel/intern/image.c @@ -452,7 +452,7 @@ static void copy_image_packedfiles(ListBase *lb_dst, const ListBase *lb_src) * * WARNING! This function will not handle ID user count! * - * \param flag Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). + * \param flag: Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). */ void BKE_image_copy_data(Main *UNUSED(bmain), Image *ima_dst, const Image *ima_src, const int flag) { diff --git a/source/blender/blenkernel/intern/key.c b/source/blender/blenkernel/intern/key.c index 4689575655e..ee11b67ca67 100644 --- a/source/blender/blenkernel/intern/key.c +++ b/source/blender/blenkernel/intern/key.c @@ -160,7 +160,7 @@ Key *BKE_key_add(Main *bmain, ID *id) /* common function */ * * WARNING! This function will not handle ID user count! * - * \param flag Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). + * \param flag: Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). */ void BKE_key_copy_data(Main *UNUSED(bmain), Key *key_dst, const Key *key_src, const int UNUSED(flag)) { @@ -1492,9 +1492,9 @@ KeyBlock *BKE_keyblock_add(Key *key, const char *name) * \note sorting is a problematic side effect in some cases, * better only do this explicitly by having its own function, * - * \param key The key datablock to add to. - * \param name Optional name for the new keyblock. - * \param do_force always use ctime even for relative keys. + * \param key: The key datablock to add to. + * \param name: Optional name for the new keyblock. + * \param do_force: always use ctime even for relative keys. */ KeyBlock *BKE_keyblock_add_ctime(Key *key, const char *name, const bool do_force) { @@ -1800,11 +1800,11 @@ void BKE_keyblock_convert_to_mesh(KeyBlock *kb, Mesh *me) /** * Computes normals (vertices, polygons and/or loops ones) of given mesh for given shape key. * - * \param kb the KeyBlock to use to compute normals. - * \param mesh the Mesh to apply keyblock to. - * \param r_vertnors if non-NULL, an array of vectors, same length as number of vertices. - * \param r_polynors if non-NULL, an array of vectors, same length as number of polygons. - * \param r_loopnors if non-NULL, an array of vectors, same length as number of loops. + * \param kb: the KeyBlock to use to compute normals. + * \param mesh: the Mesh to apply keyblock to. + * \param r_vertnors: if non-NULL, an array of vectors, same length as number of vertices. + * \param r_polynors: if non-NULL, an array of vectors, same length as number of polygons. + * \param r_loopnors: if non-NULL, an array of vectors, same length as number of loops. */ void BKE_keyblock_mesh_calc_normals( struct KeyBlock *kb, struct Mesh *mesh, @@ -2049,7 +2049,7 @@ void BKE_keyblock_update_from_offset(Object *ob, KeyBlock *kb, float (*ofs)[3]) * the object's active shape index, the 'frame' value in case of absolute keys, etc. * Note indices are expected in real values (not 'fake' shapenr +1 ones). * - * \param org_index if < 0, current object's active shape will be used as skey to move. + * \param org_index: if < 0, current object's active shape will be used as skey to move. * \return true if something was done, else false. */ bool BKE_keyblock_move(Object *ob, int org_index, int new_index) diff --git a/source/blender/blenkernel/intern/lamp.c b/source/blender/blenkernel/intern/lamp.c index 84a8e11bdc8..c1a781d4936 100644 --- a/source/blender/blenkernel/intern/lamp.c +++ b/source/blender/blenkernel/intern/lamp.c @@ -121,7 +121,7 @@ Lamp *BKE_lamp_add(Main *bmain, const char *name) * * WARNING! This function will not handle ID user count! * - * \param flag Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). + * \param flag: Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). */ void BKE_lamp_copy_data(Main *bmain, Lamp *la_dst, const Lamp *la_src, const int flag) { diff --git a/source/blender/blenkernel/intern/lattice.c b/source/blender/blenkernel/intern/lattice.c index 1e99712f47a..64c1d3ab02f 100644 --- a/source/blender/blenkernel/intern/lattice.c +++ b/source/blender/blenkernel/intern/lattice.c @@ -284,7 +284,7 @@ Lattice *BKE_lattice_add(Main *bmain, const char *name) * * WARNING! This function will not handle ID user count! * - * \param flag Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). + * \param flag: Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). */ void BKE_lattice_copy_data(Main *bmain, Lattice *lt_dst, const Lattice *lt_src, const int flag) { diff --git a/source/blender/blenkernel/intern/library.c b/source/blender/blenkernel/intern/library.c index a6cee54d81f..4d526ad8c77 100644 --- a/source/blender/blenkernel/intern/library.c +++ b/source/blender/blenkernel/intern/library.c @@ -370,7 +370,7 @@ void BKE_id_make_local_generic(Main *bmain, ID *id, const bool id_in_mainlist, c * * \note Always set ID->newid pointer in case it gets duplicated... * - * \param lib_local Special flag used when making a whole library's content local, it needs specific handling. + * \param lib_local: Special flag used when making a whole library's content local, it needs specific handling. * * \return true if the block can be made local. */ @@ -515,11 +515,11 @@ static int id_copy_libmanagement_cb(void *user_data, ID *UNUSED(id_self), ID **i * * \note Usercount of new copy is always set to 1. * - * \param bmain Main database, may be NULL only if LIB_ID_CREATE_NO_MAIN is specified. - * \param id Source datablock. - * \param r_newid Pointer to new (copied) ID pointer. - * \param flag Set of copy options, see DNA_ID.h enum for details (leave to zero for default, full copy). - * \param test If set, do not do any copy, just test whether copy is supported. + * \param bmain: Main database, may be NULL only if LIB_ID_CREATE_NO_MAIN is specified. + * \param id: Source datablock. + * \param r_newid: Pointer to new (copied) ID pointer. + * \param flag: Set of copy options, see DNA_ID.h enum for details (leave to zero for default, full copy). + * \param test: If set, do not do any copy, just test whether copy is supported. * \return False when copying that ID type is not supported, true otherwise. */ /* XXX TODO remove test thing, *all* IDs should be copyable that way! */ @@ -1529,8 +1529,8 @@ void BKE_main_relations_free(Main *bmain) /** * Generates a raw .blend file thumbnail data from given image. * - * \param bmain If not NULL, also store generated data in this Main. - * \param img ImBuf image to generate thumbnail data from. + * \param bmain: If not NULL, also store generated data in this Main. + * \param img: ImBuf image to generate thumbnail data from. * \return The generated .blend file raw thumbnail data. */ BlendThumbnail *BKE_main_thumbnail_from_imbuf(Main *bmain, ImBuf *img) @@ -1560,8 +1560,8 @@ BlendThumbnail *BKE_main_thumbnail_from_imbuf(Main *bmain, ImBuf *img) /** * Generates an image from raw .blend file thumbnail \a data. * - * \param bmain Use this bmain->blen_thumb data if given \a data is NULL. - * \param data Raw .blend file thumbnail data. + * \param bmain: Use this bmain->blen_thumb data if given \a data is NULL. + * \param data: Raw .blend file thumbnail data. * \return An ImBuf from given data, or NULL if invalid. */ ImBuf *BKE_main_thumbnail_to_imbuf(Main *bmain, BlendThumbnail *data) @@ -1948,10 +1948,10 @@ static void library_make_local_copying_check(ID *id, GSet *loop_tags, MainIDRela /** Make linked datablocks local. * - * \param bmain Almost certainly global main. - * \param lib If not NULL, only make local datablocks from this library. - * \param untagged_only If true, only make local datablocks not tagged with LIB_TAG_PRE_EXISTING. - * \param set_fake If true, set fake user on all localized datablocks (except group and objects ones). + * \param bmain: Almost certainly global main. + * \param lib: If not NULL, only make local datablocks from this library. + * \param untagged_only: If true, only make local datablocks not tagged with LIB_TAG_PRE_EXISTING. + * \param set_fake: If true, set fake user on all localized datablocks (except group and objects ones). */ /* Note: Old (2.77) version was simply making (tagging) datablocks as local, without actually making any check whether * they were also indirectly used or not... diff --git a/source/blender/blenkernel/intern/library_query.c b/source/blender/blenkernel/intern/library_query.c index f5367f6f8b3..8a646484e2c 100644 --- a/source/blender/blenkernel/intern/library_query.c +++ b/source/blender/blenkernel/intern/library_query.c @@ -1182,8 +1182,8 @@ static int foreach_libblock_id_users_callback(void *user_data, ID *UNUSED(self_i * \note This only checks for pointer references of an ID, shallow usages (like e.g. by RNA paths, as done * for FCurves) are not detected at all. * - * \param id_user the ID which is supposed to use (reference) \a id_used. - * \param id_used the ID which is supposed to be used (referenced) by \a id_user. + * \param id_user: the ID which is supposed to use (reference) \a id_used. + * \param id_used: the ID which is supposed to be used (referenced) by \a id_user. * \return the number of direct usages/references of \a id_used by \a id_user. */ int BKE_library_ID_use_ID(ID *id_user, ID *id_used) @@ -1319,7 +1319,7 @@ static int foreach_libblock_used_linked_data_tag_clear_cb( * including complex cases like 'linked archipelagoes', i.e. linked datablocks that use each other in loops, * which prevents their deletion by 'basic' usage checks... * - * \param do_init_tag if \a true, all linked data are checked, if \a false, only linked datablocks already tagged with + * \param do_init_tag: if \a true, all linked data are checked, if \a false, only linked datablocks already tagged with * LIB_TAG_DOIT are checked. */ void BKE_library_unused_linked_data_set_tag(Main *bmain, const bool do_init_tag) diff --git a/source/blender/blenkernel/intern/linestyle.c b/source/blender/blenkernel/intern/linestyle.c index e00884c8a9d..3c1d591d3f4 100644 --- a/source/blender/blenkernel/intern/linestyle.c +++ b/source/blender/blenkernel/intern/linestyle.c @@ -160,7 +160,7 @@ void BKE_linestyle_free(FreestyleLineStyle *linestyle) * * WARNING! This function will not handle ID user count! * - * \param flag Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). + * \param flag: Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). */ void BKE_linestyle_copy_data( struct Main *bmain, FreestyleLineStyle *linestyle_dst, const FreestyleLineStyle *linestyle_src, const int flag) diff --git a/source/blender/blenkernel/intern/mask.c b/source/blender/blenkernel/intern/mask.c index b5742dbdbb7..2a84109c1e0 100644 --- a/source/blender/blenkernel/intern/mask.c +++ b/source/blender/blenkernel/intern/mask.c @@ -849,7 +849,7 @@ Mask *BKE_mask_copy_nolib(Mask *mask) * * WARNING! This function will not handle ID user count! * - * \param flag Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). + * \param flag: Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). */ void BKE_mask_copy_data(Main *UNUSED(bmain), Mask *mask_dst, const Mask *mask_src, const int UNUSED(flag)) { diff --git a/source/blender/blenkernel/intern/material.c b/source/blender/blenkernel/intern/material.c index 3414d08b8e7..5c8ac0a81ce 100644 --- a/source/blender/blenkernel/intern/material.c +++ b/source/blender/blenkernel/intern/material.c @@ -225,7 +225,7 @@ Material *BKE_material_add(Main *bmain, const char *name) * * WARNING! This function will not handle ID user count! * - * \param flag Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). + * \param flag: Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). */ void BKE_material_copy_data(Main *bmain, Material *ma_dst, const Material *ma_src, const int flag) { diff --git a/source/blender/blenkernel/intern/mball.c b/source/blender/blenkernel/intern/mball.c index 9e926e5ef53..84d9cce0d2f 100644 --- a/source/blender/blenkernel/intern/mball.c +++ b/source/blender/blenkernel/intern/mball.c @@ -109,7 +109,7 @@ MetaBall *BKE_mball_add(Main *bmain, const char *name) * * WARNING! This function will not handle ID user count! * - * \param flag Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). + * \param flag: Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). */ void BKE_mball_copy_data(Main *UNUSED(bmain), MetaBall *mb_dst, const MetaBall *mb_src, const int UNUSED(flag)) { diff --git a/source/blender/blenkernel/intern/mesh.c b/source/blender/blenkernel/intern/mesh.c index 5758e00a28d..63477d859e8 100644 --- a/source/blender/blenkernel/intern/mesh.c +++ b/source/blender/blenkernel/intern/mesh.c @@ -491,7 +491,7 @@ Mesh *BKE_mesh_add(Main *bmain, const char *name) * * WARNING! This function will not handle ID user count! * - * \param flag Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). + * \param flag: Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). */ void BKE_mesh_copy_data(Main *bmain, Mesh *me_dst, const Mesh *me_src, const int flag) { @@ -1340,7 +1340,7 @@ void BKE_mesh_mselect_active_set(Mesh *me, int index, int type) /** * Compute 'split' (aka loop, or per face corner's) normals. * - * \param r_lnors_spacearr Allows to get computed loop normal space array. That data, among other things, + * \param r_lnors_spacearr: Allows to get computed loop normal space array. That data, among other things, * contains 'smooth fan' info, useful e.g. to split geometry along sharp edges... */ void BKE_mesh_calc_normals_split_ex(Mesh *mesh, MLoopNorSpaceArray *r_lnors_spacearr) diff --git a/source/blender/blenkernel/intern/mesh_evaluate.c b/source/blender/blenkernel/intern/mesh_evaluate.c index e3b1f20e583..c9119948aa3 100644 --- a/source/blender/blenkernel/intern/mesh_evaluate.c +++ b/source/blender/blenkernel/intern/mesh_evaluate.c @@ -2627,7 +2627,7 @@ void BKE_mesh_loops_to_mface_corners( /** * Convert all CD layers from loop/poly to tessface data. * - * \param loopindices is an array of an int[4] per tessface, mapping tessface's verts to loops indices. + * \param loopindices: is an array of an int[4] per tessface, mapping tessface's verts to loops indices. * * \note when mface is not NULL, mface[face_index].v4 is used to test quads, else, loopindices[face_index][3] is used. */ @@ -3461,9 +3461,9 @@ void BKE_mesh_mdisp_flip(MDisps *md, const bool use_loop_mdisp_flip) * Flip (invert winding of) the given \a mpoly, i.e. reverse order of its loops * (keeping the same vertex as 'start point'). * - * \param mpoly the polygon to flip. - * \param mloop the full loops array. - * \param ldata the loops custom data. + * \param mpoly: the polygon to flip. + * \param mloop: the full loops array. + * \param ldata: the loops custom data. */ void BKE_mesh_polygon_flip_ex( MPoly *mpoly, MLoop *mloop, CustomData *ldata, @@ -3728,11 +3728,11 @@ void BKE_mesh_flush_select_from_verts(Mesh *me) * (\a vert_cos_src, \a vert_cos_dst), * and applies the difference to \a vert_cos_new relative to \a vert_cos_org. * - * \param vert_cos_src reference deform source. - * \param vert_cos_dst reference deform destination. + * \param vert_cos_src: reference deform source. + * \param vert_cos_dst: reference deform destination. * - * \param vert_cos_org reference for the output location. - * \param vert_cos_new resulting coords. + * \param vert_cos_org: reference for the output location. + * \param vert_cos_new: resulting coords. */ void BKE_mesh_calc_relative_deform( const MPoly *mpoly, const int totpoly, diff --git a/source/blender/blenkernel/intern/mesh_mapping.c b/source/blender/blenkernel/intern/mesh_mapping.c index 2d82a5102b0..d8726644f48 100644 --- a/source/blender/blenkernel/intern/mesh_mapping.c +++ b/source/blender/blenkernel/intern/mesh_mapping.c @@ -507,9 +507,9 @@ void BKE_mesh_edge_poly_map_create( * * This has the advantage that it can operate on any data-types. * - * \param totsource The total number of elements the that \a final_origindex points to. - * \param totfinal The size of \a final_origindex - * \param final_origindex The size of the final array. + * \param totsource: The total number of elements the that \a final_origindex points to. + * \param totfinal: The size of \a final_origindex + * \param final_origindex: The size of the final array. * * \note ``totsource`` could be ``totpoly``, * ``totfinal`` could be ``tottessface`` and ``final_origindex`` its ORIGINDEX customdata. @@ -789,7 +789,7 @@ static bool poly_is_island_boundary_smooth_cb( /** * Calculate smooth groups from sharp edges. * - * \param r_totgroup The total number of groups, 1 or more. + * \param r_totgroup: The total number of groups, 1 or more. * \return Polygon aligned array of group index values (bitflags if use_bitflags is true), starting at 1 * (0 being used as 'invalid' flag). * Note it's callers's responsibility to MEM_freeN returned array. diff --git a/source/blender/blenkernel/intern/mesh_validate.c b/source/blender/blenkernel/intern/mesh_validate.c index 82b3edb5b49..09a798f5468 100644 --- a/source/blender/blenkernel/intern/mesh_validate.c +++ b/source/blender/blenkernel/intern/mesh_validate.c @@ -1446,8 +1446,8 @@ void BKE_mesh_calc_edges_legacy(Mesh *me, const bool use_old) /** * Calculate edges from polygons * - * \param mesh The mesh to add edges into - * \param update When true create new edges co-exist + * \param mesh: The mesh to add edges into + * \param update: When true create new edges co-exist */ void BKE_mesh_calc_edges(Mesh *mesh, bool update, const bool select) { diff --git a/source/blender/blenkernel/intern/modifier.c b/source/blender/blenkernel/intern/modifier.c index 723b4a5aa97..b5171258e55 100644 --- a/source/blender/blenkernel/intern/modifier.c +++ b/source/blender/blenkernel/intern/modifier.c @@ -466,7 +466,7 @@ bool modifiers_isParticleEnabled(Object *ob) /** * Check whether is enabled. * - * \param scene Current scene, may be NULL, in which case isDisabled callback of the modifier is never called. + * \param scene: Current scene, may be NULL, in which case isDisabled callback of the modifier is never called. */ bool modifier_isEnabled(struct Scene *scene, ModifierData *md, int required_mode) { diff --git a/source/blender/blenkernel/intern/movieclip.c b/source/blender/blenkernel/intern/movieclip.c index a11b0c62aa8..907ae2f35e2 100644 --- a/source/blender/blenkernel/intern/movieclip.c +++ b/source/blender/blenkernel/intern/movieclip.c @@ -1513,7 +1513,7 @@ void BKE_movieclip_free(MovieClip *clip) * * WARNING! This function will not handle ID user count! * - * \param flag Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). + * \param flag: Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). */ void BKE_movieclip_copy_data(Main *UNUSED(bmain), MovieClip *clip_dst, const MovieClip *clip_src, const int flag) { diff --git a/source/blender/blenkernel/intern/nla.c b/source/blender/blenkernel/intern/nla.c index 2f0af028abd..3a9488df155 100644 --- a/source/blender/blenkernel/intern/nla.c +++ b/source/blender/blenkernel/intern/nla.c @@ -161,7 +161,7 @@ void BKE_nla_tracks_free(ListBase *tracks) /** * Copy NLA strip * - * \param use_same_action When true, the existing action is used (instead of being duplicated) + * \param use_same_action: When true, the existing action is used (instead of being duplicated) */ NlaStrip *BKE_nlastrip_copy(Main *bmain, NlaStrip *strip, const bool use_same_action) { diff --git a/source/blender/blenkernel/intern/node.c b/source/blender/blenkernel/intern/node.c index 2946fb29863..f89163d6339 100644 --- a/source/blender/blenkernel/intern/node.c +++ b/source/blender/blenkernel/intern/node.c @@ -847,7 +847,7 @@ bool nodeIsChildOf(const bNode *parent, const bNode *child) * Iterate over a chain of nodes, starting with \a node_start, executing * \a callback for each node (which can return false to end iterator). * - * \param reversed for backwards iteration + * \param reversed: for backwards iteration * \note Recursive */ void nodeChainIter( @@ -1249,7 +1249,7 @@ bNodeTree *ntreeAddTree(Main *bmain, const char *name, const char *idname) * * WARNING! This function will not handle ID user count! * - * \param flag Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). + * \param flag: Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). */ void BKE_node_tree_copy_data(Main *UNUSED(bmain), bNodeTree *ntree_dst, const bNodeTree *ntree_src, const int flag) { diff --git a/source/blender/blenkernel/intern/object.c b/source/blender/blenkernel/intern/object.c index 5a9ecaa7232..66ea5481af0 100644 --- a/source/blender/blenkernel/intern/object.c +++ b/source/blender/blenkernel/intern/object.c @@ -1110,7 +1110,7 @@ void BKE_object_transform_copy(Object *ob_tar, const Object *ob_src) * * WARNING! This function will not handle ID user count! * - * \param flag Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). + * \param flag: Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). */ void BKE_object_copy_data(Main *UNUSED(bmain), Object *ob_dst, const Object *ob_src, const int flag) { @@ -2014,7 +2014,7 @@ void BKE_object_get_parent_matrix(Scene *scene, Object *ob, Object *par, float p } /** - * \param r_originmat Optional matrix that stores the space the object is in (without its own matrix applied) + * \param r_originmat: Optional matrix that stores the space the object is in (without its own matrix applied) */ static void solve_parenting(Scene *scene, Object *ob, Object *par, float obmat[4][4], float slowmat[4][4], float r_originmat[3][3], const bool set_origin) @@ -3424,8 +3424,8 @@ void BKE_object_groups_clear(Main *bmain, Scene *scene, Base *base, Object *obje * * \note Only mesh objects currently support deforming, others are TODO. * - * \param ob - * \param r_tot + * \param ob: + * \param r_tot: * \return The kdtree or NULL if it can't be created. */ KDTree *BKE_object_as_kdtree(Object *ob, int *r_tot) diff --git a/source/blender/blenkernel/intern/object_deform.c b/source/blender/blenkernel/intern/object_deform.c index 47f86c28dfc..43e84dc2150 100644 --- a/source/blender/blenkernel/intern/object_deform.c +++ b/source/blender/blenkernel/intern/object_deform.c @@ -68,7 +68,7 @@ static Lattice *object_defgroup_lattice_get(ID *id) * * Use it when you remove or reorder vgroups in the object. * - * \param map an array mapping old indices to new indices. + * \param map: an array mapping old indices to new indices. */ void BKE_object_defgroup_remap_update_users(Object *ob, int *map) { diff --git a/source/blender/blenkernel/intern/paint.c b/source/blender/blenkernel/intern/paint.c index dd5d801d2ac..76f18383fe8 100644 --- a/source/blender/blenkernel/intern/paint.c +++ b/source/blender/blenkernel/intern/paint.c @@ -302,7 +302,7 @@ PaintCurve *BKE_paint_curve_add(Main *bmain, const char *name) * * WARNING! This function will not handle ID user count! * - * \param flag Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). + * \param flag: Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). */ void BKE_paint_curve_copy_data(Main *UNUSED(bmain), PaintCurve *pc_dst, const PaintCurve *pc_src, const int UNUSED(flag)) { @@ -391,7 +391,7 @@ Palette *BKE_palette_add(Main *bmain, const char *name) * * WARNING! This function will not handle ID user count! * - * \param flag Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). + * \param flag: Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). */ void BKE_palette_copy_data(Main *UNUSED(bmain), Palette *palette_dst, const Palette *palette_src, const int UNUSED(flag)) { @@ -853,7 +853,7 @@ static bool sculpt_modifiers_active(Scene *scene, Sculpt *sd, Object *ob) } /** - * \param need_mask So the DerivedMesh thats returned has mask data + * \param need_mask: So the DerivedMesh thats returned has mask data */ void BKE_sculpt_update_mesh_elements(Scene *scene, Sculpt *sd, Object *ob, bool need_pmap, bool need_mask) diff --git a/source/blender/blenkernel/intern/particle.c b/source/blender/blenkernel/intern/particle.c index e24602050ef..e2a69c38133 100644 --- a/source/blender/blenkernel/intern/particle.c +++ b/source/blender/blenkernel/intern/particle.c @@ -1433,11 +1433,11 @@ static void psys_origspace_to_w(OrigSpaceFace *osface, int quad, const float w[4 * Find the final derived mesh tessface for a particle, from its original tessface index. * This is slow and can be optimized but only for many lookups. * - * \param dm_final final DM, it may not have the same topology as original mesh. - * \param dm_deformed deformed-only DM, it has the exact same topology as original mesh. - * \param findex_orig the input tessface index. - * \param fw face weights (position of the particle inside the \a findex_orig tessface). - * \param poly_nodes may be NULL, otherwise an array of linked list, one for each final DM polygon, containing all + * \param dm_final: final DM, it may not have the same topology as original mesh. + * \param dm_deformed: deformed-only DM, it has the exact same topology as original mesh. + * \param findex_orig: the input tessface index. + * \param fw: face weights (position of the particle inside the \a findex_orig tessface). + * \param poly_nodes: may be NULL, otherwise an array of linked list, one for each final DM polygon, containing all * its tessfaces indices. * \return the DM tessface index. */ @@ -3374,7 +3374,7 @@ void BKE_particlesettings_twist_curve_init(ParticleSettings *part) * * WARNING! This function will not handle ID user count! * - * \param flag Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). + * \param flag: Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). */ void BKE_particlesettings_copy_data( Main *UNUSED(bmain), ParticleSettings *part_dst, const ParticleSettings *part_src, const int UNUSED(flag)) diff --git a/source/blender/blenkernel/intern/rigidbody.c b/source/blender/blenkernel/intern/rigidbody.c index f485233fe3c..63b1a536d77 100644 --- a/source/blender/blenkernel/intern/rigidbody.c +++ b/source/blender/blenkernel/intern/rigidbody.c @@ -638,7 +638,7 @@ void BKE_rigidbody_calc_center_of_mass(Object *ob, float r_center[3]) /** * Create physics sim representation of object given RigidBody settings * - * \param rebuild Even if an instance already exists, replace it + * \param rebuild: Even if an instance already exists, replace it */ static void rigidbody_validate_sim_object(RigidBodyWorld *rbw, Object *ob, bool rebuild) { @@ -765,7 +765,7 @@ static void rigidbody_constraint_set_limits(RigidBodyCon *rbc, void (*set_limits /** * Create physics sim representation of constraint given rigid body constraint settings * - * \param rebuild Even if an instance already exists, replace it + * \param rebuild: Even if an instance already exists, replace it */ static void rigidbody_validate_sim_constraint(RigidBodyWorld *rbw, Object *ob, bool rebuild) { @@ -1137,7 +1137,7 @@ RigidBodyCon *BKE_rigidbody_create_constraint(Scene *scene, Object *ob, short ty /* Get RigidBody world for the given scene, creating one if needed * - * \param scene Scene to find active Rigid Body world for + * \param scene: Scene to find active Rigid Body world for */ RigidBodyWorld *BKE_rigidbody_get_world(Scene *scene) { @@ -1338,7 +1338,7 @@ static void rigidbody_update_sim_ob(Scene *scene, RigidBodyWorld *rbw, Object *o /** * Updates and validates world, bodies and shapes. * - * \param rebuild Rebuild entire simulation + * \param rebuild: Rebuild entire simulation */ static void rigidbody_update_simulation(Scene *scene, RigidBodyWorld *rbw, bool rebuild) { diff --git a/source/blender/blenkernel/intern/scene.c b/source/blender/blenkernel/intern/scene.c index 3947ca157c0..d038a267308 100644 --- a/source/blender/blenkernel/intern/scene.c +++ b/source/blender/blenkernel/intern/scene.c @@ -226,7 +226,7 @@ void BKE_toolsettings_free(ToolSettings *toolsettings) * * WARNING! This function will not handle ID user count! * - * \param flag Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). + * \param flag: Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). */ void BKE_scene_copy_data(Main *bmain, Scene *sce_dst, const Scene *sce_src, const int flag) { diff --git a/source/blender/blenkernel/intern/sound.c b/source/blender/blenkernel/intern/sound.c index d21055ada6a..9a0317a6648 100644 --- a/source/blender/blenkernel/intern/sound.c +++ b/source/blender/blenkernel/intern/sound.c @@ -161,7 +161,7 @@ void BKE_sound_free(bSound *sound) * * WARNING! This function will not handle ID user count! * - * \param flag Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). + * \param flag: Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). */ void BKE_sound_copy_data(Main *bmain, bSound *sound_dst, const bSound *UNUSED(sound_src), const int UNUSED(flag)) { diff --git a/source/blender/blenkernel/intern/speaker.c b/source/blender/blenkernel/intern/speaker.c index 1d2e12f34ac..7c92844ac2e 100644 --- a/source/blender/blenkernel/intern/speaker.c +++ b/source/blender/blenkernel/intern/speaker.c @@ -73,7 +73,7 @@ void *BKE_speaker_add(Main *bmain, const char *name) * * WARNING! This function will not handle ID user count! * - * \param flag Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). + * \param flag: Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). */ void BKE_speaker_copy_data(Main *UNUSED(bmain), Speaker *UNUSED(spk_dst), const Speaker *UNUSED(spk_src), const int UNUSED(flag)) { diff --git a/source/blender/blenkernel/intern/text.c b/source/blender/blenkernel/intern/text.c index 63b9f838632..dbbdf1d5f65 100644 --- a/source/blender/blenkernel/intern/text.c +++ b/source/blender/blenkernel/intern/text.c @@ -476,7 +476,7 @@ Text *BKE_text_load(Main *bmain, const char *file, const char *relpath) * * WARNING! This function will not handle ID user count! * - * \param flag Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). + * \param flag: Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). */ void BKE_text_copy_data(Main *UNUSED(bmain), Text *ta_dst, const Text *ta_src, const int UNUSED(flag)) { diff --git a/source/blender/blenkernel/intern/texture.c b/source/blender/blenkernel/intern/texture.c index bd6199d91b4..f21172b937d 100644 --- a/source/blender/blenkernel/intern/texture.c +++ b/source/blender/blenkernel/intern/texture.c @@ -494,7 +494,7 @@ MTex *BKE_texture_mtex_add_id(ID *id, int slot) * * WARNING! This function will not handle ID user count! * - * \param flag Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). + * \param flag: Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). */ void BKE_texture_copy_data(Main *bmain, Tex *tex_dst, const Tex *tex_src, const int flag) { diff --git a/source/blender/blenkernel/intern/world.c b/source/blender/blenkernel/intern/world.c index a44d717bbdd..19bc7bff8d1 100644 --- a/source/blender/blenkernel/intern/world.c +++ b/source/blender/blenkernel/intern/world.c @@ -124,7 +124,7 @@ World *BKE_world_add(Main *bmain, const char *name) * * WARNING! This function will not handle ID user count! * - * \param flag Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). + * \param flag: Copying options (see BKE_library.h's LIB_ID_COPY_... flags for more). */ void BKE_world_copy_data(Main *bmain, World *wrld_dst, const World *wrld_src, const int flag) { |