BASS_TAG_FLAC_PICTURE Class

BASS.NET API for the Un4seen BASS Audio Library

FLAC picture tag structure as returned by BASS_ChannelGetTags(Int32, BASSTag) using the BASS_TAG_FLAC_PICTURE flag.

Inheritance Hierarchy

SystemObject
Un4seen.BassBASS_TAG_FLAC_PICTURE

Namespace: Un4seen.Bass
Assembly: Bass.Net (in Bass.Net.dll) Version: 2.4.17.5

Syntax

[SerializableAttribute]
[StructLayoutAttribute(LayoutKind.Sequential, CharSet = CharSet.Ansi)]
public class BASS_TAG_FLAC_PICTURE

<SerializableAttribute>
<StructLayoutAttribute(LayoutKind.Sequential, CharSet := CharSet.Ansi)>
Public Class BASS_TAG_FLAC_PICTURE

The BASS_TAG_FLAC_PICTURE type exposes the following members.

Properties

	Name	Description
	Colors	The number of colours used for indexed-colour pictures (eg. GIF).
	Data	The picture data.
	Depth	The colour depth in bits-per-pixel.
	Desc	A description string of the picture.
	Height	The height in pixels.
	ImageURL	Returns the image URL, if the Mime type is "-->" - else is returned.
	Length	The size of Data in bytes.
	Mime	The MIME type string. This may be "-->" to signify that data contains a URL of the picture rather than the picture data itself.
	Picture	The picture image.
	Width	The width in pixels.

Top

Methods

	Name	Description
	FromIntPtr	Creates an instance of the BASS_TAG_FLAC_PICTURE class from a pointer.
	GetTag	Gets a BASS_TAG_FLAC_PICTURE tag from a given channel handle.
	ToString	Returns the description and mime type of the picture. (Overrides ObjectToString.)

Top

Remarks

The width, height, depth, and colors members may be empty (0) so should not be depended on. That information can be obtained from the picture data itself.

Use the static GetTag(Int32, Int32) method to get the FLAC picture tag from a given channel handle.

When calling BASS_ChannelGetTags(Int32, BASSTag) with the BASS_TAG_FLAC_PICTURE flag make sure to add the index number of the picture to get. E.g. call:

Copy

Bass.BASS_ChannelGetTags( stream, (BASSTag)(BASSTag.BASS_TAG_FLAC_PICTURE + 1) )

to get the 2nd picture.

Examples

Read all FLAC picture tags:

Copy

BASS_TAG_FLAC_PICTURE flacPic;
for (int n = 0; (flacPic = BASS_TAG_FLAC_PICTURE.GetTag(stream, n)) != null; n++)
{
    Console.WriteLine(flacPic);
    // access the image picture
    Image img = flacPic.Picture;
    // access the raw image data
    byte[] data = flacPic.Data;
}

Dim flacPic As BASS_TAG_FLAC_PICTURE
Dim n As Integer
For n = 0 To (flacPic  BASS_TAG_FLAC_PICTURE.GetTag(stream, n)) <> Nothing Step n + 1
    Console.WriteLine(flacPic)
    ' access the image picture
    Dim img As Image = flacPic.Picture 
    ' access the raw image data
    Dim data() As Byte = flacPic.Data 
Next

Reference

Un4seen.Bass Namespace