r154

mrdoob · Jun 29, 2023 · 86c5e10 · 86c5e10
1 parent 9ad007a
commit 86c5e10
Show file tree

Hide file tree

Showing 931 changed files with 20,772 additions and 3,533 deletions.
diff --git a/build/three.cjs b/build/three.cjs
diff --git a/build/three.js b/build/three.js
diff --git a/build/three.min.js b/build/three.min.js
diff --git a/build/three.module.js b/build/three.module.js
diff --git a/build/three.module.min.js b/build/three.module.min.js
diff --git a/docs/api/ar/lights/AmbientLight.html b/docs/api/ar/lights/AmbientLight.html
@@ -0,0 +1,53 @@
+<!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">
+		[page:Object3D] &rarr; [page:Light] &rarr;
+
+		<h1>[name]</h1>
+
+		<p class="desc">
+			يضيء هذا الضوء جميع الأشياء في المشهد بشكل متساوٍ على مستوى العالم. <br /><br />
+
+			لا يمكن استخدام هذا الضوء لرمي الظلال لأنه لا يحتوي على اتجاه.
+		</p>
+
+		<h2>مثال الكود</h2>
+
+		<code>
+		const light = new THREE.AmbientLight( 0x404040 ); // soft white light
+		scene.add( light );
+		</code>
+
+		<h2>المنشئ (Constructor)</h2>
+
+		<h3>[name]( [param:Integer color], [param:Float intensity] )</h3>
+		<p>
+		[page:Integer color] - (اختياري) قيمة عددية لمكون RGB من
+		اللون. الافتراضي هو 0xffffff. <br />
+		[page:Float intensity] - (اختياري) قيمة عددية لـ
+		قوة / شدة الضوء. الافتراضي هو 1. <br /><br />
+
+		ينشئ [name] جديدًا.
+		</p>
+
+		<h2>الخصائص (Properties)</h2>
+		<p>انظر الفئة الأساسية [page:Light Light] للخصائص المشتركة.</p>
+
+		<h3>[property:Boolean isAmbientLight]</h3>
+		<p>علامة للقراءة فقط للتحقق مما إذا كان الكائن المعطى هو من نوع [name].</p>
+
+		<h2>الطرق (Methods)</h2>
+		<p>انظر الفئة الأساسية [page:Light Light] للطرق المشتركة.</p>
+		<h2>المصدر (Source)</h2>
+
+		<p>
+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
+		</p>
+	</body>
+</html>
diff --git a/docs/api/ar/lights/AmbientLightProbe.html b/docs/api/ar/lights/AmbientLightProbe.html
@@ -0,0 +1,49 @@
+<!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">
+		[page:Object3D] &rarr; [page:Light] &rarr; [page:LightProbe]
+
+		<h1>[name]</h1>
+
+		<p class="desc">
+			تعتبر مسابير الضوء طريقة بديلة لإضافة الضوء إلى مشهد ثلاثي الأبعاد.
+			AmbientLightProbe هي بيانات تقدير الضوء لضوء محيط واحد
+			في المشهد. لمزيد من المعلومات حول مسابير الضوء ، انتقل إلى
+			[page:LightProbe].
+		</p>
+
+		<h2>المنشئ (Constructor)</h2>
+
+		<h3>[name]( [param:Color color], [param:Float intensity] )</h3>
+		<p>
+		[page:Color color] - (اختياري) مثيل من Color ، سلسلة تمثل
+		لون أو رقم يمثل لونًا. <br />
+		[page:Float intensity] - (اختياري) قيمة عددية لـ
+		شدة مسبار الضوء. الافتراضي هو 1. <br /><br />
+
+		ينشئ [name] جديدًا.
+		</p>
+
+		<h2>الخصائص (Properties)</h2>
+		<p>
+		انظر الفئة الأساسية [page:LightProbe LightProbe] للخصائص المشتركة.
+		</p>
+
+		<h3>[property:Boolean isAmbientLightProbe]</h3>
+		<p>علامة للقراءة فقط للتحقق مما إذا كان الكائن المعطى هو من نوع [name].</p>
+
+		<h2>الطرق (Methods)</h2>
+		<p>انظر الفئة الأساسية [page:LightProbe LightProbe] للطرق المشتركة.</p>
+		<h2>المصدر (Source)</h2>
+
+		<p>
+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
+		</p>
+	</body>
+</html>
diff --git a/docs/api/ar/lights/DirectionalLight.html b/docs/api/ar/lights/DirectionalLight.html
@@ -0,0 +1,146 @@
+<!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">
+		[page:Object3D] &rarr; [page:Light] &rarr;
+
+		<h1>[name]</h1>
+
+		<p class="desc">
+			ضوء ينبعث في اتجاه محدد. سيتصرف هذا الضوء كما لو كان بعيدًا لانهائيًا وأن الأشعة المنبعثة منه كلها
+			متوازية. الاستخدام الشائع لهذا هو محاكاة ضوء النهار ؛ الشمس
+			بعيد بما يكفي بحيث يمكن اعتبار موقعه لانهائيًا ، و
+			جميع أشعة الضوء القادمة منه متوازية. <br /> <br />
+
+			يمكن لهذا الضوء إلقاء الظلال - انظر صفحة [page:DirectionalLightShadow]
+			للتفاصيل.
+		</p>
+
+		<h2>ملاحظة حول الموقف والهدف والدوران</h2>
+		<p>
+			نقطة شائعة من الالتباس بالنسبة للأضواء الاتجاهية هي أن تحديد
+			لا يؤثر التدوير. هذا لأن DirectionalLight في three.js هو
+			ما يعادل ما يسمى بـ "Target Direct Light" في غيره
+			التطبيقات. <br /> <br />
+
+			هذا يعني أن اتجاهه يتم حسابه كمؤشر من ضوء
+			[page:Object3D.position position] إلى [page:.target target] الموقف
+			(على عكس "Free Direct Light" التي لديها فقط دوران
+			مكون). <br /> <br />
+
+			السبب في ذلك هو السماح للضوء بإلقاء الظلال - ال
+			[page:.shadow shadow] تحتاج الكاميرا إلى موقف لحساب الظلال
+			من. <br /> <br />
+
+			انظر خاصية [page:.target target] أدناه للحصول على تفاصيل حول تحديث
+			الهدف.
+		</p>
+
+		<h2>مثال للكود</h2>
+
+		<code>
+		// ضوء اتجاهي أبيض بشدة نصفية يشرق من الأعلى.
+		const directionalLight = new THREE.DirectionalLight( 0xffffff, 0.5 );
+		scene.add( directionalLight );
+		</code>
+
+		<h2>أمثلة (Examples)</h2>
+		<p>
+		[example:misc_controls_fly controls / fly ]<br />
+		[example:webgl_effects_parallaxbarrier effects / parallaxbarrier ]<br />
+		[example:webgl_effects_stereo effects / stereo ]<br />
+		[example:webgl_geometry_extrude_splines geometry / extrude / splines ]<br />
+		[example:webgl_materials_bumpmap materials / bumpmap ]
+		</p>
+
+		<h2>المنشئ (Constructor)</h2>
+
+		<h3>[name]( [param:Color color], [param:Float intensity] )</h3>
+		<p>
+		[page:Color color] - (اختياري) مثيل من Color ، سلسلة تمثل
+		لون أو رقم يمثل لونًا. <br />
+		[page:Float intensity] - (اختياري) قيمة عددية لـ
+		شدة مسبار الضوء. الافتراضي هو 1. <br /><br />
+
+		ينشئ [name] جديدًا.
+		</p>
+
+		<h2>الخصائص (Properties)</h2>
+
+		<p>انظر قائمة [page:Light Light] الأساسية للخصائص المشتركة.</p>
+
+		<h3>[property:Boolean castShadow]</h3>
+		<p>
+		إذا تم تعيينه على `true` فإن الضوء سيلقي ظلالًا ديناميكية. <b>تحذير</b>: هذا هو
+		باهظ الثمن ويتطلب التلاعب لجعل الظلال تبدو صحيحة. انظر
+		[page:DirectionalLightShadow] للتفاصيل. الافتراضي هو `false`.
+		</p>
+
+		<h3>[property:Boolean isDirectionalLight]</h3>
+		<p>علامة للقراءة فقط للتحقق مما إذا كان الكائن المعطى هو من نوع [name].</p>
+
+		<h3>[property:Vector3 position]</h3>
+		<p>
+		يتم تعيين هذا يساوي [page:Object3D.DEFAULT_UP] (0، 1، 0) ، بحيث
+		الضوء يشرق من الأعلى إلى الأسفل.
+		</p>
+
+		<h3>[property:DirectionalLightShadow shadow]</h3>
+		<p>
+		[page:DirectionalLightShadow] يستخدم لحساب الظلال لهذا الضوء.
+		</p>
+
+		<h3>[property:Object3D target]</h3>
+		<p>
+		يشير DirectionalLight من [page:.position position] إلى
+		target.position. الموضع الافتراضي للهدف هو `(0، 0، 0)`. <br />
+
+		<b>ملاحظة</b>: لتغيير موضع الهدف إلى أي شيء آخر غير
+		الافتراضي ، يجب إضافته إلى [page:Scene scene] باستخدام
+		</p>
+		<code>
+		scene.add( light.target );
+		</code>
+		<p>
+		هذا حتى يتم تحديث [page:Object3D.matrixWorld matrixWorld] الخاص بالهدف
+		تلقائيًا كل إطار. <br /><br />
+
+		من الممكن أيضًا تعيين الهدف ليكون كائنًا آخر في المشهد
+		(أي شيء يحتوي على خاصية [page:Object3D.position position]) ، مثل:
+		</p>
+		<code>
+		const targetObject = new THREE.Object3D(); 
+		scene.add(targetObject);
+
+		light.target = targetObject;
+		</code>
+		<p>سيتبع directionalLight الكائن الهدف الآن.</p>
+
+		<h2>الطرق (Methods)</h2>
+
+		<p>انظر الفئة الأساسية [page:Light Light] للطرق المشتركة.</p>
+
+		<h3>[method:undefined dispose]()</h3>
+		<p>
+		تحرير الموارد ذات الصلة بوحدة معالجة الرسومات التى تم تخصيصها من قبل هذه الحالة. استدعاء هذه
+		الطریقة كلما لم يعد يستخدم هذه الحال فى تطبیقك.
+		</p>
+
+		<h3>[method:this copy]( [param:DirectionalLight source] )</h3>
+		<p>
+		ينسخ قيمة جمیع خصائص من [page:DirectionalLight source]
+		إلى هذا DirectionalLight.
+		</p>
+
+		<h2>المصدر (Source)</h2>
+
+		<p>
+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
+		</p>
+	</body>
+</html>
diff --git a/docs/api/ar/lights/HemisphereLight.html b/docs/api/ar/lights/HemisphereLight.html
@@ -0,0 +1,93 @@
+<!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">
+		[page:Object3D] &rarr; [page:Light] &rarr;
+
+		<h1>[name]</h1>
+
+		<p class="desc">
+			مصدر ضوء موضوع مباشرة فوق المشهد ، مع تلاشي اللون من
+			لون السماء إلى لون الأرض. <br /> <br />
+			لا يمكن استخدام هذا الضوء لإلقاء الظلال.
+		</p>
+
+		<h2>مثال للكود</h2>
+		<code>
+		const light = new THREE.HemisphereLight( 0xffffbb, 0x080820, 1 );
+		scene.add( light );
+		</code>
+
+		<h2>أمثلة (Examples)</h2>
+
+		<p>
+		[example:webgl_animation_skinning_blending animation / skinning / blending ]<br />
+		[example:webgl_lights_hemisphere lights / hemisphere ]<br />
+		[example:misc_controls_pointerlock controls / pointerlock ]<br />
+		[example:webgl_loader_collada_kinematics loader / collada / kinematics ]<br />
+		[example:webgl_loader_stl loader / stl ]
+		</p>
+
+		<h2>المنشئ (Constructor)</h2>
+		<h3>
+		[name]( [param:Integer skyColor], [param:Integer groundColor],
+		[param:Float intensity] )
+		</h3>
+		<p>
+		[page:Integer skyColor] - (optional) لون سداسي عشري للسماء. الافتراضي
+		هو 0xffffff.<br />
+		[page:Integer groundColor] - (optional) لون سداسي عشري للأرض.
+		الافتراضي هو 0xffffff.<br />
+		[page:Float intensity] - (optional) قيمة رقمية لـ
+		قوة / شدة الضوء. الافتراضي هو 1.<br /><br />
+
+		يخلق جديد [name].
+		</p>
+
+		<h2>الخصائص (Properties)</h2>
+		<p>انظر قائمة [page:Light Light] الأساسية للخصائص المشتركة.</p>
+
+		<h3>[property:Float color]</h3>
+		<p>
+		لون سماء الضوء ، كما تم تمريره في المُنشئ. الافتراضي هو جديد
+		[page:Color] محدد على الأبيض (0xffffff).
+		</p>
+
+		<h3>[property:Float groundColor]</h3>
+		<p>
+		لون أرضية الضوء ، كما تم تمريره في المُنشئ. الافتراضي هو جديد
+		[page:Color] محدد على الأبيض (0xffffff).
+		</p>
+
+		<h3>[property:Boolean isHemisphereLight]</h3>
+		<p>علامة للقراءة فقط للتحقق مما إذا كان كائنًا معينًا من نوع [name].</p>
+
+		<h3>[property:Vector3 position]</h3>
+		<p>
+		يتم تعيين هذا يساوي [page:Object3D.DEFAULT_UP] (0، 1، 0) ، بحيث
+		يشرق الضوء من أعلى إلى أسفل.
+		</p>
+
+		<h2>الطرق (Methods)</h2>
+
+		<p>انظر قائمة [page:Light Light] الأساسية للطرق المشتركة.</p>
+
+		<h3>[method:this copy]( [param:HemisphereLight source] )</h3>
+		<p>
+		ينسخ قيمة [page:.color color] و[page:.intensity intensity] و
+		[page:.groundColor groundColor] من ضوء المصدر [page:Light source] إلى
+		هذا واحد.
+		</p>
+
+		<h2>المصدر (Source)</h2>
+
+		<p>
+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
+		</p>
+	</body>
+</html>
diff --git a/docs/api/ar/lights/HemisphereLightProbe.html b/docs/api/ar/lights/HemisphereLightProbe.html
@@ -0,0 +1,53 @@
+<!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">
+		[page:Object3D] &rarr; [page:Light] &rarr; [page:LightProbe]
+
+		<h1>[name]</h1>
+
+		<p class="desc">
+			مسابير الضوء هي طريقة بديلة لإضافة الضوء إلى مشهد ثلاثي الأبعاد.
+			HemisphereLightProbe هي بيانات تقدير الضوء لضوء نصف كرة واحد
+			في المشهد. لمزيد من المعلومات حول مسابير الضوء ، انتقل إلى
+			[page:LightProbe].
+		</p>
+
+		<h2>المنشئ (Constructor)</h2>
+
+		<h3>
+		[name]( [param:Color skyColor], [param:Color groundColor], [param:Float intensity] )
+		</h3>
+		<p>
+		[page:Color skyColor] - (اختياري) مثيل من Color ، سلسلة
+		يمثل لونًا أو رقمًا يمثل لونًا.<br />
+		[page:Color groundColor] - (اختياري) مثيل من Color ، سلسلة
+		يمثل لونًا أو رقمًا يمثل لونًا.<br />
+		[page:Float intensity] - (اختياري) قيمة رقمية لـ
+		شدة مسبار الضوء. الافتراضي هو 1.<br /><br />
+
+		يخلق جديد [name].
+		</p>
+
+		<h2>الخصائص (Properties)</h2>
+		<p>
+		انظر قائمة [page:LightProbe LightProbe] الأساسية للخصائص المشتركة.
+		</p>
+
+		<h3>[property:Boolean isHemisphereLightProbe]</h3>
+		<p>علامة للقراءة فقط للتحقق مما إذا كان كائنًا معينًا من نوع [name].</p>
+
+		<h2>الطرق (Methods)</h2>
+		<p>انظر قائمة [page:LightProbe LightProbe] الأساسية للطرق المشتركة.</p>
+		<h2>المصدر (Source)</h2>
+
+		<p>
+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
+		</p>
+	</body>
+</html>