Skip to content
Chuck Walbourn edited this page Jan 21, 2022 · 9 revisions
DirectXTK SimpleMath

Four component color vector class modeled after the XNA Game Studio 4 (Microsoft.Xna.Framework.Color) math library.

Header

#include <SimpleMath.h>

Initialization

using namespace DirectX::SimpleMath;

Color c;                      // Creates opaque black
Color c(1, 1, 1);             // Creates opaque white
Color c(1, 1, 1, 0.5f);       // Creates white with 50% alpha (straight-alpha)
Color c( Vector3(1,1,1) );    // Creates opaque white
Color c( Vector4(1,1,1,0.5f); // Creates white with 50% alpha (straight-alpha)

float arr[4] = { 1, 1, 1, 1 };
Color c(arr);                  // Creates opaque white

Fields

  • x is the red component of the color
  • y is the green component of the color
  • z is the blue component of the color
  • w is the alpha component of the color

Properties

  • R: Red component
  • G: Green component
  • B: Blue component
  • A: Alpha component

Methods

  • Comparison operators: == and !=
  • Assignment operators: =, +=, -=, *=, /=
  • Unary operators: +, -
  • Binary operators: +, -, *, /
  • BGRA: Converts to a DirectX::PackedVector::XMCOLOR Direct3D 9 style color equivalent to D3DCOLOR.
  • RGBA: Converts to a DirectX::PackedVector::XMUBYTEN4 XNA Game Studio style packed color
  • ToVector3
  • ToVector4
  • Negate: Negates or inverses the color. The result is Color( 1 - x, 1 - y, 1 - z, w ).
  • Saturate: Clamps the color to the 0 to 1 range
  • Premultiply: Converts straight-alpha color to premultiplied alpha
  • AdjustSaturation: A parameter of 0 returns the grey-scale of the color, 1 returns the original color
  • AdjustContrast: A parameter of 0 returns 50% grey of the color, 1 returns the original color

Statics

  • Modulate: Blends two colors together
  • Lerp: Linearly interpolates between two colors

Remark

Color can freely convert to and from a XMFLOAT4 and XMVECTOR

When assigning a color from DirectXColors.h to a Color, use the .v union element

Color color = Colors::White.v;

Color can be copy and assigned from DirectX::PackedVector::XMCOLOR (BGRA Direct3D 9 D3DCOLOR packed color) and DirectX::PackedVector::XMUBYTEN4 (RGBA XNA Game Studio packed color).

Color component values can exceed the 0 to 1 range for High Dynamic Range (HDR) lighting. Alpha values greater than 1 typically don't have a valid meaning.

For Use

  • Universal Windows Platform apps
  • Windows desktop apps
  • Windows 11
  • Windows 10
  • Windows 8.1
  • Windows 7 Service Pack 1
  • Xbox One

Architecture

  • x86
  • x64
  • ARM64

For Development

  • Visual Studio 2022
  • Visual Studio 2019 (16.11)
  • clang/LLVM v12 - v18
  • MinGW 12.2, 13.2
  • CMake 3.20

Related Projects

DirectX Tool Kit for DirectX 12

DirectXMesh

DirectXTex

DirectXMath

Win2D

Tools

Test Suite

Model Viewer

Content Exporter

DxCapsViewer

Clone this wiki locally