2 Copyright 1999-2012 ImageMagick Studio LLC, a non-profit organization
3 dedicated to making software imaging solutions freely available.
5 You may not use this file except in compliance with the License.
6 obtain a copy of the License at
8 http://www.imagemagick.org/script/license.php
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.
16 MagickCore image pixel methods.
18 #ifndef _MAGICKCORE_PIXEL_H
19 #define _MAGICKCORE_PIXEL_H
21 #if defined(__cplusplus) || defined(c_plusplus)
25 #include <MagickCore/colorspace.h>
27 #define MaxPixelChannels 32
32 UndefinedChannel = 0x0000,
36 GreenChannel = 0x0002,
37 MagentaChannel = 0x0002,
39 YellowChannel = 0x0004,
40 BlackChannel = 0x0008,
41 AlphaChannel = 0x0010,
42 OpacityChannel = 0x0010,
43 IndexChannel = 0x0020,
46 CompositeChannels = 0x002F,
47 AllChannels = 0x7ffffff,
49 Special purpose channel types.
50 FUTURE: are these needed any more - they are more like hacks
51 SyncChannels for example is NOT a real channel but a 'flag'
52 It really says -- "User has not defined channels"
54 TrueAlphaChannel = 0x0100, /* extract actual alpha channel from opacity */
55 RGBChannels = 0x0200, /* set alpha from grayscale mask in RGB */
56 GrayChannels = 0x0400,
57 SyncChannels = 0x20000, /* channels modified as a single unit */
58 DefaultChannels = ((AllChannels | SyncChannels) &~ AlphaChannel)
59 } ChannelType; /* must correspond to PixelChannel */
63 UndefinedInterpolatePixel,
64 AverageInterpolatePixel, /* Average 4 nearest neighbours */
65 Average9InterpolatePixel, /* Average 9 nearest neighbours */
66 Average16InterpolatePixel, /* Average 16 nearest neighbours */
67 BackgroundInterpolatePixel, /* Just return background color */
68 BilinearInterpolatePixel, /* Triangular filter interpolation */
69 BlendInterpolatePixel, /* blend of nearest 1, 2 or 4 pixels */
70 CatromInterpolatePixel, /* Catmull-Rom interpolation */
71 IntegerInterpolatePixel, /* Integer (floor) interpolation */
72 MeshInterpolatePixel, /* Triangular Mesh interpolation */
73 NearestInterpolatePixel, /* Nearest Neighbour Only */
74 SplineInterpolatePixel /* Cubic Spline (blurred) interpolation */
75 /* FilterInterpolatePixel, ** Use resize filter - (very slow) */
76 } PixelInterpolateMethod;
80 UndefinedPixelChannel = 0,
87 GreenPixelChannel = 1,
88 MagentaPixelChannel = 1,
92 YellowPixelChannel = 2,
94 BlackPixelChannel = 3,
95 AlphaPixelChannel = 4,
96 IndexPixelChannel = 5,
97 MaskPixelChannel = 6, /* Image Write Mask */
98 MetaPixelChannel = 7, /* ??? */
99 IntensityPixelChannel = MaxPixelChannels, /* what are these ??? */
100 CompositePixelChannel = MaxPixelChannels,
101 SyncPixelChannel = MaxPixelChannels+1
102 } PixelChannel; /* must correspond to ChannelType */
106 UndefinedPixelTrait = 0x000000,
107 CopyPixelTrait = 0x000001,
108 UpdatePixelTrait = 0x000002,
109 BlendPixelTrait = 0x000004
112 typedef struct _PixelChannelMap
124 typedef struct _PixelInfo
153 typedef struct _PixelPacket
175 typedef struct _CacheView
178 extern MagickExport ChannelType
179 SetPixelChannelMask(Image *,const ChannelType);
181 extern MagickExport MagickBooleanType
182 ExportImagePixels(Image *,const ssize_t,const ssize_t,const size_t,
183 const size_t,const char *,const StorageType,void *,ExceptionInfo *),
184 ImportImagePixels(Image *,const ssize_t,const ssize_t,const size_t,
185 const size_t,const char *,const StorageType,const void *,ExceptionInfo *),
186 InterpolatePixelChannel(const Image *,const CacheView_ *,
187 const PixelChannel,const PixelInterpolateMethod,const double,const double,
188 double *,ExceptionInfo *),
189 InterpolatePixelChannels(const Image *,const CacheView_ *,const Image *,
190 const PixelInterpolateMethod,const double,const double,Quantum *,
192 InterpolatePixelInfo(const Image *,const CacheView_ *,
193 const PixelInterpolateMethod,const double,const double,PixelInfo *,
195 IsFuzzyEquivalencePixel(const Image *,const Quantum *,const Image *,
197 IsFuzzyEquivalencePixelInfo(const PixelInfo *,const PixelInfo *),
198 SetPixelMetaChannels(Image *,const size_t,ExceptionInfo *);
200 extern MagickExport PixelChannelMap
201 *AcquirePixelChannelMap(void),
202 *ClonePixelChannelMap(PixelChannelMap *),
203 *DestroyPixelChannelMap(PixelChannelMap *);
205 extern MagickExport PixelInfo
206 *ClonePixelInfo(const PixelInfo *);
208 extern MagickExport void
209 InitializePixelChannelMap(Image *),
210 GetPixelInfo(const Image *,PixelInfo *),
211 SetPixelChannelMapMask(Image *,const ChannelType);
213 #if defined(__cplusplus) || defined(c_plusplus)