# [name]

فئة تمثل [link:https://en.wikipedia.org/wiki/Vector_space متجه] ثلاثي الأبعاد. متجه ثلاثي الأبعاد هو ثلاثي مرتب من الأرقام (مسمى x و y و z) ، والذي يمكن استخدامه لتمثيل عدد من الأشياء ، مثل:

- نقطة في الفضاء ثلاثي الأبعاد.
- اتجاه وطول في الفضاء ثلاثي الأبعاد. في three.js سيكون الطول دائمًا [link:https://en.wikipedia.org/wiki/Euclidean_distance المسافة الإقليدية] (المسافة المستقيمة) من `(0, 0, 0)` إلى `(x, y, z)` و يتم قياس الاتجاه أيضًا من `(0, 0, 0)` نحو `(x, y, z)`.
- أي ثلاثي مرتب عشوائي من الأرقام.

هناك أشياء أخرى يمكن استخدام متجه ثلاثي الأبعاد لتمثيلها ، مثل متجهات الزخم وما إلى ذلك ، ومع ذلك فإن هذه هي الاستخدامات الأكثر شيوعًا في three.js.

التكرار عبر مثيل [name] سوف ينتج عنه مكوناته `(x, y, z)` بالترتيب المقابل.

## مثال للكود

`const a = new THREE.Vector3( 0, 1, 0 ); //no arguments; will be initialised to (0, 0, 0) const b = new THREE.Vector3( ); const d = a.distanceTo( b );`

## المنشئ (Constructor)

### [name]( [param:Float x], [param:Float y], [param:Float z] )

[page:Float x] - قيمة x لهذا الفيكتور. القيمة الافتراضية هي `0`.
[page:Float y] - قيمة y لهذا الفيكتور. القيمة الافتراضية هي `0`.
[page:Float z] - قيمة z لهذا الفيكتور. القيمة الافتراضية هي `0`.
ينشئ [name] جديد.

## الخصائص (Properties)

### [property:Boolean isVector3]

علامة للتحقق مما إذا كان الكائن المعطى من نوع [name] أم لا.

### [property:Float x]

### [property:Float y]

### [property:Float z]

## الوظائف (Methods)

### [method:this add]( [param:Vector3 v] )

يضيف [page:Vector3 v] إلى هذا الفيكتور.

### [method:this addScalar]( [param:Float s] )

يضيف قيمة العدد s إلى قيم [page:.x x]، [page:.y y] و [page:.z z] لهذا الفيكتور.

### [method:this addScaledVector]( [param:Vector3 v], [param:Float s] )

يضيف الضرب المتعدد لـ [page:Vector3 v] و [page:Float s] إلى هذا الفيكتور.

### [method:this addVectors]( [param:Vector3 a], [param:Vector3 b] )

يعيد هذا الفيكتور إلى [page:Vector3 a] + [page:Vector3 b].

### [method:this applyAxisAngle]( [param:Vector3 axis], [param:Float angle] )

[page:Vector3 axis] - محور [page:Vector3] موحّد.
[page:Float angle] - زاوية بالراديان.
يطبق تحويلًا يُحدد بواسطة محور وزاوية على هذا الفيكتور.

### [method:this applyEuler]( [param:Euler euler] )

يطبق تحويل أويلر على هذا الفيكتور من خلال تحويل الكائن [page:Euler] إلى [page:Quaternion] وتطبيقه.

### [method:this applyMatrix3]( [param:Matrix3 m] )

يضرب هذا الفيكتور بواسطة [page:Matrix3 m].

### [method:this applyMatrix4]( [param:Matrix4 m] )

يضرب هذا الفيكتور (مع وجود 1 ضمن الأبعاد الرابعة) بـ m، ويقسمه على التوازن.

### [method:this applyNormalMatrix]( [param:Matrix3 m] )

يضرب هذا الفيكتور بواسطة مصفوفة القوامة العادية [page:Matrix3 m] ويقوم بتطبيع النتيجة.

### [method:this applyQuaternion]( [param:Quaternion quaternion] )

يطبق تحويل [page:Quaternion] على هذا الفيكتور.

### [method:Float angleTo]( [param:Vector3 v] )

يعيد الزاوية بين هذا الفيكتور وفيكتور [page:Vector3 v] بالراديان.

### [method:this ceil]()

يقوم بتقريب مكونات [page:.x x]، [page:.y y] و [page:.z z] لهذا الفيكتور إلى أقرب قيمة صحيحة.

### [method:this clamp]( [param:Vector3 min], [param:Vector3 max] )

[page:Vector3 min] - القيم [page:.x x]، [page:.y y] و [page:.z z] الدنيا.
[page:Vector3 max] - القيم [page:.x x]، [page:.y y] و [page:.z z] العليا في النطاق المطلوب.
إذا كانت قيم x أو y أو z لهذا الفيكتور أكبر من قيم x أو y أو z العليا للفيكتور، يتم استبدالها بالقيم المقابلة.
إذا كانت قيم x أو y أو z لهذا الفيكتور أقل من قيم x أو y أو z الدنيا للفيكتور، يتم استبدالها بالقيم المقابلة.

### [method:this clampLength]( [param:Float min], [param:Float max] )

[page:Float min] - القيمة الدنيا التي ستتم تقييدها للطول
[page:Float max] - القيمة العليا التي ستتم تقييدها للطول
إذا كان طول هذا الفيكتور أكبر من القيمة العليا، سيتم تصغير الفيكتور بحيث يصبح طوله هو القيمة العليا.
إذا كان طول هذا الفيكتور أقل من القيمة الدنيا، سيتم تكبير الفيكتور بحيث يصبح طوله هو القيمة الدنيا.

### [method:this clampScalar]( [param:Float min], [param:Float max] )

[page:Float min] - القيمة الدنيا التي ستتم تقييدها للمكونات
[page:Float max] - القيمة العليا التي ستتم تقييدها للمكونات
إذا كانت قيم x أو y أو z لهذا الفيكتور أكبر من القيمة العليا، سيتم استبدالها بالقيمة العليا.
إذا كانت قيم x أو y أو z لهذا الفيكتور أقل من القيمة الدنيا، سيتم استبدالها بالقيمة الدنيا.

### [method:Vector3 clone]()

يعيد فيكتور3 جديدًا بنفس القيم x، y، و z كهذا الفيكتور.

### [method:this copy]( [param:Vector3 v] )

ينسخ قيم خصائص x، y، و z لفيكتور3 الممرر إلى هذا الفيكتور.

### [method:this cross]( [param:Vector3 v] )

يضبط هذا الفيكتور إلى ناتج الضرب النقطي بينه وبين Vector3 v.

### [method:this crossVectors]( [param:Vector3 a], [param:Vector3 b] )

يضبط هذا الفيكتور إلى ناتج الضرب النقطي بين Vector3 a و Vector3 b.

### [method:Float distanceTo]( [param:Vector3 v] )

يحسب المسافة من هذا الفيكتور إلى Vector3 v.

### [method:Float manhattanDistanceTo]( [param:Vector3 v] )

يحسب [link:https://en.wikipedia.org/wiki/Taxicab_geometry Manhattan distance] من هذا المتجه إلى [page:Vector3 v].

### [method:Float distanceToSquared]( [param:Vector3 v] )

يحسب المسافة المربعة من هذا المتجه إلى [page:Vector3 v]. إذا كنت تقارن المسافة مع مسافة أخرى، يجب عليك مقارنة المسافة المربعة بدلاً من ذلك كما هو أكثر كفاءة قليلاً في الحساب.

### [method:this divide]( [param:Vector3 v] )

يقسم هذا المتجه بواسطة [page:Vector3 v].

### [method:this divideScalar]( [param:Float s] )

يقسم هذا المتجه بواسطة العدد الفردي [page:Float s].

### [method:Float dot]( [param:Vector3 v] )

حساب [link:https://en.wikipedia.org/wiki/Dot_product dot product] لهذا المتجه و[page:Vector3 v].

### [method:Boolean equals]( [param:Vector3 v] )

يعود `true` إذا كانت مكونات هذا المتجه و[page:Vector3 v] هي صارمة متساوية؛ `false` في حالات أخرى.

### [method:this floor]()

يتم تقريب مكونات هذا المتجه إلى أسفل إلى أقرب قيمة صحيحة قيمة.

### [method:this fromArray]( [param:Array array], [param:Integer offset] )

[page:Array array] - المصفوفة المصدر.
[page:Integer offset] - ( اختياري) الإزاحة في المصفوفة. الافتراضي هو 0.
يضع قيمة هذا المتجه [page:.x x] لتكون `array[ offset + 0 ]`، قيمة [page:.y y] لتكون `array[ offset + 1 ]` وقيمة [page:.z z] لتكون `array[ offset + 2 ]`.

### [method:this fromBufferAttribute]( [param:BufferAttribute attribute], [param:Integer index] )

[page:BufferAttribute attribute] - السمة المصدر.
[page:Integer index] - الفهرس في السمة.
يضع قيم هذا المتجه [page:.x x]، [page:.y y] و [page:.z z] من ال[page:BufferAttribute attribute].

### [method:Float getComponent]( [param:Integer index] )

[page:Integer index] - 0، 1 أو 2.
إذا كان الفهرس يساوي 0 يعيد قيمة [page:.x x].
إذا كان الفهرس يساوي 1 يعيد قيمة [page:.y y].
إذا كان الفهرس يساوي 2 يعيد قيمة [page:.z z].

### [method:Float length]()

يحسب [link:https://en.wikipedia.org/wiki/Euclidean_distance الطول الإقليدي] (طول الخط المستقيم) من (0، 0، 0) إلى (x، y، z).

### [method:Float manhattanLength]()

يحسب طول مانهاتن لهذا المتجه.

### [method:Float lengthSq]()

يحسب مربع [link:https://en.wikipedia.org/wiki/Euclidean_distance الطول الإقليدي] (طول الخط المستقيم) من (0، 0، 0) إلى (x، y، z). إذا كنت تقارن أطوال المتجهات، يجب عليك مقارنة طول المربع بدلاً من ذلك كما أنه أكثر كفاءة قليلاً في الحساب.

### [method:this lerp]( [param:Vector3 v], [param:Float alpha] )

[page:Vector3 v] - [page:Vector3] للتداخل نحوه.
[page:Float alpha] - عامل التداخل، عادة في المغلق الفاصل `[0, 1]`.
تداخل خطي بين هذا المتجه و[page:Vector3 v]، حيث alpha هو نسبة المسافة على طول الخط - alpha = 0 سيكون هذا المتجه، وalpha = 1 ستكون [page:Vector3 v].

### [method:this lerpVectors]( [param:Vector3 v1], [param:Vector3 v2], [param:Float alpha] )

[page:Vector3 v1] - البداية [page:Vector3].
[page:Vector3 v2] - [page:Vector3] للتداخل نحوه.
[page:Float alpha] - عامل التداخل، عادة في الفاصل المغلق `[0، 1]`.
يضع هذا المتجه ليكون المتجه المتداخل خطيًا بين [page:Vector3 v1] و [page:Vector3 v2] حيث يكون ألفا هو النسبة المئوية للمسافة على طول الخط الذي يربط المتجهين - سيكون ألفا = 0 [page:Vector3 v1]، وسيكون ألفا = 1 [page:Vector3 v2].

### [method:this max]( [param:Vector3 v] )

إذا كانت قيمة x أو y أو z لهذا المتجه أقل من قيمة x أو y أو z لـ [page:Vector3 v]، استبدل تلك القيمة بالقيمة القصوى المقابلة.

### [method:this min]( [param:Vector3 v] )

إذا كانت قيمة x أو y أو z لهذا المتجه أكبر من قيمة x أو y أو z لـ [page:Vector3 v]، استبدل تلك القيمة بالقيمة الدنيا المقابلة.

### [method:this multiply]( [param:Vector3 v] )

يضرب هذا المتجه بـ [page:Vector3 v].

### [method:this multiplyScalar]( [param:Float s] )

يضرب هذا المتجه بالعدد القائم [page:Float s].

### [method:this multiplyVectors]( [param:Vector3 a], [param:Vector3 b] )

يضع هذا المتجه يساوي [page:Vector3 a] * [page:Vector3 b]، مكونًا حكيمًا.

### [method:this negate]()

يعكس هذا المتجه - أي يضع x = -x، y = -y و z = -z.

### [method:this normalize]()

تحويل هذا المتجه إلى متجه وحدة - أي يضعه يساوي متجه بنفس الاتجاه كهذا واحد، ولكن طول الصفحة 1.

### [method:this project]( [param:Camera camera] )

[page:Camera camera] — الكاميرا المستخدمة في الإسقاط.
يسقط هذا المتجه من مساحة العالم إلى مساحة جهاز الكاميرا المعيارية (NDC).

### [method:this projectOnPlane]( [param:Vector3 planeNormal] )

[page:Vector3 planeNormal] - متجه يمثل عادي الطائرة.
[link:https://en.wikipedia.org/wiki/Vector_projection يسقط] هذا المتجه على طائرة عن طريق طرح هذا المتجه المسقط على عادي الطائرة من هذا المتجه.

### [method:this projectOnVector]( [param:Vector3 v] )

[link:https://en.wikipedia.org/wiki/Vector_projection يسقط] هذا المتجه على [page:Vector3 v].

### [method:this reflect]( [param:Vector3 normal] )

[page:Vector3 normal] - العادي إلى طائرة الانعكاس
يعكس هذا المتجه قبالة طائرة متعامدة على [page:Vector3 normal]. يفترض أن يكون العادي لديه طول وحدة.

### [method:this round]()

تتم جولة مكونات هذا المتجه إلى أقرب قيمة صحيحة.

### [method:this roundToZero]()

تتم جولة مكونات هذا المتجه نحو الصفر (لأعلى إذا كان سالبًا، لأسفل إذا كان إيجابيًا) إلى قيمة صحيحة.

### [method:this set]( [param:Float x], [param:Float y], [param:Float z] )

يضبط مكونات [page:.x x]، [page:.y y] و [page:.z z] من هذا المتجه.

### [method:this setComponent]( [param:Integer index], [param:Float value] )

[page:Integer index] - 0، 1 أو 2.
[page:Float value] - [page:Float]
إذا كان index يساوي 0 يضبط [page:.x x] على [page:Float value].
إذا كان index يساوي 1 يضبط [page:.y y] على [page:Float value].
إذا كان index يساوي 2 يضبط [page:.z z] على [page:Float value]

### [method:this setFromColor]( [param:Color color] )

يضبط مكونات [page:.x x] و [page:.y y] و [page:.z z] لهذا المتجه من مكونات r و g و b لـ[page:Color color] المحدد.

### [method:this setFromCylindrical]( [param:Cylindrical c] )

يضبط هذا المتجه من الإحداثيات الأسطوانية [page:Cylindrical c].

### [method:this setFromCylindricalCoords]( [param:Float radius], [param:Float theta], [param:Float y] )

يضبط هذا المتجه من الإحداثيات الأسطوانية [page:Cylindrical radius]، و[page:Cylindrical theta] و[page:Cylindrical y].

### [method:this setFromEuler]( [param:Euler euler] )

يضبط مكونات [page:.x x] و[page:.y y] و[page:.z z] لهذا المتجه من مكونات x و y و z لـ[page:Euler Euler Angle] المحدد.

### [method:this setFromMatrixColumn]( [param:Matrix4 matrix], [param:Integer index] )

يضبط مكونات [page:.x x] و[page:.y y] و[page:.z z] لهذا المتجه من العمود [page:Integer index] من [page:Matrix4 matrix].

### [method:this setFromMatrix3Column]( [param:Matrix3 matrix], [param:Integer index] )

يضبط مكونات [page:.x x] و [page:.y y] و [page:.z z] لهذا المتجه من العمود [page:Integer index] من [page:Matrix3 matrix].

### [method:this setFromMatrixPosition]( [param:Matrix4 m] )

يضبط هذا المتجه على عناصر الموضع لـ [link:https://en.wikipedia.org/wiki/Transformation_matrix مصفوفة التحويل] [page:Matrix4 m].

### [method:this setFromMatrixScale]( [param:Matrix4 m] )

يضبط هذا المتجه على عناصر الحجم لـ [link:https://en.wikipedia.org/wiki/Transformation_matrix مصفوفة التحويل] [page:Matrix4 m].

### [method:this setFromSpherical]( [param:Spherical s] )

يضبط هذا المتجه من الإحداثيات الكروية [page:Spherical s].

### [method:this setFromSphericalCoords]( [param:Float radius], [param:Float phi], [param:Float theta] )

يضبط هذا المتجه من الإحداثيات الكروية [page:Spherical radius]، و[page:Spherical phi] و[page:Spherical theta].

### [method:this setLength]( [param:Float l] )

يضبط هذا المتجه على متجه بنفس اتجاه هذا، ولكن بـ [page:.length length] يساوي [page:Float l].

### [method:this setScalar]( [param:Float scalar] )

يضبط قيمة كل من [page:.x x] و[page:.y y] و[page:.z z] لهذا المتجه على قيمة مساوية لـ[page:Float scalar].

### [method:this setX]( [param:Float x] )

يستبدل قيمة [page:.x x] لهذا المتجه بـ[page:Float x].

### [method:this setY]( [param:Float y] )

يستبدل قيمة [page:.y y] لهذا المتجه بـ[page:Float y].

### [method:this setZ]( [param:Float z] )

يستبدل قيمة [page:.z z] لهذا المتجه بـ[page:Float z].

### [method:this sub]( [param:Vector3 v] )

يطرح [page:Vector3 v] من هذا المتجه.

### [method:this subScalar]( [param:Float s] )

يطرح [page:Float s] من مكونات [page:.x x] و [page:.y y] و [page:.z z] لهذا المتجه.

### [method:this subVectors]( [param:Vector3 a], [param:Vector3 b] )

يضبط هذا المتجه على [page:Vector3 a] - [page:Vector3 b].

### [method:Array toArray]( [param:Array array], [param:Integer offset] )

[page:Array array] - (اختياري) مصفوفة لتخزين هذا المتجه فيها. إذا لم يتم توفير هذا، سيتم إنشاء مصفوفة جديدة.
[page:Integer offset] - (اختياري) إزاحة اختيارية في المصفوفة.
يرجع مصفوفة [x، y، z]، أو ينسخ x و y و z في المصفوفة المعطاة من نوع [page:Array array].

### [method:this transformDirection]( [param:Matrix4 m] )

يحول اتجاه هذا المتجه بمصفوفة (المجموعة العلوية اليسرى 3 × 3 من [page:Matrix4 m]) ثم يقوم بـ [page:.normalize تطبيع] النتيجة.

### [method:this unproject]( [param:Camera camera] )

[page:Camera camera] — الكاميرا المستخدمة في الإسقاط.
يُسقِط هذا المتجه من مساحة الجهاز المعيارية للكاميرا (NDC) إلى مساحة العالم.

### [method:this random]()

يضبط كل مكون من مكونات هذا المتجه على قيمة شبه عشوائية بين 0 و 1، باستثناء 1.

### [method:this randomDirection]()

يضبط هذا المتجه على نقطة عشوائية موحدة على كرة وحدة.

## المصدر (Source)

[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]