Overview
Saves an image to the library as a tagged map asset. Turn generated noise,
masks, and height maps into reusable assets that map_asset_load can retrieve.
This is the writing side of the asset library.
Usage tips
- Store frequently used base material. Saving a favorite noise pattern or gradient avoids rebuilding its generation chain in the next project.
- Saving is triggered explicitly with the Inspector's Save button, a safe design that avoids writing on every evaluation.
- Immediately after clicking Save, the Inspector reports that a save was requested.
It shows success only after the matching evaluation returns
_saved=true, or the NodeError when the save fails. - Tags and descriptions make the asset easier to find from
map_asset_load.
Related nodes
map_asset_load— the loading counterpartnoise_generate/region_height— common sources of assets to save
Saves the input image as a PNG below user_data/library/maps and stores tags,
descriptions, and other per-file metadata as xxx.map.json in the same folder.
Notes
Press the Save button in the Inspector when you want to save. To prevent
unintentional writes on every evaluation, saving runs only when the button advances
the internal trigger.
If an asset with the same asset_id already exists, choose whether to overwrite
it or save under another ID such as asset_id_2. Choosing another ID also updates
the Inspector's asset_id to the saved ID.
User-created assets are saved as two files: asset_id.png and
asset_id.map.json. Copy both files together to load the same asset with its
metadata in another environment without editing a manifest. Bundled presets and
official packs are expected to continue using manifest.json.
The sidecar stores value_type using the lowercase canonical values grayscale,
binary, stepped, or color. Display-style values in older graphs remain accepted
as compatibility aliases.