KRasterSettings
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.
These preferences control what info is displayed in the preview area when inspecting source images. They don't affect importation.
The resampling filter to use in previews. Filters are sorted by complexity, so you can try a simpler filter if you experience slowness.
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.
This mode is not required if using only simple sRGB KRA/ORA to PNG conversions.
There are 3 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 the you have the programs installed. You must locate the program's path. The arguments pattern must also be correct for the called program.
It's prudent to test the command on one file first before doing many importations in a large project.
- OpenRaster Converter: for images from ORA files
- Krita Image Converter: for images from KRA/KRZ files
- Krita Animation Exporter: for animations from KRA/KRZ files
It's recommended that the user installs Krita and enable the 2nd and 3rd options above. This allows dealing properly with HDR, non-sRGB color spaces, animations and KRZ files. It also allows converting to formats other than PNG and using the manual image converter.
The Krita command from the 2nd option can also be copied to the 1st option, for ORA files. The default command uses LazPaint to export from ORA. However, enabling the 1st option should not be necessary at all, unless you really want to convert ORA to a format other than PNG for some reason.
The command included for the animation exporter will use Krita to generate each frame separately at the output path. Krita appends a numeric suffix to the filename to differentiate frames.
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. If you have issues with slow conversions being interrupted too early, you may increase this value or use -1 to disable the timeout.
⚠️ Important
: Due to a bug in Krita (still not fixed as of v5.2.11), if Krita was already running when called to do the conversion, it will hang forever. This can cause Unity to freeze during asset (re)importation, until you close Krita or the timeout is reached. To workaround this, set up a second Krita installation, separate from what you normally use. For example: on Linux, set up both a Flatpak and a non-Flatpak installation and use one to work and the other for the plugin; on Windows, set up a portable installation for the plugin.