Skip to content

KRasterSettings

Alfish edited this page Sep 24, 2022 · 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.

External Programs

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 user has the programs installed. The user should verify that the program's PATH is accessible, so that the command works, or set it up appropriately. It can also be prudent to test the command on one file first before doing many importations in a large project.

  1. OpenRaster Converter: for images from ORA files
  2. Krita Image Converter: for images from KRA/KRZ files
  3. 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 and linear images, animations and KRZ files, as well as converting to formats other than PNG.

The Krita command from the 2nd option can also be used on 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 to the output path. Krita appends a numeric suffix to the filename to differentiate frames.

You should not enable the force option, as it will cause worse performance when importing many files at once. Leave it disabled so that the command is only called when necessary. If you feel like you need to enable it for a specific image (if its internal PNG data happens to be wrong), remember to disable it again after reimporting.

Since importation is synchronous, the 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.

Show in Preview

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


Clone this wiki locally