Daggerfall Mod:DFRemake/DFEGetNextRegionDungeon

integer DFEGetNextRegionDungeon ( DWORD MemblockPtr, DWORD RegionIndex )Edit

InputsEdit

• MemblockPtr: Pointer to the memblock (from GET MEMBLOCK POINTER) to receive the dungeon data. The memblock should be allocated with at least 256 bytes.
• RegionIndex: The region index to continue iterating dungeons in.

OutputsEdit

Returns 0 if there are no more locations in the given region (or on any error). Returns 1 on success.

DescriptionEdit

Use this function to continue iterating through all dungeons in a given region after an initial call to DFEGetFirstRegionDungeon. The memblock format is as follows:

Field	Type	Byte Pos	Description
XPos	float	0	X position of the dungeon in the world
YPos	float	4	Y position of the dungeon in the world

ExampleEdit

  Local Result as integer
  Local XPos   as float
  Local YPos   as float
 
  make memblock 1, 256
  Result = DFEGetFirstRegionDungeon(get memblock ptr(1), 19)
 
  while (Result)
     XPos = memblock float(1, 0)
     YPos = memblock float(1, 4)
 
     print "Found dungeon at ", XPos, ", ", YPos
 
     Result = DFEGetNextRegionDungeon(get memblock ptr(1), 19)
  endwhile

See AlsoEdit

• DFEGetFirstRegionDungeon