HalfType Structure |
Represents a half-precision floating point number.
Namespace: NeoAxis
Assembly: NeoAxis.Core (in NeoAxis.Core.dll) Version: 2024.1.1.0 (2024.1.1.0)
SyntaxC#
[SerializableAttribute] public struct HalfType : IComparable, IFormattable, IConvertible, IComparable<HalfType>, IEquatable<HalfType>
The HalfType type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | HalfType(Decimal) |
Initializes a new instance of System.Half to the value of the specified decimal number.
|
| HalfType(Double) |
Initializes a new instance of System.Half to the value of the specified double-precision floating-point number.
|
| HalfType(Int32) |
Initializes a new instance of System.Half to the value of the specified 32-bit signed integer.
|
| HalfType(Int64) |
Initializes a new instance of System.Half to the value of the specified 64-bit signed integer.
|
| HalfType(Single) |
Initializes a new instance of System.Half to the value of the specified single-precision floating-point number.
|
| HalfType(UInt32) |
Initializes a new instance of System.Half to the value of the specified 32-bit unsigned integer.
|
| HalfType(UInt64) |
Initializes a new instance of System.Half to the value of the specified 64-bit unsigned integer.
|
Methods| Name | Description | |
|---|---|---|
 | Abs |
Returns the absolute value of a half-precision floating-point number.
|
| Add |
Adds two specified System.Half values.
|
| CompareTo(Object) |
Compares this instance to a specified System.Object.
|
| CompareTo(HalfType) |
Compares this instance to a specified System.Half object.
|
| Divide |
Divides two specified System.Half values.
|
| Equals(Object) |
Returns a value indicating whether this instance and a specified System.Object
represent the same type and value.
(Overrides ValueTypeEquals(Object).) |
| Equals(HalfType) |
Returns a value indicating whether this instance and a specified System.Half object represent the same value.
|
| GetBits |
Converts the value of a specified instance of System.Half to its equivalent binary representation.
|
| GetBytes |
Returns the specified half-precision floating point value as an array of bytes.
|
| GetHashCode |
Returns the hash code for this instance.
(Overrides ValueTypeGetHashCode.) |
| GetType | Gets the Type of the current instance. (Inherited from Object.) |
| GetTypeCode |
Returns the System.TypeCode for value type System.Half.
|
| IsInfinity |
Returns a value indicating whether the specified number evaluates to negative or positive infinity.
|
| IsNaN |
Returns a value indicating whether the specified number evaluates to not a number (System.Half.NaN).
|
| IsNegativeInfinity |
Returns a value indicating whether the specified number evaluates to negative infinity.
|
| IsPositiveInfinity |
Returns a value indicating whether the specified number evaluates to positive infinity.
|
| Max |
Returns the larger of two half-precision floating-point numbers.
|
| Min |
Returns the smaller of two half-precision floating-point numbers.
|
| Multiply |
Multiplies two specified System.Half values.
|
| Negate |
Returns the result of multiplying the specified System.Half value by negative one.
|
| Parse(String) |
Converts the string representation of a number to its System.Half equivalent.
|
| Parse(String, NumberStyles) |
Converts the string representation of a number in a specified style to its System.Half equivalent.
|
| Parse(String, IFormatProvider) |
Converts the string representation of a number to its System.Half equivalent
using the specified culture-specific format information.
|
| Parse(String, NumberStyles, IFormatProvider) |
Converts the string representation of a number to its System.Half equivalent
using the specified style and culture-specific format.
|
| Sign |
Returns a value indicating the sign of a half-precision floating-point number.
|
| Subtract |
Subtracts one specified System.Half value from another.
|
| ToHalf(UInt16) |
Returns a half-precision floating point number converted from its binary representation.
|
| ToHalf(Byte, Int32) |
Returns a half-precision floating point number converted from two bytes
at a specified position in a byte array.
|
| ToString |
Converts the numeric value of this instance to its equivalent string representation.
(Overrides ValueTypeToString.) |
| ToString(IFormatProvider) |
Converts the numeric value of this instance to its equivalent string representation
using the specified culture-specific format information.
|
| ToString(String) |
Converts the numeric value of this instance to its equivalent string representation, using the specified format.
|
| ToString(String, IFormatProvider) |
Converts the numeric value of this instance to its equivalent string representation
using the specified format and culture-specific format information.
|
| TryParse(String, HalfType) |
Converts the string representation of a number to its System.Half equivalent.
A return value indicates whether the conversion succeeded or failed.
|
| TryParse(String, NumberStyles, IFormatProvider, HalfType) |
Converts the string representation of a number to its System.Half equivalent
using the specified style and culture-specific format. A return value indicates
whether the conversion succeeded or failed.
|
Operators| Name | Description | |
|---|---|---|
 | Addition |
Adds two specified System.Half values.
|
| Decrement |
Decrements the System.Half operand by one.
|
| Division |
Divides two specified System.Half values.
|
| Equality |
Returns a value indicating whether two instances of System.Half are equal.
|
| (Decimal to HalfType) |
Converts a decimal number to a System.Half.
|
| (Double to HalfType) |
Converts a double-precision floating-point number to a System.Half.
|
| (Single to HalfType) |
Converts a single-precision floating-point number to a System.Half.
|
| (HalfType to Byte) |
Converts a System.Half to an 8-bit unsigned integer.
|
| (HalfType to Char) |
Converts a System.Half to a Unicode character.
|
| (HalfType to Int16) |
Converts a System.Half to a 16-bit signed integer.
|
| (HalfType to Int32) |
Converts a System.Half to a 32-bit signed integer.
|
| (HalfType to Int64) |
Converts a System.Half to a 64-bit signed integer.
|
| (HalfType to Decimal) |
Converts a System.Half to a decimal number.
|
| (HalfType to SByte) |
Converts a System.Half to an 8-bit signed integer.
|
| (HalfType to UInt16) |
Converts a System.Half to a 16-bit unsigned integer.
|
| (HalfType to UInt32) |
Converts a System.Half to a 32-bit unsigned integer.
|
| (HalfType to UInt64) |
Converts a System.Half to a 64-bit unsigned integer.
|
| GreaterThan |
Returns a value indicating whether a specified System.Half is greater than another specified System.Half.
|
| GreaterThanOrEqual |
Returns a value indicating whether a specified System.Half is greater than or equal to another specified System.Half.
|
| (Byte to HalfType) |
Converts an 8-bit unsigned integer to a System.Half.
|
| (Char to HalfType) |
Converts a Unicode character to a System.Half.
|
| (Int16 to HalfType) |
Converts a 16-bit signed integer to a System.Half.
|
| (Int32 to HalfType) |
Converts a 32-bit signed integer to a System.Half.
|
| (Int64 to HalfType) |
Converts a 64-bit signed integer to a System.Half.
|
| (SByte to HalfType) |
Converts an 8-bit signed integer to a System.Half.
|
| (UInt16 to HalfType) |
Converts a 16-bit unsigned integer to a System.Half.
|
| (UInt32 to HalfType) |
Converts a 32-bit unsigned integer to a System.Half.
|
| (UInt64 to HalfType) |
Converts a 64-bit unsigned integer to a System.Half.
|
| (HalfType to Single) |
Converts a System.Half to a single-precision floating-point number.
|
| (HalfType to Double) |
Converts a System.Half to a double-precision floating-point number.
|
| Increment |
Increments the System.Half operand by 1.
|
| Inequality |
Returns a value indicating whether two instances of System.Half are not equal.
|
| LessThan |
Returns a value indicating whether a specified System.Half is less than another specified System.Half.
|
| LessThanOrEqual |
Returns a value indicating whether a specified System.Half is less than or equal to another specified System.Half.
|
| Multiply |
Multiplies two specified System.Half values.
|
| Subtraction |
Subtracts two specified System.Half values.
|
| UnaryNegation |
Negates the value of the specified System.Half operand.
|
| UnaryPlus |
Returns the value of the System.Half operand (the sign of the operand is unchanged).
|
Fields| Name | Description | |
|---|---|---|
 | Epsilon |
Represents the smallest positive System.Half value greater than zero. This field is constant.
|
| MaxValue |
Represents the largest possible value of System.Half. This field is constant.
|
| MinValue |
Represents the smallest possible value of System.Half. This field is constant.
|
| NaN |
Represents not a number (NaN). This field is constant.
|
| NegativeInfinity |
Represents negative infinity. This field is constant.
|
| One | |
| PositiveInfinity |
Represents positive infinity. This field is constant.
|
| Zero |
Extension Methods| Name | Description | |
|---|---|---|
 | MethodInvoke |
Calls the object method by name.
(Defined by ObjectEx.) |
| PropertyGet(String, Object, Boolean) | Overloaded.
Gets the value of the object property by name.
(Defined by ObjectEx.) |
| PropertyGetT(String, Object, Boolean) | Overloaded.
Gets the value of the object property by name.
(Defined by ObjectEx.) |
| PropertySet |
Sets the value of the object property by name.
(Defined by ObjectEx.) |
Remarks
Note:
Half is not fast enought and precision is also very bad,
so is should not be used for mathematical computation (use Single instead).
The main advantage of Half type is lower memory cost: two bytes per number.
Half is typically used in graphical applications.
Note:
All functions, where is used conversion half->float/float->half,
are approx. ten times slower than float->double/double->float, i.e. ~3ns on 2GHz CPU.
References:
- Code retrieved from http://sourceforge.net/p/csharp-half/code/HEAD/tree/ on 2015-12-04
- Fast Half Float Conversions, Jeroen van der Zijp, link: http://www.fox-toolkit.org/ftp/fasthalffloatconversion.pdf
- IEEE 754 revision, link: http://grouper.ieee.org/groups/754/
See Also