DG FARM — IMAGES AND DECALS — 0.5.0 — FS22 PC / SINGLE PLAYER

WHAT IS NEW
Green DG Farm panel with logo and position, rotation and scale cards.
English and Brazilian Portuguese interface following the game language.
17 images: Raízen, fictional farm logos, safety signs, Diesel S10,
Brazilian flag and reflective stripe. Controls match the FS25 0.5.0 edition.

INSTALLATION
Back up your savegame and previous mod ZIP.
Replace FS22_DGFarmDecalStudio.zip in:
Documents\My Games\FarmingSimulator2022\mods
Keep this filename and only one installed copy. Do not extract in mods.
Restart FS22 and enable the mod in your savegame.

CONTROLS
Ctrl+F8: open/close. On foot, aim at a vehicle or implement within 15 meters.
Inside a vehicle, the normal game selection is respected.
The target stays locked until you close the panel.
Entering a vehicle closes on-foot editing.
While the panel is open:
F9: add (20 decals maximum per vehicle). F10: remove.
F7: next applied decal. F11: change artwork. F6: next adjustment.
On foot: mouse wheel adjusts; Shift + wheel for fine adjustment.
Inside a vehicle: Ctrl + wheel adjusts; Ctrl + Shift + wheel for fine adjustment.
PageUp/PageDown: keyboard alternative.

ADJUSTMENTS
X/Y/Z: position. RX/RY/RZ: rotation. Size: width in meters.
Ratio = width / height. 1 = square, 2 = rectangular, 4 = wide, 0.5 = vertical.
Component selects a physical part of an articulated vehicle.
Keep flat decals a few millimeters from the body. For the opposite side,
use negative X and Y rotation of -90 degrees.
Decals do not automatically conform to curved bodywork or animated doors.

SAVING AND UPGRADING
Save the game normally. Decals are stored with each vehicle in vehicles.xml.
Leaving without saving discards edits. The FS22 edition uses no sidecar file.
The tested FS22 loading and on-foot selection routines are preserved.
The catalog contains the same 17 images as the current FS25 package.
Saved position, rotation, size and ratio are preserved.
Images are identified by filename: keep matching filenames to restore artwork.
Copy personal image files and catalog entries from your previous ZIP.
Vehicle mod source files are never rewritten.

CUSTOM IMAGES
Put PNG, DDS or JPG in imagens/ and add inside catalogo.xml's <imagens>:
<imagem arquivo="my_logo.png" nome="My logo" largura="512" altura="512"/>
Do not put entries inside comments. Restart the game after changes.
Alternatively use imagem01.png through imagem20.png (also .dds/.jpg);
numbered files default to a 2:1 ratio. Transparent PNG is suitable for logos.
When repacking, modDesc.xml must remain at the ZIP root.
Safety signs are visual examples for in-game use.

VALIDATION AND SUPPORT
PC and single player only. Hotkeys can conflict with other mods.
Lua, XML, assets and ZIP checked outside the game. Controls and persistence
exercised using simulated functions. FS22 0.4.0.2 was tested by the user;
0.5.0 still requires in-game validation. Test editing on foot and inside a
vehicle, F11, fine adjustment, saving/reloading and deletion.
Send screenshots, vehicle model and:
Documents\My Games\FarmingSimulator2022\log.txt
Log prefix: [DGFarmDecalStudio].

CREATOR: DG Farm
