summaryrefslogtreecommitdiff
path: root/icon-themes/README
blob: 120c3abac17e0c0a62897b8fcc8aa5b50591f959 (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
packimages/ module.

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>
tango
industrial
galaxy

The classic theme is left primarily for historical interest, rather
than intended to be packaged.


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

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

- Add its images_ name to CUSTOM_IMAGE_SETS in
  postprocess/packimages/pack/makefile.mk

- Add its gid to the Files section of gid_Module_Root_Brand in
  scp2/source/ooo/module_hidden_ooo.scp and add a corresponding File entry
  to scp2/source/ooo/file_ooo.scp (see for example
  gid_Brand_File_ImagesCrystal_Zip)

- Add a vcl constant for it in vcl/inc/settings.hxx, e.g.
  #define STYLE_SYMBOLS_NEW_SET ((ULONG)5)

- Map the vcl constant to its real name in
    ::rtl::OUString StyleSettings::GetCurrentSymbolsStyleName() const
  and 
    ULONG StyleSettings::ImplNameToSymbolsStyle( const ::rtl::OUString &rName ) const
  both in vcl/source/app/settings.cxx, e.g.
    case STYLE_SYMBOLS_NEW_SET: return ::rtl::OUString::createFromAscii( "new_set" );
  and 
    else if ( rName == ::rtl::OUString::createFromAscii( "new_set" ) )
    	return STYLE_SYMBOLS_NEW_SET;

- Add localized item names to 'ListBox LB_ICONSTYLE' to
    'StringList [ de ]'
  and 'StringList [ en-US ]', e.g.
    < "New set" ; > ;
  both in cui/source/options/optgdlg.src

- Add all known localizations of the new item to svx/source/dialog/localize.sdf, e.g.
    svx	source\dialog\optgdlg.src	0	stringlist	OFA_TP_VIEW.LB_ICONSTYLE	6			0	cs	New set				2002-02-02 02:02:02
  the check box item will not be visible in the other localizations otherwise, see http://www.openoffice.org/issues/show_bug.cgi?id=74982

- Add the new_set to 'SymbolsStyle' property
  in officecfg/registry/schema/org/openoffice/Office/Common.xcs.

- The default theme for various desktops (KDE, GNOME, ...) is defined in
    ULONG StyleSettings::GetCurrentSymbolsStyle() const in
  vcl/source/app/settings.cxx

- The fallback for particular icons is defined in
    packimages/pack/Makefile