DNA: support DNA type & name aliases
[blender.git] / source / blender / blenloader / intern / versioning_dna.c
1 /*
2  * This program is free software; you can redistribute it and/or
3  * modify it under the terms of the GNU General Public License
4  * as published by the Free Software Foundation; either version 2
5  * of the License, or (at your option) any later version.
6  *
7  * This program is distributed in the hope that it will be useful,
8  * but WITHOUT ANY WARRANTY; without even the implied warranty of
9  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
10  * GNU General Public License for more details.
11  *
12  * You should have received a copy of the GNU General Public License
13  * along with this program; if not, write to the Free Software Foundation,
14  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
15  */
16
17 /** \file \ingroup blenloader
18  *
19  * Apply edits to DNA at load time to behave as if old files were written with new names.
20  */
21
22 #include "BLI_compiler_attrs.h"
23 #include "BLI_utildefines.h"
24
25 #include "DNA_genfile.h"
26 #include "DNA_listBase.h"
27
28 #include "BLO_readfile.h"
29 #include "readfile.h"
30
31 /**
32  * Manipulates SDNA before calling #DNA_struct_get_compareflags,
33  * allowing us to rename structs and struct members.
34  *
35  * - This means older versions of Blender won't have access to this data **USE WITH CARE**.
36  *
37  * - These changes are applied on file load (run-time), similar to versioning for compatibility.
38  *
39  * \attention ONLY USE THIS KIND OF VERSIONING WHEN `dna_rename_defs.h` ISN'T SUFFICIENT.
40  */
41 void blo_do_versions_dna(SDNA *sdna, const int versionfile, const int subversionfile)
42 {
43 #define DNA_VERSION_ATLEAST(ver, subver) \
44         (versionfile > (ver) || (versionfile == (ver) && (subversionfile >= (subver))))
45
46         if (!DNA_VERSION_ATLEAST(280, 2)) {
47                 /* Version files created in the 'blender2.8' branch
48                  * between October 2016, and November 2017 (>=280.0 and < 280.2). */
49                 if (versionfile >= 280) {
50                         DNA_sdna_patch_struct(sdna, "SceneLayer", "ViewLayer");
51                         DNA_sdna_patch_struct(sdna, "SceneLayerEngineData", "ViewLayerEngineData");
52                         DNA_sdna_patch_struct_member(sdna, "FileGlobal", "cur_render_layer", "cur_view_layer");
53                         DNA_sdna_patch_struct_member(sdna, "ParticleEditSettings", "scene_layer", "view_layer");
54                         DNA_sdna_patch_struct_member(sdna, "Scene", "active_layer", "active_view_layer");
55                         DNA_sdna_patch_struct_member(sdna, "Scene", "render_layers", "view_layers");
56                         DNA_sdna_patch_struct_member(sdna, "WorkSpace", "render_layer", "view_layer");
57                 }
58         }
59
60 #undef DNA_VERSION_ATLEAST
61 }