Changes between Version 4 and Version 5 of code/doc/Level
- Timestamp:
- Oct 7, 2008, 10:03:09 PM (16 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
code/doc/Level
v4 v5 4 4 == Description == 5 5 6 A [wiki:Level] is a combination of a xml-file and a [wiki:ClassTreeMask]. They define a set of objects that can be loaded by the [wiki:Loader]. If you don't specify a [wiki:ClassTreeMask mask], every object gets loaded. If you exclude certain classes, objects of those classes aren't loaded. A [wiki:Loader loaded] object knows in which [wiki:Level] it was defined. This way it's possible to selecitvely delete objects of a specific [wiki:Level].6 A Level is a combination of an [wiki:XMLPort XML-file] and a [wiki:ClassTreeMask]. They define a set of objects that can be loaded by the [wiki:Loader]. If you don't specify a mask, every object gets loaded. If you exclude certain classes, objects of those classes aren't loaded. A loaded object knows in which Level it was defined. This way it's possible to selecitvely delete objects of a specific Level. 7 7 8 You can think of a [wiki:Level] as a static and well defined unit. It's not possible to change the xml-file or the [wiki:ClassTreeMask mask] of a [wiki:Level]. The same xml-file combined with a different [wiki:ClassTreeMask mask] defines another [wiki:Level]. However it's still possible to apply another [wiki:ClassTreeMask mask] to a (already masked) [wiki:Level] by using the functions of the [wiki:Loader]. But the other mask is intersected with the mask of the level, so it's only possible to exclude even more classes, but you can't include previously excluded classes.8 You can think of a Level as a static and well defined unit. It's not possible to change the XML-file or the mask of a Level. The same XML-file combined with a different mask defines another Level. However it's still possible to apply another mask to a (already masked) Level by using the functions of the Loader. But the other mask is intersected with the mask of the level, so it's only possible to exclude even more classes, but you can't include previously excluded classes. 9 9 10 Recapitulatory we can state: A xml-file defines the maximal set of objects in a [wiki:Level] and a [wiki:Level] defines the maximal set of objects that can be loaded by the [wiki:Loader]. But both, [wiki:Level] and [wiki:Loader] can use [wiki:ClassTreeMask masks]to reduce the amount of objects even more.10 Recapitulatory we can state: An XML-file defines the maximal set of objects in a Level and a Level defines the maximal set of objects that can be loaded by the Loader. But both, Level and Loader can use masks to reduce the amount of objects even more. 11 11 12 12 == Functions == 13 13 14 14 * '''Constructor''': 15 * '''Level('''''file''''')''': Creates a [wiki:Level]that includes all objects from ''file''.16 * '''Level('''''file''''', '''''mask''''')''': Creates a [wiki:Level]that includes all objects from ''file'' whose classes are included in ''mask''.15 * '''Level('''''file''''')''': Creates a Level that includes all objects from ''file''. 16 * '''Level('''''file''''', '''''mask''''')''': Creates a Level that includes all objects from ''file'' whose classes are included in ''mask''. 17 17 18 18 * '''Level''':