QVector3D Class Reference · PyQt4 中文文檔

# QVector3D Class Reference ## [[QtGui](index.htm) module] 該QVector3D類表示在三維空間中的矢量或頂點。[More...](#details) ### Methods * `__init__ (self)` * `__init__ (self, float?xpos, float?ypos, float?zpos)` * `__init__ (self, QPoint?point)` * `__init__ (self, QPointF?point)` * `__init__ (self, QVector2D?vector)` * `__init__ (self, QVector2D?vector, float?zpos)` * `__init__ (self, QVector4D?vector)` * `__init__ (self, QVector3D)` * `float distanceToLine (self, QVector3D?point, QVector3D?direction)` * `float distanceToPlane (self, QVector3D?plane, QVector3D?normal)` * `float distanceToPlane (self, QVector3D?plane1, QVector3D?plane2, QVector3D?plane3)` * `bool isNull (self)` * `float length (self)` * `float lengthSquared (self)` * `normalize (self)` * `QVector3D normalized (self)` * `setX (self, float?aX)` * `setY (self, float?aY)` * `setZ (self, float?aZ)` * `QPoint toPoint (self)` * `QPointF toPointF (self)` * `QVector2D toVector2D (self)` * `QVector4D toVector4D (self)` * `float x (self)` * `float y (self)` * `float z (self)` ### Static Methods * `QVector3D crossProduct (QVector3D?v1, QVector3D?v2)` * `float dotProduct (QVector3D?v1, QVector3D?v2)` * `QVector3D normal (QVector3D?v1, QVector3D?v2)` * `QVector3D normal (QVector3D?v1, QVector3D?v2, QVector3D?v3)` ### Special Methods * `QVector3D __add__ (self, QVector3D?v2)` * `QVector3D __div__ (self, float?divisor)` * `bool __eq__ (self, QVector3D?v2)` * `QVector3D __iadd__ (self, QVector3D?vector)` * `QVector3D __idiv__ (self, float?divisor)` * `QVector3D __imul__ (self, float?factor)` * `QVector3D __imul__ (self, QVector3D?vector)` * `QVector3D __isub__ (self, QVector3D?vector)` * `QVector3D __mul__ (self, QMatrix4x4?matrix)` * `QVector3D __mul__ (self, QVector3D?vector)` * `QVector3D __mul__ (self, float?factor)` * `QVector3D __mul__ (self, QVector3D?v2)` * `bool __ne__ (self, QVector3D?v2)` * `QVector3D __neg__ (self)` * `str __repr__ (self)` * `QVector3D __sub__ (self, QVector3D?v2)` * * * ## Detailed Description 這個類可以醃制。該QVector3D類表示在三維空間中的矢量或頂點。載體是三維表示和繪畫的主要基石之一。它們由三個坐標，傳統上被稱為的x，y和z 。該QVector3D類也可以用來表示在三維空間的頂點。因此，我們并不需要提供一個獨立的頂點類。 **Note:**通過在QVector3D實例設計值存儲`float`。這意味著，在平臺上，其中`qreal`參數QVector3D函數表示為`double`值，有可能丟失精度。 * * * ## Method Documentation ``` QVector3D.__init__ (self) ``` 構造一個空向量，即坐標為（ 0 ， 0 ， 0 ）。 ``` QVector3D.__init__ (self, float?xpos, float?ypos, float?zpos) ``` 構造一個具有坐標向量（_xpos_，_ypos_，_zpos_）。 ``` QVector3D.__init__ (self, QPoint?point) ``` 構造一個向量x和y坐標從2D_point_，和一個Z座標為0 。 ``` QVector3D.__init__ (self, QPointF?point) ``` 構造一個向量x和y坐標從2D_point_，和一個Z座標為0 。 ``` QVector3D.__init__ (self, QVector2D?vector) ``` 構造一個三維向量從指定的2D_vector_。的z坐標設為零。 **See also** [toVector2D](qvector3d.html#toVector2D)（）。 ``` QVector3D.__init__ (self, QVector2D?vector, float?zpos) ``` 構造一個三維向量從指定的2D_vector_。 Z坐標設置為_zpos_。 **See also** [toVector2D](qvector3d.html#toVector2D)（）。 ``` QVector3D.__init__ (self, QVector4D?vector) ``` 構造一個三維向量從指定4D_vector_。在W坐標將被丟棄。 **See also** [toVector4D](qvector3d.html#toVector4D)（）。 ``` QVector3D.__init__ (self, QVector3D) ``` ``` QVector3D QVector3D.crossProduct (QVector3D?v1, QVector3D?v2) ``` [ 返回向量的叉積_v1_和_v2_，對應于由所確定的平面的法線矢量_v1_和_v2_。 ](qvector3d.html) [**See also**](qvector3d.html) [normal](qvector3d.html#normal)（）。 ``` float QVector3D.distanceToLine (self, QVector3D?point, QVector3D?direction) ``` 返回由定義的直線的距離，這個頂點是_point_和單位矢量_direction_。 If _direction_是一個空向量，那么它沒有定義線。在這種情況下，從距離_point_這個頂點將被返回。 **See also** [distanceToPlane](qvector3d.html#distanceToPlane)（）。 ``` float QVector3D.distanceToPlane (self, QVector3D?plane, QVector3D?normal) ``` 返回的距離從該頂點由頂點限定的平面_plane_和_normal_單位向量。該_normal_參數被假定已經被標準化為單位向量。返回值將是負面的，如果頂點是平面的下方，??或零，如果它是在飛機上。 **See also** [normal](qvector3d.html#normal)（）和[distanceToLine](qvector3d.html#distanceToLine)（）。 ``` float QVector3D.distanceToPlane (self, QVector3D?plane1, QVector3D?plane2, QVector3D?plane3) ``` 這是一個重載函數。返回從該頂點的距離的頂點所限定的平面_plane1_，_plane2_和_plane3_。返回值將是負面的，如果頂點是平面的下方，??或零，如果它是在飛機上。兩個向量的定義平面的_plane2_ - _plane1_和_plane3_ - _plane1_。 **See also** [normal](qvector3d.html#normal)（）和[distanceToLine](qvector3d.html#distanceToLine)（）。 ``` float QVector3D.dotProduct (QVector3D?v1, QVector3D?v2) ``` 返回的點積_v1_和_v2_。 ``` bool QVector3D.isNull (self) ``` 返回True如果在x，y ，z坐標都設置為0.0 ，否則返回False 。 ``` float QVector3D.length (self) ``` 返回向量的距離原點的長度。 **See also** [lengthSquared](qvector3d.html#lengthSquared)（）和[normalized](qvector3d.html#normalized)（）。 ``` float QVector3D.lengthSquared (self) ``` 返回向量的距離原點的平方長度。這等同于用本身的矢量的點積。 **See also** [length](qvector3d.html#length)（）和[dotProduct](qvector3d.html#dotProduct)（）。 ``` QVector3D QVector3D.normal (QVector3D?v1, QVector3D?v2) ``` [ 返回一個平面上的由矢量定義的法線向量_v1_和_v2_，歸一化是一個單位矢量。 ](qvector3d.html) [使用](qvector3d.html)[crossProduct](qvector3d.html#crossProduct)（）來計算的交叉乘積_v1_和_v2_如果你不需要將結果進行標準化為單位矢量。 **See also** [crossProduct](qvector3d.html#crossProduct)（）和[distanceToPlane](qvector3d.html#distanceToPlane)（）。 ``` QVector3D QVector3D.normal (QVector3D?v1, QVector3D?v2, QVector3D?v3) ``` [ 這是一個重載函數。返回一個平面上的由矢量定義的法線向量_v2_ - _v1_和_v3_ - _v1_，歸一化是一個單位矢量。 ](qvector3d.html) [使用](qvector3d.html)[crossProduct](qvector3d.html#crossProduct)（）來計算的交叉乘積_v2_ - _v1_和_v3_ - _v1_如果你不需要將結果進行標準化為單位矢量。 **See also** [crossProduct](qvector3d.html#crossProduct)（）和[distanceToPlane](qvector3d.html#distanceToPlane)（）。 ``` QVector3D.normalize (self) ``` 標準化到位確認當期的載體。如果該矢量是零矢量或矢量的長度非常接近1沒有反應。 **See also** [length](qvector3d.html#length)（）和[normalized](qvector3d.html#normalized)（）。 ``` QVector3D QVector3D.normalized (self) ``` [ 返回此向量的歸一化的單位向量形式。如果這個向量為null，則一個空向量被返回。如果該矢量的長度非常接近1，則向量將被返回原樣。否則，長度為1的向量的歸一化形式將被退回。 ](qvector3d.html) [**See also**](qvector3d.html) [length](qvector3d.html#length)（）和[normalize](qvector3d.html#normalize)（）。 ``` QVector3D.setX (self, float?aX) ``` 設置該點的x坐標，以給定的_x_協調。 **See also** [x](qvector3d.html#x)（）[setY](qvector3d.html#setY)（）和[setZ](qvector3d.html#setZ)（）。 ``` QVector3D.setY (self, float?aY) ``` 設置該點的y坐標為給定的_y_協調。 **See also** [y](qvector3d.html#y)（）[setX](qvector3d.html#setX)（）和[setZ](qvector3d.html#setZ)（）。 ``` QVector3D.setZ (self, float?aZ) ``` 設置該點的z坐標，以給定的_z_協調。 **See also** [z](qvector3d.html#z)（）[setX](qvector3d.html#setX)（）和[setY](qvector3d.html#setY)（）。 ``` QPoint QVector3D.toPoint (self) ``` [](qpoint.html) [返回](qpoint.html)[QPoint](qpoint.html)本表格3D向量。 Z坐標將被丟棄。 **See also** [toPointF](qvector3d.html#toPointF)（）和[toVector2D](qvector3d.html#toVector2D)（）。 ``` QPointF QVector3D.toPointF (self) ``` [](qpointf.html) [返回](qpointf.html)[QPointF](qpointf.html)本表格3D向量。 Z坐標將被丟棄。 **See also** [toPoint](qvector3d.html#toPoint)（）和[toVector2D](qvector3d.html#toVector2D)（）。 ``` QVector2D QVector3D.toVector2D (self) ``` [ 返回此三維矢量的2D向量形式，去掉了z坐標。 ](qvector2d.html) [**See also**](qvector2d.html) [toVector4D](qvector3d.html#toVector4D)（）和[toPoint](qvector3d.html#toPoint)（）。 ``` QVector4D QVector3D.toVector4D (self) ``` [ 返回4D形式這個三維矢量，用坐標設置為零瓦特。 ](qvector4d.html) [**See also**](qvector4d.html) [toVector2D](qvector3d.html#toVector2D)（）和[toPoint](qvector3d.html#toPoint)（）。 ``` float QVector3D.x (self) ``` 返回該點的x坐標。 **See also** [setX](qvector3d.html#setX)（）[y](qvector3d.html#y)（）和[z](qvector3d.html#z)（）。 ``` float QVector3D.y (self) ``` 返回此點的y坐標。 **See also** [setY](qvector3d.html#setY)（）[x](qvector3d.html#x)（）和[z](qvector3d.html#z)（）。 ``` float QVector3D.z (self) ``` 返回此點的z坐標。 **See also** [setZ](qvector3d.html#setZ)（）[x](qvector3d.html#x)（）和[y](qvector3d.html#y)（）。 ``` QVector3D QVector3D.__add__ (self, QVector3D?v2) ``` [](qvector3d.html) ``` QVector3D QVector3D.__div__ (self, float?divisor) ``` [ ``` bool QVector3D.__eq__ (self, QVector3D?v2) ``` ](qvector3d.html) ``` QVector3D QVector3D.__iadd__ (self, QVector3D?vector) ``` [](qvector3d.html) ``` QVector3D QVector3D.__idiv__ (self, float?divisor) ``` [](qvector3d.html) ``` QVector3D QVector3D.__imul__ (self, float?factor) ``` [](qvector3d.html) ``` QVector3D QVector3D.__imul__ (self, QVector3D?vector) ``` [](qvector3d.html) ``` QVector3D QVector3D.__isub__ (self, QVector3D?vector) ``` [](qvector3d.html) ``` QVector3D QVector3D.__mul__ (self, QMatrix4x4?matrix) ``` [](qvector3d.html) ``` QVector3D QVector3D.__mul__ (self, QVector3D?vector) ``` [](qvector3d.html) ``` QVector3D QVector3D.__mul__ (self, float?factor) ``` [](qvector3d.html) ``` QVector3D QVector3D.__mul__ (self, QVector3D?v2) ``` [ ``` bool QVector3D.__ne__ (self, QVector3D?v2) ``` ](qvector3d.html) ``` QVector3D QVector3D.__neg__ (self) ``` [ ``` str QVector3D.__repr__ (self) ``` ](qvector3d.html) ``` QVector3D QVector3D.__sub__ (self, QVector3D?v2) ``` [](qvector3d.html)