Skip to content

start:

Small FAQ on the KDE OOo icons

2004-04-02

I'd like to have KDE icons in OpenOffice.org, what can I do?

Download the latest ooo-build tarball from http://ooo.ximian.com and configure it with --with-distro=KDE --with-icons=KDE. After the compilation you will get OOo with the KDE icons and other KDE add-ons.

 

Some of the icons do not look good. What can I do about it?

You can help improving the KDE icon set for OpenOffice.org. You do not even have to be an icon designer, because there is still a lot of icons which are in KDE, but I did not add them to the OOo icon set, usually because I did not find them at all. Just download ooo-KDE_icons-src and you can start. It contains scripts and bitmaps to create the KDE icon set suitable for OOo.

 

But I am an icon designer!

Even better! I prepared a SVG set (OOo icons converted to SVG) for you to work on: ooo-svg_icons-OOO_1_1. You can create the tarball yourself by running make svg in your untarred ooo-KDE_icons-src. But then you need potrace.

Please note that the SVG icon set can not be used "as it is". The SVG icons have to be converted to PNG to be usable for make icons, the command that actually creates the icon set.

 

OK, I have ooo-KDE_icons-src. What do I have to do next?

It has three steps. First of all, you have to find a good KDE equivalent or design a new icon, and put it to the kde subdirectory.

Then you have to modify iconlist.txt, so that the scripts find the icon and use it. You need OOo with debug icon set for this task. See the section How to build OOo with debug icons. Now:

  • Run OOo with debug icons.
  • Find the missing/bad icon. If it's just a plain white rectangle with a number, it has no KDE counterpart assigned yet. The number is an index in the mapping.txt file (see How to build OOo with debug icons), not an index in the iconlist.txt.
  • Copy the relevant part of the bitmap file name to iconlist.txt and assign an image from the kde subdirectory to it (a PNG file with alpha mask).

The third step is easy. Send your modifications to the kde.openoffice.org dev mailing list, so that I could add them to the next version of ooo-KDE_icons-src.

 

What do you mean by "relevant part af the icon file name"?

Relevant part of the bitmap file name is a 5 digit number for bitmaps matching the [sl][ocx]XXXXX.bmp pattern, or the filename without the .bmp suffix for the rest of BMPs. Please use cr22-*.png for the XXXXX bitmaps in iconlist.txt, cr16-*.png will be used automatically if 16x16 bitmap is needed and exists.

 

Can I have an example?

Sure: 

# For res/lc05300.bmp:
05300	cr22-action-exit.png

# For vcl/source/src/msgbox.bmp:
msgbox	modified-128x32-msgbox.png

 

How to build OOo with debug icons?

Configure ooo-build with --with-distro=KDE --with-icons=KDE_debug and compile it. After the compilation, you will get OOo with KDE debug icons and other KDE add-ons.

The mapping.txt file is stored under build/OOO_1_1_1/mapping.txt in your ooo-build.

 

What do the names in the kde subdir mean?

  • original-*.png are just copied from OOo and need redesign.
  • *modified-*.png are derived by me from existing KDE icons. Most probably lots of them will need redesign as well.
  • cr22-*.png 22x22 original KDE icons.
  • cr16-*.png 16x16 original KDE icons.

 

Jan Holesovsky /kendy at openoffice org/