Skip to content

Search

Back
· 1 min read

Async import of assets

Assets import off the main thread, reload when saved, keep stable id:// references, and read import settings from a sidecar.

Importing an asset runs on its own thread, so the editor keeps drawing.

The editor importing two files at once, one finished and one part way through

  • A saved texture, model, font or sound reloads, and every node built from it is rebuilt.
  • An id:// reference survives a move, and a rename in the Assets dock rewrites every reference to the file.
  • art/hero.png.import.toml holds one image's import settings, and [import.texture] in project.toml is the default.
  • filter = "nearest" draws pixel art crisp.

The same 32-pixel sprite at ten times its size, filtered linearly and with nearest

The Import tab showing filter and srgb for a selected picture

Asset imports · Import settings