diff --git a/docs/modders/HD_Graphics.md b/docs/modders/HD_Graphics.md index 1704f599f..fc0f155e8 100644 --- a/docs/modders/HD_Graphics.md +++ b/docs/modders/HD_Graphics.md @@ -1,10 +1,10 @@ # HD Graphics -It's possible to provide alternative HD-Graphics within mods. They will be used if any upscaling filter is activated. +It's possible to provide alternative high-definition graphics within mods. They will be used if any upscaling filter is activated. ## Preconditions -It's still necessary to add 1x graphics as before. HD graphics are seperate from usual graphics. This allows to partitially use HD for a few graphics in mod. And avoid handling huge graphics if upscaling isn't enabled. +It's still necessary to add 1x standard definition graphics as before. HD graphics are seperate from usual graphics. This allows to partitially use HD for a few graphics in mod. And avoid handling huge graphics if upscaling isn't enabled. Currently following scaling factors are possible to use: 2x, 3x, 4x. You can also provide multiple of them (increases size of mod, but improves loading performance for player). It's recommend to provide 2x and 3x images. @@ -20,10 +20,15 @@ The sprites should have the same name and folder structure as in `sprites` and ` ### Shadows / Overlays -It's also possible (but not necessary) to add HD shadows: Just place a image next to the normal upscaled image with the suffix `-shadow`. E.g. `TestImage.png` and `TestImage-shadow.png`. +It's also possible (but not necessary) to add high-definition shadows: Just place a image next to the normal upscaled image with the suffix `-shadow`. E.g. `TestImage.png` and `TestImage-shadow.png`. +In future, such shadows will likely become required to correctly exclude shadow from effects such as Clone spell. + +Shadow images are used only for animations of following objects: +- All adventure map objects +- All creature animations in combat Same for overlays with `-overlay`. But overlays are **necessary** for some animation graphics. They will be colorized by VCMI. Currently needed for: -- flaggable adventure map objects (needs a transparent image with white flags on it) -- creature battle animations (needs a transparent image with white outline of creature for highlighting on mouse hover) +- Flaggable adventure map objects. Overlay must contain a transparent image with white flags on it and will be used to colorize flags to owning player +- Creature battle animations, idle and mouse hover group. Overlay must contain a transparent image with white outline of creature for highlighting on mouse hover)