Docs: Translating Scenes section into Arabic (ar). (#26362)

* update list.json to include the Scenes section of arabic docs * add arabic translation for Fog page * add arabic translation for FogExp2 page * add arabic translation for Scene page
mrdoob · Jul 3, 2023 · 54a7d7f · 54a7d7f
1 parent 2f4e4e3
commit 54a7d7f
Show file tree

Hide file tree

Showing 4 changed files with 246 additions and 0 deletions.
diff --git a/docs/api/ar/scenes/Fog.html b/docs/api/ar/scenes/Fog.html
@@ -0,0 +1,80 @@
+<!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>مثال للكود</h2>
+
+		<code>
+		const scene = new THREE.Scene();
+		scene.fog = new THREE.Fog( 0xcccccc, 10, 15 );
+		</code>
+
+		<h2>المنشئ (Constructor)</h2>
+
+		<h3>
+		[name]( [param:Integer color], [param:Float near], [param:Float far] )
+		</h3>
+		<p>
+		يتم تمرير معلمة اللون إلى [page:Color] المنشئ لتعيين
+		خاصية اللون. يمكن أن يكون اللون عددًا صحيحًا سداسي عشريًا أو سلسلة على طراز CSS.
+		</p>
+
+		<h2>الخصائص (Properties)</h2>
+
+		<h3>[property:Boolean isFog]</h3>
+		<p>علامة للقراءة فقط للتحقق مما إذا كان كائنًا معطىً من نوع [name].</p>
+
+		<h3>[property:String name]</h3>
+		<p>
+		اسم اختياري للكائن (لا يحتاج إلى أن يكون فريدًا). الافتراضي هو
+		سلسلة فارغة.
+		</p>
+
+		<h3>[property:Color color]</h3>
+		<p>
+		لون الضباب. مثال: إذا تم تعيينه على الأسود ، سيتم عرض الأشياء البعيدة
+		أسود.
+		</p>
+
+		<h3>[property:Float near]</h3>
+		<p>
+		المسافة الدنيا لبدء تطبيق الضباب. الأشياء التي هي أقل من
+		'near' units from the active camera won't be affected by fog.
+		</p>
+		<p>الافتراضي هو `1`.</p>
+
+		<h3>[property:Float far]</h3>
+		<p>
+		المسافة القصوى التي يتوقف فيها حساب وتطبيق الضباب.
+		الأشياء التي تبعد أكثر من 'far' units away from the active camera won't
+		يتأثر بالضباب.
+		</p>
+		<p>الافتراضي هو `1000`.</p>
+
+		<h2>الطرق (Methods)</h2>
+
+		<h3>[method:Fog clone]()</h3>
+		<p>يرجع مثيل ضباب جديد بنفس المعلمات كهذا.</p>
+
+		<h3>[method:Object toJSON]()</h3>
+		<p>إرجاع بيانات الضباب في تنسيق JSON.</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/scenes/FogExp2.html b/docs/api/ar/scenes/FogExp2.html
@@ -0,0 +1,68 @@
+<!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>مثال للكود</h2>
+
+		<code>
+		const scene = new THREE.Scene();
+		scene.fog = new THREE.FogExp2( 0xcccccc, 0.002 );
+		</code>
+
+		<h2>المنشئ (Constructor)</h2>
+
+		<h3>[name]( [param:Integer color], [param:Float density] )</h3>
+
+		<p>
+		يتم تمرير معلمة اللون إلى [page:Color] المنشئ لتعيين
+		خاصية اللون. يمكن أن يكون اللون عددًا صحيحًا سداسي عشريًا أو سلسلة على طراز CSS.
+		</p>
+		<h2>الخصائص (Properties)</h2>
+
+		<h3>[property:Boolean isFogExp2]</h3>
+		<p>علامة للقراءة فقط للتحقق مما إذا كان كائنًا معطىً من نوع [name].</p>
+
+		<h3>[property:String name]</h3>
+		<p>
+		اسم اختياري للكائن (لا يحتاج إلى أن يكون فريدًا). الافتراضي هو
+		سلسلة فارغة.
+		</p>
+
+		<h3>[property:Color color]</h3>
+		<p>
+		لون الضباب. مثال: إذا تم تعيينه على الأسود ، سيتم عرض الأشياء البعيدة
+		أسود.
+		</p>
+
+		<h3>[property:Float density]</h3>
+		<p>يحدد مدى سرعة نمو الضباب.</p>
+		<p>الافتراضي هو `0.00025`.</p>
+
+		<h2>الطرق (Methods)</h2>
+
+		<h3>[method:FogExp2 clone]()</h3>
+		<p>يرجع مثيل FogExp2 جديد بنفس المعلمات كهذا.</p>
+
+		<h3>[method:Object toJSON]()</h3>
+		<p>إرجاع بيانات FogExp2 في تنسيق JSON.</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/scenes/Scene.html b/docs/api/ar/scenes/Scene.html
@@ -0,0 +1,92 @@
+<!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;
+		<h1>[name]</h1>
+
+		<p class="desc">
+		تسمح لك المشاهد بتحديد ما وأين يتم تجسيده بواسطة three.js.
+		هذا هو المكان الذي تضع فيه الأشياء والأضواء والكاميرات.
+		</p>
+
+		<h2>المنشئ (Constructor)</h2>
+
+		<h3>[name]()</h3>
+		<p>إنشاء كائن مشهد جديد.</p>
+
+		<h2>الخصائص (Properties)</h2>
+
+		<h3>[property:Object background]</h3>
+		<p>
+		يحدد خلفية المشهد. الافتراضي هو `null`. المدخلات الصالحة هي:
+		</p>
+		<ul>
+			<li>[page:Color] لتحديد خلفية ملونة موحدة.</li>
+			<li>[page:Texture] لتحديد خلفية ملمس (مسطح).</li>
+			<li>
+			مكعبات القوام ([page:CubeTexture]) أو القوام المستطيلة لـ
+			تحديد صندوق سماء.
+			</li>
+		</ul>
+		ملاحظة: يتم تجاهل أي تكوينات ذات صلة بالكاميرا مثل `zoom` أو `view`.
+
+		<h3>[property:Float backgroundBlurriness]</h3>
+		<p>
+		يحدد ضبابية الخلفية. يؤثر فقط على خرائط البيئة
+		المعينة إلى [page:Scene.background]. الإدخال الصالح هو عدد عشري بين `0`
+		و `1`. الافتراضي هو `0`.
+		</p>
+
+		<h3>[property:Float backgroundIntensity]</h3>
+		<p>
+		يضعف لون الخلفية. ينطبق فقط على خلفية
+		الملمس. الافتراضي هو `1`.
+		</p>
+
+		<h3>[property:Texture environment]</h3>
+		<p>
+		يحدد خريطة البيئة لجميع المواد الفعلية في المشهد. ومع ذلك ،
+		ليس من الممكن الكتابة فوق نسيج موجود معين إلى
+		[page:MeshStandardMaterial.envMap]. الافتراضي هو `null`.
+		</p>
+
+		<h3>[property:Fog fog]</h3>
+
+		<p>
+		مثيل [page:Fog fog] يحدد نوع الضباب الذي يؤثر على كل شيء
+		تم تجسيده في المشهد. الافتراضي هو `null`.
+		</p>
+
+		<h3>[property:Boolean isScene]</h3>
+		<p>علامة للقراءة فقط للتحقق مما إذا كان كائنًا معطىً من نوع [name].</p>
+
+		<h3>[property:Material overrideMaterial]</h3>
+
+		<p>
+		يجبر كل شيء في المشهد على التجسيم باستخدام المادة المحددة.
+		الافتراضي هو `null`.
+		</p>
+
+		<h2>الطرق (Methods)</h2>
+
+		<h3>[method:Object toJSON]( [param:Object meta] )</h3>
+		<p>
+		meta - كائن يحتوي على بيانات تعريفية مثل الملمس أو الصور لـ
+		scene. <br />
+		قم بتحويل المشهد إلى three.js
+		[link:https://github.com/mrdoob/three.js/wiki/JSON-Object-Scene-format-4 JSON Object/Scene format].
+		</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/list.json b/docs/list.json
@@ -730,6 +730,12 @@
 
 			"Renderers / WebXR": {
 				"WebXRManager": "api/ar/renderers/webxr/WebXRManager"
+			},
+
+			"Scenes": {
+				"Fog": "api/ar/scenes/Fog",
+				"FogExp2": "api/ar/scenes/FogExp2",
+				"Scene": "api/ar/scenes/Scene"
 			}
 
 		}