File indexing completed on 2024-05-19 04:22:56

0001 
0002 /*
0003    Copyright (c) 2003-2007 Clarence Dang <dang@kde.org>
0004    Copyright (c) 2006 Mike Gashler <gashlerm@yahoo.com>
0005    All rights reserved.
0006 
0007    Redistribution and use in source and binary forms, with or without
0008    modification, are permitted provided that the following conditions
0009    are met:
0010 
0011    1. Redistributions of source code must retain the above copyright
0012       notice, this list of conditions and the following disclaimer.
0013    2. Redistributions in binary form must reproduce the above copyright
0014       notice, this list of conditions and the following disclaimer in the
0015       documentation and/or other materials provided with the distribution.
0016 
0017    THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
0018    IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
0019    OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
0020    IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
0021    INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
0022    NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
0023    DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
0024    THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
0025    (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
0026    THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
0027 */
0028 
0029 
0030 #ifndef kpEffectToneEnhance_H
0031 #define kpEffectToneEnhance_H
0032 
0033 
0034 #include "imagelib/kpImage.h"
0035 
0036 
0037 //
0038 // Histogram Equalizer effect.
0039 //
0040 // It just divides out the color histogram from the pixel values. (So if
0041 // you plot the color histogram after equalizing, you should get a nearly
0042 // flat/uniform distribution.)
0043 //
0044 // The two sliders adjust:
0045 //
0046 // 1. The extent to which it equalizes
0047 // 2. The local-ness of the equalization. (In other words, it computes just
0048 //    the histogram of the regions near the pixel it is adjusting.)
0049 //
0050 // ASSUMPTION: The given <image> is not paletted (currently, this is the
0051 //             same as the screen mode not being paletted).
0052 //
0053 class kpEffectToneEnhance
0054 {
0055 public:
0056     static kpImage applyEffect (const kpImage &image,
0057         double granularity, double amount);
0058 };
0059 
0060 
0061 #endif  // kpEffectToneEnhance_H