Bläddra i källkod

Docs: Translating Helpers section into Arabic (ar). (#26174)

* update list.json to include the Helpers section of arabic docs

* add arabic translation for ArrowHelper page

* add arabic translation for AxesHelper page

* add arabic translation for Box3Helper page

* add arabic translation for BoxHelper page

* add arabic translation for CameraHelper page

* add arabic translation for DirectionLightHelper page

* add arabic translation for GridHelper page

* add arabic translation for HemisphereLightHelper page

* add arabic translation for PlaneHelper page

* add arabic translation for PointLightHelper page

* add arabic translation for PolarGridHelper page

* add arabic translation for SkeletonHelper page

* add arabic translation for SpotLightHelper page
Omar Khalifa 2 år sedan
förälder
incheckning
95f678c9ca

+ 103 - 0
docs/api/ar/helpers/ArrowHelper.html

@@ -0,0 +1,103 @@
+<!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">كائن سهم ثلاثي الأبعاد لتصور الاتجاهات.</p>
+
+		<h2>مثال الكود</h2>
+
+		<code>
+		const dir = new THREE.Vector3( 1, 2, 0 );
+
+		//normalize the direction vector (convert to vector of length 1)
+		dir.normalize();
+
+		const origin = new THREE.Vector3( 0, 0, 0 );
+		const length = 1;
+		const hex = 0xffff00;
+
+		const arrowHelper = new THREE.ArrowHelper( dir, origin, length, hex );
+		scene.add( arrowHelper );
+		</code>
+
+		<h2>أمثلة (Examples)</h2>
+
+		<p>[example:webgl_shadowmesh WebGL / shadowmesh]</p>
+
+		<h2>المنشئ (Constructor)</h2>
+
+		<h3>
+		[name]([param:Vector3 dir], [param:Vector3 origin], [param:Number length],
+		[param:Number hex], [param:Number headLength], [param:Number headWidth])
+		</h3>
+		<p>
+		[page:Vector3 dir] - الاتجاه من المنشأ. يجب أن يكون متجه وحدة. <br />
+		[page:Vector3 origin] - النقطة التي يبدأ فيها السهم.<br />
+		[page:Number length] - طول السهم. الافتراضي هو `1`.<br />
+		[page:Number hex] - قيمة ست عشرية لتحديد اللون. الافتراضي هو
+		0xffff00.<br />
+		[page:Number headLength] - طول رأس السهم. الافتراضي
+		هو 0.2 * الطول.<br />
+		[page:Number headWidth] - عرض رأس السهم. الافتراضي هو
+		0.2 * headLength.<br />
+		</p>
+
+		<h2>الخصائص (Properties)</h2>
+		<p>انظر إلى قاعدة [page:Object3D] class للخصائص المشتركة.</p>
+
+		<h3>[property:Line line]</h3>
+		<p>يحتوي على جزء الخط من المساعد السهم.</p>
+
+		<h3>[property:Mesh cone]</h3>
+		<p>يحتوي على جزء المخروط من المساعد السهم.</p>
+
+		<h2>الطرق (Methods)</h2>
+		<p>انظر إلى قاعدة [page:Object3D] class للطرق المشتركة.</p>
+
+		<h3>[method:undefined setColor]([param:Color color])</h3>
+		<p>
+		اللون - اللون المطلوب.<br /><br />
+
+		يضبط لون المساعد السهم.
+		</p>
+
+		<h3>
+		[method:undefined setLength]([param:Number length], [param:Number headLength], [param:Number headWidth])
+		</h3>
+		<p>
+		الطول - الطول المطلوب.<br />
+		headLength - طول رأس السهم.<br />
+		headWidth - عرض رأس السهم.<br /><br />
+
+		يضبط طول المساعد السهم.
+		</p>
+
+		<h3>[method:undefined setDirection]([param:Vector3 dir])</h3>
+		<p>
+		dir - الاتجاه المطلوب. يجب أن يكون متجه وحدة.<br /><br />
+
+		يضبط اتجاه المساعد السهم.
+		</p>
+
+		<h3>[method:undefined dispose]()</h3>
+		<p>
+		يحرر الموارد المتعلقة بالـ GPU التي تم تخصيصها من قبل هذا المثيل. اتصل بهذه
+		الطريقة كلما لم يعد هذا المثيل مستخدمًا في تطبيقك.
+		</p>
+
+		<h2>المصدر (Source)</h2>
+
+		<p>
+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
+		</p>
+	</body>
+</html>

+ 64 - 0
docs/api/ar/helpers/AxesHelper.html

@@ -0,0 +1,64 @@
+<!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:Line] &rarr; [page:LineSegments] &rarr;
+
+		<h1>[name]</h1>
+		<p class="desc">
+			كائن المحور لتصور المحاور الثلاثة بطريقة بسيطة. <br />
+			المحور X هو اللون الأحمر. المحور Y هو اللون الأخضر. المحور Z هو اللون الأزرق.
+		</p>
+			
+		<h2>مثال الكود</h2>
+			
+		<code>
+const axesHelper = new THREE.AxesHelper( 5 );
+scene.add( axesHelper );
+		</code>
+
+		<h2>أمثلة (Examples)</h2>
+		<p>
+		[example:webgl_buffergeometry_compression WebGL / buffergeometry / compression]<br />
+		[example:webgl_geometry_convex WebGL / geometry / convex]<br />
+		[example:webgl_loader_nrrd WebGL / loader / nrrd]
+		</p>
+		
+		<h2>المنشئ (Constructor)</h2>
+		<h3>[name]( [param:Number size] )</h3>
+		<p>
+		[page:Number size] - (اختياري) حجم الخطوط التي تمثل المحاور.
+		الافتراضي هو `1`.
+		</p>
+		
+		<h2>الخصائص (Properties)</h2>
+		<p>انظر إلى قاعدة [page:LineSegments] class للخصائص المشتركة.</p>
+		
+		<h2>الطرق (Methods)</h2>
+		<p>انظر إلى قاعدة [page:LineSegments] class للطرق المشتركة.</p>
+		
+		<h3>
+		[method:this setColors]( [param:Color xAxisColor], [param:Color yAxisColor], [param:Color zAxisColor] )
+		</h3>
+		<p>
+		يضبط ألوان المحاور إلى [page:Color xAxisColor]، [page:Color yAxisColor]،
+		[page:Color zAxisColor].
+		</p>
+		
+		<h3>[method:undefined dispose]()</h3>
+		<p>
+		يحرر الموارد المتعلقة بالـ GPU التي تم تخصيصها من قبل هذا المثيل. اتصل بهذه
+		الطريقة كلما لم يعد هذا المثيل مستخدمًا في تطبيقك.
+		</p>
+
+		<h2>المصدر (Source)</h2>
+		<p>
+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
+		</p>
+	</body>
+</html>

+ 62 - 0
docs/api/ar/helpers/Box3Helper.html

@@ -0,0 +1,62 @@
+<!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:Line] &rarr; [page:LineSegments] &rarr;
+
+		<h1>[name]</h1>
+
+		<p class="desc">كائن مساعد لتصور [page:Box3].</p>
+
+		<h2>مثال الكود</h2>
+
+		<code>
+		const box = new THREE.Box3();
+		box.setFromCenterAndSize( new THREE.Vector3( 1, 1, 1 ), new THREE.Vector3( 2, 1, 3 ) );
+
+		const helper = new THREE.Box3Helper( box, 0xffff00 );
+		scene.add( helper );
+		</code>
+
+		<h2>المنشئ (Constructor)</h2>
+
+		<h3>[name]( [param:Box3 box], [param:Color color] )</h3>
+		<p>
+		[page:Box3 box] -- الـ Box3 المراد عرضه.<br />
+		[page:Color color] -- (اختياري) لون الصندوق. الافتراضي هو 0xffff00.<br /><br />
+
+		ينشئ صندوقًا جديدًا بإطار سلكي يمثل Box3 المُمرَّر.
+		</p>
+
+		<h2>الخصائص (Properties)</h2>
+		<p>انظر إلى الفئة الأساسية [page:LineSegments] للحصول على الخصائص المشتركة.</p>
+
+		<h3>[property:Box3 box]</h3>
+		<p>الـ Box3 المُعروض.</p>
+
+		<h2>الطرق (Methods)</h2>
+		<p>انظر إلى الفئة الأساسية [page:LineSegments] للحصول على الطرق المشتركة.</p>
+
+		<h3>[method:undefined updateMatrixWorld]( [param:Boolean force] )</h3>
+		<p>
+		هذا يتجاوز الطريقة في الفئة الأساسية [page:Object3D] بحيث يُحدِّث أيضًا
+		الإطار السلكي للصندوق إلى مدى خاصية [page:Box3Helper.box .box].
+		</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>

+ 77 - 0
docs/api/ar/helpers/BoxHelper.html

@@ -0,0 +1,77 @@
+<!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:Line] &rarr; [page:LineSegments] &rarr;
+
+		<h1>[name]</h1>
+
+		<p class="desc">
+			كائن مساعد لإظهار الحدود المحيطة المتوازية مع محور العالم بشكل بصري
+			حول كائن. يتم التعامل مع الحدود المحيطة الفعلية باستخدام [page:Box3]،
+			هذا مجرد مساعد بصري للتصحيح. يمكن تغيير حجمه تلقائيًا باستخدام طريقة [page:BoxHelper.update]
+			عندما يتم تحويل الكائن الذي تم إنشاؤه منه. لاحظ أن يجب أن يكون للكائن
+			[page:BufferGeometry] لكي يعمل هذا، لذلك لن يعمل مع [page:Sprite Sprites].
+		</p>
+			
+		<h2>مثال الكود</h2>
+
+		<code>
+		const sphere = new THREE.SphereGeometry();
+		const object = new THREE.Mesh( sphere, new THREE.MeshBasicMaterial( 0xff0000 ) );
+		const box = new THREE.BoxHelper( object, 0xffff00 );
+		scene.add( box );
+		</code>
+
+		<h2>أمثلة (Examples)</h2>
+		<p>
+		[example:webgl_helpers WebGL / helpers]<br />
+		[example:webgl_loader_nrrd WebGL / loader / nrrd]<br />
+		[example:webgl_buffergeometry_drawrange WebGL / buffergeometry / drawrange]
+		</p>
+
+		<h2>المنشئ (Constructor)</h2>
+		<h3>[name]( [param:Object3D object], [param:Color color] )</h3>
+		<p>
+		[page:Object3D object] -- (اختياري) الـ object3D المراد عرض الحدود المحيطة المتوازية مع محور العالم.<br />
+		[page:Color color] -- (اختياري) قيمة ست عشرية تحدد لون الصندوق. الافتراضي هو 0xffff00.<br /><br />
+
+		ينشئ صندوقًا جديدًا بإطار سلكي يحد الكائن المُمرَّر. يستخدم هذا داخليًا
+		[page:Box3.setFromObject] لحساب الأبعاد. لاحظ أن هذا يشمل أي أطفال.
+		</p>
+
+		<h2>الخصائص (Properties)</h2>
+		<p>انظر إلى الفئة الأساسية [page:LineSegments] للحصول على الخصائص المشتركة.</p>
+
+		<h2>الطرق (Methods)</h2>
+		<p>انظر إلى الفئة الأساسية [page:LineSegments] للحصول على الطرق المشتركة.</p>
+
+		<h3>[method:undefined update]()</h3>
+		<p>
+		يُحدِّث هندسة المساعد لتطابق أبعاد الكائن، بما في ذلك أي أطفال. انظر [page:Box3.setFromObject].
+		</p>
+
+		<h3>[method:this setFromObject]( [param:Object3D object] )</h3>
+		<p>
+		[page:Object3D object] - [page:Object3D] لإنشاء المساعد منه.<br /><br />
+
+		يُحدِّث صندوق الإطار السلكي للكائن المُمرَّر.
+		</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>

+ 82 - 0
docs/api/ar/helpers/CameraHelper.html

@@ -0,0 +1,82 @@
+<!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:Line] &rarr; [page:LineSegments] &rarr;
+
+		<h1>[name]</h1>
+
+		<p class="desc">
+			هذا يساعد في تصور ما يحتويه الكاميرا في مخروط الرؤية الخاص بها. يُصوِّر
+			مخروط الرؤية للكاميرا باستخدام [page:LineSegments].<br /><br />
+			يجب أن يكون [name] طفلًا للمشهد.
+		</p>
+			
+		<h2>مثال الكود</h2>
+		<code>
+const camera = new THREE.PerspectiveCamera( 75, window.innerWidth / window.innerHeight, 0.1, 1000 );
+const helper = new THREE.CameraHelper( camera );
+scene.add( helper );
+		</code>
+
+		<h2>أمثلة (Examples)</h2>
+		<p>
+		[example:webgl_camera WebGL / camera]<br />
+		[example:webgl_geometry_extrude_splines WebGL / extrude / splines]
+		</p>
+		
+		<h2>المنشئ (Constructor)</h2>
+		<h3>[name]( [param:Camera camera] )</h3>
+		<p>
+		[page:Camera camera] -- الكاميرا المراد تصويرها.<br /><br />
+		
+		ينشئ [Name] جديدًا للكاميرا المحددة.
+		</p>
+		
+		<h2>الخصائص (Properties)</h2>
+		<p>انظر إلى الفئة الأساسية [page:LineSegments] للحصول على الخصائص المشتركة.</p>
+		
+		<h3>[property:Camera camera]</h3>
+		<p>الكاميرا المُعروضة.</p>
+		
+		<h3>[property:Object pointMap]</h3>
+		<p>يحتوي هذا على النقاط المستخدمة لتصوير الكاميرا.</p>
+		
+		<h3>[property:Object matrix]</h3>
+		<p>إشارة إلى [page:Object3D.matrixWorld camera.matrixWorld].</p>
+		
+		<h3>[property:Object matrixAutoUpdate]</h3>
+		<p>
+		انظر [page:Object3D.matrixAutoUpdate]. تعيين إلى `false` هنا كما يستخدم المساعد
+		[page:Object3D.matrixWorld matrixWorld] الخاص بالكاميرا.
+		</p>
+		
+		<h2>الطرق (Methods)</h2>
+		<p>انظر إلى الفئة الأساسية [page:LineSegments] للحصول على الطرق المشتركة.</p>
+		
+		<h3>[method:undefined dispose]()</h3>
+		<p>
+		يُطلِق الموارد المتعلقة بوحدة معالجة الرسومات التي تم تخصيصها من قبل هذه العيّنة. اتصل بهذه
+		الطريقة كلما لم يعد هذه العيّنة مستخدمة في تطبيقك.
+		</p>
+		
+		<h3>
+		[method:this setColors]( [param:Color frustum], [param:Color cone], [param:Color up], [param:Color target], [param:Color cross] )
+		</h3>
+		<p>يحدد ألوان المساعد.</p>
+		
+		<h3>[method:undefined update]()</h3>
+		<p>يُحدِّث المساعد بناءً على projectionMatrix للكاميرا.</p>
+		
+		<h2>المصدر (Source)</h2>
+
+		<p>
+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
+		</p>
+	</body>
+</html>

+ 88 - 0
docs/api/ar/helpers/DirectionalLightHelper.html

@@ -0,0 +1,88 @@
+<!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">
+			كائن مساعد للمساعدة في تصور تأثير [page:DirectionalLight] على المشهد.
+			يتكون هذا من مستوى وخط يمثلان موقع الضوء واتجاهه.
+		</p>
+			
+		<h2>مثال الكود</h2>
+
+		<code>
+		const light = new THREE.DirectionalLight( 0xFFFFFF );
+		const helper = new THREE.DirectionalLightHelper( light, 5 );
+		scene.add( helper );
+		</code>
+
+		<h2>المنشئ (Constructor)</h2>
+
+		<h3>
+		[name]( [param:DirectionalLight light], [param:Number size], [param:Hex color] )
+		</h3>
+		<p>
+		[page:DirectionalLight light]-- الضوء المراد تصويره. <br /><br />
+
+		[page:Number size] -- (اختياري) أبعاد المستوى. الافتراضي هو
+		`1`.<br /><br />
+
+		[page:Hex color] -- (اختياري) إذا لم يتم تعيين هذا، فسيأخذ المساعد
+		لون الضوء.
+		</p>
+
+		<h2>الخصائص (Properties)</h2>
+		<p>انظر إلى الفئة الأساسية [page:Object3D] للحصول على الخصائص المشتركة.</p>
+
+		<h3>[property:Line lightPlane]</h3>
+		<p>يحتوي على شبكة الخط التي تظهر موقع الضوء الاتجاهي.</p>
+
+		<h3>[property:DirectionalLight light]</h3>
+		<p>
+		إشارة إلى [page:DirectionalLight directionalLight] المُعروض.
+		</p>
+
+		<h3>[property:Object matrix]</h3>
+		<p>إشارة إلى [page:Object3D.matrixWorld matrixWorld] الخاص بالضوء.</p>
+
+		<h3>[property:Object matrixAutoUpdate]</h3>
+		<p>
+		انظر [page:Object3D.matrixAutoUpdate]. تعيين إلى `false` هنا كما يستخدم المساعد
+		[page:Object3D.matrixWorld matrixWorld] الخاص بالضوء.
+		</p>
+
+		<h3>[property:hex color]</h3>
+		<p>
+		معلمة اللون التي تم تمريرها في المُنشئ. الافتراضي هو `undefined`. إذا تغير هذا،
+		سيُحدِّث لون المساعد في المرة التالية التي يتم فيها استدعاء [page:.update update].
+		</p>
+
+		<h2>الطرق (Methods)</h2>
+		<p>انظر إلى الفئة الأساسية [page:Object3D] للحصول على الخصائص المشتركة.</p>
+
+		<h3>[method:undefined dispose]()</h3>
+		<p>
+		يُطلِق الموارد المتعلقة بوحدة معالجة الرسومات التي تم تخصيصها من قبل هذه العيّنة. اتصل بهذه
+		الطريقة كلما لم يعد هذه العيّنة مستخدمة في تطبيقك.
+		</p>
+
+		<h3>[method:undefined update]()</h3>
+		<p>
+		يُحدِّث المساعد ليطابق موقع واتجاه [page:.light directionalLight] المُعروض.
+		</p>
+
+		<h2>المصدر (Source)</h2>
+
+		<p>
+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
+		</p>
+	</body>
+</html>

+ 69 - 0
docs/api/ar/helpers/GridHelper.html

@@ -0,0 +1,69 @@
+<!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:Line] &rarr;
+
+		<h1>[name]</h1>
+
+		<p class="desc">
+			GridHelper هو كائن لتحديد الشبكات. الشبكات هي مصفوفات ثنائية الأبعاد
+			من الخطوط.
+		</p>
+			
+		<h2>مثال الكود</h2>
+
+		<code>
+		const size = 10;
+		const divisions = 10;
+
+		const gridHelper = new THREE.GridHelper( size, divisions );
+		scene.add( gridHelper );
+		</code>
+
+		<h2>أمثلة (Examples)</h2>
+
+		<p>[example:webgl_helpers WebGL / helpers]</p>
+		
+		<h2>المنشئ (Constructor)</h2>
+		
+		<h3>
+		[name]( [param:number size], [param:Number divisions], [param:Color colorCenterLine], [param:Color colorGrid] )
+		</h3>
+		<p>
+		size -- حجم الشبكة. الافتراضي هو 10. <br />
+		divisions -- عدد التقسيمات عبر الشبكة. الافتراضي هو 10.
+		<br />
+		colorCenterLine -- لون الخط الأوسط. يمكن أن يكون هذا
+		[page:Color]، قيمة ست عشرية واسم لون CSS. الافتراضي هو
+		0x444444 <br />
+		colorGrid -- لون خطوط الشبكة. يمكن أن يكون هذا
+		[page:Color]، قيمة ست عشرية واسم لون CSS. الافتراضي هو
+		0x888888
+		</p>
+		<p>
+		ينشئ [name] جديدًا بحجم 'size' ومقسَّمًا إلى 'divisions' شرائح
+		لكل جانب. الألوان اختيارية.
+		</p>
+		
+		<h2>الطرق (Methods)</h2>
+		<p>انظر إلى الفئة الأساسية [page:LineSegments] للحصول على الطرق المشتركة.</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>

+ 85 - 0
docs/api/ar/helpers/HemisphereLightHelper.html

@@ -0,0 +1,85 @@
+<!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">
+			ينشئ مساعدًا بصريًا يتكون من [page:Mesh] كروي لـ
+			[page:HemisphereLight HemisphereLight].
+		</p>
+			
+		<h2>مثال الكود</h2>
+
+		<code>
+		const light = new THREE.HemisphereLight( 0xffffbb, 0x080820, 1 );
+		const helper = new THREE.HemisphereLightHelper( light, 5 );
+		scene.add( helper );
+		</code>
+
+		<h2>المنشئ (Constructor)</h2>
+
+		<h3>
+		[name]( [param:HemisphereLight light], [param:Number sphereSize],
+		[param:Hex color] )
+		</h3>
+		<p>
+		[page:HemisphereLight light] -- الضوء المراد تصويره. <br /><br />
+		
+		[page:Number size] -- حجم الشبكة المستخدمة لتصوير الضوء.<br /><br />
+		
+		[page:Hex color] -- (اختياري) إذا لم يتم تعيين هذا، فسيأخذ المساعد
+		لون الضوء.
+		</p>
+		
+		<h2>الخصائص (Properties)</h2>
+		<p>انظر إلى الفئة الأساسية [page:Object3D] للحصول على الخصائص المشتركة.</p>
+		
+		<h3>[property:HemisphereLight light]</h3>
+		<p>إشارة إلى HemisphereLight المُعروض.</p>
+		
+		<h3>[property:Object matrix]</h3>
+		<p>
+		إشارة إلى [page:Object3D.matrixWorld matrixWorld] الخاص بـ hemisphereLight.
+		</p>
+		
+		<h3>[property:Object matrixAutoUpdate]</h3>
+		<p>
+		انظر [page:Object3D.matrixAutoUpdate]. تعيين إلى `false` هنا كما يستخدم المساعد
+		[page:Object3D.matrixWorld matrixWorld] الخاص بـ hemisphereLight.
+		</p>
+		
+		<h3>[property:hex color]</h3>
+		<p>
+		معلمة اللون التي تم تمريرها في المُنشئ. الافتراضي هو `undefined`. إذا تغير هذا،
+		سيُحدِّث لون المساعد في المرة التالية التي يتم فيها استدعاء [page:.update update].
+		</p>
+		
+		<h2>الطرق (Methods)</h2>
+		<p>انظر إلى الفئة الأساسية [page:Object3D] للحصول على الطرق المشتركة.</p>
+		
+		<h3>[method:undefined dispose]()</h3>
+		<p>
+		يُطلِق الموارد المتعلقة بوحدة معالجة الرسومات التي تم تخصيصها من قبل هذه العيّنة. اتصل بهذه
+		الطريقة كلما لم يعد هذه العيّنة مستخدمة في تطبيقك.
+		</p>
+		
+		<h3>[method:undefined update]()</h3>
+		<p>
+		يُحدِّث المساعد ليطابق موقع واتجاه [page:.light].
+		</p>
+
+		<h2>المصدر (Source)</h2>
+
+		<p>
+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
+		</p>
+	</body>
+</html>

+ 69 - 0
docs/api/ar/helpers/PlaneHelper.html

@@ -0,0 +1,69 @@
+<!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:Line] &rarr; [page:LineSegments] &rarr;
+
+		<h1>[name]</h1>
+
+		<p class="desc">كائن مساعد لتصور [page:Plane].</p>
+
+		<h2>مثال الكود</h2>
+		
+		<code>
+		const plane = new THREE.Plane( new THREE.Vector3( 1, 1, 0.2 ), 3 );
+		const helper = new THREE.PlaneHelper( plane, 1, 0xffff00 );
+		scene.add( helper );
+		</code>
+
+		<h2>المنشئ (Constructor)</h2>
+
+		<h3>
+		[name]( [param:Plane plane], [param:Float size], [param:Color hex] )
+		</h3>
+		<p>
+		[page:Plane plane] -- الطائرة المراد تصويرها.<br />
+		[page:Float size] -- (اختياري) طول جانب مساعد الطائرة. الافتراضي هو
+		1.<br />
+		[page:Color color] -- (اختياري) لون المساعد. الافتراضي هو
+		0xffff00.<br /><br />
+		
+		ينشئ تمثيلًا جديدًا بإطار سلكي للطائرة المُمرَّرة.
+		</p>
+		
+		<h2>الخصائص (Properties)</h2>
+		<p>انظر إلى الفئة الأساسية [page:Line] للحصول على الخصائص المشتركة.</p>
+		
+		<h3>[property:Plane plane]</h3>
+		<p>[page:Plane plane] المُعروض.</p>
+		
+		<h3>[property:Float size]</h3>
+		<p>أطوال جانب مساعد الطائرة.</p>
+		
+		<h2>الطرق (Methods)</h2>
+		<p>انظر إلى الفئة الأساسية [page:LineSegments] للحصول على الطرق المشتركة.</p>
+		
+		<h3>[method:undefined updateMatrixWorld]( [param:Boolean force] )</h3>
+		<p>
+		هذا يتجاوز الطريقة في الفئة الأساسية [page:Object3D] بحيث يُحدِّث أيضًا
+		كائن المساعد وفقًا لخصائص [page:PlaneHelper.plane .plane] و [page:PlaneHelper.size .size].
+		</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>

+ 91 - 0
docs/api/ar/helpers/PointLightHelper.html

@@ -0,0 +1,91 @@
+<!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:Mesh] &rarr;
+
+		<h1>[name]</h1>
+
+		<p class="desc">
+			يعرض كائن مساعد يتكون من [page:Mesh] كروي لتصوير
+			[page:PointLight].
+		</p>
+			
+		<h2>مثال الكود</h2>
+
+		<code>
+		const pointLight = new THREE.PointLight( 0xff0000, 1, 100 );
+		pointLight.position.set( 10, 10, 10 );
+		scene.add( pointLight );
+
+		const sphereSize = 1;
+		const pointLightHelper = new THREE.PointLightHelper( pointLight, sphereSize );
+		scene.add( pointLightHelper );
+		</code>
+
+		<h2>أمثلة (Examples)</h2>
+
+		<p>[example:webgl_helpers WebGL / helpers]</p>
+		
+		<h2>المنشئ (Constructor)</h2>
+		
+		<h3>
+		[name]( [param:PointLight light], [param:Float sphereSize], [param:Hex color] )
+		</h3>
+		<p>
+		[page:PointLight light] -- الضوء المراد تصويره. <br /><br />
+		
+		[page:Float sphereSize] -- (اختياري) حجم مساعد الكرة.
+		الافتراضي هو `1`.<br /><br />
+		
+		[page:Hex color] -- (اختياري) إذا لم يتم تعيين هذا، فسيأخذ المساعد
+		لون الضوء.
+		</p>
+		
+		<h2>الخصائص (Properties)</h2>
+		<p>انظر إلى الفئة الأساسية [page:Mesh] للحصول على الخصائص المشتركة.</p>
+		
+		<h3>[property:PointLight light]</h3>
+		<p>[page:PointLight] المُعروض.</p>
+		
+		<h3>[property:Object matrix]</h3>
+		<p>
+		إشارة إلى [page:Object3D.matrixWorld matrixWorld] الخاص بـ pointLight.
+		</p>
+		
+		<h3>[property:Object matrixAutoUpdate]</h3>
+		<p>
+		انظر [page:Object3D.matrixAutoUpdate]. تعيين إلى `false` هنا كما يستخدم المساعد
+		[page:Object3D.matrixWorld matrixWorld] الخاص بـ pointLight.
+		</p>
+		
+		<h3>[property:hex color]</h3>
+		<p>
+		معلمة اللون التي تم تمريرها في المُنشئ. الافتراضي هو `undefined`. إذا تغير هذا،
+		سيُحدِّث لون المساعد في المرة التالية التي يتم فيها استدعاء [page:.update update].
+		</p>
+		
+		<h2>الطرق (Methods)</h2>
+		<p>انظر إلى الفئة الأساسية [page:Mesh] للحصول على الطرق المشتركة.</p>
+		
+		<h3>[method:undefined dispose]()</h3>
+		<p>
+		يُطلِق الموارد المتعلقة بوحدة معالجة الرسومات التي تم تخصيصها من قبل هذه العيّنة. اتصل بهذه
+		الطريقة كلما لم يعد هذه العيّنة مستخدمة في تطبيقك.
+		</p>
+		
+		<h3>[method:undefined update]()</h3>
+		<p>يُحدِّث المساعد ليطابق موقع [page:.light].</p>
+		
+		<h2>المصدر (Source)</h2>
+
+		<p>
+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
+		</p>
+	</body>
+</html>

+ 77 - 0
docs/api/ar/helpers/PolarGridHelper.html

@@ -0,0 +1,77 @@
+<!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:Line] &rarr;
+
+		<h1>[name]</h1>
+
+		<p class="desc">
+			PolarGridHelper هو كائن لتحديد الشبكات القطبية. الشبكات هي مصفوفات ثنائية الأبعاد
+			من الخطوط.
+		</p>
+			
+		<h2>مثال الكود</h2>
+			
+		<code>
+		const radius = 10;
+		const sectors = 16;
+		const rings = 8;
+		const divisions = 64;
+
+		const helper = new THREE.PolarGridHelper( radius, sectors, rings, divisions );
+		scene.add( helper );
+		</code>
+
+		<h2>أمثلة (Examples)</h2>
+
+		<p>[example:webgl_helpers WebGL / helpers]</p>
+		
+		<h2>المنشئ (Constructor)</h2>
+		
+		<h3>
+		[name]( [param:Number radius], [param:Number sectors], [param:Number rings], [param:Number divisions], [param:Color color1], [param:Color color2] )
+		</h3>
+		<p>
+		radius -- نصف قطر الشبكة القطبية. يمكن أن يكون هذا أي رقم موجب.
+		الافتراضي هو 10.<br />
+		sectors -- عدد القطاعات التي ستُقسَّم إليها الشبكة. يمكن أن يكون هذا
+		أي عدد صحيح موجب. الافتراضي هو 16.<br />
+		rings -- عدد الحلقات. يمكن أن يكون هذا أي عدد صحيح موجب. الافتراضي هو
+		8.<br />
+		divisions -- عدد شرائح الخط المستخدمة لكل دائرة. يمكن أن يكون هذا
+		أي عدد صحيح موجب لا يقل عن 3. الافتراضي هو 64.<br />
+		color1 -- اللون الأول المستخدم لعناصر الشبكة. يمكن أن يكون هذا
+		[page:Color]، قيمة ست عشرية واسم لون CSS. الافتراضي هو
+		0x444444 <br />
+		color2 -- اللون الثاني المستخدم لعناصر الشبكة. يمكن أن يكون هذا
+		[page:Color]، قيمة ست عشرية واسم لون CSS. الافتراضي هو
+		0x888888
+		</p>
+		<p>
+		ينشئ [name] جديدًا بقطر 'radius' مع 'sectors' عدد من القطاعات
+		و 'rings' عدد من الحلقات، حيث تُسَهَّل كل دائرة إلى
+		'divisions' عدد من شرائح الخط. الألوان اختيارية.
+		</p>
+		
+		<h2>الطرق (Methods)</h2>
+		<p>انظر إلى الفئة الأساسية [page:LineSegments] للحصول على الطرق المشتركة.</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>

+ 68 - 0
docs/api/ar/helpers/SkeletonHelper.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">
+		[page:Object3D] &rarr; [page:Line] &rarr; [page:LineSegments] &rarr;
+
+		<h1>[name]</h1>
+
+		<p class="desc">
+			كائن مساعد للمساعدة في تصور [page:Skeleton Skeleton]. يتم
+			تقديم المساعد باستخدام [page:LineBasicMaterial LineBasicMaterial].
+		</p>
+			
+		<h2>مثال الكود</h2>
+			
+		<code>
+		const helper = new THREE.SkeletonHelper( skinnedMesh );
+		scene.add( helper );
+		</code>
+
+		<h2>أمثلة (Examples)</h2>
+
+		<p>
+		[example:webgl_animation_skinning_blending WebGL / animation / skinning / blending]<br />
+		[example:webgl_animation_skinning_morph WebGL / animation / skinning / morph]<br />
+		[example:webgl_loader_bvh WebGL / loader / bvh ]
+		</p>
+		
+		<h2>المنشئ (Constructor)</h2>
+		
+		<h3>[name]( [param:Object3D object] )</h3>
+		<p>
+		object -- عادةً مثيل من [page:SkinnedMesh]. ومع ذلك ، يمكن استخدام أي مثيل
+		من [page:Object3D] إذا كان يمثل تسلسل هرمي من [page:Bone Bone]s (عبر [page:Object3D.children]).
+		</p>
+		
+		<h2>الخصائص (Properties)</h2>
+		
+		<h3>[property:Array bones]</h3>
+		<p>قائمة العظام التي يعرضها المساعد كـ [page:Line Lines].</p>
+		
+		<h3>[property:Boolean isSkeletonHelper]</h3>
+		<p>علامة للقراءة فقط للتحقق مما إذا كان الكائن المعطى هو من نوع [name].</p>
+		
+		<h3>[property:Object3D root]</h3>
+		<p>الكائن الذي تم تمريره في المنشئ.</p>
+		
+		<h2>الطرق (Methods)</h2>
+		<p>انظر الفئة الأساسية [page:LineSegments] للطرق المشتركة.</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>

+ 86 - 0
docs/api/ar/helpers/SpotLightHelper.html

@@ -0,0 +1,86 @@
+<!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">
+			يعرض هذا مساعد على شكل مخروط لـ [page:SpotLight].
+		</p>
+			
+		<h2>مثال الكود</h2>
+			
+		<code>
+		const spotLight = new THREE.SpotLight( 0xffffff );
+		spotLight.position.set( 10, 10, 10 );
+		scene.add( spotLight );
+
+		const spotLightHelper = new THREE.SpotLightHelper( spotLight );
+		scene.add( spotLightHelper );
+		</code>
+
+		<h2>أمثلة (Examples)</h2>
+		<p>[example:webgl_lights_spotlights WebGL/ lights / spotlights ]</p>
+		
+		<h2>المنشئ (Constructor)</h2>
+		
+		<h3>[name]( [param:SpotLight light], [param:Hex color] )</h3>
+		<p>
+		[page:SpotLight light] -- [page:SpotLight] المراد تصوره.
+		<br /><br />
+		
+		[page:Hex color] -- (اختياري) إذا لم يتم تعيين هذا ، فسيأخذ المساعد
+		لون الضوء.
+		</p>
+		
+		<h2>الخصائص (Properties)</h2>
+		<p>انظر الفئة الأساسية [page:Object3D] للخصائص المشتركة.</p>
+		
+		<h3>[property:LineSegments cone]</h3>
+		<p>[page:LineSegments] المستخدمة لتصور الضوء.</p>
+		
+		<h3>[property:SpotLight light]</h3>
+		<p>إشارة إلى [page:SpotLight] المرئي.</p>
+		
+		<h3>[property:Object matrix]</h3>
+		<p>إشارة إلى [page:Object3D.matrixWorld matrixWorld] الخاص بـ spotLight.</p>
+		
+		<h3>[property:Object matrixAutoUpdate]</h3>
+		<p>
+		انظر [page:Object3D.matrixAutoUpdate]. تعيين إلى `false` هنا كما يستخدم المساعد
+		[page:Object3D.matrixWorld matrixWorld] الخاص بـ spotLight.
+		</p>
+		
+		<h3>[property:hex color]</h3>
+		<p>
+		معلمة اللون الممررة في المنشئ. الافتراضي هو `undefined`. إذا
+		تغير هذا ، سيتحدث لون المساعد في المرة التالية
+		[page:.update update] يتم استدعاؤه.
+		</p>
+		
+		<h2>الطرق (Methods)</h2>
+		<p>انظر الفئة الأساسية [page:Object3D] للطرق المشتركة.</p>
+		
+		<h3>[method:undefined dispose]()</h3>
+		<p>
+		تحرير الموارد ذات الصلة بوحدة معالجة الرسومات التي تم تخصيصها من قبل هذه الحالة. استدعاء هذه
+		الطريقة كلما لم يعد يستخدم هذا الحال في تطبيقك.
+		</p>
+		
+		<h3>[method:undefined update]()</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>

+ 16 - 0
docs/list.json

@@ -583,6 +583,22 @@
 				"TorusKnotGeometry": "api/ar/geometries/TorusKnotGeometry",
 				"TorusKnotGeometry": "api/ar/geometries/TorusKnotGeometry",
 				"TubeGeometry": "api/ar/geometries/TubeGeometry",
 				"TubeGeometry": "api/ar/geometries/TubeGeometry",
 				"WireframeGeometry": "api/ar/geometries/WireframeGeometry"
 				"WireframeGeometry": "api/ar/geometries/WireframeGeometry"
+			},
+
+			"Helpers": {
+				"ArrowHelper": "api/ar/helpers/ArrowHelper",
+				"AxesHelper": "api/ar/helpers/AxesHelper",
+				"BoxHelper": "api/ar/helpers/BoxHelper",
+				"Box3Helper": "api/ar/helpers/Box3Helper",
+				"CameraHelper": "api/ar/helpers/CameraHelper",
+				"DirectionalLightHelper": "api/ar/helpers/DirectionalLightHelper",
+				"GridHelper": "api/ar/helpers/GridHelper",
+				"PolarGridHelper": "api/ar/helpers/PolarGridHelper",
+				"HemisphereLightHelper": "api/ar/helpers/HemisphereLightHelper",
+				"PlaneHelper": "api/ar/helpers/PlaneHelper",
+				"PointLightHelper": "api/ar/helpers/PointLightHelper",
+				"SkeletonHelper": "api/ar/helpers/SkeletonHelper",
+				"SpotLightHelper": "api/ar/helpers/SpotLightHelper"
 			}
 			}
 
 
 		}
 		}