X-Git-Url: https://www.fleuret.org/cgi-bin/gitweb/gitweb.cgi?p=folded-ctf.git;a=blobdiff_plain;f=labelled_image_pool.h;h=6c3e5e7eb6c6637f72673e033b3e6db6e7caa18d;hp=3186dc76675e34746dbd29a2d8b425b200a87dad;hb=ccc2785ee823c934edcededc5c6448e4f9488f8b;hpb=82c3a0366dd58ea2b3a2fc3f90be3f1a42ac8341

diff --git a/labelled_image_pool.h b/labelled_image_pool.h
index 3186dc7..6c3e5e7 100644
--- a/labelled_image_pool.h
+++ b/labelled_image_pool.h
@@ -16,6 +16,14 @@
 // Contact <francois.fleuret@idiap.ch> for comments & bug reports        //
 ///////////////////////////////////////////////////////////////////////////
 
+/*
+
+  A pool of images is used to avoid having too many images in memory
+  at the same time. It can be either a file, or a subset of another
+  pool of images (see the subclasses).
+
+ */
+
 #ifndef LABELLED_IMAGE_POOL_H
 #define LABELLED_IMAGE_POOL_H
 
@@ -26,6 +34,9 @@ class LabelledImagePool {
 public:
   virtual ~LabelledImagePool();
   virtual int nb_images() = 0;
+  // grab_image _DOES NOT_ build the rich structure of the grabbed
+  // image. One has to call compute_rich_structure() explicitely for
+  // that!
   virtual LabelledImage *grab_image(int n_image) = 0;
   virtual void release_image(int n_image) = 0;
 };