Class names with first letter Uppercase and internal +Class names with first letter Uppercase and internal uppercase to separate compound words.\n -
Function members of classes follow the same rule.
+Function members of classes follow the same rule. -Example:
+Example: \code Point3f { - public: + public: ScalarType &V(const int i); } \endcode -Public Variable members has the first letter -lowercase and internal uppercase to separate compound words.
+Public Variable members has the first letter +lowercase and internal uppercase to separate compound words. -Example:
+Example: -Private Variable members has an underscore as first char and +Private Variable members has an underscore as first char and the first letter lowercase and internal uppercase to separate compound -words.
+words. -Example:
+Example:
Point3f
@@ -40,65 +42,62 @@ words.
}
-Class Template Arguments all capitalized and with names
+Class Template Arguments all capitalized and with names
remembering where they have been defined.
Class TypeDefs used for templated Class arguments or for shortness are just like Class Names,
-but ending with “Type”, “Iterator”, “Pointer”, or “Container”.
Example:
+Example:
typedef typename VertexType::CoordType CoordType;
typedef typename VertContainer::iterator VertexIterator;
-
+
-Header filenames and folders always fully lower case. Compound names -are separated by '_'.
+Example:
+Example: -- #include<vcg/space/point3.h> -+ #include
Each include file must begin with the standard legal +Each include file must begin with the standard legal disclamier/license intestation and report in the first line of history -the $LOG$ cvs string.
+the $LOG$ cvs string. -The following automatically generated history can be, from time to -time, compressed and shortened to save space.
+The following automatically generated history can be, from time to +time, compressed and shortened to save space. -Each file of the library has to include all the files that it +Each file of the library has to include all the files that it requires. A include file should rely on the files included by its own -include files. Example: in vcg/space/box3.h:
+include files. Example: in vcg/space/box3.h: -- #include<vcg/math/base.h> // not necessary because included by point3.h - #include<vcg/space/point3.h> -+ #include
In Class definitions place all the prototypes all together before -the inline or templated implementations.
-Tabs are equivalent to two spaces.
+There are no strict rules for the placement of '{' or indenting.
+Tabs are equivalent to two spaces. -All basic classes (point3, box3 ecc) must have null +
Implicit casting is disallowed. Write a member Import function for
+Implicit casting is disallowed. Write a member Import function for
casting from different integral types and a static.
-Construct to build an object from different a integral type.
Example:
+Example:
Point3f pf(1.0f,0.0f,0.0f);
@@ -106,10 +105,7 @@ Construct to build an object from different a integral type.
pf.Import(pd);
-All the classes, algorithms and functions MUST be documented using Doxygen. Please add a short intro before each class explaining design choices and for non trivial classes give some short usage example. For complex classes try to group similar members under categories. Non trivial algorithms should refer the paper/book where they are explained.
-Namespaces and files should be also documented trying to explain how the file/namespace partitioning works. -
-