Hydrogenaudio Knowledgebase - User contributions [en]

Foobar2000:Title Formatting Reference

2012-03-04T10:28:52Z

Brother John: /* Arithmetic functions */

{{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 general overview of titleformat syntax and its basic rules. The article [[foobar2000:Titleformat Examples|Titleformat Examples]] offers user-submitted examples of code for specific purposes; feel free to add your own if you think it can be of use to others.

For details of the query syntax, which uses some of these fields to find files for playlists, etc., 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. Decimal points are not supported. Examples:
* "c3po" → 0
* "4.8" → 4
* "-12" → -12
* "- 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'' by ''b'' and rounds down to an integer. 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 =

==For the Default User Interface==
Starting in version 1.0, the Default UI playlist view doesn't support color functions. In that location, text color can only be adjusted via angle-bracket syntax: Use < and > characters to make specific text <dimmed> ''vs.'' the default color or >highlight>ed with the highlight color, with up to three levels in each case, ''e.g.'': <dimmed>, >highlight<, >>more highlight<<, <<<very dim>>>.

==For Columns UI==

The playlist in the Columns UI still supports the following 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''. Words which begin with an alphanumeric character are shortened to the first character. Spaces and parentheses are stripped. Example:
* $abbr('This is a Long Title (12-inch version) [needs tags]') → TiaLT1v[needst

=== $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 from the left of the string ''a''. This function is the same as $left(a,len). Negative numbers produce the entire string. Examples:
* $cut('abc123',3) → abc
* $cut('abc123',0) → (nothing)
* $cut('abc123',-1) → abc123

=== $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 first ''len'' characters from the left of the string ''a''. This function is the same as $cut(a,len). Negative numbers produce the entire string. Examples:
* $left('abc123',3) → abc
* $left('abc123',0) → (nothing)
* $left('abc123',-1) → abc123

=== $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'' characters. Pads with zeros from the left if necessary. ''len'' includes the dash when the number is negative. If ''n'' is not numeric, it is treated as zero. Examples:

* $num(123,5) → 00123
* $num(-123,5) → -0123
* $num(4.8,5) → 00004
* $num(A1,5) → 00000

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

== 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/Playback Statistics v3.x (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:Titleformat_Album_List|Album List Title Formatting]]
* [[Foobar2000:Preferences:Album List|Preferences: Album List]]
== Playlist Organizer ==
* [http://wiki.hydrogenaudio.org/index.php?title=Foobar2000:Components/Playlist_Organizer_(foo_plorg)#Nodes Playlist Organizer: Nodes Title Formatting]

== Columns UI ==

* [http://yuo.be/columns.php Columns UI homepage]
* [http://yuo.be/wiki/columns_ui:config:global_variables Global variables reference]
* [http://yuo.be/wiki/columns_ui:config:colour_string Playlist colors reference]
* [http://yuo.be/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)

2011-05-22T12:39:30Z

Brother John: /* Setting up Menus and Items */

{{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+]

= ELPlaylist Reference (translated and adapted from Japanese Read me) =

ELPlaylist panel provides a single column playlist for [[Columns UI]]. Each track in the playlist occupies a line; within that line you can position elements freely. ELPlaylist also allows grouping items together (e.g. the tracks of an album) and nesting groups (e.g. for multi-disc albums).

In order to use ELPlaylist you need to setup your Columns UI layout accordingly and add an ELPlaylist panel in ''Columns UI configuration / Layout''. To change the playlist settings and scripts, right-click on any ELPlaylist panel and choose ''Settings'' from the context menu.

ELPlaylist can utilize foobar2000’s the built-in artwork reader. Depending on your configuration it can be accessed in the Columns UI Preference section (Artwork) or directly at the display preference page (Album Art).

In order to fully utilize ELPlaylist features and settings you should be familiar with [[Foobar2000:Title Formatting Reference|Title Formatting]] (TF). For further reading refer to the [[Foobar2000:Title Formatting Reference|Title Format reference]].

The readme file for this reference was translated from ''foo_uie_elplaylist.dll v0.6.4.2beta''. Current stable version is ''v0.6.9.0b (2010/07/30)''. Current beta version is ''v0.6.9.1.2b''.

The formatting fields and functions provided by ELPlaylist are very similar to the [[Foobar2000:Components 0.9/Panel Stack Splitter (foo uie panel splitter)|panel stack splitter]] component, because both are developed by the same author, '''ssenna'''.

Requirements: foobar2000 v0.9.5.1 +, Columns UI0.3 +, WindowsXP +
SDK version foobar2000 :2008-07-20 cui: 6.3

== Setting up Menus and Items ==

In order to change ELPlaylist settings, right-click on any playlist item and choose ''Settings''. The configuration dialog is divided into six main tabs.

=== Script Tab ===

The '''Script''' tab contains the actual scripts that define the appearance of every playlist element, i.e. track rows, group headers and popups.

[[Image:elplaylist-config-script.png]]

Each element can be modified by using title format script and the special ELPlaylist functions and fields.You can also store multiple sets of scripts as ''Titleformat Script Presets''.

* '''Track list''' contains the TF script for individual track entries, i.e. rows, in the playlist.
* '''Group header''' contains the TF script for the group headers.
* '''Per Second''' contains a TF script for the currently playling track row. In contrast to the other scripts this one gets updated once every second. If you want to display now-playing animations, elapsed/remaining playback time etc. '''Per Second''' is the appropriate script. The '''Per Second''' script is executed ''in addition to the '''Track list''' script''.
* '''Popup (Background)''' defines the background of the popup window that appears when your mouse hovers over a playlist entry.
* '''Popup (Track)''' defines the text of the popup window that appears when your mouse hovers over a playlist entry. Most of ELPlaylist’s custom fields/functions work, e.g. use ''%el_is_group%'' to determine if mouse hovers over a track row or a group header.

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.

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.
* Example: ''C:\image\%album%.jpg''

=== Style Tab ===

This tab controls a number of global visual settings for the playlist.

[[Image:elplaylist-config-style1.png]]

''Custom Background Colour'' defines background colours for different types of playlist entries.

* ''Total'' is the background colour of the complete playlist.
* ''Odd item'' is the the background colour of odd rows.
* ''Even item'' is the the background colour of even rows.
* ''Selected item'' is the background colour of selected rows.
* ''Playing item'' is the background colour of the currently playing track.
* ''Selected and Playing item'' is the background color of playing and selected tracks rows.

Odd and even item for the right padding and left padding can be drawn in the area. Odd and even can be 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.''

[[Image:elplaylist-config-style2.png]]

''Pseudo transparent'': Enables pseudo-transparent background. It tends to be a CPU demanding to process. (If the slowdown is severe, one solution is to narrow the viewing area.)

''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 Tab] ===

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

[[Image:elplaylist-config-grouping1.png]]

* ''Group by'': Grouping can be stored as a set of presets.
* ''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. Sorting is not done automatically.

[[Image:elplaylist-config-grouping2.png]]

* ''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. This can be used to ensures that images are displayed completely even if the number of rows would be too low otherwise. This section is ''Titleformat'' enabled and 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 are automatically inserted. ''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.

[[Image:elplaylist-config-grouping3.png]]

* ''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 Tab] ===

Title format preprocessor: Enables the definition of Titleformat fields that can be used in every subsection: ''[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.
Example: Album art path should be available to each section. This defined by:
'''foo''' : ''C:\%album%.jpg''
Now in each section the field ''%Foo%'' will be substituted by ''C:\%album%.jpg''. If the path changes in it needs to be changed in the ''Field definition'' section, only.

=== [Behaviour Tab] ===

This section allows to change the behavior of various playlist features:
* ''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 drop:'' Drag & Drop the selected tracks to go. If this option is turned off, press [Alt] while using Drag & Drop to move items.
* ''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 section [[shortcuts]]. IME in XP then I will support as possible to find it in Japanese. Alphabet in Vista (ASCII) may only search. (Originally I worked 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:'' To set up the each item of the right-click menu and to display the item or not.

=== [Misc Tab] ===

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

=== Keyboard Shortcuts ===

==== Commands ====

* 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 are matched against group format (''% el_group_format%'') by incremental search. (Incremental search has to be enabled though)

The following shortcuts are available.
* Ctrl-e: Reset the search (previous keystrokes)
* Ctrl-d: Find Next. (Ctrl-s if I could spare a···)
* Ctrl-r: Find

=== Main Menu Options (View->ELPlaylist) ===

All panels will be affected by selecting a menu item here.
* 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 ===

Please refer also to foobar's default [[Foobar2000:Title Formatting Reference|Title Format]] Reference

== Fields ==

ELPlaylist provides custom fields that can be used just like normal title formatting fields. Not all custom fields are available to all scripts. See below for details.

===%el_isplaying%===
Returns true if a track is currently playing.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second''

===%el_selected%===
Returns true for selected lines in the playlist.

Available in the following scripts: 
''Track list'', ''Per Second''

click action of the Select group whether the selected group

''Group header''

===%el_focused%===
Returns true for focused lines in the playlist.

Available in the following scripts: 
''Track list'', ''Per Second''

===%el_width%===
Returns the width of the line’s viewing area.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Popup''

===%el_height%===
Returns the height of the line’s viewing area. Note that ''%el_height%'' may return different values for track lines and group headers.

Track lines: ''%el_height%'' = ''%el_row_height%'' 
Group headers: ''%el_height%'' = ''%el_group_row%'' × ''%el_row_height%''

''$setworldtransform()'' is affected.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Popup''

===%el_row_height%===
Returns the base line’s height. Also see ''%el_height%''.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second''

===%el_group_row%===
Returns the number of rows in the group header. Also see ''%el_height%''.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second''

===%el_item_count%===
Returns the number of tracks in the group.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num'', ''Popup''

===%el_item_count2%===
Returns the number of empty tracks in the group.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second''

Number of tracks processed in Popup

''Popup''

===%el_direct_item_count%===
Returns the number of tracks within a group including all subgroups. Except in special cases, a group with a sub-group will be 0. If the group does not have a sub-group ''%el_direct_item_count''% should be the same as ''%el_item_count%''.

Available in the following scripts: 
''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.

Available in the following scripts: 
''Track list'', ''Per Second'', ''Popup''

===%el_item_index2%===
The index tracks the group (counting from 0) Count up the line is empty.

Available in the following scripts: 
''Track list'', ''Per Second''

===%el_total_group_count%===
Number of groups (number of headers for all groups)

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''

===%el_total_group_index%===
Index group (index group headers in the list)

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''

===%el_group_count%===
Number of groups that belong to the same parent group

Available in the following scripts: 
''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)

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''

===%el_group_depth%===
The depth of the current group (counting from 0)

Available in the following scripts: 
''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.

Available in the following scripts: 
''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.

Available in the following scripts: 
''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.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''

===%el_is_collapsed% (%el_is_hide_item%)===
Determines whether the group is collapsed. (Whether or not display the group header only)

Available in the following scripts: 
''Group header'', ''Group row''

===%el_is_empty%===
Empty or no go. (Just opposite ''%el_is_valid%'')

Available in the following scripts: 
''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.

Available in the following scripts: 
''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)

Available in the following scripts: 
''Track list'', ''Per Second''

===%el_sum_length%===
Total length of the track of the group ''[hh:]mm:ss''

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''

===%el_sum_length_seconds%===
Total length of the track of the group (s)

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''

===%el_backcolour%===
Returns the background color in ''r-g-b'' format. You can create an ''r-g-b-a'' value by simply adding the alpha value, e.g. ''%el_backcolour%-192''.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second''

===%el_preset_index%===
The current group by the preset index returns.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''

===%el_preset_name%===
Returns the current group by the preset name.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''

===%el_is_group%===
Popup whether the group header.

Available in the following scripts: 
''Popup''

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

Available in the following scripts: 
''Popup''

===%el_is_themed%===
Returns true if Visual Styles are enabled in ELPlaylist’s options.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''

== Functions (Draw control) ==

[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]) ===

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

''Note:'' This function is a string and there is also a GDI version of the same functions available [[#$drawtext(text,x,y,W,H,r-g-b,OPTIONS) | $drawtext]] and [[#$drawtextex(text,x,y,W,H,r-g-b,OPTIONS) | $drawtextex]]. This function might work for TrueType fonts, only.

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

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

'''OPTIONS2''' - specifying the glow effect (experimental stage):
* ''glow:expand:colour[:strength]'': glow options
** ''Expand'' - [0-5]
** ''Colour'' - r-g-b
** ''Strength'' - [0-3] glow_aa case of disabled

Offset:x:y
* ''X'' - glow in the horizontal offset
* ''Y'' - glow in the vertical offset

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

Examples:
* $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 function. Coordinates (x,y) size (w,h) Draws a rectangle.
* '''R1-G1-B1-A1''' internal color
* '''R2-G2-B2-A2''' border color

'''OPTIONS''':
* Aa - enable [http://en.wikipedia.org/wiki/Spatial_anti-aliasing anti aliasing]

Example:
* $drawrect(0,50,50,50,255-128-64-128,,aa)

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

Draws a rectangle with gradient fill at the coordinates '''(x,y)''' and size '''(w,h)'''
* '''r1-g1-b1-a1''' gradient start color
* '''r2-g2-b2-a2''' peak color gradient

'''OPTIONS''':
* ''vertical'': vertical gradient
* ''horizontal'': horizontal gradient
* ''aa'': enable [http://en.wikipedia.org/wiki/Spatial_anti-aliasing anti aliasing]
* ''nonlinear'': nonlinear gradient

'''PEAK''': 0-100
* Shifted the peak position of the gradient.
** 0 by default, to end at peak color.
** 50 When is the peak of color.

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

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

Draws a rectangle with a blured outline at the coordinates '''(x,y)''' and size '''(w,h)'''
* '''Level''' [1-7]: blur level

=== $drawfocusrect(x,y,w,h) ===

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

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

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

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

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

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

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

Draws a rectangle with rounded corners at coordinates (x,y) and size (w, h). The degree of roundness is defined by (w2,h2).
* In order to achieve a decent effect the condition w>4*w2 and h>4*h2 should be matched.
* '''R1-G1-B1-A1''' internal color
* '''R2-G2-B2-A2''' border color

Example:
* $drawroundrect(10,20,50,50,4,4,255-255-128-255,,)

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

Draws an ellipse at coordinates '''(x,y)''' with size '''(w,h)'''.
* '''R1-G1-B1-A1''' internal color
* '''R2-G2-B2-A2''' border Color

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

Draw a triangle and vertex function.
* '''(x1,y1),(x2,y2),(x3,y3)'''
* '''R1-G1-B1-A1''' internal color
* '''R2-G2-B2-A2''' Border Color

'''OPTIONS''':
* ''aa'': enable [http://en.wikipedia.org/wiki/Spatial_anti-aliasing anti aliasing]

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

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

Displays an image at Coordinates '''(x,y)''' with size '''(w,h)''' specified by '''path'''. After the image is resized, it is cached in the memory. The image is referenced, the memory is removed from them.


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

'''OPTIONS''':

<appearance>
* ''nokeepaspect'': not to maintain aspect ratio (nodisplay, archive, icon options and non-exclusive)
* ''nodisplay'': Hide image, read only in memory
* ''noexpansion'': image will not be expanded if smaller than the specified image size

<alignment>
* ''left right'': horizontal alignment
* ''top bottom'': vertical alignment

<misc>
* ''wc'': enables wildcard characters (*,?).

<read mode>
* ''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.
* ''artreader'': 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 not recommended optionss because these seem to be slow)

'''n''': rotateflip Index for:
* ''1'': 90°
* ''2'': 180°
* ''3'': 270°
* ''4'': flip horizontal
* ''5'': 90° + flip horizontal
* ''6'': Flipped vertically
* ''7'': 90° + Flip Vertically

'''Alpha''' (Opacity)
* ''0-255''

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

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

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

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

'''OPTIONS''' (imageabs):
* ''nokeepaspect'': not maintain the aspect ratio
* ''nodisplay'': Hide read only memory
* ''archive''
* ''Icon''
* ''Horizontal Alignment''
** left
** hcener
** right
* ''Vertical Alignment''
** top
** vcenter
** bottom

'''N''' rotateflip Index for:
* 1: 90°
* 2: 180°
* 3: 270°
* 4: flip horizontal
* 5: 90° + flip horizontal
* 6: Flipped vertically
* 7: 90° + Flip Vertically

'''Alpha''' (Opacity)
* 0-255

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

== Additional drawing functions ==

=== $getlastpos(elem) ===

Display function imageabs, imageabs_rc right after, to get the coordinates to draw a picture. Also, ''[[#$measurestring(text,x,y,W,H,OPTIONS) | $measurestring]]'' use them when you get the results. If you are drawString, mempos available only immediately after the specified coordinates.

Elem element to retrieve.
X: left
Y: top
W: width
H: height
R: right
B: bottom

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

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

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

=== $getimagewidth(path),$getimageheight(path) ===

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

=== $setcoordinate(mode) ===

$setcoordinate(0,X,Y,W,H)
$setcoordinate(1,X,Y,R,B)

Allows in a drawing function to transfer the argument ''x,y,w,h'' to ''x,y,right,bottom''.
''$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.

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

'''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%''

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

'''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%''

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[,···]) ===

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

''(Colour1 + colour2 +···) / N''

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

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

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

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

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

''Colour1 + colour2 + ··· + colourN''

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

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

''Colour1 - colour2 - colour3···- colourN''

=== $xorcolour(colour1,colour2[,···]) ===

Calculates XOR operatorion of a given color ''r-g-b'' sets. Returns only colour1 alpha channel.

''colour1 xor colour2 xor colour3···xor colourN''

== General-purpose system functions ==

The folowing functions are availble for the [Track list] [Group header] [Per Second] [Group row] [Min item num] [Popup] sections.

=== $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,...]) ===

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

=== $el_scale(val,factor[,DIV]) ===

Calculates a share of a given value: ''val * factor/100'' or ''val * factor / DIV''

Example: ''$el_scale(200,40)'' = 80

* ??val and the overflow factor is too large.

== GDI drawing functions ==

Using the Windows System Component [http://en.wikipedia.org/wiki/Graphics_Device_Interface GDI] to draw. GDI functions are usually faster, but they do not allow alpha blending and shadow effects (glow).

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

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

OPTIONS:
* Align ''left hcenter right specified horizontal''
* Align ''specified top vcenter bottom vertical''
* Not noclip clip

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

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

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

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

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

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

=== $gettextheight([FONTNAME,SIZE,OPTIONS]) ===

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

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

Filled rectangle function

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

Function of the fill rectangle with rounded corners

== Popup system functions ==
Valid for [Popup (Background)], [Popup (Track)].

=== $popupsize(w,h) ===

Pop-up function to reduce the size of the popup:
* W < max size (width)
* H < max size (height)

=== $popuphide() ===

Suppresses the 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/ELplaylist panel (foo uie elplaylist)

2011-05-08T19:36:52Z

Brother John: /* Setting up Menus and Items */ added some screenshots

{{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+]

= ELPlaylist Reference (translated and adapted from Japanese Read me) =

ELPlaylist panel provides a single column playlist for [[Columns UI]]. Each track in the playlist occupies a line; within that line you can position elements freely. ELPlaylist also allows grouping items together (e.g. the tracks of an album) and nesting groups (e.g. for multi-disc albums).

In order to use ELPlaylist you need to setup your Columns UI layout accordingly and add an ELPlaylist panel in ''Columns UI configuration / Layout''. To change the playlist settings and scripts, right-click on any ELPlaylist panel and choose ''Settings'' from the context menu.

ELPlaylist can utilize foobar2000’s the built-in artwork reader. Depending on your configuration it can be accessed in the Columns UI Preference section (Artwork) or directly at the display preference page (Album Art).

In order to fully utilize ELPlaylist features and settings you should be familiar with [[Foobar2000:Title Formatting Reference|Title Formatting]] (TF). For further reading refer to the [[Foobar2000:Title Formatting Reference|Title Format reference]].

The readme file for this reference was translated from ''foo_uie_elplaylist.dll v0.6.4.2beta''. Current stable version is ''v0.6.9.0b (2010/07/30)''. Current beta version is ''v0.6.9.1.2b''.

The formatting fields and functions provided by ELPlaylist are very similar to the [[Foobar2000:Components 0.9/Panel Stack Splitter (foo uie panel splitter)|panel stack splitter]] component, because both are developed by the same author, '''ssenna'''.

Requirements: foobar2000 v0.9.5.1 +, Columns UI0.3 +, WindowsXP +
SDK version foobar2000 :2008-07-20 cui: 6.3

== Setting up Menus and Items ==

=== [Script Tab] ===

In order to change '''ELPlaylist''' settings, right-click on any playlist item and choose the ''Settings'' dialog.

The first tab ''Script'' is divided into 5 subsections:

# Track list
# Group header
# Per second
# Popup backround
# Popup track

[[Image:elplaylist-config-script.png]]

Each section can be modified by using title format script and special ELPlaylist functions and fields. These section allow to customize editing every element of a playlist such as rows and group sections. Edits can be stored and organized in ''Titleformat Script Presets''.

==== [Track list] ====

To control the drawing of the track line Title Format.

==== [Group header] ====

To draw the header control group Title Format.

==== [Per Second] ====

To control the line drawn in the second track is updated play Title Format. This can be used to display now playing info.

==== [Popup (Background)] ====

Pop-up window to control the drawing of Title Format. 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.

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.
* Example: ''C:\image\%album%.jpg''

=== [Style Tab] ===

[[Image:elplaylist-config-style1.png]]

This Tab allows to control a number of visual settings of the playlist.
* ''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 can be 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.''

[[Image:elplaylist-config-style2.png]]

''Pseudo transparent'': Enables pseudo-transparent background. It tends to be a CPU demanding to process. (If the slowdown is severe, one solution is to narrow the viewing area.)

''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 Tab] ===

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

[[Image:elplaylist-config-grouping1.png]]

* ''Group by'': Grouping can be stored as a set of presets.
* ''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. Sorting is not done automatically.

[[Image:elplaylist-config-grouping2.png]]

* ''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. This can be used to ensures that images are displayed completely even if the number of rows would be too low otherwise. This section is ''Titleformat'' enabled and 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 are automatically inserted. ''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.

[[Image:elplaylist-config-grouping3.png]]

* ''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 Tab] ===

Title format preprocessor: Enables the definition of Titleformat fields that can be used in every subsection: ''[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.
Example: Album art path should be available to each section. This defined by:
'''foo''' : ''C:\%album%.jpg''
Now in each section the field ''%Foo%'' will be substituted by ''C:\%album%.jpg''. If the path changes in it needs to be changed in the ''Field definition'' section, only.

=== [Behaviour Tab] ===

This section allows to change the behavior of various playlist features:
* ''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 drop:'' Drag & Drop the selected tracks to go. If this option is turned off, press [Alt] while using Drag & Drop to move items.
* ''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 section [[shortcuts]]. IME in XP then I will support as possible to find it in Japanese. Alphabet in Vista (ASCII) may only search. (Originally I worked 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:'' To set up the each item of the right-click menu and to display the item or not.

=== [Misc Tab] ===

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

=== Keyboard Shortcuts ===

==== Commands ====

* 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 are matched against group format (''% el_group_format%'') by incremental search. (Incremental search has to be enabled though)

The following shortcuts are available.
* Ctrl-e: Reset the search (previous keystrokes)
* Ctrl-d: Find Next. (Ctrl-s if I could spare a···)
* Ctrl-r: Find

=== Main Menu Options (View->ELPlaylist) ===

All panels will be affected by selecting a menu item here.
* 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 ===

Please refer also to foobar's default [[Foobar2000:Title Formatting Reference|Title Format]] Reference

== Fields ==

ELPlaylist provides custom fields that can be used just like normal title formatting fields. Not all custom fields are available to all scripts. See below for details.

===%el_isplaying%===
Returns true if a track is currently playing.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second''

===%el_selected%===
Returns true for selected lines in the playlist.

Available in the following scripts: 
''Track list'', ''Per Second''

click action of the Select group whether the selected group

''Group header''

===%el_focused%===
Returns true for focused lines in the playlist.

Available in the following scripts: 
''Track list'', ''Per Second''

===%el_width%===
Returns the width of the line’s viewing area.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Popup''

===%el_height%===
Returns the height of the line’s viewing area. Note that ''%el_height%'' may return different values for track lines and group headers.

Track lines: ''%el_height%'' = ''%el_row_height%'' 
Group headers: ''%el_height%'' = ''%el_group_row%'' × ''%el_row_height%''

''$setworldtransform()'' is affected.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Popup''

===%el_row_height%===
Returns the base line’s height. Also see ''%el_height%''.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second''

===%el_group_row%===
Returns the number of rows in the group header. Also see ''%el_height%''.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second''

===%el_item_count%===
Returns the number of tracks in the group.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num'', ''Popup''

===%el_item_count2%===
Returns the number of empty tracks in the group.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second''

Number of tracks processed in Popup

''Popup''

===%el_direct_item_count%===
Returns the number of tracks within a group including all subgroups. Except in special cases, a group with a sub-group will be 0. If the group does not have a sub-group ''%el_direct_item_count''% should be the same as ''%el_item_count%''.

Available in the following scripts: 
''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.

Available in the following scripts: 
''Track list'', ''Per Second'', ''Popup''

===%el_item_index2%===
The index tracks the group (counting from 0) Count up the line is empty.

Available in the following scripts: 
''Track list'', ''Per Second''

===%el_total_group_count%===
Number of groups (number of headers for all groups)

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''

===%el_total_group_index%===
Index group (index group headers in the list)

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''

===%el_group_count%===
Number of groups that belong to the same parent group

Available in the following scripts: 
''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)

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''

===%el_group_depth%===
The depth of the current group (counting from 0)

Available in the following scripts: 
''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.

Available in the following scripts: 
''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.

Available in the following scripts: 
''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.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''

===%el_is_collapsed% (%el_is_hide_item%)===
Determines whether the group is collapsed. (Whether or not display the group header only)

Available in the following scripts: 
''Group header'', ''Group row''

===%el_is_empty%===
Empty or no go. (Just opposite ''%el_is_valid%'')

Available in the following scripts: 
''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.

Available in the following scripts: 
''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)

Available in the following scripts: 
''Track list'', ''Per Second''

===%el_sum_length%===
Total length of the track of the group ''[hh:]mm:ss''

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''

===%el_sum_length_seconds%===
Total length of the track of the group (s)

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''

===%el_backcolour%===
Returns the background color in ''r-g-b'' format. You can create an ''r-g-b-a'' value by simply adding the alpha value, e.g. ''%el_backcolour%-192''.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second''

===%el_preset_index%===
The current group by the preset index returns.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''

===%el_preset_name%===
Returns the current group by the preset name.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''

===%el_is_group%===
Popup whether the group header.

Available in the following scripts: 
''Popup''

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

Available in the following scripts: 
''Popup''

===%el_is_themed%===
Returns true if Visual Styles are enabled in ELPlaylist’s options.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''

== Functions (Draw control) ==

[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]) ===

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

''Note:'' This function is a string and there is also a GDI version of the same functions available [[#$drawtext(text,x,y,W,H,r-g-b,OPTIONS) | $drawtext]] and [[#$drawtextex(text,x,y,W,H,r-g-b,OPTIONS) | $drawtextex]]. This function might work for TrueType fonts, only.

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

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

'''OPTIONS2''' - specifying the glow effect (experimental stage):
* ''glow:expand:colour[:strength]'': glow options
** ''Expand'' - [0-5]
** ''Colour'' - r-g-b
** ''Strength'' - [0-3] glow_aa case of disabled

Offset:x:y
* ''X'' - glow in the horizontal offset
* ''Y'' - glow in the vertical offset

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

Examples:
* $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 function. Coordinates (x,y) size (w,h) Draws a rectangle.
* '''R1-G1-B1-A1''' internal color
* '''R2-G2-B2-A2''' border color

'''OPTIONS''':
* Aa - enable [http://en.wikipedia.org/wiki/Spatial_anti-aliasing anti aliasing]

Example:
* $drawrect(0,50,50,50,255-128-64-128,,aa)

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

Draws a rectangle with gradient fill at the coordinates '''(x,y)''' and size '''(w,h)'''
* '''r1-g1-b1-a1''' gradient start color
* '''r2-g2-b2-a2''' peak color gradient

'''OPTIONS''':
* ''vertical'': vertical gradient
* ''horizontal'': horizontal gradient
* ''aa'': enable [http://en.wikipedia.org/wiki/Spatial_anti-aliasing anti aliasing]
* ''nonlinear'': nonlinear gradient

'''PEAK''': 0-100
* Shifted the peak position of the gradient.
** 0 by default, to end at peak color.
** 50 When is the peak of color.

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

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

Draws a rectangle with a blured outline at the coordinates '''(x,y)''' and size '''(w,h)'''
* '''Level''' [1-7]: blur level

=== $drawfocusrect(x,y,w,h) ===

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

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

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

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

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

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

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

Draws a rectangle with rounded corners at coordinates (x,y) and size (w, h). The degree of roundness is defined by (w2,h2).
* In order to achieve a decent effect the condition w>4*w2 and h>4*h2 should be matched.
* '''R1-G1-B1-A1''' internal color
* '''R2-G2-B2-A2''' border color

Example:
* $drawroundrect(10,20,50,50,4,4,255-255-128-255,,)

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

Draws an ellipse at coordinates '''(x,y)''' with size '''(w,h)'''.
* '''R1-G1-B1-A1''' internal color
* '''R2-G2-B2-A2''' border Color

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

Draw a triangle and vertex function.
* '''(x1,y1),(x2,y2),(x3,y3)'''
* '''R1-G1-B1-A1''' internal color
* '''R2-G2-B2-A2''' Border Color

'''OPTIONS''':
* ''aa'': enable [http://en.wikipedia.org/wiki/Spatial_anti-aliasing anti aliasing]

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

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

Displays an image at Coordinates '''(x,y)''' with size '''(w,h)''' specified by '''path'''. After the image is resized, it is cached in the memory. The image is referenced, the memory is removed from them.


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

'''OPTIONS''':

<appearance>
* ''nokeepaspect'': not to maintain aspect ratio (nodisplay, archive, icon options and non-exclusive)
* ''nodisplay'': Hide image, read only in memory
* ''noexpansion'': image will not be expanded if smaller than the specified image size

<alignment>
* ''left right'': horizontal alignment
* ''top bottom'': vertical alignment

<misc>
* ''wc'': enables wildcard characters (*,?).

<read mode>
* ''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.
* ''artreader'': 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 not recommended optionss because these seem to be slow)

'''n''': rotateflip Index for:
* ''1'': 90°
* ''2'': 180°
* ''3'': 270°
* ''4'': flip horizontal
* ''5'': 90° + flip horizontal
* ''6'': Flipped vertically
* ''7'': 90° + Flip Vertically

'''Alpha''' (Opacity)
* ''0-255''

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

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

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

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

'''OPTIONS''' (imageabs):
* ''nokeepaspect'': not maintain the aspect ratio
* ''nodisplay'': Hide read only memory
* ''archive''
* ''Icon''
* ''Horizontal Alignment''
** left
** hcener
** right
* ''Vertical Alignment''
** top
** vcenter
** bottom

'''N''' rotateflip Index for:
* 1: 90°
* 2: 180°
* 3: 270°
* 4: flip horizontal
* 5: 90° + flip horizontal
* 6: Flipped vertically
* 7: 90° + Flip Vertically

'''Alpha''' (Opacity)
* 0-255

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

== Additional drawing functions ==

=== $getlastpos(elem) ===

Display function imageabs, imageabs_rc right after, to get the coordinates to draw a picture. Also, ''[[#$measurestring(text,x,y,W,H,OPTIONS) | $measurestring]]'' use them when you get the results. If you are drawString, mempos available only immediately after the specified coordinates.

Elem element to retrieve.
X: left
Y: top
W: width
H: height
R: right
B: bottom

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

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

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

=== $getimagewidth(path),$getimageheight(path) ===

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

=== $setcoordinate(mode) ===

$setcoordinate(0,X,Y,W,H)
$setcoordinate(1,X,Y,R,B)

Allows in a drawing function to transfer the argument ''x,y,w,h'' to ''x,y,right,bottom''.
''$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.

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

'''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%''

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

'''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%''

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[,···]) ===

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

''(Colour1 + colour2 +···) / N''

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

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

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

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

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

''Colour1 + colour2 + ··· + colourN''

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

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

''Colour1 - colour2 - colour3···- colourN''

=== $xorcolour(colour1,colour2[,···]) ===

Calculates XOR operatorion of a given color ''r-g-b'' sets. Returns only colour1 alpha channel.

''colour1 xor colour2 xor colour3···xor colourN''

== General-purpose system functions ==

The folowing functions are availble for the [Track list] [Group header] [Per Second] [Group row] [Min item num] [Popup] sections.

=== $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,...]) ===

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

=== $el_scale(val,factor[,DIV]) ===

Calculates a share of a given value: ''val * factor/100'' or ''val * factor / DIV''

Example: ''$el_scale(200,40)'' = 80

* ??val and the overflow factor is too large.

== GDI drawing functions ==

Using the Windows System Component [http://en.wikipedia.org/wiki/Graphics_Device_Interface GDI] to draw. GDI functions are usually faster, but they do not allow alpha blending and shadow effects (glow).

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

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

OPTIONS:
* Align ''left hcenter right specified horizontal''
* Align ''specified top vcenter bottom vertical''
* Not noclip clip

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

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

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

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

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

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

=== $gettextheight([FONTNAME,SIZE,OPTIONS]) ===

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

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

Filled rectangle function

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

Function of the fill rectangle with rounded corners

== Popup system functions ==
Valid for [Popup (Background)], [Popup (Track)].

=== $popupsize(w,h) ===

Pop-up function to reduce the size of the popup:
* W < max size (width)
* H < max size (height)

=== $popuphide() ===

Suppresses the 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]

File:Elplaylist-config-grouping3.png

2011-05-08T19:36:07Z

Brother John:

File:Elplaylist-config-grouping2.png

2011-05-08T19:35:55Z

Brother John:

File:Elplaylist-config-grouping1.png

2011-05-08T19:35:46Z

Brother John:

File:Elplaylist-config-style2.png

2011-05-08T19:35:31Z

Brother John:

File:Elplaylist-config-style1.png

2011-05-08T19:35:06Z

Brother John:

File:Elplaylist-config-script.png

2011-05-08T19:34:43Z

Brother John:

Hydrogenaudio Knowledgebase:Sandbox

2011-05-08T18:15:56Z

Brother John:

<div style="margin: 1em; padding: 1em; border:1px solid #999">
Article text{{ref|reference_name_A|a}} more text{{ref|reference_name_B|b}} more text {{ref|reference_name_C|c|noid=noid}}.
*Bulleted text{{ref|reference_name_B|b|noid=noid}}
*Bulleted text{{ref|reference_name_C|c}}.
*
*intervening text
*
*{{note|reference_name_A|a}}Text for note a.
*{{note|reference_name_B|b}}Text for note b.
*{{note|reference_name_C|c|Text for note c (with extended highlighting).}}
</div>

lkhjijhglkjh

<math>\sqrt{12}</math>

diff = 10 × log10(P2 / P1)

diff = 10 × log10(p22 / p12)

diff = 20 × log10(p2 / p1) because log10(a2) = 2 × log10(a)

<math>{diff} = 10 \cdot log_{10}\left(\frac{P_2}{P_1}\right )</math>

<math>{diff} = 10 \cdot log_{10}\left(\frac{p_2^2}{p_1^2}\right )</math>

<math>{diff} = 20 \cdot log_{10}\left(\frac{p_2}{p_1}\right )</math> because <math>log_{10}(a^2) = 2 \cdot log_{10}(a)</math>

<nowiki>some text that is not formated</nowiki>

<math>a^2</math>

<math>\sqrt{5}</math>

<math>\sum_{n=0}^\infty \frac{a^n}{n!}</math>

<math>\lim_{x\to\infty}f(x)=0</math>

<math>x = a_0 + \frac{1}{a_1 + \frac{1}{a_2 + \frac{1}{a_3 + a_4}}}</math>

Does things work after update someone wonders...
Hope the upgrade works!

<math>a^7</math>
<math>\sqrt{7}</math>
test
testing plugin

{| class="wikitable" style="text-align:center"
|+Multiplication table
|-
! × !! 1 !! 2 !! 3
|-
! 1
| 1 || 2 || 3
|-
! 2
| 2 || 4 || 6
|-
! 3
| 3 || 6 || 9
|-
! 4
| 4 || 8 || 12
|-
! 5
| 5 || 10 || 15
|}

{{Infobox Software|
|name = foobar2000
|screenshot = [[Image:Foobar2000v0.9.png|250px]]
|caption = Screenshot of foobar2000 v0.9 using the default user interface
|maintainer = Peter Pawlowski
|operating_system = [[Microsoft Windows|Windows]]
|use = [[Audio player (software)|Audio player]]
|license = [[Proprietary software|Proprietary]], [[BSD license|BSD]]
|website = [http://www.foobar2000.org/ www.foobar2000.org]
}}

this ist a test

<math>a^6</math>

<math>\sum_{n=15}^\infty \frac{a^n}{n!}</math>

[[Comparison of CD rippers]]

[[File:Example.jpg]]

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

2011-05-08T17:42:19Z

Brother John:

{{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+]

= ELPlaylist Reference (translated and adapted from Japanese Read me) =

ELPlaylist panel provides a single column playlist for [[Columns UI]]. Each track in the playlist occupies a line; within that line you can position elements freely. ELPlaylist also allows grouping items together (e.g. the tracks of an album) and nesting groups (e.g. for multi-disc albums).

In order to use ELPlaylist you need to setup your Columns UI layout accordingly and add an ELPlaylist panel in ''Columns UI configuration / Layout''. To change the playlist settings and scripts, right-click on any ELPlaylist panel and choose ''Settings'' from the context menu.

ELPlaylist can utilize foobar2000’s the built-in artwork reader. Depending on your configuration it can be accessed in the Columns UI Preference section (Artwork) or directly at the display preference page (Album Art).

In order to fully utilize ELPlaylist features and settings you should be familiar with [[Foobar2000:Title Formatting Reference|Title Formatting]] (TF). For further reading refer to the [[Foobar2000:Title Formatting Reference|Title Format reference]].

The readme file for this reference was translated from ''foo_uie_elplaylist.dll v0.6.4.2beta''. Current stable version is ''v0.6.9.0b (2010/07/30)''. Current beta version is ''v0.6.9.1.2b''.

The formatting fields and functions provided by ELPlaylist are very similar to the [[Foobar2000:Components 0.9/Panel Stack Splitter (foo uie panel splitter)|panel stack splitter]] component, because both are developed by the same author, '''ssenna'''.

Requirements: foobar2000 v0.9.5.1 +, Columns UI0.3 +, WindowsXP +
SDK version foobar2000 :2008-07-20 cui: 6.3

== Setting up Menus and Items ==

=== [Script Tab] ===

In order to change '''ELPlaylist''' settings, right-click on any playlist item and choose the ''Settings'' dialog.

The first tab ''Script'' is divided into 5 subsections:

# Track list
# Group header
# Per second
# Popup backround
# Popup track

Each section can be modified by using title format script and special ELPlaylist functions and fields. These section allow to customize editing every element of a playlist such as rows and group sections. Edits can be stored and organized in ''Titleformat Script Presets''.

==== [Track list] ====

To control the drawing of the track line Title Format.

==== [Group header] ====

To draw the header control group Title Format.

==== [Per Second] ====

To control the line drawn in the second track is updated play Title Format. This can be used to display now playing info.

==== [Popup (Background)] ====

Pop-up window to control the drawing of Title Format. 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.

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.
* Example: ''C:\image\%album%.jpg''

=== [Style Tab] ===

This Tab allows to control a number of visual settings of the playlist.
* ''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 can be 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'': Enables pseudo-transparent background. It tends to be a CPU demanding to process. (If the slowdown is severe, one solution is to narrow the viewing area.)

''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 Tab] ===

And customized for the group, you can customize the display of the list across multiple lines.
* ''Group by'': Grouping can be stored as a set of presets.
* ''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. Sorting is not done automatically.
* ''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. This can be used to ensures that images are displayed completely even if the number of rows would be too low otherwise. This section is ''Titleformat'' enabled and 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 are automatically inserted. ''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 Tab] ===

Title format preprocessor: Enables the definition of Titleformat fields that can be used in every subsection: ''[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.
Example: Album art path should be available to each section. This defined by:
'''foo''' : ''C:\%album%.jpg''
Now in each section the field ''%Foo%'' will be substituted by ''C:\%album%.jpg''. If the path changes in it needs to be changed in the ''Field definition'' section, only.

=== [Behaviour Tab] ===

This section allows to change the behavior of various playlist features:
* ''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 drop:'' Drag & Drop the selected tracks to go. If this option is turned off, press [Alt] while using Drag & Drop to move items.
* ''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 section [[shortcuts]]. IME in XP then I will support as possible to find it in Japanese. Alphabet in Vista (ASCII) may only search. (Originally I worked 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:'' To set up the each item of the right-click menu and to display the item or not.

=== [Misc Tab] ===

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

=== Keyboard Shortcuts ===

==== Commands ====

* 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 are matched against group format (''% el_group_format%'') by incremental search. (Incremental search has to be enabled though)

The following shortcuts are available.
* Ctrl-e: Reset the search (previous keystrokes)
* Ctrl-d: Find Next. (Ctrl-s if I could spare a···)
* Ctrl-r: Find

=== Main Menu Options (View->ELPlaylist) ===

All panels will be affected by selecting a menu item here.
* 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 ===

Please refer also to foobar's default [[Foobar2000:Title Formatting Reference|Title Format]] Reference

== Fields ==

ELPlaylist provides custom fields that can be used just like normal title formatting fields. Not all custom fields are available to all scripts. See below for details.

===%el_isplaying%===
Returns true if a track is currently playing.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second''

===%el_selected%===
Returns true for selected lines in the playlist.

Available in the following scripts: 
''Track list'', ''Per Second''

click action of the Select group whether the selected group

''Group header''

===%el_focused%===
Returns true for focused lines in the playlist.

Available in the following scripts: 
''Track list'', ''Per Second''

===%el_width%===
Returns the width of the line’s viewing area.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Popup''

===%el_height%===
Returns the height of the line’s viewing area. Note that ''%el_height%'' may return different values for track lines and group headers.

Track lines: ''%el_height%'' = ''%el_row_height%'' 
Group headers: ''%el_height%'' = ''%el_group_row%'' × ''%el_row_height%''

''$setworldtransform()'' is affected.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Popup''

===%el_row_height%===
Returns the base line’s height. Also see ''%el_height%''.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second''

===%el_group_row%===
Returns the number of rows in the group header. Also see ''%el_height%''.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second''

===%el_item_count%===
Returns the number of tracks in the group.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num'', ''Popup''

===%el_item_count2%===
Returns the number of empty tracks in the group.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second''

Number of tracks processed in Popup

''Popup''

===%el_direct_item_count%===
Returns the number of tracks within a group including all subgroups. Except in special cases, a group with a sub-group will be 0. If the group does not have a sub-group ''%el_direct_item_count''% should be the same as ''%el_item_count%''.

Available in the following scripts: 
''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.

Available in the following scripts: 
''Track list'', ''Per Second'', ''Popup''

===%el_item_index2%===
The index tracks the group (counting from 0) Count up the line is empty.

Available in the following scripts: 
''Track list'', ''Per Second''

===%el_total_group_count%===
Number of groups (number of headers for all groups)

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''

===%el_total_group_index%===
Index group (index group headers in the list)

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''

===%el_group_count%===
Number of groups that belong to the same parent group

Available in the following scripts: 
''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)

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''

===%el_group_depth%===
The depth of the current group (counting from 0)

Available in the following scripts: 
''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.

Available in the following scripts: 
''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.

Available in the following scripts: 
''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.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''

===%el_is_collapsed% (%el_is_hide_item%)===
Determines whether the group is collapsed. (Whether or not display the group header only)

Available in the following scripts: 
''Group header'', ''Group row''

===%el_is_empty%===
Empty or no go. (Just opposite ''%el_is_valid%'')

Available in the following scripts: 
''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.

Available in the following scripts: 
''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)

Available in the following scripts: 
''Track list'', ''Per Second''

===%el_sum_length%===
Total length of the track of the group ''[hh:]mm:ss''

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''

===%el_sum_length_seconds%===
Total length of the track of the group (s)

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''

===%el_backcolour%===
Returns the background color in ''r-g-b'' format. You can create an ''r-g-b-a'' value by simply adding the alpha value, e.g. ''%el_backcolour%-192''.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second''

===%el_preset_index%===
The current group by the preset index returns.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''

===%el_preset_name%===
Returns the current group by the preset name.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''

===%el_is_group%===
Popup whether the group header.

Available in the following scripts: 
''Popup''

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

Available in the following scripts: 
''Popup''

===%el_is_themed%===
Returns true if Visual Styles are enabled in ELPlaylist’s options.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''

== Functions (Draw control) ==

[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]) ===

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

''Note:'' This function is a string and there is also a GDI version of the same functions available [[#$drawtext(text,x,y,W,H,r-g-b,OPTIONS) | $drawtext]] and [[#$drawtextex(text,x,y,W,H,r-g-b,OPTIONS) | $drawtextex]]. This function might work for TrueType fonts, only.

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

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

'''OPTIONS2''' - specifying the glow effect (experimental stage):
* ''glow:expand:colour[:strength]'': glow options
** ''Expand'' - [0-5]
** ''Colour'' - r-g-b
** ''Strength'' - [0-3] glow_aa case of disabled

Offset:x:y
* ''X'' - glow in the horizontal offset
* ''Y'' - glow in the vertical offset

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

Examples:
* $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 function. Coordinates (x,y) size (w,h) Draws a rectangle.
* '''R1-G1-B1-A1''' internal color
* '''R2-G2-B2-A2''' border color

'''OPTIONS''':
* Aa - enable [http://en.wikipedia.org/wiki/Spatial_anti-aliasing anti aliasing]

Example:
* $drawrect(0,50,50,50,255-128-64-128,,aa)

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

Draws a rectangle with gradient fill at the coordinates '''(x,y)''' and size '''(w,h)'''
* '''r1-g1-b1-a1''' gradient start color
* '''r2-g2-b2-a2''' peak color gradient

'''OPTIONS''':
* ''vertical'': vertical gradient
* ''horizontal'': horizontal gradient
* ''aa'': enable [http://en.wikipedia.org/wiki/Spatial_anti-aliasing anti aliasing]
* ''nonlinear'': nonlinear gradient

'''PEAK''': 0-100
* Shifted the peak position of the gradient.
** 0 by default, to end at peak color.
** 50 When is the peak of color.

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

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

Draws a rectangle with a blured outline at the coordinates '''(x,y)''' and size '''(w,h)'''
* '''Level''' [1-7]: blur level

=== $drawfocusrect(x,y,w,h) ===

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

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

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

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

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

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

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

Draws a rectangle with rounded corners at coordinates (x,y) and size (w, h). The degree of roundness is defined by (w2,h2).
* In order to achieve a decent effect the condition w>4*w2 and h>4*h2 should be matched.
* '''R1-G1-B1-A1''' internal color
* '''R2-G2-B2-A2''' border color

Example:
* $drawroundrect(10,20,50,50,4,4,255-255-128-255,,)

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

Draws an ellipse at coordinates '''(x,y)''' with size '''(w,h)'''.
* '''R1-G1-B1-A1''' internal color
* '''R2-G2-B2-A2''' border Color

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

Draw a triangle and vertex function.
* '''(x1,y1),(x2,y2),(x3,y3)'''
* '''R1-G1-B1-A1''' internal color
* '''R2-G2-B2-A2''' Border Color

'''OPTIONS''':
* ''aa'': enable [http://en.wikipedia.org/wiki/Spatial_anti-aliasing anti aliasing]

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

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

Displays an image at Coordinates '''(x,y)''' with size '''(w,h)''' specified by '''path'''. After the image is resized, it is cached in the memory. The image is referenced, the memory is removed from them.


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

'''OPTIONS''':

<appearance>
* ''nokeepaspect'': not to maintain aspect ratio (nodisplay, archive, icon options and non-exclusive)
* ''nodisplay'': Hide image, read only in memory
* ''noexpansion'': image will not be expanded if smaller than the specified image size

<alignment>
* ''left right'': horizontal alignment
* ''top bottom'': vertical alignment

<misc>
* ''wc'': enables wildcard characters (*,?).

<read mode>
* ''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.
* ''artreader'': 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 not recommended optionss because these seem to be slow)

'''n''': rotateflip Index for:
* ''1'': 90°
* ''2'': 180°
* ''3'': 270°
* ''4'': flip horizontal
* ''5'': 90° + flip horizontal
* ''6'': Flipped vertically
* ''7'': 90° + Flip Vertically

'''Alpha''' (Opacity)
* ''0-255''

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

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

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

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

'''OPTIONS''' (imageabs):
* ''nokeepaspect'': not maintain the aspect ratio
* ''nodisplay'': Hide read only memory
* ''archive''
* ''Icon''
* ''Horizontal Alignment''
** left
** hcener
** right
* ''Vertical Alignment''
** top
** vcenter
** bottom

'''N''' rotateflip Index for:
* 1: 90°
* 2: 180°
* 3: 270°
* 4: flip horizontal
* 5: 90° + flip horizontal
* 6: Flipped vertically
* 7: 90° + Flip Vertically

'''Alpha''' (Opacity)
* 0-255

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

== Additional drawing functions ==

=== $getlastpos(elem) ===

Display function imageabs, imageabs_rc right after, to get the coordinates to draw a picture. Also, ''[[#$measurestring(text,x,y,W,H,OPTIONS) | $measurestring]]'' use them when you get the results. If you are drawString, mempos available only immediately after the specified coordinates.

Elem element to retrieve.
X: left
Y: top
W: width
H: height
R: right
B: bottom

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

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

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

=== $getimagewidth(path),$getimageheight(path) ===

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

=== $setcoordinate(mode) ===

$setcoordinate(0,X,Y,W,H)
$setcoordinate(1,X,Y,R,B)

Allows in a drawing function to transfer the argument ''x,y,w,h'' to ''x,y,right,bottom''.
''$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.

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

'''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%''

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

'''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%''

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[,···]) ===

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

''(Colour1 + colour2 +···) / N''

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

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

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

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

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

''Colour1 + colour2 + ··· + colourN''

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

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

''Colour1 - colour2 - colour3···- colourN''

=== $xorcolour(colour1,colour2[,···]) ===

Calculates XOR operatorion of a given color ''r-g-b'' sets. Returns only colour1 alpha channel.

''colour1 xor colour2 xor colour3···xor colourN''

== General-purpose system functions ==

The folowing functions are availble for the [Track list] [Group header] [Per Second] [Group row] [Min item num] [Popup] sections.

=== $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,...]) ===

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

=== $el_scale(val,factor[,DIV]) ===

Calculates a share of a given value: ''val * factor/100'' or ''val * factor / DIV''

Example: ''$el_scale(200,40)'' = 80

* ??val and the overflow factor is too large.

== GDI drawing functions ==

Using the Windows System Component [http://en.wikipedia.org/wiki/Graphics_Device_Interface GDI] to draw. GDI functions are usually faster, but they do not allow alpha blending and shadow effects (glow).

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

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

OPTIONS:
* Align ''left hcenter right specified horizontal''
* Align ''specified top vcenter bottom vertical''
* Not noclip clip

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

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

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

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

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

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

=== $gettextheight([FONTNAME,SIZE,OPTIONS]) ===

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

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

Filled rectangle function

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

Function of the fill rectangle with rounded corners

== Popup system functions ==
Valid for [Popup (Background)], [Popup (Track)].

=== $popupsize(w,h) ===

Pop-up function to reduce the size of the popup:
* W < max size (width)
* H < max size (height)

=== $popuphide() ===

Suppresses the 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/ELplaylist panel (foo uie elplaylist)

2011-05-05T21:43:50Z

Brother John: /* Fields */

{{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+]

= ELPlaylist Reference (translated and adapted from Japanese Read me) =

ELPlaylist panel provides a single columns playlist like Columns UI for a Playlist view. It consists of a section for each track of the playlist and grouping section for all elements of a given set. Panel Splitter shares many similarities to the panel stack splitter component [[Foobar2000:Components 0.9/Panel Stack Splitter (foo uie panel splitter) | panel splitter]], because it is being developed by the same author '''ssenna'''. Therefore functions and fields are very similar.

In order to access an ELPlaylist you have to setup a playlist item in Columns UI. In order to change the playlist settings, right-click on any playlist item and choose the Settings dialog.

ELPlaylist can utilize the build-in foobar2000 artwork reader. Depending on your configuration it can be accessed in the Columns UI Preference section (Artwork) or directly at the display preference page (Album Art).

In order to fully utilize ELPlaylist features and settings [[Foobar2000:Title Formatting Reference|Title Format]] (TF) knowledge is required. For further reading refer to the [[Foobar2000:Title Formatting Reference|Title Format]] reference.

The readme file for this reference was translated from ''foo_uie_elplaylist.dll v0.6.4.2beta''. Current stable version is ''v0.6.9.0b (2010/07/30)''. Current beta version is ''v0.6.9.1.1b (2010/10/30)''.

Requirements: foobar2000 v0.9.5.1 +, Columns UI0.3 +, WindowsXP +
SDK version foobar2000 :2008-07-20 cui: 6.3

== Setting up Menus and Items ==

=== [Script Tab] ===

In order to change '''ELPlaylist''' settings, right-click on any playlist item and choose the ''Settings'' dialog.

The first tab ''Script'' is divided into 5 subsections:

# Track list
# Group header
# Per second
# Popup backround
# Popup track

Each section can be modified by using title format script and special ELPlaylist functions and fields. These section allow to customize editing every element of a playlist such as rows and group sections. Edits can be stored and organized in ''Titleformat Script Presets''.

==== [Track list] ====

To control the drawing of the track line Title Format.

==== [Group header] ====

To draw the header control group Title Format.

==== [Per Second] ====

To control the line drawn in the second track is updated play Title Format. This can be used to display now playing info.

==== [Popup (Background)] ====

Pop-up window to control the drawing of Title Format. 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.

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.
* Example: ''C:\image\%album%.jpg''

=== [Style Tab] ===

This Tab allows to control a number of visual settings of the playlist.
* ''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 can be 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'': Enables pseudo-transparent background. It tends to be a CPU demanding to process. (If the slowdown is severe, one solution is to narrow the viewing area.)

''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 Tab] ===

And customized for the group, you can customize the display of the list across multiple lines.
* ''Group by'': Grouping can be stored as a set of presets.
* ''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. Sorting is not done automatically.
* ''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. This can be used to ensures that images are displayed completely even if the number of rows would be too low otherwise. This section is ''Titleformat'' enabled and 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 are automatically inserted. ''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 Tab] ===

Title format preprocessor: Enables the definition of Titleformat fields that can be used in every subsection: ''[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.
Example: Album art path should be available to each section. This defined by:
'''foo''' : ''C:\%album%.jpg''
Now in each section the field ''%Foo%'' will be substituted by ''C:\%album%.jpg''. If the path changes in it needs to be changed in the ''Field definition'' section, only.

=== [Behaviour Tab] ===

This section allows to change the behavior of various playlist features:
* ''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 drop:'' Drag & Drop the selected tracks to go. If this option is turned off, press [Alt] while using Drag & Drop to move items.
* ''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 section [[shortcuts]]. IME in XP then I will support as possible to find it in Japanese. Alphabet in Vista (ASCII) may only search. (Originally I worked 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:'' To set up the each item of the right-click menu and to display the item or not.

=== [Misc Tab] ===

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

=== Keyboard Shortcuts ===

==== Commands ====

* 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 are matched against group format (''% el_group_format%'') by incremental search. (Incremental search has to be enabled though)

The following shortcuts are available.
* Ctrl-e: Reset the search (previous keystrokes)
* Ctrl-d: Find Next. (Ctrl-s if I could spare a···)
* Ctrl-r: Find

=== Main Menu Options (View->ELPlaylist) ===

All panels will be affected by selecting a menu item here.
* 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 ===

Please refer also to foobar's default [[Foobar2000:Title Formatting Reference|Title Format]] Reference

== Fields ==

===<tt>%el_width%</tt>===
Returns the width of the line’s viewing area.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Popup''

===<tt>%el_height%</tt>===
Returns the height of the line’s viewing area. Note that <tt>%el_height%</tt> may return different values for track lines and group headers.

Track lines: <tt>%el_height%</tt> = <tt>%el_row_height%</tt> 
Group headers: <tt>%el_height%</tt> = <tt>%el_group_row%</tt> × <tt>%el_row_height%</tt>

<tt>$setworldtransform()</tt> is affected.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second'', ''Popup''

===<tt>%el_isplaying%</tt>===
Returns true if a track is currently playing.

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second''

===<tt>%el_selected%</tt>===
On whether the selected playlist

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

===<tt>%el_focused%</tt>===
Focus on whether or not in the playlist

[Track list] [Per Second]

===<tt>%el_row_height%</tt>===
Returns the base line’s height. also see <tt>%el_height%</tt>

Available in the following scripts: 
''Track list'', ''Group header'', ''Per Second''

===<tt>%el_group_row%</tt>===
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]

===<tt>%el_item_count%</tt>===
Number of tracks in the group

[Track list] [Group header] [Per Second] [Group row] [Min item num] [Popup]

===<tt>%el_item_count2%</tt>===
Number of empty trucks in the group that contains the line

[Track list] [Group header] [Per Second] Number of tracks processed in Popup [Popup]

===<tt>%el_direct_item_count%</tt>===
Returns the number of tracks within a group including all subgroups. Except in special cases, a group with a sub-group will be 0. If the group does not have a sub-group ''%el_direct_item_count''% should be the same as ''%el_item_count%''.

[Track list] [Group header] [Per Second] [Group row] [Min item num]

===<tt>%el_item_index%</tt>===
The index tracks the group (counting from 0) The line does not count up empty.

[Track list] [Per Second] [Popup]

===<tt>%el_item_index2%</tt>===
The index tracks the group (counting from 0) Count up the line is empty.

[Track list] [Per Second]

===<tt>%el_total_group_count%</tt>===
Number of groups (number of headers for all groups)

[Track list] [Group header] [Per Second] [Group row] [Min item num]

===<tt>%el_total_group_index%</tt>===
Index group (index group headers in the list)

[Track list] [Group header] [Per Second] [Group row] [Min item num]

===<tt>%el_group_count%</tt>===
Number of groups that belong to the same parent group

[Track list] [Group header] [Per Second] [Group row] [Min item num]

===<tt>%el_group_index%</tt>===
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]

===<tt>%el_group_depth%</tt>===
The depth of the current group (counting from 0)

[Track list] [Group header] [Per Second] [Group row] [Min item num] [Popup]

===<tt>%el_subgroup_count%</tt>===
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]

===<tt>%el_subgroup_count2%</tt>===
Cumulative number of subgroups Be counted against the group after the grandchildren.

[Track list] [Group header] [Per Second] [Group row] [Min item num]

===<tt>%el_group_format%</tt>===
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]

===<tt>%el_is_collapsed% (%el_is_hide_item%)===
Determines whether the group is collapsed. (Whether or not display the group header only)

[Group header] [Group row]

===<tt>%el_is_empty%</tt>===
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]

===<tt>%el_is_valid%</tt>===
Valid (empty lines are not), or no go.

[Track list] [Per Second] [Group header] [Group row] [Min item num]

===<tt>%el_is_noheader%</tt>===
Do not you have a group header (''%El_group_row%'' to 0 if 1)

[Track list] [Per Second]

===<tt>%el_sum_length%</tt>===
Total length of the track of the group ''[hh:]mm:ss''

[Track list] [Group header] [Per Second] [Group row] [Min item num]

===<tt>%el_sum_length_seconds%</tt>===
Total length of the track of the group (s)

[Track list] [Group header] [Per Second] [Group row] [Min item num]

===<tt>%el_backcolour%</tt>===
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]

===<tt>%el_preset_index%</tt>===
The current group by the preset index returns.

[Track list] [Group header] [Per Second] [Group row] [Min item num]

===<tt>%el_preset_name%</tt>===
Returns the current group by the preset name.

[Track list] [Group header] [Per Second] [Group row] [Min item num]

===<tt>%el_is_group%</tt>===
Popup whether the group header. [Popup]

===<tt>%el_popup_width%, %el_popup_height%</tt>===
Size pop-up at that time. ''%el_width%'', ''%el_height%'' note that the max size is returned.

[Popup]

===<tt>%el_is_themed%</tt>===
Whether or not enable Visual Style valid

[Track list] [Group header] [Per Second] [Group row] [Min item num]

== Functions (Draw control) ==

[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]) ===

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

''Note:'' This function is a string and there is also a GDI version of the same functions available [[#$drawtext(text,x,y,W,H,r-g-b,OPTIONS) | $drawtext]] and [[#$drawtextex(text,x,y,W,H,r-g-b,OPTIONS) | $drawtextex]]. This function might work for TrueType fonts, only.

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

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

'''OPTIONS2''' - specifying the glow effect (experimental stage):
* ''glow:expand:colour[:strength]'': glow options
** ''Expand'' - [0-5]
** ''Colour'' - r-g-b
** ''Strength'' - [0-3] glow_aa case of disabled

Offset:x:y
* ''X'' - glow in the horizontal offset
* ''Y'' - glow in the vertical offset

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

Examples:
* $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 function. Coordinates (x,y) size (w,h) Draws a rectangle.
* '''R1-G1-B1-A1''' internal color
* '''R2-G2-B2-A2''' border color

'''OPTIONS''':
* Aa - enable [http://en.wikipedia.org/wiki/Spatial_anti-aliasing anti aliasing]

Example:
* $drawrect(0,50,50,50,255-128-64-128,,aa)

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

Draws a rectangle with gradient fill at the coordinates '''(x,y)''' and size '''(w,h)'''
* '''r1-g1-b1-a1''' gradient start color
* '''r2-g2-b2-a2''' peak color gradient

'''OPTIONS''':
* ''vertical'': vertical gradient
* ''horizontal'': horizontal gradient
* ''aa'': enable [http://en.wikipedia.org/wiki/Spatial_anti-aliasing anti aliasing]
* ''nonlinear'': nonlinear gradient

'''PEAK''': 0-100
* Shifted the peak position of the gradient.
** 0 by default, to end at peak color.
** 50 When is the peak of color.

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

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

Draws a rectangle with a blured outline at the coordinates '''(x,y)''' and size '''(w,h)'''
* '''Level''' [1-7]: blur level

=== $drawfocusrect(x,y,w,h) ===

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

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

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

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

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

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

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

Draws a rectangle with rounded corners at coordinates (x,y) and size (w, h). The degree of roundness is defined by (w2,h2).
* In order to achieve a decent effect the condition w>4*w2 and h>4*h2 should be matched.
* '''R1-G1-B1-A1''' internal color
* '''R2-G2-B2-A2''' border color

Example:
* $drawroundrect(10,20,50,50,4,4,255-255-128-255,,)

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

Draws an ellipse at coordinates '''(x,y)''' with size '''(w,h)'''.
* '''R1-G1-B1-A1''' internal color
* '''R2-G2-B2-A2''' border Color

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

Draw a triangle and vertex function.
* '''(x1,y1),(x2,y2),(x3,y3)'''
* '''R1-G1-B1-A1''' internal color
* '''R2-G2-B2-A2''' Border Color

'''OPTIONS''':
* ''aa'': enable [http://en.wikipedia.org/wiki/Spatial_anti-aliasing anti aliasing]

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

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

Displays an image at Coordinates '''(x,y)''' with size '''(w,h)''' specified by '''path'''. After the image is resized, it is cached in the memory. The image is referenced, the memory is removed from them.


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

'''OPTIONS''':

<appearance>
* ''nokeepaspect'': not to maintain aspect ratio (nodisplay, archive, icon options and non-exclusive)
* ''nodisplay'': Hide image, read only in memory
* ''noexpansion'': image will not be expanded if smaller than the specified image size

<alignment>
* ''left right'': horizontal alignment
* ''top bottom'': vertical alignment

<misc>
* ''wc'': enables wildcard characters (*,?).

<read mode>
* ''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.
* ''artreader'': 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 not recommended optionss because these seem to be slow)

'''n''': rotateflip Index for:
* ''1'': 90°
* ''2'': 180°
* ''3'': 270°
* ''4'': flip horizontal
* ''5'': 90° + flip horizontal
* ''6'': Flipped vertically
* ''7'': 90° + Flip Vertically

'''Alpha''' (Opacity)
* ''0-255''

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

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

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

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

'''OPTIONS''' (imageabs):
* ''nokeepaspect'': not maintain the aspect ratio
* ''nodisplay'': Hide read only memory
* ''archive''
* ''Icon''
* ''Horizontal Alignment''
** left
** hcener
** right
* ''Vertical Alignment''
** top
** vcenter
** bottom

'''N''' rotateflip Index for:
* 1: 90°
* 2: 180°
* 3: 270°
* 4: flip horizontal
* 5: 90° + flip horizontal
* 6: Flipped vertically
* 7: 90° + Flip Vertically

'''Alpha''' (Opacity)
* 0-255

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

== Additional drawing functions ==

=== $getlastpos(elem) ===

Display function imageabs, imageabs_rc right after, to get the coordinates to draw a picture. Also, ''[[#$measurestring(text,x,y,W,H,OPTIONS) | $measurestring]]'' use them when you get the results. If you are drawString, mempos available only immediately after the specified coordinates.

Elem element to retrieve.
X: left
Y: top
W: width
H: height
R: right
B: bottom

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

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

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

=== $getimagewidth(path),$getimageheight(path) ===

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

=== $setcoordinate(mode) ===

$setcoordinate(0,X,Y,W,H)
$setcoordinate(1,X,Y,R,B)

Allows in a drawing function to transfer the argument ''x,y,w,h'' to ''x,y,right,bottom''.
''$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.

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

'''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%''

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

'''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%''

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[,···]) ===

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

''(Colour1 + colour2 +···) / N''

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

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

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

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

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

''Colour1 + colour2 + ··· + colourN''

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

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

''Colour1 - colour2 - colour3···- colourN''

=== $xorcolour(colour1,colour2[,···]) ===

Calculates XOR operatorion of a given color ''r-g-b'' sets. Returns only colour1 alpha channel.

''colour1 xor colour2 xor colour3···xor colourN''

== General-purpose system functions ==

The folowing functions are availble for the [Track list] [Group header] [Per Second] [Group row] [Min item num] [Popup] sections.

=== $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,...]) ===

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

=== $el_scale(val,factor[,DIV]) ===

Calculates a share of a given value: ''val * factor/100'' or ''val * factor / DIV''

Example: ''$el_scale(200,40)'' = 80

* ??val and the overflow factor is too large.

== GDI drawing functions ==

Using the Windows System Component [http://en.wikipedia.org/wiki/Graphics_Device_Interface GDI] to draw. GDI functions are usually faster, but they do not allow alpha blending and shadow effects (glow).

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

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

OPTIONS:
* Align ''left hcenter right specified horizontal''
* Align ''specified top vcenter bottom vertical''
* Not noclip clip

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

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

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

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

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

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

=== $gettextheight([FONTNAME,SIZE,OPTIONS]) ===

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

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

Filled rectangle function

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

Function of the fill rectangle with rounded corners

== Popup system functions ==
Valid for [Popup (Background)], [Popup (Track)].

=== $popupsize(w,h) ===

Pop-up function to reduce the size of the popup:
* W < max size (width)
* H < max size (height)

=== $popuphide() ===

Suppresses the 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]