VirtualRenderingSystem: imageditherop.h Source File

00001  /**********************************************************************
00002  VRS - The Virtual Rendering System
00003  Copyright (C) 2001 Computer Graphics Systems Group at the 
00004  Hasso-Plattner-Institute, Potsdam, Germany.
00005  This library is free software; you can redistribute it and/or 
00006  modify it under the terms of the GNU Lesser General Public 
00007  License as published by the Free Software Foundation; either 
00008  version 2.1 of the License, or (at your option) any later version.
00009  This library is distributed in the hope that it will be useful, but 
00010  WITHOUT ANY WARRANTY; without even the implied warranty of 
00011  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. 
00012  See the GNU Lesser General Public License for more details.
00013  You should have received a copy of the GNU Lesser+ General Public
00014  License along with this library; if not, write to the FreeSoftware 
00015  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA, 02111-1307, USA.
00016  **********************************************************************/
00017 // $Id: imageditherop.h 6014 2007-08-09 07:51:16Z Konstantin_Baumann $
00018 // $Date: 2007-08-09 09:51:16 +0200 (Thu, 09 Aug 2007) $
00019 // $Revision: 6014 $
00020 // $State$
00021 // $Author: Konstantin_Baumann $
00022 //
00023 // $Log$
00024 // Revision 1.18  2005/01/03 01:43:09  klimetschek
00025 // - modified win32 project layout, splitted vrs.vcproj into vrs_container, vrs_core, vrs_sg, vrs_image, vrs_opengl and vrs_io
00026 // - removed vrs.vcproj
00027 // minor things:
00028 // - added all glutexamples to vrs4glut.sln
00029 // - fixed some problems in glutexamples
00030 // - removed all project references from all VS projects (using solution wide project dependencies instead)
00031 //
00032 // Revision 1.17  2004/11/03 11:20:07  saar
00033 // Class comment changed (Doxygen style)
00034 //
00035 // Revision 1.16  2004/03/12 16:28:40  baumann
00036 // macros VRS_NAMESPACE_BEGIN/_END expanded and removed
00037 //
00038 // Revision 1.15  2004/01/19 11:43:58  baumann
00039 // serialization mechanism improved
00040 //
00041 // Revision 1.14  2004/01/19 07:28:04  baumann
00042 // serialization mechanism improved
00043 //
00044 // Revision 1.13  2003/11/07 14:19:24  kirsch
00045 // removed leading underscore from include guards
00046 //
00047 // Revision 1.12  2003/07/05 17:33:53  kirsch
00048 // forward declared callback and iterator2d in image
00049 //
00050 // Revision 1.11  2002/10/29 10:32:52  baumann
00051 // macros VRS_CLASSNAME_* and VRS_IMPL_TYPEINFO_* removed
00052 //
00053 // Revision 1.10  2002/03/03 21:44:25  kosta
00054 // VRS_TYPEINFO-macro rewritten
00055 //
00056 // Revision 1.9  2002/02/19 10:34:15  kosta
00057 // undone all changes since 2002-02-15
00058 //
00059 // Revision 1.6  2002/01/15 16:25:54  kosta
00060 // macros rewritten for a better namespace support
00061 //
00062 // Revision 1.5  2001/11/13 16:36:31  kirsch
00063 // changed line feed to unix style (removed control-M)
00064 //
00065 // Revision 1.4  2001/08/20 15:07:59  kersting
00066 // added classname to enumeration
00067 //
00068 // Revision 1.3  2001/07/26 12:11:19  kersting
00069 // added strong enum typing
00070 //
00071 // Revision 1.2  2001/07/20 10:23:09  doellner
00072 // comments revised, dither operations added
00073 //
00074 // Revision 1.1  2001/07/19 14:27:04  doellner
00075 // Initial check-in: dithering algorithms for VRS images
00076 //
00077 //
00078 
00079 
00080 #ifndef VRS_IMAGE_IMAGEDITHEROP_H
00081 #define VRS_IMAGE_IMAGEDITHEROP_H
00082 
00083 #include <vrs/image/imagemanipulator.h>
00084 
00085 namespace VRS {
00086 
00087 class VRS_CORE_API DitherMatrix : public SharedObj {
00088 public:
00089         DitherMatrix(int sizeX, int sizeY);
00090         virtual ~DitherMatrix();
00091 
00092         void set(int i, int j, double matrixCoefficient);
00093         double get(int i, int j) const;
00094 
00095         int sizeX() const;
00096         int sizeY() const;
00097 
00098         static DitherMatrix* clustered3x3();
00099         static DitherMatrix* clustered6x6();
00100         static DitherMatrix* dispersion4x4();
00101 
00102         VRS_TYPEINFO(DitherMatrix, SharedObj);
00103 
00104 private:
00105         int N_;
00106         int M_;
00107         double* coeff_;
00108 };
00109 
00110 
00112 class VRS_CORE_API ImageDitherOp : public ImageManipulator {
00113 public:
00114     enum Operation {
00115         OrderedDither,
00116         FloydSteinbergDither,
00117         RiemsmerDither
00118     };
00119     VRS_SERIALIZABLE_CLASS_ENUM(Operation);
00120     ImageDitherOp(Operation opType, DitherMatrix* ditherMatrix);
00131     void setOperation(Operation opType);
00132     Operation getOperation() const;
00134 
00135     void setDitherMatrix(DitherMatrix* ditherMatrix);
00136     DitherMatrix* getDitherMatrix() const;
00144     virtual Image* manipulate(Image* source, Image* target);
00145     virtual bool operatesInPlace() const;
00149     static void orderedDithering(Image* srcI, Image* dstI, DitherMatrix* ditherMatrix);
00153         static void floydSteinbergDithering(Image* srcI, Image* dstI, double threshold = 0.5);
00158         static void riemersmaDithering(Image* srcI, Image* dstI, int queueSize = 16);
00164     VRS_TYPEINFO(ImageDitherOp, ImageManipulator);
00165 
00166 private:
00167     int opType_;
00168     SO<DitherMatrix> ditherMatrix_;
00169 };
00170 
00171 } // namespace VRS
00172 
00173 #endif // VRS_IMAGE_IMAGEDITHEROP_H