diff options
author | Campbell Barton <ideasman42@gmail.com> | 2012-03-04 00:19:11 +0400 |
---|---|---|
committer | Campbell Barton <ideasman42@gmail.com> | 2012-03-04 00:19:11 +0400 |
commit | 95670e03a01d30cda5a0f685974f28790be6809d (patch) | |
tree | e6d5756cbe51edb083cda2fceff087bda35c361a /source/blender/blenkernel/BKE_DerivedMesh.h | |
parent | a2c182e9233333fc3b8ff40d352113ec95e7e30c (diff) |
style cleanup / comment formatting for bli/bke/bmesh
Diffstat (limited to 'source/blender/blenkernel/BKE_DerivedMesh.h')
-rw-r--r-- | source/blender/blenkernel/BKE_DerivedMesh.h | 78 |
1 files changed, 39 insertions, 39 deletions
diff --git a/source/blender/blenkernel/BKE_DerivedMesh.h b/source/blender/blenkernel/BKE_DerivedMesh.h index dff783c1b9b..116b3e05a8e 100644 --- a/source/blender/blenkernel/BKE_DerivedMesh.h +++ b/source/blender/blenkernel/BKE_DerivedMesh.h @@ -29,37 +29,37 @@ #define __BKE_DERIVEDMESH_H__ /* - Basic design of the DerivedMesh system: - - DerivedMesh is a common set of interfaces for mesh systems. - - There are three main mesh data structures in Blender: Mesh, CDDM, and BMesh. - These, and a few others, all implement DerivedMesh interfaces, - which contains unified drawing interfaces, a few utility interfaces, - and a bunch of read-only interfaces intended mostly for conversion from - one format to another. - - All Mesh structures in blender make use of CustomData, which is used to store - per-element attributes and interpolate them (e.g. uvs, vcols, vgroups, etc). - - Mesh is the "serialized" structure, used for storing object-mode mesh data - and also for saving stuff to disk. It's interfaces are also what DerivedMesh - uses to communicate with. - - CDDM is a little mesh library, that uses Mesh data structures in the backend. - It's mostly used for modifiers, and has the advantages of not taking much - resources. - - BMesh is a full-on brep, used for editmode, some modifiers, etc. It's much - more capable (if memory-intensive) then CDDM. - - DerivedMesh is somewhat hackish. Many places assumes that a DerivedMesh is - a CDDM (most of the time by simply copying it and converting it to one). - CDDM is the original structure for modifiers, but has since been superseded - by BMesh, at least for the foreseeable future. -*/ - -/* + * Basic design of the DerivedMesh system: + * + * DerivedMesh is a common set of interfaces for mesh systems. + * + * There are three main mesh data structures in Blender: Mesh, CDDM, and BMesh. + * These, and a few others, all implement DerivedMesh interfaces, + * which contains unified drawing interfaces, a few utility interfaces, + * and a bunch of read-only interfaces intended mostly for conversion from + * one format to another. + * + * All Mesh structures in blender make use of CustomData, which is used to store + * per-element attributes and interpolate them (e.g. uvs, vcols, vgroups, etc). + * + * Mesh is the "serialized" structure, used for storing object-mode mesh data + * and also for saving stuff to disk. It's interfaces are also what DerivedMesh + * uses to communicate with. + * + * CDDM is a little mesh library, that uses Mesh data structures in the backend. + * It's mostly used for modifiers, and has the advantages of not taking much + * resources. + * + * BMesh is a full-on brep, used for editmode, some modifiers, etc. It's much + * more capable (if memory-intensive) then CDDM. + * + * DerivedMesh is somewhat hackish. Many places assumes that a DerivedMesh is + * a CDDM (most of the time by simply copying it and converting it to one). + * CDDM is the original structure for modifiers, but has since been superseded + * by BMesh, at least for the foreseeable future. + */ + +/* * Note: This sturcture is read-only, for all practical purposes. * At some point in the future, we may want to consider * creating a replacement structure that implements a proper @@ -98,9 +98,9 @@ struct PBVH; #define SUB_ELEMS_FACE 50 /* -Note: all mface interfaces now officially operate on tesselated data. - Also, the mface origindex layer indexes mpolys, not mfaces. -*/ + * Note: all mface interfaces now officially operate on tesselated data. + * Also, the mface origindex layer indexes mpolys, not mfaces. + */ typedef struct DMGridData { float co[3]; @@ -199,8 +199,8 @@ struct DerivedMesh { void *(*getEdgeDataArray)(DerivedMesh *dm, int type); void *(*getTessFaceDataArray)(DerivedMesh *dm, int type); - /*retrieves the base CustomData structures for - verts/edges/tessfaces/loops/facdes*/ + /* retrieves the base CustomData structures for + * verts/edges/tessfaces/loops/facdes*/ CustomData *(*getVertDataLayout)(DerivedMesh *dm); CustomData *(*getEdgeDataLayout)(DerivedMesh *dm); CustomData *(*getTessFaceDataLayout)(DerivedMesh *dm); @@ -576,8 +576,8 @@ void DM_interp_poly_data(struct DerivedMesh *source, struct DerivedMesh *dest, void vDM_ColorBand_store(struct ColorBand *coba); /* Simple function to get me->totvert amount of vertices/normals, - correctly deformed and subsurfered. Needed especially when vertexgroups are involved. - In use now by vertex/weigt paint and particles */ + * correctly deformed and subsurfered. Needed especially when vertexgroups are involved. + * In use now by vertex/weigt paint and particles */ float *mesh_get_mapped_verts_nors(struct Scene *scene, struct Object *ob); /* */ @@ -625,7 +625,7 @@ void makeDerivedMesh(struct Scene *scene, struct Object *ob, struct BMEditMesh * CustomDataMask dataMask, int build_shapekey_layers); /* returns an array of deform matrices for crazyspace correction, and the - number of modifiers left */ + * number of modifiers left */ int editbmesh_get_first_deform_matrices(struct Scene *, struct Object *, struct BMEditMesh *em, float (**deformmats)[3][3], float (**deformcos)[3]); |