ZPlay.LoadFileID3ExW Method

Load extended ID3 data from specified file. Only in version 2.00 and above. (UNICODE version)

Pascal

function LoadFileID3ExW(FileName: WideString; Format: TStreamFormat; out Info: TID3InfoExW; fDecodeEmbededPicture: Boolean): Boolean;

Parameters

Parameters	Description
FileName: WideString	String that specifies the name of the file.
Format: TStreamFormat	Stream format. Use sfAutodetect if you need to autodetect stream format of specified file.
out Info: TID3InfoExW	Reference to TID3InfoExW receiving extended ID3 data.
fDecodeEmbededPicture: Boolean	Set to true to decode attached picture. See Remarks section.

Return Values

Return Values	Description
True	All OK.
False	Error. To get error message read here.

Remarks

Check supported formats for info tag support. Some formats can support some sort of "Info tags", but not all.

libZPlay library implements "ID3 tag" interface to different info tags (VORBIS comment, RIFF Info, ...). So, you can retrieve ID3 informations from different streams (mp3, ogg, flac, wav) because library will convert "format specific tag" to ID3 tag info.

Note:

This function can retrieve attached picture from info tag. If you need to draw this picture on screen, set fDecodeEmbededPicture parameter to true to decode attached picture into Bitmap class. See TID3PictureW.

Note:

Use this function if you just need ID3 data and you don't need to play this file. This function only loads ID3 data. There is no checking if this is valid file, wave output isn't open ... This function has no effect on currently open file or stream.