GroupDocs.Metadata for .NET 16.10 Release Notes

Major Features

There are 8 features and 1 enhancement in this regular monthly release. The most notable are:

  • Implement wav audio format. Ability to read WAV audio details
  • Ability to read IPTC metadata in TIFF format
  • Ability to read IPTC metadata in PSD format
  • Ability to read Lyrics3 tag in Mp3 format
  • Ability to update ID3v1 tag in Mp3 format
  • Ability to read Image Resource Blocks (native PSD metadata) in Photoshop format
  • Ability to remove Photoshop metadata in Jpeg format
  • Ability to read Image Resource Blocks (native PSD metadata) in Jpeg format
  • IPTC reader improvements - scan all image resource blocks to find IPTC metadata in JPEG format

All Changes

KeySummaryCategory
METADATANET-1172IPTC reader improvements - scan all image resource blocks to find IPTC metadata in JPEG formatEnhancement
METADATANET-691Implement wav audio format. Ability to read WAV audio detailsNew feature
METADATANET-1043Ability to read IPTC metadata in TIFF formatNew feature
METADATANET-1044Ability to read IPTC metadata in PSD formatNew feature
METADATANET-1116Ability to read Lyrics3 tag in Mp3 formatNew feature
METADATANET-1118Ability to update ID3v1 tag in Mp3 formatNew feature
METADATANET-1170Ability to read Image Resource Blocks (native PSD metadata) in Photoshop formatNew feature
METADATANET-1171Ability to remove Photoshop metadata in Jpeg formatNew feature
METADATANET-1174Ability to read Image Resource Blocks (native PSD metadata) in Jpeg formatNew feature

Public API and Backward Incompatible Changes

Working with WAV Format

Detect WAV Fromat

 // path to the input directory
string dir = @"C:\\download files";

// get all files inside directory
string[] files = Directory.GetFiles(dir);

foreach (string path in files)
{
 // detect format
 FormatBase format = GroupDocs.Metadata.Tools.FormatFactory.RecognizeFormat(path);

 if (format == null)
 {
  // skip unsupported format
  continue;
 }

  if (format.Type == DocumentType.Wav)
  {
    Console.WriteLine("File {0} has WAV format", Path.GetFileName(path));
  }
}

Read Audio Details in WAV Format

const string filePath = @"C:\download files\sample.wav";

// init WavFormat class
WavFormat wavFormat = new WavFormat(filePath);

// get audio info
WavAudioInfo audioInfo = wavFormat.AudioInfo;

// display bits per sample
Console.WriteLine("Bits per sample: {0}", audioInfo.BitsPerSample);

// display audio format version
Console.WriteLine("Audio format: {0}", audioInfo.AudioFormat);

// display number of channels
Console.WriteLine("Number of channels: {0}", audioInfo.NumberOfChannels);

// display sample rate
Console.WriteLine("Sample rate: {0}", audioInfo.SampleRate);

Read IPTC Metadata in TIFF Format

 // path to the tiff file
string path = @"C:\\example.tif";

// initialize TiffFormat
TiffFormat tiffFormat = new TiffFormat(path);

// check if TIFF contains IPTC metadata
if (tiffFormat.HasIptc)
{
 // get iptc collection
 IptcCollection iptc = tiffFormat.GetIptc();

 // and display it
 foreach (IptcProperty iptcProperty in iptc)
 {
  Console.Write("Tag id: {0}, name: {1}", iptcProperty.TagId, iptcProperty.Name);
 }
}

Read IPTC Metadata in PSD Format

// path to the tiff file
string path = @"C:\\example.tif";

// initialize PsdFormat
PsdFormat psdFormat = new PsdFormat(path);

// check if PSD contains IPTC metadata
if (psdFormat.HasIptc)
{
 // get iptc collection
 IptcCollection iptc = psdFormat.GetIptc();

 // and display it
 foreach (IptcProperty iptcProperty in iptc)
 {
  Console.Write("Tag id: {0}, name: {1}", iptcProperty.TagId, iptcProperty.Name);
 }
}

Read Lyrics3 Tag in Mp3 Format

// path to the input directory
string dir = @"C:\\download files";

// get all files inside directory
string[] files = Directory.GetFiles(dir, "*.mp3");

foreach (string file in files)
{
 // initialize Mp3Format. If file is not Mp3 then appropriate exception will throw.
 Mp3Format mp3Format = new Mp3Format(file);

 // get Lyrics3 v2.00 tag
 Lyrics3Tag lyrics3Tag = mp3Format.Lyrics3v2;

 // check if Lyrics3 is presented. It could be absent.
 if (lyrics3Tag != null)
 {
   // Display defined tag values
   Console.WriteLine("Album: {0}", lyrics3Tag.Album);
   Console.WriteLine("Artist: {0}", lyrics3Tag.Artist);
   Console.WriteLine("Track: {0}", lyrics3Tag.Track);

   // get all fields presented in Lyrics3Tag
   Lyrics3Field[] allFields = lyrics3Tag.Fields;

   foreach (Lyrics3Field lyrics3Field in allFields)
   {
     Console.WriteLine("Name: {0}, value: {1}", lyrics3Field.Name, lyrics3Field.Value);

    }
  }
}

Update ID3v1 Tag in Mp3 Format

const string filePath = @"C:\download files\a-ha - Take On Me.mp3";

// init Mp3Format class
Mp3Format mp3Format = new Mp3Format(filePath);

// create id3v1 tag
Id3v1Tag id3Tag = new Id3v1Tag();

// set artist
id3Tag.Artist = "A-ha";

// set title
id3Tag.Title = "Take on me";

// update ID3v1 tag
mp3Format.UpdateId3v1(id3Tag);

// and commit changes
mp3Format.Save();

Read Image Resource Blocks (native PSD metadata) in Photoshop Format

// path to the Photoshop file
string path = @"C:\\example.psd";

// initialize PsdFormat
PsdFormat psdFormat = new PsdFormat(path);

// check if JPEG contain photoshop metadata
if (psdFormat.HasImageResourceBlocks)
{
 // get native photoshop metadata
 ImageResourceMetadata imageResource = psdFormat.GetImageResourceBlocks();

 // display all blocks
 foreach (ImageResourceBlock imageResourceBlock in imageResource.Blocks)
 {
   Console.WriteLine("Id: {0}, size: {1}", imageResourceBlock.DefinedId, imageResourceBlock.DataSize);

   // create your own logic to parse image resource block
   byte[] data = imageResourceBlock.Data;
 }
}

Remove Photoshop Metadata in Jpeg Format

// path to the jpg file
string path = @"C:\\example.jpg";

// initialize JpegFormat
JpegFormat jpegFormat = new JpegFormat(path);

// check if JPEG contain photoshop metadata
if (jpegFormat.HasImageResourceBlocks)
{
  // remove photshop Image Resource blocks
  jpegFormat.RemovePhotoshopData();

  // and commit changes
  jpegFormat.Save();
}

Read Image Resource Blocks (native PSD metadata) in Jpeg Format

// path to the jpg file
string path = @"C:\\example.jpg";

// initialize JpegFormat
JpegFormat jpegFormat = new JpegFormat(path);

// check if JPEG contain photoshop metadata
if (jpegFormat.HasImageResourceBlocks)
{

 // get native photoshop metadata
 ImageResourceMetadata imageResource = jpegFormat.GetImageResourceBlocks();

 // display all blocks
 foreach (ImageResourceBlock imageResourceBlock in imageResource.Blocks)
 {
  Console.WriteLine("Id: {0}, size: {1}", imageResourceBlock.DefinedId, imageResourceBlock.DataSize);

  // create your own logic to parse image resource block
  byte[] data = imageResourceBlock.Data;
  }
}