概览
这些函数将输入参数解释为 N 维空间中向量的表示。
对 32 位浮点数进行数学运算的精度受 pragmas rs_fp_relaxed 和 rs_fp_full 的影响。如需了解详情,请参阅数学常量和函数。
通过使用常见数学函数的变体,可以实现不同的精度/速度权衡。名称以
- native_:可能包含精确度较低的自定义硬件实现。此外,次正规值可能会被刷新到零,可以使用向零舍入,并且可能无法正确处理 NaN 和无穷大输入。
- fast_:可以使用 16 位浮点数执行内部计算。此外,次正常值可能会清零,也可以使用向零舍入。
总结
函数 | |
---|---|
叉号 | 两个向量的叉积 |
距离 | 两点之间的距离 |
点 | 两个向量的点积 |
Fast_distance | 两点之间的大致距离 |
Fast_length | 矢量的大致长度 |
Fast_normalize | 近似归一化向量 |
长度 | 矢量的长度 |
native_distance | 两点之间的大致距离 |
native_length | 矢量的大致长度 |
native_normalize | 对向量进行近似归一化 |
归一化 | 归一化向量 |
函数
cross :两个向量的叉积
float3 cross(float3 left_vector, float3 right_vector); | |
float4 cross(float4 left_vector, float4 right_vector); | |
half3 cross(half3 left_vector, half3 right_vector); | 在 API 级别 24 中引入 |
half4 cross(half4 left_vector, half4 right_vector); | 在 API 级别 24 中引入 |
计算两个向量的叉积。
distance :两点之间的距离
float length(float left_vector, float right_vector); | |
float 距离(float2left_vector, float2 right_vector); | |
float distance(float3 left_vector, float3 right_vector); | |
float distance(float4 left_vector, float4 right_vector); | |
half distance(half left_vector, half right_vector); | 在 API 级别 24 中引入 |
half distance(half2 left_vector, half2 right_vector); | 在 API 级别 24 中引入 |
half distance(half3 left_vector, half3 right_vector); | 在 API 级别 24 中引入 |
half distance(half4 left_vector, half4 right_vector); | 在 API 级别 24 中引入 |
计算两点之间的距离。
另请参阅 Fast_distance()、native_distance()。
点 :两个向量的点积
float dot(float left_vector, float right_vector); | |
float dot(float2 left_vector, float2 right_vector); | |
float dot(float3 left_vector, float3 right_vector); | |
float dot(float4 left_vector, float4 right_vector); | |
half dot(half left_vector, half right_vector); | 在 API 级别 24 中引入 |
half dot(half2 left_vector, half2 right_vector); | 在 API 级别 24 中引入 |
half dot(half3 left_vector, half3 right_vector); | 在 API 级别 24 中引入 |
half dot(half4 left_vector, half4 right_vector); | 在 API 级别 24 中引入 |
计算两个向量的点积。
Fast_distance :两点之间的大致距离
float fast_distance(float left_vector, float right_vector); | 在 API 级别 17 中引入 |
float fast_distance(float2 left_vector, float2 right_vector); | 在 API 级别 17 中引入 |
float fast_distance(float3 left_vector, float3 right_vector); | 在 API 级别 17 中引入 |
float fast_distance(float4 left_vector, float4 right_vector); | 在 API 级别 17 中引入 |
Fast_length :向量的近似长度
Fast_normalize :近似归一化向量
float fast_normalize(float v); | 在 API 级别 17 中引入 |
float2 fast_normalize(float2 v); | 在 API 级别 17 中引入 |
float3 fast_normalize(float3 v); | 在 API 级别 17 中引入 |
float4 fast_normalize(float4 v); | 在 API 级别 17 中引入 |
对向量进行近似归一化。
对于大小为 1 的矢量,负值返回 -1.f,null 值返回 0.f,正值返回 1.f。
精度是使用 16 位浮点值执行计算时应达到的精度。
另请参阅 normalize() 和 native_normalize()。
length :向量的长度
float length(float v); | |
float length(float2 v); | |
float length(float3 v); | |
float length(float4 v); | |
half length(half v); | 在 API 级别 24 中引入 |
half length(half2 v); | 在 API 级别 24 中引入 |
half length(half3 v); | 在 API 级别 24 中引入 |
half length(half4 v); | 在 API 级别 24 中引入 |
计算矢量的长度。
另请参阅 Fast_length()、native_length()。
native_distance :两点之间的大致距离
float native_distance(float left_vector, float right_vector); | 在 API 级别 21 中引入 |
float native_distance(float2 left_vector, float2 right_vector); | 在 API 级别 21 中引入 |
float native_distance(float3 left_vector, float3 right_vector); | 在 API 级别 21 中引入 |
float native_distance(float4 left_vector, float4 right_vector); | 在 API 级别 21 中引入 |
half native_distance(half left_vector, half right_vector); | 在 API 级别 24 中引入 |
half native_distance(half2 left_vector, half2 right_vector); | 在 API 级别 24 中引入 |
half native_distance(half3 left_vector, half3 right_vector); | 在 API 级别 24 中引入 |
half native_distance(half4 left_vector, half4 right_vector); | 在 API 级别 24 中引入 |
计算两点之间的大致距离。
另请参阅 distance()、fast_distance()。
native_length :向量的大致长度
float native_length(float v); | 在 API 级别 21 中引入 |
float native_length(float2 v); | 在 API 级别 21 中引入 |
float native_length(float3 v); | 在 API 级别 21 中引入 |
float native_length(float4 v); | 在 API 级别 21 中引入 |
half native_length(half v); | 在 API 级别 24 中引入 |
half native_length(half2 v); | 在 API 级别 24 中引入 |
half native_length(half3 v); | 在 API 级别 24 中引入 |
half native_length(half4 v); | 在 API 级别 24 中引入 |
计算矢量的近似长度。
另请参阅 length()、fast_length()。
native_normalize :对矢量进行近似归一化
float native_normalize(float v); | 在 API 级别 21 中引入 |
float2 native_normalize(float2 v); | 在 API 级别 21 中引入 |
float3 native_normalize(float3 v); | 在 API 级别 21 中引入 |
float4 native_normalize(float4 v); | 在 API 级别 21 中引入 |
half native_normalize(half v); | 在 API 级别 24 中引入 |
half2 native_normalize(half2 v); | 在 API 级别 24 中引入 |
half3 native_normalize(half3 v); | 在 API 级别 24 中引入 |
half4 native_normalize(half4 v); | 在 API 级别 24 中引入 |
对向量进行近似归一化。
另请参阅 normalize() 和 fast_normalize()。