z440.atl.core 4.4.0

Breaking changes

• Major overhaul of TagData and related classes to streamline and simplify some parts of the library

  • You won't have any impact if you just use the Track class

  • If you were using TagData, please use TagHolder instead and mind the following :

    • Some fields have been renamed to align with the rest of the library : Rating → Popularity, Pictures → EmbeddedPictures
    • Some fields have been merged to align with the rest of the library : Recording<xxx> → Date, TrackNumberTotal and TrackTotal → TrackTotal, DiscNumberTotal and DiscTotal → DiscTotal
    • Public type of the "Additional fields" field has been simplified and is now a IDictionary<string, string>
    • Numeral and date fields are now typed instead of being plain strings
    • Last but not least, as collections (EmbeddedPictures, AdditionalFields and Chapters) are deep-copied upon access, they can't be edited on the fly anymore. You'll have to edit a temporary collection and feed it to TagHolder

    // Old code (won't work anymore)
    TagData tag = new TagData();
    tag.Pictures = new List<PictureInfo>();
    PictureInfo pic1 = PictureInfo.fromBinaryData(/*...*/, PIC_TYPE.Unsupported, tagType, 0x01);
    tag.Pictures.Add(pic1);
    PictureInfo pic2 = PictureInfo.fromBinaryData(/*...*/, PIC_TYPE.Unsupported, tagType, 0x02);
    tag.Pictures.Add(pic2);
    

    // New code
    TagHolder holder = new TagHolder(); // Now use TagHolder instead of TagData
    // Note that you don't have to worry about holder.Pictures not being initialized anymore
    IList<PictureInfo> testPictureInfos = new List<PictureInfo>(); // Use a local temporary collection
    PictureInfo pic1 = PictureInfo.fromBinaryData(/*...*/, PIC_TYPE.Unsupported, tagType, 0x01); // That part hasn't changed
    testPictureInfos.Add(pic1);
    PictureInfo pic2 = PictureInfo.fromBinaryData(/*...*/, PIC_TYPE.Unsupported, tagType, 0x02);
    testPictureInfos.Add(pic2);
    holder.EmbeddedPictures = testPictureInfos; // Feed the temporary collection to the TagHolder
    

• The subset of IMetaDataIO with the properties has been extracted and called IMetaData
• The IMetaData.Track field name has been renamed to TrackNumber and IMetaData.Disc has been renamed to DiscNumber to align with the naming of the Track class and the old TagData class
• Most helper classes are now internal to the library - for instance, you can't directly call StreamUtils or WavHelper anymore (don't know why you would in the first place...)

New

• OGG : Support for reading embedded FLAC
• OGG : ATL now properly reads multiplexed OGG files (e.g. Vorbis + Theora) and processes the audio part only
• M4A/MP4 : Support for Publisher and Publishing date fields
• M4A/MP4 : Support for alternate @des code for the General description field
• New standard field to Track and IMetaData : Product ID
• New feature : date values in AdditionalFields can be auto-formatted when prefixing them with MetaDataHolder.DATETIME_PREFIX. That feature can be turned off with Settings.AutoFormatAdditionalDates

Changed

The PictureTokens field is now deprecated as it is a remain from the era where ATL didn't support embedded images directly. This field will be removed on the next major udpate.

Fixed

WAV LIST INFO chunk now properly supports Recording Date, Genre, Popularity and Track number

Technical

Fixed unit tests for Linux and Unix-based systems (thanks to @sandreas)

Binaries are available from nuGet