Hydrogenaudio Knowledgebase - User contributions [en]

Foobar2000:Title Formatting Reference

2009-10-08T16:21:10Z

Chiwou: /* $char(x) */

{{fb2k}}
This article contains information about built-in titleformatting functions and field references with special meaning. References to documentation about fields and function which can only be used in specific components or which are provided by specific components can be found at the end of this article.

A field reference is a field name enclosed in percent signs, for example ''%artist%''. A function call starts with a dollar sign, followed by the function name and the parameter list. A parameter list can either be empty - denoted as ''()'' - or contain one or more parameters separated by commata, for example ''$abbr(%artist%)''. Note that there must be no whitespace between the dollar sign and the function name, or the function name and the opening parenthesis of the parameter list.

Please see [[Foobar2000:Title Formatting Introduction|Title Formatting Introduction]] for a presentation of titleformat syntax in general. For details of the query syntax, which uses these fields, see: [[Foobar2000:Query_syntax|Query Syntax]].

= Field remappings =

Some of the fields accessible through ''%name%'' are remapped to other values to make writing titleformat scripts more convenient.

== Metadata ==

=== %album artist% ===
Name of the artist of the album specified track belongs to. Checks following metadata fields, in this order: "album artist", "artist", "composer", "performer". The difference between this and ''%artist%'' is that ''%album artist%'' is intended for use where consistent value across entire album is needed even when per-track artists values vary.

=== %album% ===
Name of the album specified track belongs to. Checks following metadata fields, in this order: "album", "venue".

=== %artist% ===
Name of the artist of the track. Checks following metadata fields, in this order: "artist", "album artist", "composer", "performer". For a SHOUTcast stream which contains metadata, it is the StreamTitle up to the first "-" character.

=== %discnumber% ===
Index of disc specified track belongs to, within the album. Available only when "discnumber"/"disc" field is present in track’s metadata.

=== %track artist% ===
Name of the artist of the track; present only if ''%album artist%'' is different than ''%artist%'' for specific track. Intended for use together with ''%album artist%'', to indicate track-specific artist info, e.g. "%album artist% - %title%[ '//' %track artist%]". In this case, the last part will be displayed only when track-specific artist info is present.

=== %title% ===
Title of the track. If "title" metadata field is missing, file name is used instead. For a SHOUTcast stream which contains metadata, it is the StreamTitle after the first "-" character.

=== %tracknumber% ===
Two-digit index of specified track within the album. Available only when "tracknumber" field is present in track’s metadata.

== Technical information ==

=== %bitrate% ===
Bitrate of the track; includes dynamic VBR bitrate display for currently played track.

=== %channels% ===
Number of channels in the track (mono/stereo/etc). Returns the number of channels in text form; returns "mono" and "stereo" instead of "1" and "2".

=== %filesize% ===
Defined as ''%_filesize%''. Returns the filesize in bytes.

=== %filesize_natural% ===
Size of the file, automatically formatted in appropriate units such as megabytes or kilobytes.

=== %samplerate% ===
Sample rate of the track, in Hz.

=== %codec% ===
Name of codec used to encode the track. If exact codec name is not available, file extension is used.

== Special fields ==

= Control flow =

The functions in this section can be used to conditionally execute statements.

=== [...] (conditional section) ===

Evaluates the expression between ''['' and '']''. If it has the truth value ''true'', its string value and the truth value ''true'' are returned. Otherwise an empty string and ''false'' are returned.

Example: ''[%artist%]'' returns the value of the artist tag, if it exists. Otherwise it returns nothing, when ''artist'' would return "?".

=== $if(cond,then) ===

If ''cond'' evaluates to ''true'', the ''then'' part is evaluated and its value returned. Otherwise, ''false'' is returned.

=== $if(cond,then,else) ===

If ''cond'' evaluates to ''true'', the ''then'' part is evaluated and its value returned. Otherwise, the ''else'' part is evaluated and its value returned.

=== $if2(a,else) ===

Like ''$if(a,a,else)'' except that ''a'' is only evaluated once.

=== $if3(a1,a2,...,aN,else) ===

Evaluates arguments ''a1'' ... ''aN'', until one is found that evaluates to ''true''. If that happens, its value is returned. Otherwise the ''else'' part is evaluated and its value returned.

=== $ifequal(n1,n2,then,else) ===

Compares the integer numbers ''n1'' and ''n2'', if ''n1'' is equal to ''n2'', the ''then'' part is evaluated and its value returned. Otherwise the ''else'' part is evaluated and its value returned.

=== $ifgreater(n1,n2,then,else) ===

Compares the integer numbers ''n1'' and ''n2'', if ''n1'' is greater than ''n2'', the ''then'' part is evaluated and its value returned. Otherwise the ''else'' part is evaluated and its value returned.

=== $iflonger(s1,s2,then,else) ===

Compares the length of the strings ''s1'' and ''s2'', if ''s1'' is longer than ''s2'', the ''then'' part is evaluated and its value returned. Otherwise the ''else'' part is evaluated and its value returned.

=== $select(n,a1,...,aN) ===

If the value of ''n'' is between 1 and N, ''an'' is evaluated and its value returned. Otherwise ''false'' is returned.

= Arithmetic functions =

The functions in this section can be used to perform arithmetic on integer numbers. A string will be automatically converted to a number and vice versa. The conversion to a number uses the longest prefix of the string, that can be interpreted as number. Leading whitespace is ignored.

Example: "c3po" → 0, " -12" → -12, but "- 12" → 0

=== $add(a,b) ===

Adds ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$add(a,b,...)'' is the same as ''$add($add(a,b),...)''.

=== $div(a,b) ===

Divides ''a'' through ''b''. If ''b'' evaluates to zero, it returns ''a''.

Can be used with an arbitrary number of arguments. ''$div(a,b,...)'' is the same as ''$div($div(a,b),...)''.

=== $greater(a,b) ===

Returns true, if ''a'' is greater than ''b'', otherwise false.

=== $max(a,b) ===

Returns the maximum of ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$max(a,b,...)'' is the same as ''$max($max(a,b),...)''.

=== $min(a,b) ===

Returns the minimum of ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$min(a,b,...)'' is the same as ''$min($min(a,b),...)''.

=== $mod(a,b) ===

Computes the remainder of dividing ''a'' through ''b''. The result has the same sign as ''a''. If ''b'' evaluates to zero, the result is ''a''.

Can be used with an arbitrary number of arguments. ''$mod(a,b,...)'' is the same as ''$mod($mod(a,b),...)''.

=== $mul(a,b) ===

Multiplies ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$mul(a,b,...)'' is the same as ''$mul($mul(a,b),...)''.

=== $muldiv(a,b,c) ===

Multiplies ''a'' and ''b'', then divides by ''c''. The result is rounded to the nearest integer.

=== $rand() ===

Generates a random number in the range from 0 to 232-1. Available only in sort-related contexts, such as the ''Edit → Sort → Sort by ...'' menu command.

=== $sub(a,b) ===

Subtracts ''b'' from ''a''.

Can be used with an arbitrary number of arguments. ''$sub(a,b,...)'' is the same as ''$sub($sub(a,b),...)''.

= Boolean functions =

The functions in this section can be used to work with truth values (''true'' and ''false''), which have no explicit representation in titleformat scripts. They do not return a string or number value. You can use them for more complex conditions with ''$if'' and related functions.

=== $and(...) ===

Logical And of an arbitrary number of arguments. Returns ''true'', if and only if all arguments evaluate to ''true''.

Special case: ''$and(x,y)'' is ''true'', if both ''x'' and ''y'' are ''true''. Otherwise it is ''false''.

=== $or(...) ===

Logical Or of an arbitrary number of arguments. Returns ''true'', if at least one argument evaluates to ''true''.

Special case: ''$or(x,y)'' is ''true'', if ''x'' or ''y'' is ''true'', or if both are ''true''. Otherwise it is ''false''.

=== $not(x) ===

Logical Not. Returns ''false'', if ''x'' is ''true'', otherwise it returns ''true''.

=== $xor(...) ===

Logical Exclusive-or of an arbitrary number of arguments. Returns ''true'', if an odd number of arguments evaluate to ''true''.

Special case: ''$xor(x,y)'' is ''true'', if one of ''x'' and ''y'' is ''true'', but not both. Otherwise it is ''false''.

= Color functions =

=== $blend(color1,color2,part,total) ===

Returns a color that is a blend between ''color1'' and ''color2''. If ''part'' is smaller than or equal to zero, ''color1'' is returned. If ''part'' is greater than or equal to ''total'', ''color2'' is returned. Otherwise a blended color is returned that is ''part'' parts ''color1'' and ''total''-''part'' parts ''color2''. The blending is performed in the RGB color space.

=== $hsl() ===

Resets the text color to the default color.

=== $hsl(h,s,l) ===

Sets the color for text in the HSL color space. ''h'', ''s'' and ''l'' are the hue, saturation, and lightness of the color for unselected text. The color for selected text is set to the inverse color.
The ranges of ''h'', ''s'', and ''l'' are from 0 to 240; the function is designed to interpret those values in the same way as the standard Windows color dialog.

=== $hsl(h1,s1,l1,h2,s2,l2) ===

Sets the color for text in the HSL color space. ''h1'', ''s1'' and ''l1'' are the hue, saturation, and lightness of the color for unselected text. ''h2'', ''s2'' and ''l2'' are the hue, saturation, and lightness of the color for selected text.

=== $rgb() ===

Resets the text color to the default color.

=== $rgb(r,g,b) ===

Sets the color for text. ''r'', ''g'' and ''b'' are the red, green and blue component of the color for unselected text. The color for selected text is set to the inverse color.

=== $rgb(r1,g1,b1,r2,g2,b2) ===

Sets the color for text. ''r1'', ''g1'' and ''b1'' are the red, green and blue component of the color for unselected text. ''r2'', ''g2'' and ''b2'' are the red, green and blue component of the color for selected text.

=== $transition(string,color1,color2) ===

Inserts color codes into ''string'', so that the first character has ''color1'', the last character has ''color2'', and intermediate characters have blended colors. The blending is performed in the RGB color space. Note that color codes are additional characters that will also be counted by string manipulation functions. For example, if you need to truncate a string, you should do this before applying ''$transition''.

= Now playing info =
The following functions and fields are usable for scripts used with the currently playing item, for example the status bar, the main window title and the copy command script.

== Special fields ==

=== %playback_time% ===
Returns the elapsed time formatted as [HH:]MM:SS.

=== %playback_time_seconds% ===
Returns elapsed time in seconds.
Old version: <code>%_time_elapsed%</code>

=== %playback_time_remaining% ===
Returns remaining time until track ends, formatted as [HH:]MM:SS.
Old version: <code>%_time_remaining%</code>

=== %playback_time_remaining_seconds% ===
Returns remaining time in seconds.
Old version: <code>%_time_remaining_seconds%</code>

=== %length% ===
Returns the length of the track formatted as hours, minutes, and seconds.
Old version: <code>%_time_total%</code>

=== %length_ex% ===
Returns the length of the track formatted as hours, minutes, seconds, and milliseconds.

=== %length_seconds% ===
Returns the length of the track in seconds.
Old version: <code>%_time_total_seconds%</code>

=== %length_seconds_fp% ===
Returns the length of the track in seconds as floating point number.

=== %length_samples% ===
Returns the length of the track in samples.

= Playlist info =
The following functions and fields are usable for playlist display formatting (eg. per-column title formatting patterns).

== Special fields ==

=== %isplaying% ===

Returns "1" if file is currently playing and empty string otherwise.

=== %ispaused% ===

Returns "1" if playback is paused, empty string otherwise.

=== %list_index% ===

Returns a zero-padded playlist index of specified item. The first item is at index 1.

=== %list_total% ===

Returns number of items in the playlist.

=== %queue_index% ===

Index of the specified item in the playback queue; available in playlist only. If the item has been queued multiple times, %queue_index% evaluates to the first index.

=== %queue_indexes% ===

List of indexes of the specified item in the playback queue; available in playlist only. Same as %queue_index% unless the item has been queued more than once.

=== %queue_total% ===

Total amount of tracks in playback queue. Available only for queued tracks, for technical reasons.

= String functions =

The functions in this section can be used to manipulate character strings.

=== $abbr(x) ===

Returns abbreviation of ''x''.

=== $abbr(x,len) ===

Returns abbreviation of ''x'', if ''x'' is longer than ''len'' characters, otherwise returns ''x''.

=== $ansi(x) ===

Converts ''x'' to system codepage and back. Any characters that are not present in the system codepage will be removed / replaced. Useful for mass-renaming files to ensure compatibility with non-unicode-capable software.

=== $ascii(x) ===

Converts ''x'' to ASCII. Any characters that are not present in ASCII will be removed / replaced.

=== $caps(x) ===

Converts first letter in every word of x to uppercase, and all other letters to lowercase.

=== $caps2(x) ===

Converts first letter in every word of x to uppercase, and leaves all other letters as they are.

=== $char(x) ===

Inserts Unicode character with code ''x''. You can search for characters and find the matching decimal number on this [http://www.fileformat.info/info/unicode/char/search.htm site].

=== $crc32(a) ===

Computes the CRC32 of the string ''a'' as a number. Intended for use in coloring scripts.

Example: $rgb($mod($crc32(%album%),256),128,128)

=== $crlf() ===

Inserts end-of-line marker (carriage return, line feed). Can be used to generate multiple lines in the output, for example for the tooltip of the system notification area ("systray") icon.

=== $cut(a,len) ===

Returns first ''len'' characters on the left of ''a''.

=== $directory(x) ===

Extracts directory name from the file path ''x''.

=== $directory(x,n) ===

Extracts directory name from the file path ''x''; goes up by ''n'' levels.

=== $directory_path(x) ===

Extracts directory path from the file path ''x''.

=== $ext(x) ===

Extracts file extension from ''x'' which must be a file name or path.

=== $filename(x) ===

Extracts file name from full path.

=== $fix_eol(x) ===

If ''x'' contains an end-of-line marker (CR-LF), the end-of-line marker and all text to the right of it is replaced by " (...)". Otherwise ''x'' is returned unaltered.

=== $fix_eol(x,indicator) ===

If ''x'' contains an end-of-line marker (CR-LF), the end-of-line marker and all text to the right of it is replaced by ''indicator''. Otherwise ''x'' is returned unaltered.

=== $hex(n) ===

Formats the integer number ''n'' in hexadecimal notation.

=== $hex(n,len) ===

Formats the integer number ''n'' in hexadecimal notation with ''len'' digits. Pads with zeros from the left if necessary.

=== $insert(a,b,n) ===

Inserts ''b'' into ''a'' after ''n'' characters.

=== $left(a,len) ===

Returns the first ''len'' characters from the left of ''a''.

=== $len(a) ===

Returns length of string ''a'' in characters.

=== $len2(a) ===

Returns length of string x in characters, respecting double-width character rules (double-width characters will be counted as two).

=== $longer(a,b) ===

Returns ''true'', if string ''a'' is longer than string ''b'', false otherwise.

=== $lower(a) ===

Converts ''a'' to lowercase.

=== $longest(a,...) ===

Returns the longest of its arguments. Can be used with an arbitrary number of strings.

=== $num(n,len) ===

Formats the integer number ''n'' in decimal notation with ''len'' digits. Pads with zeros from the left if necessary.

=== $pad(x,len) ===

Pads ''x'' from the left with spaces to ''len'' characters.

=== $pad_right(x,y) ===

Pads ''x'' from the right with spaces to ''len'' characters.

=== $pad(x,len,char) ===

Pads ''x'' from the left with ''char'' to ''len'' characters.

=== $pad_right(x,len,char) ===

Pads ''x'' from the right with ''char'' to ''len'' characters.

=== $padcut(x,len) ===

Returns first ''len'' characters from the left of ''x'', if ''x'' is longer than ''len'' characters. Otherwise pads ''x'' from the left with spaces to ''len'' characters.

=== $padcut_right(x,len) ===

Returns first ''len'' characters from the left of ''x'', if ''x'' is longer than ''len'' characters. Otherwise pads ''x'' from the right with spaces to ''len'' characters.

=== $progress(pos,range,len,a,b) ===

Creates a progress bar: ''pos'' contains position, ''range'' contains range, ''len'' progress bar length in characters, ''a'' and ''b'' are characters to build progress bar with.

Example:''$progress(%_time_elapsed_seconds%, %_time_total_seconds%, 20,'#','=')'' produces "====#===============", the # character is moving with playback position.

=== $progress2(pos,range,len,a,b) ===

Creates a progress bar: ''pos'' contains position, ''range'' contains range, ''len'' progress bar length in characters, ''a'' and ''b'' are characters to build progress bar with. Produces different appearance than ''$progress''.

=== $repeat(a,n) ===

Returns ''n'' copies of ''a''. Note that ''a'' is evaluated once before its value is used, so ''$repeat'' cannot be used for loops.

=== $replace(a,b,c) ===

Replaces all occurrences of string ''b'' in string ''a'' with string ''c''.

Can also be used with an arbitrary number of arguments. Note that ''$replace(a,b1,c1,b2,c2)'' is generally not the same as ''$replace($replace(a,b1,c1),b2,c2)''.

Example: ''$replace(ab,a,b,b,c)'' → "bc", ''$replace($replace(ab,a,b),b,c)'' → "cc"

=== $right(a,len) ===

Returns the first ''len'' characters from the right of ''a''.

=== $roman(n) ===

Formats the integer number ''n'' in roman notation.

=== $rot13() ===

Performs [http://en.wikipedia.org/wiki/ROT13 ROT13] transformation to given string.

Example: ''$rot13('foobar2000')'' → "sbbone2000".

=== $shortest ===

Returns the shortest of its arguments. Can be used with an arbitrary number of strings.

=== $strchr(s,c) ===

Finds first occurence of character ''c'' in string ''s''.

Example: ''$strchr(abca,a)'' → 1

=== $strrchr(s,c) ===

Finds last occurence of character ''c'' in string ''s''.

Example: ''$strrchr(abca,a)'' → 4

=== $strstr(s1,s2) ===

Finds first occurence of string ''s2'' in string ''s1''.

=== $strcmp(s1,s2) ===

Performs a case-sensitive comparison of the strings ''s1'' and ''s2''.

=== $stricmp(s1,s2) ===

Performs a case-insensitive comparison of the strings ''s1'' and ''s2''.

=== $substr(s,m,n) ===

Returns substring of string ''s'', starting from ''m''-th character and ending at ''n''-th character.

=== $stripprefix(x) ===

Removes ''A'' and ''The'' prefixes from x.

=== $stripprefix(x,prefix1,prefix2,...) ===

Removes the specified prefixes from x.

=== $swapprefix(x) ===

Moves ''A'' and ''The'' prefixes to the end of x.

=== $swapprefix(x,prefix1,prefix2,...) ===

Moves the specified prefixes to the end of x.

=== $trim(s) ===

Removes leading and trailing spaces from string ''s''.

=== $tab() ===

Inserts one tabulator character.

=== $tab(n) ===

Inserts ''n'' tabulator characters.

=== $upper(s) ===

Converts string ''s'' to uppercase.

= Track info =

The functions and fields in this section can be used to access information about tracks. See [[Foobar2000:0.9 Track Info Panel Mod (foo uie trackinfo mod)|this]] for more info about Track info mod.

== Metadata ==

=== $meta(name) ===
Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ", " as separator.

Example: ''$meta(artist)'' → "He, She, It"

=== $meta(name,n) ===
Returns value of ''n''-th (0,1,2 and so on) tag called ''name''.

Example: ''$meta(artist,1)'' → "She"

=== $meta_sep(name,sep) ===
Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ''sep'' as separator.

Example: ''$meta_sep(artist,' + ')'' → "He + She + It"

=== $meta_sep(name,sep,lastsep) ===
Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ''sep'' as separator between all but the last two values which are concatenated with ''lastsep''.

Example: ''$meta_sep(artist,', ',', and ')'' → "He, She, and It"

=== $meta_test(...) ===
Returns ''1'', if all given tags exist, ''undefined'' otherwise.

Example: ''$meta_test(artist,title)'' → true

=== $meta_num(name) ===
Returns the number of values for the tag called ''name''.

Example: ''$meta_num(artist)'' → 3

== Technical information ==

=== $info(name) ===
Returns value of technical information field called ''name''.

For convenience, the '''%__name%''' alias is also available.

Example: ''$info(channels)'' → 2

Here is an '''informative''' list of recognized fields. Some of these depend on the media file type being queried.

{| border="0" cellspacing="0" cellpadding="2"
! field name
! Description
|-
| colspan="2" style="background-color:#CCF"|'''General'''
|-
|codec
| style="background-color:#EEF"|'''Codec''' (''e.g.'' MP3)
|-
|codec_profile
| style="background-color:#EEF"|'''Codec Profile''' (''e.g.'' CBR)
|-
|samplerate
| style="background-color:#EEF"|'''Sample Rate''', in hertz (''e.g.'' 44100)
|-
|bitrate
| style="background-color:#EEF"|'''Bitrate''', in kilobits per second (''e.g.'' 320)
|-
|tool
| style="background-color:#EEF"|'''Tool''' used to produce the file, possibly guessed (''e.g.'' LAME3.97)
|-
|encoding
| style="background-color:#EEF"|'''Encoding''' lossiness (''e.g.'' lossy)
|-
|channels
| style="background-color:#EEF"|'''Channels''' count (''e.g.'' 2 <nowiki>[for stereo]</nowiki>)
|-
|bitspersample
| style="background-color:#EEF"|'''Bits Per Sample''' (''e.g.'' 16)
|-
|tagtype
| style="background-color:#EEF"|'''Tag Type''', comma-separated list of tag formats (''e.g.'' id3v2|apev2)
|-
|cue_embedded
| style="background-color:#EEF"|'''Embedded Cuesheet''' presence (''e.g.'' no <nowiki>[may be empty!]</nowiki>)
|-
|md5
| style="background-color:#EEF"|'''Audio MD5''' hash, if container defines it (''e.g.'' 1E24A910D91EF09A8CF403C9B6963961)
|-
| colspan="2" style="background-color:#CCF"|'''Other'''
|-
|ENC_DELAY
| style="background-color:#EEF"|LAME proprietary MP3 '''enc_delay''' value (''e.g.'' 576)
|-
|ENC_PADDING
| style="background-color:#EEF"|LAME proprietary MP3 '''enc_padding''' value (''e.g.'' 1536)
|-
|MP3_ACCURATE_LENGTH
| style="background-color:#EEF"|'''mp3_accurate_length''' supported (LAME proprietary header)? (''e.g.'' yes)
|-
|MP3_STEREO_MODE
| style="background-color:#EEF"|Stereo mode used in MP3 file (''e.g.'' mono, stereo, joint stereo, etc.)
|-
|VERSION
| style="background-color:#EEF"|'''Version''' of tool (''e.g.'' 3.99)
|-
|FLAGS
| style="background-color:#EEF"|'''Flags''' of tool (''e.g.'' 22)
|}

=== $channels() ===
Returns number of channels in text format.

Example: ''$channels()'' → "stereo"

=== %replaygain_album_gain% ===

Returns ReplayGain album gain value.

=== %replaygain_album_peak% ===

Returns ReplayGain album peak value.

=== %replaygain_track_gain% ===

Returns ReplayGain track gain value.

=== %replaygain_track_peak% ===

Returns ReplayGain track peak value.

== Special fields ==

==== %filename% ====

Returns the filename without directory and extension.

==== %filename_ext% ====

Returns the filename with extension, but without the directory.

==== %directoryname% ====

Returns the name of the parent directory only, not the complete path.

==== %last_modified% ====

Returns the date and time the file was last modified. Eg: ''2005-12-22 00:04:10''

==== %path% ====

Returns the path.

==== %_path_raw% ====

Returns the path as URL including the protocol scheme.

==== %subsong% ====

Returns the subsong index. The subsong index is used to distuingish multiple tracks in a single file, for example for cue sheets, tracker modules and various container formats.

==== %_foobar2000_version% ====
Returns a string representing the version of foobar2000.

= Time/Date Functions =

These functions are used to manipulate time/date strings, notably (but not limited to), [[Foobar2000:Titleformat_Playback_Statistics|those gathered]] by the [[Foobar2000:Components_0.9/Playback_Statistics_(foo_playcount)|Playback Statistics component]].

=== $year(time) ===

Retrieves the year part (formatted as four digits) from a time/date string.

=== $month(time) ===

Retrieves the month part (formatted as two digits) from a time/date string.

=== $day_of_month(time) ===

Retrieves the day of month part (formatted as two digits) from a time/date string.

=== $date(time) ===

Retrieves the date part (formatted as YYYY-MM-DD) from a time/date string.

=== $time(time) ===

Retrieves the time part (formatted as HH:MM:SS or HH:MM) from a date/time string.

= Variable operations =

Variables can be used to store strings and number. They cannot store truth values. They are best used to store intermediate results that you need multiple times. Variable names are not case-sensitive.

For example:
{| border="0" cellspacing="0" cellpadding="2"
! code
! output
|-
|<pre>$put(foo,bar)$char(10)
$get(foo)$char(10)
$get(Foo)$char(10)
$puts(foo,2000)$char(10)
$get(foo)$char(10)</pre>
| style="background-color:#EEF" |<pre>bar
bar
bar

2000</pre>
|}
=== $get(name) ===

Returns the value that was last stored in the variable ''name'', if the variable was not defined (yet), it returns nothing. The truth value returned by ''$get'' indicates if the variable ''name'' was defined

=== $put(name,value) ===

Stores ''value'' in the variable ''name'' and returns ''value'' unaltered

=== $puts(name,value) ===

Stores ''value'' in the variable ''name'' and returns nothing

= Component-provided fields and functions on tracks =

This section lists components that provide additional fields and functions that are useable in the context of any track.

== Playback statistics ==

* [http://www.foobar2000.org/components/view/foo_playcount Playback statistics homepage]
* [[Foobar2000:Titleformat Playback Statistics|Playback statistics titleformat reference]]

= Component-specific fields and functions =

This section lists components that provide additional fields and functions that are only usable in the context of the particular component.

== Album list ==

* [[Foobar2000:Preferences:Album List|Preferences: Album List]]

== Columns UI ==

* [http://music.morbo.org/wiki/columns_ui:manual Columns UI homepage]
* [http://music.morbo.org/wiki/columns_ui:config:global_variables Global variables reference]
* [http://music.morbo.org/wiki/columns_ui:config:colour_string Playlist colors reference]
* [http://music.morbo.org/wiki/columns_ui:config:playlist_switcher_titleformatting Playlist switcher reference]

= Additional Reading =

* [[Foobar2000:Titleformat_Introduction|Introduction to titleformat scripts]]
* '''titleformat_help.html''' in your Foobar2000 directory (ie C:\Program Files\foobar2000\titleformat_help.html) file:///C:/Program%20Files/foobar2000/titleformat_help.html

[[Category:foobar2000 Guides|Titleformat Reference]]

Foobar2000:Title Formatting Reference

2009-10-08T16:20:42Z

Chiwou: /* $char(x) */

{{fb2k}}
This article contains information about built-in titleformatting functions and field references with special meaning. References to documentation about fields and function which can only be used in specific components or which are provided by specific components can be found at the end of this article.

A field reference is a field name enclosed in percent signs, for example ''%artist%''. A function call starts with a dollar sign, followed by the function name and the parameter list. A parameter list can either be empty - denoted as ''()'' - or contain one or more parameters separated by commata, for example ''$abbr(%artist%)''. Note that there must be no whitespace between the dollar sign and the function name, or the function name and the opening parenthesis of the parameter list.

Please see [[Foobar2000:Title Formatting Introduction|Title Formatting Introduction]] for a presentation of titleformat syntax in general. For details of the query syntax, which uses these fields, see: [[Foobar2000:Query_syntax|Query Syntax]].

= Field remappings =

Some of the fields accessible through ''%name%'' are remapped to other values to make writing titleformat scripts more convenient.

== Metadata ==

=== %album artist% ===
Name of the artist of the album specified track belongs to. Checks following metadata fields, in this order: "album artist", "artist", "composer", "performer". The difference between this and ''%artist%'' is that ''%album artist%'' is intended for use where consistent value across entire album is needed even when per-track artists values vary.

=== %album% ===
Name of the album specified track belongs to. Checks following metadata fields, in this order: "album", "venue".

=== %artist% ===
Name of the artist of the track. Checks following metadata fields, in this order: "artist", "album artist", "composer", "performer". For a SHOUTcast stream which contains metadata, it is the StreamTitle up to the first "-" character.

=== %discnumber% ===
Index of disc specified track belongs to, within the album. Available only when "discnumber"/"disc" field is present in track’s metadata.

=== %track artist% ===
Name of the artist of the track; present only if ''%album artist%'' is different than ''%artist%'' for specific track. Intended for use together with ''%album artist%'', to indicate track-specific artist info, e.g. "%album artist% - %title%[ '//' %track artist%]". In this case, the last part will be displayed only when track-specific artist info is present.

=== %title% ===
Title of the track. If "title" metadata field is missing, file name is used instead. For a SHOUTcast stream which contains metadata, it is the StreamTitle after the first "-" character.

=== %tracknumber% ===
Two-digit index of specified track within the album. Available only when "tracknumber" field is present in track’s metadata.

== Technical information ==

=== %bitrate% ===
Bitrate of the track; includes dynamic VBR bitrate display for currently played track.

=== %channels% ===
Number of channels in the track (mono/stereo/etc). Returns the number of channels in text form; returns "mono" and "stereo" instead of "1" and "2".

=== %filesize% ===
Defined as ''%_filesize%''. Returns the filesize in bytes.

=== %filesize_natural% ===
Size of the file, automatically formatted in appropriate units such as megabytes or kilobytes.

=== %samplerate% ===
Sample rate of the track, in Hz.

=== %codec% ===
Name of codec used to encode the track. If exact codec name is not available, file extension is used.

== Special fields ==

= Control flow =

The functions in this section can be used to conditionally execute statements.

=== [...] (conditional section) ===

Evaluates the expression between ''['' and '']''. If it has the truth value ''true'', its string value and the truth value ''true'' are returned. Otherwise an empty string and ''false'' are returned.

Example: ''[%artist%]'' returns the value of the artist tag, if it exists. Otherwise it returns nothing, when ''artist'' would return "?".

=== $if(cond,then) ===

If ''cond'' evaluates to ''true'', the ''then'' part is evaluated and its value returned. Otherwise, ''false'' is returned.

=== $if(cond,then,else) ===

If ''cond'' evaluates to ''true'', the ''then'' part is evaluated and its value returned. Otherwise, the ''else'' part is evaluated and its value returned.

=== $if2(a,else) ===

Like ''$if(a,a,else)'' except that ''a'' is only evaluated once.

=== $if3(a1,a2,...,aN,else) ===

Evaluates arguments ''a1'' ... ''aN'', until one is found that evaluates to ''true''. If that happens, its value is returned. Otherwise the ''else'' part is evaluated and its value returned.

=== $ifequal(n1,n2,then,else) ===

Compares the integer numbers ''n1'' and ''n2'', if ''n1'' is equal to ''n2'', the ''then'' part is evaluated and its value returned. Otherwise the ''else'' part is evaluated and its value returned.

=== $ifgreater(n1,n2,then,else) ===

Compares the integer numbers ''n1'' and ''n2'', if ''n1'' is greater than ''n2'', the ''then'' part is evaluated and its value returned. Otherwise the ''else'' part is evaluated and its value returned.

=== $iflonger(s1,s2,then,else) ===

Compares the length of the strings ''s1'' and ''s2'', if ''s1'' is longer than ''s2'', the ''then'' part is evaluated and its value returned. Otherwise the ''else'' part is evaluated and its value returned.

=== $select(n,a1,...,aN) ===

If the value of ''n'' is between 1 and N, ''an'' is evaluated and its value returned. Otherwise ''false'' is returned.

= Arithmetic functions =

The functions in this section can be used to perform arithmetic on integer numbers. A string will be automatically converted to a number and vice versa. The conversion to a number uses the longest prefix of the string, that can be interpreted as number. Leading whitespace is ignored.

Example: "c3po" → 0, " -12" → -12, but "- 12" → 0

=== $add(a,b) ===

Adds ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$add(a,b,...)'' is the same as ''$add($add(a,b),...)''.

=== $div(a,b) ===

Divides ''a'' through ''b''. If ''b'' evaluates to zero, it returns ''a''.

Can be used with an arbitrary number of arguments. ''$div(a,b,...)'' is the same as ''$div($div(a,b),...)''.

=== $greater(a,b) ===

Returns true, if ''a'' is greater than ''b'', otherwise false.

=== $max(a,b) ===

Returns the maximum of ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$max(a,b,...)'' is the same as ''$max($max(a,b),...)''.

=== $min(a,b) ===

Returns the minimum of ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$min(a,b,...)'' is the same as ''$min($min(a,b),...)''.

=== $mod(a,b) ===

Computes the remainder of dividing ''a'' through ''b''. The result has the same sign as ''a''. If ''b'' evaluates to zero, the result is ''a''.

Can be used with an arbitrary number of arguments. ''$mod(a,b,...)'' is the same as ''$mod($mod(a,b),...)''.

=== $mul(a,b) ===

Multiplies ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$mul(a,b,...)'' is the same as ''$mul($mul(a,b),...)''.

=== $muldiv(a,b,c) ===

Multiplies ''a'' and ''b'', then divides by ''c''. The result is rounded to the nearest integer.

=== $rand() ===

Generates a random number in the range from 0 to 232-1. Available only in sort-related contexts, such as the ''Edit → Sort → Sort by ...'' menu command.

=== $sub(a,b) ===

Subtracts ''b'' from ''a''.

Can be used with an arbitrary number of arguments. ''$sub(a,b,...)'' is the same as ''$sub($sub(a,b),...)''.

= Boolean functions =

The functions in this section can be used to work with truth values (''true'' and ''false''), which have no explicit representation in titleformat scripts. They do not return a string or number value. You can use them for more complex conditions with ''$if'' and related functions.

=== $and(...) ===

Logical And of an arbitrary number of arguments. Returns ''true'', if and only if all arguments evaluate to ''true''.

Special case: ''$and(x,y)'' is ''true'', if both ''x'' and ''y'' are ''true''. Otherwise it is ''false''.

=== $or(...) ===

Logical Or of an arbitrary number of arguments. Returns ''true'', if at least one argument evaluates to ''true''.

Special case: ''$or(x,y)'' is ''true'', if ''x'' or ''y'' is ''true'', or if both are ''true''. Otherwise it is ''false''.

=== $not(x) ===

Logical Not. Returns ''false'', if ''x'' is ''true'', otherwise it returns ''true''.

=== $xor(...) ===

Logical Exclusive-or of an arbitrary number of arguments. Returns ''true'', if an odd number of arguments evaluate to ''true''.

Special case: ''$xor(x,y)'' is ''true'', if one of ''x'' and ''y'' is ''true'', but not both. Otherwise it is ''false''.

= Color functions =

=== $blend(color1,color2,part,total) ===

Returns a color that is a blend between ''color1'' and ''color2''. If ''part'' is smaller than or equal to zero, ''color1'' is returned. If ''part'' is greater than or equal to ''total'', ''color2'' is returned. Otherwise a blended color is returned that is ''part'' parts ''color1'' and ''total''-''part'' parts ''color2''. The blending is performed in the RGB color space.

=== $hsl() ===

Resets the text color to the default color.

=== $hsl(h,s,l) ===

Sets the color for text in the HSL color space. ''h'', ''s'' and ''l'' are the hue, saturation, and lightness of the color for unselected text. The color for selected text is set to the inverse color.
The ranges of ''h'', ''s'', and ''l'' are from 0 to 240; the function is designed to interpret those values in the same way as the standard Windows color dialog.

=== $hsl(h1,s1,l1,h2,s2,l2) ===

Sets the color for text in the HSL color space. ''h1'', ''s1'' and ''l1'' are the hue, saturation, and lightness of the color for unselected text. ''h2'', ''s2'' and ''l2'' are the hue, saturation, and lightness of the color for selected text.

=== $rgb() ===

Resets the text color to the default color.

=== $rgb(r,g,b) ===

Sets the color for text. ''r'', ''g'' and ''b'' are the red, green and blue component of the color for unselected text. The color for selected text is set to the inverse color.

=== $rgb(r1,g1,b1,r2,g2,b2) ===

Sets the color for text. ''r1'', ''g1'' and ''b1'' are the red, green and blue component of the color for unselected text. ''r2'', ''g2'' and ''b2'' are the red, green and blue component of the color for selected text.

=== $transition(string,color1,color2) ===

Inserts color codes into ''string'', so that the first character has ''color1'', the last character has ''color2'', and intermediate characters have blended colors. The blending is performed in the RGB color space. Note that color codes are additional characters that will also be counted by string manipulation functions. For example, if you need to truncate a string, you should do this before applying ''$transition''.

= Now playing info =
The following functions and fields are usable for scripts used with the currently playing item, for example the status bar, the main window title and the copy command script.

== Special fields ==

=== %playback_time% ===
Returns the elapsed time formatted as [HH:]MM:SS.

=== %playback_time_seconds% ===
Returns elapsed time in seconds.
Old version: <code>%_time_elapsed%</code>

=== %playback_time_remaining% ===
Returns remaining time until track ends, formatted as [HH:]MM:SS.
Old version: <code>%_time_remaining%</code>

=== %playback_time_remaining_seconds% ===
Returns remaining time in seconds.
Old version: <code>%_time_remaining_seconds%</code>

=== %length% ===
Returns the length of the track formatted as hours, minutes, and seconds.
Old version: <code>%_time_total%</code>

=== %length_ex% ===
Returns the length of the track formatted as hours, minutes, seconds, and milliseconds.

=== %length_seconds% ===
Returns the length of the track in seconds.
Old version: <code>%_time_total_seconds%</code>

=== %length_seconds_fp% ===
Returns the length of the track in seconds as floating point number.

=== %length_samples% ===
Returns the length of the track in samples.

= Playlist info =
The following functions and fields are usable for playlist display formatting (eg. per-column title formatting patterns).

== Special fields ==

=== %isplaying% ===

Returns "1" if file is currently playing and empty string otherwise.

=== %ispaused% ===

Returns "1" if playback is paused, empty string otherwise.

=== %list_index% ===

Returns a zero-padded playlist index of specified item. The first item is at index 1.

=== %list_total% ===

Returns number of items in the playlist.

=== %queue_index% ===

Index of the specified item in the playback queue; available in playlist only. If the item has been queued multiple times, %queue_index% evaluates to the first index.

=== %queue_indexes% ===

List of indexes of the specified item in the playback queue; available in playlist only. Same as %queue_index% unless the item has been queued more than once.

=== %queue_total% ===

Total amount of tracks in playback queue. Available only for queued tracks, for technical reasons.

= String functions =

The functions in this section can be used to manipulate character strings.

=== $abbr(x) ===

Returns abbreviation of ''x''.

=== $abbr(x,len) ===

Returns abbreviation of ''x'', if ''x'' is longer than ''len'' characters, otherwise returns ''x''.

=== $ansi(x) ===

Converts ''x'' to system codepage and back. Any characters that are not present in the system codepage will be removed / replaced. Useful for mass-renaming files to ensure compatibility with non-unicode-capable software.

=== $ascii(x) ===

Converts ''x'' to ASCII. Any characters that are not present in ASCII will be removed / replaced.

=== $caps(x) ===

Converts first letter in every word of x to uppercase, and all other letters to lowercase.

=== $caps2(x) ===

Converts first letter in every word of x to uppercase, and leaves all other letters as they are.

=== $char(x) ===

Inserts Unicode character with code ''x''. You can search for characters an find the matching decimal number on this [http://www.fileformat.info/info/unicode/char/search.htm site].

=== $crc32(a) ===

Computes the CRC32 of the string ''a'' as a number. Intended for use in coloring scripts.

Example: $rgb($mod($crc32(%album%),256),128,128)

=== $crlf() ===

Inserts end-of-line marker (carriage return, line feed). Can be used to generate multiple lines in the output, for example for the tooltip of the system notification area ("systray") icon.

=== $cut(a,len) ===

Returns first ''len'' characters on the left of ''a''.

=== $directory(x) ===

Extracts directory name from the file path ''x''.

=== $directory(x,n) ===

Extracts directory name from the file path ''x''; goes up by ''n'' levels.

=== $directory_path(x) ===

Extracts directory path from the file path ''x''.

=== $ext(x) ===

Extracts file extension from ''x'' which must be a file name or path.

=== $filename(x) ===

Extracts file name from full path.

=== $fix_eol(x) ===

If ''x'' contains an end-of-line marker (CR-LF), the end-of-line marker and all text to the right of it is replaced by " (...)". Otherwise ''x'' is returned unaltered.

=== $fix_eol(x,indicator) ===

If ''x'' contains an end-of-line marker (CR-LF), the end-of-line marker and all text to the right of it is replaced by ''indicator''. Otherwise ''x'' is returned unaltered.

=== $hex(n) ===

Formats the integer number ''n'' in hexadecimal notation.

=== $hex(n,len) ===

Formats the integer number ''n'' in hexadecimal notation with ''len'' digits. Pads with zeros from the left if necessary.

=== $insert(a,b,n) ===

Inserts ''b'' into ''a'' after ''n'' characters.

=== $left(a,len) ===

Returns the first ''len'' characters from the left of ''a''.

=== $len(a) ===

Returns length of string ''a'' in characters.

=== $len2(a) ===

Returns length of string x in characters, respecting double-width character rules (double-width characters will be counted as two).

=== $longer(a,b) ===

Returns ''true'', if string ''a'' is longer than string ''b'', false otherwise.

=== $lower(a) ===

Converts ''a'' to lowercase.

=== $longest(a,...) ===

Returns the longest of its arguments. Can be used with an arbitrary number of strings.

=== $num(n,len) ===

Formats the integer number ''n'' in decimal notation with ''len'' digits. Pads with zeros from the left if necessary.

=== $pad(x,len) ===

Pads ''x'' from the left with spaces to ''len'' characters.

=== $pad_right(x,y) ===

Pads ''x'' from the right with spaces to ''len'' characters.

=== $pad(x,len,char) ===

Pads ''x'' from the left with ''char'' to ''len'' characters.

=== $pad_right(x,len,char) ===

Pads ''x'' from the right with ''char'' to ''len'' characters.

=== $padcut(x,len) ===

Returns first ''len'' characters from the left of ''x'', if ''x'' is longer than ''len'' characters. Otherwise pads ''x'' from the left with spaces to ''len'' characters.

=== $padcut_right(x,len) ===

Returns first ''len'' characters from the left of ''x'', if ''x'' is longer than ''len'' characters. Otherwise pads ''x'' from the right with spaces to ''len'' characters.

=== $progress(pos,range,len,a,b) ===

Creates a progress bar: ''pos'' contains position, ''range'' contains range, ''len'' progress bar length in characters, ''a'' and ''b'' are characters to build progress bar with.

Example:''$progress(%_time_elapsed_seconds%, %_time_total_seconds%, 20,'#','=')'' produces "====#===============", the # character is moving with playback position.

=== $progress2(pos,range,len,a,b) ===

Creates a progress bar: ''pos'' contains position, ''range'' contains range, ''len'' progress bar length in characters, ''a'' and ''b'' are characters to build progress bar with. Produces different appearance than ''$progress''.

=== $repeat(a,n) ===

Returns ''n'' copies of ''a''. Note that ''a'' is evaluated once before its value is used, so ''$repeat'' cannot be used for loops.

=== $replace(a,b,c) ===

Replaces all occurrences of string ''b'' in string ''a'' with string ''c''.

Can also be used with an arbitrary number of arguments. Note that ''$replace(a,b1,c1,b2,c2)'' is generally not the same as ''$replace($replace(a,b1,c1),b2,c2)''.

Example: ''$replace(ab,a,b,b,c)'' → "bc", ''$replace($replace(ab,a,b),b,c)'' → "cc"

=== $right(a,len) ===

Returns the first ''len'' characters from the right of ''a''.

=== $roman(n) ===

Formats the integer number ''n'' in roman notation.

=== $rot13() ===

Performs [http://en.wikipedia.org/wiki/ROT13 ROT13] transformation to given string.

Example: ''$rot13('foobar2000')'' → "sbbone2000".

=== $shortest ===

Returns the shortest of its arguments. Can be used with an arbitrary number of strings.

=== $strchr(s,c) ===

Finds first occurence of character ''c'' in string ''s''.

Example: ''$strchr(abca,a)'' → 1

=== $strrchr(s,c) ===

Finds last occurence of character ''c'' in string ''s''.

Example: ''$strrchr(abca,a)'' → 4

=== $strstr(s1,s2) ===

Finds first occurence of string ''s2'' in string ''s1''.

=== $strcmp(s1,s2) ===

Performs a case-sensitive comparison of the strings ''s1'' and ''s2''.

=== $stricmp(s1,s2) ===

Performs a case-insensitive comparison of the strings ''s1'' and ''s2''.

=== $substr(s,m,n) ===

Returns substring of string ''s'', starting from ''m''-th character and ending at ''n''-th character.

=== $stripprefix(x) ===

Removes ''A'' and ''The'' prefixes from x.

=== $stripprefix(x,prefix1,prefix2,...) ===

Removes the specified prefixes from x.

=== $swapprefix(x) ===

Moves ''A'' and ''The'' prefixes to the end of x.

=== $swapprefix(x,prefix1,prefix2,...) ===

Moves the specified prefixes to the end of x.

=== $trim(s) ===

Removes leading and trailing spaces from string ''s''.

=== $tab() ===

Inserts one tabulator character.

=== $tab(n) ===

Inserts ''n'' tabulator characters.

=== $upper(s) ===

Converts string ''s'' to uppercase.

= Track info =

The functions and fields in this section can be used to access information about tracks. See [[Foobar2000:0.9 Track Info Panel Mod (foo uie trackinfo mod)|this]] for more info about Track info mod.

== Metadata ==

=== $meta(name) ===
Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ", " as separator.

Example: ''$meta(artist)'' → "He, She, It"

=== $meta(name,n) ===
Returns value of ''n''-th (0,1,2 and so on) tag called ''name''.

Example: ''$meta(artist,1)'' → "She"

=== $meta_sep(name,sep) ===
Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ''sep'' as separator.

Example: ''$meta_sep(artist,' + ')'' → "He + She + It"

=== $meta_sep(name,sep,lastsep) ===
Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ''sep'' as separator between all but the last two values which are concatenated with ''lastsep''.

Example: ''$meta_sep(artist,', ',', and ')'' → "He, She, and It"

=== $meta_test(...) ===
Returns ''1'', if all given tags exist, ''undefined'' otherwise.

Example: ''$meta_test(artist,title)'' → true

=== $meta_num(name) ===
Returns the number of values for the tag called ''name''.

Example: ''$meta_num(artist)'' → 3

== Technical information ==

=== $info(name) ===
Returns value of technical information field called ''name''.

For convenience, the '''%__name%''' alias is also available.

Example: ''$info(channels)'' → 2

Here is an '''informative''' list of recognized fields. Some of these depend on the media file type being queried.

{| border="0" cellspacing="0" cellpadding="2"
! field name
! Description
|-
| colspan="2" style="background-color:#CCF"|'''General'''
|-
|codec
| style="background-color:#EEF"|'''Codec''' (''e.g.'' MP3)
|-
|codec_profile
| style="background-color:#EEF"|'''Codec Profile''' (''e.g.'' CBR)
|-
|samplerate
| style="background-color:#EEF"|'''Sample Rate''', in hertz (''e.g.'' 44100)
|-
|bitrate
| style="background-color:#EEF"|'''Bitrate''', in kilobits per second (''e.g.'' 320)
|-
|tool
| style="background-color:#EEF"|'''Tool''' used to produce the file, possibly guessed (''e.g.'' LAME3.97)
|-
|encoding
| style="background-color:#EEF"|'''Encoding''' lossiness (''e.g.'' lossy)
|-
|channels
| style="background-color:#EEF"|'''Channels''' count (''e.g.'' 2 <nowiki>[for stereo]</nowiki>)
|-
|bitspersample
| style="background-color:#EEF"|'''Bits Per Sample''' (''e.g.'' 16)
|-
|tagtype
| style="background-color:#EEF"|'''Tag Type''', comma-separated list of tag formats (''e.g.'' id3v2|apev2)
|-
|cue_embedded
| style="background-color:#EEF"|'''Embedded Cuesheet''' presence (''e.g.'' no <nowiki>[may be empty!]</nowiki>)
|-
|md5
| style="background-color:#EEF"|'''Audio MD5''' hash, if container defines it (''e.g.'' 1E24A910D91EF09A8CF403C9B6963961)
|-
| colspan="2" style="background-color:#CCF"|'''Other'''
|-
|ENC_DELAY
| style="background-color:#EEF"|LAME proprietary MP3 '''enc_delay''' value (''e.g.'' 576)
|-
|ENC_PADDING
| style="background-color:#EEF"|LAME proprietary MP3 '''enc_padding''' value (''e.g.'' 1536)
|-
|MP3_ACCURATE_LENGTH
| style="background-color:#EEF"|'''mp3_accurate_length''' supported (LAME proprietary header)? (''e.g.'' yes)
|-
|MP3_STEREO_MODE
| style="background-color:#EEF"|Stereo mode used in MP3 file (''e.g.'' mono, stereo, joint stereo, etc.)
|-
|VERSION
| style="background-color:#EEF"|'''Version''' of tool (''e.g.'' 3.99)
|-
|FLAGS
| style="background-color:#EEF"|'''Flags''' of tool (''e.g.'' 22)
|}

=== $channels() ===
Returns number of channels in text format.

Example: ''$channels()'' → "stereo"

=== %replaygain_album_gain% ===

Returns ReplayGain album gain value.

=== %replaygain_album_peak% ===

Returns ReplayGain album peak value.

=== %replaygain_track_gain% ===

Returns ReplayGain track gain value.

=== %replaygain_track_peak% ===

Returns ReplayGain track peak value.

== Special fields ==

==== %filename% ====

Returns the filename without directory and extension.

==== %filename_ext% ====

Returns the filename with extension, but without the directory.

==== %directoryname% ====

Returns the name of the parent directory only, not the complete path.

==== %last_modified% ====

Returns the date and time the file was last modified. Eg: ''2005-12-22 00:04:10''

==== %path% ====

Returns the path.

==== %_path_raw% ====

Returns the path as URL including the protocol scheme.

==== %subsong% ====

Returns the subsong index. The subsong index is used to distuingish multiple tracks in a single file, for example for cue sheets, tracker modules and various container formats.

==== %_foobar2000_version% ====
Returns a string representing the version of foobar2000.

= Time/Date Functions =

These functions are used to manipulate time/date strings, notably (but not limited to), [[Foobar2000:Titleformat_Playback_Statistics|those gathered]] by the [[Foobar2000:Components_0.9/Playback_Statistics_(foo_playcount)|Playback Statistics component]].

=== $year(time) ===

Retrieves the year part (formatted as four digits) from a time/date string.

=== $month(time) ===

Retrieves the month part (formatted as two digits) from a time/date string.

=== $day_of_month(time) ===

Retrieves the day of month part (formatted as two digits) from a time/date string.

=== $date(time) ===

Retrieves the date part (formatted as YYYY-MM-DD) from a time/date string.

=== $time(time) ===

Retrieves the time part (formatted as HH:MM:SS or HH:MM) from a date/time string.

= Variable operations =

Variables can be used to store strings and number. They cannot store truth values. They are best used to store intermediate results that you need multiple times. Variable names are not case-sensitive.

For example:
{| border="0" cellspacing="0" cellpadding="2"
! code
! output
|-
|<pre>$put(foo,bar)$char(10)
$get(foo)$char(10)
$get(Foo)$char(10)
$puts(foo,2000)$char(10)
$get(foo)$char(10)</pre>
| style="background-color:#EEF" |<pre>bar
bar
bar

2000</pre>
|}
=== $get(name) ===

Returns the value that was last stored in the variable ''name'', if the variable was not defined (yet), it returns nothing. The truth value returned by ''$get'' indicates if the variable ''name'' was defined

=== $put(name,value) ===

Stores ''value'' in the variable ''name'' and returns ''value'' unaltered

=== $puts(name,value) ===

Stores ''value'' in the variable ''name'' and returns nothing

= Component-provided fields and functions on tracks =

This section lists components that provide additional fields and functions that are useable in the context of any track.

== Playback statistics ==

* [http://www.foobar2000.org/components/view/foo_playcount Playback statistics homepage]
* [[Foobar2000:Titleformat Playback Statistics|Playback statistics titleformat reference]]

= Component-specific fields and functions =

This section lists components that provide additional fields and functions that are only usable in the context of the particular component.

== Album list ==

* [[Foobar2000:Preferences:Album List|Preferences: Album List]]

== Columns UI ==

* [http://music.morbo.org/wiki/columns_ui:manual Columns UI homepage]
* [http://music.morbo.org/wiki/columns_ui:config:global_variables Global variables reference]
* [http://music.morbo.org/wiki/columns_ui:config:colour_string Playlist colors reference]
* [http://music.morbo.org/wiki/columns_ui:config:playlist_switcher_titleformatting Playlist switcher reference]

= Additional Reading =

* [[Foobar2000:Titleformat_Introduction|Introduction to titleformat scripts]]
* '''titleformat_help.html''' in your Foobar2000 directory (ie C:\Program Files\foobar2000\titleformat_help.html) file:///C:/Program%20Files/foobar2000/titleformat_help.html

[[Category:foobar2000 Guides|Titleformat Reference]]

Foobar2000:Components 0.9/ELplaylist panel (foo uie elplaylist)

2009-03-10T22:31:12Z

Chiwou: first version

{{fb2k}}
{{stub}}

foobar2000 v0.9.5.1+, Columns UI 0.3+

= Requirements =
* [http://www.foobar2000.org/ foobar2000 v0.9.5.1+]
* [http://yuo.be/columns.php Columns UI 0.3+]

= Read me (translated from the Japanese original) =

foo_uie_elplaylist.dll v0.6.4.2beta
for foobar2000 v0.9.5.1 +, Columns UI0.3 +, WindowsXP +
(Testing is only WindowsXP)

SDK version
foobar2000 :2008-07-20
cui: 6.3

SCPL like Columns UI for the Playlist view
A group format each track of the playlist list and grouping of elements in the set.

When you change settings, right-click menu, please call the Settings ... dialog.
(At least General -> Title format Processor -> __ART_PATH__ you have bad balance and do not set the path to the images in the album.)
To edit the settings, Titleformat (TF) knowledge is required. About Titleformat Please refer to the descriptions of other sites separately.

● Setting items

[Script]
Customize your drawing inside the lines of the list.
title format script presets: to control the drawing and describe the TF. Settings can be registered.
Track list
To control the drawing of the track line TF.
Group header
To draw the header control group TF.
Per Second
To control the line drawn in the second track is updated play TF. (Now playing info in the TF system can be used.)
Popup (Background)
Pop-up window to control the drawing of TF. Popup (Track) will be executed before.
Most of the extended field use.
Popup (Track)
Unit to control the drawing of the track pop-up window TF. Popup header when the group will be executed for each track in the group.
Most of the extended field use.
The origin of BOPPUAPPU, header or group, please send the track to determine% el_is_group%.
Also, if the group header,% el_item_index% Please shift your position.
[Note]: Popup after updates have been implemented in the version from the version that is not implemented,
Opens a dialog and set the default Popup Titleformat is no longer what it was reset, and is by design.
In this state, and to save the settings, Popup will not appear on anything.
Graphical Browser Popup features are quite helpful. If you have problems, HAZUSHIMASU.

In entering the default description is the assumption that there is a picture album.
General-> title format preprocessor-> ART.PATH please set the path to the appropriate image.
For example C: \ image \% album%. Jpg and.

[style]
Custom background colour:
Specify a custom background color.
Total: Specifies the background color of the whole.
odd item: Specifies the background color and several odd.
even item: Specifies the background color for even-numbered lines.
selected item: Specifies the background color of selected rows.
playing item: Specifies the background color of the track playing.
selected playing item: Specifies the background color of selected tracks行KATSU play.

odd and even item for the right padding and left padding can be drawn in the area.

Odd and even are calculated by the list index:
on when the odd / determined in an even row number of the list.
off time is determined by order of the group.

※ change to display the character, script editing only.

Default font ...:
Please specify the default font.

Pseudo transparent:
And a pseudo-transparent background. I tend to be heavier to process.
(If severe, may be better to narrow the viewing area.
No I do not use it to optimize the authors・・・)

Enable Visual Style:
The background of the line and automatically draws VisualStyle. Primarily for Windows Vista.
After drawing a custom background colour, title format script will be drawn prior to evaluation.
Text color does not change automatically.

Scrollbar:
Status of the scroll bar settings: default (auto show / hide switch) / hide (displayed) / show (always displayed),
School and set the volume (0 is the system default).

[Grouping]
And customized for the group, you can customize the display of the list across multiple lines.

group by: a set of preset can be saved as.
Group format:
Grouping for each track describes Titleformat.
TF as a group that tracks the same flight as a result.
The group format is the same, leaving tracks on the playlist that is treated as a different group.
"|||" in a group format to split, you can set up the group hierarchy.

Example:% album artist %|||% album%
The group with the child group, there are constraints that can not be assigned a truck.
割RI当TEYOU and tracks such groups, is inserted DAMIGURUPUHEDDA.
Are written in some detail at the end of this text.

Sort format:
Sort in the playlist for Titleformat described.
execution of the sort is done from the context menu.
Note: It does not automatically execute the sort.

Row height:
In a list and set the height of the base line.

Row number of group header:
"row height" and set the height of the header unit of the group.
Titleformat is enabled. TF figures as a result of the process (0-16) should return.
The height of the header for this group, always an integral multiple of row height (0-16 times).
[Note: the group with a track, group row is evaluated.

Minimum row number of group:
You can set the minimum number of lines in each group.
For example, you can use to ensure the scope and application of images to reduce the number of albums and tracks.
Titleformat is enabled. TF as a result of the process must return a value of 0.
After grouping, this value is less than the number of tracks in the group, empty rows and then inflated.

Note: the group with a track, min item num will be evaluated.
The line is empty, Track list Titleformat at $ enabledraw () as long as you do not use the feature will be drawn off.
If you want to draw the line as well as other effective, $ enabledraw (1) and, drawing on the features please.
Track list Titleformat the empty line will be evaluated using only the last track of the group.

Playlist filter:
enable playlist filter is on, the name of the playlist from the playlist when切RI替WATTA the group by preset can be selected automatically.
enable all playlists in the playlist of all the active preset.
If you enable only on the playlist name matches the specified preset is enabled.
If you disable on the playlist name matches the specified preset is disabled.
preset determines the priority order of the list.

※ The name of the playlist specified, ";" that can be separated by more than one. TF or wild card is invalid.

Associated titleformat script name:
This preset tileformat scrpit関連付KETAI and the name of a single set.

Enable playlist filter:
playlist from the playlist filter name to enable you to group by preset automatically selected.

Prioritize active preset:
Find a preset valid time has now selected the first group by preset priority.

[field definition]
Title format preprocessor:
Each Titleformat [Track list] [Group header] [Per Second] [Popup (Background)] [Popup (Track)] [row number of group header] [minimum row number of group]
Before evaluating, field and displacement.
Titleformat each set may be useful to refer to a common code.
foo: C: \% album%. jpg and if you set,
% Foo% Titleformat each of the C: \% album%. Jpg will be substituted.

[Behaviour]
Click action:
You can change your behavior when you click on the playlist.

Mouse hover action:
You can run when the mouse stops for a while.

Enable hover:
Mouse hover action for on / off can be.

Delay:
Will stop the mouse from the mouse hover action to implement a delay.

Display only the focused group:
Show only a focus group. Other panel playlists (Graphical Browser or) is predicated on collaboration.

Collapse all groups when playlist is changed:
Close the group by default.
Threshold of number of groups:
Close the Group when more than this number the number of groups.
Auto-collapse:
Close the Group other than focus groups.
This option is on a group header in a single click to see the track line / switch that you hide.
Click the Action Group in the open does not close automatically.
If you want to follow the track playback, Playback / Cursor Follows Playback Please use a combination.

Allow collapsing group with no group header:
No group header (group row 0) in the group to close it.

disable focus change by single click at group header
Group headers and empty line in a single click when you stop to move the focus.

Update every second:
The tracks play Enabling Per Second. More precisely, the second update of the drawing of the unit on / off only.

Move items with drag and dop:
Drag & Drop the selected tracks to go.
But this option is off, [Alt] while pressing the Drag & Drop, you can move on.

Enable incremental search:
According to key inputs, group format (% el_group_format%) and incremental search.
Keyword search is logged in the status bar.
Also, you did not enter a second valid key, your search terms are automatically reset.
See also SHOTOKATTOKIBAINDO.
IME in XP then I will support as possible to find it in Japanese.
Alphabet in Vista (ASCII) may only search. (Originally I未確認work with Vista.)
If you want to search for Vista in non-ASCII, Ctrl-f search DAIAROGUBESU it is possible, please use there.

Resize quality:
Enlarge Image / You can set the quality down.
If you just want a quality, HighQualityBicubic would be good if you have.

Context menu:
KONTEKISUTOMEYU each (right-click menu) to display the item, you can set up or not.

[misc]
Popup
Pop-up mouse hover action is executed.
Max size:
The maximum size of the popup. Titleformat small can.

Popup opacity:
Opacity of the popup. 0 will be completely transparent and you will not be displayed.

Fade-in:
TSUKEMASU a fade effect when viewed. I made quite appropriate. (Vista will fade in the default?)

Enable colorkey:
Set the color key. The transparent color is set. Same background color (default) if the background is transparent.
However, it is anti-aliasing, transparency is not beautiful.

Prevent going outside of display
To avoid as much as possible out of the pop-up display. Multi-Display is not supported.

Max track num:
Popup (Track) limit the number of trucks running.
Popup the Titleformat script,
Popup (Background) -> Popup (Track) -> Popup (Track) ->・・・
Runs.

Additional sort format
Sort of context menu to add the item to set the sort format.
Group by preset and is independent.

● SHOTOKATTOKIBAINDO
Ctrl-c: Copy
Ctrl-v: Paste
Ctrl-x: Cut
Ctrl-a: select all
Ctrl-f: Find dialog (% el_group_format% of your search)
Ctrl-g: Go to the following groups:
Ctrl-b: Go to the previous group
Delete: remove a track from the playlist
Alt-[Up] / [Down]: Move the selected track ( "hide all items when playlist is changed" is that it is off)
[Note]: foobar2000 body of General-> Keyboard Shortcuts settings will take precedence.

# # [Alt] + Drag & Drop, you can move the selected tracks.

■ incremental search
Keystrokes group format (% el_group_format%) or incremental search. (enable incremental search is on only)
The following shortcuts are available.
Ctrl-e: to reset the search keywords.
Ctrl-d: Find Next. (Ctrl-s if I could spare a・・・)
Ctrl-r: find.

● Main Menu
All panels will be affected.
Show now playing: Scroll to the track so that you are playing.
Show focused item: Scroll to see the focus track.
Expand all groups: Expand all groups.
Collapse all groups: Close all of the groups.
Refresh: redraw causes the explicit.

● Extended Command Reference
(And other than what it says here you can use foobar's default unit is roughly TF)

■ ■ ■ ■ ■ ■ fields ■ ■ ■ ■ ■ ■

% el_width%
Returns the width of the viewing area of the line
[Track list] [Group header] [Per Second] [Popup]

% el_height%
Returns the height of the viewing area of the line.
(Line group% el_height% =% el_group_row% *% el_row_height%
Track line% el_height% =% el_row_height%)
$ Setworldtransform () is affected.
[Track list] [Group header] [Per Second] [Popup]

% el_isplaying%
Whether during playback
[Track list] [Group header] [Per Second]

% el_selected%
On whether the selected playlist
[Track list] [Per Second]
click action of the Select group whether the selected group
[Group header]

% el_focused%
Focus on whether or not in the playlist
[Track list] [Per Second]

% el_row_height%
Returns the height of the basic line.
(% El_height% header line is a different group.)
[Track list] [Group header] [Per Second]

% el_group_row%
The group header row height% el_row_height% or one minute.
The group header% el_height% =% el_group_row% *% el_row_height% of
[Track list] [Group header] [Per Second]

% el_item_count%
Number of tracks in the group
[Track list] [Group header] [Per Second] [Group row] [Min item num]
[Popup]

% el_item_count2%
number of empty trucks in the group that contains the line
[Track list] [Group header] [Per Second]
Number of tracks processed in Popup
[Popup]

% el_direct_item_count%
Do you track the number of directly assigned to the group.
Except in special cases, a group with a sub-group will be 0.
The group does not have a sub-group,% el_direct_item_count% =% el_item_count% and (should).
[Track list] [Group header] [Per Second] [Group row] [Min item num]

% el_item_index%
The index tracks the group (counting from 0)
The line does not count up empty.
[Track list] [Per Second] [Popup]

% el_item_index2%
The index tracks the group (counting from 0)
Count up the line is empty.
[Track list] [Per Second]

% el_total_group_count%
Number of groups (number of headers for all groups)
[Track list] [Group header] [Per Second] [Group row] [Min item num]

% el_total_group_index%
Index group (index group headers in the list)
[Track list] [Group header] [Per Second] [Group row] [Min item num]

% el_group_count%
Number of groups that belong to the same parent group
[Track list] [Group header] [Per Second] [Group row] [Min item num]

% el_group_index%
The index of the group as seen from a parent group (counting from 0)
[Track list] [Group header] [Per Second] [Group row] [Min item num]

% el_group_depth%
The depth of the current group (counting from 0)
[Track list] [Group header] [Per Second] [Group row] [Min item num] [Popup]

% el_subgroup_count%
The number of subgroups
Number of groups of children, grandchildren and the number of groups are not counted.
[Track list] [Group header] [Per Second] [Group row] [Min item num]

% el_subgroup_count2%
Cumulative number of subgroups
Be counted against the group after the grandchildren.
[Track list] [Group header] [Per Second] [Group row] [Min item num]

% el_group_format%
The current group of the TF group format in the process and return the result.
[Track list] [Group header] [Per Second] [Group row] [Min item num]

% el_is_collapsed% (% el_is_hide_item%)
Whether to close the group.
(Whether or not display the group header only)
[Group header] [Group row]

% el_is_empty%
Empty or no go.
(Just opposite% el_is_valid%)
[Track list] [Per Second]
Well if you can not configure the sub-group structure, or whether groups can go into a dummy.
[Group header] [Group row] [Min item num]

% el_is_valid%
Valid (empty lines are not), or no go.
[Track list] [Per Second]
[Group header] [Group row] [Min item num]

% el_is_noheader%
Do not you have a group header
(% El_group_row% to 0 if 1)
[Track list] [Per Second]

% el_sum_length%
Total length of the track of the group [hh:] mm: ss
[Track list] [Group header] [Per Second] [Group row] [Min item num]

% el_sum_length_seconds%
Total length of the track of the group (s)
[Track list] [Group header] [Per Second] [Group row] [Min item num]

% el_backcolour%
The background color back in the r-g-b format.
R-g-b-a if you want to format,
% el_backcolour% -192 can add value and alpha.
[Track list] [Group header] [Per Second]

% el_preset_index%
The current group by the preset index returns.
[Track list] [Group header] [Per Second] [Group row] [Min item num]

% el_preset_name%
Returns the current group by the preset name.
[Track list] [Group header] [Per Second] [Group row] [Min item num]

% el_is_group%
Popup whether the group header.
[Popup]

% el_popup_width%,% el_popup_height%
Size pop-up at that time.
% el_width%,% el_height% note that the max size is returned.
[Popup]

% el_is_themed%
Whether or not enable Visual Style valid
[Track list] [Group header] [Per Second] [Group row] [Min item num]

■ ■ ■ ■ ■ ■ functions ■ ■ ■ ■ ■ ■

● Draw control function
[Track list], [Group header], [Per Second], [Popup] valid.

$ font (name, size, OPTIONS)
Font settings.
OPTIONS: bold italic underline strikeout

Example: $ font (Tahoma, 10, bold italic)

$ drawstring (text, x, y, W, H, rgba, OPTIONS [, OPTIONS2])
String drawing functions.
Text coordinates (x, y) to draw on.
[Note] This function is a string and DrawText drawtextex not only in view.
Maybe only TrueType fonts.

OPTIONS: Alain specified, the specified quality of drawing, and to specify the clip.
Alain left hcenter right specified horizontal
Alain specified top vcenter bottom vertical

nowrap not wraparound

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)

If you set the trimming trimchar trimword fit the display range
elipchar elipword the last to fit the display range If・・・set to replace the

mempos getlastpos, to be able to get the coordinates of the drawing.

OPTIONS2 (optional experimental, experimental option)
Specifying the terms of the glow effect.

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)

Example, $ drawstring (abcd, 10,10,, ,255-128-64-128,)
$ drawstring (abcd, 10,10,, ,255-128-64-128, left vcenter, glow :2:255-255-255: 3)
$ drawstring (wxyz, 10,10,, ,255-255-255,, glow :2:32-168-268: 1 offset: 1: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 functions.
Coordinates (x, y) size (w, h) Draws a rectangle.
R1-G1-B1-A1 internal color
R2-G2-B2-A2 Border Color

OPTIONS
Aa - put ANCHIERIASU

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)
Gradient fill in the drawing functions in the rectangle.
Coordinates (x, y) size (w, h) Draws a rectangle.
R1-g1-b1-a1 Gradient start color
R2-g2-b2-a2 peak color gradient

OPTIONS
Vertical gradient of vertical
Gradient horizontal horizontal
Aa put ANCHIERIASU
how 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)
Filling a rectangle drawing functions to blur the outline.
Level [1-7]

$ 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.

Example:
Vista Then, apply the style of Windows Explorer.
$ drawthemerect (0,0,% el_width%,% el_height%, listview, 1,1) / / default
$ drawthemerect (0,0,% el_width%,% el_height%, listview, 1,2) / / hot
$ drawthemerect (0,0,% el_width%,% el_height%, listview, 1,3) / / selected
$ drawthemerect (0,0,% el_width%,% el_height%, listview, 1,4) / / disable
$ drawthemerect (0,0,% el_width%,% el_height%, listview, 1,5) / / notfocused selected
$ drawthemerect (0,0,% el_width%,% el_height%, listview, 1,6) / / hot selected
$ drawthemerect (0,0,% el_width%, 1, listview, 7,0) / / group header line

$ drawroundrect (x, y, w, h, w2, h2, R1-G1-B1-A1, R2-G2-B2-A2, RESERVED)
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,,)

$ drawellipse (x, y, w, h, R1-G1-B1-A1, R2-G2-B2-A2, RESERVED)
Ellipse drawing functions.
Coordinates (x, y) size (w, h) draws an ellipse.
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)
(x1, y1), (x2, y2), (x3, y3) Draw a triangle and vertex function.
R1-G1-B1-A1 internal color
R2-G2-B2-A2 Border Color

OPTIONS
Aa - put ANCHIERIASU

Example: $ drawtriangle (10,5,20,10,10,15200-100-100,, aa)

$ imageabs (x, y, w, h, path, OPTIONS, n, alpha, OPTIONS2)
Coordinates (x, y) size (w, h) show the images in the path is specified.
Retained in memory and after resizing the image, if you raise the efficiency of the process see below.
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
Poor quality and will be expanded after the reduction.
Nodisplay noexpansion and use,
Cache memory may be the largest reduction in the rate of reduction in the rate of use.

If there are images true, if false is returned.

Dipsplays the image specified by path.
after the image is resized, it is cached on the memory.

path: absolute path of the image (or an embedded image of AudioFile path)

OPTIONS
■ <appearance>
nokeepaspect not maintain the aspect ratio (nodisplay, archive, icon options and non-exclusive).
Hide nodisplay read only memory.
noexpansion will reduce, not increase.

■ <align> exclusive.
Left right horizontal aryne specified.
Specify vertical aryne top bottom.

■ <misc>
wc wildcard (*,?) enabled.

■ <read engine> exclusive.
archive archive reader through the path of the images.
The format of the archive reader is path dependent, the absolute path of the archive | base path in the archive file.
Example: C: \ aaa \ image.zip | bbb / ccc.jpg
icon path is specified in the icon file (*. ico) to appear.

Audio 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.
Audio artreader_front path specified by the embedded image file foobar2000 loaded at the core of the artwork reader.
Audio artreader_back path specified by the embedded image file foobar2000 loaded at the core of the artwork reader.
Audio artreader_disc path specified by the embedded image file foobar2000 loaded at the core of the artwork reader.
Audio artreader_icon path specified by the embedded image file foobar2000 loaded at the core of the artwork reader.
(artreader *** are currently disrecommended options because these option seem to be slow)

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
Opacity

OPTIONS2 (shadow effect)
Glow: expand: colour
Offset: x: y

Example $ 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
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
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,,,))

● auxiliary drawing

$ 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,4100100, $ 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.
Also, drawstring in, glow_aa glow if put in effect,
Measurestring see the range of results and may not match.

$ 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 returns.
This means that only have $ imageabs $ imageabs_rc behind.
nokeepaspect may be able to calculate the aspect ratio should be applied.

$ setcoordinate (mode)
$ setcoordinate (0, X, Y, W, H)
$ setcoordinate (1, X, Y, R, B)
Drawing function argument "(x, y, w, h)" designated by a, (x, y, right, bottom) change the designation.
$ imageabs_rc and $ drawtriangle for the disabled.
The X, Y, W, H is specified, you can change the default position if the specified coordinates omitted in the drawing functions.
$ imageab, $ imageabs_rc and $ drawtriangle for the disabled.

Mode: Specifies the coordinate mode
0 default (x, y, w, h)
1 (x, y, right, bottom)

(x, y )<------ w ------->
|----------------|
| |
h | |
| |
|________________|
(right, bottom)

$ setworldtransform (mode)
Changing the coordinate system.
We can draw a line in another coordinate system is not changed.
Group should be useful when you do multiple tracks and draw MATAIDA whole.
Enabled to view images.
Popup prohibited.
(TF see early examples.)

Mode
0: default
The origin of each track (x, y) = (0,0), the top left of each track.

1: group common coordinate system
Group and the origin of each track (x, y) = (0,0) Group and the upper left of the line.
% el_height% = (% el_item_count2% +% el_group_row%) *% el_row_height% will.

2: item list of common coordinate system
The origin of each track (x, y) = (0,0) and upper left of the group's first line of the track.
% el_height% =% el_item_count2% *% el_row_height% will.

default
(0,0)
|----------------|
|________________|
(el_width, el_height)

common coordinate system group
(0,0)
|----------------|
| Group header |
|----------------|
|----------------|
|----------------|
|----------------|
|________________|
(el_width, el_height)

item list of common coordinate system
|----------------|
| Group header |
(0,0 )|----------------|
|----------------|
|----------------|
|----------------|
|________________|
(el_width, el_height)

$ enabledraw (mode)
System function draw ($ draw **** or $ imageabs **) to control whether or not the drawing.
Called back to the drawing of this function on / off.
Mainly used to control the drawing of the empty line.

Mode
0: disable the function of drawing
1: Enable

Example: $ enabledraw (1)
$ Enabledraw (% el_is_valid%)

$ getsyscolour (index)
The r-g-b color system in the form of returns.

index: [0-30] color index system

$ averagecolour (colour1, colour2 [,・・・])
R-g-b-a to the average color of the form.
(Colour1 + colour2 +・・・) / N

$ blendcolour (colour1, w1, colour2, w2, [,・・・])
R-g-b-a return with the average weight in the form.
(w1 * colur1 + w2 * colour2 +・・・+ wN * colourN) / (w1 + w2 +・・・+ wN)

$ addcolour (colour1, colour2 [,・・・])
R-g-b-a to add the color of the form.
・・・Colour1 + colour2 + + colourN

$ subcolour (colour1, colour2 [,・・・])
R-g-b-a to form a color subtraction.
Colour1 - colour2 - colour3・・・- colourN

$ xorcolour (colour1, colour2 [,・・・])
R-g-b of the color of the form to the XOR operator. Returns only colour1 alpha channel.
colour1 xor colour2 xor colour3・・・xor colourN

● General-purpose system function
Basically, [Track list] [Group header] [Per Second] [Group row] [Min item num] [Popup] valid.

$ getgroupformat (group_index)
group_index groups are specified in a group format and return the result as TF.
group_index: to specify the group or what number (counting from 0).
% el_group_format% = $ getgroupformat (% el_total_group_index%) relationship.

$ findfile (path, [path2, path3 ,...])
path (wildcards accepted) to be specified in the file exists, returns the first file.
If you do not have the file does not return anything. (Strictly speaking, "false" returns)
Path can be specified.

$ el_scale (val, factor [, DIV])
val * factor/100 or val * factor / DIV returns.
val and the overflow factor is too large.

● GDI drawing functions of
Using the GDI to draw. Simple minutes, may be faster.

$ drawtext (text, x, y, W, H, r-g-b, OPTIONS)
GDI text drawing functions
Text coordinates (x, y) in output

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)

$ gettextwidth (text, [FONTNAME, SIZE, OPTIONS])
GDI (drawtext, drawtextex) returns the width in the text when drawing horizontal text.
can specify the font ($ font option). specified font is optional

$ gettextheight ([FONTNAME, SIZE, OPTIONS])
GDI returns vertical width of text when drawn.
can specify the font ($ font option). specified font is optional

$ 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

■ ■ ■ Popup system function ■ ■ ■
[Popup (Background)], [Popup (Track)] domain.

$ popupsize (w, h)
Pop-up function to reduce the size.
In other words,
W <max size (width)
H <max size (height)
Must satisfy.

$ popuphide ()
Do not pop up.
At that point and call it once and decided not to pop up.

$ popuptracknum (num)
The maximum number of tracks to reduce the num treatment.
Popup (Background) only available.

[Note]: drawstring with DrawText and drawtextex
Characters are drawn in different ways, good and bad points.
And not even being able to function at all (probably) is not a bug.
DrawText problem now is if I do not use.

[Aside]: I take the argument to the rgba color function in a format other than $ rgb (r, g, b) can be longer (should).
DrawText The only argument in the text, $ rgb $ transition function and can specify the color using the function (should be).

= External links =
* [http://foo2k.chottu.net/ Official page with download link] (Japanese)
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=62133 Discussion thread]

Foobar2000:Components 0.9/Panel Stack Splitter (foo uie panel splitter)

2009-03-10T22:27:44Z

Chiwou:

{{fb2k}}
{{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.

foobar2000 v0.9.5.1+, Columns UI 0.3+

= Requirements =
* [http://www.foobar2000.org/ foobar2000 v0.9.5.1+]
* [http://yuo.be/columns.php Columns UI 0.3+]

= Read me (translated from the Japanese original) =

foo_uie_panel_splitter.dll v0.3.6.3 (alpha ver)
for foobar2000 v0.9.5.1 +, Columns UI0.3 +, WindowsXP +

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?

Description
Add and remove panels from the basic layout of the ColumnsUI do.
They can add from the context menu.

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.

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.
(size and auto-scaling is disabled)

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.)
Title Formatting is enabled.
% _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.
is on the use parsentage value is, Splitter percentage for the size of the [0-100] can be specified.
use parsentage value of setting the example on:
left: 25
top: 25
width: 50
height: 50

padding: Add a space around the panel.
Title Formatting to put the numbers are fixed, so invalid.
If the automatic alignment panels, padding can be resized with the mouse as if the border is set.
enable resizable border with on / off can be

caption: The name of the panel, the identifier
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.

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.

[Field]
% 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

[Function]
$ font (name, size, OPTIONS)
Font settings.
OPTIONS: bold italic underline strikeout

Example: $ font (Tahoma, 10, bold italic)

$ drawstring (text, x, y, W, H, rgba, OPTIONS [, OPTIONS2])
String drawing functions.
Text coordinates (x, y) to draw on.
[Note] This function is a string and DrawText drawtextex not only in view.
Maybe only TrueType fonts.

OPTIONS: Alain specified, the specified quality of drawing, and to specify the clip.
Alain left hcenter right specified horizontal
Alain specified top vcenter bottom vertical

nowrap not wraparound

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 now)
glow_aa glow option to use a special mode. (noaa, aa, hq exclusive)

If you set the trimming trimchar trimword fit the display range
elipchar elipword the last to fit the display range If・・・set to replace the

mempos getlastpos, to be able to get the coordinates of the drawing.

OPTIONS2 (optional experimental, experimental option)
Specifying the terms of the glow effect.
Specified in the OPTIONS glow_aa only, outline and semibold is available.

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_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.
※ glow is a heavy process. (Especially the pseudo transparent)

Example, $ drawstring (abcd, 10,10,, ,255-128-64-128,)
$ drawstring (abcd, 10,10,, ,255-128-64-128, left vcenter, glow :2:255-255-255)
$ 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)

$ drawrect (x, y, w, h, R1-G1-B1-A1, R2-G2-B2-A2, OPTIONS)
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
Aa - put ANCHIERIASU

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_point)
Gradient fill in the drawing functions in the rectangle.
Coordinates (x, y) size (w, h) Draws a rectangle.
R1-g1-b1-a1 Gradient start color
R2-g2-b2-a2 Gradient end color

OPTIONS
Vertical gradient of vertical
Gradient horizontal horizontal
Aa put ANCHIERIASU
how nonlinear nonlinear gradient

Peak_point: 0-100
Shifted the position of the gradient endpoints.
0 by default, r1-g1-b1-a1 -> r2-g2-b2-a2
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)
$ gradientrect (0,50,50,50255-128-64-128255-255-255,, 10)

$ drawblurrect (x, y, w, h, colour, level)
Filling a rectangle drawing functions to blur the outline.
Level [1-7]

$ 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)
VisualStyle in the rectangle with a control (button or progress bar) function to draw.
The only practical to draw a picture may be low.
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.
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 if not drawn in, the parts are not defined.

Example: $ 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)
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,,)

$ drawellipse (x, y, w, h, R1-G1-B1-A1, R2-G2-B2-A2, RESERVED)
Ellipse drawing functions.
Coordinates (x, y) size (w, h) draws an ellipse.
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)
(x1, y1), (x2, y2), (x3, y3) Draw a triangle and vertex function.
R1-G1-B1-A1 internal color
R2-G2-B2-A2 Border Color

OPTIONS
Aa - put ANCHIERIASU

Example: $ drawtriangle (10,5,20,10,10,15200-100-100,, aa)

$ imageabs (x, y, w, h, path, OPTIONS, n, alpha, OPTIONS2)
Coordinates (x, y) size (w, h) show the images in the path is specified.
Retained in memory and after resizing the image, if you raise the efficiency of the process see below.
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
Poor quality and will be expanded after the reduction.
Nodisplay noexpansion and use,
Cache memory may be the largest reduction in the rate of reduction in the rate of use.

If there are images true, if false is returned.

Dipsplays the image specified by path.
after the image is resized, it is cached on the memory.

path: absolute path of the image (or an embedded image of AudioFile path)

OPTIONS
■ <appearance>
nokeepaspect not maintain the aspect ratio (nodisplay, archive, icon options and non-exclusive).
Hide nodisplay read only memory.
noexpansion will reduce, not increase.

■ <align> exclusive.
Left right horizontal aryne specified.
Specify vertical aryne top bottom.

■ <misc>
wc wildcard (*,?) enabled.

■ <read engine> exclusive.
archive archive reader through the path of the images.
The format of the archive reader is path dependent, the absolute path of the archive | base path in the archive file.
Example: C: \ aaa \ image.zip | bbb / ccc.jpg
icon path is specified in the icon file (*. ico) to appear.

Audio 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.
Audio artreader_front path specified by the embedded image file foobar2000 loaded at the core of the artwork reader.
Audio artreader_back path specified by the embedded image file foobar2000 loaded at the core of the artwork reader.
Audio artreader_disc path specified by the embedded image file foobar2000 loaded at the core of the artwork reader.
Audio artreader_icon path specified by the embedded image file foobar2000 loaded at the core of the artwork reader.
(artreader *** are currently disrecommended options because these option seem to be slow)

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
Opacity

OPTIONS2 (shadow effect)
Glow: expand: colour
Offset: x: y

Example $ 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%. 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
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
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,,,))

$ drawimage (x, y, w, h, path, OPTIONS, n, aplha)
Coordinates (x, y) size (w, h) show the images in the path is specified.
$ Imageabs similar.
w and h show the size of the original omitted.
From memory immediately after display processing will be removed.
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 maintain aspect ratio
Left
Right
Top
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
Opacity (transparency)

● auxiliary drawing

$ 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,4100100, $ 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.
Also, drawstring in, glow_aa glow if put in effect,
Measurestring see the range of results and may not match.

$ 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 returns.
This means that only have $ imageabs $ imageabs_rc behind.
nokeepaspect may be able to calculate the aspect ratio should be applied.

$ setparcentmode (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 form of returns.

index: [0-30] color index system

$ averagecolour (colour1, colour2 [,・・・])
R-g-b-a to the average color of the form.
(Colour1 + colour2 +・・・) / N

$ blendcolour (colour1, w1, colour2, w2, [,・・・])
R-g-b-a return with the average weight in the form.
(w1 * colur1 + w2 * colour2 +・・・+ wN * colourN) / (w1 + w2 +・・・+ wN)

$ addcolour (colour1, colour2 [,・・・])
R-g-b-a to add the color of the form.
・・・Colour1 + colour2 + + colourN

$ subcolour (colour1, colour2 [,・・・])
R-g-b-a to form a color subtraction.
Colour1 - colour2 - colour3・・・- colourN

$ findfile (path, [path2, path3 ,...])
path (wildcards accepted) to be specified in the file exists, returns the first file.
If you do not have the file does not return anything. (Strictly speaking, "false" returns)
Path can be specified.

● function button

$ 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

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: 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)
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

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)
$ 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 of
Using the GDI to draw. Simple minutes, may be faster.

$ drawtext (text, x, y, W, H, r-g-b, OPTIONS)
GDI text drawing functions
Text coordinates (x, y) in output

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)

$ gettextwidth (text, [FONTNAME, SIZE, OPTIONS])
GDI (drawtext, drawtextex) returns the width in the text when drawing horizontal text.
can specify the font ($ font option). specified font is optional

$ gettextheight ([FONTNAME, SIZE, OPTIONS])
GDI returns vertical width of text when drawn.
can specify the font ($ font option). specified font is optional

$ 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 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.

$ 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 =
* [http://foo2k.chottu.net/ Official page with download link] (Japanese)
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=62114 Discussion thread]

Foobar2000:Components

2009-03-10T22:25:20Z

Chiwou: /* Panels */

{{fb2k}}
This page contains most Foobar2000 v0.9.x components available at time of [http://wiki.hydrogenaudio.org/index.php?title=Foobar2000:Components_0.9&action=history last update].
=1st Party=
The following components are created and maintained by the foobar2000 development team. Support for them should be asked for in the [http://www.hydrogenaudio.org/forums/index.php?showforum=29 Support forum]
===Included in the Installer===
[[Image:Optional_features.png|thumb|The Optional Features screen of the fb2k Installer]]
In addition to foobar2000's core functionality, the following components can be installed as needed, in the Optional Features section of the installer.
{| class="wikitable sortable"
! Name
! foo name
! description
|----
| Audio CD Support
| foo_cdda
| Adds Support for [[CD|Audio CD]] Playback
|----
| Album List
| foo_albumlist
| Gives quick access to Media Library Content with customizable tree view
|----
| Standard DSPs
| foo_dsp_std
| Equalizer, resampler, advanced limiter, hard limiter, stereo to 4 channel upmixer and a couple other effects
|----
| ReplayGain Scanner
| foo_rgscan
| advanced solution for volume matching
|----
| [[Foobar2000:Converter|Converter]]
| foo_converter
| Converts files to WAV or any other formats using command line encoders
|----
| [[Foobar2000:File_operations|File Operations]]
| foo_fileops
| Renames, moves, or copies files according to specified patterns
|----
| Archive Reader
| foo_unpack
| Adds support for playing files directly from ZIP RAR and GZIP archives
|----
| ABX Comparator
| foo_abx
| [[ABX]] component for double blind listening tests
|----
| [[Foobar2000:Components_0.9/Freedb_Tagger_(foo_freedb2)|freedb Tagger]]
| foo_freedb2
| Tag retrieving support from freedb service for any set of files: mp3,mpc,flac,...-not only CDDA tracks
|----
|}

===Additional Components===
These components are provided as separate downloads, found on the [http://www.foobar2000.org/?page=Download Additional Components page].
====Input====
* [[Foobar2000:Components 0.9/Monkey's Audio Decoder (foo_input_monkey)|Monkey's Audio Decoder (foo_input_monkey)]] Adds decoding support for Monkey's Audio files (.[[APE]]) as well as APE Link files (.[[APL]]).
*[[Foobar2000:Components 0.9/ALAC Decoder (foo_input_alac)|ALAC Decoder (foo_input_alac)]] Apple Lossless ([[ALAC]]) decoder.

====Output====
* [[Foobar2000:Components 0.9/Kernel Streaming Output (foo_out_ks)|Kernel Streaming support (foo_out_ks)]] Allows bit-exact playback bypassing Windows kernel mixer.
* [[Foobar2000:Components 0.9/ASIO Output (foo_out_asio)|ASIO output support (foo_out_asio)]] Adds ASIO output support.
* [[Foobar2000:Components 0.9/WASAPI output support (foo_out_wasapi)|WASAPI output support (foo_out_wasapi)]] Adds Windows Audio Session API exclusive mode output support, allowing bit-exact output and muting all other sounds on Windows Vista systems.
====Other====
*[[Foobar2000:Components 0.9/Playback Statistics (foo playcount)|Playback Statistics (foo playcount)]] Collects playback statistics for your Media Library content.
*[[Foobar2000:Components 0.9/Binary Comparator (foo_bitcompare)|Binary Comparator (foo_bitcompare)]] Performs binary comparison between two or more tracks and reports differences.
* [[Foobar2000:Components 0.9/File Integrity Verifier (foo_verifier)|File Integrity Verifier (foo_verifier)]] Checks specified media files for decoding errors.
* [[Foobar2000:Components 0.9/Quick Tagger (foo_quicktag)| Quick Tagger (foo_quicktag)]] Adds customizable context menu commands for quickly setting tag fields to preconfigured values
* Text Tools (foo_texttools) Adds customizable context menu commands for copying information about the selected tracks to Windows Clipboard.
* [[Foobar2000:Components 0.9/Decoding Speed Test (foo_benchmark)|Decoding Speed Test (foo_benchmark)]] Measures decoding speed of audio files.
* [[Foobar2000:Components 0.9/Convolve (foo_convolve)|Impulse response convolver (foo_convolve)]] Allows arbitrary effects to be captured and used inside foobar2000. ([http://www.hydrogenaudio.org/forums/index.php?showtopic=10611 More Info])
* [[Foobar2000:Components 0.9/Audio CD Writer (foo_burninate)|Audio CD Writer (foo_burninate)]] CD burning support (requires Nero to be installed on your system.)
* [[Foobar2000:Components 0.9/Masstagger (foo_masstag)|Masstagger (foo_masstag)]]

=3rd Party=
The following components are created and maintained by 3rd-party authors, using foobar2000's [http://www.foobar2000.org/SDK.html SDK]. Support for these components should be asked for in the [http://www.hydrogenaudio.org/forums/index.php?showforum=33 3rd Party Plugins forum] Asking for help directly in the component's thread is usually preferred.
== User Interfaces ==

=== Columns UI ===
[[Foobar2000:Components 0.9/Columns UI (foo_ui_columns)|Columns UI (foo_ui_columns)]] Very popular alternate interface for foobar2000 based on a columns and panel layout.

Columns UI introduced components with [[#Panels|panel]] capability which extend the user interface.

===GFX===
[[Foobar2000:Components 0.9/GFX window (foo_ui_gfx)|GFX window (foo_ui_gfx)]] is a skinnable user interface, which doesn't only focus on looking good but tries to be as fast and "lightweight" as possible, too. It uses lua as scripting language. Two skins are included in the archive. Development of this component appears to have ceased.

===Panels UI===
[[Foobar2000:Components 0.9/Panels UI (foo_ui_panels)|Panels UI (foo_ui_panels)]] gives the ability to manage multiple [[#Panels|panels]] through titleformating. No longer maintained and not compatible with current foobar2000 releases anymore.

== User Interface Addons ==
=== UI Elements ===
The [[Foobar2000:Components 0.9/Default user interface (foo_ui_std)|default user interface (foo_ui_std)]], included in the standard installation package, can be extended with the following component(s):
* [[Foobar2000:Components 0.9/Facets (foo_facets)|Facets (foo_facets)]] Flexible media library viewer based on linked lists.
* [[Foobar2000:Components_0.9/Infospect_%28foo_infospect%29|Infospect (foo_infospect)]] Displays low level playback information.
* [[Foobar2000:Components_0.9/Screen_Saver_Host_%28foo_vis_screensaver%29|Screen Saver Host (foo_vis_screensaver)]] Displays a screen saver inside foobar2000 main window.
* [[Foobar2000:Components_0.9/Text_Display_%28foo_textdisplay%29|Text Display (foo_textdisplay)]] Displays information about the playing or selected track.

=== Panels ===
Panels extend the functionality of Columns UI / Panels UI components.
* [[Foobar2000:Components 0.9/Album Art Panel (foo_uie_albumart)|Album Art Panel (foo_uie_albumart)]] Panel to display album art.
* [[Foobar2000:Components 0.9/Album Art Panel for matroska (foo_uie_albumart_mka)|Album Art Panel for matroska (foo_uie_albumart_mka)]] Albumart mod to read matroska covers.
* [[Foobar2000:Components 0.9/Album List Panel (foo_uie_albumlist)|Album List Panel (foo_uie_albumlist)]] Displays the database in a treeview using customizable sorting methods (by genre, artist, directory, etc.)
* [[Foobar2000:Components 0.9/Bookmarks (foo_uie_bookmarks)|Bookmarks (foo_uie_bookmarks)]] Help you remember positions in songs.
* [[Foobar2000:Components 0.9/Console (foo_uie_console)|Console (foo_uie_console)]] Panel version of console. Displays diagnostic messages. Requires Columns UI 0.1.3 beta 1 or newer.
* [[Foobar2000:Components 0.9/Cover Flow (foo_bubble_coverflow)|Cover Flow (foo_bubble_coverflow)]] The plugin can work either as a UI panel or a standalone window (found in the view menu), and a fullscreen mode for both.
* [[Foobar2000:Components 0.9/Dockable Panels (foo_dockable_panels)|Dockable Panels (foo_dockable_panels)]] It allows you to create windows that host columns ui panels as floating windows that can be attached to the side of the main foobar2000 window or each other.
* [[Foobar2000:Components 0.9/Egoh Spectrum Analyser (foo_uie_vis_egoh)|Egoh Spectrum Analyser (foo_uie_vis_egoh)]] Similar to the default spectrum analyser.
* [[Foobar2000:Components 0.9/ELplaylist panel (foo_uie_elplaylist)|ELplaylist panel (foo_uie_elplaylist)]] Displays the playlist in a single column with a header. Highly customizable.
* [[Foobar2000:Components 0.9/Explorer Panel (foo_uie_explorer)|Explorer Panel (foo_uie_explorer)]] Displays a treeview of selected disks/folders.
* [[Foobar2000:Components 0.9/Grouped playlist panel (foo_uie_pvt)|Grouped playlist panel (foo_uie_pvt)]] Preview version of columns playlist with grouping.
* [[Foobar2000:Components 0.9/Lyrics Panel (foo_uie_lyrics_panel)|Lyrics Panel (foo_uie_lyrics_panel)]] Display lyrics stored in file tags.
* [[Foobar2000:Components 0.9/Music Browser (foo_browser)|Music Browser (foo_browser)]] Panels for Browsing Library, Similar to iTunes.
* [[Foobar2000:Components 0.9/Panel Stack Splitter (foo_uie_panel_splitter)|Panel Stack Splitter (foo_uie_panel_splitter)]] Allows free positioning of panels within the foobar2000 window and displays track info.
* [[Foobar2000:Components 0.9/Playlist Dropdown (foo_uie_playlists_dropdown)|Playlist Dropdown (foo_uie_playlists_dropdown)]] Displays the playlist in a dropdown menu.
* [[Foobar2000:Components 0.9/Playlist Tree (foo_playlist_tree)|Playlist Tree (foo_playlist_tree)]] Tree based media library with many available customizations.
* [[Foobar2000:Components 0.9/Power Panels (foo_uie_powerpanels)|Power Panels (foo_uie_powerpanels)]] Seekbar and volume transparent version panels. Useful for theming.
* [[Foobar2000:Components 0.9/ProjectM Visualisation Panel (foo_uie_vis_projectM)|ProjectM Visualisation Panel (foo_uie_vis_projectM)]] Based on the ProjectM project, which is a reimplementation of Milkdrop under OpenGL.
* [[Foobar2000:Components 0.9/Queue Manager (foo_uie_queuemanager)|Queue Manager (foo_uie_queuemanager)]] It provides a window that shows the queue's contents and allows you to delete parts of them or clear the whole queue.
* [[Foobar2000:Components 0.9/Quicksearch Panel (foo_uie_quicksearch)|Quicksearch Panel (foo_uie_quicksearch)]] Search toolbar that sends results to a playlist.
* [[Foobar2000:Components 0.9/Shpeck (foo_vis_shpeck)|Shpeck (foo_vis_shpeck)]] Winamp visualisation plugins wrapper.
* [[Foobar2000:Components_0.9/Single Column Playlist (foo_uie_single_column_playlist)|Single Column Playlist Viewer (foo_uie_single_column_playlist)]] Displays the playlist in a single column with "headers". Useful for creating a narrower and smaller layout.
* [[Foobar2000:Components 0.9/Tabs (foo_uie_tabs)|Tabs (foo_uie_tabs)]] Tabs allows you to break Pauli's Exclusion principle by placing multiple panels in the same position at the same time.
* [[Foobar2000:Components 0.9/Track Info Panel (foo_uie_trackinfo)|Track Info Panel (foo_uie_trackinfo)]] Uses TAGZ to display information about a selected track.
* [[Foobar2000:Components 0.9/Track Info Panel Mod (foo_uie_trackinfo_mod)|Track Info Panel Mod (foo_uie_trackinfo_mod)]] Improved Track Info panel with the ability to use multiple fonts in the same panel. Also has the ability to display images.
* [[Foobar2000:Components 0.9/Typefind (foo_typefind)|Typefind (foo_typefind)]] Provides some in-line search facilities.
* [[Foobar2000:Components 0.9/WmpVis (foo_uie_wmpvis)|WmpVis (foo_uie_wmpvis)]] Uses the visualizations from WMP.
* [[Foobar2000:Components 0.9/WSH panel (foo_uie_wsh_panel)|WSH panel (foo_uie_wsh_panel)]] Windows script host panel.

==DSP==
* [[Foobar2000:Components 0.9/4Front Headphones (foo_dsp_headphones9)|4Front Headphones (foo_dsp_headphones9)]] Effects for headphone users.
* [[Foobar2000:Components 0.9/ATSurround Processor (foo_dsp_atsurround)|ATSurround Processor (foo_dsp_atsurround)]] Reproduces surround sound information present in many stereo audio material and more.
* [[Foobar2000:Components 0.9/BS2B (foo_dsp_bs2b)|BS2B (foo_dsp_bs2b)]] Improves headphone listening of regular hi-fi stereo records.
* [[Foobar2000:Components 0.9/Voice Cut Filter (foo_dsp_centercut)|Voice Cut Filter (foo_dsp_centercut)]] Voice cut filter.
* [[Foobar2000:Components 0.9/Channel Mixer (foo_channel_mixer)|Channel Mixer (foo_channel_mixer)]] Up/down mix to/from 1-6 channels.
* [[Foobar2000:Components 0.9/Crossfeed (foo_dsp_crossfeed)|Crossfeed (foo_dsp_crossfeed)]] Filters the music to help reduce fatigue caused by listening to music with headphones.
* [[Foobar2000:Components 0.9/Dolby Headphone Wrapper (foo_dsp_dolbyhp)|Dolby Headphone Wrapper (foo_dsp_dolbyhp)]] Dolby Headphone engine DLL.
* [[Foobar2000:Components 0.9/Dolby Pro Logic II wrapper (foo_dsp_pl2)|Dolby Pro Logic II wrapper (foo_dsp_pl2)]] Dolby Pro Logic II engine DLL (dll not included).
* [[Foobar2000:Components 0.9/Downmix (foo_dsp_downmix)|Downmix (foo_dsp_downmix)]] Downmix [[AC3]], [[DTS]], etc. to stereo.
* [[Foobar2000:Components 0.9/FreeSurround (foo_dsp_fsurround)|FreeSurround (foo_dsp_fsurround)]] It takes Dolby Surround / Pro Logic I/II encoded stereo music and decodes it into 5.1 sound.
* [[Foobar2000:Components 0.9/George Yohng's VST Wrapper (foo_dsp_vstwrap)|George Yohng's VST Wrapper (foo_dsp_vstwrapper)]] Enables VST plug-ins.
* [[Foobar2000:Components 0.9/LPCM - Delta-PCM Converter (foo_dsp_delta)|LPCM - Delta-PCM Converter (foo_dsp_delta)]] Noise sharpening filter.
* [[Foobar2000:Components 0.9/OSS/3D (foo_dsp_oss3ddsp)|OSS/3D (foo_dsp_oss3ddsp)]] Audio enhancement. SHAREWARE.
* [[Foobar2000:Components 0.9/Post-track Silence (foo_dsp_silence)|Post-track Silence (foo_dsp_silence)]] Inserts a configurable amount of silence after each track to help external devices like MiniDisc players to sync track changes.
* [[Foobar2000:Components 0.9/Secret Rabit Code Resampler (foo_dsp_src9)|Secret Rabit Code Resampler (foo_dsp_src9)]] Mega Nerd's Secret Rabbit Code sample rate converter.
* [[Foobar2000:Components 0.9/Skip Silence (foo_dsp_skip_silence)|Skip Silence (foo_dsp_skip_silence)]] Detect and skip silence.
* [[Foobar2000:Components 0.9/Soundtouch (foo_dsp_soundtouch)|Soundtouch (foo_dsp_soundtouch)]] Ajust pitch, tempo and rate.
* [[Foobar2000:Components 0.9/SSRC (foo_dsp_ssrc)|SSRC (foo_dsp_ssrc)]] Sample rate converter.
* [[Foobar2000:Components 0.9/Stereo Convolver (foo_dsp_stereoconv)|Stereo Convolver (foo_dsp_stereoconv)]] Take stereo audio and convolve each channel with two impulse responses.
* [[Foobar2000:Components 0.9/Surround Pan (foo_dsp_span)|Surround Pan (foo_dsp_span)]] WYSIWYG Surround panning.
* [[Foobar2000:Components 0.9/Tube Sound (foo_dsp_tube)|Tube Sound (foo_dsp_tube)]] Emulate tube sound.
* [[Foobar2000:Components 0.9/VLevel (foo_dsp_vlevel)|VLevel (foo_dsp_vlevel)]] Dynamic compressor which amplifies the quiet parts of music.
* [[Foobar2000:Components 0.9/VST Host (foo_dsp_vst)|VST Host (foo_dsp_vst)]] Adds support to Virtual Studio Technology audio interface.
* [[Foobar2000:Components 0.9/Winamp DSP Bridge (foo_dsp_winamp)|Winamp DSP Bridge (foo_dsp_winamp)]] Allows the use of Winamp DSPs.
* [[Foobar2000:Components 0.9/XOver (foo_dsp_xover)|XOver (foo_dsp_xover)]] Implements this digital crossover to achieve active multi-amplification.

==Input==
===Music codecs===
* [[Foobar2000:Components 0.9/AC3 Decoder (foo_ac3)|AC3 Decoder (foo_ac3)]] Decodes Dolby Digital lossy audio compression technologies format ([[AC3]]).
* [[Foobar2000:Components 0.9/AC3 Packet Decoder (foo_packet_decoder_ac3)|AC3 Packet Decoder (foo_packet_decoder_ac3)]] Needed for [[AC3]] in [[Matroska]].
* [[Foobar2000:Components 0.9/DTS Decoder (foo_dts)|DTS Decoder (foo_dts)]] Decodes Digital Theater Systems ([[DTS]]) audio format.
* [[Foobar2000:Components 0.9/MIDI Synthesizer Host (foo_midi)|MIDI Synthesizer Host (foo_midi)]]
* [[Foobar2000:Components 0.9/OptimFROG Lossless Audio Decoder (foo_input_ofr)|OptimFROG Lossless Audio Decoder (foo_input_ofr)]] Decodes both the Lossless ([[OptimFROG|OFR]]) and DualStream (OFS) audio format.
* [[Foobar2000:Components 0.9/Shorten Decoder (foo_input_shorten)|Shorten Decoder (foo_input_shorten)]] Decodes Shorten ([[SHN]]) audio format.
* [[Foobar2000:Components 0.9/SPDIF Passthrough (foo_spdif)|SPDIF Passthrough (foo_spdif)]] SPDIF passthrough for [[AC3]] and [[DTS]] files.
* [[Foobar2000:Components 0.9/TTA Audio Decoder (unofficial) (foo_input_tta)|TTA Audio Decoder (unofficial) (foo_input_tta)]] Decodes True Audio ([[TTA]]) audio format.

===Other codecs===
* [[Foobar2000:Components 0.9/ADPCM Decoder (foo_adpcm)|ADPCM Decoder (foo_adpcm)]] Plays GameCube ADPCM audio data and some. (DSP, ADP, GCM, HPS, STM, AST, etc.)
* [[Foobar2000:Components 0.9/Another Slight Atari Player (foo_asap)|Another Slight Atari Player (foo_asap)]] [http://asap.sourceforge.net/ ASAP] is a player/converter of Atari 8-bit music for modern computers. It provides high-quality, identical to the popular Atari800 emulator, emulation of the POKEY sound chip and the 6502 processor.
* [[Foobar2000:Components 0.9/DUMB Module Decoder (foo_dumb)|DUMB Module Decoder (foo_dumb)]] Plays your favorite module files, and then some. (MOD, S3M, XM, IT, 669, PTM, PSM, MTM, UMX)
* [[Foobar2000:Components 0.9/Game Audio Decoder (foo_game)|Game Audio Decoder (foo_game)]] Plays Westwood's audio (AUD), Sierra's sounds (SFX/AUD), Core design's cd audio (cdaudio.WAD), Funcom's music (ISS), Rome Total War's IDX (.IDX/DAT), Timegate's format (RWD), EA's Pathfinder audio (MUS) and Ben Gerard's music (SC68).
* [[Foobar2000:Components 0.9/Game Emu Player (foo_gep)|Game Emu Player (foo_gep)]] Plays several emulation formats. (GBS, NSF, SPC, GYM, HES, VGM)
* [[Foobar2000:Components 0.9/Ganbatte! (foo_ganbatte)|Ganbatte! (foo_ganbatte)]] Plays compressed Edlib (.d00, .d01) files.
* [[Foobar2000:Components 0.9/Lunar 2 PCM Decoder (foo_lunar2)|Lunar 2 PCM Decoder (foo_lunar2)]] Plays audio files found on the original Lunar: Eternal Blue CD (RP*.PCM).
* [[Foobar2000:Components 0.9/M1 Decoder (foo_m1)|M1 Decoder (foo_m1)]] Plays arcade/pinball game sound.
* [[Foobar2000:Components 0.9/MDX Decoder (foo_input_mdx)|MDX Decoder (foo_input_mdx)]] MDX is a MIDI-like format that is designed to be played using the X68000's FM synthesizer.
* [[Foobar2000:Components 0.9/NSF Decoder (foo_input_nsf)|NSF Decoder (foo_input_nsf)]] NSF file is a sound data file containing instructions for the Nintendo Entertainment System (NES) sound hardware.
* [[Foobar2000:Components 0.9/PSF Decoder (foo_psf)|PSF Decoder (foo_psf)]] Plays PlayStation Sound Format (PSF) files.
* [[Foobar2000:Components 0.9/Reverse (foo_input_reverse)|Reverse (foo_input_reverse)]] Play music in reverse.
* [[Foobar2000:Components 0.9/SID Player 2 (foo_sid)|SID Player 2 (foo_sid)]] Sound chip of Commodore's CBM-II, Commodore 64 and Commodore 128 home computers.
* [[Foobar2000:Components 0.9/S98 Decoder (foo_input_s98)|S98 Decoder (foo_input_s98)]] Sound format for the NEC PC-98 microcomputer.
* [[Foobar2000:Components 0.9/USF Decoder (foo_input_usf)|USF Decoder (foo_input_usf)]] Decodes sound data ripped directly from a Nintendo 64 video game.

==Visualisation==
* [[Foobar2000:Components 0.9/Peakmeter (foo uie peakmeter)|Peakmeter for Columns UI (foo_uie_peakmeter)]] Displays the level for each channel in dB.
* [[Foobar2000:Components 0.9/Peakmeter Spectrum (foo uie vis peakmeter spectrum)|Peakmeter and spectrum analyzer (foo_uie_vis_peakmeter_spectrum)]] Plugin that combines a peakmeter with a spectrum analyzer.
* [[Foobar2000:Components 0.9/ProjectM Visualisation (foo_vis_projectM)|ProjectM Visualisation (foo_vis_projectM)]] Based on the ProjectM project, which is a reimplementation of Milkdrop under OpenGL.
* [[Foobar2000:Components 0.9/Shpeck (foo_vis_shpeck)|Shpeck (foo_vis_shpeck)]] Winamp visualisation plugins wrapper.
* [[#wmpvis|WmpVis (foo_uie_wmpvis)]] Uses the visualizations from WMP. ''Panel version only''.

==Other==
===General===
* [[Foobar2000:Components 0.9/Alarm (foo_alarm)|Alarm (foo_alarm)]] Starts playback at the specified period of time.
* [[Foobar2000:Components 0.9/Channel Usage Visualisation (foo_vis_channelusage)|Channel Usage Visualisation (foo_vis_channelusage)]] Channel Usage Visualisation.
* [[Foobar2000:Components 0.9/Common Services (foo_common)|Common Services (foo_common)]] Common services.
* [[Foobar2000:Components 0.9/Converter (foo converter)|Converter (foo converter)]]
* [[Foobar2000:Components 0.9/Cwbowron's Title formating (foo_cwb_hooks)|Cwbowron's Title Format Hooks (foo_cwb_hooks)]] Adds various global titleformat functions/variables, tagger window, new file tagger, and more. No longer maintained, not compatible with current foobar2000 versions anymore.
* [[Foobar2000:Components_0.9/Directory_Monitor_(foo_dirwatch)|Directory Monitor (foo_dirwatch)]] Allows you to specify directories to monitor, and notifies the Media Library of any changes (additions, renames, deletions) that occur.
* [[Foobar2000:Components 0.9/EXTM3U Playlist Creater (foo_extm3u)|EXTM3U Playlist Creater (foo_extm3u)]] Allow to save current playlist in the EXTM3U format.
* [[Foobar2000:Components 0.9/Feature Watcher (foo_whatsnew)|Feature Watcher (foo_whatsnew)]] Watches for added or removed features.
* [[Foobar2000:Components 0.9/File Date (foo_filedate)|File Date (foo_filedate)]] Add to file tag date added, accessed, created or modified from context menu entries.
* [[Foobar2000:Components 0.9/HyperIM (foo_2hyperim)|HyperIM (foo_2hyperim)]] Provides 19 media macros.
* [[Foobar2000:Components 0.9/iPod Manager (foo_dop)|iPod Manager (foo_dop)]] Experimental iPod plugin for foobar2000 0.9.2+, currently in alpha version.
* [[Foobar2000:Components 0.9/Logitech G15 LCD Display (foo_g15lcd)|Logitech G15 LCD Display (foo_g15lcd)]] Control the LCD panel on a Logitech G15 keyboard.
* [[Foobar2000:Components 0.9/Menu Addons (foo_menu_addons)|Menu Addons (foo_menu_addons)]] Adds a few shortcuts in menu.
* [[Foobar2000:Components 0.9/Open URL (foo_openurl)|Open URL (foo_openurl)]] Adds a context menu item to open URLs from metadata fields in a web browser.
* [[Foobar2000:Components 0.9/Pause On Lock (foo_lock)|Pause On Lock (foo_lock)]] Pauses/unpauses foobar2000 on workstation lock/unlock.
* [[Foobar2000:Components 0.9/Pause on Lock (extended) (foo_lock_ex)|Pause on Lock (extended) (foo_lock_ex)]] Pause playing on workstation lock. Optimized for use with Windows XP/2003.
* [[Foobar2000:Components 0.9/Preview (foo_preview)|Preview (foo_preview)]] Play only part of each track in the playlist.
* [[Foobar2000:Components 0.9/Replaygain Override (foo_rg_trn)|Replaygain Override (foo_rg_trn)]] Allows you to automatically switch between replaygain modes based on specified criteria (e.g. use track based RG for shuffle mode, etc.)
* [[Foobar2000:Components 0.9/Run (foo_run)|Run (foo_run)]] Able you to run a external program with the foobar syntax.
* [[Foobar2000:Components 0.9/Run Commands (foo_runcmd)|Run Commands (foo_runcmd)]] Search and execute menu commands.
* [[Foobar2000:Components 0.9/Scheduler (foo_scheduler)|Scheduler (foo_scheduler)]] Plugin for scheduling actions like play, stop, system shutdown/wake up and many more.
* [[Foobar2000:Components 0.9/Send To Device (foo_sendtodevice)|Send To Device (foo_sendtodevice)]] Add "Send to Device" feature.
* [[Foobar2000:Components 0.9/Shell Link Resolver (foo_lnk)|Shell Link Resolver (foo_lnk)]] Shell link resolver.
* [[Foobar2000:Components 0.9/Timebomb (foo_timebomb)|Timebomb (foo_timebomb)]] Stop playback / exit program after a specified time.
* [[Foobar2000:Components 0.9/Unpacker for JMA archive (foo_unpack_jma)|Unpacker for JMA archive (foo_unpack_jma)]]
* [[Foobar2000:Components 0.9/Unpacker for LHA archive (foo_unpack_lha)|Unpacker for LHA archive (foo_unpack_lha)]]
* [[Foobar2000:Components 0.9/Winamp API Emulator (foo_winamp_spam)|Winamp API Emulator (foo_winamp_spam)]] Designed to create a fake Winamp 1.x window which will act as a wrapper between applications written to use the Winamp API and foobar2000.

===Lyrics===
* [[Foobar2000:Components 0.9/Gasazip Lyrics (foo_gasazip)|Gasazip Lyrics (foo_gasazip)]] Search for lyrics and displays it in external window.
* [[Foobar2000:Components 0.9/LyricsDB (foo_lyricsdb)|LyricsDB (foo_lyricsdb)]] Search lyrics basing on song's artist title and sometimes album.
* [[Foobar2000:Components 0.9/Mini Lyrics (foo_ui_minilyrics)|Mini Lyrics (foo_ui_minilyrics)]] Lyrics viewer for synchronizing and displaying lyrics of the currently playing song.
* [[Foobar2000:Components 0.9/Sakura Script Lyrics (foo_sstp_lyrics)|Sakura Script Lyrics (foo_sstp_lyrics)]] Plays a SAKURA script lyrics to a SSP client.

===Notifier===
* [[Foobar2000:Components 0.9/AMIP Wrapper (foo_amipwrapper)|AMIP Wrapper (foo_amipwrapper)]] Complete now-playing plug-in for mIRC, PIRCH, Klient, Bersirc, other IRC and Mail clients, supporting full player control from mIRC, playlist search, clipboard integration, HTTP, dynamic image signatures, etc.
* [[Foobar2000:Components 0.9/Listening To (foo_listeningto)|Listening To (foo_listeningto)]] Sends NowPlaying information to Miranda IM.
* [[Foobar2000:Components 0.9/Miranda IM Notifier (foo_mim_notify)|Miranda IM Notifier (foo_mim_notify)]] Sends configurable information about the current playing song to Miranda-IM and shows popup windows with this info.
* [[Foobar2000:Components 0.9/MSN avatar changer (foo_uie_albumart_msn)|MSN avatar changer (foo_uie_albumart_msn)]] Set currently playing song's album art as avatar.
* [[Foobar2000:Components 0.9/MSN Now Playing (alt) (foo_msnalt)|MSN Now Playing (alt) (foo_msnalt)]] Show the current song as "Now Playing" in MSN and MS Live messenger.
* [[Foobar2000:Components 0.9/WLM Notifier (foo_wlm)|WLM Notifier (foo_wlm)]] Show the current song as "Now Playing" in MSN and Windows Live messenger.
* [[Foobar2000:Components 0.9/On-Screen Display (foo_osd)|On-Screen Display (foo_osd)]] On screen display of track information and volume bar.
* [[Foobar2000:Components 0.9/On-Screen Display GDI (foo_osd_gdiplus)|On-Screen Display GDI (foo_osd_gdiplus)]] Same as foo_osd but uses GDI+ for osd drawing.
* [[Foobar2000:Components 0.9/Pretty Popup (foo_prettypop)|Pretty Popup (foo_prettypop)]] Display a moderately sized popup of song information when a new song plays.

===Online database===
* [[Foobar2000:Components 0.9/Audioscrobbler (foo_audioscrobbler)|Audioscrobbler (foo_audioscrobbler)]] Audioscrobbler will send the name of every song you play on your computer to Last.fm. This effortlessly populates your profile to play radio you like and make personalized recommendations.
* [[Foobar2000:Components 0.9/Foosic Music Database (foo_sic)|Foosic Music Database (foo_sic)]] Sends track information to the [http://www.foosic.org/ foosic online database]. You can currently view your top artist, album and track statistics with foosic. Now support FooID fingerprints.

===Online radio===
* [[Foobar2000:Components 0.9/MSLive (foo_input_mslive)|MSLive (foo_input_mslive)]] Support for [[MMS]] and [[RSTP]] broadcast radio protocols.
* [[Foobar2000:Components 0.9/XM Radio Online Player (foo_xm)|XM Radio Online Player (foo_xm)]] Allow you to listen to XM Radio channels over the Internet by using XM Radio Online.

===Playlist tools===
* [[Foobar2000:Components 0.9/Audioscrobble Charts (foo_scrobblecharts)|Audioscrobble Charts (foo_scrobblecharts)]] Generate a playlist from an artist's Last.fm chart. It also allows you to sort a selection in the playlist by the artist's charts.
* [[Foobar2000:Components 0.9/Bin Pack (foo_binpack)|Bin Pack (foo_binpack)]] Creates playlists from a list with a maximum length.
* [[Foobar2000:Components 0.9/Command Playlist (foo_cmd_playlist)|Command Playlist (foo_cmd_playlist)]] Add /playlist-activate:"Name" to the foobar command line to activate the named playlist.
* [[Foobar2000:Components 0.9/Cuesheet Creator (foo_cuesheet_creator)|Cuesheet Creator (foo_cuesheet_creator)]] Cuesheet creator.
* [[Foobar2000:Components 0.9/Database Search (foo_dbsearch)|Database Search (foo_dbsearch)]] Database search.
* [[Foobar2000:Components 0.9/Default Video Player (foo_default_videoplayer)|Default Video Player (foo_default_videoplayer)]] Allows you to play your video clips from foobar playlist with default external player.
* [[Foobar2000:Components 0.9/Delete Current (foo_deletecurrent)|Delete Current (foo_deletecurrent)]] Adds a menu item giving the possibility to delete from computer the current playing track.
* [[Foobar2000:Components 0.9/Highlight Playing (foo_highlightplaying)|Highlight Playing (foo_highlightplaying)]] Highlights actual now playing item even when the playlist has been broken.
* [[Foobar2000:Components 0.9/History (foo_history)|History (foo_history)]] Very basic song history.
* [[Foobar2000:Components 0.9/Inactive Tracks (foo_skip)|Inactive Tracks (foo_skip)]] Skips tracks that are marked via a tag as inactive.
* [[Foobar2000:Components 0.9/MeowDB (foo_meowdb)|MeowDB (foo_meowdb)]] Takes the Media Library and outputs the results to a form and uploads it to your server using the cURL library.
* [[Foobar2000:Components 0.9/Navigator (foo_navigator)|Navigator (foo_navigator)]] Advanced history component.
* [[Foobar2000:Components 0.9/Now Playing Simple (foo_np_simple)|Now Playing Simple (foo_np_simple)]] Simple now playing plugin to output formatted string to plain text file.
* [[Foobar2000:Components 0.9/Playback Queue Viewer (foo_pqview)|Playback Queue Viewer (foo_pqview)]] Playback queue viewer.
* [[Foobar2000:Components 0.9/Playlist Bind (foo_playlist_bind)|Playlist Bind (foo_playlist_bind)]] Synchronize playlist with contents of specific directory.
* [[Foobar2000:Components 0.9/Playlist Clear (foo_playlistclear)|Playlist Clear (foo_playlistclear)]] All playlists are cleared at startup.
* [[Foobar2000:Components 0.9/Playlist Manager (foo_playlist_manager)|Playlist Manager (foo_playlist_manager)]] Playlist manager.
* [[Foobar2000:Components 0.9/Playlist Name Enhenced (foo_playlist_name_enhanced)|Playlist Name Enhenced (foo_playlist_name_enhanced)]] Appends automatically playlist info ("items / length") to all playlist names.
* [[Foobar2000:Components 0.9/Playlist Tools (foo_utils)|Playlist Tools (foo_utils)]] Provides various general commands.
* [[Foobar2000:Components 0.9/Playlist Tools for Matroska (foo_utils_mka)|Playlist Tools for Matroska (foo_utils_mka)]] Provides various general commands.
* [[Foobar2000:Components 0.9/Queue Manager (foo_queuemanager)|Queue Manager (foo_queuemanager)]] It provides a window that shows the queue's contents and allows you to delete parts of them or clear the whole queue. ''Non-ColumnUI obsolete version, try panel version instead.''
* [[Foobar2000:Components 0.9/Randomized Playlist Entry (foo_random)|Randomized Playlist Entry (foo_random)]] Randomized playlist entry.
* [[Foobar2000:Components 0.9/Rating (foo_rating)|Rating (foo_rating)]] Display an icon in the systray with a tooltip popup from which you can choose a rating between 1 and 5 for the currently playing file.
* [[Foobar2000:Components 0.9/Remove Played (foo_removeplayed)|Remove Played (foo_removeplayed)]] It removes tracks from the playlist once they've been played.
* [[Foobar2000:Components 0.9/Track Finder (foo_trackfinder)|Track Finder (foo_trackfinder)]] Displays a context menu that lets you quickly find songs based on their album title or artists name.
* [[Foobar2000:Components 0.9/Track Position (foo_trackpos)|Track Position (foo_trackpos)]] Provides a new context menu item "place after current playing", that allows you to place any tracks after the current playing one in the playing playlist.
* [[Foobar2000:Components 0.9/XSPF (foo_xspf)|XSPF (foo_xspf)]] Adds XSPF support. XSPF is an open, XML based playlist format.

===Playback Statistics===
* [[Foobar2000:Components 0.9/Playback Statistics Custom (foo_playback_custom)|Playback Statistics Custom (foo_playback_custom)]] Stores playback statistics in tags like foo_playcount_mod, with claimed faster response, and uses foo_custominfo db if file is unavailable for writing.
* [[Foobar2000:Components 0.9/Play Count Mod (foo_playcount_mod)|Play Count Mod (foo_playcount_mod)]] Unofficial playcount modded to supress the update tag popups.

===Remote control===
* [[Foobar2000:Components 0.9/Advanced Controls (foo_advancedcontrols)|Advanced Controls (foo_advancedcontrols)]] Control all the playback functions from icons in the Taskbar Notification Area (play, pause, next, previous, open)
* [[Foobar2000:Components 0.9/Appcommand (foo_appcommand)|Appcommand (foo_appcommand)]] Adds the ability to assign multimedia keyboard buttons that sends APPCOMMAND (for example some HP keyboards) as (global) keyboard hotkeys.
* [[Foobar2000:Components 0.9/Bluetooth Control (foo_bluetooth_ctrl)|Bluetooth Control (foo_bluetooth_ctrl)]] Control your favourite music player using your favourite Symbian-based bluetooth enabled phone.
* [[Foobar2000:Components 0.9/COM Automation Server (foo_comserver2)|COM Automation Server (foo_comserver2)]] Allows controlling foobar2000 through COM Automation
* [[Foobar2000:Components 0.9/Control Server (foo_controlserver)|Control Server (foo_controlserver)]] Acts as a server to control Foobar2000. Connect with a telnet client and control it using ASCII commands.
* [[Foobar2000:Components 0.9/DDE Control (foo_ddecontrol)|DDE Control (foo_ddecontrol)]] Control foobar remotelly with DDE interprocess communication (interface in japanese only).
* [[Foobar2000:Components 0.9/HTTP Writer (foo_write_http)|HTTP Writer (foo_write_http)]] It's TCP/IP server that listens on a specified port for incoming requests such as play, stop, etc.
* [[Foobar2000:Components 0.9/Joystick Control (foo_joystick_control)|Joystick Control (foo_joystick_control)]] Control foobar2000 from a joystick/gamepad.
* [[Foobar2000:Components 0.9/Minibar2k (foo_Minibar2k)|Minibar2k (foo_Minibar2k)]] Control Foobar2k from your PDA (PocketPC based).
* [[Foobar2000:Components 0.9/Remote Control (foo_remotecontrol)|Remote Control (foo_remotecontrol)]] Adds support to Melloware Intelliremote software which claims to work with Creative remote control (Soundblaster Live!, Audigy, Extigy, Audigy ZS and Soundblaster X-Fi.)
* [[Foobar2000:Components 0.9/RM-1800 (foo_mr1800)|RM-1800 (foo_mr1800)]] Adds support of Creative X-Fi's remote (RM-1800).
* [[Foobar2000:Components 0.9/RM-X Media Edition (foo_rmx)|RM-X Media Edition (foo_rmx)]] Yet another plugin for remote control. SHAREWARE.
* [[Foobar2000:Components 0.9/Titlebar (foo_managedWrapper)|Titlebar (foo_managedWrapper)]] Create a personal title bar that shows the currently playing song on the top of the screen all the time. It supports custom-made skins.
* [[Foobar2000:Components 0.9/WinLIRC Client (foo_lirc)|WinLIRC Client (foo_lirc)]] Control Foobar from a remote control.

===Tagging===
* [[Foobar2000:Components 0.9/Custom Info (foo_custominfo)|Custom Info (foo_custominfo)]] Allows you to set info fields for files without modifying them.
* [[Foobar2000:Components 0.9/Discogs (foo_discogs)|Discogs (foo_discogs)]] Retrieve info and album art from Discogs.com database.
* [[Foobar2000:Components 0.9/Freedb Tagger (foo_freedb2)|Freedb Tagger (foo_freedb2)]] Freedb.org tagger. Now included with official foobar2000 installers.
* [[Foobar2000:Components 0.9/Live Show Tagger (foo_tradersfriend)|Live Show Tagger (foo_tradersfriend)]] Live show tagger.
* [[Foobar2000:Components 0.9/Masstagger Addons (foo_masstag_addons)|Masstagger Addons (foo_masstag_addons)]] Some addons for masstagger, including code page conversion and chinese conversion.

==Links==
* [http://pelit.koillismaa.fi/plugins/ Official third-party components site]
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=42730&st=0 List of components] from earlier versions not yet ported to 0.9.x.

* [[foobar2000:foobar2000|Go back to Main Page]]

Foobar2000:Components 0.9/Panel Stack Splitter (foo uie panel splitter)

2009-03-10T22:18:58Z

Chiwou: added the Japanese read me translation

{{fb2k}}
{{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.

foobar2000 v0.9.4.3+, Columns UI0.1.3 beta1 v7+

= Requirements =
* [http://www.foobar2000.org/ foobar2000 0.9.4.3+]
* Columns UI 0.1.3 beta1 v7+

= Read me (translated from the Japanese original) =

foo_uie_panel_splitter.dll v0.3.6.3 (alpha ver)
for foobar2000 v0.9.5.1 +, Columns UI0.3 +, WindowsXP +

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?

Description
Add and remove panels from the basic layout of the ColumnsUI do.
They can add from the context menu.

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.

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.
(size and auto-scaling is disabled)

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.)
Title Formatting is enabled.
% _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.
is on the use parsentage value is, Splitter percentage for the size of the [0-100] can be specified.
use parsentage value of setting the example on:
left: 25
top: 25
width: 50
height: 50

padding: Add a space around the panel.
Title Formatting to put the numbers are fixed, so invalid.
If the automatic alignment panels, padding can be resized with the mouse as if the border is set.
enable resizable border with on / off can be

caption: The name of the panel, the identifier
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.

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.

[Field]
% 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

[Function]
$ font (name, size, OPTIONS)
Font settings.
OPTIONS: bold italic underline strikeout

Example: $ font (Tahoma, 10, bold italic)

$ drawstring (text, x, y, W, H, rgba, OPTIONS [, OPTIONS2])
String drawing functions.
Text coordinates (x, y) to draw on.
[Note] This function is a string and DrawText drawtextex not only in view.
Maybe only TrueType fonts.

OPTIONS: Alain specified, the specified quality of drawing, and to specify the clip.
Alain left hcenter right specified horizontal
Alain specified top vcenter bottom vertical

nowrap not wraparound

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 now)
glow_aa glow option to use a special mode. (noaa, aa, hq exclusive)

If you set the trimming trimchar trimword fit the display range
elipchar elipword the last to fit the display range If・・・set to replace the

mempos getlastpos, to be able to get the coordinates of the drawing.

OPTIONS2 (optional experimental, experimental option)
Specifying the terms of the glow effect.
Specified in the OPTIONS glow_aa only, outline and semibold is available.

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_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.
※ glow is a heavy process. (Especially the pseudo transparent)

Example, $ drawstring (abcd, 10,10,, ,255-128-64-128,)
$ drawstring (abcd, 10,10,, ,255-128-64-128, left vcenter, glow :2:255-255-255)
$ 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)

$ drawrect (x, y, w, h, R1-G1-B1-A1, R2-G2-B2-A2, OPTIONS)
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
Aa - put ANCHIERIASU

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_point)
Gradient fill in the drawing functions in the rectangle.
Coordinates (x, y) size (w, h) Draws a rectangle.
R1-g1-b1-a1 Gradient start color
R2-g2-b2-a2 Gradient end color

OPTIONS
Vertical gradient of vertical
Gradient horizontal horizontal
Aa put ANCHIERIASU
how nonlinear nonlinear gradient

Peak_point: 0-100
Shifted the position of the gradient endpoints.
0 by default, r1-g1-b1-a1 -> r2-g2-b2-a2
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)
$ gradientrect (0,50,50,50255-128-64-128255-255-255,, 10)

$ drawblurrect (x, y, w, h, colour, level)
Filling a rectangle drawing functions to blur the outline.
Level [1-7]

$ 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)
VisualStyle in the rectangle with a control (button or progress bar) function to draw.
The only practical to draw a picture may be low.
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.
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 if not drawn in, the parts are not defined.

Example: $ 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)
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,,)

$ drawellipse (x, y, w, h, R1-G1-B1-A1, R2-G2-B2-A2, RESERVED)
Ellipse drawing functions.
Coordinates (x, y) size (w, h) draws an ellipse.
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)
(x1, y1), (x2, y2), (x3, y3) Draw a triangle and vertex function.
R1-G1-B1-A1 internal color
R2-G2-B2-A2 Border Color

OPTIONS
Aa - put ANCHIERIASU

Example: $ drawtriangle (10,5,20,10,10,15200-100-100,, aa)

$ imageabs (x, y, w, h, path, OPTIONS, n, alpha, OPTIONS2)
Coordinates (x, y) size (w, h) show the images in the path is specified.
Retained in memory and after resizing the image, if you raise the efficiency of the process see below.
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
Poor quality and will be expanded after the reduction.
Nodisplay noexpansion and use,
Cache memory may be the largest reduction in the rate of reduction in the rate of use.

If there are images true, if false is returned.

Dipsplays the image specified by path.
after the image is resized, it is cached on the memory.

path: absolute path of the image (or an embedded image of AudioFile path)

OPTIONS
■ <appearance>
nokeepaspect not maintain the aspect ratio (nodisplay, archive, icon options and non-exclusive).
Hide nodisplay read only memory.
noexpansion will reduce, not increase.

■ <align> exclusive.
Left right horizontal aryne specified.
Specify vertical aryne top bottom.

■ <misc>
wc wildcard (*,?) enabled.

■ <read engine> exclusive.
archive archive reader through the path of the images.
The format of the archive reader is path dependent, the absolute path of the archive | base path in the archive file.
Example: C: \ aaa \ image.zip | bbb / ccc.jpg
icon path is specified in the icon file (*. ico) to appear.

Audio 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.
Audio artreader_front path specified by the embedded image file foobar2000 loaded at the core of the artwork reader.
Audio artreader_back path specified by the embedded image file foobar2000 loaded at the core of the artwork reader.
Audio artreader_disc path specified by the embedded image file foobar2000 loaded at the core of the artwork reader.
Audio artreader_icon path specified by the embedded image file foobar2000 loaded at the core of the artwork reader.
(artreader *** are currently disrecommended options because these option seem to be slow)

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
Opacity

OPTIONS2 (shadow effect)
Glow: expand: colour
Offset: x: y

Example $ 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%. 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
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
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,,,))

$ drawimage (x, y, w, h, path, OPTIONS, n, aplha)
Coordinates (x, y) size (w, h) show the images in the path is specified.
$ Imageabs similar.
w and h show the size of the original omitted.
From memory immediately after display processing will be removed.
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 maintain aspect ratio
Left
Right
Top
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
Opacity (transparency)

● auxiliary drawing

$ 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,4100100, $ 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.
Also, drawstring in, glow_aa glow if put in effect,
Measurestring see the range of results and may not match.

$ 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 returns.
This means that only have $ imageabs $ imageabs_rc behind.
nokeepaspect may be able to calculate the aspect ratio should be applied.

$ setparcentmode (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 form of returns.

index: [0-30] color index system

$ averagecolour (colour1, colour2 [,・・・])
R-g-b-a to the average color of the form.
(Colour1 + colour2 +・・・) / N

$ blendcolour (colour1, w1, colour2, w2, [,・・・])
R-g-b-a return with the average weight in the form.
(w1 * colur1 + w2 * colour2 +・・・+ wN * colourN) / (w1 + w2 +・・・+ wN)

$ addcolour (colour1, colour2 [,・・・])
R-g-b-a to add the color of the form.
・・・Colour1 + colour2 + + colourN

$ subcolour (colour1, colour2 [,・・・])
R-g-b-a to form a color subtraction.
Colour1 - colour2 - colour3・・・- colourN

$ findfile (path, [path2, path3 ,...])
path (wildcards accepted) to be specified in the file exists, returns the first file.
If you do not have the file does not return anything. (Strictly speaking, "false" returns)
Path can be specified.

● function button

$ 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

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: 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)
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

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)
$ 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 of
Using the GDI to draw. Simple minutes, may be faster.

$ drawtext (text, x, y, W, H, r-g-b, OPTIONS)
GDI text drawing functions
Text coordinates (x, y) in output

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)

$ gettextwidth (text, [FONTNAME, SIZE, OPTIONS])
GDI (drawtext, drawtextex) returns the width in the text when drawing horizontal text.
can specify the font ($ font option). specified font is optional

$ gettextheight ([FONTNAME, SIZE, OPTIONS])
GDI returns vertical width of text when drawn.
can specify the font ($ font option). specified font is optional

$ 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 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.

$ 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 =
* [http://foo2k.chottu.net/ Official page with download link] (Japanese)
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=62114 Discussion thread]