Improve comments in RangeImage

Also remove some dead code.

Change-Id: Ia0635e7b47dd52ef72b673ee4272c11a86f9ba2c
diff --git a/aos/vision/blob/range_image.cc b/aos/vision/blob/range_image.cc
index 613d2ca..81a8c48 100644
--- a/aos/vision/blob/range_image.cc
+++ b/aos/vision/blob/range_image.cc
@@ -5,18 +5,10 @@
 
 namespace aos {
 namespace vision {
+namespace {
 
-void DrawRangeImage(const RangeImage &rimg, ImagePtr outbuf, PixelRef color) {
-  for (int i = 0; i < (int)rimg.ranges().size(); ++i) {
-    int y = rimg.min_y() + i;
-    for (ImageRange rng : rimg.ranges()[i]) {
-      for (int x = rng.st; x < rng.ed; ++x) {
-        outbuf.get_px(x, y) = color;
-      }
-    }
-  }
-}
-
+// Merge sort of multiple range images into a single range image.
+// They must not overlap.
 RangeImage MergeRangeImage(const BlobList &blobl) {
   if (blobl.size() == 1) return blobl[0];
 
@@ -48,6 +40,8 @@
   }
 }
 
+}  // namespace
+
 std::string ShortDebugPrint(const BlobList &blobl) {
   RangeImage rimg = MergeRangeImage(blobl);
   std::string out;
diff --git a/aos/vision/blob/range_image.h b/aos/vision/blob/range_image.h
index 201ffb2..a735442 100644
--- a/aos/vision/blob/range_image.h
+++ b/aos/vision/blob/range_image.h
@@ -46,7 +46,13 @@
 
   int size() const { return ranges_.size(); }
 
+  // Returns the total number of included pixels.
   int npixels();
+  // Calculates the total number of included pixels.
+  //
+  // TODO(Brian): Present a nicer API than the current duality between this and
+  // npixels(), which is annoying because npixels() has to modify the cached
+  // data so it can't be const.
   int calc_area() const;
 
   void Flip(ImageFormat fmt) { Flip(fmt.w, fmt.h); }
@@ -85,12 +91,6 @@
 typedef std::vector<RangeImage> BlobList;
 typedef std::vector<const RangeImage *> BlobLRef;
 
-void DrawRangeImage(const RangeImage &rimg, ImagePtr outbuf, PixelRef color);
-
-// Merge sort of multiple range images into a single range image.
-// They must not overlap.
-RangeImage MergeRangeImage(const BlobList &blobl);
-
 // Debug print range image as ranges.
 std::string ShortDebugPrint(const BlobList &blobl);
 // Debug print range image as ### for the ranges.