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

From Hydrogenaudio Knowledgebase
m (edit developer)
 
(37 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{fb2k}}
[[Category:Foobar2000 Legacy Columns UI components|Legacy Columns UI components]]
{{stub}}
{{Foobar Component Infobox
| name                = ELPlaylist
| module_name          = foo_uie_elplaylist
| developer            = {{ha user|u=50309|name=ssenna}}
| repository          =
| released            =
| released_ref        =
| stable_release      = 0.6.9.0b
| stable_release_date  = 2010-07-30
| preview_release      = 0.6.9.1.2b
| preview_release_date = 2010-10-30
| foobar2000_minimum  = 1.0
| foobar2000_ui_module = Columns UI
| use                  = UI
| license              =
}}
'''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).


foobar2000 v0.9.5.1+, Columns UI 0.3+
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.


= Requirements =
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).
* [http://www.foobar2000.org/ foobar2000 v0.9.5.1+]
* [http://yuo.be/columns.php Columns UI 0.3+]
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''.


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


= Read me (translated from the Japanese original) =
Requirements: foobar2000 v0.9.5.1 +, Columns UI0.3 +, WindowsXP +
SDK version foobar2000 :2008-07-20 cui: 6.3


foo_uie_elplaylist.dll v0.6.4.2beta
== Setting up Menus and Items ==
for foobar2000 v0.9.5.1 +, Columns UI0.3 +, WindowsXP +
(tested WindowsXP, only)


SDK version
In order to change ELPlaylist settings, right-click on any playlist item and choose ''Settings''. The configuration dialog is divided into six main tabs.
foobar2000 :2008-07-20
        cui: 6.3


ELplaylist panel provides a single columns playlist like Columns UI for the Playlist view.
=== Script Tab ===
It consists of a section for each track of the playlist and grouping section for all elements of a given set.


In order to change its settings, right-click on any playlist item and choose the Settings ... dialog.
The '''Script''' tab contains the actual scripts that define the appearance of every playlist element, i.e. track rows, group headers and popups.
(At least General -> Title format Processor -> __ART_PATH__ you have bad balance and do not set the path to the images in the album.)
To edit the settings, [[Titleformat]] (TF) knowledge is required. About [[Titleformat]] Please refer to the descriptions of other sites separately.  


== Setting Items ==
[[Image:elplaylist-config-script.png]]


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


In entering the default description is the assumption that there is a picture album.  
* '''Track list''' contains the TF script for individual track entries, i.e. rows, in the playlist.
General-> title format preprocessor-> ART.PATH please set the path to the appropriate image.  
* '''Group header''' contains the TF script for the group headers.
For example C: \ image \% album%. Jpg and.  
* '''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.<br />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.


[style]
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.  
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.  
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''


Odd and even are calculated by the list index:
=== Style Tab ===
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.  
This tab controls a number of global visual settings for the playlist.


Default font ...:  
[[Image:elplaylist-config-style1.png]]
Please specify the default font.  


Pseudo transparent:
''Custom Background Colour'' defines background colours for different types of playlist entries.
And a pseudo-transparent background. I tend to be heavier to process.
(If severe, may be better to narrow the viewing area.
No I do not use it to optimize the authors···)


Enable Visual Style:
* ''Total'' is the background colour of the complete playlist.
The background of the line and automatically draws VisualStyle. Primarily for Windows Vista.  
* ''Odd item'' is the the background colour of odd rows.
After drawing a custom background colour, title format script will be drawn prior to evaluation.  
* ''Even item'' is the the background colour of even rows.
Text color does not change automatically.  
* ''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.


Scrollbar:  
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.
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]
Change to display the character, script editing only.
And customized for the group, you can customize the display of the list across multiple lines.  
* Default font: ''Please specify the default font.''


group by: a set of preset can be saved as.
[[Image:elplaylist-config-style2.png]]
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%
''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.)
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:  
''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.
Sort in the playlist for Titleformat described.  
execution of the sort is done from the context menu.  
Note: It does not automatically execute the sort.  


  Row height:  
''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).  
In a list and set the height of the base line.  


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


Row number of group header:  
[[Image:elplaylist-config-grouping1.png]]
"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:  
* ''Group by'': Grouping can be stored as a set of presets.
You can set the minimum number of lines in each group.
* ''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.
For example, you can use to ensure the scope and application of images to reduce the number of albums and tracks.  
  Example: ''%album artist%|%album%''
  Titleformat is enabled. TF as a result of the process must return a value of 0.  
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.
  After grouping, this value is less than the number of tracks in the group, empty rows and then inflated.  
* ''Sort format:'' Sort in the playlist for Titleformat described. Execution of the sort is done from the context menu. Sorting is not done automatically.  


Note: the group with a track, min item num will be evaluated.
[[Image:elplaylist-config-grouping2.png]]
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:  
* ''Row height'': In a list and set the height of the base line.
enable playlist filter is on, the name of the playlist from the playlist when?RI?WATTA the group by preset can be selected automatically.  
* ''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.)
enable all playlists in the playlist of all the active preset.  
* ''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.  
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.  
[[Image:elplaylist-config-grouping3.png]]


Associated titleformat script name:  
* ''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.
  This preset tileformat scrpit???KETAI and the name of a single set.  
* ''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.


  Enable playlist filter:
=== [Behaviour Tab] ===
playlist from the playlist filter name to enable you to group by preset automatically selected.


  Prioritize active preset:  
This section allows to change the behavior of various playlist features:
  Find a preset valid time has now selected the first group by preset priority.  
* ''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.  


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


  [Behaviour]
==== Popup ====
Click action:
   
  You can change your behavior when you click on the playlist.  
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.  


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


Enable hover:  
==== Commands ====
Mouse hover action for on / off can be.
 
 
* Ctrl-c: Copy
Delay:  
* Ctrl-v: Paste
Will stop the mouse from the mouse hover action to implement a delay.
* Ctrl-x: Cut
 
* Ctrl-a: select all
Display only the focused group:  
* Ctrl-f: Find dialog (% el_group_format% of your search)
Show only a focus group. Other panel playlists (Graphical Browser or) is predicated on collaboration.
* Ctrl-g: Go to the following groups:
 
* Ctrl-b: Go to the previous group
Collapse all groups when playlist is changed:  
* Delete: remove a track from the playlist
Close the group by default.
* Alt-[Up] / [Down]: Move the selected track ( "hide all items when playlist is changed" is that it is off)
Threshold of number of groups:  
   
Close the Group when more than this number the number of groups.
'''Note:''' foobar2000 body of General-> Keyboard Shortcuts settings will take precedence.  
Auto-collapse:  
Close the Group other than focus groups.
This option is on a group header in a single click to see the track line / switch that you hide.
Click the Action Group in the open does not close automatically.
If you want to follow the track playback, Playback / Cursor Follows Playback Please use a combination.
 
Allow collapsing group with no group header:
No group header (group row 0) in the group to close it.
 
  disable focus change by single click at group header
Group headers and empty line in a single click when you stop to move the focus.
 
Update every second:  
The tracks play Enabling Per Second. More precisely, the second update of the drawing of the unit on / off only.  


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


Enable incremental search:
==== Incremental search ====
According to key inputs, group format (% el_group_format%) and incremental search.
Keyword search is logged in the status bar.
Also, you did not enter a second valid key, your search terms are automatically reset.
See also SHOTOKATTOKIBAINDO.
IME in XP then I will support as possible to find it in Japanese.
Alphabet in Vista (ASCII) may only search. (Originally I???work with Vista.)
If you want to search for Vista in non-ASCII, Ctrl-f search DAIAROGUBESU it is possible, please use there.
   
   
Resize quality:
Keystrokes are matched against group format (''% el_group_format%'') by incremental search. (Incremental search has to be enabled though)
Enlarge Image / You can set the quality down.  
If you just want a quality, HighQualityBicubic would be good if you have.


Context menu:  
The following shortcuts are available.
KONTEKISUTOMEYU each (right-click menu) to display the item, you can set up or not.
* 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) ===


[misc]
All panels will be affected by selecting a menu item here.  
Popup
* Show now playing: Scroll to the track so that you are playing.
Pop-up mouse hover action is executed.  
* Show focused item: Scroll to see the focus track.
Max size:  
* Expand all groups: Expand all groups.
The maximum size of the popup. Titleformat small can.  
* Collapse all groups: Close all of the groups.
 
* Refresh: redraw causes the explicit.
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
=== Extended Command Reference ===
To avoid as much as possible out of the pop-up display. Multi-Display is not supported.
   
   
Max track num:  
Please refer also to foobar's default [[Foobar2000:Title Formatting Reference|Title Format]] Reference
Popup (Track) limit the number of trucks running.
Popup the Titleformat script,
Popup (Background) -> Popup (Track) -> Popup (Track) ->···
Runs.


Additional sort format
== Fields ==
Sort of context menu to add the item to set the sort format.
Group by preset and is independent.
 
 
== Keyboard Shortcuts ==
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.  
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.


¦ incremental search
===%el_isplaying%===
Keystrokes group format (% el_group_format%) or incremental search. (enable incremental search is on only)
Returns true if a track is currently playing.
The following shortcuts are available.
Ctrl-e: to reset the search keywords.
Ctrl-d: Find Next. (Ctrl-s if I could spare a···)
Ctrl-r: find.  


== Main Menu Options (View->ELPlaylist) ==
Available in the following scripts:<br />
''Track list'', ''Group header'', ''Per Second''


All panels will be affected by selecting a menu item here.  
===%el_selected%===
Returns true for selected lines in the playlist.


Show now playing: Scroll to the track so that you are playing.
Available in the following scripts:<br />
Show focused item: Scroll to see the focus track.
''Track list'', ''Per Second''
Expand all groups: Expand all groups.
Collapse all groups: Close all of the groups.
Refresh: redraw causes the explicit.


== Extended Command Reference ==
click action of the Select group whether the selected group
Please refer also to foobar's default titleformat Reference


== Fields ==
''Group header''


=== %el_width% ===
===%el_focused%===
Returns the width of the viewing area of the line
Returns true for focused lines in the playlist.


[Track list] [Group header] [Per Second] [Popup]
Available in the following scripts:<br />
''Track list'', ''Per Second''


=== %el_height% ===
===%el_width%===
Returns the height of the viewing area of the line. (Line group ''%el_height%'' = ''%el_group_row%'' * ''%el_row_height%'' Track line ''%el_height%'' = ''%el_row_height%'') $setworldtransform () is affected.)
Returns the width of the line’s viewing area.


[Track list] [Group header] [Per Second] [Popup]
Available in the following scripts:<br />
''Track list'', ''Group header'', ''Per Second'', ''Popup''


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


[Track list] [Group header] [Per Second]
Track lines: ''%el_height%'' = ''%el_row_height%''<br />
Group headers: ''%el_height%'' = ''%el_group_row%'' &times; ''%el_row_height%''


=== %el_selected% ===
''$setworldtransform()'' is affected.
On whether the selected playlist


[Track list] [Per Second]
Available in the following scripts:<br />
click action of the Select group whether the selected group
''Track list'', ''Group header'', ''Per Second'', ''Popup''
[Group header]


=== %el_focused% ===
===%el_row_height%===
Focus on whether or not in the playlist
Returns the base line’s height. Also see ''%el_height%''.


[Track list] [Per Second]
Available in the following scripts:<br />
''Track list'', ''Group header'', ''Per Second''


=== %el_row_height% ===
===%el_group_row%===
Returns the height of the basic line. (''%El_height%'' header line is a different group.)
Returns the number of rows in the group header. Also see ''%el_height%''.


[Track list] [Group header] [Per Second]
Available in the following scripts:<br />
''Track list'', ''Group header'', ''Per Second''


=== %el_group_row% ===
===%el_item_count%===
The group header row height %el_row_height% or one minute. The group header ''%el_height%'' = ''%el_group_row%'' * ''% el_row_height%'' of
Returns the number of tracks in the group.


[Track list] [Group header] [Per Second]
Available in the following scripts:<br />
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num'', ''Popup''


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


[Track list] [Group header] [Per Second] [Group row] [Min item num] [Popup]
Available in the following scripts:<br />
''Track list'', ''Group header'', ''Per Second''


=== %el_item_count2% ===
Number of tracks processed in Popup
Number of empty trucks in the group that contains the line


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


=== %el_direct_item_count% ===
===%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%''.  
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]
Available in the following scripts:<br />
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''


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


[Track list] [Per Second] [Popup]
Available in the following scripts:<br />
''Track list'', ''Per Second'', ''Popup''


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


[Track list] [Per Second]
Available in the following scripts:<br />
''Track list'', ''Per Second''


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


[Track list] [Group header] [Per Second] [Group row] [Min item num]
Available in the following scripts:<br />
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''


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


[Track list] [Group header] [Per Second] [Group row] [Min item num]
Available in the following scripts:<br />
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''


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


[Track list] [Group header] [Per Second] [Group row] [Min item num]
Available in the following scripts:<br />
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''


=== %el_group_index% ===
===%el_group_index%===
The index of the group as seen from a parent group (counting from 0)
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]
Available in the following scripts:<br />
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''


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


[Track list] [Group header] [Per Second] [Group row] [Min item num] [Popup]
Available in the following scripts:<br />
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num'', ''Popup''


=== %el_subgroup_count% ===
===%el_subgroup_count%===
The number of subgroups Number of groups of children, grandchildren and the number of groups are not counted.
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]
Available in the following scripts:<br />
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''


=== %el_subgroup_count2% ===
===%el_subgroup_count2%===
Cumulative number of subgroups Be counted against the group after the grandchildren.
Cumulative number of subgroups Be counted against the group after the grandchildren.


[Track list] [Group header] [Per Second] [Group row] [Min item num]
Available in the following scripts:<br />
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''


=== %el_group_format% ===
===%el_group_format%===
The current group of the TF group format in the process and return the result.
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]
Available in the following scripts:<br />
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''


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


[Group header] [Group row]
Available in the following scripts:<br />
''Group header'', ''Group row''


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


[Track list] [Per Second]
Available in the following scripts:<br />
''Track list'', ''Per Second''
 
Well if you can not configure the sub-group structure, or whether groups can go into a dummy.  
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]
''Group header'', ''Group row'', ''Min item num''


=== %el_is_valid% ===
===%el_is_valid%===
Valid (empty lines are not), or no go.  
Valid (empty lines are not), or no go.  


[Track list] [Per Second] [Group header] [Group row] [Min item num]
Available in the following scripts:<br />
''Track list'', ''Per Second'', ''Group header'', ''Group row'', ''Min item num''


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


[Track list] [Per Second]
Available in the following scripts:<br />
''Track list'', ''Per Second''


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


[Track list] [Group header] [Per Second] [Group row] [Min item num]
Available in the following scripts:<br />
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''


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


[Track list] [Group header] [Per Second] [Group row] [Min item num]
Available in the following scripts:<br />
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''


=== %el_backcolour% ===
===%el_backcolour%===
The background color back in the r-g-b format. R-g-b-a if you want to format, ''%el_backcolour%'' -192 can add value and alpha.  
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''.  


[Track list] [Group header] [Per Second]
Available in the following scripts:<br />
''Track list'', ''Group header'', ''Per Second''


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


[Track list] [Group header] [Per Second] [Group row] [Min item num]
Available in the following scripts:<br />
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''
 
===%el_preset_name%===
Returns the current "Group by" preset name (as defined in ELPlaylist Settings > Grouping).


=== %el_preset_name% ===
Available in the following scripts:<br />
Returns the current group by the preset name.
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''


[Track list] [Group header] [Per Second] [Group row] [Min item num]
===%el_is_group%===
Popup whether the group header.


=== %el_is_group% ===
Available in the following scripts:<br />
Popup whether the group header. [Popup]
''Popup''


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


[Popup]
Available in the following scripts:<br />
 
''Popup''
=== %el_is_themed% ===
Whether or not enable Visual Style valid


[Track list] [Group header] [Per Second] [Group row] [Min item num]
===%el_is_themed%===
Returns true if Visual Styles are enabled in ELPlaylist’s options.


== Functions ==
Available in the following scripts:<br />
''Track list'', ''Group header'', ''Per Second'', ''Group row'', ''Min item num''


== Draw control functions ==
== Functions (Draw control) ==


[Track list], [Group header], [Per Second], [Popup] valid.
[Track list], [Group header], [Per Second], [Popup] valid.
Line 463: Line 422:
=== $drawstring(text,x,y,W,H,rgba,OPTIONS[,OPTIONS2]) ===
=== $drawstring(text,x,y,W,H,rgba,OPTIONS[,OPTIONS2]) ===


Draws a string at the text coordinates (x,y). The size of the text field is defined by widh (W) and (H).
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 DrawText drawtextex not only in view. Might work for TrueType fonts, only.


OPTIONS:
''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.
* Alain specified, the specified quality of drawing, and to specify the clip.
* Alain left hcenter right specified horizontal
* Alain specified top vcenter bottom vertical
* nowrap not wraparound
* noaa ClearType and disable anti-aliasing.
* aa put the anti-aliasing mode. ClearType font such as resistance to the anti-aliasing.
* hq high quality rendering mode. ClearType mode. (default)


* If you set the trimming ''trimchar'' trimword fit the display range
'''OPTIONS''':
* elipchar elipword the last to fit the display range If···set to replace the
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)


* mempos getlastpos, to be able to get the coordinates of the drawing.
* ''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 (experimental stage) - specifying the terms of the glow effect:
'''OPTIONS2''' - specifying the glow effect (experimental stage):
* glow: expand: colour [: strength] glow options
* ''glow:expand:colour[:strength]'': glow options
* Expand - [0-5]
** ''Expand'' - [0-5]
* Colour - r-g-b
** ''Colour'' - r-g-b
* Strength - [0-3] glow_aa case of disabled
** ''Strength'' - [0-3] glow_aa case of disabled


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


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


Examples:
Examples:
* $drawstring(abcd, 10,10,, ,255-128-64-128,)
* $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(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,,glow :2:32-168-268: 1 offset: 1:1)
Line 500: Line 460:
=== $drawrect(x,y,w,h,R1-G1-B1-A1,R2-G2-B2-A2,OPTIONS) ===
=== $drawrect(x,y,w,h,R1-G1-B1-A1,R2-G2-B2-A2,OPTIONS) ===


Rectangular drawing functions.  Coordinates (x,y) size (w,h) Draws a rectangle.
Rectangular drawing function.  Coordinates (x,y) size (w,h) Draws a rectangle.
* R1-G1-B1-A1 internal color
* '''R1-G1-B1-A1''' internal color
* R2-G2-B2-A2 border color
* '''R2-G2-B2-A2''' border color


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


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


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


OPTIONS:
'''OPTIONS''':
* Vertical gradient of vertical
* ''vertical'': vertical gradient
* Gradient horizontal horizontal
* ''horizontal'': horizontal gradient
* Aa put ANCHIERIASU
* ''aa'': enable [http://en.wikipedia.org/wiki/Spatial_anti-aliasing anti aliasing]
* how nonlinear nonlinear gradient
* ''nonlinear'': nonlinear gradient


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


Example:
Example:
Line 533: Line 493:
=== $drawblurrect(x,y,w,h,colour,level) ===
=== $drawblurrect(x,y,w,h,colour,level) ===


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


=== $drawfocusrect(x,y,w,h) ===
=== $drawfocusrect(x,y,w,h) ===
Line 581: Line 541:
=== $drawroundrect(x,y,w,h,w2,h2,R1-G1-B1-A1,R2-G2-B2-A2,RESERVED) ===
=== $drawroundrect(x,y,w,h,w2,h2,R1-G1-B1-A1,R2-G2-B2-A2,RESERVED) ===


Draw a rectangle rolled angle function. Coordinates (x, y) size (w, h) to draw a rectangle with the corners rolled. Rounded the corner, w2, h2 can be adjusted.
Draws a rectangle with rounded corners at coordinates (x,y) and size (w, h). The degree of roundness is defined by (w2,h2).
* w> 4 * w2 & & h> 4 * h2 satisfy the need.
* 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
* '''R1-G1-B1-A1''' internal color
* R2-G2-B2-A2 Border Color
* '''R2-G2-B2-A2''' border color


Example:
Example:
* $drawroundrect(10,20,50,50,4,4255-255-128-255,,)
* $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) ===
=== $drawellipse(x,y,w,h,R1-G1-B1-A1,R2-G2-B2-A2,RESERVED) ===


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


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


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


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


Example:
Example:
Line 609: Line 570:
=== $imageabs(x,y,w,h,path,OPTIONS,n,alpha,OPTIONS2) ===
=== $imageabs(x,y,w,h,path,OPTIONS,n,alpha,OPTIONS2) ===


Coordinates (x, y) size (w, h) show the images in the path is specified. Images are retained in memory and after resizing the image, if you raise the efficiency of the process see below. The image is referenced, the memory is removed from them. w, h in the original image size is omitted, and the cache.  (However, w, h if you are already cached in memory and then the image size to be directly cached)
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.<!-- (w,h) in the original image size is omitted, and the cache.  (However, w, h if you are already cached in memory and then the image size to be directly cached)-->
 
<!--?ITAI a reduced rate if more than one. Poor quality and will be expanded after the reduction.
?ITAI a reduced rate if more than one. Poor quality and will be expanded after the reduction.
''Nodisplay'', ''noexpansion'' and use, Cache memory may be the largest reduction in the rate of reduction in the rate of use.
Nodisplay noexpansion and use, Cache memory may be the largest reduction in the rate of reduction in the rate of use.
If there are images true, if false is returned.-->
 
If there are images true, if false is returned. Dipsplays the image specified by path. After the image is resized, it is cached on the memory.


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


OPTIONS:
'''OPTIONS''':


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


<align> exclusive.
<alignment>
* Left right horizontal aryne specified.
* ''left right'': horizontal alignment
* Specify vertical aryne top bottom.
* ''top bottom'': vertical alignment


<misc>
<misc>
* wc wildcard (*,?) enabled.
* ''wc'': enables wildcard characters (*,?).
 
<read engine> exclusive.
 
archive archive reader through the path of the images. The format of the archive reader is path dependent, the absolute path of the archive | base path in the archive file.
 
Example:
* C:\aaa\image.zip | bbb/ccc.jpg
icon path is specified in the icon file (*. ico) to appear.
 
Audio artreader path specified by the embedded image file foobar2000 loaded at the core of the artwork reader.
If you do not have embedded images, Audio files to load the images folder. However slow.
* Audio artreader_front path specified by the embedded image file foobar2000 loaded at the core of the artwork reader.
* Audio artreader_back path specified by the embedded image file foobar2000 loaded at the core of the artwork reader.
* Audio artreader_disc path specified by the embedded image file foobar2000 loaded at the core of the artwork reader.
* Audio artreader_icon path specified by the embedded image file foobar2000 loaded at the core of the artwork reader.
(artreader *** are currently disrecommended options because these option seem to be slow)


N rotateflip Index for:
<read mode>
* 1: 90°
* ''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.
* 2: 180°
** Example: ''C:\aaa\image.zip|bbb/ccc.jpg''
* 3: 270°
* ''icon'': path is specified in the icon file (*.ico) to appear.
* 4: flip horizontal
* ''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.
* 5: 90° + flip horizontal
** Audio ''artreader_front'' path specified by the embedded image file foobar2000 loaded at the core of the artwork reader.
* 6: Flipped vertically
** Audio ''artreader_back'' path specified by the embedded image file foobar2000 loaded at the core of the artwork reader.
* 7: 90° + Flip Vertically
** 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)


Alpha (Opacity)
'''n''': rotateflip Index for:
* 0-255
* ''1'': 90°
* ''2'': 180°
* ''3'': 270°
* ''4'': flip horizontal
* ''5'': 90° + flip horizontal
* ''6'': Flipped vertically
* ''7'': 90° + Flip Vertically


OPTIONS2 (shadow effect)
'''Alpha''' (Opacity)
* Glow:expand:colour
* ''0-255''
* Offset:x:y


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


Examples:
Examples:
* $imageabs(10,10,50,50,C:\%album%.jpg)
* $imageabs(10,10,50,50,C:\%album%.jpg)
* $imageabs(10,10,50,50,C:\%album%.jpg,lefttop)
* $imageabs(10,10,50,50,C:\%album%.jpg,left top)
* $imageabs(10,10,50,50,C:\%album%.jpg,,6)
* $imageabs(10,10,50,50,C:\%album%.jpg,,6)
* $imageabs(10,10,50,50,C:\%album%.*,wc,6)
* $imageabs(10,10,50,50,C:\%album%.*,wc,6)
Line 680: Line 633:
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.
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):
'''OPTIONS''' (imageabs):
* nokeepaspect not maintain the aspect ratio
* ''nokeepaspect'': not maintain the aspect ratio
* Hide nodisplay read only memory
* ''nodisplay'': Hide read only memory
* Archive
* ''archive''
* Icon
* ''Icon''
*     (Left
* ''Horizontal Alignment''
*       Hcener
** left
*       Right
** hcener
*       Top
** right
*       Vcenter
* ''Vertical Alignment''
*           bottom)
** top
** vcenter
** bottom


N rotateflip Index for:
'''N''' rotateflip Index for:
* 1: 90°
* 1: 90°
* 2: 180°
* 2: 180°
Line 701: Line 656:
* 7: 90° + Flip Vertically
* 7: 90° + Flip Vertically


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


Examples:
'''Examples''':
* $imageabs_rc(200100,0,0100,50,10,10,C:\%album%.jpg,,6192)
* $imageabs_rc(200,100,0,0,100,50,10,10,C:\%album%.jpg,,6,192)
* $imageabs_rc(200100,0,0200100,10,10,C:\%album%.jpg,,) (=$imageabs(10,10200100,C:\%album%.jpg,lefttop,,))
* $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(150120,0,0150120,20,15,C:\%album%.jpg,hcenter vcenter,) (=$imageabs(20,15150120,C:\%album%.jpg,,,))
* $imageabs_rc(150,120,0,0,150,120,20,15,C:\%album%.jpg,hcenter vcenter,) ( = $imageabs(20,15,150,120,C:\%album%.jpg,,,) )
 
=== $albumart(x,y,w,h,target,OPTIONS,n,alpha,OPTIONS2) ===
 
Drawing function using the foobar2000 core api.
Resized images will be cached in the memory for efficiency. If moved out of display, the memory usage will be released.
If multiple versions of the same image are used in difference sizes, the quality of larger versions may be low. In case, options "nodisplay" and "noexpansion" may help a lot.
 
'''target''':
* 0:  group first track's album art
* 1:  current track's album art
**To use target=0 is strongly recommended. Please use target=1 carefully.


== Additional drawing functions ==
== Additional drawing functions ==
Line 713: Line 679:
=== $getlastpos(elem) ===
=== $getlastpos(elem) ===


Display function imageabs, imageabs_rc right after, to get the coordinates to draw a picture. Also, measurestring use them when you get the results. If you are drawString, mempos available only immediately after the specified coordinates.
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.
Elem element to retrieve.
Line 733: Line 699:
=== $measurestring(text,x,y,W,H,OPTIONS) ===
=== $measurestring(text,x,y,W,H,OPTIONS) ===


''$drawstring'' to calculate the area when drawing text. As a result, returns to the horizontal width of the viewing area. The display area is to get $getlastpos. ''OPTIONS'' is the same as $drawstring. If $drawstring uses the ''glow_aa'' or ''glow'' options, the ''$measurestring'' value returned may not be accurate.
''$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) ===
=== $getimagewidth(path),$getimageheight(path) ===


The image path is specified in $ imageabs $ imageabs_rc of cache memory. If the image has been resized in the horizontal width and vertical width returns. This means that only have ''$imageabs'' ''$imageabs_rc'' behind. nokeepaspect may be able to calculate the aspect ratio should be applied.
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(mode) ===
Line 825: Line 791:
The r-g-b color system in the form of returns.
The r-g-b color system in the form of returns.


''index: [0-30] color index system''
'''index''': [0-30] color index system


=== $averagecolour(colour1,colour2[,···]) ===
=== $averagecolour(colour1,colour2[,···]) ===
Line 926: Line 892:


== Popup system functions ==
== Popup system functions ==
[Popup (Background)], [Popup (Track)] domain.  
Valid for [Popup (Background)], [Popup (Track)].
 
$popupsize(w,h)
Pop-up function to reduce the size.
In other words,
W <max size (width)
H <max size (height)
Must satisfy.
 


$popuphide()  
=== $popupsize(w,h) ===
Do not pop up.
At that point and call it once and decided not to pop up.


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


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


Suppresses the pop up. At that point and call it once and decided not to pop up.


[Note]: drawstring with DrawText and drawtextex
=== $popuptracknum(num) ===
          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).
The maximum number of tracks to reduce the num treatment. Popup (Background) only available.
        DrawText The only argument in the text, $ rgb $ transition function and can specify the color using the function (should be).


''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 =
== External links ==
* [http://foo2k.chottu.net/ Official page with download link] (Japanese)
* {{ha|https://hydrogenaud.io/index.php/topic,62133.0.html}}
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=62133 Discussion thread]
* [http://foo2k.chottu.net/ Official page with download link] (Japanese) {{webarchive|https://web.archive.org/web/20230924193138/https://foo2k.chottu.net/|2023-09-24}}

Latest revision as of 15:08, 10 October 2023

ELPlaylist

foo_uie_elplaylist
Developer(s) ssenna
Repository
Release information
Initial release
Stable release 0.6.9.0b (July 30, 2010)
Preview release 0.6.9.1.2b (October 30, 2010)
foobar2000 compatibility
Architecture {{{foobar2000_architecture}}}
Minimum version 1.0
Maximum version {{{foobar2000_maximum}}}
UI module(s) Columns UI
Additional information
Use UI
License
Discussion thread {{{discussion_thread}}}
View all components

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 Title Formatting (TF). For further reading refer to the Title Format reference.

The readme file for this reference was translated from foo_uie_elplaylist.dll v0.6.4.2beta.

The formatting fields and functions provided by ELPlaylist are very similar to the 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.

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.

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.

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 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" preset name (as defined in ELPlaylist Settings > Grouping).

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 and $drawtextex. This function might work for TrueType fonts, only.

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

  • Align: left hcenter right specified horizontal
  • Align: specified top vcenter bottom vertical
  • nowrap: disables text wrap
  • noaa: ClearType and disable anti-aliasing.
  • aa: put the anti-aliasing mode. ClearType font such as resistance to the anti-aliasing.
  • hq: high quality rendering mode. ClearType mode. (default)
  • glow_aa glow option to use a special mode. (noaa, aa, hq exclusive)
  • trimchar and trimword: Trimming of the text to fit the display range
  • elipchar and elipword: Shortens the text to fit the the display range. If set the end of the line will be replaced with "···"
  • mempos getlastpos: to be able to get the coordinates of the drawing

OPTIONS2 - specifying the glow effect (experimental stage):

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

Offset:x:y

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

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

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:

Example:

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

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

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

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

OPTIONS:

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

PEAK: 0-100

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

Example:

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

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

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

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

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

$albumart(x,y,w,h,target,OPTIONS,n,alpha,OPTIONS2)

Drawing function using the foobar2000 core api. Resized images will be cached in the memory for efficiency. If moved out of display, the memory usage will be released. If multiple versions of the same image are used in difference sizes, the quality of larger versions may be low. In case, options "nodisplay" and "noexpansion" may help a lot.

target:

  • 0: group first track's album art
  • 1: current track's album art
    • To use target=0 is strongly recommended. Please use target=1 carefully.

Additional drawing functions

$getlastpos(elem)

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

Elem element to retrieve.

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

Example:

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

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

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

$getimagewidth(path),$getimageheight(path)

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

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