Обновление документации по векторам и кватернионам

This commit is contained in:
Andrey Pokidov 2026-03-30 01:05:57 +07:00
parent 2fd2578bb3
commit 460fe94830
20 changed files with 237 additions and 138 deletions

View file

@ -1,27 +1,35 @@
# Задание координат двумерного вектора
Задавать координаты векторов можно как напрямую, так и спомощью функций. Функции задания значений координат позволяют сделать это одной строкой.
[English version / Àíãëèéñêàÿ âåðñèÿ](set-values-eng.md)
Функция для **BgcVector2FP32**:
Çàäàâàòü êîîðäèíàòû âåêòîðîâ ìîæíî êàê íàïðÿìóþ, òàê è ñïîìîùüþ ôóíêöèé. Ôóíêöèè
çàäàíèÿ çíà÷åíèé êîîðäèíàò ïîçâîëÿþò ñäåëàòü ýòî îäíîé ñòðîêîé.
Ôóíêöèÿ äëÿ **BGC_FP32_Vector2**:
```c
inline void bgc_vector2_set_values_fp32(const float x1, const float x2, BgcVector2FP32* to);
inline void bgc_fp32_vector2_set_values(BGC_FP32_Vector2* const destination, const float x, const float y);
```
Функция для **BgcVector2FP32**:
Ôóíêöèÿ äëÿ **BGC_FP64_Vector2**:
```c
inline void bgc_vector2_set_values_fp64(const double x1, const double x2, BgcVector2FP64* to);
inline void bgc_fp64_vector2_set_values(BGC_FP64_Vector2* const destination, const double x, const double y);
```
Каждая из данных функции эквивалентна следующим строкам кода:
```c
to->x1 = x1;
to->x2 = x2;
destination->x = x;
destination->y = y;
```
В параметре **to** не следует передавать некорректные указатели. Значение NULL (0) также считается некорректным.
 ïàðàìåòðå **destination** ñëåäóåò ïåðåäàâàòü êîððåêòíûå óêàçàòåëè.
Çíà÷åíèå NULL (0) ñ÷èòàåòñÿ íåêîððåêòíûì.
Äàííàÿ ôóíêöèÿ õîðîøî ïîäõîäèò äëÿ çàäàíÿ çíà÷åíèé êîîðäèíàò âåêòîðà îäíîé
ñòðîêîé. Îñîáåííî åñëè íàäî óêàçàòü ôèêñèðîâàííûå çíà÷åíèÿ êîîðäèíàò êàê
â ïðèìåðå íèæå.
Пример применения:
@ -31,11 +39,11 @@ to->x2 = x2;
int main()
{
BgcVector2FP32 my_vector;
BGC_FP32_Vector2 my_vector;
bgc_vector2_set_values_fp32(-2, 7, &my_vector);
bgc_fp32_vector2_set_values(&my_vector, -2.2f, 7.1f);
printf("x1 = %f, x2 = %f\n", my_vector.x1, my_vector.x2);
printf("x = %f, y = %f\n", my_vector.x, my_vector.y);
return 0;
}