Explorar o código

Docs: Translating Extras section into Arabic (ar). (#26132)

* add arabic translation for DataUtils page

* add arabic translation for Earcut page

* add arabic translation for ImageUtils page

* add arabic translation for PMREMGenerator page

* add arabic translation for ShapeUtils page

* update list.json to include the extras section of arabic docs
Omar Khalifa %!s(int64=2) %!d(string=hai) anos
pai
achega
cfc782958f

+ 36 - 0
docs/api/ar/extras/DataUtils.html

@@ -0,0 +1,36 @@
+<!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:Number toHalfFloat]( [param:Number val] )</h3>
+		<p>
+			val -- قيمة عائمة بدقة مفردة.<br /><br />
+	 
+			يعود بقيمة عائمة نصف الدقة من القيمة العائمة بدقة مفردة المعطاة.
+		</p>
+	 
+		<h3>[method:Number fromHalfFloat]( [param:Number val] )</h3>
+		<p>
+			val -- قيمة عائمة نصف الدقة.<br /><br />
+	 
+			يعود بقيمة عائمة بدقة مفردة من القيمة العائمة نصف الدقة المعطاة.
+		</p>
+
+		<h2>المصدر (Source)</h2>
+
+		<p>
+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
+		</p>
+	</body>
+</html>

+ 33 - 0
docs/api/ar/extras/Earcut.html

@@ -0,0 +1,33 @@
+<!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">
+			تنفيذ لخوارزمية تثليث المضلع earcut. الكود هو نقل من [link:https://github.com/mapbox/earcut mapbox/earcut].
+		</p>
+	 
+		<h2>الوظائف (Methods)</h2>
+	 
+		<h3>[method:Array triangulate]( data, holeIndices, dim )</h3>
+		<p>
+			data -- مصفوفة مسطحة من إحداثيات الرأس.<br />
+			holeIndices -- مصفوفة من فهارس الثقوب إن وجدت.<br />
+			dim -- عدد الإحداثيات لكل رأس في المصفوفة الإدخال.<br /><br />
+	 
+			يثلث التعريف الشكل المعطى عن طريق إرجاع مصفوفة من المثلثات. يتم تعريف المثلث بثلاثة أعداد صحيحة متتالية تمثل فهارس الرأس.
+		</p>
+	 
+		<h2>المصدر (Source)</h2>
+
+		<p>
+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
+		</p>
+	</body>
+</html>

+ 42 - 0
docs/api/ar/extras/ImageUtils.html

@@ -0,0 +1,42 @@
+<!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:String getDataURL]( [param:HTMLCanvasElement image] |
+			[param:HTMLImageElement image] | [param:ImageBitmap image] )
+		</h3>
+		<p>
+			image -- كائن الصورة.<br /><br />
+	 
+			يعود بـ URI بيانات يحتوي على تمثيل للصورة المعطاة.
+		</p>
+	 
+		<h3>
+			[method:Object sRGBToLinear]( [param:HTMLCanvasElement image] |
+			[param:HTMLImageElement image] | [param:ImageBitmap image] )
+		</h3>
+		<p>
+			image -- كائن الصورة.<br /><br />
+	 
+			يحول بيانات الصورة sRGB المعطاة إلى مساحة اللون الخطية.
+		</p>
+
+		<h2>المصدر (Source)</h2>
+
+		<p>
+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
+		</p>
+	</body>
+</html>

+ 111 - 0
docs/api/ar/extras/PMREMGenerator.html

@@ -0,0 +1,111 @@
+<!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">
+			تولد هذه الفئة خريطة بيئة إشعاعية محددة مسبقًا ومتدرجة (PMREM) من نسيج بيئة cubeMap. يسمح هذا بالوصول السريع إلى مستويات مختلفة من التشويش بناءً على خشونة المادة. على عكس سلسلة mipmap التقليدية ، فإنها تنخفض فقط إلى مستوى LOD_MIN (أعلاه) ، ثم تنشئ "mips" إضافية مُصفاة حتى أكثر في نفس دقة LOD_MIN ، المرتبطة بمستويات خشونة أعلى. بهذه الطريقة نحافظ على الدقة لتداخل الإضاءة المنتشرة بسلاسة مع تحديد حسابات العينات.<br /><br />
+	 
+			ملاحظة: يعتمد خشونة [page:MeshStandardMaterial] الأدنى على حجم النسيج المقدم. إذا كانت عملية التصيير لديك أبعادًا صغيرة أو كانت الأجزاء اللامعة لديها الكثير من التقوس ، فقد لا تزال قادرًا على التخلص من حجم نسيج أصغر.
+		</p>
+
+		<table>
+			<tr>
+				<th>حجم النسيج (texture size)</th>
+				<td>الخشونة الدنيا (minimum roughness)</td>
+			</tr>
+			<tr>
+				<td>16</td>
+				<td>0.21</td>
+			</tr>
+			<tr>
+				<td>32</td>
+				<td>0.15</td>
+			</tr>
+			<tr>
+				<td>64</td>
+				<td>0.11</td>
+			</tr>
+			<tr>
+				<td>128</td>
+				<td>0.076</td>
+			</tr>
+			<tr>
+				<td>256</td>
+				<td>0.054</td>
+			</tr>
+			<tr>
+				<td>512</td>
+				<td>0.038</td>
+			</tr>
+			<tr>
+				<td>1024</td>
+				<td>0.027</td>
+			</tr>
+		</table>
+
+		<h2>المنشئ (Constructor)</h2>
+
+		<h3>[name]( [param:WebGLRenderer renderer] )</h3>
+		<p>ينشئ هذا المنشئ [name] جديدًا.</p>
+	 
+		<h2>الوظائف (Methods)</h2>
+	 
+		<h3>
+			[method:WebGLRenderTarget fromScene]( [param:Scene scene], [param:Number sigma], [param:Number near], [param:Number far] )
+		</h3>
+		<p>
+			[page:Scene scene] - المشهد المعطى.<br />
+			[page:Number sigma] - (اختياري) يحدد نصف قطر التشويش بالراديان ليتم تطبيقه على المشهد قبل إنشاء PMREM. الافتراضي هو `0`.<br />
+			[page:Number near] - (اختياري) قيمة السطح القريب. الافتراضي هو `0.1`.<br />
+			[page:Number far] - (اختياري) قيمة السطح البعيد. الافتراضي هو `100`.<br /><br />
+	 
+			يولد PMREM من مشهد معطى ، والذي يمكن أن يكون أسرع من استخدام صورة إذا كانت عرض النطاق الترددي للشبكة منخفضة. تضمن الأسطح القريبة والبعيدة الاختيارية عرض المشهد بأكمله (يتم وضع cubeCamera في المنشأ).
+		</p>
+	 
+		<h3>
+			[method:WebGLRenderTarget fromEquirectangular]( [param:Texture equirectangular] )
+		</h3>
+		<p>
+			[page:Texture equirectangular] - نسيج equirectangular.<br /><br />
+	 
+			يولد PMREM من نسيج equirectangular.
+		</p>
+	 
+		<h3>
+			[method:WebGLRenderTarget fromCubemap]( [param:CubeTexture cubemap] )
+		</h3>
+		<p>
+			[page:CubeTexture cubemap] - نسيج cubemap.<br /><br />
+	 
+			يولد PMREM من نسيج cubemap.
+		</p>
+	 
+		<h3>[method:undefined compileCubemapShader]()</h3>
+		<p>
+			يجمع مسبقًا شادر cubemap. يمكنك الحصول على بدء تشغيل أسرع عن طريق استدعاء هذه الطريقة أثناء جلب شبكة نسيجك لزيادة التزامن.
+		</p>
+	 
+		<h3>[method:undefined compileEquirectangularShader]()</h3>
+		<p>
+			يجمع مسبقًا شادر equirectangular. يمكنك الحصول على بدء تشغيل أسرع عن طريق استدعاء هذه الطريقة أثناء جلب شبكة نسيجك لزيادة التزامن.
+		</p>
+	 
+		<h3>[method:undefined dispose]()</h3>
+		<p>
+			يحرر الموارد المتعلقة بوحدة معالجة الرسومات التي تم تخصيصها من قبل هذه الحالة. استدعِ هذه الطريقة كلما لم يعُد هذا المثيل مستخدمًا في تطبيقك.
+		</p>
+
+		<h2>المصدر (Source)</h2>
+
+		<p>
+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
+		</p>
+	</body>
+</html>

+ 52 - 0
docs/api/ar/extras/ShapeUtils.html

@@ -0,0 +1,52 @@
+<!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">
+			فئة تحتوي على دوال مساعدة للأشكال.<br /><br />
+	 
+			لاحظ أن هذه كلها دوال خطية لذلك يجب حسابها بشكل منفصل لمكونات x و y (و z و w إذا كانت موجودة) من متجه.
+		</p>
+	 
+		<h2>الوظائف (Methods)</h2>
+	 
+		<h3>[method:Number area]( contour )</h3>
+		<p>
+			contour -- مضلع 2D. مصفوفة من THREE.Vector2()<br /><br />
+	 
+			حساب مساحة مضلع (2D) المحيط.
+		</p>
+	 
+		<h3>[method:Boolean isClockWise]( pts )</h3>
+		<p>
+			pts -- نقاط تحدد مضلع 2D<br /><br />
+	 
+			لاحظ أن هذه هي دالة خطية لذلك يجب حسابها بشكل منفصل لمكونات x و y من المضلع.<br /><br />
+	 
+			يستخدم داخليًا بواسطة [page:Path Path] و [page:ExtrudeGeometry ExtrudeGeometry] و [page:ShapeGeometry ShapeGeometry].
+		</p>
+	 
+		<h3>[method:Array triangulateShape]( contour, holes )</h3>
+		<p>
+			contour -- مضلع 2D. مصفوفة من [page:Vector2].<br />
+			holes -- مصفوفة تحتوي على مصفوفات من [page:Vector2]s. كل مصفوفة
+			تمثل تعريف ثقب واحد.<br /><br />
+	 
+			يستخدم داخليًا بواسطة [page:ExtrudeGeometry ExtrudeGeometry] و
+			[page:ShapeGeometry ShapeGeometry] لحساب الوجوه في الأشكال التي بها ثقوب.
+		</p>
+
+		<h2>المصدر (Source)</h2>
+
+		<p>
+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
+		</p>
+	</body>
+</html>

+ 8 - 0
docs/list.json

@@ -529,6 +529,14 @@
 
 
 			"Core / BufferAttributes": {
 			"Core / BufferAttributes": {
 				"BufferAttribute Types": "api/ar/core/bufferAttributeTypes/BufferAttributeTypes"
 				"BufferAttribute Types": "api/ar/core/bufferAttributeTypes/BufferAttributeTypes"
+			},
+
+			"Extras": {
+				"DataUtils": "api/ar/extras/DataUtils",
+				"Earcut": "api/ar/extras/Earcut",
+				"ImageUtils": "api/ar/extras/ImageUtils",
+				"PMREMGenerator": "api/ar/extras/PMREMGenerator",
+				"ShapeUtils": "api/ar/extras/ShapeUtils"
 			}
 			}
 
 
 		}
 		}