X-Git-Url: http://git.openbox.org/?p=mikachu%2Fopenbox.git;a=blobdiff_plain;f=render%2Fimagecache.h;h=4ad2deaec6371a6f5a76e3f87d6f8cf57c98327d;hp=8c96caf00cb8fc51dd0a5c21cefdb1989e9ec91f;hb=a2e3026d8a398a4d08c05610c3f652dd14fcdf45;hpb=35b36fc3771452cf980cb0a59aa05f3e2aa2aa67

diff --git a/render/imagecache.h b/render/imagecache.h
index 8c96caf..4ad2dea 100644
--- a/render/imagecache.h
+++ b/render/imagecache.h
@@ -21,15 +21,29 @@
 
 #include <glib.h>
 
-/* the number of resized pictures to cache for an image */
-#define MAX_CACHE_RESIZED 3
-
 struct _RrImagePic;
 
 guint RrImagePicHash(const struct _RrImagePic *p);
 
+/*! Create a new image cache.  An image cache is basically a hash table to look
+  up RrImages.  Each RrImage in the cache may contain one or more Pictures,
+  that is one or more actual copies of image data at various sizes.  For eg,
+  for a window, all of its various icons are loaded into the same RrImage.
+  When an RrImage is drawn and a picture inside it needs to be resized, that
+  is also saved within the RrImage.
+
+  For each picture that an RrImage has, the picture is hashed and that is used
+  as a key to find the RrImage.  So, given any picture in any RrImage in the
+  cache, if you hash it, you will find the RrImage.
+*/
 struct _RrImageCache {
     gint ref;
+    /*! When an original picture is resized for an RrImage, the resized picture
+      is saved in the RrImage.  This specifies how many pictures should be
+      saved at a time.  When this is exceeded, the least recently used
+      "resized" picture is deleted.
+    */
+    gint max_resized_saved;
 
     GHashTable *table;
 };