Функция XMUDECN4::XMUDECN4(float,float,float,float) (directxpackedvector.h)

Статья
08/23/2023

Этот конструктор инициализирует новый экземпляр XMUDECN4 из четырех нормализованных float аргументов.

Примечание Этот конструктор доступен только в C++.

Синтаксис

void XMUDECN4(
  float _x,
  float _y,
  float _z,
  float _w
) noexcept;

Параметры

_x

Нормализованное значение координаты X вектора.

Этот аргумент должен находиться в диапазоне от 0,0 до 1,0; во время создания экземпляра XMUDECN4он умножается на 1023.0f , а затем сохраняется как элемент x структуры.

_y

Нормализованное значение для координаты Y вектора, y нового экземпляра XMUDECN4.

Этот аргумент должен находиться в диапазоне от 0,0 до 1,0; во время создания экземпляра XMUDECN4он умножается на 1023.0f и сохраняется как элемент y структуры.

_z

Нормализованное значение координаты z вектора, z нового экземпляра XMUDECN4.

Этот аргумент должен находиться в диапазоне от 0,0 до 1,0; во время создания экземпляра XMUDECN4он умножается на 1023.0f , а затем сохраняется как элемент z структуры.

_w

Нормализованное значение w-координаты вектора, w нового экземпляра XMUDECN4.

Этот аргумент должен находиться в диапазоне от -1,0 до 1,0; во время создания экземпляра XMCOLOR он умножается на 3.0f и сохраняется как w-член структуры.

Возвращаемое значение

None

Remarks

Все входные значения, _x, _y, _z и _w зажаты в диапазоне от -1,0 до 1,0.

Следующий псевдокод демонстрирует работу этого конструктора, который использует преимущества union четырех компонентов вектора XMDECN4 с экземпляром uint32_t в определении структуры:


    	XMDECN4 instance;
	_x1=min( max( _x, 0.0 ), 1.0 );
	_y1=min( max( _y, 0.0 ), 1.0 );
	_z1=min( max( _z, 0.0 ), 1.0 );
	_w1=min( max( _w, 0.0 ), 1.0 );
	_x = round( _x *  1023.0f);
	_y = round( _y *  1023.0f);
	_z = round( _z *  1023.0f);
	_w = round( _w *  3.0f);

	instance.v =  ( (uint32_t)_w1 << 30) |
                      (((uint32_t)_z1 & 0x3FF) << 20) |
                      (((uint32_t)_y1 & 0x3FF) << 10) |
                      (((uint32_t)_x1 & 0x3FF));

Требования


Целевая платформа	Windows
Header	directxpackedvector.h

См. также раздел

Справочные материалы

XMUDECN4

Конструкторы XMUDECN4

Поделиться через