Add BoxF::ExpandTo

ui/gfx/box_f.h

Index: ui/gfx/box_f.h
diff --git a/ui/gfx/box_f.h b/ui/gfx/box_f.h
index fb2c1910a96ebe18375ab8eee821f136ea0b51a5..0dc7526078e798fdcb77cad4abefd474611647c5 100644
--- a/ui/gfx/box_f.h
+++ b/ui/gfx/box_f.h
@@ -94,7 +94,18 @@ class GFX_EXPORT BoxF {
   const Point3F& origin() const { return origin_; }
   void set_origin(const Point3F& origin) { origin_ = origin; }
 
+  // Expands the box to contain the given point, if necessary.

[danakj, 2013/10/01 15:09:15]

Comment on what happens if |this| is empty? I see you added some stuff on the
private ExpandTo() but I'm more concerned with documenting the public API.

+  void ExpandTo(const Point3F& point);
+
  private:
+  // Expands the box to contain the two given points. It is required that each
+  // component of |min| is less than or equal to the corresponding component in
+  // |max|. Precisely, what this function does is ensure that after the function
+  // completes, |this| contains origin_, min, max, and origin_ + (width_,
+  // height_, depth_), even if the box is empty. Emptiness checks are handled in
+  // the public function Union.
+  void ExpandTo(const Point3F& min, const Point3F& max);
+
   Point3F origin_;
   float width_;
   float height_;