office-gobmx/icon-themes
Petr Mladek 4b27695fea add "Tango Testing" icon theme
It is enabled by default for dev build. It will be used for reworking
the Tango theme by the design team.

The them was requested by Stefan Knorr (Astron) <heinzlesspam at gmail dot com>
The two intial icons are from Alexander Wilms <alexander dot wilms at zoho dot com>

Change-Id: I9205a3164352442a2cdc02e75e58b15b327dfbd3
2012-08-31 15:52:21 +02:00
..
classic
crystal
galaxy
hicontrast
human
industrial
oxygen
tango
tango_testing/cmd add "Tango Testing" icon theme 2012-08-31 15:52:21 +02:00
README add "Tango Testing" icon theme 2012-08-31 15:52:21 +02:00

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)

  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.

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

- 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/vcl/settings.hxx, e.g.
  #define STYLE_SYMBOLS_NEW_SET ((ULONG)5)

- Map the vcl constant to its real name in
    ::rtl::OUString StyleSettings::ImplSymbolsStyleToName( sal_uLong nStyle ) const
  and 
    sal_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

- FIXME: is this step still needed?
  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 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.  (TODO: Check if this step is still necessary.)

- Now, you need to add 2 new icon images under icon-themes/galaxy/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 galaxy theme for them to show up in any themes at all.