/*
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();}
};
}
}