If the external artwork must keep its stored pixel dimensions, choose No Scaling. If it must occupy the canvas boundaries, choose Scale to Image Size. If the source and destination represent the same physical format at different resolutions, choose Adapt to image resolution. The filter is a separate decision: Krita’s manual describes Bicubic as a usual starting point and Nearest Neighbour as more suitable for pixel art because it does not blend colors. These choices map an existing file into a File Layer; they do not create missing source detail. See the Krita File Layers manual.
Make the Decision
Start by recording four facts: the source width and height in pixels, the canvas width and height in pixels, the source resolution, and the canvas resolution. Then use this sequence:
- Choose
No Scalingwhen pixel coordinates are the priority. This is appropriate when a sprite sheet, pixel-art tile, or precisely measured raster element must enter at its full pixel size. Do not expect it to fill the canvas. - Choose
Scale to Image Sizewhen the practical requirement is to fit the layer exactly within the canvas boundaries. Treat this as a layout decision, not proof that the source and canvas have matching detail. - Choose
Adapt to image resolutionwhen the source and canvas describe corresponding physical formats but use different resolution values. The manual’s example is a 600 dpi A4 image placed into a 300 dpi A4 image, where the File Layer is scaled to fit the 300 dpi image. A changed resolution interpretation does not, by itself, add recorded detail. - Select the filter after deciding the mapping. For ordinary illustrations, begin with
Bicubicas the documented general-purpose choice. For hard-edged pixel art, tryNearest Neighbourso adjacent colors are not mixed by the scaling process. - Inspect the result at the final placement: position, overall proportion, and edge structure. If the result is wrong, change the mapping choice or filter on a copy rather than treating a blurry edge as a resolution-label problem.
A Verification Worksheet
The following is a proposed acceptance worksheet, not a report of an executed test. It uses hypothetical values to separate resolution mapping from filter behavior.
| Hypothetical input or observation | Decision or follow-up |
|---|---|
| Canvas: 300 dpi; external A4 page: 600 dpi; both are treated as the same physical page | Compare Adapt to image resolution first; record the resulting placement and do not infer a guaranteed pixel-count algorithm beyond the documented behavior |
| External artwork: 2400 × 1600 px; canvas: 4000 × 3000 px; pixel coordinates must remain exact | Use No Scaling; verify that the layer retains its full pixel-size relationship and position it deliberately |
| Same source must cover the canvas boundaries | Compare Scale to Image Size; inspect whether the composition is proportionally acceptable at the canvas edges |
| A hypothetical 1-pixel black line beside a white area | Compare Nearest Neighbour with Bicubic; record whether the boundary remains discrete or develops blended transition pixels |
| Ordinary painted edge appears softer after fitting | Keep the source unchanged, compare the filter at the same placement, and decide whether the softness is acceptable rather than claiming detail was recovered |
This worksheet tests an author’s acceptance criteria. The manual defines the three options and filter guidance, but it does not promise a particular numeric result for every file, format, or transformation.
Limits and Next Steps
A File Layer references an external file. The original must remain available, and moving the .kra without the referenced file can break the relationship because Krita stores a relative path. If the reference cannot be found, Krita may ask for its location. A File Layer also cannot currently be painted on directly; a transformation mask is needed for transforming it. These are separate from scaling selection. The official documentation also states that File Layers cannot display animations, so an animated source is not a reason to choose one scaling mode over another.
If the imported result fails, first identify the failure type: wrong physical mapping, unwanted canvas fit, or blended edge pixels. Reopen the File Layer properties and change only the relevant option on a working copy. For a hard-edged asset, inspect a pixel-level crop; for an illustration, judge the final composition and contour quality. Keep the source file available while iterating, because changing the filter cannot restore information absent from that source.
Three Short Questions
Does `Adapt to image resolution` make a low-resolution image more detailed?
No. It changes how the layer is scaled between differing resolution settings. It should not be described as recovering texture or inventing factual detail.
Should every illustration use Bicubic?
No. The manual presents Bicubic as a usual choice, while specifically identifying Nearest Neighbour as more useful for pixel art. The artwork’s edge structure should decide.
Why does `No Scaling` not fill my canvas?
Its purpose is to import the File Layer at full pixel-size. Filling the canvas is a different requirement and points to Scale to Image Size or, where the resolution relationship is the deciding factor, Adapt to image resolution.
Sources and next step
This guide interprets public documentation and uses explicitly hypothetical acceptance examples, not application tests. Controls and availability can change; verify the cited manual against your installed version.
For work created in Imagild, carry the input requirements and acceptance checklist into the photo editor. The external software controls discussed above belong to their respective products.