// Copyright (c) 2010-2014 SharpDX - Alexandre Mutel
//
// 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.
using System;
using System.Globalization;
using System.Runtime.CompilerServices;
using System.Runtime.InteropServices;
using SharpDX.Mathematics.Interop;
namespace SharpDX
{
///
/// Represents a four dimensional mathematical vector of bool (32 bits per bool value).
///
[StructLayout(LayoutKind.Sequential, Pack = 4)]
public struct Bool4 : IEquatable, IFormattable
{
///
/// The size of the type, in bytes.
///
public static readonly int SizeInBytes = Utilities.SizeOf();
///
/// A with all of its components set to false.
///
public static readonly Bool4 False = new Bool4();
///
/// The X unit (true, 0, 0, 0).
///
public static readonly Bool4 UnitX = new Bool4(true, false, false, false);
///
/// The Y unit (0, true, 0, 0).
///
public static readonly Bool4 UnitY = new Bool4(false, true, false, false);
///
/// The Z unit (0, 0, true, 0).
///
public static readonly Bool4 UnitZ = new Bool4(false, false, true, false);
///
/// The W unit (0, 0, 0, true).
///
public static readonly Bool4 UnitW = new Bool4(false, false, false, true);
///
/// A with all of its components set to true.
///
public static readonly Bool4 One = new Bool4(true, true, true, true);
///
/// The X component of the vector.
///
internal int iX;
///
/// The Y component of the vector.
///
internal int iY;
///
/// The Z component of the vector.
///
internal int iZ;
///
/// The W component of the vector.
///
internal int iW;
///
/// The X component of the vector.
///
public bool X
{
get
{
return iX != 0;
}
set
{
iX = value ? 1 : 0;
}
}
///
/// The Y component of the vector.
///
public bool Y
{
get
{
return iY != 0;
}
set
{
iY = value ? 1 : 0;
}
}
///
/// The Z component of the vector.
///
public bool Z
{
get
{
return iZ != 0;
}
set
{
iZ = value ? 1 : 0;
}
}
///
/// The W component of the vector.
///
public bool W
{
get
{
return iW != 0;
}
set
{
iW = value ? 1 : 0;
}
}
///
/// Initializes a new instance of the struct.
///
/// The value that will be assigned to all components.
public Bool4(bool value)
{
iX = value ? 1 : 0;
iY = value ? 1 : 0;
iZ = value ? 1 : 0;
iW = value ? 1 : 0;
}
///
/// Initializes a new instance of the struct.
///
/// Initial value for the X component of the vector.
/// Initial value for the Y component of the vector.
/// Initial value for the Z component of the vector.
/// Initial value for the W component of the vector.
public Bool4(bool x, bool y, bool z, bool w)
{
iX = x ? 1 : 0;
iY = y ? 1 : 0;
iZ = z ? 1 : 0;
iW = w ? 1 : 0;
}
///
/// Initializes a new instance of the struct.
///
/// The values to assign to the X, Y, Z, and W components of the vector. This must be an array with four elements.
/// Thrown when is null.
/// Thrown when contains more or less than four elements.
public Bool4(bool[] values)
{
if (values == null)
throw new ArgumentNullException("values");
if (values.Length != 4)
throw new ArgumentOutOfRangeException(
"values",
"There must be four and only four input values for Bool4.");
iX = values[0] ? 1 : 0;
iY = values[1] ? 1 : 0;
iZ = values[2] ? 1 : 0;
iW = values[3] ? 1 : 0;
}
///
/// Gets or sets the component at the specified index.
///
/// The value of the X, Y, Z, or W component, depending on the index.
/// The index of the component to access. Use 0 for the X component, 1 for the Y component, 2 for the Z component, and 3 for the W component.
/// The value of the component at the specified index.
/// Thrown when the is out of the range [0, 3].
public bool this[int index]
{
get
{
switch (index)
{
case 0:
return X;
case 1:
return Y;
case 2:
return Z;
case 3:
return W;
}
throw new ArgumentOutOfRangeException("index", "Indices for Bool4 run from 0 to 3, inclusive.");
}
set
{
switch (index)
{
case 0:
X = value;
break;
case 1:
Y = value;
break;
case 2:
Z = value;
break;
case 3:
W = value;
break;
default:
throw new ArgumentOutOfRangeException("index", "Indices for Bool4 run from 0 to 3, inclusive.");
}
}
}
///
/// Creates an array containing the elements of the vector.
///
/// A four-element array containing the components of the vector.
public bool[] ToArray()
{
return new bool[] {X, Y, Z, W};
}
///
/// Tests for equality between two objects.
///
/// The first value to compare.
/// The second value to compare.
/// true if has the same value as ; otherwise, false.
[MethodImpl((MethodImplOptions)0x100)] // MethodImplOptions.AggressiveInlining
public static bool operator ==(Bool4 left, Bool4 right)
{
return left.Equals(ref right);
}
///
/// Tests for inequality between two objects.
///
/// The first value to compare.
/// The second value to compare.
/// true if has a different value than ; otherwise, false.
[MethodImpl((MethodImplOptions)0x100)] // MethodImplOptions.AggressiveInlining
public static bool operator !=(Bool4 left, Bool4 right)
{
return !left.Equals(ref right);
}
///
/// Returns a that represents this instance.
///
///
/// A that represents this instance.
///
public override string ToString()
{
return string.Format(CultureInfo.CurrentCulture, "X:{0} Y:{1} Z:{2} W:{3}", X, Y, Z, W);
}
///
/// Returns a that represents this instance.
///
/// The format.
/// The format provider.
///
/// A that represents this instance.
///
public string ToString(string format, IFormatProvider formatProvider)
{
return string.Format(formatProvider, format, X, Y, Z, W);
}
///
/// Returns a hash code for this instance.
///
///
/// A hash code for this instance, suitable for use in hashing algorithms and data structures like a hash table.
///
public override int GetHashCode()
{
unchecked
{
var hashCode = iX;
hashCode = (hashCode * 397) ^ iY;
hashCode = (hashCode * 397) ^ iZ;
hashCode = (hashCode * 397) ^ iW;
return hashCode;
}
}
///
/// Determines whether the specified is equal to this instance.
///
/// The to compare with this instance.
///
/// true if the specified is equal to this instance; otherwise, false.
///
[MethodImpl((MethodImplOptions)0x100)] // MethodImplOptions.AggressiveInlining
public bool Equals(ref Bool4 other)
{
return other.X == X && other.Y == Y && other.Z == Z && other.W == W;
}
///
/// Determines whether the specified is equal to this instance.
///
/// The to compare with this instance.
///
/// true if the specified is equal to this instance; otherwise, false.
///
[MethodImpl((MethodImplOptions)0x100)] // MethodImplOptions.AggressiveInlining
public bool Equals(Bool4 other)
{
return Equals(ref other);
}
///
/// Determines whether the specified is equal to this instance.
///
/// The to compare with this instance.
///
/// true if the specified is equal to this instance; otherwise, false.
///
public override bool Equals(object value)
{
if (!(value is Bool4))
return false;
var strongValue = (Bool4)value;
return Equals(ref strongValue);
}
///
/// Performs an implicit conversion from array to .
///
/// The input.
/// The result of the conversion.
public static implicit operator Bool4(bool[] input)
{
return new Bool4(input);
}
///
/// Performs an implicit conversion from to array.
///
/// The input.
/// The result of the conversion.
public static implicit operator bool[](Bool4 input)
{
return input.ToArray();
}
///
/// Performs an implicit conversion from to .
///
/// The value.
/// The result of the conversion.
public unsafe static implicit operator RawBool4(Bool4 value)
{
return *(RawBool4*)&value;
}
///
/// Performs an implicit conversion from to .
///
/// The value.
/// The result of the conversion.
public unsafe static implicit operator Bool4(RawBool4 value)
{
return *(Bool4*)&value;
}
}
}