recrownedgtk/RecrownedGTK/Graphics/TextureData.cs
Harrison 04f9aab10b Added documentation.
Added more documentation.

Corrected doc.
2020-04-04 18:24:25 -05:00

111 lines
4.3 KiB
C#

using System.Drawing;
using System.IO;
using OpenTK.Graphics.OpenGL;
using OpenTK.Graphics;
using System;
namespace RecrownedGTK.Graphics {
/// <summary>
/// Represents the texture for any given vertice.
/// Contains bytes that form the texture.
/// </summary>
public class TextureData : IDisposable {
private bool disposed;
int handle;
public readonly int width, height;
public TextureWrapMode textureWrapModeWidth, textureWrapModeHeight;
public Color4 borderColor;
public TextureMinFilter textureMinFilter;
public TextureMagFilter textureMagFilter;
/// <summary>
/// Generates a texture data with a png.
/// </summary>
/// <param name="path">A path to a texture represented in PNG format.</param>
public TextureData(string path) {
int width;
int height;
byte[] textureData = LoadPNG(path, out width, out height);
GenerateTexture(textureData, width, height);
}
/// <summary>
/// Generates a texture using a byte array of the texture data.
/// </summary>
/// <param name="textureData">The byte array representing the texture.</param>
/// <param name="width">The width of the texture.</param>
/// <param name="height">The height of the texture.</param>
public TextureData(byte[] textureData, int width, int height) {
textureWrapModeHeight = TextureWrapMode.ClampToBorder;
textureWrapModeWidth = TextureWrapMode.ClampToBorder;
textureMinFilter = TextureMinFilter.LinearMipmapLinear;
textureMagFilter = TextureMagFilter.Linear;
this.width = width;
this.height = height;
GenerateTexture(textureData, width, height);
}
/// <summary>
///Load PNG data to this texture representation.
///
/// Decodes the PNG into a byte array to be stored.
/// </summary>
/// <param name="path">The path to the PNG file to be represented.</param>
/// <param name="width">Outputs the width of the PNG file.</param>
/// <param name="height">Outputs the height of the PNG file.</param>
/// <returns>A byte array representing the PNG.</returns>
private byte[] LoadPNG(string path, out int width, out int height) {
byte[] textureData = null;
using (FileStream file = new FileStream(path, FileMode.Open)) {
using (Bitmap bitmap = new Bitmap(file)) {
ImageConverter converter = new ImageConverter();
textureData = (byte[]) converter.ConvertTo(bitmap, typeof(byte[]));
width = bitmap.Width;
height = bitmap.Height;
}
}
return textureData;
}
/// <summary>
/// Generates a texture in the OpenGL context.
/// </summary>
/// <param name="textureData">Byte array representing the texture.</param>
/// <param name="width">Width of the texture.</param>
/// <param name="height">Height of the texture.</param>
private void GenerateTexture(byte[] textureData, int width, int height) {
if (handle != 0) throw new InvalidOperationException("This texture data already holds a texture.");
handle = GL.GenTexture();
Use();
GL.TexImage2D(TextureTarget.Texture2D, 0, PixelInternalFormat.Rgba, width, height, 0, PixelFormat.Rgba, PixelType.UnsignedByte, textureData);
GL.GenerateMipmap(GenerateMipmapTarget.Texture2D);
}
/// <summary>
/// Binds the OpenGL texture.
/// </summary>
internal void Use() {
GL.BindTexture(TextureTarget.Texture2D, handle);
}
/// <summary>
/// Removes texture data from memory.
/// </summary>
public void Dispose() {
Dispose(true);
GC.SuppressFinalize(this);
}
protected virtual void Dispose(bool disposing) {
if (disposed) return;
if (disposing) {
}
GL.BindTexture(TextureTarget.Texture2D, 0);
GL.DeleteTexture(handle);
disposed = true;
}
~TextureData() {
Dispose(false);
}
}
}