doc/README-DMG_background_image_creation.md

   1 # Links with `DS_Store`
   2 The DMG background image should be 500x461 pixels with DPI set at 72.  The spacing for the Jalview application icon and the symbolic link to the Applications folder tie in with the information in the `DS_Store` file, so both files should be changed if you want to move the icons.  Instructions on how to create/adapt the `DS_Store` file can be found in file `README-DMG_creation.md`.
   3
   4 # Creation of `jalview_dmg_background.png`
   5 The most recent `jalview_dmg_background.png` (with blurry faded tiled Jalview logos, should be released with Jalview 2.11.1) is created from the `jalview_dmg_background_blur_layers.svg` file which can be edited in Inkscape.  It is exported as `jalview_dmg_background_blur.png` at 500x461 pixels but Inkscape currently makes it difficult to choose an arbitrary dpi in the PNG metadata, with 96 DPI the default.
   6
   7 The exported PNG can have the 96 DPI metadata changed using GIMP or ImageMagick.  Here is how to do it on the command line with ImageMagick:
   8 ```
   9 convert -units PixelsPerInch jalview_dmg_background_blur.png -density 72 jalview_dmg_background.png
  10 ```
  11 The final image should be saved as `jalview_dmg_background.png` (which the above `convert` command will do) as this is the filename set in the `install4j8_template.install4j` file to include in the final DMG.
  12
  13 # Alternative backgrounds
  14
  15 There are now specific background images with associated DS_Stores for Release, Develop and Test.  Anything else should use the non-release DS_Store and background image.
  16
  17 ## Non-release background `jalview_dmg_background-NON-RELEASE.png`
  18 This is created in much the same way with `jalview_dmg_background-NON-RELEASE.svg` and is used as a more generic background for non-release versions where the "Jalview Build" (or "Jalview Local" etc) application icon is placed in the first available slot in the Finder window.  We cannot position these unless we create a DS_Store specifically for each possible application name.  The Applications folder link can be (and is) positioned as this names is fixed.