We've just updated MediaWiki and its underlying software. If anything doesn't look or work quite right, please mention it to us. --RanAS

Dynamic Z: Difference between revisions

From SnesLab
Jump to: navigation, search
(→‎Features: linkify VRAM)
 
(72 intermediate revisions by 2 users not shown)
Line 1: Line 1:
Dynamic Z is a patch for [[Super Mario World]] that allows performing a variety of actions during [[V-Blank]]. It was made by [[User:anonimzwx|anonimzwx]]. Dynamic Z is meant to be a replacement for [[DSX]] as both allow coding dynamic sprites.
{{Select Language|Dynamic_Z}}


Dynamic Z does not require a buffer for coding dynamic sprites, which significantly reduces the slowdown caused by these type of sprites. Additionally, it can create sprites with a 30FPS animation synchronized with each other; this allows having twice as many dynamic sprites on-screen compared to DSX.
'''Dynamic Z''' is a patch for [[Super Mario World]] that allows performing a variety of actions during [[V-Blank]]. It was made by [[User:anonimzwx|anonimzwx]]. Dynamic Z is meant to be a replacement for [[DSX]] as both allow coding dynamic sprites.


== Features ==
== Features ==
* '''Dynamic Sprite Support:''' Sprites that uploads their graphics to the [[VRAM]] when they need allowing unlimited number of frames.
* '''Shared Dynamic Sprite Support:''' Dynamic Sprites but each copy of the sprite shares graphics then doesn't have limitation of number.
* '''Semi Dynamic Sprite Support:''' Regular Sprites that uploads all their graphics to the VRAM when they are spawned on the level, each copy of the sprite use the same space in VRAM.
* '''Giant Dynamic Sprite Support:''' Very Big Dynamic Sprites. Any that fits in 48 16x16 tiles or less.
* '''Graphics Change on the fly:''' Can change GFXs in game by code.
* '''Tilemap Change on the fly:''' Can change Tilemaps of any layer in game by code.
* '''Color Palette Change on the fly:''' Can change color palettes in game by code.
* '''Block Changer:''' Allows to change several blocks, this allows to modify terrain of Layer 1 or Layer 2.
* '''DMA Mirror:''' Includes a Ram Address that mirrors register $420B and can be used to do [[DMA]] transfers.
* '''SA1's Widescreen:''' Makes easier to use the widescreen of SA1 pack, every 6~7 scanlines killed Dynamic Z allows 8 16x16 tiles more to use in Dynamic sprites or Graphics Change. '''Only Available if ROM uses SA1'''.


* Graphic changes
== Optional Features ==
* Color palette changes
* Player Features: Can change graphics or color palettes of player on the fly, allowing Custom Players, the size is defined by the user but bigger player = less dynamic sprites. Also in vanilla case optimize player routine to save a lot of cycles during NMI. '''Not Compatible with resources that change things of the player like 8x8 tiles DMAer or 32x32 player (New version will be compatible with LX5's Custom Power Ups)'''.
* Color palette and graphic changes on the player
* 50% More Mode: if it is activate, status bar, podoboos and most of minor DMA, then is possible to send 50% more data by DMA, that means 50% more Dynamic Sprites or graphics changes. '''Not compatible with resources that changes things with Status Bar'''.
* Tile changes
* Support for Dynamic, Semi-Dynamic and Giga-Dynamic sprites
* A special DMA mode, which grants 50% more transfer capacity by removing the game's original DMA code
* Player DMA optimizations that gives more time during NMI and slightly curbs slowdown
* Compatibility with DSX sprites


== Dynamic Z vs DSX ==


== How it works? ==
=== Dynamic Sprite Support ===
Dynamic Z have tables to define transfers to VRAM between #7400 and #7FFF (In the case of Overworld Sprites #6800 and #6FFF) . Every Table have 1 slot for each space of 16x8:
* '''DMA Resource:''' This Table is used to know in what RAM Address starts the source that will be transfer to the VRAM.
* '''DMA BNK:''' This Table is used to know in what Bank starts dma must find the DMA Resource.
* '''DMA Length:''' This Table is used to know how much data must send to VRAM.
Each slot of the tables is mapped to a value on the VRAM, the first slot start at #7400 and the last starts at #7FE0, Between 2 consecutive slots, there are 20 address of diference on the VRAM (40 bytes of difference).
To know what slots read of the tables, Dynamic Z use a table called '''DMA Next''', each slot on this table indicates a link between a slot and another slot, for example, if slot #$00 have the value #$20, then after load slot #$00 on the VRAM, the patch will loads slot #$20, if a Slot have the value #$FF, if the patch read that slot, will finish the transfer to VRAM.
To know what is the first slot, there is a RAM Address called '''First Slot''', if this address is #$FF, then Dynamic Z won't load anything on the VRAM.
With the table DMA Next, Dynamic Z create a data structure called '''Linked List'''. To add DMA Transfers at the end of the list, there is a RAM Address called '''Last Slot''' that have the last slot that will be loaded on the VRAM.
To connect this system with sprites there are some tables that can be used:
* '''Slots Used By Sprite:''' Dynamic Z Consideres each slot as a square of 16x16, each dynamic sprite use a number of slots, for example a dynamic sprite of 16x16 uses 1 slot, here a table with the number of slots of each sprite:
{| class="wikitable"
{| class="wikitable"
|-
|-
! Size !! Slots
! !! DSX !! Dynamic Z
|-
| Number of Dynamic Sprites || 4 of 32x32, 1 of 64x64 || Any number of sprites while it fits on the designed space. By default allows 32 16x16 tiles.
|-
|-
| 16x16|| 1
| Frame Rate || 60 FPS || 30 or 60 FPS, if you use 30 FPS sprites you can use more dynamic sprites.
|-
|-
| 32x16|| 2
| Performance || Requires a buffer to sort the data before transfer it to VRAM wasting a lot of cycles. || Send data directly to VRAM and only transfer data when is needed saving a lot of cycles on NMI, It doesn't require a buffer then doesn't waste cycles fitting graphics on the buffer.
|-
|-
| 32x32|| 4
| Sizes || 32x32 or 64x64, do others sizes is possible but harder. || Any if it fits on the designed space.
|-
|-
| 48x48|| 8
| VRAM Options || Only allows to fit Dynamic Sprites on SP4 Second Half || User can define where fit Dynamic Sprites, Default address can be changed on the patch, address can be changed in game by code.
|-
|-
| 64x64|| 16
| Shared Dynamic Sprites || No || Allows Dynamic Sprites that shares graphics on VRAM, Shared Dynamic Sprites doesn't have limitations of number.
|-
|-
| 80x80|| 24
| Semi-Dynamic Sprites || No || Normal sprites that when are spawned on the stage, they upload all their graphics to VRAM.
|-
|-
| 96x96|| All
| Giant-Dynamic Sprites || No || Very Big Dynamic Sprite, (Max Size any that use a space in vram of 48 tiles).
|-
|-
| 112x112|| All
| Auto-Defragmentation of VRAM || No || When a Dynamic sprite is spawned, it clears reserved space of unused slots and compress space on VRAM.
|}
|}
In the case of 96x96 and 112x112 Dynamic Sprites, they uses their own system and they reserve all slots. You can't use a 96x96 or 112x112 Dynamic Sprite with others Dynamic Sprites.
* '''FPS:''' This table is used to know the frecuency of a sprite to change it's graphics on the VRAM. Dynamic Z allows 2 frecuencies, 30 FPS (can change their graphics every 2 snes frames) and 60 FPS (can change their graphics each frame). On practice use 30 FPS allows to use the double of Dynamic Sprites, because you can sincronice their Dynamic Routines and have 16 slots (24 with 50% more mode) for sprites that loads their graphics on even frames and 16 (or 24) for sprites that loads their graphics on odd frames. Almost all sprites can be made with 30FPS, try to avoid 60FPS dynamic sprites.
* '''Sprite Type:''' It is used to know the type of the dynamic sprite, #$00 = Free Slot, #$01 = Normal, #$02 = Extended, #$03 = Cluster and #$04 = Overworld Sprite.
* '''Sprite ID:''' It is used to know what is the Index of the sprite on its sprite table.
* '''Sprite Number:''' It is used to know what is the Number of the sprite.
* '''Transfer Frame:''' It is one table for each kind of sprite. It is used for 30FPS to know if it uses slots of even frames or odd frames. if  bit 7 is 0 = Even Frames, if  bit 7 is 1 = Odd Frames. Also is used to know if the sprite must reserve a slot starting from the bottom of the Dynamic Space (for example on the second half of SP4) or from the top of the Dynamic Space (second half of SP3), if Bit 6 is 0 = Bottom, if bit 6 is 1 = Top.
* '''VRAM Disp:''' It is one table for each kind of sprite. It is used to know what is the slot assigned to the sprite.
* '''Signals:''' They represent if a space on the VRAM is used by a sprite, each Signal represents 4 slots, each group of 2 slots on each signal is a counter that decrease in 1 each frame, if the value is #$00 then the slot is free to use.
* '''Max Slots:''' Is the max number of slots that can be used in each frame. By default is #$10 (16 slots), if you use 50% more mode it can be #$18 (24 slots). This value can be modified by the user if he wants to use less space on SP4 or SP3, for example if the user use Max Slot = #$08, then only will use a space of 128x32 on the VRAM.


==== RAM Addresses ====
== Installation ==
 
=== Without SA-1 ===
 
# Insert Dynamic Z as any other patch.
 
=== With SA-1 ===
<ol start="1">
<li>Open a Clear ROM with [[Lunar Magic]].</li>
<li>Expand Rom (if you want to use a lot of Dynamic Sprites i recommend 4mb)</li>
<li>Open "sa1.asm" and change this to 0:
<pre>
!DSX = 1 ; Put 0 if you want to turn off legacy (Dynamic Sprites) patch support.
; (as anoni's Dynamic Z should obsolete it soon.)
</pre></li>
<li>Insert SA-1.</li>
<li>Insert Dynamic Z as any other Patch.</li>
</ol>
 
=== Installing Dynamic Z's Library and Defines  ===
 
==== Pixi ====
 
# Run "Dynamic Z Pixi Installer.exe". This will generate a define file in "./asm/ExtraDefines", that can be used by any other Dynamic Sprite. If you want to do it manually, just copy the file "DynamicZDefines.asm" and put it on "./asm/ExtraDefines".
 
==== Uber asm patch ====
'''Under Construction'''
 
==== Uber asm Tool ====
'''Under Construction'''
 
==== GPS ====
'''Under Construction'''
 
==== Overworld Sprite Tool ====
'''Under Construction'''
 
=== Inserting Dynamic Resources ===
 
Dynamic Z includes a tool to insert graphics or tilemaps on the ROM using freedata and allows to resources get them with just a macro. This system is specially useful for resources that uses more than 1 BNK, I recommend use it always for any resource because freecode is better keep them just for code and freedata for graphics and tilemaps.
 
<ol start="1">
<li>Put graphics or "Dynamic Resources" folder.</li>
<li>Open "ResourceList.txt". It will look like this:
<pre>
PIXI:
.Normal
.Cluster
.Extended
OTHER:
</pre>
 
For Normal, Clusters or Extended Sprites, write the name of the sprite on the correct label.
 
Example:
<pre>
PIXI:
.Normal
klaptrap
klump
piranha plant
.Cluster
DKC butterfly
DKC fish
.Extended
OTHER:
</pre>
 
For other resources write the complete path after label OTHER.
 
Example:
<pre>
PIXI:
.Normal
klaptrap
klump
piranha plant
.Cluster
DKC butterfly
DKC fish
.Extended
OTHER:
./blocks/block that change GFX when is touched.asm
./level/awesome uberasm.asm
</pre></li>
<li>Run "DynamicResourceAdder.exe".</li>
<li>Insert resources.</li>
</ol>
 
== Using Normal Dynamic Sprites with the New System ==
 
if the sprite is 60FPS, it must be inserted on lunar magic as any other sprite.
if the sprite is 30FPS, The highest 2 bits of Extra Byte 1 requires on of this 3 values.
* 00: Automatically assign if It uploads graphics to vram on even or odd frames.
* 01: It uploads graphics to VRAM only in odd frames.
* 02: It uploads graphics to VRAM only in even frames.
By default use always 00 for this, 01 and 02 are used if you want to do GFX or Tilemap Changes and use Dynamic Sprites without flickering, for that you can do that dynamic sprites use only odd frames and upload GFX or Tilemaps in Even Frames.
 
== Library ==
 
Dynamic Z includes severals routines and macros to help developers. Some of them can be used on any resource and others are exclusive for Dynamic Sprites.
 
=== Global Library ===
 
==== Variables ====
 
{| class="wikitable"
{| class="wikitable"
|-
|-
! Name !! Address !! SA-1 Address !! Define !! Length !! Description
! Name !! Size !! Default Address Lorom !! Default Address SA-1 !! Description
|-
| Dynamic Timer || 7F0B44 || 418000 || !DynamicTimer || 1 byte || A timer that decrease in 1, every frame when Dynamic Z is working, it is used for 30FPS Dynamic sprites to know if the frame is even or odd.
|-
| Signal for the Bottom Left Quarter of Second Half of SP4 || 7F0B45 || 418001 || !SignalSP4SecondHalfBottomLeftQuarter || 1 byte || Signal used to know if slots that are allocated on the Bottom Left quarter of the second half of SP 4 are used free or not.
|-
| Signal for the Bottom Right Quarter of Second Half of SP4 || 7F0B46 || 418002 || !SignalSP4SecondHalfBottomRightQuarter|| 1 byte || Signal used to know if slots that are allocated on the Bottom Right quarter of the second half of SP 4 are used free or not.
|-
| Signal for the Top Left Quarter of Second Half of SP4 || 7F0B47 || 418003 || !SignalSP4SecondHalfTopLeftQuarter || 1 byte || Signal used to know if slots that are allocated on the Top Left quarter of the second half of SP 4 are used free or not.
|-
| Signal for the Top Right Quarter of Second Half of SP4 || 7F0B48 || 418004 || !SignalSP4SecondHalfTopRightQuarter || 1 byte || Signal used to know if slots that are allocated on the Top Right quarter of the second half of SP 4 are used free or not.
|-
| Signal for the Bottom Left Quarter of First Half of SP4 || 7F0B49 || 418005 || !SignalSP4FirstHalfBottomLeftQuarter || 1 byte || Signal used to know if slots that are allocated on the Bottom Left quarter of the second half of SP 4 are used free or not.
|-
| Signal for the Bottom Right Quarter of First  Half of SP4 || 7F0B4A || 418006 || !SignalSP4FirstHalfBottomRightQuarter || 1 byte || Signal used to know if slots that are allocated on the Bottom Right quarter of the second half of SP 4 are used free or not.
|-
| Signal for the Top Left Quarter of First Half of SP4 || 7F0B4B || 418007 || !SignalSP4FirstHalfTopLeftQuarter || 1 byte || Signal used to know if slots that are allocated on the Top Left quarter of the first half of SP 4 are used free or not.
|-
| Signal for the Top Right Quarter of First Half of SP4 || 7F0B4C || 418008 || !SignalSP4FirstHalfTopRightQuarter || 1 byte || Signal used to know if slots that are allocated on the Top Right quarter of the first half of SP 4 are used free or not.
|-
| Signal for the Bottom Left Quarter of Second Half of SP3 || 7F0B4D || 418009 || !SignalSP3SecondHalfBottomLeftQuarter || 1 byte || Signal used to know if slots that are allocated on the Bottom Left quarter of the second half of SP 3 are used free or not.
|-
| Signal for the Bottom Right Quarter of Second Half of SP3 || 7F0B4E || 41800A || !SignalSP3SecondHalfBottomRightQuarter|| 1 byte || Signal used to know if slots that are allocated on the Bottom Right quarter of the second half of SP 3 are used free or not.
|-
| Signal for the Top Left Quarter of Second Half of SP3 || 7F0B4F || 41800B || !SignalSP3SecondHalfTopLeftQuarter || 1 byte || Signal used to know if slots that are allocated on the Top Left quarter of the second half of SP 3 are used free or not.
|-
| Signal for the Top Right Quarter of Second Half of SP3 || 7F0B50 || 41800C || !SignalSP3SecondHalfTopRightQuarter || 1 byte || Signal used to know if slots that are allocated on the Top Right quarter of the second half of SP 3 are used free or not.
|-
| Slots Used in Even Frames || 7F0B51 || 41800D || !SlotsUsedEven || 1 byte || Number of slots used on even frames.
|-
| Slots Used in Odd Frames || 7F0B52 || 41800E || !SlotsUsedOdd || 1 byte || Number of slots used on odd frames.
|-
| Max Slots || 7F0B53 || 41800F || !MaxSlots || 1 byte || Maximum number of slots that can be used per frame.
|-
| Number of Blocks || 7F0B54 || 418010 || !NumberOfBlocks || 1 byte || Number of blocks that can be used for Dynamic Routines, each block represent a space in VRAM of 128x32, by default is 2 (equivalent to have a complete SP for dynamic sprites).
|-
| VRAM Displacement Normal Sprites|| 7F0B55 || 418011 || !VRAMDispNormalSprite || 12 bytes (22 bytes on SA1 roms) || A number used to know what is the slot assigned to a Normal Dynamic Sprite.
|-
| VRAM Displacement Extended Sprites|| 7F0B61 || 418027 || !VRAMDispExtendedSprite || 10 bytes || A number used to know what is the slot assigned to a Extended Dynamic Sprite.
|-
| VRAM Displacement Cluster Sprites|| 7F0B6B || 418031 || !VRAMDispClusterSprite || 20 bytes || A number used to know what is the slot assigned to a Cluster Dynamic Sprite.
|-
| VRAM Displacement Overworld Sprites|| 7F0B7F || 418045 || !VRAMDispOWSprite || 16 bytes || A number used to know what is the slot assigned to a OVerworld Dynamic Sprite.
|-
| Transfer Frame Normal Sprite || 7F0B8F || 418055 || !TransferFrameNormalSprite || 12 bytes (22 bytes on SA1 roms) || Used to know if the sprite must find slot starting from the Top of the Dynamic Space or starting from the bottom. Also in 30FPS Dynamic sprites is used to know if the dynamic routine must be made on even or odd frames.
|-
| Transfer Frame Extended Sprite || 7F0B9B || 41806B || !TransferFrameExtendedSprite || 10 bytes || Used to know if the sprite must find slot starting from the Top of the Dynamic Space or starting from the bottom. Also in 30FPS Dynamic sprites is used to know if the dynamic routine must be made on even or odd frames.
|-
| Transfer Frame Cluster Sprite || 7F0BA5 || 418075 || !TransferFrameClusterSprite || 20 bytes || Used to know if the sprite must find slot starting from the Top of the Dynamic Space or starting from the bottom. Also in 30FPS Dynamic sprites is used to know if the dynamic routine must be made on even or odd frames.
|-
| Transfer Frame Overworld Sprite || 7F0BB9 || 418089 || !TransferFrameOWSprite || 16 bytes || Used to know if the sprite must find slot starting from the Top of the Dynamic Space or starting from the bottom. Also in 30FPS Dynamic sprites is used to know if the dynamic routine must be made on even or odd frames.
|-
|-
| Slots used by Sprite || 7F0BC9 || 418099 || !SlotsUsedBySprite || 48 bytes || How many slots are used for each dynamic sprite.
| DZ.Timer || 1 || 7F0B44 || 418000 || Increase in 1 every frame that Dynamic Z is executed. Used to syncronize 30FPS Dynamic Sprites.
|-
|-
| FPS || 7F0BF9 || 4180C9 || !FPSSprite || 48 bytes || Used to know if a sprite if 30 or 60 FPS.
| DZ.MaxDataPerFrameIn16x16Tiles || 1 || 7F0B45 || 418001 || How many Tiles of 16x16 can be send to VRAM per frame without flickering.
|-
|-
| Sprite Type || 418129 || 4180F9 || !SlotSpriteType || 48 bytes || Used to know if a slot is free or what is the type of the dynamic sprite of each slot.  
| DZ.MaxDataPerFrame || 2 || 7F0B46 || 418002 || How many bytes can be send to VRAM per frame without flickering. Is Calculated as DZ.MaxDataPerFrameIn16x16Tiles*0x80.
|-
|-
| Sprite ID || 418159 || 418129 || !SlotSpriteID || 48 bytes || Used to know what is the index of a dynamic sprite.
| DZ.PPUMirrors.CGRAMTransferLength || 1 || 7F0D19 || 4181D6 || Number of transfers to CGRAM, Max Value is 0x40.
|-
|-
| Sprite Number || 418189 || 418159 || !SlotSpriteNumber || 48 bytes || Used to know what is the sprite number of each dynamic sprite.
| DZ.PPUMirrors.CGRAMTransferSourceBNKLength || 128 || 4181D7 || 4181D7 || First byte is the BNK of Source, Second byte is the amount of data send by each transfer to CGRAM.
|-
|-
| DMA Map Resource || 4181B9 || 418189 || !DMAMapResource || 192 bytes || Used to know where are allocated the resources on the ROM (or RAM). (2 bytes per slot).
| DZ.PPUMirrors.CGRAMTransferOffset || 64 || 7F0D9A || 418257 || Address of CGRAM to start to send data.
|-
|-
| DMA MAp Bank || 418279 || 418249 || !DMAMapBNK || 96 bytes || Used to know in what bank are allocated the resources on the ROM (or RAM). (1 bytes per slot).
| DZ.PPUMirrors.CGRAMTransferSource || 128 || 7F0DDA || 418297 || Address of table with Colors.
|-
|-
| DMA Map Lenght|| 4182D9 || 4182A9 || !DMAMapLenght || 192 bytes || Used to know how many bytes must be transfer. (2 bytes per slot).
| DZ.PPUMirrors.VRAMTransferLength || 1 || 7F0E5A || 418317 || Number of transfer to VRAM, Max Value is 0xFE.
|-
|-
| DMA Map Next Slot || 418399 || 418369 || !DMAMapNext || 96 bytes || After transfer 1 slot to the VRAM, It is used to know what is the next slot that must be loaded to the VRAM. (1 bytes per slot).
| DZ.PPUMirrors.VRAMTransferSource || 190 || 7F0E5B || 418318 || Address of resource send to VRAM.
|-
|-
| First Slot || 4183F9 || 418399 || !FirstSlot || 1 byte || Used to know what is the first slot that must be loaded on the VRAM. If it is #$FF then doesn't load anything to the VRAM.
| DZ.PPUMirrors.VRAMTransferSourceBNK || 190 || 7F0F19 || 4183D6 || BNK of Address of resource send to VRAM.
|-
|-
| Last Slot || 4183FA || 41839A || !LastSlot || 1 byte || Used to know what is the last slot that must be loaded on the VRAM.
| DZ.PPUMirrors.VRAMTransferSourceLength || 190 || 7F0FD7 || 418494 || Data send by each transfer to VRAM.
|-
|-
| 50% more mode || 4183FB || 41839B || !Mode50More || 1 byte || If it is 1, activate 50% more mode. In this default smw status bar, all default animated tiles of SP1 and dma used for tile E3 and F0 are disable. This allows to have 50% more slots for dynamic sprites or to transfer 50% more data to VRAM. (Must disable global animated tiles and animated palettes on LM).  
| DZ.PPUMirrors.VRAMTransferOffset || 190 || 7F1095 || 418552 || Address of VRAM to starte to send data.
|}
|}


==== Routines ====
==== Routines ====


Dynamic Z includes some routines to do all easier:
'''UNDER CONSTRUCTION'''
 
==== Macros ====


* '''Dynamic Routine:''' Do the dynamic routine of a sprite.
'''UNDER CONSTRUCTION'''
* '''Reserve:''' Reserve a slot for a new dynamic sprite. If the sprite can't reserve a slot then it will be killed. In the case of normal sprite they can be reloaded if the player return to the area. It recieves as parameter A = Transfer Frame Table.
* '''Send Signal:''' This routine says to Dynamic Z that the slots reserved by a sprite are still used and don't overwrite them.


Here a list of all Routines:
=== Dynamic Sprites Library ===
 
==== Variables ====


{| class="wikitable"
{| class="wikitable"
|-
|-
! Name !! Define !! Description
! Name !! Size !! Default Address Lorom !! Default Address SA-1 !! Description
|-
|-
| Dynamic Routine for 16x16 sprites || !DynamicRoutine16x16 || Dynamic Routine used by dynamic sprites of 16x16.
| DZ.DSLastSlot || 1 || 7F0B47 || 418004 || Index of the Last Slot.
|-
|-
| Dynamic Routine for 32x16 sprites || !DynamicRoutine32x16 || Dynamic Routine used by dynamic sprites of 32x16.
| DZ.DSFirstSlot || 1 || 7F0B48 || 418005 || Index of the First Slot.
|-
|-
| Dynamic Routine for 32x32 sprites || !DynamicRoutine32x32 || Dynamic Routine used by dynamic sprites of 32x32.
| DZ.DSMaxSpace || 1 || 7F0B49 || 418006 || Max space available for Dynamic Sprites in 16x16 Tiles, by Default is 0x30.
|-
|-
| Dynamic Routine for 48x48 sprites || !DynamicRoutine48x48 || Dynamic Routine used by dynamic sprites of 48x48.
| DZ.DSFindSpaceMethod || 1 || 7F0B4A || 418007 || If it is 0, It find space starting from VRAMOffset (Top to Bottom), otherwise find space starting from VRAMOffset + Max Space (Bottom to Top).
|-
|-
| Dynamic Routine for 64x64 sprites || !DynamicRoutine64x64 || Dynamic Routine used by dynamic sprites of 64x64.
| DZ.DSStartingVRAMOffset || 2 || 7F0B4B || 418008 || Position on VRAM to start to find space for Dynamic Graphics.
|-
|-
| Dynamic Routine for 80x80 sprites || !DynamicRoutine80x80 || Dynamic Routine used by dynamic sprites of 80x80.
| DZ.DSStartingVRAMOffset8x8Tiles || 1 || 7F0B4D || 41800A || DSStartingVRAMOffset but in 8x8 tiles.
|-
|-
| Reserve Slot for 16x16 30FPS Normal Sprite || !Reserve16x16NormalSpriteOf30FPS || Reserve a slot for a Dynamic 30FPS Normal Sprite of 16x16.
| DZ.DSTotalSpaceUsed || 1 || 7F0B4E || 41800B || Amount of space used by Dynamic Sprites in 8x8 tiles.
|-
|-
| Reserve Slot for 16x16 60FPS Normal Sprite || !Reserve16x16NormalSpriteOf60FPS || Reserve a slot for a Dynamic 60FPS Normal Sprite of 16x16.
| DZ.DSTotalSpaceUsedOdd || 1 || 7F0B4F || 41800C || Amount of space used by Dynamic Sprites on Odd frames in 8x8 tiles.
|-
|-
| Reserve Slot for 16x16 30FPS Extended Sprite || !Reserve16x16ExtendedSpriteOf30FPS || Reserve a slot for a Dynamic 30FPS Extended Sprite of 16x16.
| DZ.DSTotalSpaceUsedEven || 1 || 7F0B50 || 41800D || Amount of space used by Dynamic Sprites on Even frames in 8x8 tiles.
|-
|-
| Reserve Slot for 16x16 60FPS Extended Sprite || !Reserve16x16ExtendedSpriteOf60FPS || Reserve a slot for a Dynamic 60FPS Extended Sprite of 16x16.
| DZ.DSTotalDataSentOdd || 1 || 7F0B51 || 41800E || Amount of Max data send by Dynamic Sprites on Odd frames in 8x8 tiles.
|-
|-
| Reserve Slot for 16x16 30FPS Cluster Sprite || !Reserve16x16ClusterSpriteOf30FPS || Reserve a slot for a Dynamic 30FPS Cluster Sprite of 16x16.
| DZ.DSTotalDataSentEven || 1 || 7F0B52 || 41800F || Amount of Max data send by Dynamic Sprites on Even frames in 8x8 tiles.
|-
|-
| Reserve Slot for 16x16 60FPS Cluster Sprite || !Reserve16x16ClusterSpriteOf60FPS || Reserve a slot for a Dynamic 60FPS Cluster Sprite of 16x16.
| DZ.DSCurrentSlotSearcher || 1 || 7F0B53 || 418010 || Used by Find Space Routine to move space used by a dynamic sprite to defragment it. Index of the Slot of sprite to defragment.
|-
|-
| Reserve Slot for 16x16 30FPS Overworld Sprite || !Reserve16x16OWSpriteOf30FPS || Reserve a slot for a Dynamic 30FPS Overworld Sprite of 16x16.
| DZ.DSSlotSearchedOffset || 1 || 7F0B54 || 418011 || Used by Find Space Routine to move space used by a dynamic sprite to defragment it. Space to move the sprite.
|-
|-
| Reserve Slot for 16x16 60FPS Overworld Sprite || !Reserve16x16OWSpriteOf60FPS || Reserve a slot for a Dynamic 60FPS Overworld Sprite of 16x16.
| DZ.DSLocUsedBy || 48 || 7F0B55 || 418012 || Format s tt iiiii. s => 0 Regular Dynamic Sprite, 1 Shared Dynamic Sprite. tt => 00 = Normal Sprite, 01 = Cluster Sprite, 10 = Extended Sprite and 11 = OW Sprite. iiiii Slot of the Sprite.
|-
|-
| Reserve Slot for 32x16 30FPS Normal Sprite || !Reserve32x16NormalSpriteOf30FPS || Reserve a slot for a Dynamic 30FPS Normal Sprite of 32x16.
| DZ.DSLocSpriteNumber || 48 || 7F0B85 || 418042 || Sprite Number.
|-
|-
| Reserve Slot for 32x16 60FPS Normal Sprite || !Reserve32x16NormalSpriteOf60FPS || Reserve a slot for a Dynamic 60FPS Normal Sprite of 32x16.
| DZ.DSLocSharedUpdated || 48 || 7F0BB5 || 418072 || If it is 0 then Frame of Shared Dynamic Sprite is not used.
|-
|-
| Reserve Slot for 32x16 30FPS Extended Sprite || !Reserve32x16ExtendedSpriteOf30FPS || Reserve a slot for a Dynamic 30FPS Extended Sprite of 32x16.
| DZ.DSLocSpaceUsedOffset || 48 || 7F0BE5 || 4180A2 || Offset of Space used by Dynamic Sprite in 16x16 tiles.
|-
|-
| Reserve Slot for 32x16 60FPS Extended Sprite || !Reserve32x16ExtendedSpriteOf60FPS || Reserve a slot for a Dynamic 60FPS Extended Sprite of 32x16.
| DZ.DSLocSpaceUsed || 48 || 7F0C15 || 4180D2 || Amount of space reserved by Dynamic Sprite.
|-
|-
| Reserve Slot for 32x16 30FPS Cluster Sprite || !Reserve32x16ClusterSpriteOf30FPS || Reserve a slot for a Dynamic 30FPS Cluster Sprite of 32x16.
| DZ.DSLocIsValid || 48 || 7F0C45 || 418102 || If it is 0, Dynamic Sprite can't be processed.
|-
|-
| Reserve Slot for 32x16 60FPS Cluster Sprite || !Reserve32x16ClusterSpriteOf60FPS || Reserve a slot for a Dynamic 60FPS Cluster Sprite of 32x16.
| DZ.DSLocFrameRateMethod || 48 || 7F0C75 || 418132 || if It is 0 can upload graphics in any frame, 1 only can upload graphics on odd frames and 2 only can upload graphics on even graphics.
|-
|-
| Reserve Slot for 32x16 30FPS Overworld Sprite || !Reserve32x16OWSpriteOf30FPS || Reserve a slot for a Dynamic 30FPS Overworld Sprite of 32x16.
| DZ.DSLocFindSpaceOrder || 48 || 7F0CA5 || 418162 || Next Slot, (because dynamic sprites are builded as a Linked List).
|-
|-
| Reserve Slot for 32x16 60FPS Overworld Sprite || !Reserve32x16OWSpriteOf60FPS || Reserve a slot for a Dynamic 60FPS Overworld Sprite of 32x16.
| DZ.DSLocUSNormal || 22 || 7F0CD5 || 418192 || Dynamic Slot used by Normal Sprites.
|-
|-
| Reserve Slot for 32x32 30FPS Normal Sprite || !Reserve32x32NormalSpriteOf30FPS || Reserve a slot for a Dynamic 30FPS Normal Sprite of 32x32.
| DZ.DSLocUSCluster || 20 || 7F0CEB || 4181A8 || Dynamic Slot used by Cluster Sprites.
|-
|-
| Reserve Slot for 32x32 60FPS Normal Sprite || !Reserve32x32NormalSpriteOf60FPS || Reserve a slot for a Dynamic 60FPS Normal Sprite of 32x32.
| DZ.DSLocUSExtended || 10 || 7F0CFF || 4181BC || Dynamic Slot used by Extended Sprites.
|-
|-
| Reserve Slot for 32x32 30FPS Extended Sprite || !Reserve32x32ExtendedSpriteOf30FPS || Reserve a slot for a Dynamic 30FPS Extended Sprite of 32x32.
| DZ.DSLocUSOW || 16 || 7F0D09 || 4181C6 || Dynamic Slot used by OW Sprites.
|}
 
==== Routines ====
 
{| class="wikitable"
|-
|-
| Reserve Slot for 32x32 60FPS Extended Sprite || !Reserve32x32ExtendedSpriteOf60FPS || Reserve a slot for a Dynamic 60FPS Extended Sprite of 32x32.
| !ClearSlot || Clear slots of Dynamic Sprites that are not used and start VRAM Defragmentation to use less space. It is recommended to use when a Dynamic Sprite dies.
|-
| Reserve Slot for 32x32 30FPS Cluster Sprite || !Reserve32x32ClusterSpriteOf30FPS || Reserve a slot for a Dynamic 30FPS Cluster Sprite of 32x32.
|-
| Reserve Slot for 32x32 60FPS Cluster Sprite || !Reserve32x32ClusterSpriteOf60FPS || Reserve a slot for a Dynamic 60FPS Cluster Sprite of 32x32.
|-
| Reserve Slot for 32x32 30FPS Overworld Sprite || !Reserve32x32OWSpriteOf30FPS || Reserve a slot for a Dynamic 30FPS Overworld Sprite of 32x32.
|-
| Reserve Slot for 32x32 60FPS Overworld Sprite || !Reserve32x32OWSpriteOf60FPS || Reserve a slot for a Dynamic 60FPS Overworld Sprite of 32x32.
|-
| Reserve Slot for 48x48 30FPS Normal Sprite || !Reserve48x48NormalSpriteOf30FPS || Reserve a slot for a Dynamic 30FPS Normal Sprite of 48x48.
|-
| Reserve Slot for 48x48 60FPS Normal Sprite || !Reserve48x48NormalSpriteOf60FPS || Reserve a slot for a Dynamic 60FPS Normal Sprite of 48x48.
|-
| Reserve Slot for 48x48 30FPS Extended Sprite || !Reserve48x48ExtendedSpriteOf30FPS || Reserve a slot for a Dynamic 30FPS Extended Sprite of 48x48.
|-
| Reserve Slot for 48x48 60FPS Extended Sprite || !Reserve48x48ExtendedSpriteOf60FPS || Reserve a slot for a Dynamic 60FPS Extended Sprite of 48x48.
|-
| Reserve Slot for 48x48 30FPS Cluster Sprite || !Reserve48x48ClusterSpriteOf30FPS || Reserve a slot for a Dynamic 30FPS Cluster Sprite of 48x48.
|-
| Reserve Slot for 48x48 60FPS Cluster Sprite || !Reserve48x48ClusterSpriteOf60FPS || Reserve a slot for a Dynamic 60FPS Cluster Sprite of 48x48.
|-
| Reserve Slot for 48x48 30FPS Overworld Sprite || !Reserve48x48OWSpriteOf30FPS || Reserve a slot for a Dynamic 30FPS Overworld Sprite of 48x48.
|-
| Reserve Slot for 48x48 60FPS Overworld Sprite || !Reserve48x48OWSpriteOf60FPS || Reserve a slot for a Dynamic 60FPS Overworld Sprite of 48x48.
|-
| Reserve Slot for 64x64 30FPS Normal Sprite || !Reserve64x64NormalSpriteOf30FPS || Reserve a slot for a Dynamic 30FPS Normal Sprite of 64x64.
|-
| Reserve Slot for 64x64 60FPS Normal Sprite || !Reserve64x64NormalSpriteOf60FPS || Reserve a slot for a Dynamic 60FPS Normal Sprite of 64x64.
|-
| Reserve Slot for 64x64 30FPS Extended Sprite || !Reserve64x64ExtendedSpriteOf30FPS || Reserve a slot for a Dynamic 30FPS Extended Sprite of 64x64.
|-
| Reserve Slot for 64x64 60FPS Extended Sprite || !Reserve64x64ExtendedSpriteOf60FPS || Reserve a slot for a Dynamic 60FPS Extended Sprite of 64x64.
|-
| Reserve Slot for 64x64 30FPS Cluster Sprite || !Reserve64x64ClusterSpriteOf30FPS || Reserve a slot for a Dynamic 30FPS Cluster Sprite of 64x64.
|-
| Reserve Slot for 64x64 60FPS Cluster Sprite || !Reserve64x64ClusterSpriteOf60FPS || Reserve a slot for a Dynamic 60FPS Cluster Sprite of 64x64.
|-
| Reserve Slot for 64x64 30FPS Overworld Sprite || !Reserve64x64OWSpriteOf30FPS || Reserve a slot for a Dynamic 30FPS Overworld Sprite of 64x64.
|-
| Reserve Slot for 64x64 60FPS Overworld Sprite || !Reserve64x64OWSpriteOf60FPS || Reserve a slot for a Dynamic 60FPS Overworld Sprite of 64x64.
|-
| Reserve Slot for 80x80 30FPS Normal Sprite || !Reserve80x80NormalSpriteOf30FPS || Reserve a slot for a Dynamic 30FPS Normal Sprite of 80x80.
|-
| Reserve Slot for 80x80 60FPS Normal Sprite || !Reserve80x80NormalSpriteOf60FPS || Reserve a slot for a Dynamic 60FPS Normal Sprite of 80x80.
|-
| Reserve Slot for 80x80 30FPS Extended Sprite || !Reserve80x80ExtendedSpriteOf30FPS || Reserve a slot for a Dynamic 30FPS Extended Sprite of 80x80.
|-
| Reserve Slot for 80x80 60FPS Extended Sprite || !Reserve80x80ExtendedSpriteOf60FPS || Reserve a slot for a Dynamic 60FPS Extended Sprite of 80x80.
|-
| Reserve Slot for 80x80 30FPS Cluster Sprite || !Reserve80x80ClusterSpriteOf30FPS || Reserve a slot for a Dynamic 30FPS Cluster Sprite of 80x80.
|-
| Reserve Slot for 80x80 60FPS Cluster Sprite || !Reserve80x80ClusterSpriteOf60FPS || Reserve a slot for a Dynamic 60FPS Cluster Sprite of 80x80.
|-
| Reserve Slot for 80x80 30FPS Overworld Sprite || !Reserve80x80OWSpriteOf30FPS || Reserve a slot for a Dynamic 30FPS Overworld Sprite of 80x80.
|-
| Reserve Slot for 80x80 60FPS Overworld Sprite || !Reserve80x80OWSpriteOf60FPS || Reserve a slot for a Dynamic 60FPS Overworld Sprite of 80x80.
|-
| Send Signal for 16x16 Normal Sprite || !SendSignal16x16Normal || Send a signal to Dynamic Z to avoid overwrite slots used for a Dynamic Normal Sprite of 16x16.
|-
| Send Signal for 16x16 Extended Sprite || !SendSignal16x16Extended || Send a signal to Dynamic Z to avoid overwrite slots used for a Dynamic Extended Sprite of 16x16.
|-
| Send Signal for 16x16 Cluster Sprite || !SendSignal16x16Cluster || Send a signal to Dynamic Z to avoid overwrite slots used for a Dynamic Cluster Sprite of 16x16.
|-
| Send Signal for 16x16 Overworld Sprite || !SendSignal16x16OW || Send a signal to Dynamic Z to avoid overwrite slots used for a Dynamic Overworld Sprite of 16x16.
|-
| Send Signal for 32x16 Normal Sprite || !SendSignal32x16Normal || Send a signal to Dynamic Z to avoid overwrite slots used for a Dynamic Normal Sprite of 32x16.
|-
| Send Signal for 32x16 Extended Sprite || !SendSignal32x16Extended || Send a signal to Dynamic Z to avoid overwrite slots used for a Dynamic Extended Sprite of 32x16.
|-
| Send Signal for 32x16 Cluster Sprite || !SendSignal32x16Cluster || Send a signal to Dynamic Z to avoid overwrite slots used for a Dynamic Cluster Sprite of 32x16.
|-
| Send Signal for 32x16 Overworld Sprite || !SendSignal32x16OW || Send a signal to Dynamic Z to avoid overwrite slots used for a Dynamic Overworld Sprite of 32x16.
|-
| Send Signal for 32x32 Normal Sprite || !SendSignal32x32Normal || Send a signal to Dynamic Z to avoid overwrite slots used for a Dynamic Normal Sprite of 32x32.
|-
| Send Signal for 32x32 Extended Sprite || !SendSignal32x32Extended || Send a signal to Dynamic Z to avoid overwrite slots used for a Dynamic Extended Sprite of 32x32.
|-
| Send Signal for 32x32 Cluster Sprite || !SendSignal32x32Cluster || Send a signal to Dynamic Z to avoid overwrite slots used for a Dynamic Cluster Sprite of 32x32.
|-
| Send Signal for 32x32 Overworld Sprite || !SendSignal32x32OW || Send a signal to Dynamic Z to avoid overwrite slots used for a Dynamic Overworld Sprite of 32x32.
|-
| Send Signal for 48x48 Normal Sprite || !SendSignal48x48Normal || Send a signal to Dynamic Z to avoid overwrite slots used for a Dynamic Normal Sprite of 48x48.
|-
| Send Signal for 48x48 Extended Sprite || !SendSignal48x48Extended || Send a signal to Dynamic Z to avoid overwrite slots used for a Dynamic Extended Sprite of 48x48.
|-
| Send Signal for 48x48 Cluster Sprite || !SendSignal48x48Cluster || Send a signal to Dynamic Z to avoid overwrite slots used for a Dynamic Cluster Sprite of 48x48.
|-
| Send Signal for 48x48 Overworld Sprite || !SendSignal48x48OW || Send a signal to Dynamic Z to avoid overwrite slots used for a Dynamic Overworld Sprite of 48x48.
|-
| Send Signal for 64x64 Normal Sprite || !SendSignal64x64Normal || Send a signal to Dynamic Z to avoid overwrite slots used for a Dynamic Normal Sprite of 64x64.
|-
| Send Signal for 64x64 Extended Sprite || !SendSignal64x64Extended || Send a signal to Dynamic Z to avoid overwrite slots used for a Dynamic Extended Sprite of 64x64.
|-
| Send Signal for 64x64 Cluster Sprite || !SendSignal64x64Cluster || Send a signal to Dynamic Z to avoid overwrite slots used for a Dynamic Cluster Sprite of 64x64.
|-
| Send Signal for 64x64 Overworld Sprite || !SendSignal64x64OW || Send a signal to Dynamic Z to avoid overwrite slots used for a Dynamic Overworld Sprite of 64x64.
|-
| Send Signal for 80x80 Normal Sprite || !SendSignal80x80Normal || Send a signal to Dynamic Z to avoid overwrite slots used for a Dynamic Normal Sprite of 80x80.
|-
| Send Signal for 80x80 Extended Sprite || !SendSignal80x80Extended || Send a signal to Dynamic Z to avoid overwrite slots used for a Dynamic Extended Sprite of 80x80.
|-
| Send Signal for 80x80 Cluster Sprite || !SendSignal80x80Cluster || Send a signal to Dynamic Z to avoid overwrite slots used for a Dynamic Cluster Sprite of 80x80.
|-
| Send Signal for 80x80 Overworld Sprite || !SendSignal80x80OW || Send a signal to Dynamic Z to avoid overwrite slots used for a Dynamic Overworld Sprite of 80x80.
|}
|}


==== Macros ====
==== Macros ====
Dynamic Z Include a Macro to do Dynamic Routines easier, the macro is called %DynamicRoutine:
<pre>
macro DynamicRoutine(FPS, SignalRoutine, TransferFrame, FrameIndex, LastFrameIndex, VRAMDisp, BNK, DynamicRoutine, GFXPointer, ResourceOffset, ResourceSize)
</pre>
The parameters are:
* '''FPS:''' if it is 1 then is a Dynamic routine for 30FPS dynamic sprites, if it is 0 then it is a Dynamic Routine for 60FPS dynamic sprites.
* '''SignalRoutine:''' Here you must use one "Send Signal" routines that are on the Routines section. The routine used depends on your sprite, for example if the sprite is 48x48 and it is a Normal sprite then you must use !SendSignal48x48Normal.
* '''TransferFrame:''' Here you must use one of the "Transfer Frame" sprite tables that are on the RAM Addresses section. The table depends on your sprite, for example, if you are making a Normal Sprite then you must use !TransferFrameNormalSprite.
* '''FrameIndex:''' Here you must select a sprite table that you are using for sprite frame. It is used to know what Graphics must load to the VRAM.
* '''LastFrameIndex:''' Here you must select a sprite table for this, this table will be used to save the last frame loaded to the VRAM. Then if the frame doesn't change then won't load graphics again.
* '''VRAMDisp:''' Here you must use one of the "VRAMDisp" sprite tables that are on the RAM Addresses section. The table depends on your sprite, for example, if you are making a Normal Sprite then you must use !VRAMDispNormalSprite.
* '''BNK:''' Here you must indicates in what bank are allocated the resources, if you includes the graphics on the sprite code, then you can do something like this:
<pre>
PHB
PLA
STA $53
</pre>
And use $53 as the parameter ($53 is a scratch ram).
* '''DynamicRoutine:''' Here you must use one "DynamicRoutine" routines that are on the Routines section. The routine used depends on your sprite, for example if the sprite is 48x48 sprite then you must use !DynamicRoutine48x48.
* '''GFXPointer:''' This is a 24 bits value that it is used to know where are allocated the graphics on the ROM (or RAM). If you includes the graphics of the sprite on the code, you can do something like this:
<pre>
GFXPointer:
dw resource
resource:
incbin "sprites\gfx.bin"
</pre>
* '''ResourceOffset:''' This is a 24 bits value that indicates the ROM Address of a table of 16 bits values. Each value of the tables represent the offset of a line that must be loaded on the VRAM, a line is a row of 8 pixels of height that will be loaded to the VRAM, each size of sprite have a number of lines per frame.


{| class="wikitable"
{| class="wikitable"
|-
|-
! Size !! Lines
! Macro !! Description !! Parameters !! Return
|-
|-
| 16x16 || 2
| FindSpace || Check if the VRAM space assigned to the sprite is valid or not, also if is required moves the sprite to other VRAM space to defragment their graphics. ||
* DSSlotUsed : Must be a DZ.DSLocUS<Sprite Type>,x for example if you use a normal sprite use %FindSpace("DZ.DSLocUSNormal,x").
|| Carry Set if VRAM space assigned to the sprite is valid.
|-
|-
| 32x16 || 2
| CheckSlot || Use !ClearSlot and then find a valid slot and assign it to the sprite, also assign its VRAM space. ||
* FrameRateMode : 00 Automatically assign if Sprite uploads graphics in odd or even frames, 01 Sprite uploads graphics in odd frames, 02 Sprite uploads graphics in even frames and 03 Sprite can upload graphics in any frame.
* NumberOf16x16Tiles : Number of tiles of 16x16 that the sprite needs to reserve in VRAM.
* SpriteNumber : For Cluster Sprites use !ClusterSpriteNumber, for Extended Sprites use !ExtendedSpriteNumber and for Overworld Sprites use !OWSpriteNumber.
* SpriteTypeAndSlot : it have format stt 00000, s => 0 Dynamic Sprite and 1 Shared Dynamic Sprite, tt => 00 Normal Sprite, 01 Cluster Sprite, 10 Extended Sprite and 11 Overworld Sprite.
* SpriteUsedSlot : Must be a DZ.DSLocUS<Sprite Type>,x for example if you use a cluster sprite use "DZ.DSLocUSCluster".
|| Sprite is deleted if don't find a valid slot.
|-
|-
| 32x32 || 2
| CheckSlotNormalSprite || Check Slot but for Normal Sprites, it assumes that ExtraByte is used for FrameRateMode. ||
* NumberOf16x16Tiles : Number of tiles of 16x16 that the sprite needs to reserve in VRAM.
* SpriteTypeAndSlot : it have format s 0000000, s => 0 Dynamic Sprite and 1 Shared Dynamic Sprite.
|| Sprite is deleted if don't find a valid slot. The sprite can be respawned later.
|-
|-
| 48x48 || 2
| GFXTabDef || Generates the define !GraphicsTable, used to find GFX inserted with GFX and Tilemap Inserter. ||
* index : Index of resource in GFX and Tilemap Inserter, it is autogenerated by the tool using the define !ResourceIndex.
|| None
|-
|-
| 64x64 || 4
| GFXDef || Generates a define !GFX<offset> (for example !GFX00) that haves the address of the gfx. ||
* offset : Is an Hex number of 2 digits, the number represents the index of the GFX, for example if it is the first GFX of the sprite, then is 00, the second is 01, etc.
|| None
|-
|-
| 80x80 || 6
| DynamicRoutine || Fill tables of VRAM DMA Mirrors to uploads graphics. ||
* VRAMOffset : Index of the first tile of 8x8 where the routine should start to fill space, This can be get with macro GetVramDispDynamicRoutine.
* ResourceAddr : RAM Address of the GFX that you want to use. If you use GFX and Tilemap Inserter, you can use #!GFXAA, where AA is the number of the GFX you want, for example #!GFX00 is the first GFX file used by the sprite.
* ResourceAddr : BNK of the RAM Address of the GFX that you want to use. If you use GFX and Tilemap Inserter, you can use #!GFXAA>>16, where AA is the number of the GFX you want, for example #!GFX00>>16 is the BNK of the first GFX file used by the sprite.
* ResourceOffset : Starting position where the DMA must start to read on the GFX.
* Size : Number of tiles of 8x8 that must send to VRAM.
|| None
|-
|  CheckEvenOrOdd || Is used to syncronize Dynamic routine with Animation routine in 30 FPS Dynamic sprites. ||
* DSLocUS : Must be a DZ.DSLocUS<Sprite Type> for example if you use a normal sprite use CheckEvenOrOdd(DZ.DSLocUSNormal).
|| Z flag is 0 if lowest bit of DZ.Timer is equal to FrameRateMode. 1 if lowest bit of DZ.Timer is different to FrameRateMode
|-
| GetVramDisp || Get the tile offset, this is used on the Graphic routine to Remap OAM Tiles to the space used by the Dynamic Sprite ||
* DSLocUS : Must be a DZ.DSLocUS<Sprite Type> for example if you use a normal sprite use CheckEvenOrOdd(DZ.DSLocUSNormal).
|| A = Offset
|-
| GetVramDispDynamicRoutine || Similar to GetVramDisp but for Dynamic Routine ||
* DSLocUS : Must be a DZ.DSLocUS<Sprite Type> for example if you use a normal sprite use CheckEvenOrOdd(DZ.DSLocUSNormal).
|| A = Offset
|-
| RemapOamTile || Remap OAM Tile to the space used by the Dynamic Sprite on the Graphic Routine ||
* Tile : The tile that to Remap
* Offset : Ressult get from GetVramDisp macro.
|| A = Remapped OAM Tile.
|}
|}
Each value of this table, have the offset of that line in bytes, how to know the offset? well each space 8x8 on the gfx uses 32 bytes (#$20 bytes), a complete row of on a GFX uses 512 bytes (#$0200 bytes), for example in this case:
[[File:Piranha Plant Example.png|128px|center]]
The first line of the first frame start at the top left of the GFX, it uses the Offset $0000, the second line is 1 row below then you must add 512 bytes, then its value should be $0200, the third line is 1 row below second line then it must be $0400. This example is only to show how calculate the value of the offset, but in real cases piranha plant is a 32x32 dynamic sprite then it only use 2 lines.
* '''ResourceSize:''' This is a 24 bits value that indicates the ROM Address of a table of 16 bits values. Each value of the tables represent the lenght of a line that must be loaded on the VRAM. To calculate this, you must considere that each 8x8 tile requires 32 bytes (#$20 bytes), Considering this, on the last example each line should have a value of $0080. If a line uses 512 bytes, then you can add the next line and the next line set it in 0, this allows to load both line in only 1 DMA transfer. Example:
<pre>
ResourceSize:
Walk0_ResourceSize:
dw $0200,$0200,$0060,$0040
</pre>
Can be changed to:
<pre>
ResourceSize:
Walk0_ResourceSize:
dw $0460,$0000,$0000,$0040
</pre>
Both are the same, but the second way transfer 3 lines in 1 DMA transfer saving some cycles


==== How To Do a Dynamic Sprite ====
== How to create Dynamic Sprites  ==


[[Category:ASM]] [[Category:Super Mario World]]
[[Category:ASM]] [[Category:Super Mario World]]

Latest revision as of 05:04, 16 July 2023

English Português Español 日本語

Dynamic Z is a patch for Super Mario World that allows performing a variety of actions during V-Blank. It was made by anonimzwx. Dynamic Z is meant to be a replacement for DSX as both allow coding dynamic sprites.

Features

  • Dynamic Sprite Support: Sprites that uploads their graphics to the VRAM when they need allowing unlimited number of frames.
  • Shared Dynamic Sprite Support: Dynamic Sprites but each copy of the sprite shares graphics then doesn't have limitation of number.
  • Semi Dynamic Sprite Support: Regular Sprites that uploads all their graphics to the VRAM when they are spawned on the level, each copy of the sprite use the same space in VRAM.
  • Giant Dynamic Sprite Support: Very Big Dynamic Sprites. Any that fits in 48 16x16 tiles or less.
  • Graphics Change on the fly: Can change GFXs in game by code.
  • Tilemap Change on the fly: Can change Tilemaps of any layer in game by code.
  • Color Palette Change on the fly: Can change color palettes in game by code.
  • Block Changer: Allows to change several blocks, this allows to modify terrain of Layer 1 or Layer 2.
  • DMA Mirror: Includes a Ram Address that mirrors register $420B and can be used to do DMA transfers.
  • SA1's Widescreen: Makes easier to use the widescreen of SA1 pack, every 6~7 scanlines killed Dynamic Z allows 8 16x16 tiles more to use in Dynamic sprites or Graphics Change. Only Available if ROM uses SA1.

Optional Features

  • Player Features: Can change graphics or color palettes of player on the fly, allowing Custom Players, the size is defined by the user but bigger player = less dynamic sprites. Also in vanilla case optimize player routine to save a lot of cycles during NMI. Not Compatible with resources that change things of the player like 8x8 tiles DMAer or 32x32 player (New version will be compatible with LX5's Custom Power Ups).
  • 50% More Mode: if it is activate, status bar, podoboos and most of minor DMA, then is possible to send 50% more data by DMA, that means 50% more Dynamic Sprites or graphics changes. Not compatible with resources that changes things with Status Bar.

Dynamic Z vs DSX

DSX Dynamic Z
Number of Dynamic Sprites 4 of 32x32, 1 of 64x64 Any number of sprites while it fits on the designed space. By default allows 32 16x16 tiles.
Frame Rate 60 FPS 30 or 60 FPS, if you use 30 FPS sprites you can use more dynamic sprites.
Performance Requires a buffer to sort the data before transfer it to VRAM wasting a lot of cycles. Send data directly to VRAM and only transfer data when is needed saving a lot of cycles on NMI, It doesn't require a buffer then doesn't waste cycles fitting graphics on the buffer.
Sizes 32x32 or 64x64, do others sizes is possible but harder. Any if it fits on the designed space.
VRAM Options Only allows to fit Dynamic Sprites on SP4 Second Half User can define where fit Dynamic Sprites, Default address can be changed on the patch, address can be changed in game by code.
Shared Dynamic Sprites No Allows Dynamic Sprites that shares graphics on VRAM, Shared Dynamic Sprites doesn't have limitations of number.
Semi-Dynamic Sprites No Normal sprites that when are spawned on the stage, they upload all their graphics to VRAM.
Giant-Dynamic Sprites No Very Big Dynamic Sprite, (Max Size any that use a space in vram of 48 tiles).
Auto-Defragmentation of VRAM No When a Dynamic sprite is spawned, it clears reserved space of unused slots and compress space on VRAM.

Installation

Without SA-1

  1. Insert Dynamic Z as any other patch.

With SA-1

  1. Open a Clear ROM with Lunar Magic.
  2. Expand Rom (if you want to use a lot of Dynamic Sprites i recommend 4mb)
  3. Open "sa1.asm" and change this to 0:
    !DSX		= 1				; Put 0 if you want to turn off legacy (Dynamic Sprites) patch support.
    						; (as anoni's Dynamic Z should obsolete it soon.)
    
  4. Insert SA-1.
  5. Insert Dynamic Z as any other Patch.

Installing Dynamic Z's Library and Defines

Pixi

  1. Run "Dynamic Z Pixi Installer.exe". This will generate a define file in "./asm/ExtraDefines", that can be used by any other Dynamic Sprite. If you want to do it manually, just copy the file "DynamicZDefines.asm" and put it on "./asm/ExtraDefines".

Uber asm patch

Under Construction

Uber asm Tool

Under Construction

GPS

Under Construction

Overworld Sprite Tool

Under Construction

Inserting Dynamic Resources

Dynamic Z includes a tool to insert graphics or tilemaps on the ROM using freedata and allows to resources get them with just a macro. This system is specially useful for resources that uses more than 1 BNK, I recommend use it always for any resource because freecode is better keep them just for code and freedata for graphics and tilemaps.

  1. Put graphics or "Dynamic Resources" folder.
  2. Open "ResourceList.txt". It will look like this:
    PIXI:
    .Normal
    .Cluster
    .Extended
    OTHER:
    

    For Normal, Clusters or Extended Sprites, write the name of the sprite on the correct label.

    Example:

    PIXI:
    .Normal
    klaptrap
    klump
    piranha plant
    .Cluster
    DKC butterfly
    DKC fish
    .Extended
    OTHER:
    

    For other resources write the complete path after label OTHER.

    Example:

    PIXI:
    .Normal
    klaptrap
    klump
    piranha plant
    .Cluster
    DKC butterfly
    DKC fish
    .Extended
    OTHER:
    ./blocks/block that change GFX when is touched.asm
    ./level/awesome uberasm.asm
    
  3. Run "DynamicResourceAdder.exe".
  4. Insert resources.

Using Normal Dynamic Sprites with the New System

if the sprite is 60FPS, it must be inserted on lunar magic as any other sprite. if the sprite is 30FPS, The highest 2 bits of Extra Byte 1 requires on of this 3 values.

  • 00: Automatically assign if It uploads graphics to vram on even or odd frames.
  • 01: It uploads graphics to VRAM only in odd frames.
  • 02: It uploads graphics to VRAM only in even frames.

By default use always 00 for this, 01 and 02 are used if you want to do GFX or Tilemap Changes and use Dynamic Sprites without flickering, for that you can do that dynamic sprites use only odd frames and upload GFX or Tilemaps in Even Frames.

Library

Dynamic Z includes severals routines and macros to help developers. Some of them can be used on any resource and others are exclusive for Dynamic Sprites.

Global Library

Variables

Name Size Default Address Lorom Default Address SA-1 Description
DZ.Timer 1 7F0B44 418000 Increase in 1 every frame that Dynamic Z is executed. Used to syncronize 30FPS Dynamic Sprites.
DZ.MaxDataPerFrameIn16x16Tiles 1 7F0B45 418001 How many Tiles of 16x16 can be send to VRAM per frame without flickering.
DZ.MaxDataPerFrame 2 7F0B46 418002 How many bytes can be send to VRAM per frame without flickering. Is Calculated as DZ.MaxDataPerFrameIn16x16Tiles*0x80.
DZ.PPUMirrors.CGRAMTransferLength 1 7F0D19 4181D6 Number of transfers to CGRAM, Max Value is 0x40.
DZ.PPUMirrors.CGRAMTransferSourceBNKLength 128 4181D7 4181D7 First byte is the BNK of Source, Second byte is the amount of data send by each transfer to CGRAM.
DZ.PPUMirrors.CGRAMTransferOffset 64 7F0D9A 418257 Address of CGRAM to start to send data.
DZ.PPUMirrors.CGRAMTransferSource 128 7F0DDA 418297 Address of table with Colors.
DZ.PPUMirrors.VRAMTransferLength 1 7F0E5A 418317 Number of transfer to VRAM, Max Value is 0xFE.
DZ.PPUMirrors.VRAMTransferSource 190 7F0E5B 418318 Address of resource send to VRAM.
DZ.PPUMirrors.VRAMTransferSourceBNK 190 7F0F19 4183D6 BNK of Address of resource send to VRAM.
DZ.PPUMirrors.VRAMTransferSourceLength 190 7F0FD7 418494 Data send by each transfer to VRAM.
DZ.PPUMirrors.VRAMTransferOffset 190 7F1095 418552 Address of VRAM to starte to send data.

Routines

UNDER CONSTRUCTION

Macros

UNDER CONSTRUCTION

Dynamic Sprites Library

Variables

Name Size Default Address Lorom Default Address SA-1 Description
DZ.DSLastSlot 1 7F0B47 418004 Index of the Last Slot.
DZ.DSFirstSlot 1 7F0B48 418005 Index of the First Slot.
DZ.DSMaxSpace 1 7F0B49 418006 Max space available for Dynamic Sprites in 16x16 Tiles, by Default is 0x30.
DZ.DSFindSpaceMethod 1 7F0B4A 418007 If it is 0, It find space starting from VRAMOffset (Top to Bottom), otherwise find space starting from VRAMOffset + Max Space (Bottom to Top).
DZ.DSStartingVRAMOffset 2 7F0B4B 418008 Position on VRAM to start to find space for Dynamic Graphics.
DZ.DSStartingVRAMOffset8x8Tiles 1 7F0B4D 41800A DSStartingVRAMOffset but in 8x8 tiles.
DZ.DSTotalSpaceUsed 1 7F0B4E 41800B Amount of space used by Dynamic Sprites in 8x8 tiles.
DZ.DSTotalSpaceUsedOdd 1 7F0B4F 41800C Amount of space used by Dynamic Sprites on Odd frames in 8x8 tiles.
DZ.DSTotalSpaceUsedEven 1 7F0B50 41800D Amount of space used by Dynamic Sprites on Even frames in 8x8 tiles.
DZ.DSTotalDataSentOdd 1 7F0B51 41800E Amount of Max data send by Dynamic Sprites on Odd frames in 8x8 tiles.
DZ.DSTotalDataSentEven 1 7F0B52 41800F Amount of Max data send by Dynamic Sprites on Even frames in 8x8 tiles.
DZ.DSCurrentSlotSearcher 1 7F0B53 418010 Used by Find Space Routine to move space used by a dynamic sprite to defragment it. Index of the Slot of sprite to defragment.
DZ.DSSlotSearchedOffset 1 7F0B54 418011 Used by Find Space Routine to move space used by a dynamic sprite to defragment it. Space to move the sprite.
DZ.DSLocUsedBy 48 7F0B55 418012 Format s tt iiiii. s => 0 Regular Dynamic Sprite, 1 Shared Dynamic Sprite. tt => 00 = Normal Sprite, 01 = Cluster Sprite, 10 = Extended Sprite and 11 = OW Sprite. iiiii Slot of the Sprite.
DZ.DSLocSpriteNumber 48 7F0B85 418042 Sprite Number.
DZ.DSLocSharedUpdated 48 7F0BB5 418072 If it is 0 then Frame of Shared Dynamic Sprite is not used.
DZ.DSLocSpaceUsedOffset 48 7F0BE5 4180A2 Offset of Space used by Dynamic Sprite in 16x16 tiles.
DZ.DSLocSpaceUsed 48 7F0C15 4180D2 Amount of space reserved by Dynamic Sprite.
DZ.DSLocIsValid 48 7F0C45 418102 If it is 0, Dynamic Sprite can't be processed.
DZ.DSLocFrameRateMethod 48 7F0C75 418132 if It is 0 can upload graphics in any frame, 1 only can upload graphics on odd frames and 2 only can upload graphics on even graphics.
DZ.DSLocFindSpaceOrder 48 7F0CA5 418162 Next Slot, (because dynamic sprites are builded as a Linked List).
DZ.DSLocUSNormal 22 7F0CD5 418192 Dynamic Slot used by Normal Sprites.
DZ.DSLocUSCluster 20 7F0CEB 4181A8 Dynamic Slot used by Cluster Sprites.
DZ.DSLocUSExtended 10 7F0CFF 4181BC Dynamic Slot used by Extended Sprites.
DZ.DSLocUSOW 16 7F0D09 4181C6 Dynamic Slot used by OW Sprites.

Routines

!ClearSlot Clear slots of Dynamic Sprites that are not used and start VRAM Defragmentation to use less space. It is recommended to use when a Dynamic Sprite dies.

Macros

Macro Description Parameters Return
FindSpace Check if the VRAM space assigned to the sprite is valid or not, also if is required moves the sprite to other VRAM space to defragment their graphics.
  • DSSlotUsed : Must be a DZ.DSLocUS<Sprite Type>,x for example if you use a normal sprite use %FindSpace("DZ.DSLocUSNormal,x").
Carry Set if VRAM space assigned to the sprite is valid.
CheckSlot Use !ClearSlot and then find a valid slot and assign it to the sprite, also assign its VRAM space.
  • FrameRateMode : 00 Automatically assign if Sprite uploads graphics in odd or even frames, 01 Sprite uploads graphics in odd frames, 02 Sprite uploads graphics in even frames and 03 Sprite can upload graphics in any frame.
  • NumberOf16x16Tiles : Number of tiles of 16x16 that the sprite needs to reserve in VRAM.
  • SpriteNumber : For Cluster Sprites use !ClusterSpriteNumber, for Extended Sprites use !ExtendedSpriteNumber and for Overworld Sprites use !OWSpriteNumber.
  • SpriteTypeAndSlot : it have format stt 00000, s => 0 Dynamic Sprite and 1 Shared Dynamic Sprite, tt => 00 Normal Sprite, 01 Cluster Sprite, 10 Extended Sprite and 11 Overworld Sprite.
  • SpriteUsedSlot : Must be a DZ.DSLocUS<Sprite Type>,x for example if you use a cluster sprite use "DZ.DSLocUSCluster".
Sprite is deleted if don't find a valid slot.
CheckSlotNormalSprite Check Slot but for Normal Sprites, it assumes that ExtraByte is used for FrameRateMode.
  • NumberOf16x16Tiles : Number of tiles of 16x16 that the sprite needs to reserve in VRAM.
  • SpriteTypeAndSlot : it have format s 0000000, s => 0 Dynamic Sprite and 1 Shared Dynamic Sprite.
Sprite is deleted if don't find a valid slot. The sprite can be respawned later.
GFXTabDef Generates the define !GraphicsTable, used to find GFX inserted with GFX and Tilemap Inserter.
  • index : Index of resource in GFX and Tilemap Inserter, it is autogenerated by the tool using the define !ResourceIndex.
None
GFXDef Generates a define !GFX<offset> (for example !GFX00) that haves the address of the gfx.
  • offset : Is an Hex number of 2 digits, the number represents the index of the GFX, for example if it is the first GFX of the sprite, then is 00, the second is 01, etc.
None
DynamicRoutine Fill tables of VRAM DMA Mirrors to uploads graphics.
  • VRAMOffset : Index of the first tile of 8x8 where the routine should start to fill space, This can be get with macro GetVramDispDynamicRoutine.
  • ResourceAddr : RAM Address of the GFX that you want to use. If you use GFX and Tilemap Inserter, you can use #!GFXAA, where AA is the number of the GFX you want, for example #!GFX00 is the first GFX file used by the sprite.
  • ResourceAddr : BNK of the RAM Address of the GFX that you want to use. If you use GFX and Tilemap Inserter, you can use #!GFXAA>>16, where AA is the number of the GFX you want, for example #!GFX00>>16 is the BNK of the first GFX file used by the sprite.
  • ResourceOffset : Starting position where the DMA must start to read on the GFX.
  • Size : Number of tiles of 8x8 that must send to VRAM.
None
CheckEvenOrOdd Is used to syncronize Dynamic routine with Animation routine in 30 FPS Dynamic sprites.
  • DSLocUS : Must be a DZ.DSLocUS<Sprite Type> for example if you use a normal sprite use CheckEvenOrOdd(DZ.DSLocUSNormal).
Z flag is 0 if lowest bit of DZ.Timer is equal to FrameRateMode. 1 if lowest bit of DZ.Timer is different to FrameRateMode
GetVramDisp Get the tile offset, this is used on the Graphic routine to Remap OAM Tiles to the space used by the Dynamic Sprite
  • DSLocUS : Must be a DZ.DSLocUS<Sprite Type> for example if you use a normal sprite use CheckEvenOrOdd(DZ.DSLocUSNormal).
A = Offset
GetVramDispDynamicRoutine Similar to GetVramDisp but for Dynamic Routine
  • DSLocUS : Must be a DZ.DSLocUS<Sprite Type> for example if you use a normal sprite use CheckEvenOrOdd(DZ.DSLocUSNormal).
A = Offset
RemapOamTile Remap OAM Tile to the space used by the Dynamic Sprite on the Graphic Routine
  • Tile : The tile that to Remap
  • Offset : Ressult get from GetVramDisp macro.
A = Remapped OAM Tile.

How to create Dynamic Sprites