GLKVector4參考

PDFCompanion文件

下一個

GLKVector4參考

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

概觀

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

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

功能按任務

創建向量

檢索關於矢量的信息

向量執行的數學操作

比較操作

功能

GLKVector4Add

返回兩個向量的和。

GLKVector4 GLKVector4Add（GLKVector4 vectorLeft，GLKVector4 vectorRight）;

參數

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

回報值

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

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector4.h

GLKVector4AddScalar

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

GLKVector4 GLKVector4AddScalar（GLKVector4 vector，float value）;

參數

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

回報值

一個新的矢量。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector4.h

GLKVector4AllEqualToScalar

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

bool GLKVector4AllEqualToScalar（GLKVector4 vector，float value）;

參數

向量
一個矢量。
值
標量

回報值

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

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector4.h

GLKVector4AllEqualToVector4

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

bool GLKVector4AllEqualToVector4（GLKVector4 vectorLeft，GLKVector4 vectorRight）;

參數

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

回報值

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

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector4.h

GLKVector4AllGreaterThanOrEqualToScalar

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

bool GLKVector4AllGreaterThanOrEqualToScalar（GLKVector4 vector，float value）;

參數

向量
一個矢量。
值
標量

回報值

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

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector4.h

GLKVector4AllGreaterThanOrEqualToVector4

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

bool GLKVector4AllGreaterThanOrEqualToVector4（GLKVector4 vectorLeft，GLKVector4 vectorRight）;

參數

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

回報值

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

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector4.h

GLKVector4AllGreaterThanScalar

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

bool GLKVector4AllGreaterThanScalar（GLKVector4 vector，float value）;

參數

向量
一個矢量。
值
標量

回報值

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

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector4.h

GLKVector4AllGreaterThanVector4

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

bool GLKVector4AllGreaterThanVector4（GLKVector4 vectorLeft，GLKVector4 vectorRight）;

參數

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

回報值

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

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector4.h

GLKVector4CrossProduct

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

GLKVector4 GLKVector4CrossProduct（GLKVector4 vectorLeft，GLKVector4 vectorRight）;

參數

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

回報值

一個新的矢量。

討論

通過獲取[x,y,z]兩個源向量的分量並計算這兩個向量的交叉乘積來執行計算。w結果向量的分量是0.0。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector4.h

GLKVector4Distance

返回兩點之間的距離。

float GLKVector4Distance（GLKVector4 vectorStart，GLKVector4 vectorEnd）;

參數

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

回報值

兩點之間的距離。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector4.h

GLKVector4Divide

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

GLKVector4 GLKVector4Divide（GLKVector4 vectorLeft，GLKVector4 vectorRight）;

參數

vectorLeft
第一個矢量。
vectorRight
股息

回報值

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

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector4.h

GLKVector4DivideScalar

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

GLKVector4 GLKVector4DivideScalar（GLKVector4 vector，float value）;

參數

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

回報值

一個新的矢量。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector4.h

GLKVector4DotProduct

返回兩個向量的點積。

float GLKVector4DotProduct（GLKVector4 vectorLeft，GLKVector4 vectorRight）;

參數

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

回報值

兩個向量的點積。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector4.h

GLKVector4Length

返回向量的長度。

float GLKVector4Length（GLKVector4 vector）;

參數

向量
一個矢量。

回報值

矢量的長度。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector4.h

GLKVector4Lerp

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

GLKVector4 GLKVector4Lerp（GLKVector4 vectorStart，GLKVector4 vectorEnd，float t）;

參數

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

回報值

一個新的矢量。

討論

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

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector4.h

GLKVector4Make

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

GLKVector4 GLKVector4Make（float x，float y，float z，float w）;

參數

X
第一個組件。
第二個組件。
第三部分。
w ^
第四個組成部分。

回報值

初始化矢量。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector4.h

GLKVector4MakeWithArray

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

GLKVector4 GLKVector4MakeWithArray（float values [4]）;

參數

值
數組包含組件值。

回報值

數組

討論

初始化矢量。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector4.h

GLKVector4MakeWithVector3

返回通過組合三分量向量與標量值創建的新的四分量向量。

GLKVector4 GLKVector4MakeWithVector3（GLKVector3 vector，float w）;

參數

向量
一個矢量。
w ^
第四個組成部分。

回報值

一個新的矢量。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector4.h

GLKVector4Maximum

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

GLKVector4 GLKVector4Maximum（GLKVector4 vectorLeft，GLKVector4 vectorRight）;

參數

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

回報值

一個新的矢量。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector4.h

GLKVector4Minimum

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

GLKVector4 GLKVector4Minimum（GLKVector4 vectorLeft，GLKVector4 vectorRight）;

參數

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

回報值

一個新的矢量。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector4.h

GLKVector4Multiply

返回兩個向量的乘積。

GLKVector4 GLKVector4Multiply（GLKVector4 vectorLeft，GLKVector4 vectorRight）;

參數

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

回報值

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

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector4.h

GLKVector4MultiplyScalar

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

GLKVector4 GLKVector4MultiplyScalar（GLKVector4 vector，float value）;

參數

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

回報值

一個新的矢量。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector4.h

GLKVector4Negate

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

GLKVector4 GLKVector4Negate（GLKVector4 vector）;

參數

向量
一個矢量。

回報值

一個新的矢量。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector4.h

GLKVector4Normalize

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

GLKVector4 GLKVector4Normalize（GLKVector4 vector）;

參數

向量
一個矢量。

回報值

一個新的矢量。

討論

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

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector4.h

GLKVector4Project

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

GLKVector4 GLKVector4Project（GLKVector4 vectorToProject，GLKVector4 projectionVector）;

參數

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

回報值

一個新的矢量。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector4.h

GLKVector4Subtract

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

GLKVector4 GLKVector4Subtract（GLKVector4 vectorLeft，GLKVector4 vectorRight）;

參數

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

回報值

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

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector4.h

GLKVector4SubtractScalar

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

GLKVector4 GLKVector4SubtractScalar（GLKVector4 vector，float value）;

參數

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

回報值

一個新的矢量。

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKVector4.h

數據類型

GLKVector4

4分量矢量的表示。

union _GLKVector4 {struct {float x，y，z，w; }; struct {float r，g，b，a; }; struct {float s，t，p，q; }; float v [4];} typedef union _GLKVector4 GLKVector4;

字段

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

可用性

適用於iOS 5.0及更高版本。

聲明在

GLKMathTypes.h