deprecate.h 17 KB

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