Skip to content

KRasterSettings

Alfish edited this page Sep 9, 2025 · 15 revisions

User Preferences: KRaster Importer

To display the user preferences for this plugin in Unity, click on the Edit menu > Preferences... > KRaster Importer section.

You can hover the mouse on any field to show a tooltip with its explanation.

User Preferences: KRaster Importer

External Programs

There are 2 settings that control the external programs called to export files from the source images. These are disabled by default, and must only be enabled after you have the programs installed. You must locate the program's path. The arguments pattern or prefix and script folder must also be correct for the called program. Environment variables like $VAR (%VAR% on Windows) are resolved in the paths here. It's prudent to test the command on one file first before doing many importations in a large project.

  1. Krita Runner: for images and animations from KRA/KRZ files
  2. OpenRaster Converter: for images from ORA files

It's recommended that you install Krita and then enable the Krita Runner option above. This allows generating animation frames and dealing properly with HDR, non-sRGB color spaces and KRZ files. It also allows converting to formats other than PNG and using the manual image converter. On Linux, prefer your distro's installation of Krita (e.g. from sudo apt install krita on Ubuntu). You can also click "Use Flatpak Krita" if you installed the Flathub version, but this is less preferable. Snap and AppImage installations of Krita are not supported because the kritarunner command is not accessible in those.

If you get incorrect results in Krita files with non-paint layers (e.g. vector layers, fill layers, etc.), you can try enabling Show Export Dialog and see if that fixes it. If it's still incorrect, try exporting from Krita itself to see if it's a Krita bug. If what you need is just a PNG file, You can force internal mode in the inspector for the Source Image importer.

The default OpenRaster command uses LazPaint to export from ORA. However, enabling this option is not necessary, as Krita (which can also handle ORA files) is used as a fallback if Krita Runner is enabled. So you don't need to install a program like LazPaint, unless you don't have Krita installed and really want to convert ORA to a format other than PNG for some reason.

Since importation is synchronous, a timeout is used to kill the process if it takes too long to finish. This time is per file processed (and per frame when animated). If you have issues with slow conversions being interrupted too early, you may increase this value or use -1 to disable the timeout.

This External Program mode is not required if using only simple sRGB KRA/ORA to PNG conversions in static images.

Show in Preview

These preferences control what info is displayed in the preview area when inspecting source images. They don't affect importation.

Preview Filter

The resampling filter to use in previews. Filters are sorted by complexity, so you can try a simpler filter if you experience slowness.

CPU Processing (Slow)

Do not enable this unless GPU processing has issues for some reason. Parallel operations are much slower on the CPU. This option affects dilation and resampling filters, which can be applied during texture importation, thumbnails and in previews.


Clone this wiki locally