MyFrame(1)               AfterStep X11 window manager               MyFrame(1)



NAME
       MyFrame - defines how AfterStep should construct window's frame




CONFIGURATION OPTIONS
       AllowBorder

              Denotes that beveled borders should be drawn around the window
              frame and titlebar. This is on by default, so this option is
              only useful in combination with inheriting previously defined
              window frames.

              See Also: Inherit MyFrame for details.



       CondenseTitlebar Left|Right|Center

              Allows titlebars to be smaller then the size of the window. The
              parameter defines the Alignment of the whole titlebar.

              See Also: Alignment flags for further details.



       Corner [ SouthEast | SouthWest | NorthEast | NorthWest ]  "pixmap_name"

              Specifies the corner of the window frame to be decorated and the
              pixmap to be used.



       CornerAlign

              FIXME: add proper description here.

              See Also: Alignment flags for further details.



       CornerBevel Bottom|Extra|NoInline|NoOutline|none|Left|Right|Top

              Sets the default bevel of a window s frame corners.

              If you need different bevels for the different window states,
              use CornerFocusedBevel, CornerUnfocusedBevel, CornerStickyBevel

              See Also: Bevel flags for further details.



       CornerFBevel

              Alias for CornerFocusedBevel.

              See Also: Bevel flags for further details.



       CornerFocusedBevel Bottom|Extra|NoInline|NoOutline|none|Left|Right|Top

              Sets the bevel of the window s frame corners while window is in
              focused state.

              If this is not used, values set with CornerBevel will be used.

              See Also: Bevel flags for further details.



       CornerSBevel

              Alias for CornerStickyBevel.

              See Also: Bevel flags for further details.



       CornerSize NorthEast|SouthEast|NorthWest|SouthWest|Any WIDTHxHEIGHT

              FIXME: add proper description here.



       CornerStickyBevel NorthEast|SouthEast|NorthWest|SouthWest|Any
       None|[Left,Top,Right,Bottom,Extra,NoOutline]

              Sets the bevel of the window s frame corners while window is in
              sticky state. This overwrites any value set with CornerBevel.

              If this is not used, values set with CornerBevel will be used.

              See Also: Bevel flags for further details.



       CornerUBevel

              Alias for CornerUnfocusedBevel.

              See Also: Bevel flags for further details.



       CornerUnfocusedBevel
       Bottom|Extra|NoInline|NoOutline|none|Left|Right|Top

              Sets the bevel of the window s frame corners while window is in
              unfocused state.

              If this is not used, values set with CornerBevel will be used.

              See Also: Bevel flags for further details.



       East "pixmap_name"

              Specifies the pixmap to be displayed in the right border of the
              window frame, if DecorateFrames is set.



       FrameFStyle MyStyle

              Alias for FrameFocusedStyle.



       FrameFocusedStyle MyStyle

              Defines the MyStyle to apply to the window frame if window is in
              focused state.



       FrameSStyle MyStyle

              Alias for FrameStickyStyle.



       FrameStickyStyle MyStyle

              Defines the MyStyle to apply to the window frame if window is in
              sticky state.



       FrameUStyle MyStyle

              Alias for FrameUnfocusedStyle.



       FrameUnfocusedStyle MyStyle

              Defines the MyStyle to apply to the window frame if window is in
              unfocused state.



       Inherit frame_name

              Specifies a MyFrame to inherit options from. Options from
              frame_name will override previously specified options for this
              frame. Inherit is a good way to save memory and network
              bandwidth if the same BackPixmap is used for several frames, as
              the pixmap will only be loaded for the inherited frame.



       InheritDefaults

              FIXME: add proper description here.



       LeftBtnAlign

              Defines the alignment of the left buttons in the titlebar.

              See Also: Look Alignment flags for further details.



       LeftBtnBackAlign

              Defines the alignment of the background of the left buttons.

              See Also: Alignment flags for further details.




       LeftBtnBackground

              Defines the background to be used for the left buttons.



       LeftSpacerBackAlign

              Defines the alignment of the background of the (by default)
              leftmost spacer of the titlebar.

              See Also: Alignment flags for further details.




       LeftSpacerBackground

              Defines the background to be used for the (by default) leftmost
              spacer of the titlebar.

              See Also: Titlebar Layout for further details.



       LeftTitleSpacerBackAlign

              Defines the alignment of the background of the (by default)
              inner spacer, left of the window title.

              See Also: Alignment flags for further details.




       LeftTitleSpacerBackground

              Defines the background of the (by default) inner spacer, left of
              the window title.



       LeftTitlebarLayout [Buttons] | [Spacer] | [TitleSpacer]

              Defines the order of the elements in the titlebar left of the
              window title, where default is Spacer - Buttons - TitleSpacer.

              See Also: Titlebar Layout Flags for further details.



       MyFrame " frame_name "


                frame_option


       ~MyFrame

              Specifies the beginning of a frame definition. The frame can be
              referred to later by frame_name . ~MyFrame ends a frame
              definition.



       NoBorder

              Denotes that beveled borders should not be drawn around the
              window frame and titlebar.



       NoCorner

              FIXME: add proper description here.



       NoSide

              FIXME: add proper description here.



       North "pixmap_name"

              Specifies the pixmap to be displayed in the top border of the
              window frame, if DecorateFrames is set.



       NorthEast "pixmap_name"

              Specifies the pixmap to be displayed in the top right corner of
              the window frame, if DecorateFrames is set.



       NorthWest "pixmap_name"

              Specifies the pixmap to be displayed in the top left corner of
              the window frame, if DecorateFrames is set.



       RightBtnAlign

              Defines the alignment of the right buttons in the titlebar.

              See Also: Look Alignment flags for further details.



       RightBtnBackAlign

              Defines the alignment of the background of the right buttons.

              See Also: Alignment flags for further details.




       RightBtnBackground

              Defines the background to be used for the right buttons.



       RightSpacerBackAlign

              Defines the alignment of the background of the (by default)
              rightmost spacer of the titlebar.

              See Also: Alignment flags for further details.




       RightSpacerBackground

              Defines the background to be used for the (by default) rightmost
              spacer of the titlebar.

              See Also: Titlebar Layout for further details.



       RightTitleSpacerBackAlign

              Defines the alignment of the background of the (by default)
              inner spacer, right of the window title.

              See Also: Alignment flags for further details.




       RightTitleSpacerBackground

              Defines the background of the (by default) inner spacer, right
              of the window title.



       RightTitlebarLayout [Buttons] | [Spacer] | [TitleSpacer]

              Defines the order of the elements in the titlebar left of the
              window title, where default is TitleSpacer, Buttons, Spacer.

              See Also: Titlebar Layout Flags for further details.



       Side [ South | North | East | West ]  "pixmap_name"

              Specifies the side of the window frame to be decorated and the
              pixmap to be used.



       SideAlign

              FIXME: add proper description here.

              See Also: Alignment flags for further details.



       SideBevel Bottom|Extra|NoInline|NoOutline|none|Left|Right|Top

              Sets the default bevel of a window s frame sides.

              If you need different bevels for the different window states,
              use SideFocusedBevel, SideUnfocusedBevel, SideStickyBevel

              See Also: Bevel flags for further details.



       SideFBevel

              Alias for SideFocusedBevel.

              See Also: Bevel flags for further details.



       SideFocusedBevel Bottom|Extra|NoInline|NoOutline|none|Left|Right|Top

              Sets the bevel of the window s frame sides while window is in
              focused state.

              If this is not used, values set with SideBevel will be used.

              See Also: Bevel flags for further details.



       SideSBevel

              Alias for SideStickyBevel.

              See Also: Bevel flags for further details.



       SideSize

              FIXME: add proper description here.



       SideSlicing

              FIXME: add proper description here.



       SideStickyBevel Bottom|Extra|NoInline|NoOutline|none|Left|Right|Top

              Sets the bevel of the window s frame sides while window is in
              sticky state.

              If this is not used, values set with SideBevel will be used.

              See Also: Bevel flags for further details.



       SideUBevel

              Alias for SideUnfocusedBevel.

              See Also: Bevel flags for further details.



       SideUnfocusedBevel Bottom|Extra|NoInline|NoOutline|none|Left|Right|Top

              Sets the bevel of the window s frame sides while window is in
              unfocused state.

              If this is not used, values set with SideBevel will be used.

              See Also: Bevel flags for further details.



       South "pixmap_name"

              Specifies the pixmap to be displayed in the bottom border of the
              window frame, if DecorateFrames is set.



       SouthEast "pixmap_name"

              Specifies the pixmap to be displayed in the bottom right corner
              of the window frame, if DecorateFrames is set.



       SouthWest "pixmap_name"

              Specifies the pixmap to be displayed in the bottom left corner
              of the window frame, if DecorateFrames is set.



       TitleAlign

              FIXME: add proper description here.

              See Also: Alignment flags for further details.



       TitleBackground

              Defines the background to be used for the window title.



       TitleBackgroundAlign

              Defines the alignment of the background of the window title.

              See Also: Alignment flags for further details.




       TitleBevel

              Determines the bevel to be drawn around the title bar. If you
              wish to have different bevels, depending on the window s state,
              use TitleFocusedBevel, TitleUnfocusedBevel or TitleStickyBevel.

              See Also: Bevel flags for further details.



       TitleCompositionMethod

              FIXME: add proper description here.



       TitleFBevel

              Alias for TitleFocusedBevel.

              See Also: Bevel flags for further details.



       TitleFCompositionMethod

              Alias for TitleFocusedCompositionMethod.



       TitleFHue

              Alias for TitleFocusedHue.



       TitleFSaturation

              Alias for TitleFocusedSaturation.



       TitleFStyle MyStyle

              Alias for TitleFocusedStyle.



       TitleFocusedBevel

              Determines the bevel to be drawn around the title bar if window
              is in focused state.

              See Also: Bevel flags for further details.



       TitleFocusedCompositionMethod

              FIXME: add proper description here.



       TitleFocusedHue

              FIXME: add proper description here.



       TitleFocusedSaturation

              FIXME: add proper description here.



       TitleFocusedStyle MyStyle

              MyStyle to apply to titlebar if window is in focused state.



       TitleHSpacing value

              Defines the space in pixel to insert between window title and
              the buttons/spacers. Please note that CondenseTitlebar is
              influencing the behaviour of this option.



       TitleSBevel

              Alias for TitleStickyBevel.

              See Also: Bevel flags for further details.



       TitleSCompositionMethod

              Alias for TitleStickyCompositionMethod.



       TitleSHue

              Alias for TitleStickyHue.



       TitleSSaturation

              Alias for TitleStickySaturation.



       TitleSStyle MyStyle

              Alias for TitleStickyStyle.



       TitleStickyBevel

              Determines the bevel to be drawn around the title bar if window
              is in unfocused state.

              See Also: Bevel flags for further details.



       TitleStickyCompositionMethod

              FIXME: add proper description here.



       TitleStickyHue

              FIXME: add proper description here.



       TitleStickySaturation

              FIXME: add proper description here.



       TitleStickyStyle MyStyle

              MyStyle to apply to titlebar if window is in sticky state.



       TitleUBevel

              Alias for TitleUnfocusedBevel.

              See Also: Bevel flags for further details.



       TitleUCompositionMethod

              Alias for TitleUnfocusedCompositionMethod.



       TitleUHue

              Alias for TitleUnfocusedHue.



       TitleUSaturation

              Alias for TitleUnfocusedSaturation.



       TitleUStyle MyStyle

              Alias for TitleUnfocusedStyle.



       TitleUnfocusedBevel

              Determines the bevel to be drawn around the title bar if window
              is in unfocused state.

              See Also: Bevel flags for further details.



       TitleUnfocusedCompositionMethod

              FIXME: add proper description here.



       TitleUnfocusedHue

              FIXME: add proper description here.



       TitleUnfocusedSaturation

              FIXME: add proper description here.



       TitleUnfocusedStyle MyStyle

              MyStyle to apply to titlebar if window is in unfocused state.



       TitleVSpacing value





       West "pixmap_name"

              Specifies the pixmap to be displayed in the left border of the
              window frame, if DecorateFrames is set.



       Window frame decorations (aka MyFrame)

              Each window is surrounded by so-called frame decoration. each
              frame decoration could be built from 9 TBars:

              1) Main Titlebar with icons on left, label in the middle and
              icons on right. Label may also have special underlying image -
              so called Title Background. Ordering of this elements is set by
              TitleButtonOrder setting ( see below ).

              2) 4 frame sides. Each of this have fixed width that is
              determined by SideSize setting or image size if SideSize is
              ommited. Second dimension of the TBar changes to match the size
              of the window.

              3) 4 frame corners. Each of this have both fixed width and
              height, as determined by CornerSize setting or image size.

              Each of above elements is rendered by generating background
              using respective MyStyle, and then overlaying images/buttons and
              text on top of it. Default overlaying is done using composition
              method alpha-blend. In case of main Titlebar that could be
              changed. Bevel is then drawn on top of the image as specified in
              respective setting.

              MyFrame allows different MyStyles to be used for titlebar and
              frame decorations. If any of those are ommited - default setting
              from FWindowStyle/UWindowStyle/SWindowStyle will be used.

              Important: If you use semi-transparent images for frame sides -
              they will be overlayed on top of MyStyle generated background,
              so if you want it to be overlayed over root background - you
              should use MyStyle with BackPixmap set to 129 or 149.

              Also note that unless you use MYStyle with BackPixmap 126 and
              125 - frame decorations will not be shaped. Likewise if you want
              frame part to have only the shape of the image, you specified,
              with no background at all - use MyStyle with BackPixmap set like
              so :

              BackPixmap 126 empty.xpm

              Where empty.xpm is 1x1 completely transparent image (supplied as
              desktop/icons/common/empty.xpm ).

              To identify side/corner it is possible to use abbreviations,
              such as: N, NW, SW, etc.

              All the CompositionMethod settings must have one of the
              BackPixmap types from MyStyles ( ie 130-143 )

              Align setting may have different meaning/capabilities for
              different items. When applied to text - it simply aligns text to
              sides mentioned. When applied to image - such as title
              background or frame side pixmap - it also specifies if image
              should be tiled, scaled or left same size. Make sure that you
              use HTiled,VTiled or HScaled,VScaled for frame sides - otherwise
              images on they will not be resized to match window size (this is
              also a feature :).

              To center item specify Align to include both sides. For example
              :

              Align Left,Right

              will center item horizontally.

              Note that TitleBackground option allows you to specify an image
              to be used under titlebar label in addition to the MyStyle. This
              was done for better shaped titlebars. You may have MyStyle to be
              completely transparent shape, while TitleBackground some
              non-transparent image, and that will provide better visibility
              for the titlebar text.

              MyFrame "name"
                      Inherit     "name"]
                  #traditional form :
                      [North       ]      [East        ]
                      [South       ]      [West        ]
                      [NorthEast   ]
                      [NorthWest   ]
                      [SouthEast   ]      [SouthWest   ]
                  #alternative form :      [Side
              North|South|East|West|Any []]      if pixmap is ommited - empty
              bevel will be drawn
                      [NoSide      North|South|East|West|Any]
                      [Corner      NorthEast|SouthEast|NorthWest|SouthWest|Any
              ]      if pixmap is ommited - empty bevel will be drawn
                      [NoCorner
              NorthEast|SouthEast|NorthWest|SouthWest|Any]
                  #new settings :
                      [TitleUnfocusedStyle   ]
                      [TitleFocusedStyle     ]
                      [TitleStickyStyle      ]
                      [FrameUnfocusedStyle   ]
                      [FrameFocusedStyle     ]
                      [FrameStickyStyle      ]
                      [TitleBackground       ]          gets overlayed over
              background and under the text
                      [LeftBtnBackground     ]          gets overlayed over
              background and under the left block of buttons
                      [LeftSpacerBackground  ]          gets overlayed over
              background between left block of buttons and text label
                      [RightSpacerBackground ]          gets overlayed over
              background between right block of buttons and text label
                      [RightBtnBackground    ]          gets overlayed over
              background and under the right block of buttons

                  #additional attributes :      [SideSize
              North|South|East|West|Any





3rd Berkeley Distribution     AfterStep v.2.2.12                    MyFrame(1)
