small merge needed for testing new animsys in 2.5 BGE, mixing own changes with merge...
[blender.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    *crect;         /**< color corrected pixel values stored here */
87         unsigned int    **planes;       /**< bitplanes */
88         int     flags;                          /**< Controls which components should exist. */
89         int     mall;                           /**< what is malloced internal, and can be freed */
90         short   xorig, yorig;           /**< Cordinates of first pixel of an image used in some formats (example: targa) */
91         char    name[1023];             /**< The file name assocated with this image */
92         char    namenull;               /**< Unused don't want to remove it thought messes things up */
93         int     userflags;                      /**< Used to set imbuf to Dirty and other stuff */
94         int     *zbuf;                          /**< z buffer data, original zbuffer */
95         float *zbuf_float;              /**< z buffer data, camera coordinates */
96         void *userdata;                 /**< temporary storage, only used by baking at the moment */
97         unsigned char *encodedbuffer;     /**< Compressed image only used with png currently */
98         unsigned int   encodedsize;       /**< Size of data written to encodedbuffer */
99         unsigned int   encodedbuffersize; /**< Size of encodedbuffer */
100
101         float *rect_float;              /**< floating point Rect equivalent */
102         int channels;                   /**< amount of channels in rect_float (0 = 4 channel default) */
103         float dither;                   /**< random dither value, for conversion from float -> byte rect */
104         
105         struct MEM_CacheLimiterHandle_s * c_handle; /**< handle for cache limiter */
106         struct ImgInfo * img_info;
107         int refcounter;                 /**< Refcounter for multiple users */
108         int index;                              /**< reference index for ImBuf lists */
109         
110         struct ImBuf *mipmap[IB_MIPMAP_LEVELS]; /**< MipMap levels, a series of halved images */
111 } ImBuf;
112
113 /* Moved from BKE_bmfont_types.h because it is a userflag bit mask. */
114 /**
115  * \brief Flags used internally by blender for imagebuffers
116  */
117 typedef enum {
118         IB_BITMAPFONT = 1 << 0,         /* This image is a font */
119         IB_BITMAPDIRTY = 1 << 1         /* Image needs to be saved is not the same as filename */
120 } ImBuf_userflagsMask;
121
122
123 /* From iff.h. This was once moved away by Frank, now Nzc moves it
124  * back. Such is the way it is... It is a long list of defines, and
125  * there are a few external defines in the back. Most of the stuff is
126  * probably imbuf_intern only. This will need to be merged later
127  * on. */
128
129 /**
130  * \name Imbuf Component flags
131  * \brief These flags determine the components of an ImBuf struct.
132  */
133 /**@{*/
134 /** \brief Flag defining the components of the ImBuf struct. */
135 #define IB_rect                 (1 << 0)
136 #define IB_planes               (1 << 1)
137 #define IB_cmap                 (1 << 2)
138
139 #define IB_vert                 (1 << 4)
140 #define IB_freem                (1 << 6)
141 #define IB_test                 (1 << 7)
142
143 #define IB_ttob                 (1 << 8)
144 #define IB_subdlta              (1 << 9)
145 #define IB_fields               (1 << 11)
146 #define IB_zbuf                 (1 << 13)
147
148 #define IB_mem                  (1 << 14)
149 #define IB_rectfloat    (1 << 15)
150 #define IB_zbuffloat    (1 << 16)
151 #define IB_multilayer   (1 << 17)
152 #define IB_imginfo              (1 << 18)
153 #define IB_animdeinterlace      (1 << 19)
154
155 /*
156  * The bit flag is stored in the ImBuf.ftype variable.
157  * Note that the lower 10 bits is used for storing custom flags 
158  */
159 #define AMI                             (1 << 31)
160 #define PNG                             (1 << 30)
161 #define Anim            (1 << 29)
162 #define TGA                             (1 << 28)
163 #define JPG                             (1 << 27)
164 #define BMP                             (1 << 26)
165
166 #ifdef WITH_QUICKTIME
167 #define QUICKTIME               (1 << 25)
168 #endif
169
170 #define RADHDR                  (1 << 24)
171 #define TIF                             (1 << 23)
172 #define TIF_16BIT               (1 << 8 )
173
174 #define OPENEXR                 (1 << 22)
175 #define OPENEXR_HALF    (1 << 8 )
176 #define OPENEXR_COMPRESS (7)    
177
178 #define CINEON                  (1 << 21)
179 #define DPX                             (1 << 20)
180
181 #ifdef WITH_DDS
182 #define DDS                             (1 << 19)
183 #endif
184
185 #ifdef WITH_OPENJPEG
186 #define JP2                             (1 << 18)
187 #define JP2_12BIT                       (1 << 17)
188 #define JP2_16BIT                       (1 << 16)
189 #define JP2_YCC                 (1 << 15)
190 #define JP2_CINE                        (1 << 14)
191 #define JP2_CINE_48FPS          (1 << 13) 
192 #endif
193
194 #define RAWTGA          (TGA | 1)
195
196 #define JPG_STD         (JPG | (0 << 8))
197 #define JPG_VID         (JPG | (1 << 8))
198 #define JPG_JST         (JPG | (2 << 8))
199 #define JPG_MAX         (JPG | (3 << 8))
200 #define JPG_MSK         (0xffffff00)
201
202 #define AM_ham          (0x0800 | AMI)
203 #define AM_hbrite       (0x0080 | AMI)
204
205 #define C233    1
206 #define YUVX    2
207 #define HAMX    3
208 #define TANX    4
209
210 #define AN_c233                 (Anim | C233)
211 #define AN_yuvx                 (Anim | YUVX)
212 #define AN_hamx                 (Anim | HAMX)
213 #define AN_tanx                 (Anim | TANX)
214 /**@}*/
215
216 /** \name Imbuf File Type Tests
217  * \brief These macros test if an ImBuf struct is the corresponding file type.
218  */
219 /**@{*/
220 /** \brief Tests the ImBuf.ftype variable for the file format. */
221 #define IS_amiga(x)             (x->ftype & AMI)
222 #define IS_ham(x)               ((x->ftype & AM_ham) == AM_ham)
223 #define IS_hbrite(x)    ((x->ftype & AM_hbrite) == AM_hbrite)
224
225 #define IS_anim(x)              (x->ftype & Anim)
226 #define IS_hamx(x)              (x->ftype == AN_hamx)
227 #define IS_tga(x)               (x->ftype & TGA)
228 #define IS_png(x)               (x->ftype & PNG)
229 #define IS_openexr(x)   (x->ftype & OPENEXR)
230 #define IS_jp2(x)              (x->ftype & JP2)
231 #define IS_cineon(x)    (x->ftype & CINEON)
232 #define IS_dpx(x)               (x->ftype & DPX)
233 #define IS_bmp(x)               (x->ftype & BMP)
234 #define IS_tiff(x)              (x->ftype & TIF)
235 #define IS_radhdr(x)    (x->ftype & RADHDR)
236
237 #ifdef WITH_DDS
238 #define IS_dds(x)               (x->ftype & DDS)
239 #endif
240
241 #define IMAGIC  0732
242 #define IS_iris(x)              (x->ftype == IMAGIC)
243
244 #define IS_jpg(x)               (x->ftype & JPG)
245 #define IS_stdjpg(x)    ((x->ftype & JPG_MSK) == JPG_STD)
246 #define IS_vidjpg(x)    ((x->ftype & JPG_MSK) == JPG_VID)
247 #define IS_jstjpg(x)    ((x->ftype & JPG_MSK) == JPG_JST)
248 #define IS_maxjpg(x)    ((x->ftype & JPG_MSK) == JPG_MAX)
249 /**@}*/
250
251 #endif
252