Opened 5 years ago

Closed 4 years ago

#11261 closed defect (fixed)

MAC OS X: App icon doesn’t display on OS X 10.5.8.

Reported by: macca8 Owned by: criezy
Priority: normal Component: Port: Mac OS X
Version: Keywords:
Cc: Game:


The current build of the scummvm.icns file isn’t compatible with OS X 10.5.8, producing an app label accompanied by an invisible icon.

Platform: Intel Mac & PPC Mac (OS X 10.5.8)

This file was updated with the new icon as part of the implementation of the remastered modern theme in April 2019.

In updating the icon, the structure of the file was changed from the old Apple icon image format (consisting solely of 72ppi images) to the newer icon image format (consisting of a mix of 72ppi & 144ppi images) introduced in OS X 10.8 to complement the release of retina displays.

For systems not capable of supporting retina displays (OS X 10.7 and earlier), all 144ppi images are automatically hidden from view, leaving only 72ppi images available for use.

The scummvm.icns file retains only the 256 & 512 pixel images (for some reason, the 128x128 72ppi image (the default) is also hidden) for use with OS X 10.7 or earlier.

These images display correctly on OS X 10.6 & 10.7 (dual boot 32bit/64bit systems), but appear as blank images (0 pixel size) on OS X 10.5.8 (a 32bit-only system).

This behaviour is consistent with other apps that have icon files containing 144ppi images less than 1024x1024 pixels in size.

Ironically, even though the icon is invisible, because the app label is visible, it’s still possible to interact with the icon normally, but this is a poor compromise.

Since the issue is restricted to 32bit systems, the obvious solution is to create a second scummvm.icns file for use in 32bit builds, in the previous format of 72ppi images only… the old logo proved that this format works up to macOS 10.14.

The newer format is really for the benefit of those with retina displays or better, and those users now have the option of 64bit daily & release builds.

As a proof of concept, I’ve attached a new scummvm.icns file for the updated icon in the previous format for testing.

Attachments (2)

scummvm.icns (119.2 KB ) - added by macca8 5 years ago.
Updated icon in previous 72ppi-only Apple icon image format
scummvm.2.icns (123.6 KB ) - added by criezy 4 years ago.

Download all attachments as: .zip

Change History (7)

by macca8, 5 years ago

Attachment: scummvm.icns added

Updated icon in previous 72ppi-only Apple icon image format

comment:1 by criezy, 4 years ago

Owner: set to criezy
Resolution: fixed
Status: newclosed

Thank you for the report.
I have now updated our scummvm-media repository to allow generating a legacy icns file with only 72ppi icons. And I have also modified the ScummVM build rules to use this legacy file when targeting a Mac OS X version older than 10.6.

comment:2 by criezy, 4 years ago

Resolution: fixed
Status: closednew

Reopening as the icon I used still doesn't work on Mac OS X 10.5. The one attached to this ticket could be used, but if possible I would like to find a way to properly generate it in our scummvm-media repository.

by criezy, 4 years ago

Attachment: scummvm.2.icns added

comment:3 by criezy, 4 years ago

I have attached a new test icon. Could you please check if that one works for you on 10.5?

I am using exactly the same source png images as for the scummvm_legacy.icns I generated yesterday, but instead of using iconutil I used Icon Composer on 10.6 to generate the icons file. This is not ideal as this cannot be scripted, but at least it would indicate I can generate working icons on the same machine I use to generate the PPC builds.

comment:4 by macca8, 4 years ago

Your test icon works perfectly on 10.5... & 10.6 & 10.11.
The legacy icon displays similar structural issues on 10.6 as seen on 10.5 (including the missing 128 pixel image), except that the icon still works on 10.6. If you can get the legacy icon to match the structure of your test icon on 10.6 (it already matches on 10.11), you can pretty much guarantee that it will work on 10.5.

Last edited 4 years ago by macca8 (previous) (diff)

comment:5 by criezy, 4 years ago

Resolution: fixed
Status: newclosed

Thank you for confirming the test icon is fine.
I will close this now as I have a way to generate valid icons manually and have updated the icon in the repository. I will continue to look for a way to automate the icon generation, but that is outside the scope of this ticket.

Note: See TracTickets for help on using tickets.