Update graphics modes: add more uze_atmega644_mode{,1}3 descritions

6 files changed, 418 insertions, 0 deletions

diff --git a/src/hardware_data/graphics/uze_atmega644_mode13_scroll-mode-with-extended-palette.lua b/src/hardware_data/graphics/uze_atmega644_mode13_scroll-mode-with-extended-palette.lua
index 1e7275e..915811c 100644
--- a/src/hardware_data/graphics/uze_atmega644_mode13_scroll-mode-with-extended-palette.lua
+++ b/src/hardware_data/graphics/uze_atmega644_mode13_scroll-mode-with-extended-palette.lua
@@ -1,6 +1,101 @@
 -- Information:                             --
 -- Video Mode 13 (official)                 --
 --                                          --
+-- Scroll Mode and Static Mode,             --
+-- can be changed by compilation.           --
+-- Default value is:                        --
+-- SCROLLING=0 (Static Mode)                --
+-- Available values are:                    --
+-- SCROLLING=0 (Static Mode)                --
+-- SCROLLING=1 (Scroll Mode)                --
+--                                          --
+-- Maximum sprites on screen and RAM tiles  --
+-- can be changed by compilation.           --
+-- In video mode 3, the maximum             --
+-- sprites on screen is 20, due of limit    --
+-- VRAM (4K) and CPU                        --
+-- In video mode 13, the maximum            --
+-- sprites on screen is more that 20, due   --
+-- of palette limitation.                   --
+-- Default value is:                        --
+-- RAM_TILE_COUNT=0                         --
+-- RAM_TILE_COUNT is needed to change to    --
+-- compile it.                              --
+-- MAX_SPRITES=32 (20)                      --
+-- MAX_RAMTILES=90                          --
+-- Available values are:                    --
+-- RAM_TILE_COUNT=1 to                      --
+-- RAM_TILE_COUNT=255                       --
+-- MAX_SPRITES=1 to MAX_SPRITES=20 or more, --
+-- but is not recomended, due of hardware   --
+-- limitation.                              --
+-- MAX_RAMTILES=90 (unchangeable)           --
+--                                          --
+-- Default palette (8 colours) and          --
+-- Extended palette (15 colours)            --
+-- can be changed by compilation.           --
+-- Default value is:                        --
+-- EXTENDED_PALETTE=0                       --
+-- Available value is:                      --
+-- EXTENDED_PALETTE=0                       --
+-- EXTENDED_PALETTE=1                       --
+--                                          --
+-- Horizontal tiles on screen and/or VRAM,  --
+-- can be changed by compilation,           --
+-- but is not recomended.                   --
+-- Default value is:                        --
+-- {SCREEN,VRAM}_TILES_H=30 if SCROLLING=0  --
+-- and SCREEN_TILES_H == VRAM_TILES_H       --
+-- SCREEN_TILES_H=28        if SCROLLING=1  --
+-- VRAM_TILES_H=32          if SCROLLING=1  --
+--                                          --
+-- Vertical tiles on screen and/or VRAM,    --
+-- can be changed by compilation,           --
+-- but is not recomended.                   --
+-- Default value is:                        --
+-- {SCREEN,VRAM}_TILES_V=28 if SCROLLING=0  --
+-- and SCREEN_TILES_V == VRAM_TILES_V       --
+-- SCREEN_TILES_V=28        if SCROLLING=1  --
+-- VRAM_TILES_V=32          if SCROLLING=1  --
+-- Available value is:                      --
+-- VRAM_TILES_V=32          if SCROLLING=1  --
+-- VRAM_TILES_V=24          if SCROLLING=1  --
+-- VRAM_TILES_V=16          if SCROLLING=1  --
+--                                          --
+-- Tile width size in pixels,               --
+-- can be changed by compilation,           --
+-- more that 224 pixels is not recommended. --
+-- Default value is:                        --
+-- TILE_WIDTH=8                             --
+-- Available value is:                      --
+-- TILE_WIDTH=1 to TILE_WIDTH=224 or more   --
+--                                          --
+-- Tile height size in pixels,              --
+-- can be changed by compilation,           --
+-- more that 224 pixels with scrolling or   --
+-- 240 pixels without scrolling is not      --
+-- recommended.                             --
+-- Default value is:                        --
+-- TILE_HEIGHT=8                            --
+-- Available value is:                      --
+-- TILE_HEIGHT=1 to TILE_HEIGHT=224 or more --
+--   if SCROLLING=1                         --
+-- TILE_HEIGHT=1 to TILE_HEIGHT=240 or more --
+--   if SCROLLING=0                         --
+--                                          --
+-- Numbers of video lines to render,        --
+-- can be changed by compilation,           --
+-- but is not recommended, changes the      --
+-- CPU cyles.                               --
+-- Default value is:                        --
+-- FRAME_LINES=SCREEN_TILES_V*TILE_HEIGHT   --
+--                                          --
+-- First render line is used to adjust      --
+-- vertical centering if the value          --
+-- FRAME_LINES is changed.                  --
+-- Can be changed by compilation.           --
+-- Default value is:                        --
+-- FIRST_RENDER_LINE=20                     --
 
 -- Sites:
 -- http://uzebox.org/wiki/index.php?title=Video_Modes
diff --git a/src/hardware_data/graphics/uze_atmega644_mode13_scroll-mode-without-extended-palette.lua b/src/hardware_data/graphics/uze_atmega644_mode13_scroll-mode-without-extended-palette.lua
index 2f44e3b..6717e2e 100644
--- a/src/hardware_data/graphics/uze_atmega644_mode13_scroll-mode-without-extended-palette.lua
+++ b/src/hardware_data/graphics/uze_atmega644_mode13_scroll-mode-without-extended-palette.lua
@@ -1,6 +1,101 @@
 -- Information:                             --
 -- Video Mode 13 (official)                 --
 --                                          --
+-- Scroll Mode and Static Mode,             --
+-- can be changed by compilation.           --
+-- Default value is:                        --
+-- SCROLLING=0 (Static Mode)                --
+-- Available values are:                    --
+-- SCROLLING=0 (Static Mode)                --
+-- SCROLLING=1 (Scroll Mode)                --
+--                                          --
+-- Maximum sprites on screen and RAM tiles  --
+-- can be changed by compilation.           --
+-- In video mode 3, the maximum             --
+-- sprites on screen is 20, due of limit    --
+-- VRAM (4K) and CPU                        --
+-- In video mode 13, the maximum            --
+-- sprites on screen is more that 20, due   --
+-- of palette limitation.                   --
+-- Default value is:                        --
+-- RAM_TILE_COUNT=0                         --
+-- RAM_TILE_COUNT is needed to change to    --
+-- compile it.                              --
+-- MAX_SPRITES=32 (20)                      --
+-- MAX_RAMTILES=90                          --
+-- Available values are:                    --
+-- RAM_TILE_COUNT=1 to                      --
+-- RAM_TILE_COUNT=255                       --
+-- MAX_SPRITES=1 to MAX_SPRITES=20 or more, --
+-- but is not recomended, due of hardware   --
+-- limitation.                              --
+-- MAX_RAMTILES=90 (unchangeable)           --
+--                                          --
+-- Default palette (8 colours) and          --
+-- Extended palette (15 colours)            --
+-- can be changed by compilation.           --
+-- Default value is:                        --
+-- EXTENDED_PALETTE=0                       --
+-- Available value is:                      --
+-- EXTENDED_PALETTE=0                       --
+-- EXTENDED_PALETTE=1                       --
+--                                          --
+-- Horizontal tiles on screen and/or VRAM,  --
+-- can be changed by compilation,           --
+-- but is not recomended.                   --
+-- Default value is:                        --
+-- {SCREEN,VRAM}_TILES_H=30 if SCROLLING=0  --
+-- and SCREEN_TILES_H == VRAM_TILES_H       --
+-- SCREEN_TILES_H=28        if SCROLLING=1  --
+-- VRAM_TILES_H=32          if SCROLLING=1  --
+--                                          --
+-- Vertical tiles on screen and/or VRAM,    --
+-- can be changed by compilation,           --
+-- but is not recomended.                   --
+-- Default value is:                        --
+-- {SCREEN,VRAM}_TILES_V=28 if SCROLLING=0  --
+-- and SCREEN_TILES_V == VRAM_TILES_V       --
+-- SCREEN_TILES_V=28        if SCROLLING=1  --
+-- VRAM_TILES_V=32          if SCROLLING=1  --
+-- Available value is:                      --
+-- VRAM_TILES_V=32          if SCROLLING=1  --
+-- VRAM_TILES_V=24          if SCROLLING=1  --
+-- VRAM_TILES_V=16          if SCROLLING=1  --
+--                                          --
+-- Tile width size in pixels,               --
+-- can be changed by compilation,           --
+-- more that 224 pixels is not recommended. --
+-- Default value is:                        --
+-- TILE_WIDTH=8                             --
+-- Available value is:                      --
+-- TILE_WIDTH=1 to TILE_WIDTH=224 or more   --
+--                                          --
+-- Tile height size in pixels,              --
+-- can be changed by compilation,           --
+-- more that 224 pixels with scrolling or   --
+-- 240 pixels without scrolling is not      --
+-- recommended.                             --
+-- Default value is:                        --
+-- TILE_HEIGHT=8                            --
+-- Available value is:                      --
+-- TILE_HEIGHT=1 to TILE_HEIGHT=224 or more --
+--   if SCROLLING=1                         --
+-- TILE_HEIGHT=1 to TILE_HEIGHT=240 or more --
+--   if SCROLLING=0                         --
+--                                          --
+-- Numbers of video lines to render,        --
+-- can be changed by compilation,           --
+-- but is not recommended, changes the      --
+-- CPU cyles.                               --
+-- Default value is:                        --
+-- FRAME_LINES=SCREEN_TILES_V*TILE_HEIGHT   --
+--                                          --
+-- First render line is used to adjust      --
+-- vertical centering if the value          --
+-- FRAME_LINES is changed.                  --
+-- Can be changed by compilation.           --
+-- Default value is:                        --
+-- FIRST_RENDER_LINE=20                     --
 
 -- Sites:
 -- http://uzebox.org/wiki/index.php?title=Video_Modes
diff --git a/src/hardware_data/graphics/uze_atmega644_mode13_static-mode-with-extended-palette.lua b/src/hardware_data/graphics/uze_atmega644_mode13_static-mode-with-extended-palette.lua
index a6acef6..dd0c64f 100644
--- a/src/hardware_data/graphics/uze_atmega644_mode13_static-mode-with-extended-palette.lua
+++ b/src/hardware_data/graphics/uze_atmega644_mode13_static-mode-with-extended-palette.lua
@@ -1,6 +1,101 @@
 -- Information:                             --
 -- Video Mode 13 (official)                 --
 --                                          --
+-- Scroll Mode and Static Mode,             --
+-- can be changed by compilation.           --
+-- Default value is:                        --
+-- SCROLLING=0 (Static Mode)                --
+-- Available values are:                    --
+-- SCROLLING=0 (Static Mode)                --
+-- SCROLLING=1 (Scroll Mode)                --
+--                                          --
+-- Maximum sprites on screen and RAM tiles  --
+-- can be changed by compilation.           --
+-- In video mode 3, the maximum             --
+-- sprites on screen is 20, due of limit    --
+-- VRAM (4K) and CPU                        --
+-- In video mode 13, the maximum            --
+-- sprites on screen is more that 20, due   --
+-- of palette limitation.                   --
+-- Default value is:                        --
+-- RAM_TILE_COUNT=0                         --
+-- RAM_TILE_COUNT is needed to change to    --
+-- compile it.                              --
+-- MAX_SPRITES=32 (20)                      --
+-- MAX_RAMTILES=90                          --
+-- Available values are:                    --
+-- RAM_TILE_COUNT=1 to                      --
+-- RAM_TILE_COUNT=255                       --
+-- MAX_SPRITES=1 to MAX_SPRITES=20 or more, --
+-- but is not recomended, due of hardware   --
+-- limitation.                              --
+-- MAX_RAMTILES=90 (unchangeable)           --
+--                                          --
+-- Default palette (8 colours) and          --
+-- Extended palette (15 colours)            --
+-- can be changed by compilation.           --
+-- Default value is:                        --
+-- EXTENDED_PALETTE=0                       --
+-- Available value is:                      --
+-- EXTENDED_PALETTE=0                       --
+-- EXTENDED_PALETTE=1                       --
+--                                          --
+-- Horizontal tiles on screen and/or VRAM,  --
+-- can be changed by compilation,           --
+-- but is not recomended.                   --
+-- Default value is:                        --
+-- {SCREEN,VRAM}_TILES_H=30 if SCROLLING=0  --
+-- and SCREEN_TILES_H == VRAM_TILES_H       --
+-- SCREEN_TILES_H=28        if SCROLLING=1  --
+-- VRAM_TILES_H=32          if SCROLLING=1  --
+--                                          --
+-- Vertical tiles on screen and/or VRAM,    --
+-- can be changed by compilation,           --
+-- but is not recomended.                   --
+-- Default value is:                        --
+-- {SCREEN,VRAM}_TILES_V=28 if SCROLLING=0  --
+-- and SCREEN_TILES_V == VRAM_TILES_V       --
+-- SCREEN_TILES_V=28        if SCROLLING=1  --
+-- VRAM_TILES_V=32          if SCROLLING=1  --
+-- Available value is:                      --
+-- VRAM_TILES_V=32          if SCROLLING=1  --
+-- VRAM_TILES_V=24          if SCROLLING=1  --
+-- VRAM_TILES_V=16          if SCROLLING=1  --
+--                                          --
+-- Tile width size in pixels,               --
+-- can be changed by compilation,           --
+-- more that 224 pixels is not recommended. --
+-- Default value is:                        --
+-- TILE_WIDTH=8                             --
+-- Available value is:                      --
+-- TILE_WIDTH=1 to TILE_WIDTH=224 or more   --
+--                                          --
+-- Tile height size in pixels,              --
+-- can be changed by compilation,           --
+-- more that 224 pixels with scrolling or   --
+-- 240 pixels without scrolling is not      --
+-- recommended.                             --
+-- Default value is:                        --
+-- TILE_HEIGHT=8                            --
+-- Available value is:                      --
+-- TILE_HEIGHT=1 to TILE_HEIGHT=224 or more --
+--   if SCROLLING=1                         --
+-- TILE_HEIGHT=1 to TILE_HEIGHT=240 or more --
+--   if SCROLLING=0                         --
+--                                          --
+-- Numbers of video lines to render,        --
+-- can be changed by compilation,           --
+-- but is not recommended, changes the      --
+-- CPU cyles.                               --
+-- Default value is:                        --
+-- FRAME_LINES=SCREEN_TILES_V*TILE_HEIGHT   --
+--                                          --
+-- First render line is used to adjust      --
+-- vertical centering if the value          --
+-- FRAME_LINES is changed.                  --
+-- Can be changed by compilation.           --
+-- Default value is:                        --
+-- FIRST_RENDER_LINE=20                     --
 
 -- Sites:
 -- http://uzebox.org/wiki/index.php?title=Video_Modes
diff --git a/src/hardware_data/graphics/uze_atmega644_mode13_static-mode-without-extended-palette.lua b/src/hardware_data/graphics/uze_atmega644_mode13_static-mode-without-extended-palette.lua
index 57a7433..a93e136 100644
--- a/src/hardware_data/graphics/uze_atmega644_mode13_static-mode-without-extended-palette.lua
+++ b/src/hardware_data/graphics/uze_atmega644_mode13_static-mode-without-extended-palette.lua
@@ -1,6 +1,101 @@
 -- Information:                             --
 -- Video Mode 13 (official)                 --
 --                                          --
+-- Scroll Mode and Static Mode,             --
+-- can be changed by compilation.           --
+-- Default value is:                        --
+-- SCROLLING=0 (Static Mode)                --
+-- Available values are:                    --
+-- SCROLLING=0 (Static Mode)                --
+-- SCROLLING=1 (Scroll Mode)                --
+--                                          --
+-- Maximum sprites on screen and RAM tiles  --
+-- can be changed by compilation.           --
+-- In video mode 3, the maximum             --
+-- sprites on screen is 20, due of limit    --
+-- VRAM (4K) and CPU                        --
+-- In video mode 13, the maximum            --
+-- sprites on screen is more that 20, due   --
+-- of palette limitation.                   --
+-- Default value is:                        --
+-- RAM_TILE_COUNT=0                         --
+-- RAM_TILE_COUNT is needed to change to    --
+-- compile it.                              --
+-- MAX_SPRITES=32 (20)                      --
+-- MAX_RAMTILES=90                          --
+-- Available values are:                    --
+-- RAM_TILE_COUNT=1 to                      --
+-- RAM_TILE_COUNT=255                       --
+-- MAX_SPRITES=1 to MAX_SPRITES=20 or more, --
+-- but is not recomended, due of hardware   --
+-- limitation.                              --
+-- MAX_RAMTILES=90 (unchangeable)           --
+--                                          --
+-- Default palette (8 colours) and          --
+-- Extended palette (15 colours)            --
+-- can be changed by compilation.           --
+-- Default value is:                        --
+-- EXTENDED_PALETTE=0                       --
+-- Available value is:                      --
+-- EXTENDED_PALETTE=0                       --
+-- EXTENDED_PALETTE=1                       --
+--                                          --
+-- Horizontal tiles on screen and/or VRAM,  --
+-- can be changed by compilation,           --
+-- but is not recomended.                   --
+-- Default value is:                        --
+-- {SCREEN,VRAM}_TILES_H=30 if SCROLLING=0  --
+-- and SCREEN_TILES_H == VRAM_TILES_H       --
+-- SCREEN_TILES_H=28        if SCROLLING=1  --
+-- VRAM_TILES_H=32          if SCROLLING=1  --
+--                                          --
+-- Vertical tiles on screen and/or VRAM,    --
+-- can be changed by compilation,           --
+-- but is not recomended.                   --
+-- Default value is:                        --
+-- {SCREEN,VRAM}_TILES_V=28 if SCROLLING=0  --
+-- and SCREEN_TILES_V == VRAM_TILES_V       --
+-- SCREEN_TILES_V=28        if SCROLLING=1  --
+-- VRAM_TILES_V=32          if SCROLLING=1  --
+-- Available value is:                      --
+-- VRAM_TILES_V=32          if SCROLLING=1  --
+-- VRAM_TILES_V=24          if SCROLLING=1  --
+-- VRAM_TILES_V=16          if SCROLLING=1  --
+--                                          --
+-- Tile width size in pixels,               --
+-- can be changed by compilation,           --
+-- more that 224 pixels is not recommended. --
+-- Default value is:                        --
+-- TILE_WIDTH=8                             --
+-- Available value is:                      --
+-- TILE_WIDTH=1 to TILE_WIDTH=224 or more   --
+--                                          --
+-- Tile height size in pixels,              --
+-- can be changed by compilation,           --
+-- more that 224 pixels with scrolling or   --
+-- 240 pixels without scrolling is not      --
+-- recommended.                             --
+-- Default value is:                        --
+-- TILE_HEIGHT=8                            --
+-- Available value is:                      --
+-- TILE_HEIGHT=1 to TILE_HEIGHT=224 or more --
+--   if SCROLLING=1                         --
+-- TILE_HEIGHT=1 to TILE_HEIGHT=240 or more --
+--   if SCROLLING=0                         --
+--                                          --
+-- Numbers of video lines to render,        --
+-- can be changed by compilation,           --
+-- but is not recommended, changes the      --
+-- CPU cyles.                               --
+-- Default value is:                        --
+-- FRAME_LINES=SCREEN_TILES_V*TILE_HEIGHT   --
+--                                          --
+-- First render line is used to adjust      --
+-- vertical centering if the value          --
+-- FRAME_LINES is changed.                  --
+-- Can be changed by compilation.           --
+-- Default value is:                        --
+-- FIRST_RENDER_LINE=20                     --
 
 -- Sites:
 -- http://uzebox.org/wiki/index.php?title=Video_Modes
diff --git a/src/hardware_data/graphics/uze_atmega644_mode3_scroll-mode.lua b/src/hardware_data/graphics/uze_atmega644_mode3_scroll-mode.lua
index 17e8678..10ca98e 100644
--- a/src/hardware_data/graphics/uze_atmega644_mode3_scroll-mode.lua
+++ b/src/hardware_data/graphics/uze_atmega644_mode3_scroll-mode.lua
@@ -9,6 +9,25 @@
 -- SCROLLING=0 (Static Mode)                --
 -- SCROLLING=1 (Scroll Mode)                --
 --                                          --
+-- Maximum sprites on screen and RAM tiles  --
+-- can be changed by compilation.           --
+-- In video mode 3, the maximum             --
+-- sprites on screen is 20, due of limit    --
+-- VRAM (4K) and CPU                        --
+-- Default value is:                        --
+-- RAM_TILE_COUNT=0                         --
+-- RAM_TILE_COUNT is needed to change to    --
+-- compile it.                              --
+-- MAX_SPRITES=32 (20)                      --
+-- MAX_RAMTILES=60                          --
+-- Available values are:                    --
+-- RAM_TILE_COUNT=1 to                      --
+-- RAM_TILE_COUNT=255                       --
+-- MAX_SPRITES=1 to MAX_SPRITES=20 or more, --
+-- but is not recomended, due of hardware   --
+-- limitation.                              --
+-- MAX_RAMTILES=60 (unchangeable)           --
+--                                          --
 -- Horizontal tiles on screen and/or VRAM,  --
 -- can be changed by compilation,           --
 -- but is not recomended.                   --
diff --git a/src/hardware_data/graphics/uze_atmega644_mode3_static-mode.lua b/src/hardware_data/graphics/uze_atmega644_mode3_static-mode.lua
index 09acde8..9160dc5 100644
--- a/src/hardware_data/graphics/uze_atmega644_mode3_static-mode.lua
+++ b/src/hardware_data/graphics/uze_atmega644_mode3_static-mode.lua
@@ -9,6 +9,25 @@
 -- SCROLLING=0 (Static Mode)                --
 -- SCROLLING=1 (Scroll Mode)                --
 --                                          --
+-- Maximum sprites on screen and RAM tiles  --
+-- can be changed by compilation.           --
+-- In video mode 3, the maximum             --
+-- sprites on screen is 20, due of limit    --
+-- VRAM (4K) and CPU                        --
+-- Default value is:                        --
+-- RAM_TILE_COUNT=0                         --
+-- RAM_TILE_COUNT is needed to change to    --
+-- compile it.                              --
+-- MAX_SPRITES=32 (20)                      --
+-- MAX_RAMTILES=60                          --
+-- Available values are:                    --
+-- RAM_TILE_COUNT=1 to                      --
+-- RAM_TILE_COUNT=255                       --
+-- MAX_SPRITES=1 to MAX_SPRITES=20 or more, --
+-- but is not recomended, due of hardware   --
+-- limitation.                              --
+-- MAX_RAMTILES=60 (unchangeable)           --
+--                                          --
 -- Horizontal tiles on screen and/or VRAM,  --
 -- can be changed by compilation,           --
 -- but is not recomended.                   --