From 08a89d3709af28bc3353ac142b7d81af5ff26200 Mon Sep 17 00:00:00 2001 From: rfm Date: Fri, 22 Sep 2006 16:42:47 +0000 Subject: [PATCH] merge bugfix and documentation from themes branch git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/gui/trunk@23593 72102866-910b-0410-8b05-ffd578937521 --- Headers/Additions/GNUstepGUI/GSTheme.h | 109 ++++++++++++++++++++++++- Source/NSColor.m | 2 +- 2 files changed, 109 insertions(+), 2 deletions(-) diff --git a/Headers/Additions/GNUstepGUI/GSTheme.h b/Headers/Additions/GNUstepGUI/GSTheme.h index 5971ed615..bd5e0be8f 100644 --- a/Headers/Additions/GNUstepGUI/GSTheme.h +++ b/Headers/Additions/GNUstepGUI/GSTheme.h @@ -24,15 +24,121 @@ License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02111 USA. - */ + + + + The theme management system +

+ The theme management system for the GNUstep GUI is based around the + [GSTheme] class, which provides support for loading of theme bundles + and methods for drawing common user interface elements.
+ The theme system works in conjunction with a variety of other GUI + classes and is intended to eventually allow for very major changes + in GUI appearance and behavior. +

+

+ Various design imperatives apply to the theme system, but probably + the key ones are: +

+ + It should allow designers and other non-technical users to + easily develop new and interesting GUI styles likely to attract + new users to GNUstep. + + Using and switching between themes should be an easy and + pleasant experience ... so that people are not put off when they + try using themes. + + It should eventually permit a GNUstep application to + appear as a native application on ms-windows and other systems. + + +

+ To attain these aims implies the recognition of some more specific + objectives and some possible technical solutions: +

+ + We must have as simple as possible an API for the + functions handling the way GUI elements work and the way they + draw themselves.
+ The standard OpenStep/MacOS-X API provides mechanisms for + controlling the colors used to draw controls (via [NSColor] and + [NSColorList]) and controlling the way controls behave + (NSInterfaceStyleForKey() and [NSResponder-interfaceStyle]), + but we need to extend that with methods to draw controls entirely + differently if required. + + We must have a GUI application for theme development. + It is not sufficient to provide an API if we want good graphic + designers and user interface specialists to develop themes + for us. + + It must be possible for an application to dynamically change + the theme in use while it is running and it should be easy for a + user to select between available themes.
+ This implies that themes must be loadable bundles and that it + must always be possible to unload a theme as well as loading one.
+ It suggests that the theme selection mechanism should be in every + application, perhaps as an extension to an existing panel such + as the info panel. + + +
+ Types of theming +

+ There are various aspects of theming which can be treated pretty + much separately, so there is no reason why a theme might not be + created which just employs one of these mechanisms. +

+ + System images + + Possibly the simples theme change ... a theme might supply a + new set of system images used for arrows and other icons that + the GUI decorates controls with. + + System colors + + A theme might simply define a new system color list, so that + controls are drawn in a new color range, though they would + still function the same way. Even specifying new colors can + make the GUI look quite different though. + + Image tiling + + Controls might be given sets of images used as tiling to draw + themselves rather than using the standard line drawing and + color fill mechanisms. + + Interface style + + A theme might supply a set of interface style keys for various + controls, defining how those controls should behave subject to + the limitation of the range of behaviors coded into the GUI + library. + + Method override + + A theme might actually provide code, in the form of a subclass + of [GSTheme] such that drawing methods have completely custom + behavior. + + + +
+ + + */ #ifndef _GNUstep_H_GSTheme #define _GNUstep_H_GSTheme +#include #include // For gradient types #include "AppKit/NSButtonCell.h" +#if OS_API_VERSION(GS_API_NONE,GS_API_NONE) @class NSBundle; @class NSColor; @class GSDrawTiles; @@ -280,4 +386,5 @@ withRepeatedImage: (NSImage*)image flipped: (BOOL)flipped; @end +#endif /* OS_API_VERSION */ #endif /* _GNUstep_H_GSTheme */ diff --git a/Source/NSColor.m b/Source/NSColor.m index 35a2286ca..330a5aec0 100644 --- a/Source/NSColor.m +++ b/Source/NSColor.m @@ -235,7 +235,7 @@ void initSystemColors(void) //black, @"windowFrameTextColor", nil]; - systemColors = [NSColorList colorListNamed: @"System"]; + systemColors = RETAIN([NSColorList colorListNamed: @"System"]); defaultSystemColors = [[NSColorList alloc] initWithName: @"System"]; [NSColorList _setDefaultSystemColorList: defaultSystemColors]; if (systemColors == nil)