mirror of https://github.com/SixLabors/ImageSharp
James Jackson-South
9 years ago
4 changed files with 503 additions and 159 deletions
@ -0,0 +1,398 @@ |
|||||
|
// <copyright file="Rgba32.cs" company="James Jackson-South">
|
||||
|
// Copyright (c) James Jackson-South and contributors.
|
||||
|
// Licensed under the Apache License, Version 2.0.
|
||||
|
// </copyright>
|
||||
|
|
||||
|
namespace ImageSharp |
||||
|
{ |
||||
|
using System.Numerics; |
||||
|
using System.Runtime.CompilerServices; |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Packed pixel type containing four 8-bit unsigned normalized values ranging from 0 to 255.
|
||||
|
/// The color components are stored in red, green, blue, and alpha order.
|
||||
|
/// </summary>
|
||||
|
/// <remarks>
|
||||
|
/// This struct is fully mutable. This is done (against the guidelines) for the sake of performance,
|
||||
|
/// as it avoids the need to create new values for modification operations.
|
||||
|
/// </remarks>
|
||||
|
public struct Rgba32 : IPixel<Rgba32>, IPackedVector<uint> |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// The shift count for the red component
|
||||
|
/// </summary>
|
||||
|
private const int RedShift = 0; |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// The shift count for the green component
|
||||
|
/// </summary>
|
||||
|
private const int GreenShift = 8; |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// The shift count for the blue component
|
||||
|
/// </summary>
|
||||
|
private const int BlueShift = 16; |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// The shift count for the alpha component
|
||||
|
/// </summary>
|
||||
|
private const int AlphaShift = 24; |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// The maximum byte value.
|
||||
|
/// </summary>
|
||||
|
private static readonly Vector4 MaxBytes = new Vector4(255); |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// The half vector value.
|
||||
|
/// </summary>
|
||||
|
private static readonly Vector4 Half = new Vector4(0.5F); |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// The packed value.
|
||||
|
/// </summary>
|
||||
|
private uint packedValue; |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Initializes a new instance of the <see cref="Rgba32"/> struct.
|
||||
|
/// </summary>
|
||||
|
/// <param name="r">The red component.</param>
|
||||
|
/// <param name="g">The green component.</param>
|
||||
|
/// <param name="b">The blue component.</param>
|
||||
|
/// <param name="a">The alpha component.</param>
|
||||
|
public Rgba32(byte r, byte g, byte b, byte a = 255) |
||||
|
{ |
||||
|
this.packedValue = Pack(r, g, b, a); |
||||
|
} |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Initializes a new instance of the <see cref="Rgba32"/> struct.
|
||||
|
/// </summary>
|
||||
|
/// <param name="r">The red component.</param>
|
||||
|
/// <param name="g">The green component.</param>
|
||||
|
/// <param name="b">The blue component.</param>
|
||||
|
/// <param name="a">The alpha component.</param>
|
||||
|
public Rgba32(float r, float g, float b, float a = 1) |
||||
|
{ |
||||
|
this.packedValue = Pack(r, g, b, a); |
||||
|
} |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Initializes a new instance of the <see cref="Rgba32"/> struct.
|
||||
|
/// </summary>
|
||||
|
/// <param name="vector">
|
||||
|
/// The vector containing the components for the packed vector.
|
||||
|
/// </param>
|
||||
|
public Rgba32(Vector3 vector) |
||||
|
{ |
||||
|
this.packedValue = Pack(ref vector); |
||||
|
} |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Initializes a new instance of the <see cref="Rgba32"/> struct.
|
||||
|
/// </summary>
|
||||
|
/// <param name="vector">
|
||||
|
/// The vector containing the components for the packed vector.
|
||||
|
/// </param>
|
||||
|
public Rgba32(Vector4 vector) |
||||
|
{ |
||||
|
this.packedValue = Pack(ref vector); |
||||
|
} |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Initializes a new instance of the <see cref="Rgba32"/> struct.
|
||||
|
/// </summary>
|
||||
|
/// <param name="packed">
|
||||
|
/// The packed value.
|
||||
|
/// </param>
|
||||
|
public Rgba32(uint packed) |
||||
|
{ |
||||
|
this.packedValue = packed; |
||||
|
} |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Gets or sets the red component.
|
||||
|
/// </summary>
|
||||
|
public byte R |
||||
|
{ |
||||
|
[MethodImpl(MethodImplOptions.AggressiveInlining)] |
||||
|
get |
||||
|
{ |
||||
|
return (byte)(this.packedValue >> RedShift); |
||||
|
} |
||||
|
|
||||
|
[MethodImpl(MethodImplOptions.AggressiveInlining)] |
||||
|
set |
||||
|
{ |
||||
|
this.packedValue = this.packedValue & 0xFFFFFF00 | (uint)value << RedShift; |
||||
|
} |
||||
|
} |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Gets or sets the green component.
|
||||
|
/// </summary>
|
||||
|
public byte G |
||||
|
{ |
||||
|
[MethodImpl(MethodImplOptions.AggressiveInlining)] |
||||
|
get |
||||
|
{ |
||||
|
return (byte)(this.packedValue >> GreenShift); |
||||
|
} |
||||
|
|
||||
|
[MethodImpl(MethodImplOptions.AggressiveInlining)] |
||||
|
set |
||||
|
{ |
||||
|
this.packedValue = this.packedValue & 0xFFFF00FF | (uint)value << GreenShift; |
||||
|
} |
||||
|
} |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Gets or sets the blue component.
|
||||
|
/// </summary>
|
||||
|
public byte B |
||||
|
{ |
||||
|
[MethodImpl(MethodImplOptions.AggressiveInlining)] |
||||
|
get |
||||
|
{ |
||||
|
return (byte)(this.packedValue >> BlueShift); |
||||
|
} |
||||
|
|
||||
|
[MethodImpl(MethodImplOptions.AggressiveInlining)] |
||||
|
set |
||||
|
{ |
||||
|
this.packedValue = this.packedValue & 0xFF00FFFF | (uint)value << BlueShift; |
||||
|
} |
||||
|
} |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Gets or sets the alpha component.
|
||||
|
/// </summary>
|
||||
|
public byte A |
||||
|
{ |
||||
|
[MethodImpl(MethodImplOptions.AggressiveInlining)] |
||||
|
get |
||||
|
{ |
||||
|
return (byte)(this.packedValue >> AlphaShift); |
||||
|
} |
||||
|
|
||||
|
[MethodImpl(MethodImplOptions.AggressiveInlining)] |
||||
|
set |
||||
|
{ |
||||
|
this.packedValue = this.packedValue & 0x00FFFFFF | (uint)value << AlphaShift; |
||||
|
} |
||||
|
} |
||||
|
|
||||
|
/// <inheritdoc/>
|
||||
|
public uint PackedValue |
||||
|
{ |
||||
|
get => this.packedValue; |
||||
|
|
||||
|
set => this.packedValue = value; |
||||
|
} |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Compares two <see cref="Rgba32"/> objects for equality.
|
||||
|
/// </summary>
|
||||
|
/// <param name="left">
|
||||
|
/// The <see cref="Rgba32"/> on the left side of the operand.
|
||||
|
/// </param>
|
||||
|
/// <param name="right">
|
||||
|
/// The <see cref="Rgba32"/> on the right side of the operand.
|
||||
|
/// </param>
|
||||
|
/// <returns>
|
||||
|
/// True if the <paramref name="left"/> parameter is equal to the <paramref name="right"/> parameter; otherwise, false.
|
||||
|
/// </returns>
|
||||
|
[MethodImpl(MethodImplOptions.AggressiveInlining)] |
||||
|
public static bool operator ==(Rgba32 left, Rgba32 right) |
||||
|
{ |
||||
|
return left.packedValue == right.packedValue; |
||||
|
} |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Compares two <see cref="Rgba32"/> objects for equality.
|
||||
|
/// </summary>
|
||||
|
/// <param name="left">The <see cref="Rgba32"/> on the left side of the operand.</param>
|
||||
|
/// <param name="right">The <see cref="Rgba32"/> on the right side of the operand.</param>
|
||||
|
/// <returns>
|
||||
|
/// True if the <paramref name="left"/> parameter is not equal to the <paramref name="right"/> parameter; otherwise, false.
|
||||
|
/// </returns>
|
||||
|
[MethodImpl(MethodImplOptions.AggressiveInlining)] |
||||
|
public static bool operator !=(Rgba32 left, Rgba32 right) |
||||
|
{ |
||||
|
return left.packedValue != right.packedValue; |
||||
|
} |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Creates a new instance of the <see cref="Rgba32"/> struct.
|
||||
|
/// </summary>
|
||||
|
/// <param name="hex">
|
||||
|
/// The hexadecimal representation of the combined color components arranged
|
||||
|
/// in rgb, rgba, rrggbb, or rrggbbaa format to match web syntax.
|
||||
|
/// </param>
|
||||
|
/// <returns>
|
||||
|
/// The <see cref="Rgba32"/>.
|
||||
|
/// </returns>
|
||||
|
public static Rgba32 FromHex(string hex) |
||||
|
{ |
||||
|
return ColorBuilder<Rgba32>.FromHex(hex); |
||||
|
} |
||||
|
|
||||
|
/// <inheritdoc />
|
||||
|
public BulkPixelOperations<Rgba32> CreateBulkOperations() => new BulkPixelOperations<Rgba32>(); |
||||
|
|
||||
|
/// <inheritdoc/>
|
||||
|
[MethodImpl(MethodImplOptions.AggressiveInlining)] |
||||
|
public void PackFromBytes(byte x, byte y, byte z, byte w) |
||||
|
{ |
||||
|
this.packedValue = Pack(x, y, z, w); |
||||
|
} |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Converts the value of this instance to a hexadecimal string.
|
||||
|
/// </summary>
|
||||
|
/// <returns>A hexadecimal string representation of the value.</returns>
|
||||
|
public string ToHex() |
||||
|
{ |
||||
|
uint hexOrder = Pack(this.A, this.B, this.G, this.R); |
||||
|
return hexOrder.ToString("X8"); |
||||
|
} |
||||
|
|
||||
|
/// <inheritdoc/>
|
||||
|
[MethodImpl(MethodImplOptions.AggressiveInlining)] |
||||
|
public void ToXyzBytes(byte[] bytes, int startIndex) |
||||
|
{ |
||||
|
bytes[startIndex] = this.R; |
||||
|
bytes[startIndex + 1] = this.G; |
||||
|
bytes[startIndex + 2] = this.B; |
||||
|
} |
||||
|
|
||||
|
/// <inheritdoc/>
|
||||
|
[MethodImpl(MethodImplOptions.AggressiveInlining)] |
||||
|
public void ToXyzwBytes(byte[] bytes, int startIndex) |
||||
|
{ |
||||
|
bytes[startIndex] = this.R; |
||||
|
bytes[startIndex + 1] = this.G; |
||||
|
bytes[startIndex + 2] = this.B; |
||||
|
bytes[startIndex + 3] = this.A; |
||||
|
} |
||||
|
|
||||
|
/// <inheritdoc/>
|
||||
|
[MethodImpl(MethodImplOptions.AggressiveInlining)] |
||||
|
public void ToZyxBytes(byte[] bytes, int startIndex) |
||||
|
{ |
||||
|
bytes[startIndex] = this.B; |
||||
|
bytes[startIndex + 1] = this.G; |
||||
|
bytes[startIndex + 2] = this.R; |
||||
|
} |
||||
|
|
||||
|
/// <inheritdoc/>
|
||||
|
[MethodImpl(MethodImplOptions.AggressiveInlining)] |
||||
|
public void ToZyxwBytes(byte[] bytes, int startIndex) |
||||
|
{ |
||||
|
bytes[startIndex] = this.B; |
||||
|
bytes[startIndex + 1] = this.G; |
||||
|
bytes[startIndex + 2] = this.R; |
||||
|
bytes[startIndex + 3] = this.A; |
||||
|
} |
||||
|
|
||||
|
/// <inheritdoc/>
|
||||
|
[MethodImpl(MethodImplOptions.AggressiveInlining)] |
||||
|
public void PackFromVector4(Vector4 vector) |
||||
|
{ |
||||
|
this.packedValue = Pack(ref vector); |
||||
|
} |
||||
|
|
||||
|
/// <inheritdoc/>
|
||||
|
[MethodImpl(MethodImplOptions.AggressiveInlining)] |
||||
|
public Vector4 ToVector4() |
||||
|
{ |
||||
|
return new Vector4(this.R, this.G, this.B, this.A) / MaxBytes; |
||||
|
} |
||||
|
|
||||
|
/// <inheritdoc/>
|
||||
|
public override bool Equals(object obj) |
||||
|
{ |
||||
|
return (obj is Rgba32) && this.Equals((Rgba32)obj); |
||||
|
} |
||||
|
|
||||
|
/// <inheritdoc/>
|
||||
|
[MethodImpl(MethodImplOptions.AggressiveInlining)] |
||||
|
public bool Equals(Rgba32 other) |
||||
|
{ |
||||
|
return this.packedValue == other.packedValue; |
||||
|
} |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Gets a string representation of the packed vector.
|
||||
|
/// </summary>
|
||||
|
/// <returns>A string representation of the packed vector.</returns>
|
||||
|
public override string ToString() |
||||
|
{ |
||||
|
return this.ToVector4().ToString(); |
||||
|
} |
||||
|
|
||||
|
/// <inheritdoc/>
|
||||
|
public override int GetHashCode() |
||||
|
{ |
||||
|
return this.packedValue.GetHashCode(); |
||||
|
} |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Packs a <see cref="Vector4"/> into a uint.
|
||||
|
/// </summary>
|
||||
|
/// <param name="vector">The vector containing the values to pack.</param>
|
||||
|
/// <returns>The <see cref="uint"/> containing the packed values.</returns>
|
||||
|
[MethodImpl(MethodImplOptions.AggressiveInlining)] |
||||
|
private static uint Pack(ref Vector4 vector) |
||||
|
{ |
||||
|
vector *= MaxBytes; |
||||
|
vector += Half; |
||||
|
vector = Vector4.Clamp(vector, Vector4.Zero, MaxBytes); |
||||
|
return (uint)(((byte)vector.X << RedShift) |
||||
|
| ((byte)vector.Y << GreenShift) |
||||
|
| ((byte)vector.Z << BlueShift) |
||||
|
| (byte)vector.W << AlphaShift); |
||||
|
} |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Packs a <see cref="Vector3"/> into a uint.
|
||||
|
/// </summary>
|
||||
|
/// <param name="vector">The vector containing the values to pack.</param>
|
||||
|
/// <returns>The <see cref="uint"/> containing the packed values.</returns>
|
||||
|
[MethodImpl(MethodImplOptions.AggressiveInlining)] |
||||
|
private static uint Pack(ref Vector3 vector) |
||||
|
{ |
||||
|
Vector4 value = new Vector4(vector, 1); |
||||
|
return Pack(ref value); |
||||
|
} |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Packs the four floats into a <see cref="uint"/>.
|
||||
|
/// </summary>
|
||||
|
/// <param name="x">The x-component</param>
|
||||
|
/// <param name="y">The y-component</param>
|
||||
|
/// <param name="z">The z-component</param>
|
||||
|
/// <param name="w">The w-component</param>
|
||||
|
/// <returns>The <see cref="uint"/></returns>
|
||||
|
[MethodImpl(MethodImplOptions.AggressiveInlining)] |
||||
|
private static uint Pack(float x, float y, float z, float w) |
||||
|
{ |
||||
|
Vector4 value = new Vector4(x, y, z, w); |
||||
|
return Pack(ref value); |
||||
|
} |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Packs the four floats into a <see cref="uint"/>.
|
||||
|
/// </summary>
|
||||
|
/// <param name="x">The x-component</param>
|
||||
|
/// <param name="y">The y-component</param>
|
||||
|
/// <param name="z">The z-component</param>
|
||||
|
/// <param name="w">The w-component</param>
|
||||
|
/// <returns>The <see cref="uint"/></returns>
|
||||
|
[MethodImpl(MethodImplOptions.AggressiveInlining)] |
||||
|
private static uint Pack(byte x, byte y, byte z, byte w) |
||||
|
{ |
||||
|
return (uint)(x << RedShift | y << GreenShift | z << BlueShift | w << AlphaShift); |
||||
|
} |
||||
|
} |
||||
|
} |
||||
Loading…
Reference in new issue