#[non_exhaustive]pub struct StructureReport {
pub cfb_version: u16,
pub storages: u32,
pub red_black_trees: u32,
pub top_down_trees: u32,
pub irregular_free_entries: u32,
pub writer_slot_order: bool,
pub pages: u32,
pub pages_with_number_or_population: u32,
pub model_records_without_time: u32,
pub split_dictionary_pages: Vec<u32>,
pub warnings: Vec<Warning>,
}Expand description
Structural facts of a DGN V8 file’s container and pages.
The report states what the file holds; it does not claim that any application accepts
the file. Counts that differ between observed writers (the page header’s number and
population, the directory slot order) are information, not warnings. Recoverable
problems are listed in warnings with stable codes:
| Code | Meaning |
|---|---|
dgn.cfb_tree_unordered | a sibling tree is not ordered by CFB name ([MS-CFB] 2.6.4), reaches a slot twice or points outside the directory: lookups by name can miss entries |
dgn.cfb_tree_unbalanced | a sibling tree is ordered, but its colours are not a red-black tree (MS-CFB permits this, an all-black tree for instance) |
dgn.cfb_tree_shared | a storage’s sibling tree reaches entries an earlier storage’s tree holds (an entry with two parents, which [MS-CFB] does not allow); the tree is counted in storages but not analysed |
dgn.cfb_free_entry | a slot the root does not reach is not in the free form of [MS-CFB] 2.6.3 |
dgn.record_time | a graphic or control record has no positive finite time at +0x18 |
dgn.dictionary_page_split | a Dgn^Nm page starts with a complex component |
dgn.model_page_counter | the first dword of a model header stream lies outside [pages holding records, pages] of its graphic and control pages |
Fields (Non-exhaustive)§
This struct is marked as non-exhaustive
Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.cfb_version: u16Compound file major version (3: 512-byte sectors, 4: 4096-byte sectors).
storages: u32Storages, the root included, whose child (sibling) tree is not empty.
red_black_trees: u32Of storages, the trees that are ordered red-black trees: colours
0 or 1, a black tree root, no red node with a red child and the same number of black
nodes on every path.
top_down_trees: u32Of storages, the trees whose shape equals top-down 2-3-4
red-black insertion of the children in slot order, the shape the writer produces.
irregular_free_entries: u32Directory slots the root does not reach that are not in the MS-CFB free form.
writer_slot_order: boolWhether the reachable entries fill slots 1, 2, … without a gap in the order the writer uses. That order is one seed lineage’s; observed files differ, and readers find entries through the sibling trees, not by slot.
pages: u32Page streams ($n) of every model’s graphic, control and auxiliary storages and of
Dgn^Nm / Dgn^NmA.
pages_with_number_or_population: u32Of pages, those whose header stores a page number or population
(+0x08 / +0x0C) other than 0. Public files written by other applications store
both; this is not a defect.
model_records_without_time: u32Graphic and control records whose time (f64 at +0x18, milliseconds since 1970)
is not positive and finite.
split_dictionary_pages: Vec<u32>Numbers of the Dgn^Nm pages that start with a complex component.
warnings: Vec<Warning>Recoverable problems, see the table above.