icon-themes/README

   1 Icon repository for the applications
   2
   3 All of the icons, separated by themes are included in this
   4 directory. These icons are built into .zip files, and re-ordered /
   5 packed for efficiency reasons based on our UI configuration by the
   6 postprocess/CustomTarget_images.mk.
   7
   8 An icon theme does not need to contain all images, since these can be
   9 layered one on top of another.
  10
  11 In general the layering is done like this:
  12
  13 <leaf theme>
  14 breeze
  15 colibre
  16 tango
  17
  18 How to add a new image set:
  19 ---------------------------
  20
  21 - Create a directory for it here (let's call it e.g. new_set)
  22
  23   FIXME: It is important to use an underscore '_' to delimit more words.
  24          scp2 compilation crashes when using a dash '-'.
  25          It evidently splits the name into two strings.
  26    ^ It's probably not true anymore with filelists.
  27    ^ if this gets changed, IconThemeSelector::SetPreferredIconTheme needs to change too
  28
  29 - Add its name (new_set) to WITH_THEMES variable in configure.ac
  30
  31 - The fallback for particular icons is defined be packimages_CUSTOM_FALLBACK_1
  32   in packimages/CustomTarget_images.mk
  33
  34
  35 How to add a new icon for a new command:
  36 ----------------------------------------
  37
  38 - Assume you defined a dispatch command in officecfg like the following:
  39
  40   in officecfg/registry/data/org/openoffice/Office/UI/CalcCommands.xcu
  41
  42     <node oor:name=".uno:OpenFromCalc" oor:op="replace">
  43         <prop oor:name="Label" oor:type="xs:string">
  44             <value xml:lang="en-US">~Open...</value>
  45         </prop>
  46         <prop oor:name="Properties" oor:type="xs:int">
  47             <value>1</value>
  48         </prop>
  49     </node>
  50
  51   Here, you need to define a property named "Properties", with its value set
  52   to 1 so that the icons show up.
  53
  54 - Now, you need to add 2 new icon images under icon-themes/colibre/cmd/, one
  55   for the large size and one for the smaller size.  The name of each image
  56   must be lc_<command name>.png and sc_<command name>.png.  Here, the command
  57   name is the name given in the above .xcu file without the ".uno:" prefix and
  58   all its letters lower-cased.  In this example, the file names will be
  59   lc_openfromcalc.png and sc_openfromcalc.png.  Note that you need to add new
  60   images to the colibre theme for them to show up in any themes at all.
  61
  62 How to call optipng to optimize size:
  63 ---------------------------
  64
  65 8 bit palettes are on the slow path for quartz/svp/gtk3 so avoid using palettes with...
  66
  67 $ optipng -nc <file>