javascript
/
three.js
mirror of https://github.com/tazdij/three.js.git


			
				
					
						
						
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326
							<!DOCTYPE html>
<html lang="ar">
	<head>
		<meta charset="utf-8" />
		<base href="../../../" />
		<script src="page.js"></script>
		<link type="text/css" rel="stylesheet" href="page.css" />
	</head>
	<body class="rtl">
		<h1>[name]</h1>

		<p class="desc">
		تنفيذ [link:http://en.wikipedia.org/wiki/Quaternion كواترنيون].<br />
		يتم استخدام الكواترنيونات في three.js لتمثيل
		[link:https://en.wikipedia.org/wiki/Quaternions_and_spatial_rotation الدوران].
		</p>
		 
		<p>
		التكرار عبر مثيل [name] سيعطي مكوناته (x، y، z، w)
		بالترتيب المقابل.
		</p>

		<p>
			لاحظ أن three.js تتوقع أن يتم تسوية Quaternions.
		</p>
		 
		<h2>مثال الكود</h2>
		 
		<code>
		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 );
		</code>
		 
		<h2>المنشئ (Constructor)</h2>
		 
		<h3>
		[name]( [param:Float x], [param:Float y], [param:Float z], [param:Float w] )
		</h3>
		<p>
		[page:Float x] - إحداثية x<br />
		[page:Float y] - إحداثية y<br />
		[page:Float z] - إحداثية z<br />
		[page:Float w] - إحداثية w
		</p>
		 
		<h2>الخصائص (Properties)</h2>
		 
		<h3>[property:Boolean isQuaternion]</h3>
		<p>علامة للقراءة فقط للتحقق مما إذا كان الكائن المعطى هو من نوع [name].</p>
		 
		<h3>[property:Float x]</h3>
		 
		<h3>[property:Float y]</h3>
		 
		<h3>[property:Float z]</h3>
		 
		<h3>[property:Float w]</h3>
		 
		<h2>الطرق (Methods)</h2>

		<h3>[method:Float angleTo]( [param:Quaternion q] )</h3>
		<p>
		يعيد الزاوية بين هذا الكواترنيون وكواترنيون [page:Quaternion q] بالراديان.
		</p>
	 
		<h3>[method:Quaternion clone]()</h3>
		<p>
		ينشئ كواترنيون جديدًا بخصائص [page:.x x] و [page:.y y] و [page:.z z] 
		و [page:.w w] متطابقة مع هذا.
		</p>
	 
		<h3>[method:this conjugate]()</h3>
		<p>
		يعيد التجانس الدوراني لهذا الكواترنيون. التجانس لـ
		كواترنيون يمثل نفس الدوران في الاتجاه المعاكس حول
		محور الدوران.
		</p>
	 
		<h3>[method:this copy]( [param:Quaternion q] )</h3>
		<p>
		ينسخ خصائص [page:.x x] و [page:.y y] و [page:.z z] و [page:.w w]
		من [page:Quaternion q] إلى هذا الكواترنيون.
		</p>
	 
		<h3>[method:Boolean equals]( [param:Quaternion v] )</h3>
		<p>
		[page:Quaternion v] - كواترنيون سيتم مقارنة هذا الكواترنيون
		إليه.<br /><br />
	 
		يقارن خصائص [page:.x x] و [page:.y y] و [page:.z z] و [page:.w w]
		من [page:Quaternion v] إلى الخصائص المكافئة لهذا
		كواترنيون لتحديد ما إذا كانت تمثل نفس الدوران.
		</p>
	 
		<h3>[method:Float dot]( [param:Quaternion v] )</h3>
		<p>
		يحسب [link:https://en.wikipedia.org/wiki/Dot_product dot product]
		من كواترنيونات [page:Quaternion v] وهذا.
		</p>

		<h3>
		[method:this fromArray]( [param:Array array], [param:Integer offset] )
		</h3>
		<p>
		[page:Array array] - مصفوفة بتنسيق (x، y، z، w) تستخدم لبناء
		الكواترنيون.<br />
		[page:Integer offset] - (اختياري) إزاحة في المصفوفة.<br /><br />
		 
		يضع خصائص [page:.x x] و [page:.y y] و [page:.z z] و [page:.w w] 
		لهذا الكواترنيون من مصفوفة.
		</p>
		 
		<h3>[method:this identity]()</h3>
		<p>
		يضع هذا الكواترنيون على الكواترنيون المتطابق ؛ أي إلى
		الكواترنيون الذي يمثل "لا دوران".
		</p>
		 
		<h3>[method:this invert]()</h3>
		<p>
		يعكس هذا الكواترنيون - يحسب [page:.conjugate conjugate]. The
		يفترض أن الكواترنيون لديه طول وحدة.
		</p>
		 
		<h3>[method:Float length]()</h3>
		<p>
		يحسب [link:https://en.wikipedia.org/wiki/Euclidean_distance الطول الإقليدي]
		(طول خط مستقيم) لهذا الكواترنيون ، كما هو معتبر
		متجه 4 أبعاد.
		</p>
		 
		<h3>[method:Float lengthSq]()</h3>
		<p>
		يحسب المربع
		[link:https://en.wikipedia.org/wiki/Euclidean_distance الطول الإقليدي]
		(طول خط مستقيم) لهذا الكواترنيون ، كما هو معتبر متجه 4 أبعاد
		. هذا يمكن أن يكون مفيدًا إذا كنت تقارن طول اثنين
		كواترنيون ، حيث أن هذا حساب أكثر كفاءة قليلاً من
		[page:.length length]().
		</p>
		 
		<h3>[method:this normalize]()</h3>
		<p>
		[link:https://en.wikipedia.org/wiki/Normalized_vector يعدل] هذا
		كواترنيون - أي حساب الكواترنيون الذي يؤدي نفس
		دوران كهذا ، ولكن لديه [page:.length length] يساوي `1`.
		</p>
		 

		<h3>[method:this multiply]( [param:Quaternion q] )</h3>
		<p>يضرب هذا الكواترنيون بـ[page:Quaternion q].</p>
	 
		<h3>
		[method:this multiplyQuaternions]( [param:Quaternion a], [param:Quaternion b] )
		</h3>
		<p>
		يضع هذا الكواترنيون على[page:Quaternion a] x[page:Quaternion b].<br />
		تم تكييفه من الطريقة الموضحة
		[link:http://www.euclideanspace.com/maths/algebra/realNormedAlgebra/quaternions/code/index.html هنا].
		</p>
	 
		<h3>[method:this premultiply]( [param:Quaternion q] )</h3>
		<p>يضرب مسبقًا هذا الكواترنيون بـ[page:Quaternion q].</p>
	 
		<h3>[method:this random]()</h3>
		<p>يضع هذا الكواترنيون على كواترنيون عشوائي معتدل ومعتدل.</p>
	 
		<h3>
		[method:this rotateTowards]( [param:Quaternion q], [param:Float step] )
		</h3>
		<p>
		[page:Quaternion q] - كواترنيون الهدف. <br />
		[page:Float step] - الخطوة الزاوية بالراديان. <br /><br />
	 
		يدور هذا الكواترنيون بخطوة زاوية معطاة إلى كواترنيون محدد
		*q*. تضمن الطريقة ألا يتجاوز الكواترنيون النهائي *q*.
		</p>
	 
		<h3>[method:this slerp]( [param:Quaternion qb], [param:Float t] )</h3>
		<p>
		[page:Quaternion qb] - التدوير الكواترنيون الآخر<br />
		[page:Float t] - عامل التداخل في الفترة المغلقة `[0، 1]`. <br /><br />
	 
		يتعامل مع التداخل الخطي الكروي بين كواترنيون.
		[page:Float t] يمثل مقدار التدوير بين هذا الكواترنيون
		(حيث[page:Float t] هو 0) و[page:Quaternion qb] (حيث[page:Float t]
		هو 1). يتم تعيين هذا الكواترنيون على النتيجة. اطلع أيضًا على الإصدار الثابت
		من `slerp` أدناه.
	 
		<code>
		// تدور شبكة نحو كواترنيون هدف 
		mesh.quaternion.slerp( endQuaternion، 0.01 );
		</code>
		</p>
	 
		<h3>
		[method:this slerpQuaternions]( [param:Quaternion qa], [param:Quaternion qb], [param:Float t] )
		</h3>
		<p>
		يؤدي التداخل الخطي الكروي بين كواترنيون المعطى
		وتخزين النتائج في هذا الكواترنيون.
		</p>

		<h3>
		[method:this set]( [param:Float x], [param:Float y], [param:Float z], [param:Float w] )
		</h3>
		<p>
		يضع خصائص [page:.x x] ،[page:.y y] ،[page:.z z] ،[page:.w w] من هذا
		كواترنيون.
		</p>
		 
		<h3>
		[method:this setFromAxisAngle]( [param:Vector3 axis], [param:Float angle] )
		</h3>
		<p>
		يضع هذا الكواترنيون من التدوير المحدد بـ[page:Vector3 axis] و
		[page:Float angle].<br />
		تم تكييفه من الطريقة
		[link:http://www.euclideanspace.com/maths/geometry/rotations/conversions/angleToQuaternion/index.html هنا].<br />
		يفترض أن يكون `Axis` معتدلًا ، `angle` بالراديان.
		</p>
		 
		<h3>[method:this setFromEuler]( [param:Euler euler] )</h3>
		<p>
		يضع هذا الكواترنيون من التدوير المحدد بزاوية[page:Euler].
		</p>
		 
		<h3>[method:this setFromRotationMatrix]( [param:Matrix4 m] )</h3>
		<p>
		[page:Matrix4 m] - a[page:Matrix4] من الذي العلوي 3x3 من المصفوفة هو
		مصفوفة دوران نقية
		(أي غير متساوية القياس).<br />
		يضع هذا الكواترنيون من مكون التدوير لـ[page:Matrix4 m].<br />
		تم تكييفه من الطريقة
		[link:http://www.euclideanspace.com/maths/geometry/rotations/conversions/matrixToQuaternion/index.html هنا].
		</p>
		 
		<h3>
		[method:this setFromUnitVectors]( [param:Vector3 vFrom], [param:Vector3 vTo] )
		</h3>
		<p>
		يضع هذا الكواترنيون على التدوير المطلوب لتدوير متجه الاتجاه
		[page:Vector3 vFrom] إلى متجه الاتجاه[page:Vector3 vTo].<br />
		تم تكييفه من الطريقة
		[link:http://lolengine.net/blog/2013/09/18/beautiful-maths-quaternion-from-vectors هنا].<br />
		يفترض أن يكون[page:Vector3 vFrom] و[page:Vector3 vTo] معتدلًا.
		</p>
		 
		<h3>
		[method:Array toArray]( [param:Array array], [param:Integer offset] )
		</h3>
		<p>
		[page:Array array] - مصفوفة اختيارية لتخزين الكواترنيون. إذا لم يتم
		محدد ، سيتم إنشاء مصفوفة جديدة. <br />
		[page:Integer offset] - (اختياري) إذا تم تحديده ، فسيتم نسخ
		في هذه[page:Array].<br /><br />
		 
		يعود بالعناصر العددية لهذا الكواترنيون في مصفوفة بتنسيق
		[x، y، z، w].
		</p>
		 
		<h3>[method:Array toJSON]()</h3>
		<p>
		هذه الطرق تحدد نتيجة التسلسل لـ[name]. يعود
		العناصر العددية لهذا الكواترنيون في مصفوفة بتنسيق [x، y، z، w].
		</p>
	 
		<h3>
		[method:this fromBufferAttribute]( [param:BufferAttribute attribute], [param:Integer index] )
		</h3>
		<p>
		[page:BufferAttribute attribute] - السمة المصدر. <br />
		[page:Integer index] - فهرس في السمة. <br /><br />
	 
		يضع خصائص [page:.x x] ،[page:.y y] ،[page:.z z] ،[page:.w w] من هذا
		كواترنيون من[page:BufferAttribute attribute].
		</p>
	 
		<h2>طرق ثابتة (Static Methods)</h2>
	 
		<h3>
		[method:undefined slerpFlat]( [param:Array dst], [param:Integer dstOffset], 
		[param:Array src0], [param:Integer srcOffset0], [param:Array src1], 
		[param:Integer srcOffset1], [param:Float t] )
		</h3>
		<p>
		[page:Array dst] - مصفوفة الإخراج. <br />
		[page:Integer dstOffset] - إزاحة في مصفوفة الإخراج. <br />
		[page:Array src0] - مصفوفة المصدر للكواترنيون البدائي. <br />
		[page:Integer srcOffset0] - إزاحة في مصفوفة `src0`. <br />
		[page:Array src1] - مصفوفة المصدر للكواترنيون المستهدف. <br />
		[page:Integer srcOffset1] - إزاحة في مصفوفة `src1`. <br />
		[page:Float t] - عامل التداخل المعتدل (بين 0 و 1). <br /><br />
	 
		تفترض هذه التطبيقات SLERP أن بيانات الكواترنيون يتم إدارتها في
		مصفوفات مسطحة.
		</p>
	 
		<h3>
		[method:Array multiplyQuaternionsFlat]( [param:Array dst], [param:Integer dstOffset], 
		[param:Array src0], [param:Integer srcOffset0], [param:Array src1], [param:Integer srcOffset1] )
		</h3>
		<p>
		[page:Array dst] - مصفوفة الإخراج. <br />
		[page:Integer dstOffset] - إزاحة في مصفوفة الإخراج. <br />
		[page:Array src0] - مصفوفة المصدر للكواترنيون البدائي. <br />
		[page:Integer srcOffset0] - إزاحة في مصفوفة `src0`. <br />
		[page:Array src1] - مصفوفة المصدر للكواترنيون المستهدف. <br />
		[page:Integer srcOffset1] - إزاحة في مصفوفة `src1`. <br /><br />
	 
		تفترض هذه التطبيقات التعددية أن بيانات الكواترنيون يتم إدارتها
		في مصفوفات مسطحة.
		</p>

		<!-- Note: Do not add non-static methods to the bottom of this page. Put them above the <h2>Static Methods</h2> -->

		<h2>المصدر (Source)</h2>

		<p>
			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
		</p>
	</body>
</html>