58 lines
2.3 KiB
Markdown
58 lines
2.3 KiB
Markdown
# Задание координат трёхмерного вектора.
|
||
|
||
[English version / Английская версия](set-values-eng.md)
|
||
|
||
Функция для **BGC_FP32_Vector3**:
|
||
|
||
```c
|
||
inline void bgc_fp32_vector3_set_values(BGC_FP32_Vector3* const destination, const float x, const float y, const float z);
|
||
```
|
||
|
||
Функция для **BGC_FP64_Vector3**:
|
||
|
||
```c
|
||
inline void bgc_fp64_vector3_set_values(BGC_FP64_Vector3* const destination, const double x, const double y, const double z);
|
||
```
|
||
|
||
Данные функции позволяют задать значения координат вектора одной строкой.
|
||
|
||
Такая возможность может быть удобна, когда нужно указать значения координат с помощью числовых констант как в примере ниже.
|
||
|
||
Каждая из функций аналогична следующим трём строкам кода:
|
||
|
||
```c
|
||
destination->x = x;
|
||
destination->y = y;
|
||
destination->z = z;
|
||
```
|
||
|
||
### Параметры
|
||
|
||
| Параметр | Направление | Описание |
|
||
| ----------- | ----------- | -------------------------------------------------------------- |
|
||
| destination | исходящий | Указатель на вектор, координаты которого будут заданы функцией |
|
||
| x | входящий | Значение координаты X |
|
||
| y | входящий | Значение координаты Y |
|
||
| z | входящий | Значение координаты Z |
|
||
|
||
Параметр *destination* должен быть корректным указателем. Значение NULL (0) считается некорректным.
|
||
|
||
### Пример
|
||
|
||
```c
|
||
#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;
|
||
}
|
||
```
|
||
|
||
[Документация](../intro-rus.md) / [Трёхмерные векторы](../vector3-rus.md)
|