Bugfix: saved game engine runtimes failed to load library .blend
[blender.git] / source / blender / blenloader / BLO_readfile.h
1 /*
2  * $Id$
3  *
4  * ***** BEGIN GPL LICENSE BLOCK *****
5  *
6  * This program is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU General Public License
8  * as published by the Free Software Foundation; either version 2
9  * of the License, or (at your option) any later version.
10  *
11  * This program is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with this program; if not, write to the Free Software Foundation,
18  * Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
19  *
20  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
21  * All rights reserved.
22  *
23  * The Original Code is: all of this file.
24  *
25  * Contributor(s): none yet.
26  *
27  * ***** END GPL LICENSE BLOCK *****
28  * external readfile function prototypes
29  */
30 #ifndef BLO_READFILE_H
31 #define BLO_READFILE_H
32
33 #ifdef __cplusplus
34 extern "C" {
35 #endif
36
37 struct SpaceFile;
38 struct SpaceImaSel;
39 struct FileList;
40 struct LinkNode;
41 struct Main;
42 struct UserDef;
43 struct bScreen;
44 struct Scene;
45 struct MemFile;
46 struct direntry;
47
48 typedef struct BlendHandle      BlendHandle;
49
50 typedef enum BlenFileType {
51         BLENFILETYPE_BLEND= 1, 
52         BLENFILETYPE_PUB= 2, 
53         BLENFILETYPE_RUNTIME= 3
54 } BlenFileType;
55
56 typedef enum {
57         BRE_NONE, 
58         
59         BRE_UNABLE_TO_OPEN, 
60         BRE_UNABLE_TO_READ, 
61
62         BRE_OUT_OF_MEMORY, 
63         BRE_INTERNAL_ERROR, 
64
65         BRE_NOT_A_BLEND, 
66         BRE_NOT_A_PUBFILE,
67         BRE_INCOMPLETE, 
68         BRE_CORRUPT, 
69         
70         BRE_TOO_NEW, 
71         BRE_NOT_ALLOWED, 
72         
73         BRE_NO_SCREEN, 
74         BRE_NO_SCENE, 
75         
76         BRE_INVALID
77 } BlendReadError;
78
79 typedef struct BlendFileData {
80         struct Main*    main;
81         struct UserDef* user;
82
83         int winpos;
84         int fileflags;
85         int displaymode;
86         int globalf;
87
88         struct bScreen* curscreen;
89         struct Scene*   curscene;
90         
91         BlenFileType    type;
92 } BlendFileData;
93
94         /**
95          * Open a blender file from a pathname. The function
96          * returns NULL and sets the @a error_r argument if
97          * it cannot open the file.
98          * 
99          * @param file The path of the file to open.
100          * @param error_r If the return value is NULL, an error
101          * code indicating the cause of the failure.
102          * @return The data of the file.
103          */
104 BlendFileData*  BLO_read_from_file              (char *file, BlendReadError *error_r);
105
106         /**
107          * Open a blender file from memory. The function
108          * returns NULL and sets the @a error_r argument if
109          * it cannot open the file.
110          * 
111          * @param mem The file data.
112          * @param memsize The length of @a mem.
113          * @param error_r If the return value is NULL, an error
114          * code indicating the cause of the failure.
115          * @return The data of the file.
116          */
117 BlendFileData*  BLO_read_from_memory(void *mem, int memsize, BlendReadError *error_r);
118
119 /**
120  * file name is current file, only for retrieving library data */
121
122 BlendFileData *BLO_read_from_memfile(const char *filename, struct MemFile *memfile, BlendReadError *error_r);
123
124 /**
125  * Convert a BlendReadError to a human readable string.
126  * The string is static and does not need to be free'd.
127  * 
128  * @param error The error to return a string for.
129  * @return A static human readable string representation
130  * of @a error.
131  */
132  
133         char*
134 BLO_bre_as_string(
135         BlendReadError error);
136
137 /**
138  * Free's a BlendFileData structure and _all_ the
139  * data associated with it (the userdef data, and
140  * the main libblock data).
141  * 
142  * @param bfd The structure to free.
143  */
144         void
145 BLO_blendfiledata_free(
146         BlendFileData *bfd);
147
148 /**
149  * Convert an idcode into a name.
150  * 
151  * @param code The code to convert.
152  * @return A static string representing the name of
153  * the code.
154  */
155         char*
156 BLO_idcode_to_name(
157         int code);
158
159 /**
160  * Convert a name into an idcode (ie. ID_SCE)
161  * 
162  * @param name The name to convert.
163  * @return The code for the name, or 0 if invalid.
164  */
165         int
166 BLO_idcode_from_name(
167         char *name);
168         
169 /**
170  * Open a blendhandle from a file path.
171  * 
172  * @param file The file path to open.
173  * @return A handle on success, or NULL on failure.
174  */
175         BlendHandle*
176 BLO_blendhandle_from_file(
177         char *file);
178
179 /**
180  * Gets the names of all the datablocks in a file
181  * of a certain type (ie. All the scene names in
182  * a file).
183  * 
184  * @param bh The blendhandle to access.
185  * @param ofblocktype The type of names to get.
186  * @return A BLI_linklist of strings. The string links
187  * should be freed with malloc.
188  */
189         struct LinkNode*
190 BLO_blendhandle_get_datablock_names(
191         BlendHandle *bh, 
192         int ofblocktype);
193
194 /**
195  * Gets the previews of all the datablocks in a file
196  * of a certain type (ie. All the scene names in
197  * a file).
198  * 
199  * @param bh The blendhandle to access.
200  * @param ofblocktype The type of names to get.
201  * @return A BLI_linklist of PreviewImage. The PreviewImage links
202  * should be freed with malloc.
203  */
204         struct LinkNode*
205 BLO_blendhandle_get_previews(
206         BlendHandle *bh, 
207         int ofblocktype);
208
209 /**
210  * Gets the names of all the datablock groups in a
211  * file. (ie. file contains Scene, Mesh, and Lamp
212  * datablocks).
213  * 
214  * @param bh The blendhandle to access.
215  * @return A BLI_linklist of strings. The string links
216  * should be freed with malloc.
217  */
218         struct LinkNode*
219 BLO_blendhandle_get_linkable_groups(
220         BlendHandle *bh);
221
222 /**
223  * Close and free a blendhandle. The handle
224  * becomes invalid after this call.
225  *
226  * @param bh The handle to close.
227  */
228         void
229 BLO_blendhandle_close(
230         BlendHandle *bh);
231         
232         /***/
233
234 char *BLO_gethome(void);
235 int BLO_has_bfile_extension(char *str);
236 void BLO_library_append(struct SpaceFile *sfile, char *dir, int idcode);
237 void BLO_library_append_(BlendHandle **libfiledata, struct direntry* filelist, int totfile, char *dir, char* file, short flag, int idcode);
238 void BLO_script_library_append(BlendHandle **bh, char *dir, char *name, int idcode, short flag, struct Scene *scene);
239
240 BlendFileData* blo_read_blendafterruntime(int file, char *name, int actualsize, BlendReadError *error_r);
241
242 #ifdef __cplusplus
243
244 #endif
245
246 #endif
247