ID3Tag Functions

All ID3Tag related functions are mapped on the MP3_ID3 table.

  • MP3_ID3.CleanUp(Content)
  • MP3_ID3.GetFrameSize_4(nf)
  • MP3_ID3.OnlySpaces(txt)
  • MP3_ID3.ReadNullTerminatedString(fileid)
  • MP3_ID3.Read_ID3(filename)
  • MP3_ID3.StripZero(txt)


MP3_ID3.CleanUp(Content)

cleaned = MP3_ID3.CleanUp(Content)

Cleanup the given 'content' string removing leading/trailing spaces and removing Chr(0) characters.

INPUT

  • Content : String to clean

OUTPUT

  • cleaned : Cleaned string

NOTES
This is an utility function used internally



MP3_ID3.GetFrameSize_4(nf)

result = MP3_ID3.GetFrameSize_4(nf)

From the given opened file 'nf', read the next 4 characters to calculate a 4 byte value that determines the frame size.

INPUT

  • nf : File id of the file we have to process

OUTPUT

  • fs : Calculated frame size

NOTES
This is an utility function used internally



MP3_ID3.OnlySpaces(txt)

result = MP3_ID3.OnlySpaces(txt)

Returns TRUE if the given 'txt' is composed only by spaces.

INPUT

  • txt : String to check

OUTPUT

  • result : TRUE if 'txt' is composed by spaces

NOTES
This is an utility function used internally



MP3_ID3.ReadNullTerminatedString(fileid)

result = MP3_ID3.ReadNullTerminatedString(fileid)

Read from an opened file and at the current position, the first null-terminated string.

INPUT

  • fileid : File ID of an opened file

OUTPUT

  • result : The read data

NOTES
If the null character is not found this function will return Nil This is an utility function used internally



MP3_ID3.Read_ID3(filename)

id3v1, id3v2, tagsv1, tagsv2 = MP3_ID3.Read_ID3(filename)

Process the given 'filename' file to read all available ID3 Tags.

INPUT

  • filename : MP3 File to check

OUTPUT

  • id3v1 : TRUE if ID3 Tags v1 has been detected
  • id3v2 : TRUE if ID3 Tags v2 has been detected
  • tagsv1 : A table with all detected ID3 Tags v1
  • tagsv2 : A table with all detected ID3 Tags v2

NOTES
This function handles the following ID3 tags / data — v1 —
* Song Title → .SongTitle
* Artist → .Artist
* Album → .Album
* Year → .Year
* Comment → .Comment
* Genre → .Genre — v2 —
* ID3 Tags Version → .Version
* ID3 Tags Revision → .Revision
* ID3 Tags Flags → .Flags
* FrameSize → .FrameSize — Version = 3 —
* AENC : Audio Encryption → .AudioEncryption
* ASPE : Audio SPI → .AudioSeekPointIndex
* COMM : Comments → .Comments
* COMR : Commercial Frame → .CommercialFrame
* ENCR : Encr.Method Reg. → .EncryptionMethodRegistration
* EQU2 : Equalisation → .Equalisation
* ETCO : Event Timing Codes> .EventTimingCodes
* GRID : Group Ident.Reg. → .GroupIdentificationRegistration
* GEOB : Gen.Encaps.Obj. → .General EncapsulatedObject
* LINK : Linked Information> .LinkedInformation
* MLLT : MPEG LLT → .MPEGLocationLookupTable
* OWNE : Ownership Frame → .OwnershipFrame
* PRIV : Private Frame → .PrivateFrame
* PCNT : Play Counter → .PlayCounter
* POPM : Popularimeter → .Popularimeter
* POSS : Pos.Sync. Frame → .PositionSynchronizationFrame
* RBUF : Recomm.Buffer Size> .RecommandedBufferSize
* RVA2 : Rel.Vol.Adjustm → .RelativeVolumeAdjustment
* RVBR : Reverb → .Reverb
* SEEK : Seek Frame → .SeekFrame
* SIGN : Signature Frame → .SignatureFrame
* SYLT : Synchronized Lyric> .SynchronizedLyric
* SYTC : Sync. Tempo COdes→ .SynchronizedTempoCodes
* TDEN : Encoding Time → .EncodingTime
* TDOR : Orig.Release Time→ .OriginalReleaseTime
* TDRC : Recording Time → .RecordingTime
* TDRL : Release Time → .ReleaseTime
* TDTG : Tagging Time → .TaggingTime
* TIPL : Involved People → .InvolvedPeople
* TMCL : Music.Cred.List → .MusicianCreditsList
* TMOO : Mood → .Mood
* TPE4 : Modifier → .Modifier
* TPRO : Producer Notice → .ProducerNotice
* TSOA : Album Sort Order → .AlbumSortOrder
* TSOP : Perf. SOrt Order → .PerformerSortOrder
* TSOT : Title Sort Order → .TitleSortOrder
* TSSE : Soft.Hard.Encoder→ .SoftwareHardwareEncoder
* TSST : Set Subtitle → .SetSubtitle
* UFID : Unique File ID → .UniqueFileIdentifier
* USER : Terms of use → .TermsOfUse
* USLT : Unsync. Lyric → .UnsynchronisedLyric
* APIC : Embedded picture → .RawEmbeddedPicture (.ImageData, .Description, .PicType, .MimeType)
* TALB : Album → .Album
* TBPM : BPM → .BPM
* TCOM : Composer → .Composer
* TCON : Content Type → .ContentType
* TCOP : Copyright Message→ .CopyrightMessage
* TDAT : Recording Date → .RecordingDate
* TDLY : Playlist Delay → .PlailistDelay_ms
* TENC : Encoder → .Encoder
* TEXT : Lyricist → .Lyricist
* TFLT : File type → .FileType
* TIME : Recording Time → .RecordingTime
* TIT1 : Content Group → .ContentGroup
* TIT2 : Song Title → .SongTitle
* TIT3 : Song Sub Title → .SongSubTitle
* TKEY : Starting Key → .Starting Key
* TLAN : Lyrics Language → .LyricsLanguage
* TLEN : Song Lenght → .SongLenght_ms
* TMED : Media Type → .MediaType
* TOAL : Original Album → .OriginalAlbum
* TOFN : Original Filename→ .OriginalFilename
* TOLY : Original Lyricist→ .OriginalLyricist
* TOPE : Orig.Performers → .OriginalPerformers
* TORY : Orig.Release Year→ .OriginalReleaseYear
* TOWN : File Owner → .FileOwner
* TPE1 : Lead Artist → .LeadArtist
* TPE2 : Band → .Band
* TPE3 : Conductor → .Conductor
* TPOS : Part of set → .PartOfSet
* TPUB : Publisher → .Publisher
* TRCK : Track Number → .TrackNumber
* TRDA : Recording Dates → .RecordingDates
* TRSN : Internet Radio Name → .InternetRadioName
* TRSO : Internet Radio Owner→ .InternetRadioOwner
* TSIZ : Song Size → .SongSize
* TSRC : ISRC → .InternationalStandardRecordingCode
* TYER : Recording Year → .RecordingYear
* WCOM : Link Comm. Infos → .Link_CommercialInfos
* WCOP : Link Copyright → .Link_CopyrightInfos
* WOAF : Link Off. File → .Link_OfficialAudioFile
* WOAR : Link Artist → .Link_Artist
* WOAS : Link Off. Studio → .Link_OfficialAudioStudio
* WORS : Link Off. Radio → .Link_OfficialInternetRadio
* WPAY : Link Payment → .Link_Payment
* WPUB : Link Publisher → .Link_Publisher
* MCDI : CD TOC → .CD_TOC



MP3_ID3.StripZero(txt)

result, c = MP3_ID3.StripZero(txt)

Clean the given 'txt' string removing all Chr(0) characters.

INPUT

  • txt : String to clean

OUTPUT

  • result : Cleaned string
  • c : How many characters has been removed

NOTES
This is an utility function used internally

hollywoodlibs/id3tag/functions.txt · Ultima modifica: 2017/08/22 08:51 da admin
CC Attribution-Noncommercial 4.0 International
Driven by DokuWiki Recent changes RSS feed Valid CSS Valid XHTML 1.0