Add IPC sync result for SerialPort::Write()
[platform/framework/native/appfw.git] / inc / FBaseFloatMatrix3.h
index afa0785..ed340f7 100644 (file)
@@ -36,7 +36,7 @@ namespace Tizen { namespace Base
  *
  * @since 2.0
  *
- * The %FloatMatrix3 class provides a @c float precision, two-dimensional matrix.
+ * The %FloatMatrix3 class provides a @c float precision, two-dimensional matrix class.
  *
  */
 class _OSP_EXPORT_ FloatMatrix3
@@ -45,7 +45,7 @@ class _OSP_EXPORT_ FloatMatrix3
 public:
        /**
         * This is the default constructor for this class. @n
-        * Constructs a 3 X 3 null matrix in which all the elements are zero.
+        * Constructs a 3 X 3 null matrix in which all elements are zero.
         *
         * @since 2.0
         */
@@ -56,7 +56,7 @@ public:
         *
         * @since 2.0
         *
-        * @param[in]   rhs     An instance of %FloatMatrix3 to copy
+        * @param[in]   rhs     An instance of %FloatMatrix3
         */
        FloatMatrix3(const FloatMatrix3& rhs);
 
@@ -81,7 +81,7 @@ public:
         *
         * @since 2.0
         *
-        * @return      @c true if all the matrix members of the current instance are equal to the corresponding matrix members in the specified instance, @n
+        * @return      @c true if all matrix members of the current instance are equal to the corresponding matrix members in the specified instance, @n
         *                      else @c false
         * @param[in]   rhs     An instance of %FloatMatrix3
         */
@@ -92,7 +92,7 @@ public:
         *
         * @since 2.0
         *
-        * @return      @c true if all the matrix members of the current instance are not equal to the corresponding matrix members in the specified instance, @n
+        * @return      @c true if all matrix members of the current instance are not equal to the corresponding matrix members in the specified instance, @n
         *                      else @c false
         * @param[in]   rhs     An instance of %FloatMatrix3
         */
@@ -103,8 +103,8 @@ public:
         *
         * @since 2.0
         *
-        * @return      A reference to this instance
-        * @param[in]   rhs     An instance of %FloatMatrix3 to copy
+        * @return      The reference to this instance
+        * @param[in]   rhs     An instance of %FloatMatrix3
         */
        FloatMatrix3& operator =(const FloatMatrix3& rhs);
 
@@ -113,8 +113,8 @@ public:
         *
         * @since 2.0
         *
-        * @return      A reference to this instance
-        * @param[in]   value   The @c float value to assign
+        * @return      The reference to this instance
+        * @param[in]   value   A @c float value to assign
         */
        FloatMatrix3& operator =(float value);
 
@@ -123,38 +123,38 @@ public:
         *
         * @since 2.0
         *
-        * @return              A new instance of %FloatMatrix3 that contains the resulting value of the operation
+        * @return      A new instance of %FloatMatrix3 containing the resulting value of the operation
         * @param[in]   rhs     An instance of %FloatMatrix3
         */
        FloatMatrix3 operator *(const FloatMatrix3& rhs) const;
 
        /**
-        * Multiplies the value to each matrix member of the current instance of %FloatMatrix3.
+        * Multiplies the value to each matrix members of current instance of %FloatMatrix3.
         *
         * @since 2.0
         *
-        * @return      A new instance of %FloatMatrix3 that contains the resulting value of the operation
-        * @param[in]   value   The @c float value to multiply
+        * @return      A new instance of %FloatMatrix3 containing the resulting value of the operation
+        * @param[in]   value   A @c float value to multiply
         */
        FloatMatrix3 operator *(float value) const;
 
        /**
-        * Adds the value of the specified instance to the current instance of %FloatMatrix3.
+        * Adds the value of the specified instance and the current instance of %FloatMatrix3.
         *
         * @since 2.0
         *
-        * @return      A new instance of %FloatMatrix3 that contains the resulting value of the operation
+        * @return      A new instance of %FloatMatrix3 containing the resulting value of the operation
         * @param[in]   rhs     An instance of %FloatMatrix3
         */
        FloatMatrix3 operator +(const FloatMatrix3& rhs) const;
 
        /**
-        * Adds the value to each matrix member of the current instance of %FloatMatrix3.
+        * Adds the value to each matrix members of current instance of %FloatMatrix3.
         *
         * @since 2.0
         *
-        * @return      A new instance of %FloatMatrix3 that contains the resulting value of the operation
-        * @param[in]   value   The @c float value to add
+        * @return      A new instance of %FloatMatrix3 containing the resulting value of the operation
+        * @param[in]   value   A @c float value to add
         */
        FloatMatrix3 operator +(float value) const;
 
@@ -163,18 +163,18 @@ public:
         *
         * @since 2.0
         *
-        * @return      A new instance of %FloatMatrix3 that contains the resulting value of the operation
+        * @return      A new instance of %FloatMatrix3 containing the resulting value of the operation
         * @param[in]   rhs     An instance of %FloatMatrix3
         */
        FloatMatrix3 operator -(const FloatMatrix3& rhs) const;
 
        /**
-        * Subtracts the value from each matrix member of the current instance of %FloatMatrix3.
+        * Subtracts the value from each matrix members of current instance of %FloatMatrix3.
         *
         * @since 2.0
         *
-        * @return      A new instance of %FloatMatrix3 that contains the resulting value of the operation
-        * @param[in]   value   The @c float value to subtract
+        * @return      A new instance of %FloatMatrix3 containing the resulting value of the operation
+        * @param[in]   value   A @c float value to subtract
         */
        FloatMatrix3 operator -(float value) const;
 
@@ -183,18 +183,18 @@ public:
         *
         * @since 2.0
         *
-        * @return      A reference to %FloatMatrix3 that contains the resulting value of the operation
+        * @return      The reference to %FloatMatrix3 containing the resulting value of the operation
         * @param[in]   rhs     An instance of %FloatMatrix3
         */
        FloatMatrix3& operator *=(const FloatMatrix3& rhs);
 
        /**
-        * Multiplies the value to each matrix member of the current instance of %FloatMatrix3.
+        * Multiplies the value to each matrix members of current instance of %FloatMatrix3.
         *
         * @since 2.0
         *
-        * @return      A reference to %FloatMatrix3 that contains the resulting value of the operation
-        * @param[in]   value   The @c float value to multiply
+        * @return      The reference to %FloatMatrix3 containing the resulting value of the operation
+        * @param[in]   value   A @c float value to multiply
         */
        FloatMatrix3& operator *=(float value);
 
@@ -203,18 +203,18 @@ public:
         *
         * @since 2.0
         *
-        * @return      A reference to %FloatMatrix3 that contains the resulting value of the operation
+        * @return      The reference to %FloatMatrix3 containing the resulting value of the operation
         * @param[in]   rhs     An instance of %FloatMatrix3
         */
        FloatMatrix3& operator +=(const FloatMatrix3& rhs);
 
        /**
-        * Adds the value to each matrix member of the current instance of %FloatMatrix3.
+        * Adds the value to each matrix members of current instance of %FloatMatrix3.
         *
         * @since 2.0
         *
-        * @return      A reference to %FloatMatrix3 that contains the resulting value of the operation
-        * @param[in]   value   The @c float value to add
+        * @return      The reference to %FloatMatrix3 containing the resulting value of the operation
+        * @param[in]   value   A @c float value to add
         */
        FloatMatrix3& operator +=(float value);
 
@@ -223,51 +223,51 @@ public:
         *
         * @since 2.0
         *
-        * @return      A reference to %FloatMatrix3 that contains the resulting value of the operation
+        * @return      The reference to %FloatMatrix3 containing the resulting value of the operation
         * @param[in]   rhs     An instance of %FloatMatrix3
         */
        FloatMatrix3& operator -=(const FloatMatrix3& rhs);
 
        /**
-        * Subtracts the value from each matrix member of the current instance of %FloatMatrix3.
+        * Subtracts the value from each matrix members of current instance of %FloatMatrix3.
         *
         * @since 2.0
         *
-        * @return      A reference to %FloatMatrix3 that contains the resulting value of the operation
-        * @param[in]   value   The @c float value to subtract
+        * @return      The reference to %FloatMatrix3 containing the resulting value of the operation
+        * @param[in]   value   A @c float value to subtract
         */
        FloatMatrix3& operator -=(float value);
 
        /**
-        * Gets an instance of %FloatMatrix3 resulting from the sum of the value and the specified instance of %FloatMatrix3.
+        * Gets the instance of %FloatMatrix3 resulting from the sum of the value and the specified instance of %FloatMatrix3.
         *
         * @since 2.0
         *
-        * @return              A new instance of %FloatMatrix3 that contains the resulting value of the operation
-        * @param[in]   value   The @c float value to add
-        * @param[in]   rhs             An instance of %FloatMatrix3
+        * @return      A new instance of %FloatMatrix3 containing the resulting value of the operation
+        * @param[in]   value   A @c float value to add
+        * @param[in]   rhs     An instance of %FloatMatrix3
         */
        _OSP_EXPORT_ friend FloatMatrix3 operator +(const float& value, const FloatMatrix3& rhs);
 
        /**
-        * Gets an instance of %FloatMatrix3 resulting from the product of the value and the specified instance of %FloatMatrix3.
+        * Gets the instance of %FloatMatrix3 resulting from the product of the value and the specified instance of %FloatMatrix3.
         *
         * @since 2.0
         *
-        * @return              A new instance of %FloatMatrix3 that contains the resulting value of the operation
-        * @param[in]   value   The @c float value to multiply
-        * @param[in]   rhs             An instance of %FloatMatrix3
+        * @return      A new instance of %FloatMatrix3 containing the resulting value of the operation
+        * @param[in]   value   A @c float value to multiply
+        * @param[in]   rhs     An instance of %FloatMatrix3
         */
        _OSP_EXPORT_ friend FloatMatrix3 operator *(const float& value, const FloatMatrix3& rhs);
 
        /**
-        * Gets an instance of %FloatMatrix3 resulting from the difference between the value and the specified instance of %FloatMatrix3.
+        * Gets the instance of %FloatMatrix3 resulting from the difference between the value and the specified instance of %FloatMatrix3.
         *
         * @since 2.0
         *
-        * @return              A new instance of %FloatMatrix3 that contains the resulting value of the operation
-        * @param[in]   value   The @c float value to subtract
-        * @param[in]   rhs             An instance of %FloatMatrix3
+        * @return      A new instance of %FloatMatrix3 containing the resulting value of the operation
+        * @param[in]   value   A @c float value to subtract
+        * @param[in]   rhs     An instance of %FloatMatrix3
         */
        _OSP_EXPORT_ friend FloatMatrix3 operator -(const float& value, const FloatMatrix3& rhs);
 
@@ -276,12 +276,10 @@ public:
         *
         * @since 2.0
         *
-        * @return              @c true if the values of the current instance is equal to the value of the specified instance, @n
-        *                              else @c false
+        * @return      @c true if the values of the current instance is equal to the value of the specified instance, @n
+        *                      else @c false
         * @param[in]   obj     An instance of %FloatMatrix3
-        * @remarks
-        *                              - This method overrides Tizen::Base::Object::Equals(). 
-        *                              - This method uses the values of the Matrix components to compare the two instances.
+        * @remarks             This method overrides Tizen::Base::Object::Equals(). This method uses the values of the Matrix components to compare the two instances.
         */
        virtual bool Equals(const Tizen::Base::Object& obj) const;
 
@@ -291,8 +289,8 @@ public:
         * @since 2.0
         *
         * @return      The hash value of the current instance
-        * @remarks     Two equal instances must return the same hash value. @n
-        *                      For better performance, the used hash function must generate a random distribution for all the inputs.
+        * @remarks     Two equal instances must return the same hash value. For better performance,
+        *                              the used hash function must generate a random distribution for all inputs.
         */
        virtual int GetHashCode(void) const;
 
@@ -310,7 +308,7 @@ public:
         *
         * @since 2.0
         *
-        * @return      A new instance of %FloatMatrix3 that contains the resulting value of the operation
+        * @return      A new instance of %FloatMatrix3 containing the resulting value of the operation
         * @remarks     This function must be called after checking whether the matrix is invertible or not.
         */
        FloatMatrix3 GetInverse(void) const;
@@ -329,7 +327,7 @@ public:
         *
         * @since 2.0
         *
-        * @return      A new instance of %FloatMatrix3 that contains the resulting value of the operation
+        * @return      A new instance of %FloatMatrix3 containing the resulting value of the operation
         */
        FloatMatrix3 GetTranspose(void) const;
 
@@ -354,7 +352,7 @@ public:
        bool IsInvertible(void) const;
 
        /**
-        * Negates the matrix members of the current instance of %FloatMatrix3.
+        * Negates the matrix members of current instance of %FloatMatrix3.
         *
         * @since 2.0
         */
@@ -373,7 +371,7 @@ public:
         * @since 2.0
         *
         * @return              An error code
-        * @exception   E_SUCCESS                       The method is successful.
+        * @exception   E_SUCCESS       The method is successful.
         * @exception   E_INVALID_OPERATION     The current instance is not invertible.
         */
        result Invert(void);
@@ -386,7 +384,7 @@ public:
        void Transpose(void);
 
        /**
-        * Sets the matrix members of the current instance of %FloatMatrix3 to zero.
+        * Sets the matrix members of current instance of %FloatMatrix3 to zero.
         *
         * @since 2.0
         */