Blender V5.3
blo_core_blend_header.cc
Go to the documentation of this file.
1/* SPDX-FileCopyrightText: 2025 Blender Authors
2 *
3 * SPDX-License-Identifier: GPL-2.0-or-later */
4
5#include <cctype>
6#include <cstdlib>
7#include <cstring>
8
10#include "BLI_filereader.hh"
11
12#include "BLO_core_bhead.hh"
14
15namespace blender {
16
28
30{
31 char header_bytes[MAX_SIZEOFBLENDERHEADER];
32 /* We read the minimal number of header bytes first. If necessary, the remaining bytes are read
33 * below. */
34 int64_t readsize = file->read(file, header_bytes, MIN_SIZEOFBLENDERHEADER);
35 if (readsize != MIN_SIZEOFBLENDERHEADER) {
36 return BlenderHeaderInvalid{};
37 }
38 if (!STREQLEN(header_bytes, "BLENDER", 7)) {
39 return BlenderHeaderInvalid{};
40 }
41 /* If the first 7 bytes are BLENDER, it is very likely that this is a newer version of the
42 * blend-file format. If the rest of the decode fails, we can still report that this was a
43 * Blender file of a potentially future version. */
44
45 BlenderHeader header;
46 /* In the old header format, the next bytes indicate the pointer size. In the new format a
47 * version number comes next. */
48 const bool is_legacy_header = ELEM(header_bytes[7], '_', '-');
49
50 if (is_legacy_header) {
51 header.file_format_version = 0;
52 switch (header_bytes[7]) {
53 case '_':
54 header.pointer_size = 4;
55 break;
56 case '-':
57 header.pointer_size = 8;
58 break;
59 default:
60 return BlenderHeaderUnknown{};
61 }
62 switch (header_bytes[8]) {
63 case 'v':
64 header.endian = L_ENDIAN;
65 break;
66 case 'V':
67 header.endian = B_ENDIAN;
68 break;
69 default:
70 return BlenderHeaderUnknown{};
71 }
72 if (!isdigit(header_bytes[9]) || !isdigit(header_bytes[10]) || !isdigit(header_bytes[11])) {
73 return BlenderHeaderUnknown{};
74 }
75 char version_str[4];
76 memcpy(version_str, header_bytes + 9, 3);
77 version_str[3] = '\0';
78 header.file_version = atoi(version_str);
79 return header;
80 }
81
82 if (!isdigit(header_bytes[7]) || !isdigit(header_bytes[8])) {
83 return BlenderHeaderUnknown{};
84 }
85 char header_size_str[3];
86 memcpy(header_size_str, header_bytes + 7, 2);
87 header_size_str[2] = '\0';
88 const int header_size = atoi(header_size_str);
89 if (header_size != MAX_SIZEOFBLENDERHEADER) {
90 return BlenderHeaderUnknown{};
91 }
92
93 /* Read remaining header bytes. */
94 const int64_t remaining_bytes_to_read = header_size - MIN_SIZEOFBLENDERHEADER;
95 readsize = file->read(file, header_bytes + MIN_SIZEOFBLENDERHEADER, remaining_bytes_to_read);
96 if (readsize != remaining_bytes_to_read) {
97 return BlenderHeaderUnknown{};
98 }
99 if (header_bytes[9] != '-') {
100 return BlenderHeaderUnknown{};
101 }
102 header.pointer_size = 8;
103 if (!isdigit(header_bytes[10]) || !isdigit(header_bytes[11])) {
104 return BlenderHeaderUnknown{};
105 }
106 char blend_file_version_format_str[3];
107 memcpy(blend_file_version_format_str, header_bytes + 10, 2);
108 blend_file_version_format_str[2] = '\0';
109 header.file_format_version = atoi(blend_file_version_format_str);
110 if (header.file_format_version != 1) {
111 return BlenderHeaderUnknown{};
112 }
113 if (header_bytes[12] != 'v') {
114 return BlenderHeaderUnknown{};
115 }
116 header.endian = L_ENDIAN;
117 if (!isdigit(header_bytes[13]) || !isdigit(header_bytes[14]) || !isdigit(header_bytes[15]) ||
118 !isdigit(header_bytes[16]))
119 {
120 return BlenderHeaderUnknown{};
121 }
122 char version_str[5];
123 memcpy(version_str, header_bytes + 13, 4);
124 version_str[4] = '\0';
125 header.file_version = std::atoi(version_str);
126 return header;
127}
128
129} // namespace blender
#define B_ENDIAN
#define L_ENDIAN
Wrapper for reading from various sources (e.g. raw files, compressed files, memory....
#define MAX_SIZEOFBLENDERHEADER
#define BLEND_FILE_FORMAT_VERSION_0
#define MIN_SIZEOFBLENDERHEADER
#define BLEND_FILE_FORMAT_VERSION_1
#define STREQLEN(a, b, n)
#define ELEM(...)
BMesh Iterators.
BLI_assert(slot->slot_subtype.map==BMO_OP_SLOT_SUBTYPE_MAP_FLT)
__int64 int64_t
Definition BKE_text.h:90
std::variant< BlenderHeaderInvalid, BlenderHeaderUnknown, BlenderHeader > BlenderHeaderVariant
BlenderHeaderVariant BLO_readfile_blender_header_decode(FileReader *file)
FileReaderReadFn read