foo_uie_esplaylist.dll v0.1.1.0 beta 2 (UI Extension for ColumnsUI 0.3+ / UI Element for Default UI)
for foobar2000 v1.0+, Windows Vista+ 


SDK version
foobar2000:2010-05-21
       cui:6.3


Default UI または、ColumnsUI 用のPlaylist Viewer (Library Viewerとしても使用可能)です。



※設定の説明は書きかけです。

[Preferences]
	[Grouping Tab]
	You can configure grouping presets.

		Sort format
			Specify titleformat script to sort all tracks for "Browse Library" mode.
			Force-Sorted: Apply sort format to the other modes also (i.e. Browse Playlist) than "Browse Library" mode.
			              Note about "Force-Sorted":
					(1) This configuration doesn't affect the actual order of the playlist contents, but reorder the "display order".
					(2) not support for editing the playlist with Drag & Drop.  
			              

		Grouping List
			This list shows the grouping layers in selected preset.
			You can edit by double-clicking on any grouping layer.
			The grouping layer which is checked will be the default layer (to be displayed first when restarting foobar2000). 


		Grouping Setting

			Grouping:
				Specify titleformat script  to determine how to separate/group each tracks.
				Consecutive tracks that return the same result of this script, belong to the same group.
				Note that the tracks belonging to one group must be consecutive.
				You can use "Sort format" (and "Force-Sorted"), if you want to avoid duplicated groups.

			Title:
				Specify titleformat script for group title.
		
			Side Info:
				Specify additional titleformat script for group side information.

			Artwrok:
				Specify the kind of artwork to display on group header.

			Display Only Focused Group:
				You can limit the tracks to be displayed in this layer.


[Track list]
	the content of the each column is configurable via  "right-click menu->Edit Column..." on the Column Header.

	Rating Column needs integer value within a range from 0 to 5 as the result of the titleformat scripts.
	Artwork Column and Group Info Column are special columns that need to be placed on left side.
	Note that the height of Group Info Column is equal to the width of Artwork Column.

[Context Menu]
	[Grouping]
		You can activate any grouping preset.

	[Playlists]
		Follow Active Playlist
			Always display the contents of the active playlist and follow the focused track.
			If you tick "Display Only Focused Group", you can list the tracks belonging to the group which the focused track belongs to.

		Follow NowPlaying Playlist
			Always display the contents of the playing playlist and follow the current playing track.
			If you tick "Display Only Focused Group",  you can list the tracks belonging to the group which the current playing track belongs to.

		Browse Library
			Display contents of the media library directly.


	[Options]
		View Style
			Always Display Only Focused Group: You can limit tracks to be displayed regardless of preset setting.

			Layered View : Grid View.
			Flat View (Fixed) : Normal List View Style


[keyboard shortcut]
	Enter    : Play
	Enter + Shift (on group header) : open/close group. 
	Ctrl + a : select all
	Ctrl + z : undo
	Ctrl + y : redo
	Delete   : remove the selected tracks from playlist.


[titleformat]
	$es_is_ascii(a)
		Returns true, if "a" consists of only ascii characters, otherwise false. 

	$es_is_numeric(a)
		Returns true, if "a" consists of only numeric characters, otherwise false. 

	$es_is_alphabet(a)
		Returns true, if "a" consists of only alphabet characters, otherwise false. 

	
	%es_item_index%
	    [Column Format] [Column Dynamic Format]
		Index of the item in the group it belongs to.

	%es_subgroup_count%
	    [Group Title] [Group SideInfo]
		Count of the sub-groups/items in the group.

	%es_subgroup_length%
	    [Group Title] [Group SideInfo]
		Playback length of the sub-groups/items in the group.




･本ソフトウェアには、下記の使用条件とともに配布されているソフトウェアの一部が含まれています。
foobar2000 1.0 SDK
  Copyright (c) 2001-2010, Peter Pawlowski
  All rights reserved.

  Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

  Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 
  Neither the name of the author nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
  Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation or other materials provided with the distribution.

  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.


Columns UI SDK 6.3.1


･ライセンスについて
  Copyright (c) 2010, ssenna

  バイナリ形式で再頒布する場合、頒布物に付属のドキュメント等の資料に、上記の著作権表示、本条件一覧、および下記免責条項を含めること。
  書面による特別の許可なしに、本ソフトウェアから派生した製品の宣伝または販売促進に、著作権所有者または貢献者の名前を使用してはならない。

  このソフトウェアは著作権所有者および貢献者により「現状のまま」提供されるものとし、商業的な使用可能性や特定の目的に対する適合性などの保証を含め、明示的暗黙的を問わず、いかなる保証もありません。
  著作権所有者および貢献者は、事由の如何を問わず、損害発生の原因の如何を問わず、かつ責任の根拠が契約であるか厳格責任であるか（過失その他）不法行為であるかを問わず、仮にそのような損害が発生する可能性を知らされていたとしても、
  このソフトウェアの使用から発生した直接損害、間接損害、偶発的な損害、特別損害、懲罰的損害、または結果損害（代替の物品やサービスの調達、使用機会やデータや利益の損失、業務の中断を含む、あらゆる損害）に対して一切責任を負いません。 


[免責事項など]
ライセンス条項にありますように、このソフトウェアには、いかなる保証もありません。
このソフトウェアを使用したことによって生じたすべての損害・障害・権利侵害・不具合等に関して、ソフトウェア作者は、一切の責任を負いません。
たとえバグがあったとしても、修正の義務を負いません。
この事項に了承頂ける方のみ、各自の責任においてご使用ください。


[changelog]
v1.1 beta 2
･$rgbのサポート。
･column設定のdynamic formatの削除。(%isplaying%を使用してください)
･SDK2010-05-21でビルド。
･version番号のルールを推奨に従うよう変更。
･他、細かい修正。

v1.1 beta
･ Layered View時に、グループごとにできる冗長なスペースを削除。
･ カスタム色のとき(VisualStyleを使わない場合)の選択行などの背景色の描画で、薄くボーダーを描画するようにした。
･ 他、細かい変更。
