bgc-c/docs/vector3/set-values-rus.md

2.3 KiB
Raw Blame History

Задание координат трёхмерного вектора.

English version / Английская версия

Функция для BGC_FP32_Vector3:

inline void bgc_fp32_vector3_set_values(BGC_FP32_Vector3* const destination, const float x, const float y, const float z);

Функция для BGC_FP64_Vector3:

inline void bgc_fp64_vector3_set_values(BGC_FP64_Vector3* const destination, const double x, const double y, const double z);

Данные функции позволяют задать значения координат вектора одной строкой.

Такая возможность может быть удобна, когда нужно указать значения координат с помощью числовых констант как в примере ниже.

Каждая из функций аналогична следующим трём строкам кода:

destination->x = x;
destination->y = y;
destination->z = z;

Параметры

Параметр Направление Описание
destination исходящий Указатель на вектор, координаты которого будут заданы функцией
x входящий Значение координаты X
y входящий Значение координаты Y
z входящий Значение координаты Z

Параметр destination должен быть корректным указателем. Значение NULL (0) считается некорректным.

Пример

#include <stdio.h>
#include <basic-geometry.h>

int main()
{
    BGC_FP32_Vector3 v;

    bgc_fp32_vector3_set_values(&v, -2.2f, 7.8f, 10.01f);

    printf("x = %f, y = %f, z = %f\n", v.x, v.y, v.z);

    return 0;
}

Документация / Трёхмерные векторы