utils/install4j/README_convert_PNG_to_ICNS_and_ICO

   1 ## Creating the .ico (Windows) and .icns (macOS) files from PNG images in linux
   2
   3 Create multiple square versions of your icon at the following resolutions:
   4 16x16, 32x32, 48x48, 64x64, 128x128, 256x256, 512x512
   5
   6 > A quick way to do this with ImageMagick is create the 512x512 logo first, saved as logo-512.png, and run
   7 > `for n in 16 32 48 64 128 256; do convert -geometry ${n}x${n} logo-512.png logo-${n}.png; done`
   8 > but note that anitaliasing can make a logo look quite blurry, especially for small resolutions.  These should
   9 > then be hand edited (with e.g. gimp) to neaten the edges.  A nice trick in gimp is to use the Colours->Curves->Alpha
  10 > and create a curve that makes mostly transparent pixels completely transparent, and slightly transparent pixels
  11 > completely opaque.
  12
  13 Then use the script `jalview/utils/create_iconfiles.sh` like this:
  14 ```
  15 create_iconfiles.sh logo-*.png
  16 ```
  17 and it will create both `logo.ico` and `logo.icns` containing the appropriate different resolution logos.
  18 It is then up to the OS to display the correct one in different circumstances.
  19
  20 This script uses the utilities convert (ImageMagick) and png2icns (icnsutils) which should be installed and in the path.
  21 Note that for some reason ICNS files should not contain a 64x64 pixel version of a logo, so the script removes this
  22 as png2icns complains if it finds one!
  23
  24 ### Rotatable icon with white background
  25
  26 This icon is used by the web services progress window, with the rotating Jalview logo.
  27 It requires some small margin of white pixels around the logo to enable antialiasing around the edge of the logo.
  28 You can make one form a 48x48 transparent logo with
  29 ```
  30 convert jalview_logo-48.png -gravity center -background white -extent 60x60 rotatable_jalview_logo-48.png
  31 ```