Daggerfall Mod:DFRemake/DFELibrary - Blocks.bsa

Blocks.bsa contains information on building dungeon and location blocks from the component 3d objects. Within the Bsa file there are several differet file formats:

• RDB: Hold dungeon block data (Random Dungeon Block?)
• RMB: Hold location block data (towns, etc...) (Random Map Block?)
• RDI: Related to dungeons (Random Dungeon Information?) but currently unknown.

General Design

• The Blocks.bsa directory will be read the first time it is needed (when a RDB/RMB file is loaded or at the start of an iteration request).
• One RDB/RMB file will be loaded at a time.
• RDB/RMB files will be accessed/loaded according to their filename (8.3 format).
• Information will be passed onto DarkBasic using memblocks with user defined structures (will required manual extraction in DB).
• Object angles in dungeon blocks can be converted to degrees by multiplying by 540/1024. This results in some angles that are very large but (>360) it seems to work fine.

Error Codes

The following table lists the Blocks.bsa related error codes:

Error Code	Value	Description
DFERR_RDB_NUMOBJECTS	-901	Invalid number of objects contained in the RDB file.
DFERR_BLOCKS_NOTRMB	-1001	The specified file is not a RMB format.
DFERR_BLOCKS_NOTRDI	-1002	The specified file is not a RDI format.
DFERR_BLOCKS_NOTRDB	-1003	The specified file is not a RDB format.

Functions

• DFELoadDungeonBlock : Load a dungeon block (RDB) according to its filename.
• DFEGetFirstDungeonObject : Start iterating through pieces in the current dungeon block.
• DFEGetNextDungeonObject : Continue iterating through pieces in the current dungeon block.