BASS.NET API for the Un4seen BASS Audio Library

TAG_INFO Class

BASS.NET API for the Un4seen BASS Audio Library
Used with BASS_ChannelGetTags(Int32, BASSTag) to retrieve information on the current tags of a stream.
Inheritance Hierarchy

SystemObject
  Un4seen.Bass.AddOn.TagsTAG_INFO

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

[SerializableAttribute]
public class TAG_INFO

The TAG_INFO type exposes the following members.

Constructors

  NameDescription
Public methodTAG_INFO
Default constructor (filename must be set manually in order to be available).
Public methodTAG_INFO(String)
Constructor already setting the filename (full path) and the title (file name only).
Public methodTAG_INFO(TAG_INFO)
Creates a new instance as a clone of an existing instance.
Public methodTAG_INFO(String, Boolean)
Constructor already setting the filename (full path) and the title (file name only).
Top
Properties

  NameDescription
Public propertyNativeTags
Returns all native tags.
Public propertyNativeTagsCount
Returns the total number of available native tags.
Public propertyPictureCount
Returns the number of pictures which are available.
Top
Methods

  NameDescription
Public methodAddNativeTag
Adds a native tag.
Public methodAddOrReplaceNativeTag
Adds or Replaces a native tag.
Public methodAddPicture
Adds a picture tag.
Public methodClearAllNativeTags
Clears the collection of native tag entries.
Public methodClone
Returns a new TAG_INFO instance which is a clone of the current one.
Public methodCode exampleConvertToRiffBEXT
Converts the members of this instance to a WAV RIFF BEXT chunk.
Public methodCode exampleConvertToRiffCART
Converts the members of this instance to a WAV RIFF CART chunk.
Public methodCode exampleConvertToRiffINFO
Converts the members of this instance to a WAV RIFF LIST INFO chunk.
Public methodNativeTag
Returns a certain native tag.
Public methodPictureGet
Returns a picture tag.
Public methodPictureGetDescription
Returns the description of a picture.
Public methodPictureGetImage
Returns a picture image.
Public methodPictureGetType
Returns the type of the picture.
Public methodReadPicturesFromDirectory(String, Boolean)
Scans the directory of the filename location for additional pictures and adds them to the internal picture tags (see PictureCount for details).
Public methodStatic memberReadPicturesFromDirectory(String, String, String, Boolean)
Scans the directory of the filename location for additional pictures and returns any found pictures.
Public methodRemoveAllPictures
Removes all picture tags.
Public methodRemoveNativeTag
Removes a native tag.
Public methodRemovePicture
Removes a picture tag.
Public methodToString
A description of the tag info object (artist - title or filename).
(Overrides ObjectToString.)
Public methodCode exampleUpdateFromMETA(IntPtr, Boolean, Boolean)
Update the tags from a meta data pointer, e.g. when streaming from a URL as triggered by a SYNCPROC using BASS_SYNC_META and as returned by BASS_ChannelGetTags(Int32, BASSTag).
Public methodCode exampleUpdateFromMETA(IntPtr, TAGINFOEncoding, Boolean)
Update the tags from a meta data pointer, e.g. when streaming from a URL as triggered by a SYNCPROC using BASS_SYNC_META and as returned by BASS_ChannelGetTags(Int32, BASSTag).
Public methodCode exampleUpdateFromMIDILyric
Update the tags from a meta data pointer, when using in a SYNCPROC using BASS_SYNC_MIDI_LYRIC or BASS_MIDI_MARK_TEXT.
Top
Fields

  NameDescription
Public fieldalbum
The Album name.
Public fieldalbumartist
The Album Artist name (Band/Orchestra/Remixer).
Public fieldartist
The Artist name.
Public fieldbitrate
The estimated bitrate of the track in kBit/sec.
Public fieldbpm
Beats Per Minute.
Public fieldchannelinfo
The BASS_CHANNELINFO structure.
Public fieldcomment
The Comment text.
Public fieldcomposer
The Composer (as a string).
Public fieldconductor
The conductor (or director) of the content.
Public fieldcopyright
The Copyright (as a string).
Public fielddisc
The disc number (as a string, either '99' or '99/99').
Public fieldduration
The estimated duration of the track in seconds.
Public fieldencodedby
The EncodedBy (as a string).
Public fieldfilename
The name of the file (only available, if set in the constructor or manually)
Public fieldgenre
The Genre (as a string).
Public fieldgrouping
Content groups are collections of media to which individual files may belong. For example, an audio file may be a song that is a track on one compact disc that is part of a boxed set.
Public fieldisrc
The International Standard Recording Code (a 12 digit unique alphanumeric number).
Public fieldlyricist
The Lyricist, Songwriter (as a string).
Public fieldmood
The mood of the content.
Public fieldproducer
The Producer (as a string).
Public fieldpublisher
The Publisher, Label (as a string).
Public fieldrating
The rating of the content (e.g. 0=unrated, 1-20=poor, 21-40=average, 41-60=good, 61-80=very good, 81-100=excellent).
Public fieldremixer
The Remixer, Modifier (as a string).
Public fieldreplaygain_track_gain
The track replaygain gain value in dB between -60.0 and +60.0 dB.
Public fieldreplaygain_track_peak
The track replaygain peak level value as a float value between 0.0 (silence) and 1.0 (0dB).
Public fieldtagType
The type of TAG being read (one of BASSTag).
Public fieldtitle
The song title.
Public fieldtrack
The track number (as a string, either '99' or '99/99').
Public fieldyear
The Year (as a string, typically in the format YYYY or YYYY-MM).
Top
Remarks

The following mapping is used with the diferent tag formats to read the content:
NameMapping
title

ID3v2: TIT2, TT2

OGG: TITLE

APE: Title

MP4: ©nam

ASF: WM/Title

RIFF: INAM

Alternatives: --

artist

ID3v2: TPE1, TP1

OGG: ARTIST

APE: Artist

MP4: ©ART

ASF: WM/Author

RIFF: IART

Alternatives: ISTR, AUTHOR

album

ID3v2: TALB, TAL

OGG: ALBUM

APE: Album

MP4: ©alb

ASF: WM/AlbumTitle

RIFF: IPRD

Alternatives: --

albumartist

ID3v2: TPE2, TP2

OGG: ALBUMARTIST

APE: Album Artist

MP4: aART

ASF: WM/AlbumArtist

RIFF: ISBJ

Alternatives: H2_ALBUMARTIST, ENSEMBLE, ORCHESTRA, BAND, PERFORMER, iaar

track

ID3v2: TRCK, TRK

OGG: TRACKNUMBER

APE: Track

MP4: trkn

ASF: WM/TrackNumber

RIFF: IPRT, ITRK

Alternatives: TRACKNUM

disc

ID3v2: TPOS, TPA

OGG: DISCNUMBER

APE: Disc

MP4: disk

ASF: WM/PartOfSet

RIFF: IFRM

Alternatives: DISCNUM

year

ID3v2: TYER, TYE

OGG: DATE

APE: Year

MP4: ©day

ASF: WM/Year

RIFF: ICRD

Alternatives: TDRC, RELEASEDATE, RELEASE DATE

genre

ID3v2: TCON, TCO

OGG: GENRE

APE: Genre

MP4: ©gen

ASF: WM/Genre

RIFF: IGNR

Alternatives: --

copyright

ID3v2: TCOP, TCR

OGG: COPYRIGHT

APE: Copyright

MP4: cprt

ASF: Copyright

RIFF: ICOP

Alternatives: PROVIDER, WM/Provider

encodedby

ID3v2: TENC, TEN

OGG: ENCODEDBY

APE: EncodedBy

MP4: ©too

ASF: WM/EncodedBy

RIFF: ISFT

Alternatives: VERSION, ENCODED BY, ENCODED-BY, ENCODER, SOFTWARE, TOOL

publisher

ID3v2: TPUB, TPB

OGG: LABEL

APE: Label

MP4: ----:com.apple.iTunes:LABEL

ASF: WM/Publisher

RIFF: ICMS

Alternatives: PUBLISHER, ORIGINALSOURCE, VENDOR

composer

ID3v2: TCOM, TCM

OGG: COMPOSER

APE: Composer

MP4: ©wrt

ASF: WM/Composer

RIFF: IENG

Alternatives: ORGANIZATION, WRITER, IMUS

conductor

ID3v2: TPE3, TP3

OGG: CONDUCTOR

APE: Conductor

MP4: ----:com.apple.iTunes:CONDUCTOR

ASF: WM/Conductor

RIFF: ITCH

Alternatives: --

lyricist

ID3v2: TEXT, TXT

OGG: LYRICIST

APE: Lyricist

MP4: ----:com.apple.iTunes:LYRICIST

ASF: WM/Writer

RIFF: IWRI

Alternatives: TEXTER, SONGWRITER

remixer

ID3v2: TPE4, TP4

OGG: REMIXER

APE: MixArtist

MP4: ----:com.apple.iTunes:REMIXER

ASF: WM/ModifiedBy

RIFF: IEDT

Alternatives: ModifiedBy

producer

ID3v2: TIPL, IPL

OGG: PRODUCER

APE: Producer

MP4: ----:com.apple.iTunes:PRODUCER

ASF: WM/Producer

RIFF: IPRO

Alternatives: --

comment

ID3v2: COMM, COM

OGG: COMMENT

APE: Comment

MP4: ©cmt

ASF: WM/Description

RIFF: ICMT

Alternatives: DESCRIPTION

grouping

ID3v2: TIT1, TT1

OGG: GROUPING

APE: Grouping

MP4: ©grp

ASF: WM/ContentGroupDescription

RIFF: ISRF

Alternatives: GROUP

mood

ID3v2: TMOO

OGG: MOOD

APE: Mood

MP4: ----:com.apple.iTunes:MOOD

ASF: WM/Mood

RIFF: IKEY

Alternatives: --

rating

ID3v2: POPM

OGG: RATING

APE: Rating

MP4: rtng

ASF: WM/SharedUserRating

RIFF: ISHP

Alternatives: TXXX:RATING, IRTD

isrc

ID3v2: TSCR

OGG: ISRC

APE: ISRC

MP4: ----:com.apple.iTunes:ISRC

ASF: WM/ISRC

RIFF: ISRC

Alternatives: --

bpm

ID3v2: TBPM, TBP

OGG: BPM

APE: BPM

MP4: ----:com.apple.iTunes:BPM

ASF: WM/BeatsPerMinute

RIFF: IBPM

Alternatives: TEMPO, IDPI, tmpo, H2_BPM, BEATSPERMINUTE

replaygain_track_gain

ID3v2: TXXX:replaygain_track_gain

OGG: replaygain_track_gain

APE: replaygain_track_gain

MP4: ----:com.apple.iTunes:replaygain_track_gain

ASF: replaygain_track_gain

RIFF: IRGG

Alternatives: itgl

replaygain_track_peak

ID3v2: TXXX:replaygain_track_peak

OGG: replaygain_track_peak

APE: replaygain_track_peak

MP4: ----:com.apple.iTunes:replaygain_track_peak

ASF: replaygain_track_peak

RIFF: IRGP

Alternatives: --

Note: The mapping is performed case insensitive. The Alternatives are only used, if the regular mapping doesn't find any matching entry.
See Also

Reference