Dock Styles

From Docky
Jump to: navigation, search

Types:

<enabled>           = Yes | True  | Enabled
<disabled>          = No  | False | Disabled | None
<bool>              = <enabled> | <disabled>
 
<int>               = positive or negative integer
 
<point>             = (x, y)
 
<percent>           = decimal value from 0.0 to 1.0
 
<color>             = (r, g, b, a)
<optional_color>    = <color> | <disabled>
 
<gradient_name>     = the name of a defined gradient
<optional_gradient> = <gradient_name> | <disabled>
 
<dockstyle>         = the name of another, existing .dockstyle (no path and no file extension)
 
<filename>          = any filename, no path (files must be in same directory as the .dockstyle definition)


Style format:

# you can have comments!
Name        = Example
Author      = Docky
Description = An example of everything you can do!
Extends     = <dockstyle>
 
 
# if item reflections show on 3d docks
Reflections          = <bool>
# percent to tilt the dock when in 3d mode
Tilt3d               = <percent>
# how much (in pixels) of the edges to 'tilt in' on the 3d background
EdgeBuffer3d         = <int>
 
# the spacing on the ends of the dock between the dock border and the nearest item
DockWidthBuffer      = <int>
# the spacing between items, as a percent of the current Icon Size
ItemWidthBuffer      = <percent>
 
# how long the glow indicator shows on urgent windows with dock hidden
GlowTime             = <int>
# how long (in ms) a single pulse of the glow indicator takes
PulseTime            = <int>
 
# the hue offset of the urgent indicator
UrgentHue            = <int>
# the size of the normal indicators
NormalIndicatorSize  = <int>
# the size of the urgent indicators
UrgentIndicatorSize  = <int>
 
# how long (in ms) to slide the dock in/out when hiding
SlideTime            = <int>
 
# how long (in ms) to 'bounce' an icon
BounceTime           = <int>
# the height (in pixels) to 'bounce' an icon when urgent is set on it
UrgentBounceHeight   = <int>
# the height (in pixels) to 'bounce' an icon when launching
LaunchBounceHeight   = <int>
 
# the time (in ms) for most dock animations
BaseAnimationTime    = <int>
 
# the time (in ms) for the panel toggle animation
PanelAnimationTime   = <int>
 
# the time (in ms) for the painter show/hide animation
PainterAnimationTime = <int>
 
# the size of the selected dock glow in preferences
GlowSize             = <int>
 
 
#
# Gradients
#
 
# linear gradients!
gradient <gradient_name>
{
	start = <point>
	end   = <point>
	stop  = <percent> : <color>
	stop  = <percent> : <color>
}
 
# radial gradients!
gradient <gradient_name>
{
	center = <point>
	stop   = <percent> : <color>
	stop   = <percent> : <color>
}
 
 
#
# Styles
#
 
# 2d dock style
style Dock
{
	# line thickness of each stroke
	thickness        = <int>
	# roundness of the top and bottom curved corners
	roundness        = <int>
	# roundness of the top curved corners
	top_roundness    = <int>
	# roundness of the bottom curved corners
	bottom_roundness = <int>
	# color of the inner stroke line
	inner_stroke     = <optional_color>
	# a gradient to draw the inner stroke line, can appear multiple times (applied in order of appearance)
	inner_gradient   = <optional_gradient_name>
	# color of the outer stroke line
	outer_stroke     = <optional_color>
	# a gradient to draw the outer stroke line, can appear multiple times (applied in order of appearance)
	outer_gradient   = <optional_gradient_name>
	# color to fill the area
	fill             = <optional_color>
	# a gradient to fill the area, can appear multiple times (applied in order of appearance)
	fill_gradient    = <optional_gradient_name>
	# image to fill the area
	fill_image       = <filename>
	# how to draw the fill image, once in top-left, tiled, scaled
	fill_style       = normal | tile | scale | arscale
	normal_text      = <color>
	disabled_text    = <color>
}
 
# 3d dock style
style 3dDock = Dock
{
	fill             = <optional_color>
	inner_stroke     = <optional_color>
	outer_stroke     = <optional_color>
	fill_gradient    = <optional_gradient_name>
	inner_gradient   = <optional_gradient_name>
	outer_gradient   = <optional_gradient_name>
	fill_image       = <filename>
	fill_style       = normal | tile | scale | arscale
	thickness        = <int>
	roundness        = <int>
	top_roundness    = <int>
	bottom_roundness = <int>
	normal_text      = <color>
	disabled_text    = <color>
}
 
# painter style
style Painter = Dock
{
	fill             = <optional_color>
	inner_stroke     = <optional_color>
	outer_stroke     = <optional_color>
	fill_gradient    = <optional_gradient_name>
	inner_gradient   = <optional_gradient_name>
	outer_gradient   = <optional_gradient_name>
	fill_image       = <filename>
	fill_style       = normal | tile | scale | arscale
	thickness        = <int>
	roundness        = <int>
	top_roundness    = <int>
	bottom_roundness = <int>
	normal_text      = <color>
	disabled_text    = <color>
}
 
# menu style
style Menu = Dock
{
	fill             = <optional_color>
	inner_stroke     = <optional_color>
	outer_stroke     = <optional_color>
	fill_gradient    = <optional_gradient_name>
	inner_gradient   = <optional_gradient_name>
	outer_gradient   = <optional_gradient_name>
	fill_image       = <filename>
	fill_style       = normal | tile | scale | arscale
	thickness        = <int>
	roundness        = <int>
	top_roundness    = <int>
	bottom_roundness = <int>
	normal_text      = <color>
	disabled_text    = <color>
	hover_text       = <color>
}
 
# tooltip style
style Tooltip = Menu
{
	fill             = <optional_color>
	inner_stroke     = <optional_color>
	outer_stroke     = <optional_color>
	fill_gradient    = <optional_gradient_name>
	inner_gradient   = <optional_gradient_name>
	outer_gradient   = <optional_gradient_name>
	fill_image       = <filename>
	fill_style       = normal | tile | scale | arscale
	thickness        = <int>
	roundness        = <int>
	top_roundness    = <int>
	bottom_roundness = <int>
	normal_text      = <color>
	disabled_text    = <color>
}
 
# dock and menu separator style
style Separator
{
	inner_stroke     = <color>
	outer_stroke     = <color>
}
 
 
#
# styles for the Calendar Painter
#
 
style CalendarPainter = Painter
{
	normal_text   = <color>
	disabled_text = <color>
}
 
style CalendarPainter.Month = CalendarPainter
{
	disabled_text = <color>
}
 
style CalendarPainter.WeekNumber = CalendarPainter
{
	disabled_text = <color>
}
 
style CalendarPainter.DayName = CalendarPainter
{
	disabled_text = <color>
}
 
 
#
# styles for the digital clock
#
 
style Clock = Dock
{
	normal_text   = <color>
	disabled_text = <color>
}
 
style Clock.AMPM = Clock
{
	normal_text   = <color>
	disabled_text = <color>
}
 
style Clock.Date = Clock
{
	normal_text   = <color>
	disabled_text = <color>
}
 
 
#
# styles for the weather icon
#
 
style Weather = Dock
{
	normal_text   = <color>
	disabled_text = <color>
}
 
 
#
# styles for the weather painter
#
 
style WeatherPainter = Painter
{
	normal_text   = <color>
}
 
style WeatherPainter.DayName = WeatherPainter
{
	disabled_text = <color>
}
 
style WeatherPainter.High = WeatherPainter
{
	normal_text   = <color>
}
 
style WeatherPainter.Low = WeatherPainter
{
	normal_text   = <color>
}
 
style WeatherPainter.Graph = WeatherPainter
{
	inner_stroke  = <optional_color>
	thickness     = <int>
	normal_text   = <color>
	disabled_text = <color>
}