Revision as of 22:27, 10 March 2009 (view source) Chiwou (Talk | contribs) ← Older edit		Revision as of 08:43, 25 October 2020 (view source) 151.210.128.9 (Talk) Newer edit →
(36 intermediate revisions by 6 users not shown)
Line 2:		Line 2:
	{{stub}}		{{stub}}
−	'''foo_uie_panel_splitter''' is an extension for Columns UI that allows you to place objects freely within the foobar2000 window, including panels, text (e.g., track info), and images.	+	Panel Stack Splitter is a ColumnsUI extension for advanced placement and scripting of panels.  It functions as a splitter in the ColumnsUI panel hierarchy (i.e., it can contain other panels).
−	foobar2000 v0.9.5.1+, Columns UI 0.3+	+	= Function and Use =
		+	Panel Stack Splitter is an extension for ColumnsUI which allows for greater control over the arrangement of panels.  Not only can any panel be positioned freely within the Foobar2000 window, but the splitters themselves can be scripted, the panels can be resized using the cursor or by scripted actions, and panels can be hidden and displayed according to your script.  It includes functions which make it easy to create graphical buttons and dynamic layouts.  It can replace any number of more specific panels, such as those intended for displaying album art or track information.
		+
		+	Common uses include the creation of interfaces which reconfigure themselves automatically depending on the window size, panel-switching arrangements, and of course, all manner of window dressing.  It's often used alongside other plugins such as [[Foobar2000:Components 0.9/ELplaylist panel (foo uie elplaylist) | ELPlaylist]] and [[Foobar2000:Components 0.9/WSH panel (foo uie wsh panel)| WSH Panel]] to construct elaborate custom interfaces, but be warned that the results of such efforts are, unlike Foobar2000 itself, not always efficient or stable.
		+
		+	= Authorship =
		+	Panel Splitter was written by '''ssenna''', who is also the author of [[Foobar2000:Components 0.9/ELplaylist panel (foo uie elplaylist) | ELPlaylist]].  Many of the functions are similar and both plug-ins work well together.<!--Columns UI panel to place the splitter
		+	And without borders, or a little over a panel and set the highest possible degree of freedom.
		+	Has been stable or loose?-->
	= Requirements =		= Requirements =
−	* [http://www.foobar2000.org/ foobar2000 v0.9.5.1+]	+	* foo_uie_panel_splitter.dll v0.3.8.3a (2009/12/11)
		+	* [http://www.foobar2000.org/ foobar2000 v0.9.5.2+]
	* [http://yuo.be/columns.php Columns UI 0.3+]		* [http://yuo.be/columns.php Columns UI 0.3+]
		+	= Reference =
		+	The following documentation is an imperfect translation and adaptation from the original Japanese readme.  Until the page has been more thoroughly re-written, expect some confusing passages.
		+	== Introduction ==
		+	After installing the plug-in, in the options dialog under ColumnsUI's Layout tab you'll be able to add a Panel Stack Splitter to your layout and configure it.  Once you've added a Panel Stack Splitter you can also edit it by right-clicking the panel and choosing ''Configure'' from the context menu.  The relationship between Panel Stack Splitters and the resulting layout may initially be confusing.  In theory, one could place all their panels under a single Panel Stack Splitter to achieve any layout, but in practice you will generally want to employ them more like traditional horizontal and vertical splitters, nesting hierarchically.
−	= Read me (translated from the Japanese original) =	+	== Splitter Settings dialog ==
		+	The Splitter Settings dialog has four tabs, ''PanelList, Script, Behavior'' and ''Global variables''.
−	foo_uie_panel_splitter.dll v0.3.6.3 (alpha ver)	+	''PanelList'' shows subordinate panels and allows you to define their names, positions and sizes. ''Script'' allows you to script the Splitter panel itself; this is where you would define buttons, text to display, or scripts which alter the layout or operate invisibly. ''Behavior'' presents options related to how the Splitter is rendered and how it executes scripts, and ''Global variables'' lets you view and delete currently active global variables. <!--Placement of the panel and automatic alignment mode, forced mode is set. Auto-deploy mode, a horizontal (Horizontal) or placed in a vertical direction (Vertical) or choose a place. Forced layout mode that is placed on the force placed on the panel.-->
−	for foobar2000 v0.9.5.1 +, Columns UI0.3 +, WindowsXP +	+
−	Columns UI panel to place the splitter	+	=== PanelList ===
−	And without borders, or a little over a panel and set the highest possible degree of freedom.	+	You can't add subordinate panels from this tab -- for this you must return to the ColumnsUI layout options. But once you've added panels, you can select them from the left box in this tab and define their display parameters at the right.  Note that there is one option on this tab which is for the Splitter itself rather than its children; this is ''Panel placement mode'', which allows you to select horizontal or vertical position.  This parameter is irrelevant for forced layouts.
−	Has been stable or loose?	+
		+	All fields accept numbers as pixel positions and widths by default, though you can switch to percentage values instead when in forced mode.  You can use Titleformatting Script in all of these fields, which is often important for forced layouts if you want them to be resizeable.
		+	; Caption : This allows you to assign a unique name to the panel in question.  In addition to providing a convenient label for the panel for when you're editing, this allows you make direct reference to the panel is scripts later on, for example if you wanted to display, hide or resize it.
		+	; Size : Defines the size of the panel, but only if you are using a non-forced layout.  Size means width when in horizontal panel placement mode and height when in vertical panel placement mode.
		+	; Padding : These values define padding between the edges of the panel's allotted space (''size'') and the actual panel.
		+	; Lock size : This disables the user from resizing the panel using the mouse. Only applies to non-forced layout mode; in forced-layout mode this is already default.  The original documentation provides further details about this option, including a caveat that seems to address the possibility of blurred pixels, but the auto-translation is garbled.<!-- a place without scaling.
		+	** off when the size of each panel to be placed according to the Splitter and the appropriate scaling for size.
		+	** ± 1 to lock the current situation that would blur pixel minutes.
		+	*** So hard to fix, could not fix.-->
		+	; Forced layout : This option allows you to directly determine the position and size of a panel.  Turning it on disables ''Size'' and (by default) padding and makes ''panel placement mode'' irrelevant.  Panels can even overlap, though you generally would only want to do this if you intend to provide a way to switch between them.  Left and Right are measurements from the upper-left (0,0) of the panel.
		+	:* [[Foobar2000:Title Formatting Reference | Title Formatting script]] is enabled and you can use <tt>%_width%</tt> and <tt>%_height%</tt> to call the current width and height of the Splitter itself.
		+	:* If two panels overlap, by default the one that renders in front is determined by the sequence of panels as defined in the ColumnsUI options. ''[?]''
		+	:* '''Example.''' This would always expand the panel to the width of the splitter minus 400 pixels:
		+	Width: $sub(%_width%,400)
		+	:* '''Example.''' This would make the panel always fill the lower half of the available space:
		+	Top: $div(%_height%,2)
		+	Height: $div(%_height%,2)
		+	; Use percentage value : This option makes Panel Splitter interpret the values in Left, Top, Width and Height as percentages of available space instead of pixel measurements.  Thus the second example above could be written as ''Top: 50'' and ''Height: 50''.
		+	; Enable padding settings: This option re-enables the padding values defined for non-forced-layout mode.  Though this may seem redundant when you can simply include the padding in your position and size values, it may be useful for percentage-based layouts.
		+	; Ignore panel size limits : ''This seems to be undocumented'', but allows for sizes lower or higher than default caps. For example, the seekbar will display as 20px high if any value below 20px is entered into the Height field unless this box is checked.
		+	; Hide panel on startup : This rather straight-forward option does precisely what its name indicates.  To later make the panel visible, you would use a script function such as <tt>$showpanel_c</tt>.
		+	<!--If you stacked the panel appears on the front panel as a list of the top panel (But depends on the implementation of the child panel. I have come to the front panel profusely.)
		+	%_width% %_height% in the horizontal width of the Panel Stack Splitter, you can see the vertical width.
		+	Example:
		+	left: $div(%_width%,4)
		+	top: $div(%_height%,4)
		+	width: $div(%_width%,2)
		+	height: $div(%_height%,2)
−	Description	+	Also, Splitter mode to specify a value relative to size.
−	Add and remove panels from the basic layout of the ColumnsUI do.	+	is on the use percentage value is, Splitter percentage for the size of the [0-100] can be specified.
−	They can add from the context menu.	+	use percentage value of setting example:
		+	left: 25
		+	top: 25
		+	width: 50
		+	height: 50
		+	-->
−	Placement of the panel and automatic alignment mode, forced mode is set.	+	=== Script Tab ===
−	Auto-deploy mode, a horizontal (Horizontal) or placed in a vertical direction (Vertical) or choose a place.	+
−	forced layout mode that is placed on the force placed on the panel.	+
		+	titleformat mode on startup: when you start the TitleFormat PerTrack modes.
		+	* now playing TF play that track
		+	* follow cursor on the selected tracks in playlist
		+	* last mode at the end of the previous mode (the switch mode button to save)
−	size: size of the display panel (Horizontal size if horizontal, Vertical Vertical size of it)
−	lock size: a place without scaling.
−	off when the size of each panel to be placed according to the Splitter and the appropriate scaling for size.
−	± 1 to lock the current situation that would blur pixel minutes.
−	-> So hard to fix, could not fix.
−	forced layout: left Top width right under it to force the panel to be placed in the specified range.	+	* title formatting script:
−	(size and auto-scaling is disabled)	+	Titleformat here to describe, and decorative backgrounds. However, the child is on the panel can not be drawn.
−	If you stacked the panel appears on the front panel as a list of the top panel	+	Extended Command Reference
−	(But depends on the implementation of the child panel. I have come to the front panel profusely.)	+	Sensitive argument, or optional, and not implemented.
−	Title Formatting is enabled.	+	Note: Do not waste the space. (Carriage return accepted)
−	% _width%% _height% in the horizontal width of the Panel Stack Splitter, you can see the vertical width.	+
−	Example:	+
−	left: $ div (% _width%, 4)	+
−	top: $ div (% _height%, 4)	+
−	width: $ div (% _width%, 2)	+
−	height: $ div (% _height%, 2)	+
−	Also, Splitter mode to specify a value relative to size.	+	in title formatting script is evaluated,
−	is on the use parsentage value is, Splitter percentage for the size of the [0-100] can be specified.	+	* Today
−	use parsentage value of setting the example on:	+	* Per Track: track and play and play·When the user changes the size of the state changed when paused. Function when the REFRESH button.
−	left: 25	+	* Per Second: second, when a change in the state play in the function when the REFRESH button.
−	top: 25	+
−	width: 50	+
−	height: 50	+
		+	[Note]
		+	* Per Second, especially that not only can handle high-stress functions.
		+	* GDI is recommended that you use the drawing functions.
−	padding: Add a space around the panel.	+	=== Behaviour Tab ===
−	Title Formatting to put the numbers are fixed, so invalid.	+	* use background color: the color specified, the background fill.
−	If the automatic alignment panels, padding can be resized with the mouse as if the border is set.	+	* use image: specify a fixed background image. TitleFormatting is disabled.
−	enable resizable border with on / off can be	+	* pseudo transparent: splitter to simulate a transparent background. (splitter and if you use the nest)
−	caption: The name of the panel, the identifier	+	[Note]
−	use background color: the color specified, the background fill.	+	* ColumnsUI in the panel is to present the panel with the transparent background feature, use background color or use image backgrounds are often not transparent and does not use the panel.
−	use image: specify a fixed background image. TitleFormatting is disabled.	+
−	pseudo transparent: splitter to simulate a transparent background. (splitter and if you use the nest)	+
−	[Note]	+	=== Global variables Tab ===
−	ColumnsUI in the panel is to present the panel with the transparent background feature,	+
−	use background color or use image backgrounds are often not transparent and does not use the panel.	+
		+	== Fields ==
−	titleformat mode on startup: when you start the TitleFormat PerTrack modes.	+	=== %ps_width% ===
−	now playing TF play that track	+	Returns the width of the Splitter
−	follow cursor on the selected tracks in playlist	+
−	last mode at the end of the previous mode (the switch mode button to save)	+
−		+
−	title formatting script:	+	=== %ps_height% ===
−	Titleformat here to describe, and decorative backgrounds. However, the child is on the panel can not be drawn.	+	Returns the height of the Splitter
−	Extended Command Reference	+	=== %ps_tfmode% ===
−	Sensitive argument, or optional, and not implemented.	+	TF mode returns. (Per Track when enabled)
−	Note: Do not waste the space. (Carriage return accepted)	+	* 0 nowplaying mode
		+	* 1 follow cursor mode
−	in title formatting script is evaluated,	+	=== %ps_isplaying% ===
−	Today	+	Whether during playback
−	Per Track: track and play and play・When the user changes the size of the state changed when paused. Function when the REFRESH button.	+
−	Per Second: second, when a change in the state play in the function when the REFRESH button.	+
−	[Note]	+	=== %ps_ispause% ===
−	Per Second, especially that not only can handle high-stress functions.	+	Whether suspended
−	GDI is recommended that you use the drawing functions.	+
−	[Field]	+	=== %ps_foobar2000_path% ===
−	% ps_width%	+	Foobar2000 executable path
−	Returns the width of the Splitter	+
		+	=== %ps_user_profile_path% ===
		+	User profile path
−	% ps_height%	+	=== %ps_playback_order% ===
−	Returns the height of the Splitter	+	Returns the playback order.
		+	However, playback order can not be immediately reflected in the change.(REFRESH commands are required)
		+	=== %ps_track_state% ===
		+	TF mode returns state of the player, whether a track is present or not.
		+	* 0 no error
		+	* 1 no track
		+	* 2 dummy track (for mainly legacy metadb_display_hook API)
−	% ps_tfmode%	+	== Functions ==
−	TF mode returns. (Per Track when enabled)	+
−	0 nowplaying mode	+
−	1 follow cursor mode	+
		+	=== $init_ps_global(name,value) ===
−	% ps_isplaying%	+	Valid only if there is no global variable name specified.
−	Whether during playback	+
−	% ps_ispause%	+	All global variables are shared between each of the TF although the PanelStackSplitter evaluation order is undefined.
−	Whether suspended	+	Persistency = 1 variable is set, $delete_ps_gobal you use will be saved until you delete from the settings dialog.
		+	$Init_ps_global(name,value) is, $if($get_ps_global(name),,$set_ps_global(name,value)) and almost equivalent.
		+	=== $init_ps_global(name,value,persistency) ===
−	% ps_foobar2000_path%	+	Persistency - whether to save at the end.
−	Foobar2000 executable path	+	* 0 not saved on exit
		+	* 1 saved on exit (default)
		+	$init_ps_global(NAME,VALUE,0) implies that the global variable "NAME" is deleted when quitting foobar2000.
−	[Function]	+	=== $set_ps_global(name,value) ===
−	$ font (name, size, OPTIONS)	+
−	Font settings.	+
−	OPTIONS: bold italic underline strikeout	+
−	Example: $ font (Tahoma, 10, bold italic)	+	=== $get_ps_global(name) or  %name% ===
		+	=== $delete_ps_global(name) ===
−	$ drawstring (text, x, y, W, H, rgba, OPTIONS [, OPTIONS2])	+	=== $font(name,size,OPTIONS) ===
−	String drawing functions.	+	Font settings.
−	Text coordinates (x, y) to draw on.	+	* OPTIONS: bold italic underline strikeout
−	[Note] This function is a string and DrawText drawtextex not only in view.	+	* Example: $font(Tahoma,10,bolditalic)
−	Maybe only TrueType fonts.	+
−	OPTIONS: Alain specified, the specified quality of drawing, and to specify the clip.	+	=== $drawstring(text,x,y,W,H,rgba,OPTIONS[,OPTIONS2]) ===
−	Alain left hcenter right specified horizontal	+	Draws a string at the coordinates '''(x,y)'''. The size of the text field is defined by width '''(W)''' and height '''(H)'''.
−	Alain specified top vcenter bottom vertical	+
−	nowrap not wraparound	+	''Note:'' This function is a string and there is also a GDI version of the same functions available [[#$drawtext(text,x,y,W,H,r-g-b,OPTIONS) | $drawtext]] and [[#$drawtextex(text,x,y,W,H,r-g-b,OPTIONS) | $drawtextex]]. This function might work for TrueType fonts, only.
−	noaa ClearType and disable anti-aliasing.	+	'''OPTIONS''':
−	aa put the anti-aliasing mode. ClearType font such as resistance to the anti-aliasing.	+	Align specified, the specified quality of drawing, and to specify the clip.
−	hq high quality rendering mode. ClearType mode. (default now)	+	* Align: ''left hcenter right specified horizontal''
−	glow_aa glow option to use a special mode. (noaa, aa, hq exclusive)	+	* Align: ''specified top vcenter bottom vertical''
		+	* ''nowrap'': disables text wrap
		+	* ''noaa'': ClearType and disable anti-aliasing.
		+	* ''aa'': put the anti-aliasing mode. ClearType font such as resistance to the anti-aliasing.
		+	* ''hq'': high quality rendering mode. ClearType mode. (default)
		+	* ''glow_aa'' glow option to use a special mode. (noaa, aa, hq exclusive)
−	If you set the trimming trimchar trimword fit the display range	+	* ''trimchar'' and ''trimword'': Trimming  of the text to fit the display range
−	elipchar elipword the last to fit the display range If・・・set to replace the	+	* ''elipchar'' and ''elipword'': Shortens the text to fit the the display range. If set the end of the line will be replaced with ''"···"''
		+	* ''mempos getlastpos'': to be able to get the coordinates of the drawing
−	mempos getlastpos, to be able to get the coordinates of the drawing.	+	'''OPTIONS2''' - specifying the glow effect (experimental stage):
		+	* ''glow:expand:colour[:strength]'': glow options
		+	** ''Expand'' - [0-5]
		+	** ''Colour'' - r-g-b
		+	** ''Strength'' - [0-3] glow_aa case of disabled
−	OPTIONS2 (optional experimental, experimental option)	+	Offset:x:y
−	Specifying the terms of the glow effect.	+	* ''X'' - glow in the horizontal offset
−	Specified in the OPTIONS glow_aa only, outline and semibold is available.	+	* ''Y'' - glow in the vertical offset
−	glow: expand: colour [: strength] glow options	+	Glow is a heavy process. (Especially the pseudo transparent)
−	Expand - [0-5]	+
−	Colour - r-g-b	+
−	Strength - [0-3] glow_aa case of disabled	+
−	Offset: x: y	+	* glow_aa be used only when the specified
−	X - glow in the horizontal offset	+	* outline: colour color draws a thin border of the specified character (if glow_aa)
−	Y - glow in the vertical offset	+	* Colour r-g-b
		+	* semibold to the characters a little thick (if glow_aa)
−	↓ glow_aa be used only when the specified	+	These specifications may be changed.
−	outline: colour color draws a thin border of the specified character (if glow_aa)	+	Changes in the glow, especially drawing, and semibold outline and may be discontinued.
−	Colour r-g-b	+
−	semibold to the characters a little thick (if glow_aa)	+	Examples:
		+	* $drawstring(abcd,10,10,,,255-128-64-128,)
		+	* $drawstring(abcd,10,10,,,255-128-64-128,leftvcenter,glow:2:255-255-255)
		+	* $drawstring(efgh,10,10,,,255-255-255,vcenterglow_aa,glow:1:32-168-268semibold)
		+	* $drawstring(wxyz,10,10,,,255-255-255,glow_aa,glow:0:32-168-268semiboldoffset:2:1outline:32-168-268)
		+	* $drawstring(wxyz,10,10,,,255-255-255,,glow:2:32-168-268:1)
		+	* $drawstring(wxyz,10,10,,,255-255-255,elipchar)
		+	=== $drawrect(x,y,w,h,R1-G1-B1-A1,R2-G2-B2-A2,OPTIONS) ===
−	※ These specifications may be changed.	+	Rectangular drawing function.  Coordinates (x,y) size (w,h) Draws a rectangle.
−	Changes in the glow, especially drawing, and semibold outline and may be discontinued.	+	* '''R1-G1-B1-A1''' internal color
−	※ glow is a heavy process. (Especially the pseudo transparent)	+	* '''R2-G2-B2-A2''' border color
−	Example, $ drawstring (abcd, 10,10,, ,255-128-64-128,)	+	'''OPTIONS''':
−	$ drawstring (abcd, 10,10,, ,255-128-64-128, left vcenter, glow :2:255-255-255)	+	* Aa - enable [http://en.wikipedia.org/wiki/Spatial_anti-aliasing anti aliasing]
−	$ drawstring (efgh, 10,10,, ,255-255-255, vcenter glow_aa, glow :1:32-168-268 semibold)	+
−	$ drawstring (wxyz, 10,10,, ,255-255-255, glow_aa, glow :0:32-168-268 semibold offset: 2:1 outline :32-168-268)	+
−	$ drawstring (wxyz, 10,10,, ,255-255-255,, glow :2:32-168-268: 1)	+
−	$ drawstring (wxyz, 10,10,, ,255-255-255, elipchar)	+
		+	Example:
		+	* $drawrect(0,50,50,50,255-128-64-128,,aa)
−	$ drawrect (x, y, w, h, R1-G1-B1-A1, R2-G2-B2-A2, OPTIONS)	+	=== $gradientrect(x,y,w,h,r1-g1-b1-a1,r2-g2-b2-a2,OPTIONS,PEAK) ===
−	Rectangular drawing functions.	+
−	Coordinates (x, y) size (w, h) Draws a rectangle.	+
−	R1-G1-B1-A1 internal color	+
−	R2-G2-B2-A2 Border Color	+
−	OPTIONS	+	Draws a rectangle with gradient fill at the coordinates '''(x,y)''' and size '''(w,h)'''
−	Aa - put ANCHIERIASU	+	* '''r1-g1-b1-a1''' gradient start color
		+	* '''r2-g2-b2-a2''' peak color gradient
−	Example $ drawrect (0,50,50,50,255-128-64-128,, aa)	+	'''OPTIONS''':
		+	* ''vertical'': vertical gradient
		+	* ''horizontal'': horizontal gradient
		+	* ''aa'': enable [http://en.wikipedia.org/wiki/Spatial_anti-aliasing anti aliasing]
		+	* ''nonlinear'': nonlinear gradient
		+	'''PEAK''': 0-100
		+	* Shifted the peak position of the gradient.
		+	** 0 by default, to end at peak color.
		+	** 50 When is the peak of color.
−	$ gradientrect (x, y, w, h, r1-g1-b1-a1, r2-g2-b2-a2, OPTIONS, peak_point)	+	Example:
−	Gradient fill in the drawing functions in the rectangle.	+	* $gradientrect(0,50,50,50255-128-64-128255-255-255,vertical aa)
−	Coordinates (x, y) size (w, h) Draws a rectangle.	+	* $gradientrect(0,50,50,50255-128-64-128255-255-255,,10)
−	R1-g1-b1-a1 Gradient start color	+
−	R2-g2-b2-a2 Gradient end color	+
−	OPTIONS	+	=== $drawblurrect(x,y,w,h,colour,level) ===
−	Vertical gradient of vertical	+
−	Gradient horizontal horizontal	+
−	Aa put ANCHIERIASU	+
−	how nonlinear nonlinear gradient	+
−	Peak_point: 0-100	+	Draws a rectangle with a blured outline at the coordinates '''(x,y)''' and size '''(w,h)'''
−	Shifted the position of the gradient endpoints.	+	* '''Colour''' [r1-g1-b1-a1]: blur colour
−	0 by default, r1-g1-b1-a1 -> r2-g2-b2-a2	+	* '''Level''' [1-7]: blur level
−	50 is when, r1-g1-b1-a1 -> r2-g2-b2-a2 -> r1-g1-b1-a1, and.	+
−	Example: $ gradientrect (0,50,50,50255-128-64-128255-255-255, vertical aa)	+	=== $drawfocusrect(x,y,w,h) ===
−	$ gradientrect (0,50,50,50255-128-64-128255-255-255,, 10)	+	Function to draw a dotted line shows the focus rectangle frame specified.
		+	=== $drawthemerect(x,y,w,h,control_name,partId,stateId) ===
−	$ drawblurrect (x, y, w, h, colour, level)	+	Visual Style in a rectangle with a control (button or progress bar) function to draw. The only practical to draw a picture may be low. Visual Style not defined in control will not be drawn. At least WindowXP required.
−	Filling a rectangle drawing functions to blur the outline.	+
−	Level [1-7]	+
		+	control_name:
		+	* Specify the name of the type of control you want to draw. One of the following:
		+	* window button rebar toolbar status listview header progress tab trackbar tooltip treeview spin scrollbar
		+	* edit combobox taskbar taskband startpanel explorerbar
−	$ drawfocusrect (x, y, w, h)	+	PartId:
−	Function to draw a dotted line shows the focus rectangle frame specified.	+	* the parts you want to draw ID. Could we use the following number in the range for each control as a guide.
		+	* In most cases, less than what I have defined.
		+	* Window: 1-37
		+	* Button rebar listview tooltip: 1-5
		+	* Toolbar: 1-6
		+	* Status treeview taskband: 1-3
		+	* Header spin: 1-4
		+	* Progress: 1-4
		+	* Tab trackbar scrollbar :1-10
		+	* Edit: 1-2
		+	* Combobox: 1
		+	* Taskbar: 1-8
		+	* Startpanel: 1-11
		+	* Explorerbar: 1-12
		+	StateId:
		+	* the state and selected ID. If the component does not have to specify the state is 0.
		+	* stateId is 0 or 1 or 2 would not be drawn in, the parts are not defined.
−	$ drawthemerect (x, y, w, h, control_name, partId, stateId)	+	Examples:
−	VisualStyle in the rectangle with a control (button or progress bar) function to draw.	+	* $drawthemerect (0,0,%el_width%,%el_height%,tab,10,0) / / tab of body parts drawn
−	The only practical to draw a picture may be low.	+	* $drawthemerect (,,,,progress,3,0) / / Draw the progress bar bar
−	VisualStyle not defined in control will not be drawn.	+
−	At least WindowXP required.	+
−	control_name: Specify the name of the type of control you want to draw. One of the following.	+	=== $drawroundrect(x,y,w,h,w2,h2,R1-G1-B1-A1,R2-G2-B2-A2,RESERVED) ===
−	window button rebar toolbar status listview header progress tab trackbar tooltip treeview spin scrollbar	+
−	edit combobox taskbar taskband startpanel explorerbar	+
−	PartId: the parts you want to draw ID. Could we use the following number in the range for each control as a guide.	+	Draws a rectangle with rounded corners at coordinates (x,y) and size (w, h). The degree of roundness is defined by (w2,h2).
−	In most cases, less than what I have defined.	+	* In order to achieve a decent effect the condition w>4*w2 and h>4*h2 should be matched.
−	Window: 1-37	+	* '''R1-G1-B1-A1''' internal color
−	Button rebar listview tooltip: 1-5	+	* '''R2-G2-B2-A2''' border color
−	Toolbar: 1-6	+
−	Status treeview taskband: 1-3	+
−	Header spin: 1-4	+
−	Progress: 1-4	+
−	Tab trackbar scrollbar :1-10	+
−	Edit: 1-2	+
−	Combobox: 1	+
−	Taskbar: 1-8	+
−	Startpanel: 1-11	+
−	Explorerbar: 1-12	+
−	StateId: the state and selected ID. If the component does not have to specify the state is 0.	+	Example:
−	stateId is 0 or 1 if not drawn in, the parts are not defined.	+	* $drawroundrect(10,20,50,50,4,4,255-255-128-255,,)
−	Example: $ drawthemerect (0,0,% el_width%,% el_height%, tab, 10,0) / / tab of body parts drawn	+	=== $drawellipse(x,y,w,h,R1-G1-B1-A1,R2-G2-B2-A2,RESERVED) ===
−	$ drawthemerect (,,,, progress, 3,0) / / Draw the progress bar bar	+
		+	Draws an ellipse at coordinates '''(x,y)''' with size '''(w,h)'''.
		+	* '''R1-G1-B1-A1''' internal color
		+	* '''R2-G2-B2-A2''' border Color
−	$ drawroundrect (x, y, w, h, w2, h2, R1-G1-B1-A1, R2-G2-B2-A2, RESERVED)	+	=== $drawtriangle(x1,y1,x2,y2,x3,y3,R1-G1-B1-A1,R2-G2-B2-A2,OPTIONS) ===
−	Draw a rectangle rolled angle function.	+
−	Coordinates (x, y) size (w, h) to draw a rectangle with the corners rolled.	+
−	Rounded the corner, w2, h2 can be adjusted.	+
−	w> 4 * w2 & & h> 4 * h2 satisfy the need.	+
−	R1-G1-B1-A1 internal color	+
−	R2-G2-B2-A2 Border Color	+
−	Example $ drawroundrect (10,20,50,50,4,4255-255-128-255,,)	+	Draw a triangle and vertex function.
		+	* '''(x1,y1),(x2,y2),(x3,y3)'''
		+	* '''R1-G1-B1-A1''' internal color
		+	* '''R2-G2-B2-A2''' Border Color
		+	'''OPTIONS''':
		+	* ''aa'': enable [http://en.wikipedia.org/wiki/Spatial_anti-aliasing anti aliasing]
−	$ drawellipse (x, y, w, h, R1-G1-B1-A1, R2-G2-B2-A2, RESERVED)	+	Example:
−	Ellipse drawing functions.	+	* $drawtriangle(10,5,20,10,10,15,200-100-100,,aa)
−	Coordinates (x, y) size (w, h) draws an ellipse.	+
−	R1-G1-B1-A1 internal color	+
−	R2-G2-B2-A2 Border Color	+
		+	=== $imageabs(x,y,w,h,path,OPTIONS,n,alpha,OPTIONS2) ===
−	$ drawtriangle (x1, y1, x2, y2, x3, y3, R1-G1-B1-A1, R2-G2-B2-A2, OPTIONS)	+	Displays an image '''(path)''' at coordinates '''(x,y)''' with size '''(w,h)'''. By default, an image is expanded to the maximum size allowed by (w,h) without changing the aspect ratio of the image.  After the image has been resized (if indeed it has been), the resized version is cached in the memory, which means any further references to it will return the modified rather than original values. <!--  The image is referenced, the memory is removed from them. (w,h) in the original image size is omitted, and the cache.  (However, w, h if you are already cached in memory and then the image size to be directly cached)-->
−	(x1, y1), (x2, y2), (x3, y3) Draw a triangle and vertex function.	+	<!--?ITAI a reduced rate if more than one. Poor quality and will be expanded after the reduction.
−	R1-G1-B1-A1 internal color	+	''Nodisplay'', ''noexpansion'' and use, Cache memory may be the largest reduction in the rate of reduction in the rate of use.
−	R2-G2-B2-A2 Border Color	+	If there are images true, if false is returned.-->
−	OPTIONS	+	'''Path''' is the absolute path of the image. It can also point to an audio file if it has an embedded image or if you are using one of the "artreader" options, and the path can include compressed archives if the "archive" option is active (see below).
−	Aa - put ANCHIERIASU	+
−	Example: $ drawtriangle (10,5,20,10,10,15200-100-100,, aa)	+	'''Options''' are flags which you separate with a space.
		+	* '''Resizing options'''
		+	** ''nokeepaspect'' ignores the image's aspect ratio and expands the image to fill both width and height regardless of distortion ''(nodisplay, archive, icon options and non-exclusive) [?]''
		+	** ''noexpansion'' prevents resizing to fill the space if the image turns out to be smaller than the specified width and height.
		+	* '''Alignment options'''
		+	** ''left'' and ''right'' determine horizontal alignment (left is default).
		+	** ''top'' and ''bottom'' determine vertical alignment (top is default).
−	$ imageabs (x, y, w, h, path, OPTIONS, n, alpha, OPTIONS2)	+	* '''Miscellaneous options'''
−	Coordinates (x, y) size (w, h) show the images in the path is specified.	+	** ''wc'' enables wildcard characters (*,?).
−	Retained in memory and after resizing the image, if you raise the efficiency of the process see below.	+	** ''nodisplay'' caches the image without actually displaying it.
−	The image is referenced, the memory is removed from them.	+
−	w, h in the original image size is omitted, and the cache.	+
−	(However, w, h if you are already cached in memory and then the image size to be directly cached)	+
−	扱ITAI a reduced rate if more than one	+	* '''Read-mode (path-related) options'''
−	Poor quality and will be expanded after the reduction.	+	** ''archive'' allows references to compressed archives to be included in the path. The path format is the absolute path of the archive followed by the base path within the archive file, using a pipe (|) as the separator. For example: ''C:\aaa\image.zip|bbb/ccc.jpg''
−	Nodisplay noexpansion and use,	+	** ''icon'' indicates that the path is specified in the icon file (*.ico) ''[?]''.
−	Cache memory may be the largest reduction in the rate of reduction in the rate of use.	+	** ''artreader'' uses embedded images or the default album art paths you've defined in Foobar2000's options to determine the image to be displayed.  The path supplied should be that of an audio file (typically, this would be %path%). <!--artreader path specified by the embedded image file foobar2000 loaded at the core of the artwork reader. If you do not have embedded images, audio files to load the images folder. However slow.-->
		+	*** ''artreader_front, artreader_back, artreader_disc'' and ''artreader_icon'' are variations on this option which select the specific corresponding album art.  However, the original documentation suggests one avoid these options because they seem to be slow. <!--* (artreader_*** are currently not recommended options because these seem to be slow)-->
−	If there are images true, if false is returned.	+	'''n''': rotateflip Index for:
		+	* ''1'': 90°
		+	* ''2'': 180°
		+	* ''3'': 270°
		+	* ''4'': flip horizontal
		+	* ''5'': 90° + flip horizontal
		+	* ''6'': Flipped vertically
		+	* ''7'': 90° + Flip Vertically
−	Dipsplays the image specified by path.	+	'''Alpha''' (Opacity)
−	after the image is resized, it is cached on the memory.	+	* ''0-255''
−	path: absolute path of the image (or an embedded image of AudioFile path)	+	'''OPTIONS2''' (shadow effect)
		+	* ''Glow:expand:colour''
		+	* ''Offset:x:y''
−	OPTIONS	+	Examples:
−	■ <appearance>	+	* $imageabs(10,10,50,50,C:\%album%.jpg)
−	nokeepaspect not maintain the aspect ratio (nodisplay, archive, icon options and non-exclusive).	+	* $imageabs(10,10,50,50,C:\%album%.jpg,left top)
−	Hide nodisplay read only memory.	+	* $imageabs(10,10,50,50,C:\%album%.jpg,,6)
−	noexpansion will reduce, not increase.	+	* $imageabs(10,10,50,50,C:\%album%.*,wc,6)
		+	* $imageabs(10,10,50,50,C:\%album%.jpg,bottom,,128)
		+	* $imageabs(10,10,50,50,C:\%album%.jpg,bottom,,,glow :2:0-0-0 offset: 4:4)
		+	* $imageabs(10,10,50,50,%path%,artreader)
−	■ <align> exclusive.	+	=== $imageabs_rc(rw,rh,srcx,srcy,srcw,srch,x,y,path,OPTIONS,n,alpha,OPTIONS2) ===
−	Left right horizontal aryne specified.	+
−	Specify vertical aryne top bottom.	+
−	■ <misc>	+	To view the clip and resize images. Path specified by the image size (rw, rh) after resizing, portion of the area (srcx, srcy, srcw, srch) coordinates (x, y) size (srcw, srch) to display.
−	wc wildcard (*,?) enabled.	+	In memory (rw, rh) cache. When you evaluate the TF (rw, rh) with changes in, to refresh the image. Therefore, rw, rh is to specify a fixed value. If there are images true, if false is returned.
−	■ <read engine> exclusive.	+	'''OPTIONS''' (imageabs):
−	archive archive reader through the path of the images.	+	* ''nokeepaspect'': not maintain the aspect ratio
−	The format of the archive reader is path dependent, the absolute path of the archive | base path in the archive file.	+	* ''nodisplay'': Hide read only memory
−	Example: C: \ aaa \ image.zip | bbb / ccc.jpg	+	* ''archive''
−	icon path is specified in the icon file (*. ico) to appear.	+	* ''Icon''
		+	* ''Horizontal Alignment''
		+	** left
		+	** hcener
		+	** right
		+	* ''Vertical Alignment''
		+	** top
		+	** vcenter
		+	** bottom
−	Audio artreader path specified by the embedded image file foobar2000 loaded at the core of the artwork reader.	+	'''N''' rotateflip Index for:
−	If you do not have embedded images, Audio files to load the images folder. However slow.	+	* 1: 90°
−	Audio artreader_front path specified by the embedded image file foobar2000 loaded at the core of the artwork reader.	+	* 2: 180°
−	Audio artreader_back path specified by the embedded image file foobar2000 loaded at the core of the artwork reader.	+	* 3: 270°
−	Audio artreader_disc path specified by the embedded image file foobar2000 loaded at the core of the artwork reader.	+	* 4: flip horizontal
−	Audio artreader_icon path specified by the embedded image file foobar2000 loaded at the core of the artwork reader.	+	* 5: 90° + flip horizontal
−	(artreader *** are currently disrecommended options because these option seem to be slow)	+	* 6: Flipped vertically
		+	* 7: 90° + Flip Vertically
−	N rotateflip Index for	+	'''Alpha''' (Opacity)
−	One ninety	+	* 0-255
−	2: 180	+
−	3: 270	+
−	4: flip horizontal	+
−	Five ninety + flip horizontal	+
−	6: Flipped vertically	+
−	Seven ninety Flip Vertically +	+
−	Alpha 0-255	+	'''Examples''':
−	Opacity	+	* $imageabs_rc(200,100,0,0,100,50,10,10,C:\%album%.jpg,,6,192)
		+	* $imageabs_rc(200,100,0,0,200,100,10,10,C:\%album%.jpg,,)  ( = $imageabs(10,10,200,100,C:\%album%.jpg,left top,,) )
		+	* $imageabs_rc(150,120,0,0,150,120,20,15,C:\%album%.jpg,hcenter vcenter,) ( = $imageabs(20,15,150,120,C:\%album%.jpg,,,) )
−	OPTIONS2 (shadow effect)	+	=== $drawimage(x,y,w,h,path,OPTIONS,n,alpha) ===
−	Glow: expand: colour	+
−	Offset: x: y	+
		+	Displays an image at Coordinates (x,y) with size (w,h) specified by path.
		+	The function is similar to $imageabs.
		+	w and h show the size of the original if omitted.
		+	Removed from memory immediately after being displayed.
		+	TF to be reloaded each time the images are evaluated.
−	Example $ imageabs (10,10,50,50, C: \% album%. Jpg)	+	You can see a huge image, the amount of occupied memory?RASHITAKATTARI to see more pictures, $imageabs for those who do not like the resizing process.
−	$ imageabs (10,10,50,50, C: \% album%. jpg, left top)	+
−	$ imageabs (10,10,50,50, C: \% album%. jpg,, 6)	+
−	$ imageabs (10,10,50,50, C: \% album%. jpg, bottom,, 128)	+
−	$ imageabs (10,10,50,50, C: \% album%. jpg, bottom,,, glow :2:0-0-0 offset: 4:4)	+
−	$ imageabs (10,10,50,50,% path%, artreader)	+
		+	'''OPTIONS''':
		+	* ''nokeepaspect'': not to maintain aspect ratio
		+	* Alignment
		+	** Left
		+	** Right
		+	** Top
		+	** Bottom
−	$ imageabs_rc (rw, rh, srcx, srcy, srcw, srch, x, y, path, OPTIONS, n, alpha, OPTIONS2)	+	'''n''': rotateflip index for
−	To view the clip and resize images.	+	* ''1'': 90°
−	path specified by the image size (rw, rh) after resizing,	+	* ''2'': 180°
−	Portion of the area (srcx, srcy, srcw, srch) coordinates (x, y) size (srcw, srch) to display.	+	* ''3'': 270°
		+	* ''4'': flip horizontal
		+	* ''5'': 90° + flip horizontal
		+	* ''6'': Flipped vertically
		+	* ''7'': 90° + Flip Vertically
−	In memory (rw, rh) cache.	+	alpha: 0-255
−	When you evaluate the TF (rw, rh) with changes in, to refresh the image.	+	* Opacity (transparency)
−	Therefore, rw, rh is to specify a fixed value.	+
−	If there are images true, if false is returned.	+	== Additional drawing functions ==
−	OPTIONS (imageabs).
−	nokeepaspect not maintain the aspect ratio
−	Hide nodisplay read only memory
−	Archive
−	Icon
−	(Left
−	Hcener
−	Right
−	Top
−	Vcenter
−	bottom)
−	N rotateflip Index for
−	One ninety
−	2: 180
−	3: 270
−	4: flip horizontal
−	Five ninety + flip horizontal
−	6: Flipped vertically
−	Seven ninety Flip Vertically +
−	Alpha 0-255	+	=== $getlastpos(elem) ===
−	Opacity	+
−		+
−	Example:	+
−	$ imageabs_rc (200100,0,0100,50,10,10, C: \% album%. jpg,, 6192)	+
−	$ imageabs_rc (200100,0,0200100,10,10, C: \% album%. jpg,,) (= $ imageabs (10,10200100, C: \% album%. jpg, left top,,))	+
−	$ imageabs_rc (150120,0,0150120,20,15, C: \% album%. jpg, hcenter vcenter,) (= $ imageabs (20,15150120, C: \% album%. jpg,,,))	+
		+	Display function imageabs, imageabs_rc right after, to get the coordinates to draw a picture. Also, ''[[#$measurestring(text,x,y,W,H,OPTIONS) | $measurestring]]'' use them when you get the results. If you are drawString, mempos available only immediately after the specified coordinates.
−	$ drawimage (x, y, w, h, path, OPTIONS, n, aplha)	+	Elem element to retrieve.
−	Coordinates (x, y) size (w, h) show the images in the path is specified.	+	X: left
−	$ Imageabs similar.	+	Y: top
−	w and h show the size of the original omitted.	+	W: width
−	From memory immediately after display processing will be removed.	+	H: height
−	TF to be reloaded each time the images are evaluated.	+	R: right
−		+	B: bottom
−	※ You can see a huge image, the amount of occupied memory減RASHITAKATTARI to see more pictures,	+
−	imageabs for those who do not like the resizing process.	+
−	OPTIONS: nokeepaspect not maintain aspect ratio	+	Example:
−	Left	+	$setworldtransform(2)
−	Right	+	$puts(img_path,C:\%album%.jpg)
−	Top	+	$imageabs(10,4,100,100,$get(img_path),top noexpansion,)
−	Bottom	+	$imageabs($getlastpos(x),$getlastpos(b),$getlastpos(w),20,$get(img_path),top nokeepaspect,6)
		+	$gradientrect($getlastpos(x),$getlastpos(y),$getlastpos(w),$getlastpos(h),%el_backcolour%-128,%el_backcolour%-255)
		+	$setworldtransform(0)
−	n: rotateflip index for	+	=== $measurestring(text,x,y,W,H,OPTIONS) ===
−	One ninety	+
−	2: 180	+
−	3: 270	+
−	4: flip horizontal	+
−	Five ninety + flip horizontal	+
−	6: Flipped vertically	+
−	Seven ninety Flip Vertically +	+
−	alpha 0-255	+	''$drawstring'' to calculate the area when drawing text. As a result, returns to the horizontal width of the viewing area. The display area is to get ''[[#$getlastpos(elem) | $getlastpos]]''. '''OPTIONS''' is the same as $drawstring. If $drawstring uses the ''glow_aa'' or ''glow'' options, the ''$measurestring'' value returned may not be accurate.
−	Opacity (transparency)	+
−	● auxiliary drawing	+	=== $getimagewidth(path),$getimageheight(path) ===
−	$ getlastpos (elem)	+	The image path is specified in ''$imageabs'' ''$imageabs_rc'' of cache memory. If the image has been resized in the horizontal width and vertical width it returns the respective values. This means that only have ''$imageabs'' ''$imageabs_rc'' behind. ''nokeepaspect'' may be able to calculate the aspect ratio should be applied.
−	Display function imageabs, imageabs_rc right after, to get the coordinates to draw a picture.	+
−	Also, measurestring use them when you get the results.	+
−	If you are drawString, mempos available only immediately after the specified coordinates.	+
−	Elem element to retrieve.	+	=== $setpercentmode(bx,by,bw,bh) ===
−	X: left	+	Set the mode to specify the coordinates.
−	Y: top	+	Window space
−	W: width	+	(0,0) ~ (%_width%,%_height%) where a, percentage specified in the mode, (0,0) to (100100) mapping.
−	H: height	+	*x,y,W,H, can be set individually.
−	R: right	+	*x,y,W,H, all affect the function of one argument.
−	B: bottom	+
−	Example:	+	* bx x coordinate specified mode
−	$ Setworldtransform (2)	+	** 0: Splitter mode specified in absolute coordinates
−	$ Puts (img_path, C: \% album%. Jpg)	+	** 1: Splitter value relative to the size (percentage) and designated.
−	$ imageabs (10,4100100, $ get (img_path), top noexpansion,)	+	* mode specified by y coordinates
−	$ imageabs ($ getlastpos (x), $ getlastpos (b), $ getlastpos (w), 20, $ get (img_path), top nokeepaspect, 6)	+	* bw w coordinates specified mode
−	$ gradientrect ($ getlastpos (x), $ getlastpos (y), $ getlastpos (w), $ getlastpos (h),% el_backcolour% -128,% el_backcolour% -255)	+	* bh h coordinates specified mode
−	$ Setworldtransform (0)	+
		+	=== $getsyscolour (index) ===
		+	The r-g-b color system in the fo
−	$ measurestring (text, x, y, W, H, OPTIONS)	+	index: [0-30] color index system
−	$ drawstring to calculate the area when drawing text.	+
−	As a result, returns to the horizontal width of the viewing area.	+
−	The display area is to get $ getlastpos.	+
−	OPTIONS is the same as $ drawstring.	+
−	Also, drawstring in, glow_aa glow if put in effect,	+
−	Measurestring see the range of results and may not match.	+
		+	=== $averagecolour(colour1,colour2[,···]) ===
−	$ getimagewidth (path), $ getimageheight (path)	+	Calculates the average color ''R-g-b-a'' of a given set of colors.
−	The image path is specified in $ imageabs $ imageabs_rc of cache memory	+
−	If the image has been resized in the horizontal width and vertical width returns.	+
−	This means that only have $ imageabs $ imageabs_rc behind.	+
−	nokeepaspect may be able to calculate the aspect ratio should be applied.	+
		+	''(Colour1 + colour2 +···) / N''
−	$ setparcentmode (bx, by, bw, bh)	+	=== $blendcolour(colour1,w1,colour2,w2,[,···]) ===
−	Set the mode to specify the coordinates.	+
−	Window space	+
−	(0,0) ~ (% _width%,% _height%) where a,	+
−	Percentage specified in the mode, (0,0) to (100100) mapping.	+
−	x, y, w, h can be set individually.	+
−	x, y, w, h all affect the function of one argument.	+
−	bx x coordinate specified mode	+	Calculates the average weighted ''w1,w2[,···]'' color ''R-g-b-a'' of a given set of colors.
−	0: Splitter mode specified in absolute coordinates	+
−	1: Splitter value relative to the size (percentage) and designated.	+
−	mode specified by y coordinates	+
−	bw w coordinates specified mode	+
−	bh h coordinates specified mode	+
−	$ getsyscolour (index)	+	''(w1 * colur1 + w2 * colour2 +···+ wN * colourN) / (w1 + w2 +···+ wN)''
−	The r-g-b color system in the form of returns.	+
−	index: [0-30] color index system	+	=== $addcolour(colour1,colour2[,···]) ===
		+	Adds colors ''r-g-b-a'' of a given set.
−	$ averagecolour (colour1, colour2 [,・・・])	+	''Colour1 + colour2 + ··· + colourN''
−	R-g-b-a to the average color of the form.	+
−	(Colour1 + colour2 +・・・) / N	+
		+	=== $subcolour(colour1,colour2[,···]) ===
−	$ blendcolour (colour1, w1, colour2, w2, [,・・・])	+	Substracts colors ''r-g-b-a'' of a given set.
−	R-g-b-a return with the average weight in the form.	+
−	(w1 * colur1 + w2 * colour2 +・・・+ wN * colourN) / (w1 + w2 +・・・+ wN)	+
		+	''Colour1 - colour2 - colour3···- colourN''
−	$ addcolour (colour1, colour2 [,・・・])	+	== General-purpose system functions ==
−	R-g-b-a to add the color of the form.	+
−	・・・Colour1 + colour2 + + colourN	+
		+	=== $findfile(path,[path2,path3,...]) ===
−	$ subcolour (colour1, colour2 [,・・・])	+	Determinates whether the specified file(s) exist(s) and returns the first file. If you do not have the file does not return anything. (Strictly speaking, "false" returns). Path can be specified. The ''path'' allows wildcards.
−	R-g-b-a to form a color subtraction.	+	<!--Elplaylist lists here $el_scale(val,factor[,DIV]) as another function -->
−	Colour1 - colour2 - colour3・・・- colourN	+
		+	== Function buttons ==
−	$ findfile (path, [path2, path3 ,...])	+	=== $textbutton(x,y,w,h,text,mover_text,command,options1,options2) ===
−	path (wildcards accepted) to be specified in the file exists, returns the first file.	+	Create a button.
−	If you do not have the file does not return anything. (Strictly speaking, "false" returns)	+	Per Track only available. Per Second is not to write.
−	Path can be specified.	+
		+	* '''text''': the button label
		+	* '''mover_text''': the button label when mouse over
−	● function button	+	command: "Type of instruction: arguments" specified in the form of
		+	* be no extra spaces
		+	* Going to be separated by a specified multiple orders.
		+	* A few instructions that can be specified.
		+	* Very difficult to implement. . .
		+	* And the splitter so that the characters and words in these arguments, could not parse well.
−	$ textbutton (x, y, w, h, text, mover_text, command, options1, options2)	+	Note 1: Do not specify the order processing time.
−	Create a button.	+	Note 2: If you specify more than one instruction, the instruction execution order is not guaranteed. Especially if WINDOWSIZE and COMMAND is specified, WINDOWSIZE probably be better to run. COMMAND, CONTEXT and others, the order may be warranted.
−	Per Track only available. Per Second is not to write.	+
−	text: the button label	+	'''Command''': command_path
−	mover_text: the button label when mouse over	+	* command_path to run the command specified by menu.
		+	* COMMAND: View / Equalizer and COMMAND: File / Preferences; COMMAND: Playback / Play
		+	* To specify that you can use the input help in setting some of them.
		+	* TF command_path Note also that as COMMAND: 'View / Equalizer' and it's recommended.
−	command: "Type of instruction: arguments" specified in the form of	+	'''Context''': context_path
−	※ be no extra spaces	+	* context_path KONTEKISUTOMENYUKOMANDO be designated to perform.
−	; Going to be separated by a specified multiple orders.	+	* Handles the context menu of the currently playing track.
−	A few instructions that can be specified.	+	* CONTEXT: Properties to specify the like.
−	Very difficult to implement. . .	+	* TF context_path Note also that as
−	: And; the splitter so that the characters and words in these arguments,	+
−	Could not parse well.	+
−	Note 1: Do not specify the order processing time.	+	'''Panelshow''': cap: sh
−	Note 2: If you specify more than one instruction, the instruction execution order is not guaranteed.	+	*The caption of the child panel cap / hide.
−	Especially if WINDOWSIZE and COMMAND is specified, WINDOWSIZE probably be better to run.	+	*sh: 0 hide
−	COMMAND, CONTEXT and others, the order may be warranted.	+	**    1.
		+	**  -1 Show / hide toggle
−	COMMAND: command_path	+	'''TFMode''': mode
−	command_path to run the command specified by menu.	+	*Per Track titleformat to change the mode.
−	COMMAND: View / Equalizer and	+	*mode: 0 nowplaying mode
−	COMMAND: File / Preferences; COMMAND: Playback / Play	+	** 1 follow curosr mode
−	To specify that.	+	** -1 Toggle
−	※ You can use the input help in setting some of them. . .	+
−	TF command_path Note also that as	+
−	COMMAND: 'View / Equalizer' and it's recommended.	+
−	CONTEXT: context_path	+	'''Windowsize''': width:height
−	context_path KONTEKISUTOMENYUKOMANDO be designated to perform.	+	* Sets the size of the entire foobar2000 window.
−	Handles the context menu of the currently playing track.	+
−	CONTEXT: Properties to specify the like.	+
−	TF context_path Note also that as	+
		+	'''Setglobal''': name:value
−	PANELSHOW: cap: sh	+	'''Refresh''': TF of PerTrack, PerSecond update.
−	The caption of the child panel cap / hide.	+
−	sh: 0 hide	+
−	1.	+
−	-1 Show / hide toggle	+
−	TFMODE: mode	+	'''options1'''
−	Per Track titleformat to change the mode.	+
−	mode: 0 nowplaying mode	+
−	1 follow curosr mode	+
−	-1 Toggle	+
−	REFRESH: TF of PerTrack, PerSecond update.	+	specify the default decoration (can specify more than one, separated by spaces)
		+	* fontcolor: r-g-b color of the text
		+	* brushcolor: r-g-b-a color fills the rectangle button
		+	* pencolor: r-g-b-a color button border
		+	* left top bottom right position of the text
		+	'''options2''':
		+	decorative specify when mouse over (can specify more than one, separated by spaces)
		+	* fontcolor: r-g-b color of the text
		+	* brushcolor: r-g-b-a color fills the rectangle button
		+	* pencolor: r-g-b-a color button border
		+	* left top bottom right position of the text
−	options1 specify the default decoration (can specify more than one, separated by spaces)
−	fontcolor: r-g-b-color of the text
−	brushcolor: rgba color fills the rectangle button
−	pencolor: r-g-b-a color button border
−	left top bottom right position of the text
−	options2: decorative specify when mouse over (can specify more than one, separated by spaces)	+	'''Examples''':
−	fontcolor: r-g-b-color of the text	+	* $textbutton (0,0,80,20,play,play,COMMAND: Playback / Play,fontcolor:64-64-64 brushcolor:192-192-192-128 pencolor:0-0-0-0,fontcolor:32-32-32)
−	brushcolor: rgba color fills the rectangle button	+	* $textbutton (100,0,80,20,Resize,Resize,PANELSHOW:aaa:-1;REFRESH,fontcolor:64-64-64 left bottom,fontcolor:32-32-32)
−	pencolor: r-g-b-a color button border	+
−	left top bottom right position of the text	+
		+	=== $imagebutton(x,y,w,h,path,mover_path,command,options1,options2) ===
		+	Create an image button.
		+	Per Track only available. Per Second is not to write.
		+	The internal processing of the images are treated equally and $imageabs will be cached in memory.
		+	w, h is omitted, path to original image size is specified.
		+	textbutton command is common.
−	Example $ textbutton (0,0,80,20, play, play, COMMAND: Playback / Play, fontcolor :64-64-64 brushcolor :192-192-192-128 pencolor :0-0-0, fontcolor: 32 -- 32-32)	+	Display options:
−	$ textbutton (100,0,80,20, Resize, Resize, PANELSHOW: aaa: -1; REFRESH, fontcolor :64-64-64 left bottom, fontcolor :32-32-32)	+
		+	OPTIONS1
		+	* nokeepaspect
		+	* left
		+	* top
		+	* bottom
		+	* right
		+	OPTIONS2:
		+	When mouse over the image display options
		+	* nokeepaspect
		+	* left
		+	* top
		+	* bottom
		+	* right
−	$ imagebutton (x, y, w, h, path, mover_path, command, options1, options2)	+	== GDI drawing functions ==
−	Create an image button.	+
−	Per Track only available. Per Second is not to write.	+
−	The internal processing of the images are treated equally and $ imageabs will be cached in memory.	+
−	w, h is omitted, path to original image size is specified.	+
−	textbutton command is common.	+
−	Display options options1	+	Using the Windows System Component [http://en.wikipedia.org/wiki/Graphics_Device_Interface GDI] to draw. GDI functions are usually faster, but they do not allow alpha blending and shadow effects (glow).
−	nokeepaspect	+
−	left top bottom right	+
−	options2: When mouse over the image display options	+
−	nokeepaspect	+
−	left top bottom right	+
		+	=== $drawtext(text,x,y,W,H,r-g-b,OPTIONS) ===
−	● GDI drawing functions of	+	GDI text drawing functions. Text coordinates (x, y) in output
−	Using the GDI to draw. Simple minutes, may be faster.	+
−	$ drawtext (text, x, y, W, H, r-g-b, OPTIONS)	+	OPTIONS:
−	GDI text drawing functions	+	* Align ''left hcenter right specified horizontal''
−	Text coordinates (x, y) in output	+	* Align ''specified top vcenter bottom vertical''
−		+	* Not noclip clip
−	OPTIONS	+
−	Alain left hcenter right specified horizontal	+
−	Alain specified top vcenter bottom vertical	+
−	Not noclip clip	+
−		+
−		+
−	$ drawtextex (text, x, y, W, H, r-g-b, OPTIONS)	+
−	GDI drawing functions text_2	+
−	Text coordinates (x, y) in output	+
−		+
−	OPTIONS	+
−	Alain left hcenter right specified horizontal	+
−	Alain specified top vcenter bottom vertical	+
−	Not noclip clip	+
−	Allow specified wrap wraparound (vcenter, bottom and exclusive)	+
−	end_ellipsis If you clip text, replace the end of the text ...	+
−		+
−	Example: $ drawtextex (text, 0,0,% _width%,% _height% ,0-0-0, hcenter vcenter end_ellipsis)	+
		+	=== $drawtextex(text,x,y,W,H,r-g-b,OPTIONS) ===
−	$ gettextwidth (text, [FONTNAME, SIZE, OPTIONS])	+	GDI drawing functions text_2
−	GDI (drawtext, drawtextex) returns the width in the text when drawing horizontal text.	+	Text coordinates (x, y) in output
−	can specify the font ($ font option). specified font is optional	+
		+	OPTIONS
		+	* Align ''left hcenter right specified horizontal''
		+	* Align ''specified top vcenter bottom vertical''
		+	* Not noclip clip
		+	* Allow specified wrap wraparound (vcenter, bottom and exclusive)
		+	* ''end_ellipsis'' If you clip text, replace the end of the text ...
−	$ gettextheight ([FONTNAME, SIZE, OPTIONS])	+	Example: ''$drawtextex(text,0,0,%_width%,%_height%,0-0-0,hcenter vcenter end_ellipsis)''
−	GDI returns vertical width of text when drawn.	+
−	can specify the font ($ font option). specified font is optional	+
		+	=== $gettextwidth(text,[FONTNAME,SIZE,OPTIONS]) ===
−	$ fillrect (x, y, w, h, r-g-b, RESERVED)	+	For the use with GDI text functions (''drawtext'', ''drawtextex''). Returns the width in the text when drawing horizontal text. Optionaly the font can be specified ''FONTNAME'', ''SIZE'' and ''OPTIONS'' (bold, italic, etc).
−	Filled rectangle function	+
		+	=== $gettextheight([FONTNAME,SIZE,OPTIONS]) ===
−	$ fillroundrect (x, y, w, h, w2, h2, r1-g1-b1, r2-g2-b2)	+	For the use with GDI text functions (''drawtext'', ''drawtextex''). Returns vertical width of text. can specify the font ($ font option). Optionaly the font can be specified ''FONTNAME'', ''SIZE'' and ''OPTIONS'' (bold, italic, etc).
−	Function of the fill rectangle with rounded corners	+
		+	=== $fillrect(x,y,w,h,r-g-b,RESERVED) ===
−	● Panel operating system functions	+	Filled rectangle function
−	Apparently drawing functions and the TF is such low efficiency of the frame together,	+
−	Future plans to別枠.	+
−	$ showpanel (i, sh) or $ showpanel_c (caption, sh)	+	=== $fillroundrect(x,y,w,h,w2,h2,r1-g1-b1,r2-g2-b2) ===
−	Panel, change the function inactive	+
−	i somethingth in the child panel list (counting from 0)	+
−	sh 0: Inactive 1: View	+
		+	Function of the fill rectangle with rounded corners
−	$ movepanel (i, x, y, w, h) or $ movepanel_c (caption, x, y, w, h)	+	== Panel operating system functions ==
−	i somethingth in the child panel list (counting from 0)	+
−	Panel Force layout only for the specified coordinates (x, y) size (w, h) to move on.	+
		+	Apparently drawing functions and the TF is such low efficiency of the frame together,
		+	Future plans to??.
−	$ getcaption (i)	+	=== $showpanel(i,sh) or $showpanel_c(caption,sh) ===
−	I returns the list of child panel captions are set in the second panel.	+	Panel, change the function inactive
		+	* '''i''': somethingth in the child panel list (counting from 0)
		+	* '''sh''': 0: Inactive 1: View
		+	=== $movepanel(i,x,y,W,H,) or $movepanel_c(caption,x,y,W,H,) ===
		+	'''i''': something in the child panel list (counting from 0)
−	$ isvisible_c (caption)	+	Panel Force layout only for the specified coordinates (x, y) size (w, h) to move on.
−	Returns the status panel.	+
		+	=== $getcaption(i) ===
		+	'''i''': returns the list of child panel captions are set in the second panel.
		+	=== $isvisible_c(caption) ===
		+	Returns the status panel.
	= External links =		= External links =
	* [http://foo2k.chottu.net/ Official page with download link] (Japanese)		* [http://foo2k.chottu.net/ Official page with download link] (Japanese)
	* [http://www.hydrogenaudio.org/forums/index.php?showtopic=62114 Discussion thread]		* [http://www.hydrogenaudio.org/forums/index.php?showtopic=62114 Discussion thread]

---

Revision as of 08:43, 25 October 2020

Panel Stack Splitter is a ColumnsUI extension for advanced placement and scripting of panels. It functions as a splitter in the ColumnsUI panel hierarchy (i.e., it can contain other panels).

Function and Use

Panel Stack Splitter is an extension for ColumnsUI which allows for greater control over the arrangement of panels. Not only can any panel be positioned freely within the Foobar2000 window, but the splitters themselves can be scripted, the panels can be resized using the cursor or by scripted actions, and panels can be hidden and displayed according to your script. It includes functions which make it easy to create graphical buttons and dynamic layouts. It can replace any number of more specific panels, such as those intended for displaying album art or track information.

Common uses include the creation of interfaces which reconfigure themselves automatically depending on the window size, panel-switching arrangements, and of course, all manner of window dressing. It's often used alongside other plugins such as ELPlaylist and WSH Panel to construct elaborate custom interfaces, but be warned that the results of such efforts are, unlike Foobar2000 itself, not always efficient or stable.

Authorship

Panel Splitter was written by ssenna, who is also the author of ELPlaylist. Many of the functions are similar and both plug-ins work well together.

Requirements

• foo_uie_panel_splitter.dll v0.3.8.3a (2009/12/11)
• foobar2000 v0.9.5.2+
• Columns UI 0.3+

Reference

The following documentation is an imperfect translation and adaptation from the original Japanese readme. Until the page has been more thoroughly re-written, expect some confusing passages.

Introduction

After installing the plug-in, in the options dialog under ColumnsUI's Layout tab you'll be able to add a Panel Stack Splitter to your layout and configure it. Once you've added a Panel Stack Splitter you can also edit it by right-clicking the panel and choosing Configure from the context menu. The relationship between Panel Stack Splitters and the resulting layout may initially be confusing. In theory, one could place all their panels under a single Panel Stack Splitter to achieve any layout, but in practice you will generally want to employ them more like traditional horizontal and vertical splitters, nesting hierarchically.

Splitter Settings dialog

The Splitter Settings dialog has four tabs, PanelList, Script, Behavior and Global variables.

PanelList shows subordinate panels and allows you to define their names, positions and sizes. Script allows you to script the Splitter panel itself; this is where you would define buttons, text to display, or scripts which alter the layout or operate invisibly. Behavior presents options related to how the Splitter is rendered and how it executes scripts, and Global variables lets you view and delete currently active global variables.

PanelList

You can't add subordinate panels from this tab -- for this you must return to the ColumnsUI layout options. But once you've added panels, you can select them from the left box in this tab and define their display parameters at the right. Note that there is one option on this tab which is for the Splitter itself rather than its children; this is Panel placement mode, which allows you to select horizontal or vertical position. This parameter is irrelevant for forced layouts.

All fields accept numbers as pixel positions and widths by default, though you can switch to percentage values instead when in forced mode. You can use Titleformatting Script in all of these fields, which is often important for forced layouts if you want them to be resizeable.

Caption 

This allows you to assign a unique name to the panel in question. In addition to providing a convenient label for the panel for when you're editing, this allows you make direct reference to the panel is scripts later on, for example if you wanted to display, hide or resize it.

Size 

Defines the size of the panel, but only if you are using a non-forced layout. Size means width when in horizontal panel placement mode and height when in vertical panel placement mode.

Padding 

These values define padding between the edges of the panel's allotted space (size) and the actual panel.

Lock size 

This disables the user from resizing the panel using the mouse. Only applies to non-forced layout mode; in forced-layout mode this is already default. The original documentation provides further details about this option, including a caveat that seems to address the possibility of blurred pixels, but the auto-translation is garbled.

Forced layout 

This option allows you to directly determine the position and size of a panel. Turning it on disables Size and (by default) padding and makes panel placement mode irrelevant. Panels can even overlap, though you generally would only want to do this if you intend to provide a way to switch between them. Left and Right are measurements from the upper-left (0,0) of the panel.

• Title Formatting script is enabled and you can use %_width% and %_height% to call the current width and height of the Splitter itself.
• If two panels overlap, by default the one that renders in front is determined by the sequence of panels as defined in the ColumnsUI options. [?]
• Example. This would always expand the panel to the width of the splitter minus 400 pixels:

       Width: $sub(%_width%,400)

• Example. This would make the panel always fill the lower half of the available space:

       Top: $div(%_height%,2)
       Height: $div(%_height%,2)

Use percentage value 

This option makes Panel Splitter interpret the values in Left, Top, Width and Height as percentages of available space instead of pixel measurements. Thus the second example above could be written as Top: 50 and Height: 50.

Enable padding settings

This option re-enables the padding values defined for non-forced-layout mode. Though this may seem redundant when you can simply include the padding in your position and size values, it may be useful for percentage-based layouts.

Ignore panel size limits 

This seems to be undocumented, but allows for sizes lower or higher than default caps. For example, the seekbar will display as 20px high if any value below 20px is entered into the Height field unless this box is checked.

Hide panel on startup 

This rather straight-forward option does precisely what its name indicates. To later make the panel visible, you would use a script function such as $showpanel_c.

Script Tab

titleformat mode on startup: when you start the TitleFormat PerTrack modes.

• now playing TF play that track
• follow cursor on the selected tracks in playlist
• last mode at the end of the previous mode (the switch mode button to save)

• title formatting script:

Titleformat here to describe, and decorative backgrounds. However, the child is on the panel can not be drawn.

Extended Command Reference Sensitive argument, or optional, and not implemented. Note: Do not waste the space. (Carriage return accepted)

in title formatting script is evaluated,

• Today
• Per Track: track and play and play·When the user changes the size of the state changed when paused. Function when the REFRESH button.
• Per Second: second, when a change in the state play in the function when the REFRESH button.

[Note]

• Per Second, especially that not only can handle high-stress functions.
• GDI is recommended that you use the drawing functions.

Behaviour Tab

• use background color: the color specified, the background fill.
• use image: specify a fixed background image. TitleFormatting is disabled.
• pseudo transparent: splitter to simulate a transparent background. (splitter and if you use the nest)

[Note]

• ColumnsUI in the panel is to present the panel with the transparent background feature, use background color or use image backgrounds are often not transparent and does not use the panel.

Global variables Tab

Fields

%ps_width%

Returns the width of the Splitter

%ps_height%

Returns the height of the Splitter

%ps_tfmode%

TF mode returns. (Per Track when enabled)

• 0 nowplaying mode
• 1 follow cursor mode

%ps_isplaying%

Whether during playback

%ps_ispause%

Whether suspended

%ps_foobar2000_path%

Foobar2000 executable path

%ps_user_profile_path%

User profile path

%ps_playback_order%

Returns the playback order. However, playback order can not be immediately reflected in the change.(REFRESH commands are required)

%ps_track_state%

TF mode returns state of the player, whether a track is present or not.

• 0 no error
• 1 no track
• 2 dummy track (for mainly legacy metadb_display_hook API)

Functions

$init_ps_global(name,value)

Valid only if there is no global variable name specified.

All global variables are shared between each of the TF although the PanelStackSplitter evaluation order is undefined. Persistency = 1 variable is set, $delete_ps_gobal you use will be saved until you delete from the settings dialog. $Init_ps_global(name,value) is, $if($get_ps_global(name),,$set_ps_global(name,value)) and almost equivalent.

$init_ps_global(name,value,persistency)

Persistency - whether to save at the end.

• 0 not saved on exit
• 1 saved on exit (default)

$init_ps_global(NAME,VALUE,0) implies that the global variable "NAME" is deleted when quitting foobar2000.

$set_ps_global(name,value)

$get_ps_global(name) or  %name%

$delete_ps_global(name)

$font(name,size,OPTIONS)

Font settings.

• OPTIONS: bold italic underline strikeout
• Example: $font(Tahoma,10,bolditalic)

$drawstring(text,x,y,W,H,rgba,OPTIONS[,OPTIONS2])

Draws a string at the coordinates (x,y). The size of the text field is defined by width (W) and height (H).

Note: This function is a string and there is also a GDI version of the same functions available $drawtext and $drawtextex. This function might work for TrueType fonts, only.

OPTIONS: Align specified, the specified quality of drawing, and to specify the clip.

• Align: left hcenter right specified horizontal
• Align: specified top vcenter bottom vertical
• nowrap: disables text wrap
• noaa: ClearType and disable anti-aliasing.
• aa: put the anti-aliasing mode. ClearType font such as resistance to the anti-aliasing.
• hq: high quality rendering mode. ClearType mode. (default)
• glow_aa glow option to use a special mode. (noaa, aa, hq exclusive)

• trimchar and trimword: Trimming of the text to fit the display range
• elipchar and elipword: Shortens the text to fit the the display range. If set the end of the line will be replaced with "···"
• mempos getlastpos: to be able to get the coordinates of the drawing

OPTIONS2 - specifying the glow effect (experimental stage):

• glow:expand:colour[:strength]: glow options
  • Expand - [0-5]
  • Colour - r-g-b
  • Strength - [0-3] glow_aa case of disabled

Offset:x:y

• X - glow in the horizontal offset
• Y - glow in the vertical offset

Glow is a heavy process. (Especially the pseudo transparent)

• glow_aa be used only when the specified
• outline: colour color draws a thin border of the specified character (if glow_aa)
• Colour r-g-b
• semibold to the characters a little thick (if glow_aa)

These specifications may be changed. Changes in the glow, especially drawing, and semibold outline and may be discontinued.

Examples:

• $drawstring(abcd,10,10,,,255-128-64-128,)
• $drawstring(abcd,10,10,,,255-128-64-128,leftvcenter,glow:2:255-255-255)
• $drawstring(efgh,10,10,,,255-255-255,vcenterglow_aa,glow:1:32-168-268semibold)
• $drawstring(wxyz,10,10,,,255-255-255,glow_aa,glow:0:32-168-268semiboldoffset:2:1outline:32-168-268)
• $drawstring(wxyz,10,10,,,255-255-255,,glow:2:32-168-268:1)
• $drawstring(wxyz,10,10,,,255-255-255,elipchar)

$drawrect(x,y,w,h,R1-G1-B1-A1,R2-G2-B2-A2,OPTIONS)

Rectangular drawing function. Coordinates (x,y) size (w,h) Draws a rectangle.

• R1-G1-B1-A1 internal color
• R2-G2-B2-A2 border color

OPTIONS:

• Aa - enable anti aliasing

Example:

• $drawrect(0,50,50,50,255-128-64-128,,aa)

$gradientrect(x,y,w,h,r1-g1-b1-a1,r2-g2-b2-a2,OPTIONS,PEAK)

Draws a rectangle with gradient fill at the coordinates (x,y) and size (w,h)

• r1-g1-b1-a1 gradient start color
• r2-g2-b2-a2 peak color gradient

OPTIONS:

• vertical: vertical gradient
• horizontal: horizontal gradient
• aa: enable anti aliasing
• nonlinear: nonlinear gradient

PEAK: 0-100

• Shifted the peak position of the gradient.
  • 0 by default, to end at peak color.
  • 50 When is the peak of color.

Example:

• $gradientrect(0,50,50,50255-128-64-128255-255-255,vertical aa)
• $gradientrect(0,50,50,50255-128-64-128255-255-255,,10)

$drawblurrect(x,y,w,h,colour,level)

Draws a rectangle with a blured outline at the coordinates (x,y) and size (w,h)

• Colour [r1-g1-b1-a1]: blur colour
• Level [1-7]: blur level

$drawfocusrect(x,y,w,h)

Function to draw a dotted line shows the focus rectangle frame specified.

$drawthemerect(x,y,w,h,control_name,partId,stateId)

Visual Style in a rectangle with a control (button or progress bar) function to draw. The only practical to draw a picture may be low. Visual Style not defined in control will not be drawn. At least WindowXP required.

control_name:

• Specify the name of the type of control you want to draw. One of the following:
• window button rebar toolbar status listview header progress tab trackbar tooltip treeview spin scrollbar
• edit combobox taskbar taskband startpanel explorerbar

PartId:

• the parts you want to draw ID. Could we use the following number in the range for each control as a guide.
• In most cases, less than what I have defined.
• Window: 1-37
• Button rebar listview tooltip: 1-5
• Toolbar: 1-6
• Status treeview taskband: 1-3
• Header spin: 1-4
• Progress: 1-4
• Tab trackbar scrollbar :1-10
• Edit: 1-2
• Combobox: 1
• Taskbar: 1-8
• Startpanel: 1-11
• Explorerbar: 1-12

StateId:

• the state and selected ID. If the component does not have to specify the state is 0.
• stateId is 0 or 1 or 2 would not be drawn in, the parts are not defined.

Examples:

• $drawthemerect (0,0,%el_width%,%el_height%,tab,10,0) / / tab of body parts drawn
• $drawthemerect (,,,,progress,3,0) / / Draw the progress bar bar

$drawroundrect(x,y,w,h,w2,h2,R1-G1-B1-A1,R2-G2-B2-A2,RESERVED)

Draws a rectangle with rounded corners at coordinates (x,y) and size (w, h). The degree of roundness is defined by (w2,h2).

• In order to achieve a decent effect the condition w>4*w2 and h>4*h2 should be matched.
• R1-G1-B1-A1 internal color
• R2-G2-B2-A2 border color

Example:

• $drawroundrect(10,20,50,50,4,4,255-255-128-255,,)

$drawellipse(x,y,w,h,R1-G1-B1-A1,R2-G2-B2-A2,RESERVED)

Draws an ellipse at coordinates (x,y) with size (w,h).

• R1-G1-B1-A1 internal color
• R2-G2-B2-A2 border Color

$drawtriangle(x1,y1,x2,y2,x3,y3,R1-G1-B1-A1,R2-G2-B2-A2,OPTIONS)

Draw a triangle and vertex function.

• (x1,y1),(x2,y2),(x3,y3)
• R1-G1-B1-A1 internal color
• R2-G2-B2-A2 Border Color

OPTIONS:

• aa: enable anti aliasing

Example:

• $drawtriangle(10,5,20,10,10,15,200-100-100,,aa)

$imageabs(x,y,w,h,path,OPTIONS,n,alpha,OPTIONS2)

Displays an image (path) at coordinates (x,y) with size (w,h). By default, an image is expanded to the maximum size allowed by (w,h) without changing the aspect ratio of the image. After the image has been resized (if indeed it has been), the resized version is cached in the memory, which means any further references to it will return the modified rather than original values.

Path is the absolute path of the image. It can also point to an audio file if it has an embedded image or if you are using one of the "artreader" options, and the path can include compressed archives if the "archive" option is active (see below).

Options are flags which you separate with a space.

• Resizing options
  • nokeepaspect ignores the image's aspect ratio and expands the image to fill both width and height regardless of distortion (nodisplay, archive, icon options and non-exclusive) [?]
  • noexpansion prevents resizing to fill the space if the image turns out to be smaller than the specified width and height.

• Alignment options
  • left and right determine horizontal alignment (left is default).
  • top and bottom determine vertical alignment (top is default).

• Miscellaneous options
  • wc enables wildcard characters (*,?).
  • nodisplay caches the image without actually displaying it.

• Read-mode (path-related) options
  • archive allows references to compressed archives to be included in the path. The path format is the absolute path of the archive followed by the base path within the archive file, using a pipe (|) as the separator. For example: C:\aaa\image.zip|bbb/ccc.jpg
  • icon indicates that the path is specified in the icon file (*.ico) [?].
  • artreader uses embedded images or the default album art paths you've defined in Foobar2000's options to determine the image to be displayed. The path supplied should be that of an audio file (typically, this would be %path%).
    • artreader_front, artreader_back, artreader_disc and artreader_icon are variations on this option which select the specific corresponding album art. However, the original documentation suggests one avoid these options because they seem to be slow.

n: rotateflip Index for:

• 1: 90°
• 2: 180°
• 3: 270°
• 4: flip horizontal
• 5: 90° + flip horizontal
• 6: Flipped vertically
• 7: 90° + Flip Vertically

Alpha (Opacity)

• 0-255

OPTIONS2 (shadow effect)

• Glow:expand:colour
• Offset:x:y

Examples:

• $imageabs(10,10,50,50,C:\%album%.jpg)
• $imageabs(10,10,50,50,C:\%album%.jpg,left top)
• $imageabs(10,10,50,50,C:\%album%.jpg,,6)
• $imageabs(10,10,50,50,C:\%album%.*,wc,6)
• $imageabs(10,10,50,50,C:\%album%.jpg,bottom,,128)
• $imageabs(10,10,50,50,C:\%album%.jpg,bottom,,,glow :2:0-0-0 offset: 4:4)
• $imageabs(10,10,50,50,%path%,artreader)

$imageabs_rc(rw,rh,srcx,srcy,srcw,srch,x,y,path,OPTIONS,n,alpha,OPTIONS2)

To view the clip and resize images. Path specified by the image size (rw, rh) after resizing, portion of the area (srcx, srcy, srcw, srch) coordinates (x, y) size (srcw, srch) to display. In memory (rw, rh) cache. When you evaluate the TF (rw, rh) with changes in, to refresh the image. Therefore, rw, rh is to specify a fixed value. If there are images true, if false is returned.

OPTIONS (imageabs):

• nokeepaspect: not maintain the aspect ratio
• nodisplay: Hide read only memory
• archive
• Icon
• Horizontal Alignment
  • left
  • hcener
  • right
• Vertical Alignment
  • top
  • vcenter
  • bottom

N rotateflip Index for:

• 1: 90°
• 2: 180°
• 3: 270°
• 4: flip horizontal
• 5: 90° + flip horizontal
• 6: Flipped vertically
• 7: 90° + Flip Vertically

Alpha (Opacity)

• 0-255

Examples:

• $imageabs_rc(200,100,0,0,100,50,10,10,C:\%album%.jpg,,6,192)
• $imageabs_rc(200,100,0,0,200,100,10,10,C:\%album%.jpg,,) ( = $imageabs(10,10,200,100,C:\%album%.jpg,left top,,) )
• $imageabs_rc(150,120,0,0,150,120,20,15,C:\%album%.jpg,hcenter vcenter,) ( = $imageabs(20,15,150,120,C:\%album%.jpg,,,) )

$drawimage(x,y,w,h,path,OPTIONS,n,alpha)

Displays an image at Coordinates (x,y) with size (w,h) specified by path. The function is similar to $imageabs. w and h show the size of the original if omitted. Removed from memory immediately after being displayed. TF to be reloaded each time the images are evaluated.

You can see a huge image, the amount of occupied memory?RASHITAKATTARI to see more pictures, $imageabs for those who do not like the resizing process.

OPTIONS:

• nokeepaspect: not to maintain aspect ratio
• Alignment
  • Left
  • Right
  • Top
  • Bottom

n: rotateflip index for

• 1: 90°
• 2: 180°
• 3: 270°
• 4: flip horizontal
• 5: 90° + flip horizontal
• 6: Flipped vertically
• 7: 90° + Flip Vertically

alpha: 0-255

• Opacity (transparency)

Additional drawing functions

$getlastpos(elem)

Display function imageabs, imageabs_rc right after, to get the coordinates to draw a picture. Also, $measurestring use them when you get the results. If you are drawString, mempos available only immediately after the specified coordinates.

Elem element to retrieve.

X: left
Y: top
W: width
H: height
R: right
B: bottom

Example:

$setworldtransform(2)
$puts(img_path,C:\%album%.jpg)
$imageabs(10,4,100,100,$get(img_path),top noexpansion,)
$imageabs($getlastpos(x),$getlastpos(b),$getlastpos(w),20,$get(img_path),top nokeepaspect,6)
$gradientrect($getlastpos(x),$getlastpos(y),$getlastpos(w),$getlastpos(h),%el_backcolour%-128,%el_backcolour%-255)
$setworldtransform(0)

$measurestring(text,x,y,W,H,OPTIONS)

$drawstring to calculate the area when drawing text. As a result, returns to the horizontal width of the viewing area. The display area is to get $getlastpos. OPTIONS is the same as $drawstring. If $drawstring uses the glow_aa or glow options, the $measurestring value returned may not be accurate.

$getimagewidth(path),$getimageheight(path)

The image path is specified in $imageabs $imageabs_rc of cache memory. If the image has been resized in the horizontal width and vertical width it returns the respective values. This means that only have $imageabs $imageabs_rc behind. nokeepaspect may be able to calculate the aspect ratio should be applied.

$setpercentmode(bx,by,bw,bh)

Set the mode to specify the coordinates. Window space (0,0) ~ (%_width%,%_height%) where a, percentage specified in the mode, (0,0) to (100100) mapping.

• x,y,W,H, can be set individually.
• x,y,W,H, all affect the function of one argument.

• bx x coordinate specified mode
  • 0: Splitter mode specified in absolute coordinates
  • 1: Splitter value relative to the size (percentage) and designated.
• mode specified by y coordinates
• bw w coordinates specified mode
• bh h coordinates specified mode

$getsyscolour (index)

The r-g-b color system in the fo

index: [0-30] color index system

$averagecolour(colour1,colour2[,···])

Calculates the average color R-g-b-a of a given set of colors.

(Colour1 + colour2 +···) / N

$blendcolour(colour1,w1,colour2,w2,[,···])

Calculates the average weighted w1,w2[,···] color R-g-b-a of a given set of colors.

(w1 * colur1 + w2 * colour2 +···+ wN * colourN) / (w1 + w2 +···+ wN)

$addcolour(colour1,colour2[,···])

Adds colors r-g-b-a of a given set.

Colour1 + colour2 + ··· + colourN

$subcolour(colour1,colour2[,···])

Substracts colors r-g-b-a of a given set.

Colour1 - colour2 - colour3···- colourN

General-purpose system functions

$findfile(path,[path2,path3,...])

Determinates whether the specified file(s) exist(s) and returns the first file. If you do not have the file does not return anything. (Strictly speaking, "false" returns). Path can be specified. The path allows wildcards.

Function buttons

$textbutton(x,y,w,h,text,mover_text,command,options1,options2)

Create a button. Per Track only available. Per Second is not to write.

• text: the button label
• mover_text: the button label when mouse over

command: "Type of instruction: arguments" specified in the form of

• be no extra spaces
• Going to be separated by a specified multiple orders.
• A few instructions that can be specified.
• Very difficult to implement. . .
• And the splitter so that the characters and words in these arguments, could not parse well.

Note 1: Do not specify the order processing time. Note 2: If you specify more than one instruction, the instruction execution order is not guaranteed. Especially if WINDOWSIZE and COMMAND is specified, WINDOWSIZE probably be better to run. COMMAND, CONTEXT and others, the order may be warranted.

Command: command_path

• command_path to run the command specified by menu.
• COMMAND: View / Equalizer and COMMAND: File / Preferences; COMMAND: Playback / Play
• To specify that you can use the input help in setting some of them.
• TF command_path Note also that as COMMAND: 'View / Equalizer' and it's recommended.

Context: context_path

• context_path KONTEKISUTOMENYUKOMANDO be designated to perform.
• Handles the context menu of the currently playing track.
• CONTEXT: Properties to specify the like.
• TF context_path Note also that as

Panelshow: cap: sh

• The caption of the child panel cap / hide.
• sh: 0 hide
  • 1.
  • -1 Show / hide toggle

TFMode: mode

• Per Track titleformat to change the mode.
• mode: 0 nowplaying mode
  • 1 follow curosr mode
  • -1 Toggle

Windowsize: width:height

• Sets the size of the entire foobar2000 window.

Setglobal: name:value

Refresh: TF of PerTrack, PerSecond update.

options1

specify the default decoration (can specify more than one, separated by spaces)

• fontcolor: r-g-b color of the text
• brushcolor: r-g-b-a color fills the rectangle button
• pencolor: r-g-b-a color button border
• left top bottom right position of the text

options2:

decorative specify when mouse over (can specify more than one, separated by spaces)

• fontcolor: r-g-b color of the text
• brushcolor: r-g-b-a color fills the rectangle button
• pencolor: r-g-b-a color button border
• left top bottom right position of the text

Examples:

• $textbutton (0,0,80,20,play,play,COMMAND: Playback / Play,fontcolor:64-64-64 brushcolor:192-192-192-128 pencolor:0-0-0-0,fontcolor:32-32-32)
• $textbutton (100,0,80,20,Resize,Resize,PANELSHOW:aaa:-1;REFRESH,fontcolor:64-64-64 left bottom,fontcolor:32-32-32)

$imagebutton(x,y,w,h,path,mover_path,command,options1,options2)

Create an image button. Per Track only available. Per Second is not to write. The internal processing of the images are treated equally and $imageabs will be cached in memory. w, h is omitted, path to original image size is specified. textbutton command is common.

Display options:

OPTIONS1

• nokeepaspect
• left
• top
• bottom
• right

OPTIONS2:

When mouse over the image display options

• nokeepaspect
• left
• top
• bottom
• right

GDI drawing functions

Using the Windows System Component GDI to draw. GDI functions are usually faster, but they do not allow alpha blending and shadow effects (glow).

$drawtext(text,x,y,W,H,r-g-b,OPTIONS)

GDI text drawing functions. Text coordinates (x, y) in output

OPTIONS:

• Align left hcenter right specified horizontal
• Align specified top vcenter bottom vertical
• Not noclip clip

$drawtextex(text,x,y,W,H,r-g-b,OPTIONS)

GDI drawing functions text_2 Text coordinates (x, y) in output

OPTIONS

• Align left hcenter right specified horizontal
• Align specified top vcenter bottom vertical
• Not noclip clip
• Allow specified wrap wraparound (vcenter, bottom and exclusive)
• end_ellipsis If you clip text, replace the end of the text ...

Example: $drawtextex(text,0,0,%_width%,%_height%,0-0-0,hcenter vcenter end_ellipsis)

$gettextwidth(text,[FONTNAME,SIZE,OPTIONS])

For the use with GDI text functions (drawtext, drawtextex). Returns the width in the text when drawing horizontal text. Optionaly the font can be specified FONTNAME, SIZE and OPTIONS (bold, italic, etc).

$gettextheight([FONTNAME,SIZE,OPTIONS])

For the use with GDI text functions (drawtext, drawtextex). Returns vertical width of text. can specify the font ($ font option). Optionaly the font can be specified FONTNAME, SIZE and OPTIONS (bold, italic, etc).

$fillrect(x,y,w,h,r-g-b,RESERVED)

Filled rectangle function

$fillroundrect(x,y,w,h,w2,h2,r1-g1-b1,r2-g2-b2)

Function of the fill rectangle with rounded corners

Panel operating system functions

Apparently drawing functions and the TF is such low efficiency of the frame together, Future plans to??.

$showpanel(i,sh) or $showpanel_c(caption,sh)

Panel, change the function inactive

• i: somethingth in the child panel list (counting from 0)
• sh: 0: Inactive 1: View

$movepanel(i,x,y,W,H,) or $movepanel_c(caption,x,y,W,H,)

i: something in the child panel list (counting from 0)

Panel Force layout only for the specified coordinates (x, y) size (w, h) to move on.

$getcaption(i)

i: returns the list of child panel captions are set in the second panel.

$isvisible_c(caption)

Returns the status panel.

External links

• Official page with download link (Japanese)
• Discussion thread