Fix paste/append w/ local-view
[blender.git] / source / blender / blenloader / BLO_readfile.h
1 /*
2  * ***** BEGIN GPL LICENSE BLOCK *****
3  *
4  * This program is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU General Public License
6  * as published by the Free Software Foundation; either version 2
7  * of the License, or (at your option) any later version.
8  *
9  * This program is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12  * GNU General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software Foundation,
16  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
17  *
18  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
19  * All rights reserved.
20  *
21  * The Original Code is: all of this file.
22  *
23  * Contributor(s): none yet.
24  *
25  * ***** END GPL LICENSE BLOCK *****
26  */
27 #ifndef __BLO_READFILE_H__
28 #define __BLO_READFILE_H__
29
30 /** \file BLO_readfile.h
31  *  \ingroup blenloader
32  *  \brief external readfile function prototypes.
33  */
34
35 #ifdef __cplusplus
36 extern "C" {
37 #endif
38
39 struct BlendThumbnail;
40 struct bScreen;
41 struct LinkNode;
42 struct ListBase;
43 struct Main;
44 struct MemFile;
45 struct ReportList;
46 struct Scene;
47 struct ViewLayer;
48 struct UserDef;
49 struct View3D;
50 struct bContext;
51 struct BHead;
52 struct FileData;
53 struct wmWindowManager;
54
55 typedef struct BlendHandle BlendHandle;
56
57 typedef enum eBlenFileType {
58         BLENFILETYPE_BLEND = 1,
59         BLENFILETYPE_PUB = 2,
60         BLENFILETYPE_RUNTIME = 3
61 } eBlenFileType;
62
63 typedef struct BlendFileData {
64         struct Main *main;
65         struct UserDef *user;
66
67         int fileflags;
68         int globalf;
69         char filename[1024];    /* 1024 = FILE_MAX */
70
71         struct bScreen *curscreen; /* TODO think this isn't needed anymore? */
72         struct Scene *curscene;
73         struct ViewLayer *cur_view_layer; /* layer to activate in workspaces when reading without UI */
74
75         eBlenFileType type;
76 } BlendFileData;
77
78 typedef struct WorkspaceConfigFileData {
79         struct Main *main; /* has to be freed when done reading file data */
80
81         struct ListBase workspaces;
82 } WorkspaceConfigFileData;
83
84 struct BlendFileReadParams {
85         uint skip_flags : 2;  /* eBLOReadSkip */
86         uint is_startup : 1;
87 };
88
89 /* skip reading some data-block types (may want to skip screen data too). */
90 typedef enum eBLOReadSkip {
91         BLO_READ_SKIP_NONE          = 0,
92         BLO_READ_SKIP_USERDEF       = (1 << 0),
93         BLO_READ_SKIP_DATA          = (1 << 1),
94 } eBLOReadSkip;
95 #define BLO_READ_SKIP_ALL \
96         (BLO_READ_SKIP_USERDEF | BLO_READ_SKIP_DATA)
97
98 BlendFileData *BLO_read_from_file(
99         const char *filepath,
100         eBLOReadSkip skip_flags,
101         struct ReportList *reports);
102 BlendFileData *BLO_read_from_memory(
103         const void *mem, int memsize,
104         eBLOReadSkip skip_flags,
105         struct ReportList *reports);
106 BlendFileData *BLO_read_from_memfile(
107         struct Main *oldmain, const char *filename, struct MemFile *memfile,
108         eBLOReadSkip skip_flags,
109         struct ReportList *reports);
110
111 void BLO_blendfiledata_free(BlendFileData *bfd);
112
113 BlendHandle *BLO_blendhandle_from_file(const char *filepath, struct ReportList *reports);
114 BlendHandle *BLO_blendhandle_from_memory(const void *mem, int memsize);
115
116 struct LinkNode *BLO_blendhandle_get_datablock_names(BlendHandle *bh, int ofblocktype, int *tot_names);
117 struct LinkNode *BLO_blendhandle_get_previews(BlendHandle *bh, int ofblocktype, int *tot_prev);
118 struct LinkNode *BLO_blendhandle_get_linkable_groups(BlendHandle *bh);
119
120 void BLO_blendhandle_close(BlendHandle *bh);
121
122 /***/
123
124 #define BLO_GROUP_MAX 32
125 #define BLO_EMBEDDED_STARTUP_BLEND "<startup.blend>"
126
127 bool BLO_has_bfile_extension(const char *str);
128 bool BLO_library_path_explode(const char *path, char *r_dir, char **r_group, char **r_name);
129
130 /* Options controlling behavior of append/link code.
131  * Note: merged with 'user-level' options from operators etc. in 16 lower bits
132  *       (see eFileSel_Params_Flag in DNA_space_types.h). */
133 typedef enum BLO_LibLinkFlags {
134         /* Generate a placeholder (empty ID) if not found in current lib file. */
135         BLO_LIBLINK_USE_PLACEHOLDERS = 1 << 16,
136         /* Force loaded ID to be tagged as LIB_TAG_INDIRECT (used in reload context only). */
137         BLO_LIBLINK_FORCE_INDIRECT   = 1 << 17,
138 } BLO_LinkFlags;
139
140 struct Main *BLO_library_link_begin(struct Main *mainvar, BlendHandle **bh, const char *filepath);
141 struct ID *BLO_library_link_named_part(struct Main *mainl, BlendHandle **bh, const short idcode, const char *name);
142 struct ID *BLO_library_link_named_part_ex(
143         struct Main *mainl, BlendHandle **bh,
144         const short idcode, const char *name, const int flag,
145         struct Main *bmain, struct Scene *scene, struct ViewLayer *view_layer, const struct View3D *v3d);
146 void BLO_library_link_end(
147         struct Main *mainl, BlendHandle **bh, int flag,
148         struct Main *bmain, struct Scene *scene, struct ViewLayer *view_layer, const struct View3D *v3d);
149
150 void BLO_library_link_copypaste(struct Main *mainl, BlendHandle *bh);
151
152 void *BLO_library_read_struct(struct FileData *fd, struct BHead *bh, const char *blockname);
153
154 /* internal function but we need to expose it */
155 void blo_lib_link_restore(
156         struct Main *newmain, struct wmWindowManager *curwm,
157         struct Scene *curscene, struct ViewLayer *cur_render_layer);
158
159 typedef void (*BLOExpandDoitCallback) (void *fdhandle, struct Main *mainvar, void *idv);
160
161 void BLO_main_expander(BLOExpandDoitCallback expand_doit_func);
162 void BLO_expand_main(void *fdhandle, struct Main *mainvar);
163
164 /* Update defaults in startup.blend & userprefs.blend, without having to save and embed it */
165 void BLO_update_defaults_userpref_blend(void);
166 void BLO_update_defaults_startup_blend(struct Main *mainvar, const char *app_template);
167
168 /* Version patch user preferences. */
169 void BLO_version_defaults_userpref_blend(struct Main *mainvar, struct UserDef *userdef);
170
171 struct BlendThumbnail *BLO_thumbnail_from_file(const char *filepath);
172
173 struct Main *BLO_main_from_memfile(struct MemFile *memfile, struct Main *bmain, struct Scene **r_scene);
174
175 /* datafiles (generated theme) */
176 extern const struct bTheme U_theme_default;
177
178 #ifdef __cplusplus
179 }
180 #endif
181
182 #endif  /* __BLO_READFILE_H__ */