2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
6 % PPPP RRRR EEEEE PPPP RRRR EEEEE SSSSS SSSSS %
7 % P P R R E P P R R E SS SS %
8 % PPPP RRRR EEE PPPP RRRR EEE SSS SSS %
9 % P R R E P R R E SS SS %
10 % P R R EEEEE P R R EEEEE SSSSS SSSSS %
13 % MagickCore Prepress Methods %
20 % Copyright 1999-2011 ImageMagick Studio LLC, a non-profit organization %
21 % dedicated to making software imaging solutions freely available. %
23 % You may not use this file except in compliance with the License. You may %
24 % obtain a copy of the License at %
26 % http://www.imagemagick.org/script/license.php %
28 % Unless required by applicable law or agreed to in writing, software %
29 % distributed under the License is distributed on an "AS IS" BASIS, %
30 % WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. %
31 % See the License for the specific language governing permissions and %
32 % limitations under the License. %
34 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
42 #include "MagickCore/studio.h"
43 #include "MagickCore/cache-view.h"
44 #include "MagickCore/exception.h"
45 #include "MagickCore/exception-private.h"
46 #include "MagickCore/hashmap.h"
47 #include "MagickCore/image.h"
48 #include "MagickCore/list.h"
49 #include "MagickCore/memory_.h"
50 #include "MagickCore/pixel-accessor.h"
51 #include "MagickCore/prepress.h"
52 #include "MagickCore/registry.h"
53 #include "MagickCore/semaphore.h"
54 #include "MagickCore/splay-tree.h"
55 #include "MagickCore/string_.h"
58 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
62 % G e t I m a g e T o t a l I n k D e n s i t y %
66 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
68 % GetImageTotalInkDensity() returns the total ink density for a CMYK image.
69 % Total Ink Density (TID) is determined by adding the CMYK values in the
70 % darkest shadow area in an image.
72 % The format of the GetImageTotalInkDensity method is:
74 % double GetImageTotalInkDensity(const Image *image)
76 % A description of each parameter follows:
81 MagickExport double GetImageTotalInkDensity(Image *image)
98 assert(image != (Image *) NULL);
99 if (image->debug != MagickFalse)
100 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"...");
101 assert(image->signature == MagickSignature);
102 if (image->colorspace != CMYKColorspace)
104 (void) ThrowMagickException(&image->exception,GetMagickModule(),
105 ImageError,"ColorSeparatedImageRequired","`%s'",image->filename);
109 total_ink_density=0.0;
110 exception=(&image->exception);
111 image_view=AcquireCacheView(image);
112 #if defined(MAGICKCORE_OPENMP_SUPPORT)
113 #pragma omp parallel for schedule(dynamic,4) shared(status)
115 for (y=0; y < (ssize_t) image->rows; y++)
120 register const Quantum
126 p=GetCacheViewVirtualPixels(image_view,0,y,image->columns,1,exception);
127 if (p == (const Quantum *) NULL)
132 for (x=0; x < (ssize_t) image->columns; x++)
134 density=(double) GetPixelRed(image,p)+GetPixelGreen(image,p)+
135 GetPixelBlue(image,p)+GetPixelBlack(image,p);
136 if (density > total_ink_density)
137 #if defined(MAGICKCORE_OPENMP_SUPPORT)
138 #pragma omp critical (MagickCore_GetImageTotalInkDensity)
141 if (density > total_ink_density)
142 total_ink_density=density;
144 p+=GetPixelChannels(image);
147 image_view=DestroyCacheView(image_view);
148 if (status == MagickFalse)
149 total_ink_density=0.0;
150 return(total_ink_density);