Index: trunk/psLib/src/image/psImageExtraction.h
===================================================================
--- trunk/psLib/src/image/psImageExtraction.h	(revision 1606)
+++ trunk/psLib/src/image/psImageExtraction.h	(revision 1613)
@@ -10,6 +10,6 @@
 *  @author Robert DeSonia, MHPCC
 *
-*  @version $Revision: 1.10 $ $Name: not supported by cvs2svn $
-*  @date $Date: 2004-08-23 22:36:03 $
+*  @version $Revision: 1.11 $ $Name: not supported by cvs2svn $
+*  @date $Date: 2004-08-25 00:04:01 $
 *
 *  Copyright 2004 Maui High Performance Computing Center, University of Hawaii
@@ -62,4 +62,24 @@
     psImage* image,                    ///< Parent image.
     const char* section                ///< Subsection in the form '[x1:x2,y1:y2]'
+);
+
+/** Trim an image
+ *
+ *  Trim the specified image in-place, which involves shuffling the pixels 
+ *  around in memory.  The pixels in the region [x0:x1,y0:y1] (inclusive)
+ *  shall consist the output image.
+ *
+ *  N.b., An image that has a parent image will be orphaned from the parent 
+ *  upon trimming.  Any children of the trimmed image will also be obliterated, 
+ *  i.e., freed from memory.
+ *
+ *  @return psImage*  trimmed image result
+ */
+psImage* psImageTrim(
+    psImage* image,                    ///< image to trim
+    int x0,                            ///< column of trim region's left boundary
+    int x1,                            ///< column of trim region's right boundary
+    int y0,                            ///< row of trim region's lower boundary
+    int y1                             ///< row of trim region's upper boundary
 );