summaryrefslogtreecommitdiffstats
path: root/icon-themes/README.md
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 09:06:44 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 09:06:44 +0000
commited5640d8b587fbcfed7dd7967f3de04b37a76f26 (patch)
tree7a5f7c6c9d02226d7471cb3cc8fbbf631b415303 /icon-themes/README.md
parentInitial commit. (diff)
downloadlibreoffice-ed5640d8b587fbcfed7dd7967f3de04b37a76f26.tar.xz
libreoffice-ed5640d8b587fbcfed7dd7967f3de04b37a76f26.zip
Adding upstream version 4:7.4.7.upstream/4%7.4.7upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'icon-themes/README.md')
-rw-r--r--icon-themes/README.md77
1 files changed, 77 insertions, 0 deletions
diff --git a/icon-themes/README.md b/icon-themes/README.md
new file mode 100644
index 000000000..3d3c378b8
--- /dev/null
+++ b/icon-themes/README.md
@@ -0,0 +1,77 @@
+# 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`) 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>