QVector3D Class

メンバ関数のドキュメント

[constexpr noexcept] QVector3D::QVector3D()

零ベクトル、すなわち座標が (0, 0, 0) であるベクトルを作成します。

[explicit constexpr noexcept] QVector3D::QVector3D(QPoint point)

2次元のpoint からx座標とy座標を持つベクトルを生成し、z座標を0とします。

[explicit constexpr noexcept] QVector3D::QVector3D(QPointF point)

2次元point からx座標とy座標を持つベクトルを構築し、z座標を0とします。

[explicit constexpr noexcept] QVector3D::QVector3D(QVector2D vector)

指定された 2Dvector から 3D ベクトルを生成します。z 座標は 0 に設定されます。

toVector2D()も参照してください 。

[explicit constexpr noexcept] QVector3D::QVector3D(QVector4D vector)

指定された4次元vector から3次元ベクトルを生成します。w座標は除外されます。

toVector4D()も参照してください 。

[constexpr noexcept] QVector3D::QVector3D(QVector2D vector, float zpos)

指定された2次元vector から3次元ベクトルを構築します。z座標はzpos に設定されますが、この値は有限でなければなりません。

toVector2D()も参照してください 。

[constexpr noexcept] QVector3D::QVector3D(float xpos, float ypos, float zpos)

座標 (xpos,ypos,zpos) を持つベクトルを生成します。すべてのパラメータは有限値でなければなりません。

[static constexpr noexcept] QVector3D QVector3D::crossProduct(QVector3D v1, QVector3D v2)

ベクトル `v1 ` と `v2` の外積を返します。この外積は、`v1 ` と `v2` によって張られる平面に垂直なベクトルとなります。2つのベクトルが平行な場合は、0になります。

normal()も参照してください 。

[noexcept] float QVector3D::distanceToLine(QVector3D point, QVector3D direction) const

この頂点と、point で定義される直線および単位ベクトルdirection との距離を返します。

direction が零ベクトルの場合、直線は定義されません。その場合は、point からこの頂点までの距離が返されます。

distanceToPlane()も参照してください 。

[constexpr noexcept] float QVector3D::distanceToPlane(QVector3D plane, QVector3D normal) const

この頂点から、頂点plane および単位ベクトルnormal によって定義される平面までの距離を返します。normal パラメータは、単位ベクトルに正規化されているものとみなされます。

頂点が平面より下にある場合は負の値が、平面上にある場合は 0 が返されます。

normal() およびdistanceToLine()も参照してください 。

[noexcept] float QVector3D::distanceToPlane(QVector3D plane1, QVector3D plane2, QVector3D plane3) const

この頂点から、頂点plane1 、plane2 、plane3 によって定義される平面までの距離を返します。

頂点が平面の下にある場合は負の値が、平面上にある場合は 0 が返されます。

平面を定義する 2 つのベクトルは、plane2 -plane1 およびplane3 -plane1 です。

normal() およびdistanceToLine()も参照してください 。

[noexcept] float QVector3D::distanceToPoint(QVector3D point) const

この頂点から、頂点point で定義される点までの距離を返します。

distanceToPlane() およびdistanceToLine()も参照してください 。

[static constexpr noexcept] float QVector3D::dotProduct(QVector3D v1, QVector3D v2)

v1 とv2 の内積を返します。

[constexpr noexcept] bool QVector3D::isNull() const

x、y、zの座標がすべて0.0に設定されている場合はtrue を返し、それ以外の場合はfalse を返します。

[noexcept] float QVector3D::length() const

原点からのベクトルの長さを返します。

lengthSquared() およびnormalized()も参照してください 。

[constexpr noexcept] float QVector3D::lengthSquared() const

原点からのベクトルの長さの二乗を返します。これは、そのベクトルとそれ自身の内積に相当します。

length() およびdotProduct()も参照してください 。

[static noexcept] QVector3D QVector3D::normal(QVector3D v1, QVector3D v2)

ベクトルv1 とv2 によって張られる平面の単位法線ベクトルを返します。なお、これらのベクトルは互いに平行であってはなりません。

結果を単位ベクトルに正規化する必要がない場合は、crossProduct() を使用して、v1 とv2 の外積を計算してください。

crossProduct() およびdistanceToPlane()も参照してください 。

[static noexcept] QVector3D QVector3D::normal(QVector3D v1, QVector3D v2, QVector3D v3)

ベクトル `v2 ` - `v1 ` および `v3 ` - `v1` によって張られる平面の単位法線ベクトルを返します。これらのベクトルは互いに平行であってはなりません。

結果を単位ベクトルに正規化する必要がない場合は、crossProduct() を使用して、v2 -v1 とv3 -v1 の外積を計算してください。

crossProduct() およびdistanceToPlane()も参照してください 。

[noexcept] void QVector3D::normalize()

現在のベクトルをその場で正規化します。このベクトルが空ベクトルである場合、またはベクトルの長さが 1 に非常に近い場合は、何も起こりません。

length() およびnormalized()も参照してください 。

[noexcept] QVector3D QVector3D::normalized() const

このベクトルの正規化された単位ベクトル形式を返します。

このベクトルが null の場合、null ベクトルが返されます。ベクトルの長さが 1 に非常に近い場合は、ベクトルがそのまま返されます。それ以外の場合は、長さ 1 の正規化されたベクトルが返されます。

length() およびnormalize()も参照してください 。

QVector3D QVector3D::project(const QMatrix4x4 &modelView, const QMatrix4x4 &projection, const QRect &viewport) const

このベクトルのウィンドウ座標を返します。このベクトルは、モデルビュー行列 `modelView`、投影行列 `projection `、およびビューポートの寸法 `viewport` を用いて、当初はオブジェクト／モデル座標で表されています。

クリップ空間から正規化空間へ変換する際、ベクトルの各成分に対して w 成分による除算が行われます。w が 0 の場合に 0 で除算されるのを防ぐため、w は 1 に設定されます。

unproject()も参照してください 。

[constexpr noexcept] void QVector3D::setX(float x)

この点のx座標を、指定された有限のx 座標に設定します。

x()、setY()、およびsetZ()も参照してください 。

[constexpr noexcept] void QVector3D::setY(float y)

この点の y 座標を、指定された有限なy 座標に設定します。

y()、setX()、およびsetZ()も参照してください 。

[constexpr noexcept] void QVector3D::setZ(float z)

この点の z 座標を、指定された有限のz 座標に設定します。

z()、setX()、およびsetY()も参照してください 。

[constexpr noexcept] QPoint QVector3D::toPoint() const

この3次元ベクトルのQPoint 形式を返します。z座標は切り捨てられます。x座標とy座標は、最も近い整数に丸められます。

toPointF() およびtoVector2D()も参照してください 。

[constexpr noexcept] QPointF QVector3D::toPointF() const

この3次元ベクトルのQPointF 形式を返します。z座標は除外されます。

toPoint() およびtoVector2D()も参照してください 。

[constexpr noexcept] QVector2D QVector3D::toVector2D() const

この3次元ベクトルのz座標を除いた2次元ベクトル形式を返します。

toVector4D() およびtoPoint()も参照してください 。

[constexpr noexcept] QVector4D QVector3D::toVector4D() const

この3次元ベクトルの4次元形式を返し、w座標を0に設定します。

toVector2D() およびtoPoint()も参照してください 。

QVector3D QVector3D::unproject(const QMatrix4x4 &modelView, const QMatrix4x4 &projection, const QRect &viewport) const

このベクトルのオブジェクト／モデル座標を、モデルビュー行列modelView 、投影行列projection 、およびビューポートの寸法viewport を用いて、最初はウィンドウ座標系で返します。

クリップ空間から正規化空間へ変換する際、ベクトル成分の w 成分による除算が行われます。w が 0 の場合に除算が 0 になるのを防ぐため、w は 1 に設定されます。

project()も参照してください 。

[constexpr noexcept] float QVector3D::x() const

この点の x 座標を返します。

setX()、y()、およびz()も参照してください 。

[constexpr noexcept] float QVector3D::y() const

この点の y 座標を返します。

setY()、x()、およびz()も参照してください 。

[constexpr noexcept] float QVector3D::z() const

この点の z 座標を返します。

setZ()、x()、およびy()も参照してください 。

QVector3D::operator QVariant() const

3DベクトルをQVariant として返します。

[constexpr noexcept] QVector3D &QVector3D::operator*=(float factor)

このベクトルの座標に、指定された有限なfactor を乗算し、このベクトルへの参照を返します。

operator/=() およびoperator*()も参照してください 。

[constexpr noexcept] QVector3D &QVector3D::operator*=(QVector3D vector)

このベクトルの各成分に、vector 内の対応する成分を乗算し、このベクトルへの参照を返します。

注：これは、このベクトルのcrossProduct()やvector とは異なります。（その成分の和は、このベクトルとvector の内積に等しくなります。）

crossProduct()、operator/=()、およびoperator*()も参照してください 。

[constexpr noexcept] QVector3D &QVector3D::operator+=(QVector3D vector)

指定されたvector をこのベクトルに追加し、このベクトルへの参照を返します。

operator-=()も参照してください 。

[constexpr noexcept] QVector3D &QVector3D::operator-=(QVector3D vector)

指定されたvector をこのベクトルから差し引き、このベクトルへの参照を返します。

operator+=()も参照してください 。

[constexpr] QVector3D &QVector3D::operator/=(QVector3D vector)

このベクトルの各成分を、vector の対応する成分で割り、このベクトルへの参照を返します。

vector には、0 または NaN の成分が含まれていてはなりません。

operator*=() およびoperator/()も参照してください 。

[constexpr] QVector3D &QVector3D::operator/=(float divisor)

このベクトルの座標を、指定されたdivisor で除算し、このベクトルへの参照を返します。divisor は、0でもNaNでもあってはなりません。

operator*=() およびoperator/()も参照してください 。

[constexpr] float &QVector3D::operator[](int i)

ベクトルのインデックス位置i にある成分を、変更可能な参照として返します。

i i は、ベクトル内の有効なインデックス位置でなければなりません（つまり、0 <= < 3）。

[constexpr] float QVector3D::operator[](int i) const

ベクトルのインデックス位置i にある成分を返します。

i i は、ベクトル内の有効なインデックス位置でなければなりません（つまり、0 <= < 3）。