section lookinfo

Optional - contains skin, author & version information

string name
The look's name
string author
The author's name
string date
The date in which the look was released
double version
The look's version number
string description
A short description of the look.
string URL
The appropriate webaddress for the look.

section window

Required - contains the skin window dimensions and global display options

Dimensions:

int width
int height

or

list rect int { x y w h }
note that x & y are not used when giving the skin window dimensions, so most coders will use something like: list rect int { 0 0 250 150 }
int blendflag
Determines whether or not the look window will blend in with the desktop. valid values are:
  • blendflags.Opaque (use this if your look has no per pixel alpha for better speed)
  • blendflags.Alpha (required if you want to blend to desktop)
int alphaBlend
The alpha value used for blending the look window with the desktop. Ranges from 0 to 100, where 0 is full transparency, and 100 means the look window will be opaque.
string windowtext
The look window's title, which will appear in the Taskbar if "Show in Taskbar" is checked. Recommended value: "%_lookname% v%_lookversion%"
bool showtooltips
If true, tooltips will be shown for each sprite in the look. By default, the tooltip's text shall be the sprite's name.
int hovertime
Time elapsed before tooltip appears, in milliseconds. Default is 500.
list tooltipcolor
The fill-color of the tooltip box.
list tooltipfontcolor
The tooltip's font color.

sprite mySprite

defines a new sprite in the skin (name can be anything you desire but no spaces - use underscores if necessary)

bool enabled
Controls if the sprite responds to mouse clicks
bool visible
Controls if the sprite is visible
int layer
The sprite's 2D layer determines the sprite's distance from the viewer, relative to the other sprites.
list rendermap int
Controls the render order in which items are rendered for each sprite. The rendered items constants are:
  • render.Image
  • render.Fill
  • render.Text
  • render.Border
  • render.Erase

	
 	


Default is { render.Image, render.Fill, render.Text, render.Border }
	
	int x
	int y
	int width
	int height
OR
	list rect int { x y w h }
NOTE: list rect will override any x,y,width,height properties set for the sprite.
The image to be displayed inside this sprite. The supported extensions are bmp, png, gif, jpg.
	string image
'source offset' sets the pixel coordinates relative to the top-left corner of the graphics file. Default is the sprite's x and y coordinates. If you want to display the whole image, use:
list srcoff int { 0, 0 }
	list srcoff int { x, y }
Search strings used in function look_getAlbumArtList(), which returns all available album art in the directory in which a track is located. The order in which the search is conducted:
1.	search1
2.	search2
3.	search3
4.	search4
5.	search5
6.	%albumart%"
7.	"%title%"
8.	"%album%"
9.	"cover")
10.	"folder"

For example, using
string search1 "*thumb*"
The search will begin by looking for any file with the word thumb in it.

	string search1
	string search2
	string search3
	string search4
	string search5
The tooltip's text that will be shown when the mouse cursor hovers over the sprite. It may contain TagZ formatted text. Default is the sprite's name. If an empty string, no tooltip will appear.	string tooltip 
Transforms image alpha values by the given percentage [0..100] amount	int alphablend
	string fspec
	string fontname
Note: if you set text and fspec, fspec will override the text
fontstyle constants are predefined in "section fontstyle" as:
fontstyle.Regular - 0
fontstyle.Bold - 1 [DEFAULT]
fontstyle.Italic - 2
fontstyle.BoldItalic - 3
fontstyle.Underline - 4
fontstyle.Strikeout – 8
Combinations of the above are allowed.	int fontstyle
Determines the font's size.	int fontsize
Determines the font's color.	list fontcolor int { A R G B }
Must be specified in order to use a gradient fill	list fontcolor2 int { A R G B}
gradientmode constants are predefined in "section gradientmode" as:
gradientmode.Horizontal 
gradientmode.Vertical
gradientmode.ForwardDiagonal
gradientmode.BackwardDiagonal 	int fontgradientmode
Trim mode for long strings that don't fit display rectangle.
trimming constants are predefined in "section trimming" as:
trimming.None
trimming.Character
trimming.Word
trimming.EllipsisCharacter
trimming.EllipsisWord
trimming.EllipsisPath	int trimming
Controls vertical text alignment
Valid values are:
align.Near


	
align.Center

	

align.Far

	int valign
Controls horizontal text alignment
Valid values are:
align.Near

align.Center

align.Far
	int halign
Controls Specialized text formatting features
textflags constants are predefined in "section textflags" as:

textflags.DirectionRightToLeft 0x00000001
textflags.DirectionVertical 0x00000002
textflags.NoFitBlackBox 0x00000004
textflags.DisplayFormatControl 0x00000020
textflags.NoFontFallback 0x00000400
textflags.MeasureTrailingSpaces 0x00000800
textflags.NoWrap 0x00001000
textflags.LineLimit 0x00002000
textflags.NoClip 0x00004000

Combinations of the above are allowed.	int textflags
texthint constants are predefined in "section texthint" as:
texthint.SystemDefault
texthint.SingleBitPerPixelGridFit
texthint.SingleBitPerPixel
texthint.AntiAliasGridFit
texthint.AntiAlias
texthint.ClearTypeGridFit - Windows XP ignored on all other flavors	int texthint
	list fillcolor int { A R G B }
specify this to use a gradient fill	list fillcolor2 int { A R G B}
gradientmode constants are predefined in "section gradientmode". See fontgradientmode for details. (LINK)	int fillgradientmode




Alpha blending is used in computer graphics to create the effect of transparency. For animations, alpha blending can also be used to gradually fade one image into another. The value of 'alpha' in foo_looks colours ranges from 0 to 255, where 0 represents a fully transparent colour, and 255 represents a fully opaque colour.


For more information about TagZ Formatted Strings, see FB2L->Preferences->Display->Title Formatting->Help.

Custom TAGZ fields - these are added to augment the built in tag support or to provide the "special"
foobar fields
%et%
%eet%
%etm%
%rtm%
%rt%
%rrt%
%_ispaused%
%_isplaying%
%_isstopped%
%_volumedb%
%_volumechange% - 1 if volume was changed in last 2 seconds
%_volume%
%_playlist_number%
%_playlist_name% - name of current playlist
%_lookdllversion% - version of foo_looks .dll
%_lookversion% - version of loaded look
%_lookname% - name of loaded look
SUPPORT "dot" notation such as %sectionname._fspec% or can be applied to current section (except _fspec)
%_istoggled%
%_iskeyfocus%
%_isrollover%
%_isvisible%
%section._value%
//
PLAYLISTFIND SPECIFIC
%_playlistfindhit% - Current hit formatted agains the search formatting from playlist find prefs page
%_playlistfindidx% - The playlist index of the matched item