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


			
				
					
						
						
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208
							<!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">كائن مع عدة وظائف مساعدة للرياضيات.</p>

		<h2>الطرق (Methods)</h2>
	 
		<h3>
		[method:Float clamp]( [param:Float value], [param:Float min], [param:Float max] )
		</h3>
		<p>
		[page:Float value] — القيمة التي يتم تثبيتها.<br />
		[page:Float min] — الحد الأدنى.<br />
		[page:Float max] — الحد الأقصى.<br /><br />
	 
		يثبت[page:Float value ] ليكون بين[page:Float min ] و
	 [page:Float max ].
		</p>
	 
		<h3>[method:Float degToRad]( [param:Float degrees] )</h3>
		<p>تحويل الدرجات إلى راديان.</p>
	 
		<h3>
		[method:Integer euclideanModulo]( [param:Integer n], [param:Integer m] )
		</h3>
		<p>
		[page:Integer n]،[page:Integer m ] - أعداد صحيحة<br /><br />
	 
		يحسب نمط إقليدي لـ[page:Integer m ] % [page:Integer n ]، هذا
		هو:
		<code>( ( n % m ) + m ) % m</code>
		</p>
	 
		<h3>[method:UUID generateUUID]( )</h3>
		<p>
		توليد
	 	[link:https://en.wikipedia.org/wiki/Universally_unique_identifier UUID]
		(معرف فريد عالميًا).
		</p>
	 
		<h3>[method:Boolean isPowerOfTwo]( [param:Number n] )</h3>
		<p>يعود بـ`true` إذا كان [page:Number n] قوة لـ2.</p>
	 
		<h3>
		[method:Float inverseLerp]( [param:Float x], [param:Float y], [param:Float value] )
		</h3>
		<p>
		[page:Float x] - نقطة البداية.<br />
		[page:Float y] - نقطة النهاية.<br />
		[page:Float value] - قيمة بين البداية والنهاية.<br /><br />
	 
		يعود بالنسبة المئوية في الفترة المغلقة `[0، 1]` للقيمة المعطاة
		بين نقطة البداية والنهاية.
		</p>
	 
		<h3>
		[method:Float lerp]( [param:Float x], [param:Float y], [param:Float t] )
		</h3>
		<p>
		[page:Float x] - نقطة البداية. <br />
		[page:Float y] - نقطة النهاية. <br />
		[page:Float t] - عامل التداخل في الفترة المغلقة `[0، 1]`.<br /><br />
	 
		يعود بقيمة[link:https://en.wikipedia.org/wiki/Linear_interpolation متداخلة خطيًا ] 
		من نقطتين معروفتين بناءً على الفترة المعطاة -
	 	[page:Float t ] = 0 سيعود بـ[page:Float x ] و[page:Float t ] = 1 سوف
		يعود بـ[page:Float y ].
		</p>
	 
		<h3>
		[method:Float damp]( [param:Float x], [param:Float y], [param:Float lambda], [param:Float dt] )
		</h3>
		<p>
		[page:Float x] - نقطة حالية. <br />
		[page:Float y] - نقطة الهدف. <br />
		[page:Float lambda] - قيمة lambda أعلى ستجعل الحركة أكثر
		فجأة، وقيمة أقل ستجعل الحركة أكثر تدرجًا. <br />
		[page:Float dt] - وقت دلتا بالثواني.<br /><br />
	 
		تداخل عدد من[page:Float x ] نحو[page:Float y ] بطريقة
		ربيعية باستخدام[page:Float dt ] للحفاظ على حركة مستقلة عن معدل
		الإطارات. للحصول على التفاصيل، راجع
	 	[link:http://www.rorydriscoll.com/2016/03/07/frame-rate-independent-damping-using-lerp/ تخميد مستقل عن معدل الإطارات باستخدام lerp].
		</p>
	 

		<h3>
			[method:Float mapLinear]( [param:Float x], [param:Float a1], [param:Float a2], [param:Float b1], [param:Float b2] )
		</h3>
		<p>
		[page:Float x] — القيمة التي يتم تعيينها.<br />
		[page:Float a1] — الحد الأدنى للنطاق A.<br />
		[page:Float a2] — الحد الأقصى للنطاق A.<br />
		[page:Float b1] — الحد الأدنى للنطاق B.<br />
		[page:Float b2] — الحد الأقصى للنطاق B.<br /><br />
		 
		تعيين خطي لـ[page:Float x ] من النطاق [[page:Float a1 ], [page:Float a2 ]] إلى النطاق [[page:Float b1 ], [page:Float b2 ]].
		</p>
		 
		<h3>[method:Float pingpong]( [param:Float x], [param:Float length] )</h3>
		<p>
		[page:Float x] — القيمة التي يتم تعيينها.<br />
		[page:Float length] — القيمة الموجبة التي ستتعامل معها الوظيفة.
		الافتراضي هو 1.<br /><br />
		 
		يعود بقيمة تتبادل بين 0 و[param:Float length ].
		</p>
		 
		<h3>[method:Integer ceilPowerOfTwo]( [param:Number n] )</h3>
		<p>
		يعود بأصغر قوة من 2 أكبر من أو يساوي
		[page:Number n ].
		</p>
		 
		<h3>[method:Integer floorPowerOfTwo]( [param:Number n] )</h3>
		<p>
		يعود بأكبر قوة من 2 أقل من أو يساوي[page:Number n ].
		</p>
		 
		<h3>[method:Float radToDeg]( [param:Float radians] )</h3>
		<p>تحويل الراديان إلى درجات.</p>
		 
		<h3>[method:Float randFloat]( [param:Float low], [param:Float high] )</h3>
		<p>عشوائية عائمة في الفترة [[page:Float low ], [page:Float high ]].</p>
		 
		<h3>[method:Float randFloatSpread]( [param:Float range] )</h3>
		<p>
		عشوائية عائمة في الفترة [-[page:Float range ] / 2،[page:Float range ]
		/ 2].
		</p>
		 
		<h3>
		[method:Integer randInt]( [param:Integer low], [param:Integer high] )
		</h3>
		<p>عشوائية صحيحة في الفترة [[page:Float low ],[page:Float high ]].</p>
		 
		<h3>[method:Float seededRandom]( [param:Integer seed] )</h3>
		<p>
		عشوائية زائفة محددة عائمة في الفترة `[0، 1]`. هو اختیاری
		[page:Integer seed ].
		</p>
		 
		<h3>
			[method:Float smoothstep]( [param:Float x], [param:Float min], [param:Float max] )
		</h3>
		<p>
		[page:Float x] - القيمة التي يتم تقييمها بناءً على موقعها بين الحد
		الأدنى والأقصى. <br />
		[page:Float min] - أي قيمة x أدنى من الحد الأدنى ستكون 0.<br />
		[page:Float max] - أي قيمة x أعلى من الحد الأقصى ستكون 1.<br /><br />
		 
		يعود بقيمة بين 0-1 تمثل النسبة المئوية التي انتقلت فيها x بين الحد
		الأدنى والأقصى، ولكن تم تجانسها أو تبطئها كلما اقترب X من
		الحد الأدنى والأقصى.<br /><br />
		 
		راجع [link:http://en.wikipedia.org/wiki/Smoothstep Smoothstep] للحصول على التفاصيل.
		</p>
		 
		<h3>
		[method:Float smootherstep]( [param:Float x], [param:Float min], [param:Float max] )
		</h3>
		<p>
		[page:Float x] - القيمة التي يتم تقييمها بناءً على موقعها بين الحد
		الأدنى والأقصى. <br />
		[page:Float min] - أي قيمة x أدنى من الحد الأدنى ستكون 0.<br />
		[page:Float max] - أي قيمة x أعلى من الحد الأقصى ستكون 1.<br /><br />
		 
		يعود بقيمة بين 0-1. تغير على smoothstep
		يحتوي على مشتقات من الطلب 1st و 2nd صفر في x=0 و x=1.
		</p>
		 
		<h3>
		[method:undefined setQuaternionFromProperEuler]( [param:Quaternion q], [param:Float a], [param:Float b], [param:Float c], [param:String order] )
		</h3>
		<p>
		[page:Quaternion q] - رباعية لضبطها<br />
		[page:Float a] - التدوير المطبق على المحور الأول، بالراديان <br />
		[page:Float b] - التدوير المطبق على المحور الثاني، بالراديان
		<br />
		[page:Float c] - التدوير المطبق على المحور الثالث، بالراديان <br />
		[page:String order] - سلسلة تحدد ترتيب المحاور: 'XYX'، 'XZX'،
		'YXY'، 'YZY'، 'ZXZ'، أو 'ZYZ'<br /><br />
		 
		يضبط رباعية[page:Quaternion q ] من
		[link:http://en.wikipedia.org/wiki/Euler_angles زوايا أويلر Proper intrinsic ] 
		المعرفة بزوايا[page:Float a ]،[page:Float b ]، و[page:Float c ]، 
		والترتیب[page:String order].<br />
		 
		يتم تطبیق التدویرات على المحاور بالترتیب المحدد بـ[page:String order]: 
		يتم تطبیق التدویر بزاویة[page:Float a ] أولًا، ثم بزاویة
		[page:Float b ]، ثم بزاویة[page:Float c ]. زوایا هی فی رادیان.
		</p>
		 
		<h2>المصدر (Source)</h2>

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