doc/README_convert_PNG_to_ICNS_and_ICO

   1 ## There is now a script utils/mk_jalview_icons.sh that creates the .icns and .ico icon files, and also the rotatable icon.
   2 Run it as
   3 ```
   4 mk_jalview_icons.sh <BASENAME>-512.png
   5 ```
   6 Having an existing 512x512 PNG image with the above filename format is important.
   7 It will then create multiple files
   8 `<BASENAME>-<N>.png`
   9 for N being 16, 32, 38, 48, 64, 128, 256.
  10 **NB** You might want to edit these as described below.  The `mk_jalview_icons.sh` will not overwrite these files, but it
  11 will overwrite the `.ico` and `.icns` files, so after editing the `<BASENAME>-<N>.png` files, just run the script again.
  12
  13 As below, the script relies on ImageMagick and icnsutils being installed with `convert` and `png2icns` in the PATH.
  14
  15 The rotatable logo will also be created (and overwritten) as
  16 `rotatable_<BASENAME>-38.png`
  17
  18
  19 ## Old text
  20 ### Creating the .ico (Windows) and .icns (macOS) files from PNG images in linux
  21
  22 Create multiple square versions of your icon at the following resolutions:
  23 16x16, 32x32, 48x48, 64x64, 128x128, 256x256, 512x512
  24
  25 > A quick way to do this with ImageMagick is create the 512x512 logo first, saved as logo-512.png, and run
  26 > `for n in 16 32 48 64 128 256; do convert -geometry ${n}x${n} logo-512.png logo-${n}.png; done`
  27 > but note that anitaliasing can make a logo look quite blurry, especially for small resolutions.  These should
  28 > then be hand edited (with e.g. gimp) to neaten the edges.  A nice trick in gimp is to use the Colours->Curves->Alpha
  29 > and create a curve that makes mostly transparent pixels completely transparent, and slightly transparent pixels
  30 > completely opaque.
  31
  32 Then use the script `jalview/utils/create_iconfiles.sh` like this:
  33 ```
  34 create_iconfiles.sh logo-*.png
  35 ```
  36 and it will create both `logo.ico` and `logo.icns` containing the appropriate different resolution logos.
  37 It is then up to the OS to display the correct one in different circumstances.
  38
  39 This script uses the utilities convert (ImageMagick) and png2icns (icnsutils) which should be installed and in the path.
  40 Note that for some reason ICNS files should not contain a 64x64 pixel version of a logo, so the script removes this
  41 as png2icns complains if it finds one!
  42
  43 ### Rotatable icon with white background
  44
  45 This icon is used by the web services progress window, with the rotating Jalview logo.
  46 It requires some small margin of white pixels around the logo to enable antialiasing around the edge of the logo.
  47 You can make one form a 38x38 transparent logo with
  48 ```
  49 convert jalview_logo-38.png -gravity center -background white -extent 60x60 rotatable_jalview_logo-38.png
  50 ```