@canvasengine/tilemap

中文文档
5.0.2发布于 2026/10/18MITTypeScriptESM + CJS零依赖近 30 天下载 2938

A low-level, optimized rectangular tilemap implementation for PixiJS (CanvasEngine fork of pixijs/tilemap).

原始使用文档
文档目录8 节
  1. Version Compatiblity
  2. Installation :package:
  3. Usage
  4. Demos
  5. Settings
  6. RPGMaker
  7. RPGMaker Demo
  8. More Tutorials

@canvasengine/tilemap - Canvas Engine Tilemap Kit

Automation CI

Just forked from pixijs/tilemap (fix for latest pixijs)

This package provides a low-level rectangular tilemap implementation, optimized for high performance rendering and a out-of-the-box canvas fallback.

Version Compatiblity

PixiJSPixiJS Tilemap Kit
v4.xv1.x
v5.xv2.x
v6.xv3.x
v7.xv4.x
v8.xv5.x

Installation :package:

npm install --save @canvasengine/tilemap

You can also use the browser bundle:

<script src="https://cdn.jsdelivr.net/npm/@pixi/tilemap@latest/dist/pixi-tilemap.js"></script>

Usage

In short, the tilemap you create will render each tile texture at the provided position and dimensions. Generally, a spritesheet is used to load the tileset assets:

import { Assets } from 'pixi.js';
import { CompositeTilemap } from '@canvasengine/tilemap';

Assets.add('atlas', 'atlas.json');
Assets.load(['atlas']).then(() =>
{
    const tilemap = new CompositeTilemap();

    // Render your first tile at (0, 0)!
    tilemap.tile('grass.png', 0, 0);
});

CompositeTilemap is actually a lazy composite of layered Tilemap instances. A Tilemap has a fixed number of tile textures (the tileset) it can render in one go. Usually, CompositeTilemap abstracts away this limitation in a robust enough manner.

Demos

Settings

import { settings } from '@pixi/tilemap';
SettingDescription
TEXTURES_PER_TILEMAPTemporarily switched off
TEXTILE_UNITSTemporarily switched off
use32bitIndexThere's also a limitation on 16k tiles per one tilemap. If you want to lift it, please use PixiJS v5.1.0 and following setting settings.use32bitIndex = true;

RPGMaker

Canvas fallback is 5x slower than vanilla rpgmaker. WebGL version is faster and doesnt use extra textures.

RPGMaker Demo

More Tutorials

版本与发布记录

@canvasengine/tilemap 共发布 2 个版本,首次发布于 2025/06/06;过去 12 个月发布了 1 个版本。

版本发布日期距今
5.0.2latest2026/10/1821 天前
5.0.12025/06/061.4 年前

关于 @canvasengine/tilemap 的常见问题

@canvasengine/tilemap 是什么?

A low-level, optimized rectangular tilemap implementation for PixiJS (CanvasEngine fork of pixijs/tilemap).

如何安装 @canvasengine/tilemap?

在项目目录运行 npm install @canvasengine/tilemap,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:pixi.js(>=8.5.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@canvasengine/tilemap 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@canvasengine/tilemap 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@canvasengine/tilemap 可以商用吗?

@canvasengine/tilemap 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@canvasengine/tilemap 的下载量有多少?

根据 npm 官方下载统计,@canvasengine/tilemap 在 2026/10/09 – 2026/11/07 这 30 天内被下载 2,938 次,日均约 98 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@canvasengine/tilemap 还在维护吗?

最新版本 5.0.2 发布于 2026/10/18(21 天前);至今共发布 2 个版本,其中过去 12 个月发布了 1 个;首次发布于 2025/06/06。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。