GLKVector3參考

PDFCompanion文件

下一個

GLKVector3參考

骨架	GLKit / GLKMath.h
宣稱	GLKMathTypes.h GLKVector3.h

概觀

該GLKVector3類型定義了一個組件3浮點向量以及通常用於操縱向量的許多數學運算。圖形編程廣泛使用向量來表示位置，法線，顏色和其他數據結構。

操作GLKVector3結構的函數將輸入視爲不可變的，而返回一個代表操作結果的新向量。

功能按任務

創建向量

檢索關於矢量的信息

向量執行的數學操作

比較操作

功能

GLKVector3Add

返回兩個向量的和。

GLKVector3 GLKVector3Add（GLKVector3 vectorLeft，GLKVector3 vectorRight）;

參數

vectorLeft
第一個矢量。
vectorRight
第二個矢量。

回報值

一個新向量，其分量各自表示在兩個源向量的相同位置中發現的兩個分量之和。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector3.h

GLKVector3AddScalar

返回通過向向量的每個組件添加標量值創建的新向量。

GLKVector3 GLKVector3AddScalar（GLKVector3 vector，float value）;

參數

向量
一個矢量。
值
標量值。

回報值

一個新的矢量。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector3.h

GLKVector3AllEqualToScalar

返回一個布爾值，指示源向量的所有組件是否等於標量值。

bool GLKVector3AllEqualToScalar（GLKVector3 vector，float value）;

參數

向量
一個矢量。
值
標量

回報值

YES如果所有矢量的分量都等於值，NO否則。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector3.h

GLKVector3AllEqualToVector3

返回一個布爾值，指示第一個向量的每個分量是否等於第二個向量的相應分量。

bool GLKVector3AllEqualToVector3（GLKVector3 vectorLeft，GLKVector3 vectorRight）;

參數

vectorLeft
第一個矢量。
vectorRight
第二個矢量。

回報值

YES如果所有的矢量組件相同，NO否則。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector3.h

GLKVector3AllGreaterThanOrEqualToScalar

返回一個布爾值，指示源向量的所有組件是否大於或等於標量值。

bool GLKVector3AllGreaterThanOrEqualToScalar（GLKVector3 vector，float value）;

參數

向量
一個矢量。
值
標量

回報值

YES如果所有矢量的分量都大於或等於標量值，NO否則。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector3.h

GLKVector3AllGreaterThanOrEqualToVector3

返回一個布爾值，指示第一個向量的每個分量是否大於或等於第二個向量的相應分量。

bool GLKVector3AllGreaterThanOrEqualToVector3（GLKVector3 vectorLeft，GLKVector3 vectorRight）;

參數

vectorLeft
第一個矢量。
vectorRight
第二個矢量。

回報值

YES如果第一向量中的每個分量大於或等於第二向量的相應分量，NO否則。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector3.h

GLKVector3AllGreaterThanScalar

返回一個布爾值，指示源向量的所有組件是否大於標量值。

bool GLKVector3AllGreaterThanScalar（GLKVector3 vector，float value）;

參數

向量
一個矢量。
值
標量

回報值

YES如果所有矢量的分量都大於標量值，NO否則。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector3.h

GLKVector3AllGreaterThanVector3

返回一個布爾值，指示第一個向量的每個分量是否大於第二個向量的相應分量。

bool GLKVector3AllGreaterThanVector3（GLKVector3 vectorLeft，GLKVector3 vectorRight）;

參數

vectorLeft
第一個矢量。
vectorRight
第二個矢量。

回報值

YES如果第一矢量中的每個分量大於第二矢量的相應分量，NO否則。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector3.h

GLKVector3CrossProduct

返回兩個向量的交叉乘積。

GLKVector3 GLKVector3CrossProduct（GLKVector3 vectorLeft，GLKVector3 vectorRight）;

參數

vectorLeft
第一個矢量。
vectorRight
第二個矢量。

回報值

一個新的矢量。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector3.h

GLKVector3Distance

返回兩點之間的距離。

float GLKVector3Distance（GLKVector3 vectorStart，GLKVector3 vectorEnd）;

參數

vectorStart
提供起點座標的向量。
vectorEnd
提供終點座標的向量。

回報值

兩點之間的距離。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector3.h

GLKVector3Divide

返回通過將一個向量除以另一個矢量創建的新向量。

GLKVector3 GLKVector3Divide（GLKVector3 vectorLeft，GLKVector3 vectorRight）;

參數

vectorLeft
第一個矢量。
vectorRight
股息

回報值

通過將在第一矢量的相同位置中找到的分量除以在第二矢量的相同位置中找到的分量，分別計算其分量的新向量。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector3.h

GLKVector3DivideScalar

返回通過將向量的每個分量除以標量值創建的新向量。

GLKVector3 GLKVector3DivideScalar（GLKVector3 vector，float value）;

參數

向量
一個矢量。
值
標量值。

回報值

一個新的矢量。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector3.h

GLKVector3DotProduct

返回兩個向量的點積。

float GLKVector3DotProduct（GLKVector3 vectorLeft，GLKVector3 vectorRight）;

參數

vectorLeft
第一個矢量。
vectorRight
第二個矢量。

回報值

兩個向量的點積。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector3.h

GLKVector3Length

返回向量的長度。

float GLKVector3Length（GLKVector3 vector）;

參數

向量
一個矢量。

回報值

矢量的長度。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector3.h

GLKVector3Lerp

返回通過兩個向量之間的線性解釋創建的新向量。

GLKVector3 GLKVector3Lerp（GLKVector3 vectorStart，GLKVector3 vectorEnd，float t）;

參數

vectorStart
起始矢量。
vectorEnd
結束向量。
內插常數。

回報值

一個新的矢量。

討論

的值噸通常應該之間0.0和1.0。的值0.0返回初始向量和的值1.0返回結束矢量。t的任何其他值導致兩點之間的線性插值。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector3.h

GLKVector3Make

返回從各個組件值創建的新的三分量向量。

GLKVector3 GLKVector3Make（float x，float y，float z）;

參數

X
第一個組件。
第二個組件。
第三部分。

回報值

初始化矢量。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector3.h

GLKVector3MakeWithArray

返回從組件數組創建的新的三分量向量。

GLKVector3 GLKVector3MakeWithArray（float values [3]）;

參數

值
數組包含組件值。

回報值

數組。

討論

初始化矢量。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector3.h

GLKVector3Maximum

返回一個新向量，其中每個位置的分量值是源向量中相同位置處的最大分量值。

GLKVector3 GLKVector3Maximum（GLKVector3 vectorLeft，GLKVector3 vectorRight）;

參數

vectorLeft
第一個矢量。
vectorRight
第二個矢量。

回報值

一個新的矢量。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector3.h

GLKVector3Minimum

返回一個新向量，其中每個位置的分量值是源向量中相同位置處的最小分量值。

GLKVector3 GLKVector3Minimum（GLKVector3 vectorLeft，GLKVector3 vectorRight）;

參數

vectorLeft
第一個矢量。
vectorRight
第二個矢量。

回報值

一個新的矢量。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector3.h

GLKVector3Multiply

返回兩個向量的乘積。

GLKVector3 GLKVector3Multiply（GLKVector3 vectorLeft，GLKVector3 vectorRight）;

參數

vectorLeft
第一個矢量。
vectorRight
第二個矢量。

回報值

一個新向量，其分量各自表示在兩個源向量的相同位置中發現的分量的乘積。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector3.h

GLKVector3MultiplyScalar

返回通過將向量的每個分量乘以標量值創建的新向量。

GLKVector3 GLKVector3MultiplyScalar（GLKVector3 vector，float value）;

參數

向量
一個矢量。
值
標量值。

回報值

一個新的矢量。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector3.h

GLKVector3Negate

返回通過否定另一個向量的組件值創建的新向量。

GLKVector3 GLKVector3Negate（GLKVector3 vector）;

參數

向量
一個矢量。

回報值

一個新的矢量。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector3.h

GLKVector3Normalize

返回通過將輸入向量歸一化爲一段長度創建的新向量1.0。

GLKVector3 GLKVector3Normalize（GLKVector3 vector）;

參數

向量
一個矢量。

回報值

一個新的矢量。

討論

所得到的向量指向與輸入向量相同的方向，但具有長度1.0。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector3.h

GLKVector3Project

返回通過將向量投影到另一個向量上創建的新向量。

GLKVector3 GLKVector3Project（GLKVector3 vectorToProject，GLKVector3 projectionVector）;

參數

vectorToProject
正在投影的矢量。
projectionVector
投影向量。

回報值

一個新的矢量。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector3.h

GLKVector3Subtract

返回兩個向量之間的差異。

GLKVector3 GLKVector3Subtract（GLKVector3 vectorLeft，GLKVector3 vectorRight）;

參數

vectorLeft
起始矢量。
vectorRight
向量減去。

回報值

一個新向量，其分量各自表示在兩個源向量的相同位置中發現的分量之間的差異。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector3.h

GLKVector3SubtractScalar

返回通過從矢量的每個分量中減去標量值創建的新向量。

GLKVector3 GLKVector3SubtractScalar（GLKVector3 vector，float value）;

參數

向量
一個矢量。
值
標量值。

回報值

一個新的矢量。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector3.h

數據類型

GLKVector3

3分量矢量的表示。

union _GLKVector3 {struct {float x，y，z; }; struct {float r，g，b; }; struct {float s，t，p; }; float v [3];}; typedef union _GLKVector3 GLKVector3;

字段

x
矢量中的第一個組件。通常在矢量指的是位置或正常時使用。
y
向量中的第二個組件。通常在矢量指的是位置或正常時使用。
z
向量中的第三個組件。通常在矢量指的是位置或正常時使用。
r
矢量中的第一個組件。通常在矢量指的是顏色值時使用。
g
向量中的第二個組件。通常在矢量指的是顏色值時使用。
b
向量中的第三個組件。通常在矢量指的是顏色值時使用。
s
矢量中的第一個組件。通常在矢量指紋理座標時使用。
t
向量中的第二個組件。通常在矢量指紋理座標時使用。
p
向量中的第三個組件。通常在矢量指紋理座標時使用。
v
向量的元素表示爲數組。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKMathTypes.h