svn merge -r36651:36672 https://svn.blender.org/svnroot/bf-blender/trunk/blender
[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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, 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 struct ImMetaData;
52
53 #define IB_MIPMAP_LEVELS        20
54 #define IB_FILENAME_SIZE        1023
55
56 /**
57  * \ingroup imbuf
58  * This is the abstraction of an image.  ImBuf is the basic type used for all
59  * imbuf operations.
60  *
61  * REMINDER: if any changes take place, they need to be carried over
62  * to source/blender/blenpluginapi/iff.h too, OTHERWISE PLUGINS WON'T
63  * WORK CORRECTLY!
64  *
65  * Also; add new variables to the end to save pain!
66  *
67  * Also, that iff.h needs to be in the final release "plugins/include" dir, too!
68  */
69 typedef struct ImBuf {
70         struct ImBuf *next, *prev;      /**< allow lists of ImBufs, for caches or flipbooks */
71
72         /* dimensions */
73         int x, y;                               /* width and Height of our image buffer.
74                                                          * Should be 'unsigned int' since most formats use this.
75                                                          * but this is problematic with texture math in imagetexture.c
76                                                          * avoid problems and use int. - campbell */
77
78         unsigned char depth;    /* Active amount of bits/bitplanes */
79         int channels;                   /* amount of channels in rect_float (0 = 4 channel default) */
80
81         /* flags */
82         int     flags;                          /* Controls which components should exist. */
83         int     mall;                           /* what is malloced internal, and can be freed */
84
85         /* pixels */
86         unsigned int *rect;             /* pixel values stored here */
87         float *rect_float;              /* floating point Rect equivalent
88                                                         Linear RGB color space - may need gamma correction to 
89                                                         sRGB when generating 8bit representations */
90
91 #ifdef WITH_LCMS
92         unsigned int *crect;    /* color corrected pixel values stored here */
93         char profile_filename[256];     /* to be implemented properly, specific filename for custom profiles */
94 #endif
95
96         /* resolution - pixels per meter */
97         double ppm[2];
98
99         /* tiled pixel storage */
100         int tilex, tiley;
101         int xtiles, ytiles;
102         unsigned int **tiles;   
103
104         /* zbuffer */
105         int     *zbuf;                          /* z buffer data, original zbuffer */
106         float *zbuf_float;              /* z buffer data, camera coordinates */
107
108         /* parameters used by conversion between byte and float */
109         float dither;                           /* random dither value, for conversion from float -> byte rect */
110         short profile;                          /* color space/profile preset that the byte rect buffer represents */
111
112         /* mipmapping */
113         struct ImBuf *mipmap[IB_MIPMAP_LEVELS]; /* MipMap levels, a series of halved images */
114         int miptot, miplevel;
115
116         /* externally used data */
117         int index;                                              /* reference index for ImBuf lists */
118         int     userflags;                                      /* used to set imbuf to dirty and other stuff */
119         struct ImMetaData *metadata;    /* image metadata */
120         void *userdata;                                 /* temporary storage, only used by baking at the moment */
121
122         /* file information */
123         int     ftype;                                                  /* file type we are going to save as */
124         char name[IB_FILENAME_SIZE];            /* filename associated with this image */
125         char cachename[IB_FILENAME_SIZE];       /* full filename used for reading from cache */
126
127         /* memory cache limiter */
128         struct MEM_CacheLimiterHandle_s *c_handle; /* handle for cache limiter */
129         int refcounter; /* reference counter for multiple users */
130
131         /* some parameters to pass along for packing images */
132         unsigned char *encodedbuffer;     /* Compressed image only used with png currently */
133         unsigned int   encodedsize;       /* Size of data written to encodedbuffer */
134         unsigned int   encodedbuffersize; /* Size of encodedbuffer */
135 } ImBuf;
136
137 /* Moved from BKE_bmfont_types.h because it is a userflag bit mask. */
138 /**
139  * \brief userflags: Flags used internally by blender for imagebuffers
140  */
141
142 #define IB_BITMAPFONT           (1 << 0)        /* this image is a font */
143 #define IB_BITMAPDIRTY          (1 << 1)        /* image needs to be saved is not the same as filename */
144 #define IB_MIPMAP_INVALID       (1 << 2)        /* image mipmaps are invalid, need recreate */
145 #define IB_RECT_INVALID         (1 << 3)    /* float buffer changed, needs recreation of byte rect */
146
147 /**
148  * \name Imbuf Component flags
149  * \brief These flags determine the components of an ImBuf struct.
150  */
151 /**@{*/
152 /** \brief Flag defining the components of the ImBuf struct. */
153
154 #define IB_rect                         (1 << 0)
155 #define IB_test                         (1 << 1)
156 #define IB_fields                       (1 << 2)
157 #define IB_zbuf                         (1 << 3)
158 #define IB_mem                          (1 << 4)
159 #define IB_rectfloat            (1 << 5)
160 #define IB_zbuffloat            (1 << 6)
161 #define IB_multilayer           (1 << 7)
162 #define IB_metadata                     (1 << 8)
163 #define IB_animdeinterlace      (1 << 9)
164 #define IB_tiles                        (1 << 10)
165 #define IB_tilecache            (1 << 11)
166 #define IB_premul                       (1 << 12)
167
168 /*
169  * The bit flag is stored in the ImBuf.ftype variable.
170  * Note that the lower 10 bits is used for storing custom flags 
171  */
172 #define PNG                             (1 << 30)
173 #define TGA                             (1 << 28)
174 #define JPG                             (1 << 27)
175 #define BMP                             (1 << 26)
176
177 #ifdef WITH_QUICKTIME
178 #define QUICKTIME               (1 << 25)
179 #endif
180
181 #ifdef WITH_HDR
182 #define RADHDR                  (1 << 24)
183 #endif
184 #ifdef WITH_TIFF
185 #define TIF                             (1 << 23)
186 #define TIF_16BIT               (1 << 8 )
187 #endif
188
189 #define OPENEXR                 (1 << 22)
190 #define OPENEXR_HALF    (1 << 8 )
191 #define OPENEXR_COMPRESS (7)    
192
193 #ifdef WITH_CINEON
194 #define CINEON                  (1 << 21)
195 #define DPX                             (1 << 20)
196 #endif
197
198 #ifdef WITH_DDS
199 #define DDS                             (1 << 19)
200 #endif
201
202 #ifdef WITH_OPENJPEG
203 #define JP2                             (1 << 18)
204 #define JP2_12BIT               (1 << 17)
205 #define JP2_16BIT               (1 << 16)
206 #define JP2_YCC                 (1 << 15)
207 #define JP2_CINE                (1 << 14)
208 #define JP2_CINE_48FPS  (1 << 13) 
209 #endif
210
211 #define RAWTGA          (TGA | 1)
212
213 #define JPG_STD         (JPG | (0 << 8))
214 #define JPG_VID         (JPG | (1 << 8))
215 #define JPG_JST         (JPG | (2 << 8))
216 #define JPG_MAX         (JPG | (3 << 8))
217 #define JPG_MSK         (0xffffff00)
218
219 #define IMAGIC                  0732
220
221 /**
222  * \name Imbuf preset profile tags
223  * \brief Some predefined color space profiles that 8 bit imbufs can represent
224  */
225 #define IB_PROFILE_NONE                 0
226 #define IB_PROFILE_LINEAR_RGB   1
227 #define IB_PROFILE_SRGB                 2
228 #define IB_PROFILE_CUSTOM               3
229
230 extern const char *imb_ext_image[];
231 extern const char *imb_ext_image_qt[];
232 extern const char *imb_ext_movie[];
233 extern const char *imb_ext_audio[];
234
235 #endif