This looks like a lot but its a few small changes.
[blender.git] / source / blender / imbuf / readme.txt
1 The following 4 steps to adding a new image format to blender, its
2 probably easiest to look at the png code for a clean clear example,
3 animation formats are a bit more complicated but very similar:
4
5 Step 1:
6 create a new file named after the format for example lets say we were
7 creating an openexr read/writer  use openexr.c
8 It should contain functions to match the following prototypes:
9
10 struct ImBuf *imb_loadopenexr(unsigned char *mem,int size,int flags);
11 /* Use one of the following depending on whats easyer for your file format */
12 short imb_saveopenexr(struct ImBuf *ibuf, FILE myfile, int flags);
13 short imb_saveopenexr(struct ImBuf *ibuf, char *myfile, int flags);
14
15 /* Used to test if its the correct format
16 int IMB_is_openexr(void *buf);
17
18 Step 2: 
19 Add your hooks to read and write the image format these go in
20         writeimage.c and readimage.c  just look at how the others are done
21
22 Step 3: 
23 Add in IS_openexr to blender/source/blender/imbuf/IMB_imbuf_types.h
24
25 Step 4: 
26 Add any external library info to the build process.
27