MagickCore  6.8.5
deprecate.h
Go to the documentation of this file.
1 /*
2  Copyright 1999-2013 ImageMagick Studio LLC, a non-profit organization
3  dedicated to making software imaging solutions freely available.
4 
5  You may not use this file except in compliance with the License.
6  obtain a copy of the License at
7 
8  http://www.imagemagick.org/script/license.php
9 
10  Unless required by applicable law or agreed to in writing, software
11  distributed under the License is distributed on an "AS IS" BASIS,
12  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  See the License for the specific language governing permissions and
14  limitations under the License.
15 
16  MagickCore deprecated methods.
17 */
18 #ifndef _MAGICKCORE_DEPRECATE_H
19 #define _MAGICKCORE_DEPRECATE_H
20 
21 #if defined(__cplusplus) || defined(c_plusplus)
22 extern "C" {
23 #endif
24 
25 #if !defined(MAGICKCORE_EXCLUDE_DEPRECATED)
26 
27 #include <stdarg.h>
28 #include "magick/blob.h"
29 #include "magick/cache-view.h"
30 #include "magick/draw.h"
31 #include "magick/constitute.h"
32 #include "magick/magick-config.h"
33 #include "magick/pixel.h"
34 #include "magick/quantize.h"
35 #include "magick/quantum.h"
36 #include "magick/registry.h"
37 #include "magick/semaphore.h"
38 
39 #if !defined(magick_attribute)
40 # if !defined(__GNUC__)
41 # define magick_attribute(x) /*nothing*/
42 # else
43 # define magick_attribute __attribute__
44 # endif
45 #endif
46 
47 #define Downscale(quantum) ScaleQuantumToChar(quantum)
48 #define LABColorspace LabColorspace
49 #define CompressPixelGamma(pixel) DecodePixelGamma(pixel)
50 #define DecodesRGBGamma(pixel) DecodePixelGamma(pixel)
51 #define EncodesRGBGamma(pixel) EncodePixelGamma(pixel)
52 #define ExpandPixelGamma(pixel) EncodePixelGamma(pixel)
53 #define Intensity(color) PixelIntensityToQuantum(color)
54 #define LiberateUniqueFileResource(resource) \
55  RelinquishUniqueFileResource(resource)
56 #define LiberateMagickResource(resource) RelinquishMagickResource(resource)
57 #define LiberateSemaphore(semaphore) RelinquishSemaphore(semaphore)
58 #define QuantumDepth MAGICKCORE_QUANTUM_DEPTH
59 #define MaxRGB QuantumRange /* deprecated */
60 #define RunlengthEncodedCompression RLECompression
61 #define Upscale(value) ScaleCharToQuantum(value)
62 #define XDownscale(value) ScaleShortToQuantum(value)
63 #define XUpscale(quantum) ScaleQuantumToShort(quantum)
64 
65 typedef enum
66 {
69 
73 typedef struct _ViewInfo ViewInfo;
74 
75 typedef MagickBooleanType
76  (*MonitorHandler)(const char *,const MagickOffsetType,const MagickSizeType,
77  ExceptionInfo *);
78 
79 typedef struct _ImageAttribute
80 {
81  char
82  *key,
83  *value;
84 
87 
89  *previous,
90  *next; /* deprecated */
92 
94  *CloseCacheView(CacheView *) magick_attribute((deprecated)),
95  *OpenCacheView(const Image *) magick_attribute((deprecated));
96 
97 extern MagickExport char
98  *AllocateString(const char *) magick_attribute((deprecated)),
99  *InterpretImageAttributes(const ImageInfo *,Image *,const char *)
100  magick_attribute((deprecated)),
101  *PostscriptGeometry(const char *) magick_attribute((deprecated)),
102  *TranslateText(const ImageInfo *,Image *,const char *)
103  magick_attribute((deprecated));
104 
105 extern MagickExport const ImageAttribute
106  *GetImageAttribute(const Image *,const char *),
107  *GetImageClippingPathAttribute(Image *) magick_attribute((deprecated)),
108  *GetNextImageAttribute(const Image *) magick_attribute((deprecated));
109 
110 extern MagickExport const IndexPacket
111  *AcquireCacheViewIndexes(const CacheView *) magick_attribute((deprecated)),
112  *AcquireIndexes(const Image *) magick_attribute((deprecated));
113 
114 extern MagickExport const PixelPacket
115  *AcquirePixels(const Image *) magick_attribute((deprecated)),
116  *AcquireCacheViewPixels(const CacheView *,const ssize_t,const ssize_t,
117  const size_t,const size_t,ExceptionInfo *)
118  magick_attribute((deprecated)),
119  *AcquireImagePixels(const Image *,const ssize_t,const ssize_t,const size_t,
120  const size_t,ExceptionInfo *) magick_attribute((deprecated));
121 
122 extern MagickExport FILE
123  *OpenMagickStream(const char *,const char *);
124 
125 extern MagickExport Image
126  *AllocateImage(const ImageInfo *) magick_attribute((deprecated)),
127  *AverageImages(const Image *,ExceptionInfo *),
128  *ExtractSubimageFromImage(Image *,const Image *,ExceptionInfo *)
129  magick_attribute((deprecated)),
130  *GetImageFromMagickRegistry(const char *,ssize_t *id,ExceptionInfo *)
131  magick_attribute((deprecated)),
132  *GetImageList(const Image *,const ssize_t,ExceptionInfo *)
133  magick_attribute((deprecated)),
134  *GetNextImage(const Image *) magick_attribute((deprecated)),
135  *GetPreviousImage(const Image *) magick_attribute((deprecated)),
136  *FlattenImages(Image *,ExceptionInfo *) magick_attribute((deprecated)),
137  *MaximumImages(const Image *,ExceptionInfo *),
138  *MedianFilterImage(const Image *,const double,ExceptionInfo *),
139  *ModeImage(const Image *,const double,ExceptionInfo *),
140  *MinimumImages(const Image *,ExceptionInfo *),
141  *MosaicImages(Image *,ExceptionInfo *) magick_attribute((deprecated)),
142  *PopImageList(Image **) magick_attribute((deprecated)),
143  *RecolorImage(const Image *,const size_t,const double *,ExceptionInfo *)
144  magick_attribute((deprecated)),
145  *ReduceNoiseImage(const Image *,const double,ExceptionInfo *),
146  *ShiftImageList(Image **) magick_attribute((deprecated)),
147  *SpliceImageList(Image *,const ssize_t,const size_t,const Image *,
148  ExceptionInfo *) magick_attribute((deprecated)),
149  *ZoomImage(const Image *,const size_t,const size_t,ExceptionInfo *)
150  magick_attribute((deprecated));
151 
153  *GetCacheViewIndexes(CacheView *) magick_attribute((deprecated)),
154  *GetIndexes(const Image *) magick_attribute((deprecated)),
155  ValidateColormapIndex(Image *,const size_t) magick_attribute((deprecated));
156 
157 extern MagickExport int
158  GetImageGeometry(Image *,const char *,const unsigned int,RectangleInfo *)
159  magick_attribute((deprecated)),
160  ParseImageGeometry(const char *,ssize_t *,ssize_t *,size_t *,size_t *)
161  magick_attribute((deprecated));
162 
164  AcquireOneCacheViewPixel(const CacheView *,const ssize_t,const ssize_t,
165  PixelPacket *,ExceptionInfo *) magick_attribute((deprecated)),
166  AcquireOneCacheViewVirtualPixel(const CacheView *,const VirtualPixelMethod,
167  const ssize_t,const ssize_t,PixelPacket *,ExceptionInfo *)
168  magick_attribute((deprecated)),
169  AffinityImage(const QuantizeInfo *,Image *,const Image *)
170  magick_attribute((deprecated)),
171  AffinityImages(const QuantizeInfo *,Image *,const Image *)
172  magick_attribute((deprecated)),
173  AllocateImageColormap(Image *,const size_t)
174  magick_attribute((deprecated)),
175  ClipPathImage(Image *,const char *,const MagickBooleanType)
176  magick_attribute((deprecated)),
177  CloneImageAttributes(Image *,const Image *) magick_attribute((deprecated)),
178  ColorFloodfillImage(Image *,const DrawInfo *,const PixelPacket,const ssize_t,
179  const ssize_t,const PaintMethod) magick_attribute((deprecated)),
180  DeleteImageAttribute(Image *,const char *) magick_attribute((deprecated)),
181  DeleteMagickRegistry(const ssize_t) magick_attribute((deprecated)),
182  DescribeImage(Image *,FILE *,const MagickBooleanType)
183  magick_attribute((deprecated)),
184  FormatImageAttribute(Image *,const char *,const char *,...)
185  magick_attribute((__format__ (__printf__,3,4)))
186  magick_attribute((deprecated)),
187  FormatImageAttributeList(Image *,const char *,const char *,va_list)
188  magick_attribute((__format__ (__printf__,3,0)))
189  magick_attribute((deprecated)),
190  FormatImagePropertyList(Image *,const char *,const char *,va_list)
191  magick_attribute((__format__ (__printf__,3,0))),
192  FuzzyColorCompare(const Image *,const PixelPacket *,const PixelPacket *)
193  magick_attribute((deprecated)),
194  FuzzyOpacityCompare(const Image *,const PixelPacket *,const PixelPacket *)
195  magick_attribute((deprecated)),
196  LevelImageColors(Image *,const ChannelType,const MagickPixelPacket *,
197  const MagickPixelPacket *, const MagickBooleanType)
198  magick_attribute((deprecated)),
199  MagickMonitor(const char *,const MagickOffsetType,const MagickSizeType,
200  void *) magick_attribute((deprecated)),
201  MapImage(Image *,const Image *,const MagickBooleanType)
202  magick_attribute((deprecated)),
203  MapImages(Image *,const Image *,const MagickBooleanType)
204  magick_attribute((deprecated)),
205  MatteFloodfillImage(Image *,const PixelPacket,const Quantum,const ssize_t,
206  const ssize_t,const PaintMethod) magick_attribute((deprecated)),
207  OpaqueImage(Image *,const PixelPacket,const PixelPacket)
208  magick_attribute((deprecated)),
209  PaintFloodfillImage(Image *,const ChannelType,const MagickPixelPacket *,
210  const ssize_t,const ssize_t,const DrawInfo *,const PaintMethod)
211  magick_attribute((deprecated)),
212  PaintOpaqueImage(Image *,const MagickPixelPacket *,const MagickPixelPacket *)
213  magick_attribute((deprecated)),
214  PaintOpaqueImageChannel(Image *,const ChannelType,const MagickPixelPacket *,
215  const MagickPixelPacket *) magick_attribute((deprecated)),
216  PaintTransparentImage(Image *,const MagickPixelPacket *,const Quantum)
217  magick_attribute((deprecated)),
218  SetExceptionInfo(ExceptionInfo *,ExceptionType)
219  magick_attribute((deprecated)),
220  SetImageAttribute(Image *,const char *,const char *)
221  magick_attribute((deprecated)),
222  SyncCacheViewPixels(CacheView *) magick_attribute((deprecated)),
223  SyncImagePixels(Image *) magick_attribute((deprecated)),
224  TransparentImage(Image *,const PixelPacket,const Quantum)
225  magick_attribute((deprecated));
226 
227 extern MagickExport MagickPixelPacket
228  AcquireOneMagickPixel(const Image *,const ssize_t,const ssize_t,
229  ExceptionInfo *) magick_attribute((deprecated));
230 
232  GetMonitorHandler(void) magick_attribute((deprecated)),
234 
235 extern MagickExport MagickOffsetType
236  SizeBlob(Image *image) magick_attribute((deprecated));
237 
238 extern MagickExport MagickPixelPacket
239  InterpolatePixelColor(const Image *,CacheView *,const InterpolatePixelMethod,
240  const double,const double,ExceptionInfo *) magick_attribute((deprecated));
241 
243  ParseSizeGeometry(const Image *,const char *,RectangleInfo *)
244  magick_attribute((deprecated));
245 
246 extern MagickExport PixelPacket
247  AcquireOnePixel(const Image *,const ssize_t,const ssize_t,ExceptionInfo *)
248  magick_attribute((deprecated)),
249  AcquireOneVirtualPixel(const Image *,const VirtualPixelMethod,const ssize_t,
250  const ssize_t,ExceptionInfo *) magick_attribute((deprecated)),
251  *GetCacheView(CacheView *,const ssize_t,const ssize_t,const size_t,
252  const size_t) magick_attribute((deprecated)),
253  *GetCacheViewPixels(CacheView *,const ssize_t,const ssize_t,const size_t,
254  const size_t) magick_attribute((deprecated)),
255  *GetImagePixels(Image *,const ssize_t,const ssize_t,const size_t,
256  const size_t) magick_attribute((deprecated)),
257  GetOnePixel(Image *,const ssize_t,const ssize_t)
258  magick_attribute((deprecated)),
259  *GetPixels(const Image *) magick_attribute((deprecated)),
260  *SetCacheViewPixels(CacheView *,const ssize_t,const ssize_t,const size_t,
261  const size_t) magick_attribute((deprecated)),
262  *SetImagePixels(Image *,const ssize_t,const ssize_t,const size_t,
263  const size_t) magick_attribute((deprecated));
264 
267  sRGBCompandor(const MagickRealType) magick_attribute((deprecated));
268 
269 extern MagickExport size_t
270  GetImageListSize(const Image *) magick_attribute((deprecated)),
271  PopImagePixels(Image *,const QuantumType,unsigned char *)
272  magick_attribute((deprecated)),
273  PushImagePixels(Image *,const QuantumType,const unsigned char *)
274  magick_attribute((deprecated));
275 
276 extern MagickExport ssize_t
277  FormatMagickString(char *,const size_t,const char *,...)
278  magick_attribute((__format__ (__printf__,3,4)))
279  magick_attribute((deprecated)),
280  FormatMagickStringList(char *,const size_t,const char *,va_list)
281  magick_attribute((__format__ (__printf__,3,0))),
282  GetImageListIndex(const Image *) magick_attribute((deprecated)),
283  SetMagickRegistry(const RegistryType,const void *,const size_t,
284  ExceptionInfo *) magick_attribute((deprecated));
285 
286 extern MagickExport unsigned int
287  ChannelImage(Image *,const ChannelType) magick_attribute((deprecated)),
288  ChannelThresholdImage(Image *,const char *) magick_attribute((deprecated)),
289  DispatchImage(const Image *,const ssize_t,const ssize_t,const size_t,
290  const size_t,const char *,const StorageType,void *,ExceptionInfo *)
291  magick_attribute((deprecated)),
292  FuzzyColorMatch(const PixelPacket *,const PixelPacket *,const double)
293  magick_attribute((deprecated)),
294  GetNumberScenes(const Image *) magick_attribute((deprecated)),
295  GetMagickGeometry(const char *,ssize_t *,ssize_t *,size_t *,size_t *)
296  magick_attribute((deprecated)),
297  IsSubimage(const char *,const unsigned int) magick_attribute((deprecated)),
298  PushImageList(Image **,const Image *,ExceptionInfo *)
299  magick_attribute((deprecated)),
300  QuantizationError(Image *) magick_attribute((deprecated)),
301  RandomChannelThresholdImage(Image *,const char *,const char *,
302  ExceptionInfo *) magick_attribute((deprecated)),
303  SetImageList(Image **,const Image *,const ssize_t,ExceptionInfo *)
304  magick_attribute((deprecated)),
305  TransformColorspace(Image *,const ColorspaceType)
306  magick_attribute((deprecated)),
307  ThresholdImage(Image *,const double) magick_attribute((deprecated)),
308  ThresholdImageChannel(Image *,const char *) magick_attribute((deprecated)),
309  UnshiftImageList(Image **,const Image *,ExceptionInfo *)
310  magick_attribute((deprecated));
311 
312 extern MagickExport void
313  *AcquireMemory(const size_t) magick_attribute((deprecated)),
314  AllocateNextImage(const ImageInfo *,Image *) magick_attribute((deprecated)),
315  *CloneMemory(void *,const void *,const size_t) magick_attribute((deprecated)),
316  DestroyConstitute(void),
317  DestroyImageAttributes(Image *) magick_attribute((deprecated)),
318  DestroyImages(Image *) magick_attribute((deprecated)),
319  DestroyMagick(void) magick_attribute((deprecated)),
320  DestroyMagickRegistry(void) magick_attribute((deprecated)),
321  *GetConfigureBlob(const char *,char *,size_t *,ExceptionInfo *)
322  magick_attribute((deprecated)),
323  *GetMagickRegistry(const ssize_t,RegistryType *,size_t *,ExceptionInfo *)
324  magick_attribute((deprecated)),
326  LiberateMemory(void **) magick_attribute((deprecated)),
328  FormatString(char *,const char *,...)
329  magick_attribute((__format__ (__printf__,2,3)))
330  magick_attribute((deprecated)),
331  FormatStringList(char *,const char *,va_list)
332  magick_attribute((__format__ (__printf__,2,0)))
333  magick_attribute((deprecated)),
334  HSLTransform(const double,const double,const double,Quantum *,Quantum *,
335  Quantum *) magick_attribute((deprecated)),
336  InitializeMagick(const char *) magick_attribute((deprecated)),
337  MagickIncarnate(const char *) magick_attribute((deprecated)),
338  ReacquireMemory(void **,const size_t) magick_attribute((deprecated)),
339  ResetImageAttributeIterator(const Image *) magick_attribute((deprecated)),
340  SetCacheThreshold(const size_t) magick_attribute((deprecated)),
341  SetImage(Image *,const Quantum) magick_attribute((deprecated)),
342  Strip(char *) magick_attribute((deprecated)),
343  TemporaryFilename(char *) magick_attribute((deprecated)),
344  TransformHSL(const Quantum,const Quantum,const Quantum,double *,double *,
345  double *) magick_attribute((deprecated));
346 
347 /*
348  Inline methods.
349 */
350 static inline double MagickEpsilonReciprocal(const double x)
351 {
352  double
353  sign;
354 
355  sign=x < 0.0 ? -1.0 : 1.0;
356  if ((sign*x) >= MagickEpsilon)
357  return(1.0/x);
358  return(sign/MagickEpsilon);
359 }
360 
361 static inline Quantum PixelIntensityToQuantum(const Image *restrict image,
362  const PixelPacket *restrict pixel)
363 {
364  return(ClampToQuantum(GetPixelIntensity(image,pixel)));
365 }
366 
367 #endif
368 
369 #if defined(__cplusplus) || defined(c_plusplus)
370 }
371 #endif
372 
373 #endif