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

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,31 +1,39 @@
# Копирование
Функции копирования позволяют скопировать значения координат одного вектора в другой вектор.
[English version / Àíãëèéñêàÿ âåðñèÿ](copy-eng.md)
Функция для **BgcVector2FP32**:
Ôóíêöèè êîïèðîâàíèÿ ïîçâîëÿþò ñêîïèðîâàòü çíà÷åíèÿ êîîðäèíàò îäíîãî âåêòîðà
â äðóãîé âåêòîð.
Ôóíêöèÿ äëÿ **BGC_FP32_Vector2**:
```c
inline void bgc_vector2_copy_fp32(const BgcVector2FP32* from, BgcVector2FP32* to);
inline void bgc_fp32_vector2_copy(BGC_FP32_Vector2* const destination, const BGC_FP32_Vector2* const source);
```
Функция для **BgcVector2FP64**:
Ôóíêöèÿ äëÿ **BGC_FP64_Vector2**:
```c
inline void bgc_vector2_copy_fp64(const BgcVector2FP64* from, BgcVector2FP64* to);
inline void bgc_fp64_vector2_copy(BGC_FP64_Vector2* const destination, const BGC_FP64_Vector2* const source);
```
Каждая из данных функции эквивалентна следующим строкам кода:
```c
to->x1 = from->x1;
to->x2 = from->x2;
destination->x = source->x;
destination->y = source->y;
```
Параметры **from** и **to** не должны быть некорректными указателями. Значение NULL (0) также считается некорректным.
Ïàðàìåòðû **source** è **destination** äîëæíû áûòü êîððåêòíûìè óêàçàòåëÿìè.
Çíà÷åíèå NULL (0) òàêæå ñ÷èòàåòñÿ íåêîððåêòíûì.
Параметр **from** должен быть указателем на двумерный вектор, координаты которого должны быть скопированы. Координаты вектора **from** не изменятся после вызова функции.
Ïàðàìåòð **source** äîëæåí áûòü óêàçàòåëåì íà äâóìåðíûé âåêòîð, êîîðäèíàòû
êîòîðîãî äîëæíû áûòü ñêîïèðîâàíû. Êîîðäèíàòû âåêòîðà **source** íå èçìåíÿòñÿ
ïîñëå âûçîâà ôóíêöèè.
Параметр **to** должен быть указателем на двумерный вектор, координаты которого должны быть изменены. Координаты вектора **to** после вызова функции станут такими же, как и у вектора **from**.
Ïàðàìåòð **destination** äîëæåí áûòü óêàçàòåëåì íà äâóìåðíûé âåêòîð, êîîðäèíàòû
êîòîðîãî äîëæíû áûòü èçìåíåíû. Êîîðäèíàòû âåêòîðà **destination** ïîñëå âûçîâà
ôóíêöèè ñòàíóò òàêèìè æå, êàê è ó âåêòîðà **source**.
Пример применения:
@ -35,13 +43,14 @@ to->x2 = from->x2;
int main()
{
BgcVector2FP32 my_vector1, my_vector2;
BGC_FP32_Vector2 my_vector1, my_vector2;
bgc_vector2_set_values_fp32(-2, 7, &my_vector1);
my_vector1.x = -2.0f;
my_vector1.y = 7.4f;
bgc_vector2_copy_fp32(&my_vector1, &my_vector2);
bgc_fp32_vector2_copy(&my_vector2, &my_vector1);
printf("x1 = %f, x2 = %f\n", my_vector2.x1, my_vector2.x2);
printf("x = %f, y = %f\n", my_vector2.x, my_vector2.y);
return 0;
}