Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
MyStyle(1)		 AfterStep X11 window manager		    MyStyle(1)

NAME
       MyStyle -  defines  combination of color, font, style, background to be
       used together

CONFIGURATION OPTIONS
       BackColor color

	      Specifies	the background color associated	with this style. color
	      is  a  color definition in one of	the color formats supported by
	      AfterStep.

	      BackColor	is also	used to	calculate bevel	colors used to draw  a
	      border around a widget.

       BackGradient type  from	to

	      Specifies	that a gradient	should be used as a background instead
	      of a solid color.	The gradient colors start at from and  end  at
	      to  .  from  and to are color definition in one of the supported
	      color formats . If gradient includes at  least  one  transparent
	      color  (	alpha value set	to be below FF ), gradient will	be al-
	      pha-blended over the root	background image. type can be 1, 2, 3,
	      4, or 5:

	      1:  Wharf-style diagonal gradient	2: Horizontal from top to bot-
	      tom 3: Horizontal	from top/bottom	to  center  4:	Vertical  from
	      left  to right 5:	Vertical from left/right to center 6: Top-Left
	      to Bottom	Right diagonal	(  same	 as  1	)  7:  Bottom-Left  to
	      Top-Right	 diagonal  8:  Vertical	Top to Bottom (	same as	2 ) 9:
	      Horizontal Left to Right ( same as 4 )

       BackMultiGradient type  offset1	color1 ... offsetN  colorN

	      Specifies	that a gradient	should be used as a background instead
	      of a solid color.	The gradient colors start at color1 and	end at
	      colorN . Each color has an offset	associated with	it. The	offset
	      is a number between 0.0 and 1.0, and specifies where in the gra-
	      dient the	colors are to be placed. The colors are	in one of  the
	      color  formats  supported	by AfterStep. At least two colors must
	      be given.	If gradient includes at	least one transparent color  (
	      alpha value set to be below FF ),	gradient will be alpha-blended
	      over the root background image. The offsets  are	non-decreasing
	      numbers  between 0.0 and 1.0. If the first offset	is not 0.0, it
	      will be set to 0.0. If the last offset is	not 1.0,  it  will  be
	      set to 1.0. type may be any of the following:

	      6: Top-Left to Bottom Right diagonal 7: Bottom-Left to Top-Right
	      diagonal 8: Vertical Top to Bottom 9: Horizontal Left to Right

       BackPixmap type	pixmap_name|color_name

	      Specifies	that a pixmap should be	used as	a  background  instead
	      of  a  solid  color. This	option has two forms, depending	on the
	      value of type :

	      If type is 125, 126, 127,	128, 130-144, 150-164 -	the second pa-
	      rameter, pixmap_name must	be the name of an image	file which can
	      be found in PixmapPath .

	      If type is 129 or	149 the	root pixmap (desktop background)  will
	      be  used,	and the	optional second	parameter must be a color with
	      which the	root pixmap will be shaded/tinted.

	      Depending	on the value of	type AfterStep will render  pixmap  in
	      many different ways :

       125    Image  is	 SCALED	 to the	size of	the widget, and	its opacity is
	      used to set the shape of the widget/window decoration, achieving
	      non-rectangular window effect.

       126    Image  is	 TILED	to  the	size of	the widget, and	its opacity is
	      used to set the shape of the widget/window decoration, achieving
	      non-rectangular window effect.

       127    Image is SCALED to the size of the widget.

       128    Image is Tiled to	the size of the	image.

       129    Underlying  desktop  background  is tinted/shaded	with the color
	      specified	with the second	parameter.

       130    Underlying desktop background is combined	with tiled image,  us-
	      ing "allanon" method - taking average of pixel values.

       131    Underlying desktop background is alpha-blended with tiled	image.

       132    Underlying  desktop  background  is tinted using pixel values of
	      the tiled	image, as a tint values	on per-pixel basis.

       133    Each pixel of underlying desktop background has value  of	 tiled
	      image's pixel added to it.

       134    Each  pixel  of underlying desktop background has	value of tiled
	      image's pixel subtracted from it.

       135    Result consists of pixels	representing absolute value of differ-
	      ence between underlying desktop background and tiled image.

       136    Underlying  desktop  background  is darkened using luminocity of
	      the tiled	image's	pixels.

       137    Underlying desktop background is lightened using	luminocity  of
	      the tiled	image's	pixels.

       138    Underlying desktop background is "screened" by the tiled image.

       139    Underlying desktop background is "overlayed" by the tiled	image.

       140    Underlying  desktop background's hue is substituted with the hue
	      of the tiled image.

       141    Underlying desktop background's saturation is  substituted  with
	      the saturation of	the tiled image.

       142    Underlying  desktop  background's	 value	(in HSV	colorspace) is
	      substituted with the value of the	tiled image.

       143    Underlying desktop background is "colorized" by the tiled	image.

       144    Underlying desktop background is "dissipated" by the  tiled  im-
	      age.

       149    Underlying  desktop  background  is tinted/shaded	with the color
	      specified	with the second	parameter. It differs from 129 so that
	      desktop  background  could  be  both darkened and	brightened. If
	      tint color channel is greater the	7F (127	decimal)  -  then  re-
	      spective channel of background will be brightened.

       150 - 164
	      Same as 130-144 but specified image is scaled to the size	of the
	      widget.

       BlurSize

	      FIXME: add proper	description here.

       DrawTextBackground [ 0|1	]

	      Specifies	that the area behind text drawn	in this	 style	should
	      be cleared to BackColor .	The argument is	optional. If the argu-
	      ment is 0, this option is	turned off; if it  is  omitted	or  is
	      nonzero, the option is turned on.

       Font font

	      Specifies	the font associated with this style. font copuld beei-
	      ther a standard X11 font definition, or a	filename of the	 True-
	      Type  font  that could be	found in FontPath. To specify the size
	      of the TrueType font - use format	like that : FontName.ttf-Size.

	      Example :
		   Font	 DefaultSans.ttf-14

       ForeColor color

	      Specifies	the text color associated with this  style.  color  is
	      color definition in one of the color formats supported by	After-
	      Step.

       Inherit " style_name "

	      Specifies	a  MyStyle  to	inherit	 options  from.	 Options  from
	      style_name  will	override previously specified options for this
	      style. Inherit is	a good way to save memory  and	network	 band-
	      width  if	the same BackPixmap is used for	several	styles,	as the
	      pixmap will only be loaded for the inherited style.

       MyStyle " style_name "

		style_option

       ~MyStyle

	      Specifies	the beginning of a look	style  definition.  The	 style
	      can  be  referred	 to later by style_name	. ~MyStyle ends	a look
	      style definition.

       Overlay

	      FIXME: add proper	description here.

       SliceXEnd val

	      When used	with scalable BackPixmap it will make image sliced in-
	      stead  scaled.  Which  means  that  its  borders will remain un-
	      changed, but center part will get	tiled  to  fill	 empty	space.
	      SliceXEnd	is the left edge of the	right border.

       SliceXStart val

	      When used	with scalable BackPixmap it will make image sliced in-
	      stead scaled. Which means	 that  its  borders  will  remain  un-
	      changed,	but  center  part  will	get tiled to fill empty	space.
	      SliceXStart is the width of the left border.

       SliceYEnd val

	      When used	with scalable BackPixmap it will make image sliced in-
	      stead  scaled.  Which  means  that  its  borders will remain un-
	      changed, but center part will get	tiled  to  fill	 empty	space.
	      SliceYEnd	is the top edge	of the bottom border.

       SliceYStart val

	      When used	with scalable BackPixmap it will make image sliced in-
	      stead scaled. Which means	 that  its  borders  will  remain  un-
	      changed,	but  center  part  will	get tiled to fill empty	space.
	      SliceYStart is the height	of the top border.

       TextStyle style

	      Specifies	the text style associated with this style.  style  can
	      be 0, 1, or 2:

	      0: normal	text 1:	embossed 3D text 2: sunken 3D text 3: text has
	      shade above the text 4: text has shade below the text  5:	 thick
	      embossed	3D  text  6:  thick sunken 3D text 7: text is outlined
	      with contrasting color on	upper edge of a	 glyph.	  8:  text  is
	      outlined	with  contrasting color	on bottom edge of a glyph.  9:
	      text is outlined with contrasting	color all around a glyph.

DESCRIPTION
       MyStyle 's are the means	to define how widgets (menu items,  titlebars,
       wharf  buttons,	Pager  desktops, etc. )	should be rendered. It defines
       widget's	background (solid color, gradient, textured image and/or semi-
       transparent texture), shape - making widget non-rectangular, text font,
       text 3D style, widget's border bevel colors.

       All the GUI elements are	rendered using consistent  approach  in	 every
       module  and  every  part	 of  the AfterStep. Interface is build from so
       called TBars. TBar is rectangular area that may be focused(hilited)  or
       unfocused  and  pressed or unpressed.  TBAR STRUCTURE Each TBar has the
       following structure :

       - the background	of the TBar, which is defined by MyStyle and state  of
       the  bar	 -  there are two MyStyles assigned to each TBar - one for fo-
       cused and one for unfocused state.

       - tiles of the TBar. Tiles are smaller features that gets arranged  in-
       side  the  bar  according  to  its size,	alignment, position and	order.
       Tiles could be static icons ( cannot be pressed ); blocks of buttons  -
       each  having  two shapes	- pressed and normal; Text labels; Empty space
       tiles. There could be upto 256 tiles, each residing on one of the cells
       in  8x8	grid. Several tiles could reside in single cell, in which case
       they get	superimposed on	top of each other.

       - bevel of the TBar. When TBar is rendered all of its tiles are	super-
       imposed	on  top	 of its	background, and	resulting image	will have a 3D
       bevel drawn on it, using	colors from same MyStyle  as  used  for	 back-
       ground.	Bevel  could be	switched off partially or entirely. Respective
       configuration options has been added where appropriate.	When  TBar  is
       pressed	- its bevel is inverted.  TBAR RENDERING When TBar is rendered
       all of its elements gets	superimposed on	top of each other using	one of
       13 blending methods supported by	libAfterImage, with default being sim-
       ple alphablending. See MyFrame configuration for	more details. This  is
       refrred to as "Composition Method".

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

NAME | CONFIGURATION OPTIONS | DESCRIPTION

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=MyStyle&sektion=1x&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help