seal 0.1.0

data/mpg123/ports/MSVC++/2008clr/mpg123clr/id3v1.cpp

@@ -0,0 +1,92 @@
+/*
+	mpg123clr: MPEG Audio Decoder library Common Language Runtime version.
+
+	copyright 2009 by Malcolm Boczek - free software under the terms of the LGPL 2.1
+	mpg123clr.dll is a derivative work of libmpg123 - all original mpg123 licensing terms apply.
+
+	All rights to this work freely assigned to the mpg123 project.
+*/
+/*
+	libmpg123: MPEG Audio Decoder library
+
+	copyright 1995-2008 by the mpg123 project - free software under the terms of the LGPL 2.1
+	see COPYING and AUTHORS files in distribution or http://mpg123.org
+
+*/
+/*
+	1.8.1.0	04-Aug-09	Initial release.
+	1.9.0.0 01-Oct-09	Technical cleanup - subst nullptr for NULL (mb)
+*/
+
+#include "StdAfx.h"
+#include "id3v1.h"
+
+mpg123clr::id3::mpg123id3v1::mpg123id3v1(void)
+{
+}
+
+mpg123clr::id3::mpg123id3v1::mpg123id3v1(mpg123_id3v1* sb)
+{
+	this->sb = sb;
+}
+
+
+// Destructor
+mpg123clr::id3::mpg123id3v1::~mpg123id3v1(void)
+{
+	// clean up code to release managed resources
+	// ...
+
+	// call Finalizer to clean up unmanaged resources
+	this->!mpg123id3v1();
+}
+
+// Finalizer
+mpg123clr::id3::mpg123id3v1::!mpg123id3v1(void)
+{
+	// we do not create the underlying structure, so shouldn't dispose it either...
+}
+
+String^ mpg123clr::id3::mpg123id3v1::tag::get()
+{
+	if (sb == nullptr || sb->tag == nullptr) return gcnew String("");
+
+	return Marshal::PtrToStringAnsi((IntPtr)sb->tag, (int)strnlen(sb->tag, 3));
+}
+
+String^ mpg123clr::id3::mpg123id3v1::title::get()
+{
+	if (sb == nullptr || sb->title == nullptr) return gcnew String("");
+
+	return Marshal::PtrToStringAnsi((IntPtr)sb->title, (int)strnlen(sb->title, 30));
+}
+
+String^ mpg123clr::id3::mpg123id3v1::artist::get()
+{
+	if (sb == nullptr || sb->artist == nullptr) return gcnew String("");
+
+	return Marshal::PtrToStringAnsi((IntPtr)sb->artist, (int)strnlen(sb->artist, 30));
+}
+
+String^ mpg123clr::id3::mpg123id3v1::album::get()
+{
+	if (sb == nullptr || sb->album == nullptr) return gcnew String("");
+
+	return Marshal::PtrToStringAnsi((IntPtr)sb->album, (int)strnlen(sb->album, 30));
+}
+
+String^ mpg123clr::id3::mpg123id3v1::comment::get()
+{
+	if (sb == nullptr || sb->comment == nullptr) return gcnew String("");
+
+	return Marshal::PtrToStringAnsi((IntPtr)sb->comment, (int)strnlen(sb->comment, 30));
+}
+
+int mpg123clr::id3::mpg123id3v1::genre::get()
+{
+	if (sb == nullptr) return 0;
+
+	return sb->genre;
+}
+
+

data/mpg123/ports/MSVC++/2008clr/mpg123clr/id3v1.h

@@ -0,0 +1,132 @@
+/*
+	mpg123clr: MPEG Audio Decoder library Common Language Runtime version.
+
+	copyright 2009 by Malcolm Boczek - free software under the terms of the LGPL 2.1
+	mpg123clr.dll is a derivative work of libmpg123 - all original mpg123 licensing terms apply.
+
+	All rights to this work freely assigned to the mpg123 project.
+*/
+/*
+	libmpg123: MPEG Audio Decoder library
+
+	copyright 1995-2008 by the mpg123 project - free software under the terms of the LGPL 2.1
+	see COPYING and AUTHORS files in distribution or http://mpg123.org
+
+*/
+/*
+	1.8.1.0	04-Aug-09	Initial release.
+*/
+
+#pragma once
+
+#pragma warning(disable : 4635)
+#include "mpg123.h"
+#pragma warning(default : 4635)
+
+#include <string>
+#include <iostream>
+
+#include <vcclr.h>
+using namespace std;
+using namespace System;
+using namespace System::Runtime::InteropServices;
+
+namespace mpg123clr
+{
+	namespace id3
+	{
+		///<summary>id3check enumeration.</summary>
+		public enum class id3check
+		{
+			none		= 0,
+			id3			= 2,				/**< 0010 There is some ID3 info. */
+			upd_id3		= MPG123_ID3,		/**< 0011 There is some ID3 info. Also matches 0010 or NEW_ID3. */
+			new_id3		= MPG123_NEW_ID3,	/**< 0001 There is ID3 info that changed since last call to mpg123_id3. */
+			icy			= 8,				/**< 1100 There is some ICY info. Also matches 0100 or NEW_ICY.*/
+			upd_icy		= MPG123_ICY,		/**< 1100 There is some ICY info. Also matches 0100 or NEW_ICY.*/
+			new_icy		= MPG123_NEW_ICY,	/**< 0100 There is ICY info that changed since last call to mpg123_icy. */
+		};
+
+		// Recommended usage when creating reference type on the managed heap (not using stack semantics 
+		//  for reference types...) [see Destructors and Finalizers in Visual C++]
+		//
+		// A ^ myA = gcnew A;
+		// try
+		// {
+		//     use myA
+		// }
+		// finally
+		// {
+		//     delete myA;
+		// }
+
+		///<summary>Wrapper for mpg123_id3v1.</summary>
+		[StructLayout(LayoutKind::Sequential)]
+		public ref struct mpg123id3v1
+		{
+		private:
+			mpg123_id3v1* sb;
+		protected:
+			///<summary>Finalizer.
+			///<para>Cleanly handles mpg123_delete of internal (unmanaged) mpg123 handle.</para></summary>
+			/// Implementation of CLR Finalize().
+			!mpg123id3v1(void);
+		internal:
+			///<summary>Working Constructor.
+			///<para>Maps to mpg123_id3v1 memory.</para>
+			///</summary>
+			mpg123id3v1(mpg123_id3v1* sb);
+		public:
+			///<summary>Constructor.
+			///<para>Only creates object for use as "out" target in ID3 constructor.</para>
+			///</summary>
+			mpg123id3v1(void);
+
+			///<summary>Destructor. Used for final object deletion.
+			///<para>Calls finalizer for clean disposal of internal (unmanaged) library handles.</para>
+			///</summary>
+			/// Implementation of CLR Dispose().
+			/// ~Destructor and !Finalizer are the prescribed implementation of Dispose() and Finalize().
+			/// See Destructors and Finalizers in Visual C++
+			~mpg123id3v1(void);
+
+			///<summary>Get the ID3v1 tag descriptor.
+			///<para>Property returns the ID3v1 tag (should always be "TAG").</para>
+			///</summary>
+			///<value>The ID3v1 tag (should always be "TAG").</value>
+			property String^ tag{String^ __clrcall get();}
+
+			///<summary>Get the ID3v1 title text.
+			///<para>Property returns the ID3v1 title text.</para>
+			///</summary>
+			///<value>The ID3v1 title text.</value>
+			property String^ title{String^ __clrcall get();}
+
+			///<summary>Get the ID3v1 artist text.
+			///<para>Property returns the ID3v1 artist text.</para>
+			///</summary>
+			///<value>The ID3v1 artist text.</value>
+			property String^ artist{String^ __clrcall get();}
+
+			///<summary>Get the ID3v1 album text.
+			///<para>Property returns the ID3v1 album text.</para>
+			///</summary>
+			///<value>The ID3v1 album text.</value>
+			property String^ album{String^ __clrcall get();}
+
+			///<summary>Get the ID3v1 comment text.
+			///<para>Property returns the ID3v1 comment text.</para>
+			///</summary>
+			///<value>The ID3v1 comment text.</value>
+			property String^ comment{String^ __clrcall get();}
+
+			///<summary>Get the ID3v1 genre index.
+			///<para>Property returns the ID3v1 genre index.</para>
+			///</summary>
+			///<value>The ID3v1 genre index.</value>
+			property int genre{int __clrcall get();}
+
+
+		};
+	}
+}

data/mpg123/ports/MSVC++/2008clr/mpg123clr/id3v2.cpp

@@ -0,0 +1,138 @@
+/*
+	mpg123clr: MPEG Audio Decoder library Common Language Runtime version.
+
+	copyright 2009 by Malcolm Boczek - free software under the terms of the LGPL 2.1
+	mpg123clr.dll is a derivative work of libmpg123 - all original mpg123 licensing terms apply.
+
+	All rights to this work freely assigned to the mpg123 project.
+*/
+/*
+	libmpg123: MPEG Audio Decoder library
+
+	copyright 1995-2008 by the mpg123 project - free software under the terms of the LGPL 2.1
+	see COPYING and AUTHORS files in distribution or http://mpg123.org
+
+*/
+/*
+	1.8.1.0	04-Aug-09	Initial release.
+	1.9.0.0 01-Oct-09	Technical cleanup - subst nullptr for NULL (mb)
+	1.10.0.0 30-Nov-09	Add test for null base (sb) - in addition to null string test (mb)
+						(required if v2 referenced prior to file scan)
+*/
+
+#include "StdAfx.h"
+#include "id3v2.h"
+
+mpg123clr::id3::mpg123id3v2::mpg123id3v2(void)
+{
+}
+
+mpg123clr::id3::mpg123id3v2::mpg123id3v2(mpg123_id3v2* sb)
+{
+	this->sb = sb;
+}
+
+
+// Destructor
+mpg123clr::id3::mpg123id3v2::~mpg123id3v2(void)
+{
+	// clean up code to release managed resources
+	// ...
+
+	// call Finalizer to clean up unmanaged resources
+	this->!mpg123id3v2();
+}
+
+// Finalizer
+mpg123clr::id3::mpg123id3v2::!mpg123id3v2(void)
+{
+	// we do not create the underlying structure, so shouldn't dispose it either...
+}
+
+String^ mpg123clr::id3::mpg123id3v2::title::get()
+{
+	// updated: more efficient "union style" mpg123str
+	mpg123str^ str = (sb == nullptr || sb->title == nullptr) ? gcnew mpg123str("") : gcnew mpg123str(sb->title);
+
+	// Deprecated remnant - uses "overlayed style" mpg123str - note inefficient PtrToStrucure...
+	//	mpg123str^% str = gcnew mpg123str;
+	//	Marshal::PtrToStructure((IntPtr)sb->title, str);
+
+	return str->Text;
+}
+
+String^ mpg123clr::id3::mpg123id3v2::artist::get()
+{
+	mpg123str^ str = (sb == nullptr || sb->artist == nullptr) ? gcnew mpg123str("") : gcnew mpg123str(sb->artist);
+
+	return str->Text;
+}
+
+String^ mpg123clr::id3::mpg123id3v2::album::get()
+{
+	mpg123str^ str = (sb == nullptr || sb->album == nullptr) ? gcnew mpg123str("") : gcnew mpg123str(sb->album);
+
+	return str->Text;
+}
+
+String^ mpg123clr::id3::mpg123id3v2::comment::get()
+{
+	mpg123str^ str = (sb == nullptr || sb->comment == nullptr) ? gcnew mpg123str("") : gcnew mpg123str(sb->comment);
+
+	return str->Text;
+}
+
+String^ mpg123clr::id3::mpg123id3v2::year::get()
+{
+	mpg123str^ str = (sb == nullptr || sb->year == nullptr) ? gcnew mpg123str("") : gcnew mpg123str(sb->year);
+
+	return str->Text;
+}
+
+String^ mpg123clr::id3::mpg123id3v2::genre::get()
+{
+	mpg123str^ str = (sb == nullptr || sb->genre == nullptr) ? gcnew mpg123str("") : gcnew mpg123str(sb->genre);
+
+	return str->Text;
+}
+
+int mpg123clr::id3::mpg123id3v2::version::get()
+{
+	return sb->version;
+}
+
+array<mpg123clr::mpg123text^>^ mpg123clr::id3::mpg123id3v2::MakeTextList(mpg123_text* ptr, size_t count)
+{
+	// WARN 4267 - clr limited to 32bit-length-size arrays!!
+	array<mpg123clr::mpg123text^>^ ary = gcnew array<mpg123clr::mpg123text^>((int)count);
+
+	for (int ii = 0; ii < ary->Length; ii++)
+	{
+		// Remnant - for explicit layout
+		//		mpg123text^% txt = gcnew mpg123text;
+		//		Marshal::PtrToStructure((IntPtr)ptr++, txt);
+
+		// New code - for "handle style" structure 
+		mpg123text^% txt = gcnew mpg123text(ptr++);
+
+		ary[ii] = txt;
+	}
+
+	return ary;
+}
+
+array<mpg123clr::mpg123text^>^ mpg123clr::id3::mpg123id3v2::Comments::get()
+{
+	return MakeTextList(sb->comment_list, sb->comments);
+}
+
+array<mpg123clr::mpg123text^>^ mpg123clr::id3::mpg123id3v2::Texts::get()
+{
+	return MakeTextList(sb->text, sb->texts);
+}
+
+array<mpg123clr::mpg123text^>^ mpg123clr::id3::mpg123id3v2::Extras::get()
+{
+	return MakeTextList(sb->extra, sb->extras);
+}
+

data/mpg123/ports/MSVC++/2008clr/mpg123clr/id3v2.h

@@ -0,0 +1,152 @@
+/*
+	mpg123clr: MPEG Audio Decoder library Common Language Runtime version.
+
+	copyright 2009 by Malcolm Boczek - free software under the terms of the LGPL 2.1
+	mpg123clr.dll is a derivative work of libmpg123 - all original mpg123 licensing terms apply.
+
+	All rights to this work freely assigned to the mpg123 project.
+*/
+/*
+	libmpg123: MPEG Audio Decoder library
+
+	copyright 1995-2008 by the mpg123 project - free software under the terms of the LGPL 2.1
+	see COPYING and AUTHORS files in distribution or http://mpg123.org
+
+*/
+/*
+	1.8.1.0	04-Aug-09	Initial release.
+*/
+
+#pragma once
+
+#pragma warning(disable : 4635)
+#include "mpg123.h"
+#pragma warning(default : 4635)
+
+#include "string.h"
+#include "text.h"
+
+#include <string>
+#include <iostream>
+
+#include <vcclr.h>
+using namespace std;
+using namespace System;
+using namespace System::Runtime::InteropServices;
+
+namespace mpg123clr
+{
+	namespace id3
+	{
+		// Recommended usage when creating reference type on the managed heap (not using stack semantics 
+		//  for reference types...) [see Destructors and Finalizers in Visual C++]
+		//
+		// A ^ myA = gcnew A;
+		// try
+		// {
+		//     use myA
+		// }
+		// finally
+		// {
+		//     delete myA;
+		// }
+
+		///<summary>Wrapper for mpg123_id3v2.</summary>
+		[StructLayout(LayoutKind::Sequential)]
+		public ref struct mpg123id3v2
+		{
+		private:
+			mpg123_id3v2* sb;
+
+			array<mpg123text^>^ __clrcall MakeTextList(mpg123_text* ptr, size_t count);
+
+		protected:
+			///<summary>Finalizer.
+			///<para>Does nothing - wrapper points to underlying memory, this class doesn't allocate memory.</para></summary>
+			/// Implementation of CLR Finalize().
+			!mpg123id3v2(void);
+
+		internal:
+			///<summary>Working Constructor.
+			///<para>Maps to mpg123_id3v2 memory.</para>
+			///</summary>
+			mpg123id3v2(mpg123_id3v2* sb);
+
+		public:
+			///<summary>Constructor.
+			///<para>Only creates object for use as "out" target in ID3 constructor.</para>
+			///</summary>
+			mpg123id3v2(void);
+
+			///<summary>Destructor. Used for final object deletion.
+			///<para>Calls finalizer for clean disposal of internal (unmanaged) library handles.</para>
+			///</summary>
+			/// Implementation of CLR Dispose().
+			/// ~Destructor and !Finalizer are the prescribed implementation of Dispose() and Finalize().
+			/// See Destructors and Finalizers in Visual C++
+			~mpg123id3v2(void);
+
+			///<summary>Get the ID3v2 title text.
+			///<para>Property returns the last encountered ID3v2 title text.</para>
+			///</summary>
+			///<value>The last encountered ID3v2 title text.</value>
+			property String^ title{String^ __clrcall get();}
+
+			///<summary>Get the ID3v2 artist text.
+			///<para>Property returns the last encountered ID3v2 artist text.</para>
+			///</summary>
+			///<value>The last encountered ID3v2 artist text.</value>
+			property String^ artist{String^ __clrcall get();}
+
+			///<summary>Get the ID3v2 album text.
+			///<para>Property returns the last encountered ID3v2 album text.</para>
+			///</summary>
+			///<value>The last encountered ID3v2 album text.</value>
+			property String^ album{String^ __clrcall get();}
+
+			///<summary>Get the ID3v2 comment text.
+			///<para>Property returns the last encountered ID3v2 comment text.</para>
+			///</summary>
+			///<value>The last encountered ID3v2 comment text.</value>
+			property String^ comment{String^ __clrcall get();}
+
+			///<summary>Get the ID3v2 year text.
+			///<para>Property returns the last encountered ID3v2 year text.</para>
+			///</summary>
+			///<value>The last encountered ID3v2 year text.</value>
+			property String^ year{String^ __clrcall get();}
+
+			///<summary>Get the ID3v2 genre text.
+			///<para>Property returns the last encountered ID3v2 genre text.</para>
+			///</summary>
+			///<value>The last encountered ID3v2 genre text.</value>
+			property String^ genre{String^ __clrcall get();}
+
+			///<summary>Get the ID3v2 version.
+			///<para>Property returns the ID3v2 version.</para>
+			///</summary>
+			///<value>The ID3v2 version.</value>
+			property int version{int __clrcall get();}
+
+
+			///<summary>Get an array of Comments.
+			///<para>Property returns an array of Comments.</para>
+			///</summary>
+			///<value>An array of Comments.</value>
+			property array<mpg123clr::mpg123text^>^ Comments{array<mpg123clr::mpg123text^>^ __clrcall get();};
+
+			///<summary>Get an array of ID3v2 text fields (including USLT).
+			///<para>Property returns an array of ID3v2 text fields (including USLT).</para>
+			///</summary>
+			///<value>An array of ID3v2 text fields (including USLT).</value>
+			property array<mpg123clr::mpg123text^>^ Texts{array<mpg123clr::mpg123text^>^ __clrcall get();};
+
+			///<summary>Get an array of extra (TXXX) fields.
+			///<para>Property returns an array of extra (TXXX) fields.</para>
+			///</summary>
+			///<value>An array of extra (TXXX) fields.</value>
+			property array<mpg123clr::mpg123text^>^ Extras{array<mpg123clr::mpg123text^>^ __clrcall get();};
+
+		};
+	}
+}