summaryrefslogtreecommitdiff
path: root/icon-themes/README
blob: 79ca0ed54b876dbc5489528d8d644548787e81fa (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
Icon repository for the applications

All of the icons, separated by themes are included in this
directory. These icons are built into .zip files, and re-ordered /
packed for efficiency reasons based on our UI configuration by the
postprocess/CustomTarget_images.mk.

An icon theme does not need to contain all images, since these can be
layered one on top of another.

In general the layering is done like this:

<leaf theme>
breeze
colibre

How to add a new image set:
---------------------------

- Create a directory for it here (let's call it e.g. new_set)

  FIXME: It is important to use an underscore '_' to delimit more words.
         scp2 compilation crashes when using a dash '-'.
         It evidently splits the name into two strings.
   ^ It's probably not true anymore with filelists.
   ^ if this gets changed, IconThemeSelector::SetPreferredIconTheme needs to change too

- Add its name (new_set) to WITH_THEMES variable in configure.ac

- The fallback for particular icons is defined be packimages_CUSTOM_FALLBACK_1
  in packimages/CustomTarget_images.mk


How to add a new icon for a new command:
----------------------------------------

- Assume you defined a dispatch command in officecfg like the following:

  in officecfg/registry/data/org/openoffice/Office/UI/CalcCommands.xcu

    <node oor:name=".uno:OpenFromCalc" oor:op="replace">
        <prop oor:name="Label" oor:type="xs:string">
            <value xml:lang="en-US">~Open...</value>
        </prop>
        <prop oor:name="Properties" oor:type="xs:int">
            <value>1</value>
        </prop>
    </node>

  Here, you need to define a property named "Properties", with its value set
  to 1 so that the icons show up.

- Now, you need to add 2 new icon images under icon-themes/colibre/cmd/, one
  for the large size and one for the smaller size.  The name of each image
  must be lc_<command name>.png and sc_<command name>.png.  Here, the command
  name is the name given in the above .xcu file without the ".uno:" prefix and
  all its letters lower-cased.  In this example, the file names will be
  lc_openfromcalc.png and sc_openfromcalc.png.  Note that you need to add new
  images to the colibre theme for them to show up in any themes at all.

How to call optipng to optimize size:
---------------------------

8 bit palettes are on the slow path for quartz/svp/gtk3 so avoid using palettes with...

$ optipng -nc <file>
lo/core/commit/drawinglayer/source/processor3d?id=a2fbc48afdaf693f1a24e1de5cea21250bfab5ed'>tdf#42949 Fix IWYU warnings in drawinglayer/Gabor Kelemen 2019-03-08new loplugin constvarsNoel Grandin 2019-02-08loplugin:indentation in dbaccess..drawinglayerNoel Grandin 2018-10-23clang-tidy performance-unnecessary-copy-init in dbaccess..drawinglayerNoel Grandin 2018-10-19clang-tidy readability-container-size-emptyNoel Grandin 2018-09-06loplugin:simplifyconstruct in dbaccess..drawinglayerNoel Grandin 2018-07-18Removed duplicated includeAndrea Gelmini 2018-07-16loplugin:mergeclasses merge BPixelRaster into BZPixelRasterNoel Grandin 2018-05-17loplugin:unusedfields in dbaccess..drawinglayerNoel Grandin 2018-01-19loplugin:useuniqueptr in ZBufferProcessor3DNoel Grandin 2018-01-12More loplugin:cstylecast: drawinglayerStephan Bergmann 2018-01-11convert (a>b?a:b) to std::max(a,b)Noel Grandin 2017-11-22Make loplugin:unnecessaryparen warn about (x) ? ... : ... after allStephan Bergmann 2017-11-03loplugin:constmethod in drawinglayerNoel Grandin 2017-09-26Rename the basegfx::tools namespace to basegfx::utilsTor Lillqvist 2017-09-18maPrimitiveColor in Shadow3DExtractingProcessor unusedNoel Grandin 2017-08-17remove UL/L suffixes from integer constants on the RHS of expressionsNoel Grandin 2017-08-17remove UL/L suffixes from integer constants in initialiser/call expressionsNoel Grandin 2017-06-28remove default-able copy ctors and copy operatorsJochen Nitschke 2017-06-12clang-tidy readability-delete-null-pointerNoel Grandin