add roundOut that returns its result

include/core/SkRect.h

 /*
  * Copyright 2006 The Android Open Source Project
  *
  * Use of this source code is governed by a BSD-style license that can be
  * found in the LICENSE file.
  */
 
 #ifndef SkRect_DEFINED
 #define SkRect_DEFINED
 
@@ skipping 785 matching lines @@
      *  Set the dst rectangle by rounding "out" this rectangle, choosing the
      *  SkScalarFloor of top and left, and the SkScalarCeil of right and bottom.
      */
     void roundOut(SkIRect* dst) const {
         SkASSERT(dst);
         dst->set(SkScalarFloorToInt(fLeft), SkScalarFloorToInt(fTop),
                  SkScalarCeilToInt(fRight), SkScalarCeilToInt(fBottom));
     }
 
     /**
-     *  Expand this rectangle by rounding its coordinates "out", choosing the
-     *  floor of top and left, and the ceil of right and bottom. If this rect
-     *  is already on integer coordinates, then it will be unchanged.
+     *  Set the dst rectangle by rounding "out" this rectangle, choosing the
+     *  SkScalarFloorToScalar of top and left, and the SkScalarCeilToScalar of right and bottom.
      *
      *  It is safe for this == dst
      */
     void roundOut(SkRect* dst) const {
         dst->set(SkScalarFloorToScalar(fLeft),
                  SkScalarFloorToScalar(fTop),
                  SkScalarCeilToScalar(fRight),
                  SkScalarCeilToScalar(fBottom));
     }
 
     /**
      *  Set the dst rectangle by rounding "in" this rectangle, choosing the
      *  ceil of top and left, and the floor of right and bottom. This does *not*
      *  call sort(), so it is possible that the resulting rect is inverted...
      *  e.g. left >= right or top >= bottom. Call isEmpty() to detect that.
      */
     void roundIn(SkIRect* dst) const {
         SkASSERT(dst);
         dst->set(SkScalarCeilToInt(fLeft), SkScalarCeilToInt(fTop),
                  SkScalarFloorToInt(fRight), SkScalarFloorToInt(fBottom));
     }
 
-    /**
-     *  Return a new SkIRect which is contains the rounded coordinates of this
-     *  rect using SkScalarRoundToInt.
-     */
+    //! Returns the result of calling round(&dst)
     SkIRect round() const {
         SkIRect ir;
         this->round(&ir);
         return ir;
     }
-
+    
+    //! Returns the result of calling roundOut(&dst)
+    SkIRect roundOut() const {
+        SkIRect ir;
+        this->roundOut(&ir);
+        return ir;
+    }
+    
     /**
      *  Swap top/bottom or left/right if there are flipped (i.e. if width()
      *  or height() would have returned a negative value.) This should be called
      *  if the edges are computed separately, and may have crossed over each
      *  other. When this returns, left <= right && top <= bottom
      */
     void sort() {
         if (fLeft > fRight) {
             SkTSwap<SkScalar>(fLeft, fRight);
         }
@@ skipping 14 matching lines @@
      * rely on the existence of this function or the formatting of its output.
      */
     void dump() const {
         SkDebugf("{ l: %f, t: %f, r: %f, b: %f }", fLeft, fTop, fRight, fBottom);
     }
 #endif
 
 };
 
 #endif