KRasterSettings
To display the user preferences for this plugin in Unity, click on the Edit menu > Preferences... > KRaster Importer section (or KRaster Previewer in the free demo).
🔒 Most features here are not available in the free demo. You can upgrade to unlock all features.
You can hover the mouse on any field to show a tooltip with its explanation.
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, and paths starting with ~/ are relative to the user's home folder (even on Windows). It's prudent to test the command on one file first before doing many importations in a large project.
- Krita Runner: for images and animations from KRA/KRZ files
- 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.
Option to choose the file type icon or a miniature of the image as the asset's icon. When importing a Source Image asset with this toggle enabled, it will render a small version of the image itself to use as its icon. If disabled, it will use the generic icon for the file type. By default, it's disabled so you can easily distinguish a Source Image asset from its corresponding Texture asset when you generate a file next to it.
Changing this option will not affect already imported assets until they're reimported. You can search for t:SourceImage in the Project view to find all assets to reimport.
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.
🔒 In the free demo, only 2 filters are available (Point and Linear), and as a simpler implementation which doesn't fix outline artifacts on images with transparency. You can upgrade to unlock the improved filters.
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.