docs: CR-6 — README um echte v0.2-Flags ergaenzt (--pad-px/--schema/--verbose/--tile-size auto)
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
27
README.md
27
README.md
@@ -2,6 +2,11 @@
|
|||||||
|
|
||||||
Builds paired diffuse + height PNG atlases for the Sporel map-lib v0.3.0+ format.
|
Builds paired diffuse + height PNG atlases for the Sporel map-lib v0.3.0+ format.
|
||||||
|
|
||||||
|
**v0.2.0** adds edge-replicated padding (Rev 4 §13.3), `--schema blob-14` slot
|
||||||
|
validation (E1), a `collision.json` sidecar (E2 validation + pass-through), and
|
||||||
|
alpha-analysis that sets a per-tile `tile.opaque` flag. Source tiles may be
|
||||||
|
PNG, WebP, or JPG (decoded via jimp).
|
||||||
|
|
||||||
## Usage
|
## Usage
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
@@ -9,12 +14,30 @@ sporel-atlas-baker \
|
|||||||
--in <source-dir> \
|
--in <source-dir> \
|
||||||
--out <atlas-dir> \
|
--out <atlas-dir> \
|
||||||
--atlas-id <stable-id> \
|
--atlas-id <stable-id> \
|
||||||
[--tile-size 64] \
|
[--tile-size 64 | auto] \
|
||||||
[--max-size 4096] \
|
[--max-size 4096] \
|
||||||
|
[--pad-px <N>] \
|
||||||
|
[--schema blob-14] \
|
||||||
[--lock <existing-lock.json>] \
|
[--lock <existing-lock.json>] \
|
||||||
[--blocks-sight-pattern <regex>]
|
[--blocks-sight-pattern <regex>] \
|
||||||
|
[--verbose]
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### Flags
|
||||||
|
|
||||||
|
| Flag | Meaning |
|
||||||
|
| --- | --- |
|
||||||
|
| `--in <source-dir>` | Directory of source tile images. |
|
||||||
|
| `--out <atlas-dir>` | Output directory for the baked atlas + sidecars. |
|
||||||
|
| `--atlas-id <stable-id>` | Stable atlas identifier written into the lock. |
|
||||||
|
| `--tile-size <N\|auto>` | Tile edge length in pixels, or `auto` to infer it from the source tiles. |
|
||||||
|
| `--max-size <N>` | Maximum atlas dimension in pixels (default 4096). |
|
||||||
|
| `--pad-px <N>` | Edge-replicated padding (gutter) applied around each tile, in pixels (Rev 4 §13.3). |
|
||||||
|
| `--schema <blob-14>` | Slot-validation schema for the source set. `blob-14` is the v0.2 14-slot blob schema (E1); required by lib-core.maps v0.5.1. |
|
||||||
|
| `--lock <existing-lock.json>` | Reuse an existing lock to keep tile indices stable. |
|
||||||
|
| `--blocks-sight-pattern <regex>` | Regex matching tile names that block line of sight. |
|
||||||
|
| `--verbose` | Print detailed per-tile diagnostics. |
|
||||||
|
|
||||||
See `sporel-meta/docs/superpowers/specs/2026-05-21-map-multi-layer-design.md` §4 for the format spec.
|
See `sporel-meta/docs/superpowers/specs/2026-05-21-map-multi-layer-design.md` §4 for the format spec.
|
||||||
|
|
||||||
## Development
|
## Development
|
||||||
|
|||||||
Reference in New Issue
Block a user