#region --- OpenTK.OpenAL License ---
/* XRamExtension.cs
* C header: \OpenAL 1.1 SDK\include\xram.h
* Spec: ?
* Copyright (c) 2008 Christoph Brandtner and Stefanos Apostolopoulos
* See license.txt for license details (MIT)
* http://www.OpenTK.net */
#endregion
using System;
using System.Runtime.InteropServices;
namespace OpenTK.OpenAL
{
public class XRamExtension
{
#region instance state
private bool _valid = false;
/// Returns True if the X-Ram Extension has been found and could be initialized.
public bool IsInitialized
{
get { return _valid; }
}
#endregion instance state
#region X-RAM Function pointer definitions
[CLSCompliant(false)]
public unsafe delegate bool Delegate_SetBufferMode( int n,ref uint buffers,int value );
//typedef ALboolean (__cdecl *EAXSetBufferMode)(ALsizei n, ALuint *buffers, ALint value);
[CLSCompliant(false)]
public delegate int Delegate_GetBufferMode( uint buffer,out int value );
//typedef ALenum (__cdecl *EAXGetBufferMode)(ALuint buffer, ALint *value);
[CLSCompliant(false)]
private Delegate_SetBufferMode Imported_SetBufferMode;
[CLSCompliant(false)]
private Delegate_GetBufferMode Imported_GetBufferMode;
#endregion X-RAM Function pointer definitions
#region X-RAM Tokens
private int AL_EAX_RAM_SIZE, AL_EAX_RAM_FREE,
AL_STORAGE_AUTOMATIC, AL_STORAGE_HARDWARE, AL_STORAGE_ACCESSIBLE;
#endregion X-RAM Tokens
#region Constructor / Extension Loading
public XRamExtension( )
{ // Query if Extension supported and retrieve Tokens/Pointers if it is.
_valid = false;
if ( AL.IsExtensionPresent("EAX-RAM") == false )
return;
AL_EAX_RAM_SIZE = AL.GetEnumValue("AL_EAX_RAM_SIZE");
AL_EAX_RAM_FREE = AL.GetEnumValue("AL_EAX_RAM_FREE");
AL_STORAGE_AUTOMATIC = AL.GetEnumValue("AL_STORAGE_AUTOMATIC");
AL_STORAGE_HARDWARE = AL.GetEnumValue("AL_STORAGE_HARDWARE");
AL_STORAGE_ACCESSIBLE = AL.GetEnumValue("AL_STORAGE_ACCESSIBLE");
Console.WriteLine("RamSize: {0} RamFree: {1} StorageAuto: {2} StorageHW: {3} StorageAccess: {4}",AL_EAX_RAM_SIZE,AL_EAX_RAM_FREE,AL_STORAGE_AUTOMATIC,AL_STORAGE_HARDWARE,AL_STORAGE_ACCESSIBLE);
if ( AL_EAX_RAM_SIZE == 0 ||
AL_EAX_RAM_FREE == 0 ||
AL_STORAGE_AUTOMATIC == 0 ||
AL_STORAGE_HARDWARE == 0 ||
AL_STORAGE_ACCESSIBLE == 0 )
{
Console.WriteLine("Token values could not be retrieved.");
return;
}
Console.WriteLine("Free Ram: {0} / {1}",GetRamFree( ),GetRamSize( ));
try
{
Imported_GetBufferMode = (Delegate_GetBufferMode) Marshal.GetDelegateForFunctionPointer(AL.GetProcAddress("EAXGetBufferMode"),typeof(Delegate_GetBufferMode));
Imported_SetBufferMode = (Delegate_SetBufferMode) Marshal.GetDelegateForFunctionPointer(AL.GetProcAddress("EAXSetBufferMode"),typeof(Delegate_SetBufferMode));
} catch ( Exception e )
{
Console.WriteLine("Attempt to marshal AL.GetProcAddress failed. " + e.ToString( ));
return;
}
_valid = true;
}
#endregion Constructor / Extension Loading
#region Public Methods
/// Query total amount of X-RAM.
public int GetRamSize( )
{
return AL.Get((Enums.ALGetInteger) AL_EAX_RAM_SIZE);
}
/// Query free X-RAM available.
public int GetRamFree( )
{
return AL.Get((Enums.ALGetInteger) AL_EAX_RAM_FREE);
}
public enum XRamStorage : byte
{
/// Put an Open AL Buffer into X-RAM if memory is available, otherwise use host RAM. This is the default mode.
/// alGenBuffers(1, &uiBuffer);
/// eaxSetBufferMode(1, &uiBuffer, alGetEnumValue("AL_STORAGE_AUTOMATIC"));
/// alBufferData(...);
Automatic,
/// Force an Open AL Buffer into X-RAM (good for non-streaming buffers)
// alGenBuffers(1, &uiBuffer);
// eaxSetBufferMode(1, &uiBuffer, alGetEnumValue("AL_STORAGE_HARDWARE"));
// alBufferData(...);
Hardware = 1,
/// Force an Open AL Buffer into 'accessible' (currently host) RAM (good for streaming buffers)
/// alGenBuffers(1, &uiBuffer);
/// eaxSetBufferMode(1, &uiBuffer, alGetEnumValue("AL_STORAGE_ACCESSIBLE"));
/// alBufferData(...);
Acessible = 2,
}
[CLSCompliant(false)]
public void SetBufferMode( int n,ref uint buffer,XRamStorage mode )
{
switch ( mode )
{
case XRamStorage.Acessible:
Imported_SetBufferMode(1,ref buffer,AL_STORAGE_ACCESSIBLE);
break;
case XRamStorage.Hardware:
Imported_SetBufferMode(1,ref buffer,AL_STORAGE_HARDWARE);
break;
default:
Imported_SetBufferMode(1,ref buffer,AL_STORAGE_AUTOMATIC);
break;
}
}
[CLSCompliant(false)]
public XRamStorage GetBufferMode( ref uint buffer )
{
int t; // this is improper, find sample codes using it and figure out what 2nd param does.
return (XRamStorage) Imported_GetBufferMode(buffer,out t);
}
#endregion Public Methods
}
}