WSHCommon/Common/Library/SharpFont-master/SharpFont/Memory.cs

#region MIT License
/*Copyright (c) 2012 Robert Rouhani <robert.rouhani@gmail.com>

SharpFont based on Tao.FreeType, Copyright (c) 2003-2007 Tao Framework Team

Permission is hereby granted, free of charge, to any person obtaining a copy of
this software and associated documentation files (the "Software"), to deal in
the Software without restriction, including without limitation the rights to
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
of the Software, and to permit persons to whom the Software is furnished to do
so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.*/
#endregion

using System;
using System.Runtime.InteropServices;

using SharpFont.Internal;

namespace SharpFont
{
	/// <summary>
	/// A function used to allocate ‘size’ bytes from ‘memory’.
	/// </summary>
	/// <param name="memory">A handle to the source memory manager.</param>
	/// <param name="size">The size in bytes to allocate.</param>
	/// <returns>Address of new memory block. 0 in case of failure.</returns>
	[UnmanagedFunctionPointer(CallingConvention.Cdecl)]
	public delegate IntPtr AllocFunc([MarshalAs(UnmanagedType.CustomMarshaler, MarshalTypeRef = typeof(MemoryMarshaler))] Memory memory, IntPtr size);

	/// <summary>
	/// A function used to release a given block of memory.
	/// </summary>
	/// <param name="memory">A handle to the source memory manager.</param>
	/// <param name="block">The address of the target memory block.</param>
	[UnmanagedFunctionPointer(CallingConvention.Cdecl)]
	public delegate void FreeFunc([MarshalAs(UnmanagedType.CustomMarshaler, MarshalTypeRef = typeof(MemoryMarshaler))] Memory memory, IntPtr block);

	/// <summary>
	/// A function used to re-allocate a given block of memory.
	/// </summary>
	/// <remarks>
	/// In case of error, the old block must still be available.
	/// </remarks>
	/// <param name="memory">A handle to the source memory manager.</param>
	/// <param name="currentSize">The block's current size in bytes.</param>
	/// <param name="newSize">The block's requested new size.</param>
	/// <param name="block">The block's current address.</param>
	/// <returns>New block address. 0 in case of memory shortage.</returns>
	[UnmanagedFunctionPointer(CallingConvention.Cdecl)]
	public delegate IntPtr ReallocFunc([MarshalAs(UnmanagedType.CustomMarshaler, MarshalTypeRef = typeof(MemoryMarshaler))] Memory memory, IntPtr currentSize, IntPtr newSize, IntPtr block);

	/// <summary>
	/// A structure used to describe a given memory manager to FreeType 2.
	/// </summary>
	public class Memory
	{
		#region Fields

		private IntPtr reference;
		private MemoryRec rec;

		#endregion

		#region Constructors

		internal Memory(IntPtr reference)
		{
			Reference = reference;
		}

		internal Memory(IntPtr reference, IntPtr offset)
			: this(new IntPtr(reference.ToInt64() + offset.ToInt64()))
		{
		}

		#endregion

		#region Properties

		/// <summary>
		/// Gets a generic typeless pointer for user data.
		/// </summary>
		public IntPtr User
		{
			get
			{
				return rec.user;
			}
		}

		/// <summary>
		/// Gets a pointer type to an allocation function.
		/// </summary>
		public AllocFunc Allocate
		{
			get
			{
				return rec.alloc;
			}
		}

		/// <summary>
		/// Gets a pointer type to an memory freeing function.
		/// </summary>
		public FreeFunc Free
		{
			get
			{
				return rec.free;
			}
		}

		/// <summary>
		/// Gets a pointer type to a reallocation function.
		/// </summary>
		public ReallocFunc Reallocate
		{
			get
			{
				return rec.realloc;
			}
		}

		internal IntPtr Reference
		{
			get
			{
				return reference;
			}

			set
			{
				reference = value;
				rec = PInvokeHelper.PtrToStructure<MemoryRec>(reference);
			}
		}

		#endregion
	}
}