Changeset 1613 for trunk/psLib/src/image/psImageExtraction.h

Timestamp:

Aug 24, 2004, 2:04:01 PM (22 years ago)

Author:

desonia

Message:

added psImageTrim and psImageSubsection.

File:

• trunk/psLib/src/image/psImageExtraction.h (modified) (2 diffs)

trunk/psLib/src/image/psImageExtraction.h

@@ -10 +10 @@
 *  @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 +62 @@
     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
 );