/*
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 <string>
#include <iostream>
#include <vcclr.h>
using namespace std;
using namespace System;
using namespace System::Runtime::InteropServices;
namespace mpg123clr
{
// 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_text.</summary>
[StructLayout(LayoutKind::Sequential, CharSet=CharSet::Ansi)]
public ref struct mpg123text
{
private:
mpg123_text* sb;
internal:
///<summary>Constructor.
///<para>Recommended usage: only as tracking marker to existing mpg123_text objects.</para></summary>
mpg123text(void);
///<summary>Reference Constructor.
///<para>Recommended usage: only as tracking marker to existing mpg123_text objects.</para></summary>
mpg123text(mpg123_text* sb);
protected:
///<summary>Finalizer.
///<para>Does nothing. mpg123text can only be instanced as a reference to an existing mpg123_text object (which is responsible for its own disposal.</para></summary>
/// Implementation of CLR Finalize().
!mpg123text(void);
public:
///<summary>Destructor. Used for final object deletion.
///<para>Calls finalizer.</para>
///</summary>
/// Implementation of CLR Dispose().
/// ~Destructor and !Finalizer are the prescribed implementation of Dispose() and Finalize().
/// See Destructors and Finalizers in Visual C++
~mpg123text(void);
///<summary>Get a string representation of the 3-letter language code.
///<para>Only COMM and USLT have a language element.</para>
///<para>Property returns string representation of the 3-letter language code.</para>
///</summary>
///<value>String representation of the 3-letter language code.</value>
property String^ lang{String^ __clrcall get();}
///<summary>Get a string representation of the ID3v2 field id. (i.e. TALB, TPE2 etc.)
///<para>Property returns string representation of the ID3v2 field id. (i.e. TALB, TPE2 etc.)</para>
///</summary>
///<value>String representation of the ID3v2 field id. (i.e. TALB, TPE2 etc.)</value>
property String^ id{String^ __clrcall get();}
///<summary>Get a string representation of the description field.
///<para>Only COMM and TXXX have a description element.</para>
///<para>Property returns string representation of the description field.</para>
///</summary>
///<value>String representation of the description field.</value>
property String^ description{String^ __clrcall get();}
///<summary>Get a string representation of the ID3 tag text.
///<para>This is for COMM, TXXX and all the other text fields.</para>
///<para>Property returns string representation of the ID3 tag text.</para>
///</summary>
///<value>String representation of the ID3 tag text.</value>
property String^ text{String^ __clrcall get();}
};
}