2.5 - node editor
[blender-staging.git] / source / blender / imbuf / IMB_imbuf_types.h
1 /**
2  * IMB_imbuf_types.h (mar-2001 nzc)
3  *
4  * Types needed for using the image buffer.
5  *
6  * Imbuf is external code, slightly adapted to live in the Blender
7  * context. It requires an external jpeg module, and the avi-module
8  * (also external code) in order to function correctly.
9  *
10  * This file contains types and some constants that go with them. Most
11  * are self-explanatory (e.g. IS_amiga tests whether the buffer
12  * contains an Amiga-format file).
13  *
14  * $Id$ 
15  *
16  * ***** BEGIN GPL LICENSE BLOCK *****
17  *
18  * This program is free software; you can redistribute it and/or
19  * modify it under the terms of the GNU General Public License
20  * as published by the Free Software Foundation; either version 2
21  * of the License, or (at your option) any later version.
22  *
23  * This program is distributed in the hope that it will be useful,
24  * but WITHOUT ANY WARRANTY; without even the implied warranty of
25  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
26  * GNU General Public License for more details.
27  *
28  * You should have received a copy of the GNU General Public License
29  * along with this program; if not, write to the Free Software Foundation,
30  * Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
31  *
32  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
33  * All rights reserved.
34  *
35  * The Original Code is: all of this file.
36  *
37  * Contributor(s): none yet.
38  *
39  * ***** END GPL LICENSE BLOCK *****
40  */
41 /**
42  * \file IMB_imbuf_types.h
43  * \ingroup imbuf
44  * \brief Contains defines and structs used throughout the imbuf module.
45  * \todo Clean up includes.
46  */
47
48 #ifndef IMB_IMBUF_TYPES_H
49 #define IMB_IMBUF_TYPES_H
50
51 #include <stdio.h>        /* for size_t */
52 #include "DNA_listBase.h" /* for ListBase */
53 struct _AviMovie;
54 struct Mdec;
55
56 struct ImgInfo;
57
58 #define IB_MIPMAP_LEVELS        10
59
60 /**
61  * \brief The basic imbuf type
62  * \ingroup imbuf
63  * This is the abstraction of an image.  ImBuf is the basic type used for all
64  * imbuf operations.
65  *
66  * REMINDER: if any changes take place, they need to be carried over
67  * to source/blender/blenpluginapi/iff.h too, OTHERWISE PLUGINS WON'T
68  * WORK CORRECTLY!
69  *
70  * Also; add new variables to the end to save pain!
71  *
72  * Also, that iff.h needs to be in the final release "plugins/include" dir, too!
73  */
74 typedef struct ImBuf {
75         struct ImBuf *next, *prev;      /**< allow lists of ImBufs, for caches or flipbooks */
76         short   x, y;                           /**< width and Height of our image buffer */
77         short   skipx;                          /**< Width in ints to get to the next scanline */
78         unsigned char   depth;          /**< Active amount of bits/bitplanes */
79         unsigned char   cbits;          /**< Amount of active bits in cmap */
80         unsigned short  mincol;         /**< smallest color in colormap */
81         unsigned short  maxcol;         /**< Largest color in colormap */
82         int     type;                                   /**< 0=abgr, 1=bitplanes */
83         int     ftype;                                  /**< File type we are going to save as */
84         unsigned int    *cmap;          /**< Color map data. */
85         unsigned int    *rect;          /**< pixel values stored here */
86         unsigned int    **planes;       /**< bitplanes */
87         int     flags;                          /**< Controls which components should exist. */
88         int     mall;                           /**< what is malloced internal, and can be freed */
89         short   xorig, yorig;           /**< Cordinates of first pixel of an image used in some formats (example: targa) */
90         char    name[1023];             /**< The file name assocated with this image */
91         char    namenull;               /**< Unused don't want to remove it thought messes things up */
92         int     userflags;                      /**< Used to set imbuf to Dirty and other stuff */
93         int     *zbuf;                          /**< z buffer data, original zbuffer */
94         float *zbuf_float;              /**< z buffer data, camera coordinates */
95         void *userdata;                 /**< temporary storage, only used by baking at the moment */
96         unsigned char *encodedbuffer;     /**< Compressed image only used with png currently */
97         unsigned int   encodedsize;       /**< Size of data written to encodedbuffer */
98         unsigned int   encodedbuffersize; /**< Size of encodedbuffer */
99
100         float *rect_float;              /**< floating point Rect equivilant */
101         int channels;                   /**< amount of channels in rect_float (0 = 4 channel default) */
102         float dither;                   /**< random dither value, for conversion from float -> byte rect */
103         
104         struct MEM_CacheLimiterHandle_s * c_handle; /**< handle for cache limiter */
105         struct ImgInfo * img_info;
106         int refcounter;                 /**< Refcounter for multiple users */
107         int index;                              /**< reference index for ImBuf lists */
108         
109         struct ImBuf *mipmap[IB_MIPMAP_LEVELS]; /**< MipMap levels, a series of halved images */
110 } ImBuf;
111
112 /* Moved from BKE_bmfont_types.h because it is a userflag bit mask. */
113 /**
114  * \brief Flags used internally by blender for imagebuffers
115  */
116 typedef enum {
117         IB_BITMAPFONT = 1 << 0,         /* This image is a font */
118         IB_BITMAPDIRTY = 1 << 1         /* Image needs to be saved is not the same as filename */
119 } ImBuf_userflagsMask;
120
121
122 /* From iff.h. This was once moved away by Frank, now Nzc moves it
123  * back. Such is the way it is... It is a long list of defines, and
124  * there are a few external defines in the back. Most of the stuff is
125  * probably imbuf_intern only. This will need to be merged later
126  * on. */
127
128 /**
129  * \name Imbuf Component flags
130  * \brief These flags determine the components of an ImBuf struct.
131  */
132 /**@{*/
133 /** \brief Flag defining the components of the ImBuf struct. */
134 #define IB_rect                 (1 << 0)
135 #define IB_planes               (1 << 1)
136 #define IB_cmap                 (1 << 2)
137
138 #define IB_vert                 (1 << 4)
139 #define IB_freem                (1 << 6)
140 #define IB_test                 (1 << 7)
141
142 #define IB_ttob                 (1 << 8)
143 #define IB_subdlta              (1 << 9)
144 #define IB_fields               (1 << 11)
145 #define IB_zbuf                 (1 << 13)
146
147 #define IB_mem                  (1 << 14)
148 #define IB_rectfloat    (1 << 15)
149 #define IB_zbuffloat    (1 << 16)
150 #define IB_multilayer   (1 << 17)
151 #define IB_imginfo              (1 << 18)
152 #define IB_animdeinterlace      (1 << 19)
153
154 /*
155  * The bit flag is stored in the ImBuf.ftype variable.
156  * Note that the lower 10 bits is used for storing custom flags 
157  */
158 #define AMI                             (1 << 31)
159 #define PNG                             (1 << 30)
160 #define Anim            (1 << 29)
161 #define TGA                             (1 << 28)
162 #define JPG                             (1 << 27)
163 #define BMP                             (1 << 26)
164
165 #ifdef WITH_QUICKTIME
166 #define QUICKTIME               (1 << 25)
167 #endif
168
169 #define RADHDR                  (1 << 24)
170 #define TIF                             (1 << 23)
171 #define TIF_16BIT               (1 << 8 )
172
173 #define OPENEXR                 (1 << 22)
174 #define OPENEXR_HALF    (1 << 8 )
175 #define OPENEXR_COMPRESS (7)    
176
177 #define CINEON                  (1 << 21)
178 #define DPX                             (1 << 20)
179
180 #ifdef WITH_DDS
181 #define DDS                             (1 << 19)
182 #endif
183
184 #define RAWTGA          (TGA | 1)
185
186 #define JPG_STD         (JPG | (0 << 8))
187 #define JPG_VID         (JPG | (1 << 8))
188 #define JPG_JST         (JPG | (2 << 8))
189 #define JPG_MAX         (JPG | (3 << 8))
190 #define JPG_MSK         (0xffffff00)
191
192 #define AM_ham          (0x0800 | AMI)
193 #define AM_hbrite       (0x0080 | AMI)
194
195 #define C233    1
196 #define YUVX    2
197 #define HAMX    3
198 #define TANX    4
199
200 #define AN_c233                 (Anim | C233)
201 #define AN_yuvx                 (Anim | YUVX)
202 #define AN_hamx                 (Anim | HAMX)
203 #define AN_tanx                 (Anim | TANX)
204 /**@}*/
205
206 /** \name Imbuf File Type Tests
207  * \brief These macros test if an ImBuf struct is the corresponding file type.
208  */
209 /**@{*/
210 /** \brief Tests the ImBuf.ftype variable for the file format. */
211 #define IS_amiga(x)             (x->ftype & AMI)
212 #define IS_ham(x)               ((x->ftype & AM_ham) == AM_ham)
213 #define IS_hbrite(x)    ((x->ftype & AM_hbrite) == AM_hbrite)
214
215 #define IS_anim(x)              (x->ftype & Anim)
216 #define IS_hamx(x)              (x->ftype == AN_hamx)
217 #define IS_tga(x)               (x->ftype & TGA)
218 #define IS_png(x)               (x->ftype & PNG)
219 #define IS_openexr(x)   (x->ftype & OPENEXR)
220 #define IS_cineon(x)    (x->ftype & CINEON)
221 #define IS_dpx(x)               (x->ftype & DPX)
222 #define IS_bmp(x)               (x->ftype & BMP)
223 #define IS_tiff(x)              (x->ftype & TIF)
224 #define IS_radhdr(x)    (x->ftype & RADHDR)
225
226 #ifdef WITH_DDS
227 #define IS_dds(x)               (x->ftype & DDS)
228 #endif
229
230 #define IMAGIC  0732
231 #define IS_iris(x)              (x->ftype == IMAGIC)
232
233 #define IS_jpg(x)               (x->ftype & JPG)
234 #define IS_stdjpg(x)    ((x->ftype & JPG_MSK) == JPG_STD)
235 #define IS_vidjpg(x)    ((x->ftype & JPG_MSK) == JPG_VID)
236 #define IS_jstjpg(x)    ((x->ftype & JPG_MSK) == JPG_JST)
237 #define IS_maxjpg(x)    ((x->ftype & JPG_MSK) == JPG_MAX)
238 /**@}*/
239
240 #endif
241