diff --git a/assets/branding/boot_splash.png b/assets/branding/boot_splash.png new file mode 100644 index 0000000..73bae8f Binary files /dev/null and b/assets/branding/boot_splash.png differ diff --git a/assets/branding/boot_splash.png.import b/assets/branding/boot_splash.png.import new file mode 100644 index 0000000..4700985 --- /dev/null +++ b/assets/branding/boot_splash.png.import @@ -0,0 +1,40 @@ +[remap] + +importer="texture" +type="CompressedTexture2D" +uid="uid://d0modgi3t42ij" +path="res://.godot/imported/boot_splash.png-72bba54fc454f72a9370bfb743edf121.ctex" +metadata={ +"vram_texture": false +} + +[deps] + +source_file="res://assets/branding/boot_splash.png" +dest_files=["res://.godot/imported/boot_splash.png-72bba54fc454f72a9370bfb743edf121.ctex"] + +[params] + +compress/mode=0 +compress/high_quality=false +compress/lossy_quality=0.7 +compress/uastc_level=0 +compress/rdo_quality_loss=0.0 +compress/hdr_compression=1 +compress/normal_map=0 +compress/channel_pack=0 +mipmaps/generate=false +mipmaps/limit=-1 +roughness/mode=0 +roughness/src_normal="" +process/channel_remap/red=0 +process/channel_remap/green=1 +process/channel_remap/blue=2 +process/channel_remap/alpha=3 +process/fix_alpha_border=true +process/premult_alpha=false +process/normal_map_invert_y=false +process/hdr_as_srgb=false +process/hdr_clamp_exposure=false +process/size_limit=0 +detect_3d/compress_to=1 diff --git a/docs/BRANDING.md b/docs/BRANDING.md new file mode 100644 index 0000000..a2d23ce --- /dev/null +++ b/docs/BRANDING.md @@ -0,0 +1,81 @@ +# Loading screen branding + +The stock Godot boot splash (logo plus "GODOT Game engine") is replaced by the +"Mat Games" mascot on a black background. This applies to both surfaces: + +- the browser loading screen: the exported `index.png` referenced by + `` in the HTML shell, drawn over `#status`; +- native startup: `application/boot_splash/image` in `project.godot`. + +## Asset + +`assets/branding/boot_splash.png`, 1024x1218, palette PNG with alpha +(256 colors, 95 alpha levels), about 150 KB. Subject: cartoon zombie head and bust, +unsettling grin, thumbs up, with "Mat Games" below in a phosphor-terminal typeface. + +Provenance is recorded in `tools/branding/manifest.json`: + +- mascot: generated with `agy_generate` (Antigravity direct API, model + `gemini-3.1-flash-image`) on 2026-10-11 from no third-party source material; the + provider terms do not claim ownership of the output. Raw source kept at + `tools/branding/raw/` with its SHA256. Note that an image generator does not emit + real alpha, so the flat magenta background is keyed out locally; +- lettering: drawn by script, not by the generator, because generated text is + unreliable. Font `tools/branding/fonts/VT323-Regular.ttf`, glyphs of the DEC VT320 + terminal, licensed **SIL Open Font License 1.1** (license text kept next to it in + `OFL.txt`, downloaded from the `google/fonts` repository). OFL permits embedding + and redistribution, including commercially, as long as the font is not sold on its + own. SHA256 `cf4de751ada78ceac033dbe16a687742939995b77bc2a052ae17a4957958594d`. + +Only the final PNG lives under `assets/`, so the raw source and the font are not +packed into the export (`tools/*` is already excluded by the export preset). + +## Composition and keying + +`tools/make_boot_splash.py`: + +1. measures the background color from the four corners (here 250,4,247); +2. builds an anti-aliased mask by distance from that color (transparent below 55, + opaque above 130) and runs a small median filter; +3. removes magenta spill by subtracting `min(r, b) - g`, which does not harm the + pink tongue or the blue shirt because their red and blue are not both above green; +4. crops to the subject, applies a 50 px fade at the bottom to soften the frame cut + of the generated bust, and scales to 1024 px wide with 40 px side padding; +5. draws the title with VT323 in amber over a blurred glow layer; +6. quantizes to 256 colors (no dither) and writes the PNG plus the manifest. + +```sh +python3 tools/make_boot_splash.py tools/branding/raw/agy_generate_20261010234423_0.jpg +``` + +`--colors 0` keeps 32-bit RGBA if a future artwork needs smoother gradients. + +## Godot settings + +```ini +boot_splash/bg_color=Color(0, 0, 0, 1) +boot_splash/image="res://assets/branding/boot_splash.png" +boot_splash/show_image=true +boot_splash/use_filter=true +``` + +The default stretch behavior is kept, so the image is scaled preserving its aspect +ratio; the exported shell confirms the result with the classes +`show-image--true fullsize--true use-filter--true` and `#status` background +`#000000`. + +## Verification + +- Exported `index.png` has the same 1024x1218 dimensions as the master. It is + re-encoded by the exporter to 32-bit RGBA (about 475 KB), so the bytes are not + identical; composited on black the two images differ by at most 6.4/255 on + 0.14% of pixels, all with alpha below 20, i.e. invisible. The release keeps the + 150 KB master in the repository and ships a gzip sidecar. +- The exported shell contains no "Game engine" text and the splash image has an + empty `alt`. +- `html/export_icon=false`, so no favicon is exported: the browser tab still shows + a default icon. Using the mascot as favicon is a possible follow-up. +- On a phone in landscape the splash is scaled to fit the height, so the mascot + appears fairly small; a landscape variant (mascot beside the title) would fill + more of the screen if that is wanted. +- All eleven test suites still pass; this change touches no gameplay code. diff --git a/docs/WEB-DEPLOY.md b/docs/WEB-DEPLOY.md index 73d6aaf..ddcf61f 100644 --- a/docs/WEB-DEPLOY.md +++ b/docs/WEB-DEPLOY.md @@ -1,5 +1,17 @@ # Web build and compressed deployment +## Loading screen branding release: 097e6c64b42640ad + +See `docs/BRANDING.md`: black boot splash background and the "Mat Games" mascot in +place of the Godot logo; the browser progress bar is restyled to a thin amber line at +the bottom so it no longer crosses the artwork. PCK 4,330,608 bytes; gzip payload total +12,778,745 bytes. A first attempt without the bar fix was deployed as ddba14dd80539f19 +and superseded minutes later; both deploys reused the backup name +`index-before-loading.html`, so that file now holds the ddba14dd80539f19 shell. +Releases on the bastion: 9a376a3dbf674069, 7ebf03fe3c88be15, ddba14dd80539f19, 097e6c64b42640ad +(retention policy keeps the live one plus the previous one). + + ## Aligned office surfaces release: 9a376a3dbf674069 See `docs/OFFICE-SURFACES.md`: original FIFTIES_WALL14U and FIFTIES_CEIL5; diff --git a/export_presets.cfg b/export_presets.cfg index 864c14c..ce67398 100644 --- a/export_presets.cfg +++ b/export_presets.cfg @@ -23,7 +23,7 @@ vram_texture_compression/for_desktop=true vram_texture_compression/for_mobile=true html/export_icon=false html/custom_html_shell="" -html/head_include="" +html/head_include="" html/canvas_resize_policy=2 html/focus_canvas_on_start=true progressive_web_app/enabled=false diff --git a/project.godot b/project.godot index 9b9f848..bcfce06 100644 --- a/project.godot +++ b/project.godot @@ -15,6 +15,14 @@ config/description="FPS survival: zombie di Half-Life in una stanza con finestre run/main_scene="res://scenes/main.tscn" config/features=PackedStringArray("4.7", "Forward Plus") +; Schermata di caricamento: sfondo nero e mascotte "Mat Games" al posto del +; logo Godot, sia nell'HTML shell del browser sia all'avvio nativo. L'immagine +; si adatta conservando le proporzioni (comportamento predefinito). +boot_splash/bg_color=Color(0, 0, 0, 1) +boot_splash/image="res://assets/branding/boot_splash.png" +boot_splash/show_image=true +boot_splash/use_filter=true + [animation] compatibility/default_parent_skeleton_in_mesh_instance_3d=true diff --git a/tools/branding/fonts/OFL.txt b/tools/branding/fonts/OFL.txt new file mode 100644 index 0000000..bcb092f --- /dev/null +++ b/tools/branding/fonts/OFL.txt @@ -0,0 +1,93 @@ +Copyright 2011, The VT323 Project Authors (peter.hull@oikoi.com) + +This Font Software is licensed under the SIL Open Font License, Version 1.1. +This license is copied below, and is also available with a FAQ at: +http://scripts.sil.org/OFL + + +----------------------------------------------------------- +SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007 +----------------------------------------------------------- + +PREAMBLE +The goals of the Open Font License (OFL) are to stimulate worldwide +development of collaborative font projects, to support the font creation +efforts of academic and linguistic communities, and to provide a free and +open framework in which fonts may be shared and improved in partnership +with others. + +The OFL allows the licensed fonts to be used, studied, modified and +redistributed freely as long as they are not sold by themselves. The +fonts, including any derivative works, can be bundled, embedded, +redistributed and/or sold with any software provided that any reserved +names are not used by derivative works. The fonts and derivatives, +however, cannot be released under any other type of license. The +requirement for fonts to remain under this license does not apply +to any document created using the fonts or their derivatives. + +DEFINITIONS +"Font Software" refers to the set of files released by the Copyright +Holder(s) under this license and clearly marked as such. This may +include source files, build scripts and documentation. + +"Reserved Font Name" refers to any names specified as such after the +copyright statement(s). + +"Original Version" refers to the collection of Font Software components as +distributed by the Copyright Holder(s). + +"Modified Version" refers to any derivative made by adding to, deleting, +or substituting -- in part or in whole -- any of the components of the +Original Version, by changing formats or by porting the Font Software to a +new environment. + +"Author" refers to any designer, engineer, programmer, technical +writer or other person who contributed to the Font Software. + +PERMISSION & CONDITIONS +Permission is hereby granted, free of charge, to any person obtaining +a copy of the Font Software, to use, study, copy, merge, embed, modify, +redistribute, and sell modified and unmodified copies of the Font +Software, subject to the following conditions: + +1) Neither the Font Software nor any of its individual components, +in Original or Modified Versions, may be sold by itself. + +2) Original or Modified Versions of the Font Software may be bundled, +redistributed and/or sold with any software, provided that each copy +contains the above copyright notice and this license. These can be +included either as stand-alone text files, human-readable headers or +in the appropriate machine-readable metadata fields within text or +binary files as long as those fields can be easily viewed by the user. + +3) No Modified Version of the Font Software may use the Reserved Font +Name(s) unless explicit written permission is granted by the corresponding +Copyright Holder. This restriction only applies to the primary font name as +presented to the users. + +4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font +Software shall not be used to promote, endorse or advertise any +Modified Version, except to acknowledge the contribution(s) of the +Copyright Holder(s) and the Author(s) or with their explicit written +permission. + +5) The Font Software, modified or unmodified, in part or in whole, +must be distributed entirely under this license, and must not be +distributed under any other license. The requirement for fonts to +remain under this license does not apply to any document created +using the Font Software. + +TERMINATION +This license becomes null and void if any of the above conditions are +not met. + +DISCLAIMER +THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT +OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE +COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, +INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL +DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM +OTHER DEALINGS IN THE FONT SOFTWARE. diff --git a/tools/branding/fonts/VT323-Regular.ttf b/tools/branding/fonts/VT323-Regular.ttf new file mode 100644 index 0000000..afa6909 Binary files /dev/null and b/tools/branding/fonts/VT323-Regular.ttf differ diff --git a/tools/branding/fonts/VT323-Regular.ttf.import b/tools/branding/fonts/VT323-Regular.ttf.import new file mode 100644 index 0000000..cc2d023 --- /dev/null +++ b/tools/branding/fonts/VT323-Regular.ttf.import @@ -0,0 +1,36 @@ +[remap] + +importer="font_data_dynamic" +type="FontFile" +uid="uid://dl68sx8ti22de" +path="res://.godot/imported/VT323-Regular.ttf-bf92192fbafeb12c09857a075677f081.fontdata" + +[deps] + +source_file="res://tools/branding/fonts/VT323-Regular.ttf" +dest_files=["res://.godot/imported/VT323-Regular.ttf-bf92192fbafeb12c09857a075677f081.fontdata"] + +[params] + +Rendering=null +antialiasing=1 +generate_mipmaps=false +disable_embedded_bitmaps=true +multichannel_signed_distance_field=false +msdf_pixel_range=8 +msdf_size=48 +allow_system_fallback=true +force_autohinter=false +modulate_color_glyphs=false +hinting=3 +subpixel_positioning=4 +keep_rounding_remainders=true +oversampling=0.0 +Fallbacks=null +fallbacks=[] +Compress=null +compress=true +preload=[] +language_support={} +script_support={} +opentype_features={} diff --git a/tools/branding/manifest.json b/tools/branding/manifest.json new file mode 100644 index 0000000..2f7543c --- /dev/null +++ b/tools/branding/manifest.json @@ -0,0 +1,38 @@ +{ + "boot_splash": { + "file": "assets/branding/boot_splash.png", + "size": [ + 1024, + 1218 + ], + "mode": "P", + "palette_colors": 256, + "sha256": "78524be4ba17ab04afe56d16b00954989457f9af247367f7c4b0f9ed8ea2dec4" + }, + "mascot_source": { + "file": "tools/branding/raw/agy_generate_20261010234423_0.jpg", + "sha256": "5929495ff606fbcdd74f52a37304f3b569315bcd1fc0fef812b5fd7689dc1396" + }, + "generator": { + "tool": "agy_generate (Antigravity direct API)", + "model": "gemini-3.1-flash-image", + "date": "2026-10-11", + "prompt": "single cartoon zombie head-and-bust mascot, unsettling wide grin, thumbs up, 2D cartoon style with bold outlines, flat magenta chroma-key background, no text and no logo", + "terms_note": "generated from no third-party source material; the provider terms do not claim ownership of the output. The generator emits no real alpha channel, so the background is keyed out locally by this script." + }, + "chroma_key": { + "background_rgb": [ + 250, + 4, + 247 + ], + "transparent_below": 55, + "opaque_above": 130 + }, + "title": { + "text": "Mat Games", + "font": "tools/branding/fonts/VT323-Regular.ttf", + "license": "SIL Open Font License 1.1 (tools/branding/fonts/OFL.txt)" + }, + "bottom_fade_px": 50 +} diff --git a/tools/branding/raw/agy_generate_20261010234423_0.jpg b/tools/branding/raw/agy_generate_20261010234423_0.jpg new file mode 100644 index 0000000..4de01b3 Binary files /dev/null and b/tools/branding/raw/agy_generate_20261010234423_0.jpg differ diff --git a/tools/branding/raw/agy_generate_20261010234423_0.jpg.import b/tools/branding/raw/agy_generate_20261010234423_0.jpg.import new file mode 100644 index 0000000..919393f --- /dev/null +++ b/tools/branding/raw/agy_generate_20261010234423_0.jpg.import @@ -0,0 +1,40 @@ +[remap] + +importer="texture" +type="CompressedTexture2D" +uid="uid://c04sjmptejokb" +path="res://.godot/imported/agy_generate_20261010234423_0.jpg-9704405d701d25c0ec3a2821bf90d456.ctex" +metadata={ +"vram_texture": false +} + +[deps] + +source_file="res://tools/branding/raw/agy_generate_20261010234423_0.jpg" +dest_files=["res://.godot/imported/agy_generate_20261010234423_0.jpg-9704405d701d25c0ec3a2821bf90d456.ctex"] + +[params] + +compress/mode=0 +compress/high_quality=false +compress/lossy_quality=0.7 +compress/uastc_level=0 +compress/rdo_quality_loss=0.0 +compress/hdr_compression=1 +compress/normal_map=0 +compress/channel_pack=0 +mipmaps/generate=false +mipmaps/limit=-1 +roughness/mode=0 +roughness/src_normal="" +process/channel_remap/red=0 +process/channel_remap/green=1 +process/channel_remap/blue=2 +process/channel_remap/alpha=3 +process/fix_alpha_border=true +process/premult_alpha=false +process/normal_map_invert_y=false +process/hdr_as_srgb=false +process/hdr_clamp_exposure=false +process/size_limit=0 +detect_3d/compress_to=1 diff --git a/tools/make_boot_splash.py b/tools/make_boot_splash.py new file mode 100644 index 0000000..0e3640f --- /dev/null +++ b/tools/make_boot_splash.py @@ -0,0 +1,122 @@ +"""Compose the boot splash: chroma-keyed mascot plus VT323 "Mat Games" lettering. + +The raw mascot comes from an image generator on a flat magenta background (generators +do not emit real alpha). This script keys that background to transparency, removes +magenta spill, then draws the title with the OFL-licensed VT323 font and saves a +transparent PNG ready for application/boot_splash/image. +""" +import argparse +import hashlib +import json +import pathlib +from PIL import Image, ImageDraw, ImageFilter, ImageFont + +parser = argparse.ArgumentParser() +parser.add_argument('raw', type=pathlib.Path, help='raw generated image (magenta background)') +parser.add_argument('--title', default='Mat Games') +parser.add_argument('--canvas', type=int, default=1024) +parser.add_argument('--title-height', type=int, default=190) +parser.add_argument('--bottom-fade', type=int, default=50, + help='soften the generator frame cut at the bottom of the bust') +parser.add_argument('--colors', type=int, default=256, + help='palette colors for the shipped PNG; 0 keeps 32-bit RGBA') +args = parser.parse_args() +args.raw = args.raw.resolve() +root = pathlib.Path(__file__).resolve().parents[1] +branding = root / 'assets/branding' +branding.mkdir(parents=True, exist_ok=True) +source_tools = root / 'tools/branding' +font_path = source_tools / 'fonts/VT323-Regular.ttf' + +# ---------------------------------------------------------------- chroma key +source = Image.open(args.raw).convert('RGB') +corners = [source.getpixel(p) for p in + [(2, 2), (source.width - 3, 2), (2, source.height - 3), (source.width - 3, source.height - 3)]] +background = tuple(sorted(channel)[1] for channel in zip(*corners)) # median per channel +T0, T1 = 55, 130 +alpha = Image.new('L', source.size) +spill = Image.new('L', source.size) +pixels = source.load() +alpha_pixels = alpha.load() +spill_pixels = spill.load() +for y in range(source.height): + for x in range(source.width): + r, g, b = pixels[x, y] + distance = ((r - background[0]) ** 2 + (g - background[1]) ** 2 + (b - background[2]) ** 2) ** 0.5 + alpha_pixels[x, y] = max(0, min(255, round((distance - T0) / (T1 - T0) * 255))) + # Magenta contamination raises both red and blue above green. + spill_pixels[x, y] = max(0, min(r, b) - g) +mask = alpha.filter(ImageFilter.MedianFilter(3)) +fixed = Image.new('RGB', source.size) +fixed_pixels = fixed.load() +for y in range(source.height): + for x in range(source.width): + r, g, b = pixels[x, y] + amount = spill_pixels[x, y] + fixed_pixels[x, y] = (max(0, r - amount), g, max(0, b - amount)) +mascot = fixed.convert('RGBA') +mascot.putalpha(mask) +mascot = mascot.crop(mascot.getbbox()) +if args.bottom_fade > 0: + fade = min(args.bottom_fade, mascot.height) + ramp = Image.new('L', (1, fade)) + for y in range(fade): + ramp.putpixel((0, y), round(255 * (1.0 - y / fade))) + band = mascot.crop((0, mascot.height - fade, mascot.width, mascot.height)) + band.putalpha(Image.composite(band.getchannel('A'), Image.new('L', band.size, 0), ramp.resize((1, fade)).resize(band.size, Image.NEAREST))) + mascot.paste(band, (0, mascot.height - fade)) + +# ---------------------------------------------------------------- composition +canvas_width = args.canvas +title_area = args.title_height +scale = (canvas_width - 2 * 40) / mascot.width +mascot = mascot.resize((round(mascot.width * scale), round(mascot.height * scale)), Image.LANCZOS) +height = mascot.height + title_area +canvas = Image.new('RGBA', (canvas_width, height), (0, 0, 0, 0)) +canvas.alpha_composite(mascot, ((canvas_width - mascot.width) // 2, 0)) + +font_size = int(title_area * 0.95) +font = ImageFont.truetype(str(font_path), font_size) +text = args.title +while font.getbbox(text)[2] - font.getbbox(text)[0] > canvas_width - 60 and font_size > 8: + font_size -= 2 + font = ImageFont.truetype(str(font_path), font_size) +box = font.getbbox(text) +text_width = box[2] - box[0] +position = ((canvas_width - text_width) // 2 - box[0], mascot.height + (title_area - box[3]) // 2 - box[1]) +glow = Image.new('RGBA', canvas.size, (0, 0, 0, 0)) +ImageDraw.Draw(glow).text(position, text, font=font, fill=(255, 150, 20, 190)) +glow = glow.filter(ImageFilter.GaussianBlur(9)) +canvas.alpha_composite(glow) +ImageDraw.Draw(canvas).text(position, text, font=font, fill=(255, 196, 64, 255)) + +out = branding / 'boot_splash.png' +if args.colors > 0: + # Flat cartoon art tolerates a palette well; keeps ~95 alpha levels for edges. + canvas = canvas.quantize(colors=args.colors, method=Image.FASTOCTREE, dither=Image.Dither.NONE) +canvas.save(out, optimize=True) +manifest = json.loads((source_tools / 'manifest.json').read_text()) if (source_tools / 'manifest.json').exists() else {} +manifest.update({ + 'boot_splash': {'file': str(out.relative_to(root)), 'size': list(canvas.size), 'mode': canvas.mode, + 'palette_colors': args.colors, + 'sha256': hashlib.sha256(out.read_bytes()).hexdigest()}, + 'mascot_source': {'file': str(args.raw.relative_to(root)), + 'sha256': hashlib.sha256(args.raw.read_bytes()).hexdigest()}, + 'generator': { + 'tool': 'agy_generate (Antigravity direct API)', + 'model': 'gemini-3.1-flash-image', + 'date': '2026-10-11', + 'prompt': ('single cartoon zombie head-and-bust mascot, unsettling wide grin, thumbs up, ' + '2D cartoon style with bold outlines, flat magenta chroma-key background, ' + 'no text and no logo'), + 'terms_note': ('generated from no third-party source material; the provider terms do not claim ' + 'ownership of the output. The generator emits no real alpha channel, so the ' + 'background is keyed out locally by this script.'), + }, + 'chroma_key': {'background_rgb': list(background), 'transparent_below': T0, 'opaque_above': T1}, + 'title': {'text': args.title, 'font': 'tools/branding/fonts/VT323-Regular.ttf', + 'license': 'SIL Open Font License 1.1 (tools/branding/fonts/OFL.txt)'}, + 'bottom_fade_px': args.bottom_fade, +}) +(source_tools / 'manifest.json').write_text(json.dumps(manifest, indent=2) + '\n') +print(out, canvas.size, canvas.mode, 'mascot', mascot.size)