Changeset 9927 for trunk/psLib/src/imageops/psImageGeomManip.h

Timestamp:

Nov 9, 2006, 10:20:27 AM (20 years ago)

Author:

magnier

Message:

added test psImageShiftKernel and related p_psImageShiftKernel_F32; added PS_INTERPOLATE_GAUSS

File:

• trunk/psLib/src/imageops/psImageGeomManip.h (modified) (3 diffs)

trunk/psLib/src/imageops/psImageGeomManip.h

@@ -8 +8 @@
  *  @author Robert DeSonia, MHPCC
  *
- *  @version $Revision: 1.16 $ $Name: not supported by cvs2svn $
- *  @date $Date: 2006-06-07 03:22:06 $
+ *  @version $Revision: 1.17 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2006-11-09 20:20:27 $
  *
  *  Copyright 2004-2005 Maui High Performance Computing Center, University of Hawaii
@@ -100 +100 @@
     psImageInterpolateMode mode        ///< the interpolation mode to use
 );
+
+/** Shift image by an arbitrary number of pixels (dx,dy) in either direction.
+ *
+ *  If the shift values are fractional, the output pixel values should
+ *  interpolate between the input pixel values. The output image has the same
+ *  dimensions as the input image. Pixels which fall off the edge of the
+ *  output image are lost. Newly exposed pixels are set to the value given by
+ *  exposed. This function must be defined for the following types: psU8,
+ *  psU16, psS8, psS16, psF32, psF64, psC32, psC64.
+ *
+ *  This implementation uses a NxN kernel generated based on the interpolation method
+ *  the image is first shifted by a fractional amount with the kernel, then
+ *  shifted in place by an integer amount. 
+ *
+ *  XXX the integer shift portion is not implemented
+ *  XXX the exposed pixels are not properly replaced
+ *  XXX the algorithm can properly handle a mask, but the API does not include
+ *  it (and it is not implemented)
+ *
+ *  @return psImage*     the shifted image result.
+ */
+psImage* psImageShiftKernel(
+    psImage* out,                      ///< an psImage to recycle.  If NULL, a new image is created
+    const psImage* input,              ///< input image
+    float dx,                          ///< the shift in x direction.
+    float dy,                          ///< the shift in y direction.
+    psImageInterpolateMode mode        ///< the interpolation mode to use
+);
+
+// XXX should this be global private or local static?
+psImage *p_psImageShiftKernel_F32(
+    psImage *out,
+    const psImage *input,
+    const psImage *kernel);
 
 /** Roll image by an integer number of pixels in either direction.
@@ -151 +185 @@
     psRegion region,                   ///< the size of the transformed image
     const psPixels* pixels,            /**< if not NULL, consists of psPixelCoords and specifies
-                                                * which pixels in output image shall be transformed;
-                                                * otherwise, entire image generated*/
+                                                    * which pixels in output image shall be transformed;
+                                                    * otherwise, entire image generated*/
     psImageInterpolateMode mode,       ///< the interpolation scheme to be used
     double exposedValue                ///< Exposed value to which non-corresponding pixels are set