Creating TWin decorations - Revision history

Blu256: + KDE3

2021-08-24T20:25:26Z

+ KDE3

Blu256: Additional formatting

2021-03-28T15:12:53Z

Additional formatting

Show changes

Blu256: /* Wrapping Things Up */ Added final result illustration

2021-03-28T14:59:11Z

Wrapping Things Up: Added final result illustration

Blu256: /* Adding Buttons */ Added titlebar illustration

2021-03-28T14:57:38Z

Adding Buttons: Added titlebar illustration

Blu256: /* Step 5: The Buttons */ Added illustration

2021-03-28T14:55:33Z

Step 5: The Buttons: Added illustration

Blu256: /* Step 1: Proper planning */ Added window layout pictures

2021-03-28T14:49:49Z

Step 1: Proper planning: Added window layout pictures

Blu256: Added to category Tutorials

2021-03-28T14:39:54Z

Added to category Tutorials

Blu256: Added text with some basic formatting. (TODO: insert images, more formatting)

2021-03-21T10:57:47Z

Added text with some basic formatting. (TODO: insert images, more formatting)

Show changes

@@ Line 1: / Line 1: @@
 [[Category:Tutorials]]
+{{KDE3}}
 This is a HOWTO tutorial which was originally written for KWin3 by David Johnson
 [http://www.usermode.org/docs/kwintheme.html].
+__TOC__
 == General notes ==

@@ Line 700: / Line 700: @@
 The finished product isn't pretty, but it's fully functional. Think of it as your starting point for your own KWin decoration.
+[[File:ExampleDecoration.png]]
 === Tips and Tricks ===

@@ Line 452: / Line 452: @@
 The finished title bar layout will look like this:
+[[File:ExampleTitlebar.png]]
 === Painting the Window ===

@@ Line 303: / Line 303: @@
 }
 </syntaxhighlight>
+[[File:TWinButtonExamplePixmaps.png|right]]
 Finally we paint the button decoration. We do some minor calculations to center the decoration in the button. If this is the menu button, we draw the application icon. Notice that we get this pixmap from the client. If it's any other button, we draw the bitmap decoration.

@@ Line 22: / Line 22: @@
 Before you start working on a new decoration, you should have some idea as to what the finished decoration will look like. All usable window managers will have a title bar containing buttons and a frame which surround the application. There are two classic layouts for window manager decorations, with some minor variations. For lack of standard names, I'll call them the "motif" and "next" layouts.
+[[File:motiflayout.png|frame|right|The Motif Layout]]
-The "motif" layout is the most popular. The title bar and window are surrounded by a thick frame. Sometimes the frame only wraps the left, right and bottom of the window, with the title bar being the top part of the frame.
+[[File:nextlayout.png|frame|right|The NeXT Layout]]
-The "next" layout was first seen, to the best of my knowledge, in the NeXT desktop. It is used by the Windowmaker and Blackbox window managers, as well as several KDE decorations. There is only a titlebar on top and a "handle" on the bottom.
+The '''"motif" layout''' is the most popular. The title bar and window are surrounded by a thick frame. Sometimes the frame only wraps the left, right and bottom of the window, with the title bar being the top part of the frame.
+The '''"next" layout''' was first seen, to the best of my knowledge, in the NeXT desktop. It is used by the Windowmaker and Blackbox window managers, as well as several KDE decorations. There is only a titlebar on top and a "handle" on the bottom.
 The example decoration will use the motif layout because it is traditional. Since this is an example, I'm going to make everything look quite plain with simple lines delineating the parts of the decoration. Think of the example as a template from which to create your own, more aesthetic, decorations.
@@ Line 44: / Line 48: @@
 '''Honor User Preferences:'''
 If users do not like the default behaviors, they will change them. Do not presume to know what is best for the user. For example, people who use custom button positions do so for a reason, and it will only annoy them to disregard their preference. Those that don't will still expect to see the standard button positions.
 == Step 2: Infrastructure ==

← Older revision		Revision as of 14:39, 28 March 2021
Line 1:		Line 1:

			[[Category:Tutorials]]

	This is a HOWTO tutorial which was originally written for KWin3 by David Johnson		This is a HOWTO tutorial which was originally written for KWin3 by David Johnson