Swift bindings to the Playdate C API

Wraps all ten subsystems of the Playdate SDK 3.1.1 C API (system, display, graphics, sprites, sound, file, JSON, Lua, scoreboards, network) in idiomatic Swift: namespaced APIs, wrapper types with ownership semantics, closures for callbacks, and typed throws. Written within the Embedded Swift subset so the same code can target the device. The SDK headers are resolved through a "playdate" pkg-config module (Scripts/install-pkgconfig.sh), so the package works as a normal SwiftPM dependency without unsafe build flags. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-24 10:33:45 +02:00
commit 09760f99b0
29 changed files with 6533 additions and 0 deletions
@@ -0,0 +1,79 @@
+//
+//  GraphicsTileMap.swift
+//  TileMap wrapper around LCDTileMap (playdate->graphics->tilemap).
+//
+
+internal import CPlaydate
+
+private var tilemapAPI: playdate_tilemap { gfx.tilemap.pointee }
+
+extension Playdate.Graphics {
+    /// A grid of tiles drawn from a bitmap table. Wraps `LCDTileMap`.
+    public final class TileMap {
+        let pointer: OpaquePointer
+        /// The image table is retained so the tilemap's tiles stay valid.
+        private var retainedImageTable: BitmapTable?
+
+        public init() {
+            pointer = tilemapAPI.newTilemap.unsafelyUnwrapped().unsafelyUnwrapped
+        }
+
+        deinit {
+            tilemapAPI.freeTilemap.unsafelyUnwrapped(pointer)
+        }
+
+        /// The bitmap table the tile indexes refer to.
+        public var imageTable: BitmapTable? {
+            get { retainedImageTable }
+            set {
+                retainedImageTable = newValue
+                tilemapAPI.setImageTable.unsafelyUnwrapped(pointer, newValue?.pointer)
+            }
+        }
+
+        /// Sets the tilemap's size in tiles.
+        public func setSize(tilesWide: Int, tilesHigh: Int) {
+            tilemapAPI.setSize.unsafelyUnwrapped(pointer, Int32(tilesWide), Int32(tilesHigh))
+        }
+
+        /// The tilemap's size in tiles.
+        public var size: (tilesWide: Int, tilesHigh: Int) {
+            var wide: Int32 = 0, high: Int32 = 0
+            tilemapAPI.getSize.unsafelyUnwrapped(pointer, &wide, &high)
+            return (Int(wide), Int(high))
+        }
+
+        /// The tilemap's total size in pixels.
+        public var pixelSize: (width: Int, height: Int) {
+            var width: UInt32 = 0, height: UInt32 = 0
+            tilemapAPI.getPixelSize.unsafelyUnwrapped(pointer, &width, &height)
+            return (Int(width), Int(height))
+        }
+
+        /// Fills the tilemap with `indexes`, `rowWidth` tiles per row. The
+        /// tilemap is resized to fit.
+        public func setTiles(_ indexes: [UInt16], rowWidth: Int) {
+            var indexes = indexes
+            indexes.withUnsafeMutableBufferPointer { buffer in
+                tilemapAPI.setTiles.unsafelyUnwrapped(pointer, buffer.baseAddress,
+                                                      Int32(buffer.count), Int32(rowWidth))
+            }
+        }
+
+        /// Sets the tile index at position (x, y).
+        public func setTile(x: Int, y: Int, index: UInt16) {
+            tilemapAPI.setTileAtPosition.unsafelyUnwrapped(pointer, Int32(x), Int32(y), index)
+        }
+
+        /// The tile index at position (x, y), or `nil` if out of bounds.
+        public func tile(x: Int, y: Int) -> Int? {
+            let index = tilemapAPI.getTileAtPosition.unsafelyUnwrapped(pointer, Int32(x), Int32(y))
+            return index < 0 ? nil : Int(index)
+        }
+
+        /// Draws the tilemap with its upper-left corner at (x, y).
+        public func draw(x: Float, y: Float) {
+            tilemapAPI.drawAtPoint.unsafelyUnwrapped(pointer, x, y)
+        }
+    }
+}