Tilemap

Author: risolvipro

Source/images/tile.pgm

@@ -22,6 +22,21 @@ function newWorld()
 
     world:setPlaneFillColor(mode7.color.grayscale.new(60, 255))
 
+    --[[
+    local tilemap = world:newTilemap(64, 64)
+
+    local tileBitmap = mode7.bitmap.loadPGM("images/tile.pgm")
+    tilemap:setBitmapAtRange(tileBitmap, 0, 0, -1, -1)
+    
+    local tileBitmap1 = mode7.bitmap.loadPGM("images/tile1.pgm")
+    tilemap:setBitmapAtPosition(tileBitmap1, 16, 3)
+    tilemap:setBitmapAtPosition(tileBitmap1, 16, 4)
+
+    tilemap:setFillBitmap(tileBitmap)
+
+    world:setPlaneTilemap(tilemap)
+    --]]
+
     local imageTable = mode7.imagetable.new("images/full-car")
 
     addCar(world, imageTable, 246, 1106, 1.5)

Source/images/tile1.pgm

@@ -89,6 +89,28 @@ function mode7.world:setCeilingFillColor(color)
     self:_setCeilingFillColor(color.gray, color.alpha)
 end
 
+--- Gets the color of the plane at the specified point.
+---
+--- https://risolvipro.github.io/playdate-mode7/Lua-API.html#def-world-planeColorAt
+---@param x number
+---@param y number
+---@return mode7.color
+function mode7.world:planeColorAt(x, y)
+    local gray, alpha = self:_planeColorAt(x, y)
+    return mode7.color.grayscale.new(gray, alpha)
+end
+
+--- Gets the color of the ceiling at the specified point.
+---
+--- https://risolvipro.github.io/playdate-mode7/Lua-API.html#def-world-ceilingColorAt
+---@param x number
+---@param y number
+---@return mode7.color
+function mode7.world:ceilingColorAt(x, y)
+    local gray, alpha = self:_ceilingColorAt(x, y)
+    return mode7.color.grayscale.new(gray, alpha)
+end
+
 -- Display
 
 mode7.display.kScale1x1 = 0

Source/main.lua

@@ -1 +1 @@
-1.4.1
+1.5.0

Source/mode7.lua

@@ -65,6 +65,9 @@ mode7.image = {}
 ---@class mode7.imagetable
 mode7.imagetable = {}
 
+---@class mode7.tilemap
+mode7.tilemap = {}
+
 ---@class mode7.array
 mode7.array = {}
 
@@ -96,6 +99,18 @@ function mode7.world:_setCeilingFillColor(gray, alpha) end
 ---@return integer alpha
 function mode7.world:_getCeilingFillColor() return 0, 0 end
 
+---@param x integer
+---@param y integer
+---@return integer gray
+---@return integer alpha
+function mode7.world:_planeColorAt(x, y) return 0, 0 end
+
+---@param x integer
+---@param y integer
+---@return integer gray
+---@return integer alpha
+function mode7.world:_ceilingColorAt(x, y) return 0, 0 end
+
 ---@param width integer
 ---@param height integer
 ---@param gray integer
@@ -172,6 +187,30 @@ function mode7.world:setCeilingBitmap(bitmap) end
 ---@return mode7.bitmap
 function mode7.world:getCeilingBitmap() return {} end
 
+--- Sets a tilemap for the plane.
+---
+--- https://risolvipro.github.io/playdate-mode7/Lua-API.html#def-world-setPlaneTilemap
+---@param tilemap mode7.tilemap
+function mode7.world:setPlaneTilemap(tilemap) end
+
+--- Gets the plane tilemap.
+---
+--- https://risolvipro.github.io/playdate-mode7/Lua-API.html#def-world-getPlaneTilemap
+---@return mode7.tilemap
+function mode7.world:getPlaneTilemap() return {} end
+
+--- Sets a tilemap for the ceiling.
+---
+--- https://risolvipro.github.io/playdate-mode7/Lua-API.html#def-world-setCeilingTilemap
+---@param tilemap mode7.tilemap
+function mode7.world:setCeilingTilemap(tilemap) end
+
+--- Gets the ceiling tilemap.
+---
+--- https://risolvipro.github.io/playdate-mode7/Lua-API.html#def-world-getCeilingTilemap
+---@return mode7.tilemap
+function mode7.world:getCeilingTilemap() return {} end
+
 --- Converts a world point to a display point. The z component of the returned value is 1 if the point is in front of the camera or -1 if the point is behind the camera.
 ---
 --- https://risolvipro.github.io/playdate-mode7/Lua-API.html#def-world-worldToDisplayPoint
@@ -484,6 +523,13 @@ function mode7.background:getCenter() return 0, 0 end
 ---@return mode7.bitmap
 function mode7.bitmap.loadPGM(path) return {} end
 
+--- Returns a copy of the bitmap. The mask, if it exists, is copied too.
+---
+--- https://risolvipro.github.io/playdate-mode7/Lua-API.html#def-bitmap-copy
+---@param bitmap mode7.bitmap
+---@return mode7.bitmap
+function mode7.bitmap:copy(bitmap) return {} end
+
 --- Gets the bitmap size.
 ---
 --- https://risolvipro.github.io/playdate-mode7/Lua-API.html#def-bitmap-getSize
@@ -683,6 +729,52 @@ function mode7.shader.radial:setInverted(inverted) end
 ---@return boolean
 function mode7.shader.radial:getInverted() return false end
 
+--- Creates new tilemap from world. tileWidth and tileHeight values must be a power of 2.
+---
+--- https://risolvipro.github.io/playdate-mode7/Lua-API.html#def-world-newTilemap
+---@param tileWidth number
+---@param tileHeight number
+---@return mode7.tilemap
+function mode7.world:newTilemap(tileWidth, tileHeight) return {} end
+
+--- Sets a bitmap at the specified position. Row and column start at 0.
+---
+--- https://risolvipro.github.io/playdate-mode7/Lua-API.html#def-tilemap-setBitmapAtPosition
+---@param bitmap mode7.bitmap
+---@param row number
+---@param column number
+function mode7.tilemap:setBitmapAtPosition(bitmap, row, column) end
+
+--- Sets a bitmap at the specified range (from start position to end position). Row and column start at 0, pass -1 as endRow or endColumn to express the highest row or column in the grid. For example, (0, 0, -1, -1) will set the bitmap to the entire grid.
+---
+--- https://risolvipro.github.io/playdate-mode7/Lua-API.html#def-tilemap-setBitmapAtRange
+---@param bitmap mode7.bitmap
+---@param startRow number
+---@param startColumn number
+---@param endRow number
+---@param endColumn number
+function mode7.tilemap:setBitmapAtRange(bitmap, startRow, startColumn, endRow, endColumn) end
+
+--- Gets the bitmap at the specified position.
+---
+--- https://risolvipro.github.io/playdate-mode7/Lua-API.html#def-tilemap-getBitmapAtPosition
+---@param row number
+---@param column number
+---@return mode7.bitmap
+function mode7.tilemap:getBitmapAtPosition(row, column) return {} end
+
+--- Sets a bitmap to be used for the out-of-bounds space.
+---
+--- https://risolvipro.github.io/playdate-mode7/Lua-API.html#def-tilemap-setFillBitmap
+---@param bitmap mode7.bitmap
+function mode7.tilemap:setFillBitmap(bitmap) end
+
+--- Gets a bitmap to be used for the out-of-bounds space.
+---
+--- https://risolvipro.github.io/playdate-mode7/Lua-API.html#def-tilemap-setFillBitmap
+---@return mode7.bitmap
+function mode7.tilemap:getFillBitmap() return {} end
+
 --- Resize the pool to the given size in bytes. We recommend to call this function only once.
 ---
 --- https://risolvipro.github.io/playdate-mode7/Lua-API.html#def-pool-realloc

VERSION.txt

@@ -27,6 +27,8 @@ static LCDBitmapTable *carTable;
 static PDMode7_Bitmap *bitmap;
 static PDMode7_Sprite *sprite;
 static LCDBitmap *backgroundImage;
+static PDMode7_Tilemap *tilemap;
+static PDMode7_Bitmap *tileBitmap;
 
 #ifdef _WINDLL
 __declspec(dllexport)
@@ -69,6 +71,21 @@ PDMode7_World *newWorld(void)
 
     world = mode7->world->newWorld(configuration);
 
+    /*
+    tilemap = mode7->world->newTilemap(world, 64, 64);
+    mode7->world->setPlaneTilemap(world, tilemap);
+    
+    tileBitmap = mode7->bitmap->loadPGM("images/tile.pgm");
+    mode7->tilemap->setBitmapAtRange(tilemap, tileBitmap, 0, 0, -1, -1);
+    
+    int *indexes = (int[2]){
+        16 * 32 + 3, 16 * 32 + 4
+    };
+    
+    PDMode7_Bitmap *tileBitmap1 = mode7->bitmap->loadPGM("images/tile1.pgm");
+    mode7->tilemap->setBitmapAtIndexes(tilemap, tileBitmap1, indexes, 2);
+     */
+    
     bitmap = mode7->bitmap->loadPGM("images/track-0.pgm");
     mode7->world->setPlaneBitmap(world, bitmap);
     mode7->world->setPlaneFillColor(world, mode7->color->newGrayscaleColor(60, 255));
@@ -130,7 +147,7 @@ static int update(void *userdata)
     PDMode7_Vec3 position = mode7->camera->getPosition(camera);
 
     float angleDelta = 1 * dt;
-
+    
     if(pressed & kButtonLeft)
     {
         angle -= angleDelta;
@@ -189,6 +206,14 @@ void restartWorld(void)
     {
         mode7->sprite->freeSprite(sprite);
     }
+    if(tilemap)
+    {
+        mode7->tilemap->freeTilemap(tilemap);
+    }
+    if(tileBitmap)
+    {
+        mode7->bitmap->freeBitmap(tileBitmap);
+    }
 
     playdate->graphics->freeBitmap(backgroundImage);
     mode7->bitmap->freeBitmap(bitmap);