]> SALOME platform Git repositories - modules/geom.git/commitdiff
Salome HOME
documentation
authorfps <fps@opencascade.com>
Wed, 11 Sep 2013 13:39:07 +0000 (13:39 +0000)
committerfps <fps@opencascade.com>
Wed, 11 Sep 2013 13:39:07 +0000 (13:39 +0000)
14 files changed:
src/XAO/XAO_BooleanField.hxx
src/XAO/XAO_BooleanStep.hxx
src/XAO/XAO_BrepGeometry.hxx
src/XAO/XAO_DoubleField.hxx
src/XAO/XAO_DoubleStep.hxx
src/XAO/XAO_Geometry.hxx
src/XAO/XAO_IntegerField.hxx
src/XAO/XAO_IntegerStep.hxx
src/XAO/XAO_Step.hxx
src/XAO/XAO_StringField.hxx
src/XAO/XAO_StringStep.hxx
src/XAO/XAO_Xao.hxx
src/XAO/XAO_XaoExporter.hxx
src/XAO/XAO_XaoUtils.hxx

index eefb492347d668b82589382c00bb75b769fe71df..33a9baf433ec12e3d8fb6b06fbdffecf0446db0b 100644 (file)
 
 namespace XAO
 {
+    /**
+     * @class BooleanField
+     * Represents a field with boolean values.
+     */
     class BooleanField : public Field
     {
     public:
+        /**
+         * Constructor.
+         * @param name the name of the field.
+         * @param dimension the dimension of the field.
+         * @param nbElements the number of elements.
+         * @param nbComponents the number of components.
+         */
         BooleanField(const std::string& name, const XAO::Dimension& dimension, const int& nbElements, const int& nbComponents);
 
         virtual const XAO::Type getType() { return XAO::BOOLEAN; }
 
         virtual Step* addNewStep(const int& step);
+
+        /**
+         * Adds a new step.
+         * @param step the number of the step.
+         * @return the newly created step.
+         */
         BooleanStep* addStep(const int& step);
+
+        /**
+         * Adds a new step.
+         * @param step the number of the step.
+         * @param stamp the stamp of the step.
+         * @return the newly created step.
+         */
         BooleanStep* addStep(const int& step, const int& stamp);
+
+        /**
+         * Gets the step of given index.
+         * @param index the index.
+         * @return the step for the given index.
+         */
         BooleanStep* getStep(const int& index);
     };
 }
index 4f514407a4e8856ff55aca64f0c76a156cf62995..e4a057ff99e9c644c0ef92c3b9707990e1e3880a 100644 (file)
 
 namespace XAO
 {
+    /**
+     * @class BooleanStep
+     * Step with boolean values.
+     */
     class BooleanStep : public Step
     {
     public:
+        /**
+         * Constructor.
+         * @param step the step number.
+         * @param stamp the stamp of the step.
+         * @param nbElements the number elements of the geometry.
+         * @param nbComponents the number of components of the field.
+         */
         BooleanStep(const int& step, const int& stamp, const int& nbElements, const int& nbComponents);
 
         virtual const XAO::Type getType() { return XAO::BOOLEAN; }
@@ -64,9 +75,32 @@ namespace XAO
          */
         const bool getValue(const int& element, const int& component);
 
+        /**
+         * Sets all the values from a list.
+         * @param values the list of values to set.
+         */
         void setValues(const std::vector<bool>& values);
+
+        /**
+         * Sets the values for an element.
+         * @param element the index of the element to set.
+         * @param elements the values to set.
+         */
         void setElements(const int& element, const std::vector<bool>& elements);
+
+        /**
+         * Sets the values for a component.
+         * @param component the index of the component to set.
+         * @param components the values to set.
+         */
         void setComponents(const int& component, const std::vector<bool>& components);
+
+        /**
+         * Sets the value for an element and a component.
+         * @param element the index of the element.
+         * @param component the index of the component.
+         * @param value the value.
+         */
         void setValue(const int& element, const int& component, const bool& value);
 
         virtual const std::string getStringValue(const int& element, const int& component);
index 16561b8a35569bfe48af2a5ae921286807f220ac..f2288606fe49ae25306a8fa2eb74361e59b73614 100644 (file)
 
 namespace XAO
 {
+    /**
+     * @class BrepGeometry
+     * Representation of a BRep Geometry.
+     */
     class BrepGeometry : public Geometry
     {
     public:
+        /**
+         * Default Constructor.
+         */
         BrepGeometry();
+
+        /**
+         * Constructor.
+         * @param name the name of the geometry.
+         */
         BrepGeometry(const std::string& name);
 
+        /**
+         * Gets the format of the geometry.
+         * @return the format of the geometry.
+         */
         virtual const XAO::Format getFormat() { return XAO::BREP; }
 
+        /**
+         * Gets the shape as a string.
+         * @return the shape as a string.
+         */
         virtual const std::string getShape();
+
+        /**
+         * Sets the shape from a string.
+         * @param shape the shape as a string.
+         */
         virtual void setShape(const std::string& shape);
 
+        /**
+         * Gets the shape as a TopoDS_Shape.
+         * @return the TopoDS_Shape.
+         */
         TopoDS_Shape getTopoDS_Shape();
+
+        /**
+         * Sets the shape from a TopoDS_Shape.
+         * @param shape the TopoDS_Shape to set.
+         */
         void setTopoDS_Shape(const TopoDS_Shape& shape);
 
         /**
@@ -94,56 +128,79 @@ namespace XAO
 
         /**
          * Gets the length of an edge.
-         * @param edge the index of the edge.
+         * @param index the index of the edge.
          * @return the length of the edge.
          */
         const double getEdgeLength(const int& index);
 
         /**
          * Gets the are of a face.
-         * @param face the index of a face.
+         * @param index the index of a face.
          * @return the area of the face.
          */
         const double getFaceArea(const int& index);
 
         /**
          * Gets the volume of a solid.
-         * @param solid the index of the solid.
+         * @param index the index of the solid.
          * @return the volume of the solid.
          */
         const double getSolidVolume(const int& index);
 
         /**
          * Gets the ID of a vertex.
-         * @param vertex the index of the vertex.
+         * @param index the index of the vertex.
          * @return the ID of the vertex.
          */
         const int getVertexID(const int& index);
 
         /**
          * Gets the ID of an edge.
-         * @param edge the index of the edge.
+         * @param index the index of the edge.
          * @return the ID of the edge.
          */
         const int getEdgeID(const int& index);
 
         /**
          * Gets the ID of a face.
-         * @param face the index of the face.
+         * @param index the index of the face.
          * @return the ID of the face.
          */
         const int getFaceID(const int& index);
 
         /**
          * Gets the ID of a solid.
-         * @param solid the index of the solid.
+         * @param index the index of the solid.
          * @return the ID of the solid.
          */
-        const int getSolidID(const int& solid);
+        const int getSolidID(const int& index);
 
+        /**
+         * Sets the ID of a vertex.
+         * @param index the index of the vertex to set.
+         * @param id the id to set.
+         */
         void setVertexID(const int& index, const int& id);
+
+        /**
+         * Sets the ID of an edge.
+         * @param index the index of the edge to set.
+         * @param id the id to set.
+         */
         void setEdgeID(const int& index, const int& id);
+
+        /**
+         * Sets the ID of a face.
+         * @param index the index of the face to set.
+         * @param id the id to set.
+         */
         void setFaceID(const int& index, const int& id);
+
+        /**
+         * Sets the ID of a solid.
+         * @param index the index of the solid to set.
+         * @param id the id to set.
+         */
         void setSolidID(const int& index, const int& id);
 
         /**
index 383ff0ca8e4b01808a024ef4b838ff88f14d569a..efbffb8419dcf15aa58d4207b44c75613192e9db 100644 (file)
 
 namespace XAO
 {
+    /**
+     * @class DoubleField
+     * Represents a field with double values.
+     */
     class DoubleField : public Field
     {
     public:
+        /**
+         * Constructor.
+         * @param name the name of the field.
+         * @param dimension the dimension of the field.
+         * @param nbElements the number of elements.
+         * @param nbComponents the number of components.
+         */
         DoubleField(const std::string& name, const XAO::Dimension& dimension, const int& nbElements, const int& nbComponents);
 
         virtual const XAO::Type getType() { return XAO::DOUBLE; }
 
         virtual Step* addNewStep(const int& step);
+
+        /**
+         * Adds a new step.
+         * @param step the number of the step.
+         * @return the newly created step.
+         */
         DoubleStep* addStep(const int& step);
+
+        /**
+         * Adds a new step.
+         * @param step the number of the step.
+         * @param stamp the stamp of the step.
+         * @return the newly created step.
+         */
         DoubleStep* addStep(const int& step, const int& stamp);
+
+        /**
+         * Gets the step of given index.
+         * @param index the index.
+         * @return the step for the given index.
+         */
         DoubleStep* getStep(const int& index);
     };
 }
index d5301aafec8774865f20207d6b92bd224b595395..c0be2c17772d23ac4c3f7cceecd8bfc7034f61b2 100644 (file)
 
 namespace XAO
 {
+    /**
+     * @class DoubleStep
+     * Step with double values.
+     */
     class DoubleStep : public Step
     {
     public:
+        /**
+         * Constructor.
+         * @param step the step number.
+         * @param stamp the stamp of the step.
+         * @param nbElements the number elements of the geometry.
+         * @param nbComponents the number of components of the field.
+         */
         DoubleStep(const int& step, const int& stamp, const int& nbElements, const int& nbComponents);
 
         virtual const XAO::Type getType() { return XAO::DOUBLE; }
 
+        /**
+         * Gets all the values of the step as a list.
+         * @return a vector containing all the values of the step.
+         */
         std::vector<double> getValues();
+
+        /**
+         * Gets all the values for a given element.
+         * @param element the index of the element.
+         * @return a vector containing all the values for the given element.
+         */
         std::vector<double> getElement(const int& element);
+
+        /**
+         * Gets all the values for a given component.
+         * @param component the index of the component.
+         * @return a vector containing all the values for the given component.
+         */
         std::vector<double> getComponent(const int& component);
 
+        /**
+         * Gets the value for an element and a component.
+         * @param element the index of the element.
+         * @param component the index of the component.
+         * @return the value for the given element and component.
+         */
         const double getValue(const int& element, const int& component);
 
+        /**
+         * Sets all the values from a list.
+         * @param values the list of values to set.
+         */
         void setValues(const std::vector<double>& values);
+
+        /**
+         * Sets the values for an element.
+         * @param element the index of the element to set.
+         * @param elements the values to set.
+         */
         void setElements(const int& element, const std::vector<double>& elements);
+
+        /**
+         * Sets the values for a component.
+         * @param component the index of the component to set.
+         * @param components the values to set.
+         */
         void setComponents(const int& component, const std::vector<double>& components);
+
+        /**
+         * Sets the value for an element and a component.
+         * @param element the index of the element.
+         * @param component the index of the component.
+         * @param value the value.
+         */
         void setValue(const int& element, const int& component, const double& value);
 
         virtual const std::string getStringValue(const int& element, const int& component);
index 9f20fbcaaf5cf08b395ae7dadeab9000fb5304fb..6adb5c7acabaef81033ac8d593e7999fb4554329 100644 (file)
 
 namespace XAO
 {
+    /**
+     * @class Geometry
+     * Base class for geometries.
+     */
     class Geometry
     {
     protected:
+        /**
+         * Constructor.
+         * @param name the name of the Geometry.
+         */
         Geometry(const std::string& name);
 
     public:
index 807592e7f3644689dfa712efa5a22f9429521baa..4c3e22e50c393e8f250c5009b1cd74dab446607b 100644 (file)
 
 namespace XAO
 {
+    /**
+     * @class IntegerField
+     * Represents a field with integer values.
+     */
     class IntegerField : public Field
     {
     public:
+        /**
+         * Constructor.
+         * @param name the name of the field.
+         * @param dimension the dimension of the field.
+         * @param nbElements the number of elements.
+         * @param nbComponents the number of components.
+         */
         IntegerField(const std::string& name, const XAO::Dimension& dimension, const int& nbElements, const int& nbComponents);
 
         virtual const XAO::Type getType() { return XAO::INTEGER; }
 
         virtual Step* addNewStep(const int& step);
+
+        /**
+         * Adds a new step.
+         * @param step the number of the step.
+         * @return the newly created step.
+         */
         IntegerStep* addStep(const int& step);
+
+        /**
+         * Adds a new step.
+         * @param step the number of the step.
+         * @param stamp the stamp of the step.
+         * @return the newly created step.
+         */
         IntegerStep* addStep(const int& step, const int& stamp);
-        IntegerStep* getStep(const int& step);
+
+        /**
+         * Gets the step of given index.
+         * @param index the index of the step.
+         * @return the step for the given index.
+         */
+        IntegerStep* getStep(const int& index);
     };
 }
 
index 8c3f6593936917c6a997da2244e39a86ef8c2213..692fa28de8573432f968eea7c14fcb51ed18a54a 100644 (file)
 
 namespace XAO
 {
+    /**
+     * @class IntegerStep
+     * Step with integer values.
+     */
     class IntegerStep : public Step
     {
     public:
+        /**
+         * Constructor.
+         * @param step the step number.
+         * @param stamp the stamp of the step.
+         * @param nbElements the number elements of the geometry.
+         * @param nbComponents the number of components of the field.
+         */
         IntegerStep(const int& step, const int& stamp, const int& nbElements, const int& nbComponents);
 
         virtual const XAO::Type getType() { return XAO::INTEGER; }
 
+        /**
+         * Gets all the values of the step as a list.
+         * @return a vector containing all the values of the step.
+         */
         std::vector<int> getValues();
+
+        /**
+         * Gets all the values for a given element.
+         * @param element the index of the element.
+         * @return a vector containing all the values for the given element.
+         */
         std::vector<int> getElement(const int& element);
+
+        /**
+         * Gets all the values for a given component.
+         * @param component the index of the component.
+         * @return a vector containing all the values for the given component.
+         */
         std::vector<int> getComponent(const int& component);
 
+        /**
+         * Gets the value for an element and a component.
+         * @param element the index of the element.
+         * @param component the index of the component.
+         * @return the value for the given element and component.
+         */
         const int getValue(const int& element, const int& component);
 
+        /**
+         * Sets all the values from a list.
+         * @param values the list of values to set.
+         */
         void setValues(const std::vector<int>& values);
+
+        /**
+         * Sets the values for an element.
+         * @param element the index of the element to set.
+         * @param elements the values to set.
+         */
         void setElements(const int& element, const std::vector<int>& elements);
-        void setComponents(const int& element, const std::vector<int>& components);
+
+        /**
+         * Sets the values for a component.
+         * @param component the index of the component to set.
+         * @param components the values to set.
+         */
+        void setComponents(const int& component, const std::vector<int>& components);
+
+        /**
+         * Sets the value for an element and a component.
+         * @param element the index of the element.
+         * @param component the index of the component.
+         * @param value the value.
+         */
         void setValue(const int& element, const int& component, const int& value);
 
         virtual const std::string getStringValue(const int& element, const int& component);
index 4ebf27a55b205085947754ab963700a08ac6a7c1..bc9eb740612b1bd384628ab29a171c143d7aefb1 100644 (file)
 
 namespace XAO
 {
+    /**
+     * @class Step
+     * Base class for steps.
+     */
     class Step
     {
     protected:
@@ -104,11 +108,33 @@ namespace XAO
         virtual void setStringValue(const int& element, const int& component, const std::string& value) = 0;
 
     protected:
+        /**
+         * Checks that given element index is in the range of element indexes.
+         * @param element the index to check.
+         */
         void checkElementIndex(const int& element);
+        /**
+         * Checks that given component index is in the range of component indexes.
+         * @param component the index to check.
+         */
         void checkComponentIndex(const int& component);
 
+        /**
+         * Checks that the given number of elements is correct.
+         * @param nbElements the number of elements to check.
+         */
         void checkNbElements(const int& nbElements);
+
+        /**
+         * Checks that the given number of components is correct.
+         * @param nbComponents the number of components to check.
+         */
         void checkNbComponents(const int& nbComponents);
+
+        /**
+         * checks that the given number of values is correct.
+         * @param nbValues the number of values to check.
+         */
         void checkNbValues(const int& nbValues);
 
     protected:
index 7257f8df693e4d32d54ac596750709a032d2ba71..4c60daa027d04629d7aad18e14707d48eb73037a 100644 (file)
 
 namespace XAO
 {
+    /**
+     * @class StringField
+     * Represents a field with string values.
+     */
     class StringField : public Field
     {
     public:
+        /**
+         * Constructor.
+         * @param name the name of the field.
+         * @param dimension the dimension of the field.
+         * @param nbElements the number of elements.
+         * @param nbComponents the number of components.
+         */
         StringField(const std::string& name, const XAO::Dimension& dimension, const int& nbElements, const int& nbComponents);
 
         virtual const XAO::Type getType() { return XAO::STRING; }
 
         virtual Step* addNewStep(const int& step);
+
+        /**
+         * Adds a new step.
+         * @param step the number of the step.
+         * @return the newly created step.
+         */
         StringStep* addStep(const int& step);
+
+        /**
+         * Adds a new step.
+         * @param step the number of the step.
+         * @param stamp the stamp of the step.
+         * @return the newly created step.
+         */
         StringStep* addStep(const int& step, const int& stamp);
+
+        /**
+         * Gets the step of given index.
+         * @param index the index of the step.
+         * @return the step for the given index.
+         */
         StringStep* getStep(const int& index);
     };
 }
index cce7271b52de94346e8e4a3cdb0407033a40af20..43e72b1ba2bd07a6d192bbf0a5a29d9ee035a7a8 100644 (file)
 
 namespace XAO
 {
+    /**
+     * @class StringStep
+     * Step with strings values.
+     */
     class StringStep : public Step
     {
     public:
-        StringStep(const int& nbElements, const int& nbComponents);
-        StringStep(const int& step, const int& nbElements, const int& nbComponents);
+        /**
+         * Constructor.
+         * @param step the step number.
+         * @param stamp the stamp of the step.
+         * @param nbElements the number elements of the geometry.
+         * @param nbComponents the number of components of the field.
+         */
         StringStep(const int& step, const int& stamp, const int& nbElements, const int& nbComponents);
 
         virtual const XAO::Type getType() { return XAO::STRING; }
 
+        /**
+         * Gets all the values of the step as a list.
+         * @return a vector containing all the values of the step.
+         */
         std::vector<std::string> getValues();
+
+        /**
+         * Gets all the values for a given element.
+         * @param element the index of the element.
+         * @return a vector containing all the values for the given element.
+         */
         std::vector<std::string> getElement(const int& element);
+
+        /**
+         * Gets all the values for a given component.
+         * @param component the index of the component.
+         * @return a vector containing all the values for the given component.
+         */
         std::vector<std::string> getComponent(const int& component);
 
+        /**
+         * Gets the value for an element and a component.
+         * @param element the index of the element.
+         * @param component the index of the component.
+         * @return the value for the given element and component.
+         */
         const std::string getValue(const int& element, const int& component);
 
+        /**
+         * Sets all the values from a list.
+         * @param values the list of values to set.
+         */
         void setValues(const std::vector<std::string>& values);
+
+        /**
+         * Sets the values for an element.
+         * @param element the index of the element to set.
+         * @param elements the values to set.
+         */
         void setElements(const int& element, const std::vector<std::string>& elements);
+
+        /**
+         * Sets the values for a component.
+         * @param component the index of the component to set.
+         * @param components the values to set.
+         */
         void setComponents(const int& component, const std::vector<std::string>& components);
+
+        /**
+         * Sets the value for an element and a component.
+         * @param element the index of the element.
+         * @param component the index of the component.
+         * @param value the value.
+         */
         void setValue(const int& element, const int& component, const std::string& value);
 
         virtual const std::string getStringValue(const int& element, const int& component);
index b96d2774ac5de5435e4ef402ef25c1368fed8b80..e9fc6231ce006797c8b9a6eea54b14ee73af17d2 100644 (file)
@@ -27,7 +27,7 @@
 namespace XAO
 {
     /**
-     * @enum CAD
+     * @enum Format
      */
     enum Format
     {
@@ -200,7 +200,7 @@ namespace XAO
         /**
          * Adds a field.
          * \param type the type of the field.
-         * \param the name of the field.
+         * \param name the name of the field.
          * \param dim the dimension of the field.
          * \param nbComponents the number of components in the field.
          * \return the created field.
index 510572d09a0ecb994c6f23e42e5881c64cf82084..844c8dcb00e5e5e3a00a5f95d0c0cc2d46d1ebe4 100644 (file)
 
 namespace XAO
 {
+    /**
+     * @class XaoExporter
+     * Util class for import/export XAO.
+     */
     class XaoExporter
     {
     public:
+        /**
+         * Saves the XAO object to a file.
+         * @param xaoObject the object to export.
+         * @param fileName the path of the file to create.
+         * @return true if the export was successful, false otherwise.
+         */
         static const bool saveToFile(Xao* xaoObject, const std::string& fileName);
+
+        /**
+         * Saves the XAO object to a XML string.
+         * @param xaoObject the object to export.
+         * @return the XML string.
+         */
         static const std::string saveToXml(Xao* xaoObject);
 
+        /**
+         * Reads a XAO object from a file.
+         * @param fileName the path of the file to read.
+         * @param xaoObject the XAO object.
+         * @return true if the XAO object was read successful, false otherwise.
+         */
         static const bool readFromFile(const std::string& fileName, Xao* xaoObject);
+
+        /**
+         * Reads a XAO object from an XML string.
+         * @param xml the XML string.
+         * @param xaoObject the XAO object.
+         * @return true if the XAO object was read successful, false otherwise.
+         */
         static const bool setXML(const std::string& xml, Xao* xaoObject);
 
     private:
index c9088a636aec060f2bde3effc2067b2d175d524e..ad41663cec669964629a802ba35e900386a74c7c 100644 (file)
@@ -125,12 +125,19 @@ namespace XAO
         static const XAO::Format stringToShapeFormat(const std::string& format);
     };
 
+    /**
+     * @class MsgBuilder
+     * MsgBuilder can be use to easily create messages.
+     */
     class MsgBuilder
     {
     public:
+        /** Constructor. */
         MsgBuilder() {};
+        /** Destructor. */
         ~MsgBuilder() {};
 
+        /** Stream operator. */
         template <typename T>
         MsgBuilder& operator <<(const T& t)
         {
@@ -138,6 +145,9 @@ namespace XAO
             return *this;
         }
 
+        /**
+         * Conversion operator to char*.
+         */
         operator const char*() const   { return m_stream.str().c_str(); }
 
     private :