[name]

تنفيذ [link:http://en.wikipedia.org/wiki/Quaternion كواترنيون].
يتم استخدام الكواترنيونات في three.js لتمثيل [link:https://en.wikipedia.org/wiki/Quaternions_and_spatial_rotation الدوران].

التكرار عبر مثيل [name] سيعطي مكوناته (x، y، z، w) بالترتيب المقابل.

لاحظ أن three.js تتوقع أن يتم تسوية Quaternions.

مثال الكود


		const quaternion = new THREE.Quaternion();
		quaternion.setFromAxisAngle( new THREE.Vector3( 0, 1, 0 ), Math.PI / 2 );
		 
		const vector = new THREE.Vector3( 1, 0, 0 );
		vector.applyQuaternion( quaternion );

المنشئ (Constructor)

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

[page:Float x] - إحداثية x
[page:Float y] - إحداثية y
[page:Float z] - إحداثية z
[page:Float w] - إحداثية w

الخصائص (Properties)

[property:Boolean isQuaternion]

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

[property:Float x]

[property:Float y]

[property:Float z]

[property:Float w]

الطرق (Methods)

[method:Float angleTo]( [param:Quaternion q] )

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

[method:Quaternion clone]()

ينشئ كواترنيون جديدًا بخصائص [page:.x x] و [page:.y y] و [page:.z z] و [page:.w w] متطابقة مع هذا.

[method:this conjugate]()

يعيد التجانس الدوراني لهذا الكواترنيون. التجانس لـ كواترنيون يمثل نفس الدوران في الاتجاه المعاكس حول محور الدوران.

[method:this copy]( [param:Quaternion q] )

ينسخ خصائص [page:.x x] و [page:.y y] و [page:.z z] و [page:.w w] من [page:Quaternion q] إلى هذا الكواترنيون.

[method:Boolean equals]( [param:Quaternion v] )

[page:Quaternion v] - كواترنيون سيتم مقارنة هذا الكواترنيون إليه.

يقارن خصائص [page:.x x] و [page:.y y] و [page:.z z] و [page:.w w] من [page:Quaternion v] إلى الخصائص المكافئة لهذا كواترنيون لتحديد ما إذا كانت تمثل نفس الدوران.

[method:Float dot]( [param:Quaternion v] )

يحسب [link:https://en.wikipedia.org/wiki/Dot_product dot product] من كواترنيونات [page:Quaternion v] وهذا.

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

[page:Array array] - مصفوفة بتنسيق (x، y، z، w) تستخدم لبناء الكواترنيون.
[page:Integer offset] - (اختياري) إزاحة في المصفوفة.

يضع خصائص [page:.x x] و [page:.y y] و [page:.z z] و [page:.w w] لهذا الكواترنيون من مصفوفة.

[method:this identity]()

يضع هذا الكواترنيون على الكواترنيون المتطابق ؛ أي إلى الكواترنيون الذي يمثل "لا دوران".

[method:this invert]()

يعكس هذا الكواترنيون - يحسب [page:.conjugate conjugate]. The يفترض أن الكواترنيون لديه طول وحدة.

[method:Float length]()

يحسب [link:https://en.wikipedia.org/wiki/Euclidean_distance الطول الإقليدي] (طول خط مستقيم) لهذا الكواترنيون ، كما هو معتبر متجه 4 أبعاد.

[method:Float lengthSq]()

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

[method:this normalize]()

[link:https://en.wikipedia.org/wiki/Normalized_vector يعدل] هذا كواترنيون - أي حساب الكواترنيون الذي يؤدي نفس دوران كهذا ، ولكن لديه [page:.length length] يساوي `1`.

[method:this multiply]( [param:Quaternion q] )

يضرب هذا الكواترنيون بـ[page:Quaternion q].

[method:this multiplyQuaternions]( [param:Quaternion a], [param:Quaternion b] )

يضع هذا الكواترنيون على[page:Quaternion a] x[page:Quaternion b].
تم تكييفه من الطريقة الموضحة [link:http://www.euclideanspace.com/maths/algebra/realNormedAlgebra/quaternions/code/index.html هنا].

[method:this premultiply]( [param:Quaternion q] )

يضرب مسبقًا هذا الكواترنيون بـ[page:Quaternion q].

[method:this random]()

يضع هذا الكواترنيون على كواترنيون عشوائي معتدل ومعتدل.

[method:this rotateTowards]( [param:Quaternion q], [param:Float step] )

[page:Quaternion q] - كواترنيون الهدف.
[page:Float step] - الخطوة الزاوية بالراديان.

يدور هذا الكواترنيون بخطوة زاوية معطاة إلى كواترنيون محدد *q*. تضمن الطريقة ألا يتجاوز الكواترنيون النهائي *q*.

[method:this slerp]( [param:Quaternion qb], [param:Float t] )

[page:Quaternion qb] - التدوير الكواترنيون الآخر
[page:Float t] - عامل التداخل في الفترة المغلقة `[0، 1]`.

يتعامل مع التداخل الخطي الكروي بين كواترنيون. [page:Float t] يمثل مقدار التدوير بين هذا الكواترنيون (حيث[page:Float t] هو 0) و[page:Quaternion qb] (حيث[page:Float t] هو 1). يتم تعيين هذا الكواترنيون على النتيجة. اطلع أيضًا على الإصدار الثابت من `slerp` أدناه. // تدور شبكة نحو كواترنيون هدف mesh.quaternion.slerp( endQuaternion، 0.01 );

[method:this slerpQuaternions]( [param:Quaternion qa], [param:Quaternion qb], [param:Float t] )

يؤدي التداخل الخطي الكروي بين كواترنيون المعطى وتخزين النتائج في هذا الكواترنيون.

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

يضع خصائص [page:.x x] ،[page:.y y] ،[page:.z z] ،[page:.w w] من هذا كواترنيون.

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

يضع هذا الكواترنيون من التدوير المحدد بـ[page:Vector3 axis] و [page:Float angle].
تم تكييفه من الطريقة [link:http://www.euclideanspace.com/maths/geometry/rotations/conversions/angleToQuaternion/index.html هنا].
يفترض أن يكون `Axis` معتدلًا ، `angle` بالراديان.

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

يضع هذا الكواترنيون من التدوير المحدد بزاوية[page:Euler].

[method:this setFromRotationMatrix]( [param:Matrix4 m] )

[page:Matrix4 m] - a[page:Matrix4] من الذي العلوي 3x3 من المصفوفة هو مصفوفة دوران نقية (أي غير متساوية القياس).
يضع هذا الكواترنيون من مكون التدوير لـ[page:Matrix4 m].
تم تكييفه من الطريقة [link:http://www.euclideanspace.com/maths/geometry/rotations/conversions/matrixToQuaternion/index.html هنا].

[method:this setFromUnitVectors]( [param:Vector3 vFrom], [param:Vector3 vTo] )

يضع هذا الكواترنيون على التدوير المطلوب لتدوير متجه الاتجاه [page:Vector3 vFrom] إلى متجه الاتجاه[page:Vector3 vTo].
تم تكييفه من الطريقة [link:http://lolengine.net/blog/2013/09/18/beautiful-maths-quaternion-from-vectors هنا].
يفترض أن يكون[page:Vector3 vFrom] و[page:Vector3 vTo] معتدلًا.

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

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

يعود بالعناصر العددية لهذا الكواترنيون في مصفوفة بتنسيق [x، y، z، w].

[method:Array toJSON]()

هذه الطرق تحدد نتيجة التسلسل لـ[name]. يعود العناصر العددية لهذا الكواترنيون في مصفوفة بتنسيق [x، y، z، w].

[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:.w w] من هذا كواترنيون من[page:BufferAttribute attribute].

طرق ثابتة (Static Methods)

[method:undefined slerpFlat]( [param:Array dst], [param:Integer dstOffset], [param:Array src0], [param:Integer srcOffset0], [param:Array src1], [param:Integer srcOffset1], [param:Float t] )

[page:Array dst] - مصفوفة الإخراج.
[page:Integer dstOffset] - إزاحة في مصفوفة الإخراج.
[page:Array src0] - مصفوفة المصدر للكواترنيون البدائي.
[page:Integer srcOffset0] - إزاحة في مصفوفة `src0`.
[page:Array src1] - مصفوفة المصدر للكواترنيون المستهدف.
[page:Integer srcOffset1] - إزاحة في مصفوفة `src1`.
[page:Float t] - عامل التداخل المعتدل (بين 0 و 1).

تفترض هذه التطبيقات SLERP أن بيانات الكواترنيون يتم إدارتها في مصفوفات مسطحة.

[method:Array multiplyQuaternionsFlat]( [param:Array dst], [param:Integer dstOffset], [param:Array src0], [param:Integer srcOffset0], [param:Array src1], [param:Integer srcOffset1] )

[page:Array dst] - مصفوفة الإخراج.
[page:Integer dstOffset] - إزاحة في مصفوفة الإخراج.
[page:Array src0] - مصفوفة المصدر للكواترنيون البدائي.
[page:Integer srcOffset0] - إزاحة في مصفوفة `src0`.
[page:Array src1] - مصفوفة المصدر للكواترنيون المستهدف.
[page:Integer srcOffset1] - إزاحة في مصفوفة `src1`.

تفترض هذه التطبيقات التعددية أن بيانات الكواترنيون يتم إدارتها في مصفوفات مسطحة.

المصدر (Source)

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