man Look () - AfterStep look
NAME
Look - AfterStep look
CONFIGURATION OPTIONS
- IconBox left top right bottom
Specifies a region of the screen in which to place iconified windows. Up to four icon boxes can be defined. If an IconBox is provided, icons will automatically be placed in them, if possible. Otherwise, they will be placed in the upper left corner of the screen. Each time a window is iconified, a new place is found for it, unless the icon has been moved manually. An available space is searched for from left to right, then top to bottom. Icons will not be automatically placed on top of other icons, but they may be placed underneath application windows if StubbornIconPlacement has not been specified. If left or right is negative, then AfterStep will add the screen width to it. If top or bottom is negative, then AfterStep will add the screen height to it. Note that -0 is not parsed as the right or bottom pixel on the screen. Use -1 instead. The IconBox will normally be filled from left to right, then top to bottom. However, if the right edge of the IconBox is closer to the right edge of the screen than the left edge of the IconBox is to the left edge of the screen, then it will be filled from right to left. Similarly for top to bottom. For example, "2 2 -1 -1" will result in an IconBox which fills from right to left, then bottom to top.
- IconsGrowVertically
Specifies that the Iconbox(es) should be filled vertically first.
- MArrowPixmap pixmap_name
Specifies a pixmap to use as the submenu indicator in popup menus.
- MenuPinOn pixmap_name
MenuPinOn is deprecated and AfterStep will reinterpret it, and it will create new TitleButton using last unused TitleButton context. It will then assign PinMenu function to this button. This button will only be shown on titlebars belonging to menu windows. This button behaves just like any other TitleButton - for example you can use TitleButtonOrder to specify where it should go. Problem is you may not know what context AfterStep had choosen for it. The better way would be to explicitely define TitleButton, and assign PinMenu to it in your feel.
- MenuMiniPixmaps minis
Specifies whether mini pixmaps should be included in menus. If minis is 0, mini pixmaps are not included. If minis is 1, mini pixmaps are included. Note that mini pixmaps will not be added to menus until the next time menus are updated. Mini pixmaps can cause AS to take much longer to load over a network.
- TitlebarNoPush
Specifies that the titlebar should not to appear to be "pushed in" when clicked with a mouse button. This is useful to reduce video strain or if textured pixmaps that do not look good "pushed in" are used.
- TitleTextAlign align
Defines how titlebar text should be aligned - Left, Right or Center.
- ResizeMoveGeometry geom
Specifies the location of the resize/move window. If this option is not specified, the move/resize window will be centered on the screen. geom may be any one of the following:
++: upper-left corner -+: upper-right corner +-: lower-left corner --: lower-right corner
- StartMenuSortMode number
Sort start menu entries by... 1=alphabetical order, 0=date
- DrawMenuBorders 0|1|2
Specifies the look of the (start)menu. Using 0 will draw the menu with no border on either the menu label or menu item por- tions. Using 1 will draw a border around each menu label and around the menu item. Using 2 will drawn a border around the menu label and the entire menu item list. The border colors are calculated from the BackColor under MyStyle menu_item of the look.name. The "hilight" (top & left) color is one half lighter than the BackColor color and the "shadow" (bottom & right) is one half darker than the BackColor color. If the BackColor color is black, the color grey is used.
- ButtonSize width height
Specifies the size of iconified windows. Every iconified window button will be exactly width pixels wide and height pixels high. This includes titles drawn at the top, but not the separate title window created by SeparateButtonTitle. If either width or height is less than one, that dimension will not be fixed. The default is ButtonSize 0 0
- ButtonIconSpacing
FIXME: add proper description here.
- ButtonBevel
Specifies the bevel to be drawn around iconified windows.
See Also: Look Bevel flags for further details.
- ButtonAlign
FIXME: add proper description here.
See Also: Look Alignment flags for further details.
- MinipixmapSize x y
Changes the default maximum minipixmap size ( 48x48 ) to a user specified value
- SeparateButtonTitle 0|1
Specifies where iconified window titles should be drawn. If it is 0, the title will be drawn at the top of the icon. If it is 1, the title will be drawn in a separate window at the below the icon. The default value is 1.
- RubberBand
Specifies the RubberBand type to use when moving or resizing non-opaque windows. There are 3 styles: 0: the window is represented as a number of rectangles 1: one rectangle the size of the window 2: one crossed-out rectangle the size of the window.
- DefaultStyle
Specifies the MyStyle to use when no style has been specifically defined for a given situation. Note that if a style named "default" has been defined and DefaultStyle has not, the "default" style will be used as the default.
- FWindowStyle
Specifies the MyStyle to use for the focused window decorations.
- UWindowStyle
Specifies the MyStyle to use for the unfocused window decorations.
- SWindowStyle
Specifies the MyStyle to use for the sticky window decorations.
- MenuItemStyle
Specifies the MyStyle to use for menu items.
- MenuTitleStyle
Specifies the MyStyle to use for menu titles.
- MenuHiliteStyle
Specifies the MyStyle to use for hilighted menu items.
- MenuStippleStyle
Specifies the MyStyle to use for stippled menu items.
- MenuSubItemStyle
AfterStep now includes this new feature: when you select an item from the menu - this item will be marked as recently used, and next time the menu is opened it will show all the recently used items from its SUBMENU. For exmaple you do :
Menu->Applications->rxvt
Next time you open the Main menu, it will display rxvt just under the "Applications" item with some offset.
It looks much better when this subitems are shown with different (smaller ) font. To achive that - specify a MyStyle with asmaller font using the MenuSubItemStyle option in your look file.
This feature could be turned off or altered by using the RecentSubmenuItems option in your feel file: set it to 0 to disable this feature.
- MenuHiTitleStyle
AfterStep now allows you to specify a MyStyle to be used for the titlebar of the currently hilighted menu. AS soon as the menu goes out of focus its titlebar will be rendered using MenuTitleStyle.
- MenuItemCompositionMethod 130-145
This is a funny feature - try it and see how you like different values :) If you use shades of grey for your item text - you may not see any difference for some of this values.
- MenuHiliteCompositionMethod 130-145
This is a funny feature - try it and see how you like different values :) If you use shades of grey for your item text - you may not see any difference for some of this values.
- MenuStippleCompositionMethod 130-145
This is a funny feature - try it and see how you like different values :) If you use shades of grey for your item text - you may not see any difference for some of this values.
- SupportedHints
FIXME: add proper description here.
See Also: Supported hints list for further details.
- DeskBack desk#
Specifies what background to use for desk#. "name" can be either image filename in double-quotes, or the name of background definition (see MyBackground definition for details).
- DefaultFrame
MyFrame to use as default for all windows. Note: if you want a different framing for any window, you need to specify it in the database file using the Frame keyword.
- CursorFore
use with CursorBack setting to adjust color of the mouse cursor.
- CursorBack
use with CursorFore setting to adjust color of the mouse cursor.
- MyStyle
FIXME: add proper description here.
See Also: MyStyle definition for further details.
- MyFrame
FIXME: add proper description here.
See Also: MyFrame definition for further details.
- MyBackground
FIXME: add proper description here.
See Also: MyBackground definition for further details.
- KillBackgroundThreshold size
Here size is the maximum number of pixels in root background image. If image is bigger that this - it will be unloaded from memory when desktop is switched and image is no longer in use. Use it on systems with low memory.
- DontAnimateBackground
disables non-blocking root background changing of full-screen backgrounds, that looks like slow animation. This is recommended for fast machines.
- DontDrawBackground
FIXME: add proper description here.
- Balloons
FIXME: add proper description here.
- TitleButtonBalloons
FIXME: add proper description here.
- BalloonBorderHilite
FIXME: add proper description here.
See Also: Look Bevel flags for further details.
- TitleButtonBalloonBorderHilite None|[Left,Top,Right,Bottom,Extra,NoOutline
Defines bevel to be drawn around balloons - replaces BorderWidth setting.
See Also: Bevel flags for further details.
- BalloonXOffset offset
Specifies the horizontal offset (in pixels) to use when displaying balloons.
- TitleButtonBalloonXOffset offset
Specifies the horizontal offset (in pixels) to use when displaying balloons.
- BalloonYOffset offset
Specifies the vertical offset (in pixels) to use when displaying balloons.
- TitleButtonBalloonYOffset offset
Specifies the horizontal offset (in pixels) to use when displaying balloons.
- BalloonDelay milliseconds
Specifies the period in milliseconds to delay the appearance of the balloon.
- TitleButtonBalloonDelay milliseconds
Determines delay between when balloon is shown and before it disapears.
- BalloonCloseDelay milliseconds
Specifies the period in milliseconds to delay the disappearance of the balloon when leaving window with the mouse.
- TitleButtonBalloonCloseDelay
FIXME: add proper description here.
- BalloonStyle
FIXME: add proper description here.
- TitleButtonBalloonStyle
MyStyle to be used to draw balloon. Note that balloons could be shaped (BackPixmap 125 and 126 ).
- TitleButtonSpacingLeft number
Specifies how much space (in pixels) to put between left buttons and titlebar.
- TitleButtonSpacingRight number
Specifies how much space (in pixels) to put between titlebar and right buttons.
- TitleButtonSpacing
FIXME: add proper description here.
- TitleButtonXOffsetLeft x_offset_val
Determines the distance of the left block of titlebar buttons from the side of the titlebar.
- TitleButtonXOffsetRight x_offset_val
Determines the distance of the right block of titlebar buttons from the side of the titlebar.
- TitleButtonXOffset x_offset_val
Determines the distance of the titlebar buttons from the edge of the titlebar.
- TitleButtonYOffsetLeft y_offset_val
Determines the distance of the left block of titlebar buttons from the top/bottom of the titlebar
- TitleButtonYOffsetRight y_offset_val
Determines the distance of the right block of titlebar buttons from the top/bottom of the titlebar
- TitleButtonYOffset y_offset_val
Determines the distance of the titlebar buttons from the top/bottom of the titlebar
- TitleButtonStyle num
Specifies how much space is put between leftmost and rightmost titlebar buttons, and the edges of the titlebar. If num is 0, there is a two pixel buffer the buttons and the edge. If num is 1, there is no space between the buttons and the edge. If num is 2 , then distance between titlebar edge and titlebuttons is determined by TitleButtonXOffset and TitleButtonYOffset.
- TitleButtonOrder context_sequence
Determines layout of the titlebar. Default is 13579t08642.
- TitleButton button unclicked_image clicked_image
button defines the button location number from 1 to 10 in the following layout: [1] [3] [5] [7] [9] (title) [10] [8] [6] [4] [2].
unclicked_image is the bitmap or pixmap to be used during the static state of the associated buton location.
clicked_image is the bitmap or pixmap to be used during a clicked state of the associated button location.
Frame decoration settings have been greately enhanced. It is now fashioned after MyStyle option and is called MyFrame. It allows for several named structures, with inheritance and ability to assign different structure to different apps using the database.
As mentioned above root background settings has been moved into look - hence MyBackground and Desk back as look options.
MyStyle has far greater number of BackPixmap types reflecting new functionality in libAfterImage.
CompositionMethod setting has been added to different aspects of look.
New options for more flexible placing of titlebar buttons has been added.
Balloons now support both X and Y offset as well as MyStyle instead of simple back and fore colors.