59 lines
1.7 KiB
Markdown
59 lines
1.7 KiB
Markdown
# Setting the coordinates of a three-dimensional vector
|
|
|
|
[Русская версия / Russian version](set-values-rus.md)
|
|
|
|
The function for **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);
|
|
```
|
|
|
|
The function for **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);
|
|
```
|
|
|
|
These functions allow to set the values of coordinates in one-line.
|
|
|
|
The functions are especially useful when the values are constants like in the example below.
|
|
|
|
Each of these functions is equivalent to the following lines of code:
|
|
|
|
```c
|
|
destination->x = x;
|
|
destination->y = y;
|
|
destination->z = z;
|
|
```
|
|
|
|
### Parameters
|
|
|
|
| Parameter | Direction | Description |
|
|
| ----------- | --------- | ------------------------------------------------------- |
|
|
| destination | out | A pointer to a 3D-vector, which coordinates must be set |
|
|
| x | in | A new value for the X-coordinate |
|
|
| y | in | A new value for the Y-coordinate |
|
|
| z | in | A new value for the Z-coordinate |
|
|
|
|
The *destination* parameter must be a valid pointer. The NULL (0) value is considered invalid.
|
|
|
|
### Example
|
|
|
|
```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;
|
|
}
|
|
```
|
|
|
|
[Documentation](../intro-eng.md) / [3D vectors](../vector3-eng.md)
|
|
|