Changes

| ''(optional)'' How the image should be patched. The possible values...

| ''(optional)'' How the image should be patched. The possible values...

* <samp>PatchMode.Replace</samp> (default): erase the original content within the area before pasting in the new content;

* <samp>PatchMode.Replace</samp> (default): erase the original content within the area before pasting in the new content;

* <samp>PatchMode.Overlay</samp>: draw the new content over the original content, so the original content shows through any ''fully'' transparent pixels.

* <samp>PatchMode.Overlay</samp>: draw the new content over the original content, so the original content shows through transparent or semi-transparent pixels.

|}

|}

:; ExtendImage

:; ExtendImage

:: Extend the image if needed to fit the given size. Note that '''this is an expensive operation''', creates a new texture instance, and extending a spritesheet horizontally may cause game errors or bugs. For example:

:: Extend the image if needed to fit the given size. Note that '''resizing the image is an expensive operation''', creates a new texture instance, and extending a spritesheet horizontally may cause game errors or bugs. For example:

:: <syntaxhighlight lang="C#">

:: <syntaxhighlight lang="C#">

===Cache invalidation===

===Cache invalidation===

You can reload an asset by invalidating it from the cache. It will be reloaded next time the game requests it (and mods will have another chance to intercept it), and SMAPI will automatically update references to the asset in many cases. For example, this lets you change what clothes an NPC is wearing (by invalidating their cached sprites or portraits).

You can reload an asset by invalidating it from the cache. It will be reloaded next time the game requests it (and mods will have another chance to intercept it), and SMAPI will automatically update references to the asset in many cases. For example, this lets you change what clothes an NPC is wearing (by invalidating their cached sprites or portraits).

Please be aware that in some cases a localized version of the asset will be cached and simply invalidating the default asset will not work for any language other than english.

Please be aware that in some cases a localized version of the asset will be cached and simply invalidating the default asset will not work for any language other than english.