Theme Preferences

From Audacity Development Manual
Revision as of 12:58, 16 February 2010 by Windinthew (talk | contribs) (Make public this feature is disabled in case anyone finds this page)
Jump to: navigation, search


This feature is still under development, and disabled in current releases. It will be re-introduced in a later Beta version.

Summary

Theme Preferences customises the images and colors used in Audacity


Theme Preferences


Theme Cache

The Theme Cache is a compound image that contains (nearly) all of Audacity's images and colors. To modify the images and colors follow these steps:

  • Click Save Theme Cache. A copy of the images will be saved in file ImageCache.png in the "Theme" directory inside your Audacity settings folder. This folder can be found at:
    • Windows: Documents and Settings\<user name>\Application Data\Audacity
    • OS X: ~/Library/Application Support/audacity
    • Linux: ~/.audacity-data
  • Modify the ImageCache file using an image editor such as the GIMP and save the results in the same place.
  • You can test changes to the Image cache by clicking Load Theme Cache. However, this is a partially implemented feature, and only some changes such as changes to the large buttons and changes to the colors for the waveforms will show up.
  • Check the check box marked 'Load Theme Cache at Start Up'. Now when you restart Audacity you will get the new images and colors.

If you have an ImageCache.png provided by someone else you only need to:

  • Place it in the correct directory.
  • Check the 'Load Theme Cache at Start up' box.

If you want the built in images again:

  • Use Defaults to restore the default images.
  • Click Save Theme Cache to save the default values.

Individual Theme Files

Because the images Audacity needs will change from one version of Audacity to another, there is also a way to build a Theme Cache up from component images and to break a Theme Cache down into its components.

  • Use Save Files to break a ThemeCache into its component images.
  • Use Load Files to build a new ThemeCache from existing components. This Theme Cache is held in Audacity. If you want to save it you will still need to click 'Save Theme Cache'


You should not expect a Theme Cache designed for one version of Audacity to work with another version. However using the individual component images, converting from one to another is not difficult.

For Developers

Audacity has a built in Theme Cache which it uses for its defaults. If you know how to compile Audacity from its source code you can also update this built in Theme Cache. Contact the Audacity developer's mailing list for details.