08241a5079
Change-Id: I299a283a1729f3ab0595218b7b29ca36a1c257f7 Reviewed-on: https://gerrit.libreoffice.org/c/core/+/167975 Tested-by: Jenkins Reviewed-by: Rizal Muttaqin <rizmut@libreoffice.org> |
||
---|---|---|
.. | ||
breeze | ||
breeze_dark | ||
breeze_dark_svg | ||
breeze_svg | ||
colibre | ||
colibre_dark | ||
colibre_dark_svg | ||
colibre_svg | ||
elementary | ||
elementary_svg | ||
karasa_jaga | ||
karasa_jaga_svg | ||
sifr | ||
sifr_dark | ||
sifr_dark_svg | ||
sifr_svg | ||
sukapura | ||
sukapura_dark | ||
sukapura_dark_svg | ||
sukapura_svg | ||
README.md |
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
Icon naming convention
sc_* icons are 16x16 px (small) lc_* icons are 24x24 px (large) There is also an 32px folder at cmd/ with 32 px icons
16x16 px icons are used in the menus 24x24 px icons are used in toolbars and sidebar Notebook bar use 24x24 px icons when there is only one icon, and 16x16 px everywhere else
sc_ and lc_ icon are followed by the .uno:CommandName (see below)
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
) toWITH_THEMES
variable inconfigure.ac
-
The fallback for particular icons is defined be
packimages_CUSTOM_FALLBACK_1
inpackimages/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 belc_<command name>.png
andsc_<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 belc_openfromcalc.png
andsc_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>