Skip to content

Commit

Permalink
Switch to typedoc
Browse files Browse the repository at this point in the history
  • Loading branch information
mikewesthad committed Jan 31, 2025
1 parent 34d0657 commit 0b40f1a
Show file tree
Hide file tree
Showing 8 changed files with 152 additions and 1,278 deletions.
5 changes: 0 additions & 5 deletions .esdoc.json

This file was deleted.

6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,9 @@

A CLI and JS library to extrude tiles in tilesets to avoid "bleeding" issues where tiles are rendered with the wrong color at the edges of tiles.

![demo](./doc-source/images/demo.png)
![demo](./images/demo.png)

![explanation](./doc-source/images/explanation.png)
![explanation](./images/explanation.png)

You can read more about the bleeding problem and solution [here](https://web.archive.org/web/20180411151113/http://rotorz.com/unity/tile-system/docs/edge-correction). The TLDR is that there are many ways this type of rendering artifact can occur, e.g. from pixels being incorrectly blended when the edge of a tile in a tilemap texture is rendered. This CLI app handles both tilesets with and without margin & spacing. Check out my [blog post series](https://medium.com/@michaelwesthadley/modular-game-worlds-in-phaser-3-tilemaps-1-958fc7e6bbd6) about building modular worlds with tilemaps for more information on using tilemaps and extruding tiles.

Expand Down Expand Up @@ -65,7 +65,7 @@ Options:

A note on terminology, _spacing_ is the number of pixels between neighboring tiles, while _margin_ is the number of pixels between the edges of the image and the tiles. Or, more visually explained:

![Margin and spacing](./doc-source/images/margin-and-spacing.png)
![Margin and spacing](./images/margin-and-spacing.png)

### Usage as a Library

Expand Down
File renamed without changes
File renamed without changes
File renamed without changes
12 changes: 5 additions & 7 deletions package.json
Original file line number Diff line number Diff line change
Expand Up @@ -10,10 +10,9 @@
"pretest": "pnpm run build",
"test": "ts-node ./tests/index.ts",
"demo": "http-server ./examples/phaser -c-1 -o",
"doc": "esdoc -c ./.esdoc.json",
"postdoc": "cp -r doc-source/ docs/",
"deploy:doc": "gh-pages --branch gh-pages --dist docs",
"predeploy:doc": "pnpm run doc",
"docs:build": "typedoc",
"docs:run": "pnpm run docs:build && http-server ./docs -c-1 -o",
"docs:deploy": "pnpm run docs:build && gh-pages --branch gh-pages --dist docs",
"prettier": "prettier --write \"./{src,tests}/**/*.{js,ts}\""
},
"repository": {
Expand Down Expand Up @@ -42,15 +41,14 @@
},
"devDependencies": {
"@types/node": "^22.12.0",
"esdoc": "^1.1.0",
"esdoc-node": "^1.0.5",
"esdoc-standard-plugin": "^1.0.0",
"gh-pages": "^6.3.0",
"http-server": "^14.1.1",
"imagemin": "^9.0.0",
"imagemin-pngquant": "^10.0.0",
"prettier": "^3.4.2",
"ts-node": "^10.9.2",
"typedoc": "^0.27.6",
"typedoc-material-theme": "^1.3.0",
"typescript": "^5.7.3"
}
}
1,401 changes: 138 additions & 1,263 deletions pnpm-lock.yaml

Large diffs are not rendered by default.

6 changes: 6 additions & 0 deletions typedoc.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
{
"tsconfig": "./tsconfig.json",
"readme": "./README.md",
"plugin": ["typedoc-material-theme"],
"themeColor": "#cb9820"
}

0 comments on commit 0b40f1a

Please sign in to comment.