A changed preview does not prove that a transformed gamut mask will persist. Krita’s manual warns that changes made with the Transform Tool or a layer transform cannot be saved as gamut-mask shapes, even when the thumbnail reflects them. For a mask you can reload, edit its basic vector shapes directly, put them on maskShapesLayer, save, then reselect the resource and inspect the actual shape.
Choose an editing route and check the saved result
Use the Gamut Masks Docker when creating, editing, or duplicating a mask. The editor opens its template in a new view. The documentation says the mask is intended to use basic vector shapes and that its shapes must be on the layer named maskShapesLayer. That layer is selected by default. Shapes also need a solid background to display correctly in the editor, and a template with no shapes cannot be saved. See the Gamut Masks Docker reference.
Follow this sequence for a custom mask:
- In Settings > Dockers > Gamut Masks, choose Create new mask, or duplicate an existing mask if you want to retain its starting shapes. Create new mask opens an empty template, so add at least one shape to
maskShapesLayerbefore saving; a template with no shapes cannot be saved. The manual also describes opening a selected mask with Edit mask. - In the template view, select
maskShapesLayerand add or modify basic vector shapes with the standard vector tools. Confirm the shapes are on that layer; do not rely on the layer’s default selection remaining unchanged. - Enter the mandatory title. Add a description if useful. Use the color-selector preview to inspect the result, but treat it as a preview, not proof that a transform will be written into the mask shapes.
- If the change was made with the Transform Tool or a layer transform, replace it with direct editing of the basic shapes for the intended saved result. Save from the editor; choose Cancel only when you mean to close without saving.
- After saving, select the mask from the Docker again and inspect its shape. For this guide’s proposed check, compare the reselected shape with the intended edit, rather than judging success from the preview thumbnail alone.
Krita describes gamut masks as resources stored in .kgm files. The Docker reference says these ZIP files contain a MIME-type entry, a preview image, and an SVG describing the mask. The gamut-mask manual explains the preview and save controls, including why a thumbnail can appear changed while the individual mask shapes are not.
Save-and-reselect worksheet
The following observations are a hypothetical worksheet, not results from running Krita. Record what you did and what you see after reselecting the resource. “Basic shape” refers to the supported editing approach described in the manual; the table does not predict exact geometry or preview behavior.
| Checkpoint | Hypothetical record | Decision |
|---|---|---|
| Starting mask | One basic vector shape on maskShapesLayer | Record this as the comparison point. |
| Edit operation | Deliberate risk test, not recommended for the final saved mask: apply a transform operation to the shape. For the comparison, directly edit a basic shape with standard vector tools. | Mark the transform as a persistence risk; the manual warns that transform-tool and layer-transform results cannot be saved as mask shapes. |
| Preview | Thumbnail looks different from the starting state | Record the change, but do not treat it as evidence of saved geometry. |
| Save and reselect | After saving, select the resource again; inspect the shape itself | Pass only if the reselected shape has the intended edit. If not, return to direct shape editing. |
| Structure check | Grouping or vector text was used | Flag for review: the manual says these advanced features are not guaranteed to work properly. |
This record separates three observations that can otherwise be confused: the operation performed, what the preview showed, and what the resource displays after reselecting it. The last is the acceptance check proposed here.
Limits and what to do if it fails
Krita’s documentation does not guarantee that advanced vector structures such as grouping or vector text work correctly in gamut masks. If the saved result is missing or different and such structures were used, simplify the mask to basic vector shapes on maskShapesLayer, save, and reselect it to review again. This is a troubleshooting recommendation based on the documented constraints, not a promise that every simplified design will work.
If the shapes are missing, first confirm their layer and that the template contains shapes. If the only change was a transform operation, remake that edit directly on the basic shapes. If the editor preview is correct but the reselected mask differs, rely on the reselected mask for this review and record the discrepancy; the documentation establishes that thumbnail and mask shapes can differ after a transform. The manual does not specify a numeric tolerance or an automatic comparison method, so assess whether the saved shape matches your intended design visually.
Three quick questions
Can I rotate a mask without editing its saved shapes? The manual documents rotating an existing mask in the color selector with its rotation slider. That is distinct from saving a transformed shape as part of the mask resource.
Why can’t I save an empty template? The Docker reference says a template without shapes cannot be saved. Add a shape to maskShapesLayer before saving.
Can I use vector text or grouped shapes? The manual says those features are not guaranteed to work properly. For a mask that must be reliably reviewable after reselecting, use basic vector shapes instead.
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.