Un errore frequente è credere che convertire un PNG in .ico consista nel rinominare l'estensione del file. Se rinomini logo.png in logo.ico, i compilatori di risorse di Windows Visual Studio (rc.exe), gli installer Inno Setup, Electron Builder e Tauri rifiuteranno il file segnalando un errore di intestazione non valida.
Utiliome costruisce un buffer binario little-endian conforme alle specifiche direttamente nel browser utilizzando ArrayBuffer e DataView:
- Intestazione file
ICONDIRa 6 byte: Scrive0x0000(Riservato),0x0001(Tipo1= Icona Windows) e il conteggiouint16dei livelli di risoluzione incorporati. - Tabella directory
ICONDIRENTRYa 16 byte per livello: Per ogni risoluzione selezionata (16,24,32,48,64,128,256), scrive larghezza e altezza in pixel (0indica256pxsecondo le specifiche Windows Vista+), piani colore (1), bit per pixel (32per RGBA completo), dimensione in byte e offset esatto in byte. - Payload dei fotogrammi PNG a 32-bit RGBA: Concatena ciascun fotogramma PNG ricampionato ad alta fedeltà all'offset di byte calcolato.