Răsfoiți Sursa

Merge pull request #20377 from hassanMuhamad/dev

 Docs(Ar): Reference - Initiate Cameras section
Mr.doob 4 ani în urmă
părinte
comite
7ec8ce7f9d

+ 49 - 0
docs/api/ar/cameras/ArrayCamera.html

@@ -0,0 +1,49 @@
+<!DOCTYPE html>
+<html lang="ar">
+	<head>
+		<meta charset="utf-8" />
+		<base href="../../../" />
+		<script src="list.js"></script>
+		<script src="page.js"></script>
+		<link type="text/css" rel="stylesheet" href="page.css" />
+	</head>
+	<body class="rtl">
+		[page:Object3D] &rarr; [page:Camera] &rarr; [page:PerspectiveCamera] &rarr;
+
+		<h1>[name]</h1>
+
+		<p class="desc">
+			يمكن استخدام [name] لتقديم مشهد بكفاءة مع مجموعة محددة مسبقًا من الكاميرات. يعد هذا جانبًا مهمًا من جوانب الأداء لعرض مشاهد الواقع الافتراضي.<br />
+			يحمل دائمًا نموذج لـ [name] مصفوفة من الكاميرات الفرعية. من الضروري تحديد خاصية *viewport* لكل كاميرا فرعية والتي تحدد جزء منفذ العرض الذي يتم تقديمه باستخدام هذه الكاميرا.
+		</p>
+
+		<h2>أمثلة (Examples)</h2>
+
+		<p>[example:webgl_camera_array camera / array ]</p>
+
+		<h2>المنشئ (Constructor)</h2>
+
+		<h3>[name]( [param:Array array] )</h3>
+		<p>
+			مجموعة من الكاميرات.
+		</p>
+
+
+		<h2>الخصائص (Properties)</h2>
+		<p>راجع الفئة [page:PerspectiveCamera] الأساسية للممتلكات العامة.</p>
+
+		<h3>[property:Array cameras]</h3>
+		<p>
+			مجموعة من الكاميرات.
+		</p>
+
+		<h2>الوظائف (Methods)</h2>
+		<p>راجع الفئة الأساسية [page:PerspectiveCamera]  للتعرف على الطرق الشائعة.</p>
+
+		<h2>المصدر (Source)</h2>
+
+		<p>
+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
+		</p>
+	</body>
+</html>

+ 79 - 0
docs/api/ar/cameras/Camera.html

@@ -0,0 +1,79 @@
+<!DOCTYPE html>
+<html lang="ar">
+	<head>
+		<meta charset="utf-8" />
+		<base href="../../../" />
+		<script src="list.js"></script>
+		<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>المنشئ (Constructor)</h2>
+
+
+		<h3>[name]()</h3>
+		<p>
+			ينشئ كائن [name] جديد. لاحظ أن هذه الفئة لا يُقصد أن يتم استدعاؤها مباشرة ؛
+ربما تريد [page:PerspectiveCamera] أو [page:OrthographicCamera] بدلاً من ذلك.
+		</p>
+
+
+		<h2>الخصائص (Properties)</h2>
+		<p>راجع الفئة [page: Object3D] الأساسية للممتلكات العامة.</p>
+
+		<h3>[property:Layers layers]</h3>
+		<p>
+		ال [page:Layers layers] التي تعد الكاميرا عضو فيها. هذه ملكية موروثة من [page:Object3D].<br /><br />
+
+		يجب أن تشترك الكائنات في طبقة واحدة على الأقل مع الكاميرا لتظهر عند عرض وجهة نظر الكاميرا.
+		</p>
+
+		<h3>[property:Matrix4 matrixWorldInverse]</h3>
+		<p>
+			هذه القيمة هي نتيجة عكس matrixWorld. يحتوي MatrixWorld على Matrix الذي يحتوي على عالم تحويل الكاميرا.
+		</p>
+
+		<h3>[property:Matrix4 projectionMatrix]</h3>
+		<p>هذه هي المصفوفة التي تحتوي على الإسقاط.</p>
+
+		<h3>[property:Matrix4 projectionMatrixInverse]</h3>
+		<p>معكوس مصفوفة الإسقاط *projectionMatrix*.</p>
+
+
+		<h2>الوظائف (Methods)</h2>
+		<p>راجع الفئة الأساسية [page:Object3D] للتعرف على الطرق الشائعة.</p>
+
+		<h3>[method:Camera clone]( )</h3>
+		<p>
+			ترجع كاميرا جديدة بنفس خصائص هذه الكاميرا.
+		</p>
+
+		<h3>[method:Camera copy]( [param:Camera source], [param:Boolean recursive] )</h3>
+		<p>
+			تنسخ الخصائص من الكاميرا المصدر إلى هذه الكاميرا.
+		</p>
+
+		<h3>[method:Vector3 getWorldDirection]( [param:Vector3 target] )</h3>
+		<p>
+		[page:Vector3 target] — سيتم نسخ النتيجة في الـ*Vector3* الحالي. <br /><br />
+
+		ترجع [page:Vector3] التي تمثل اتجاه الفضاء العالمي الذي تنظر فيه الكاميرا.
+		(ملاحظة: تنظر الكاميرا إلى محورها z المحلي والسالب).<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>

+ 96 - 0
docs/api/ar/cameras/CubeCamera.html

@@ -0,0 +1,96 @@
+<!DOCTYPE html>
+<html lang="ar">
+	<head>
+		<meta charset="utf-8" />
+		<base href="../../../" />
+		<script src="list.js"></script>
+		<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">يقوم بإنشاء 6 كاميرات يتم تحويلها إلى [page:WebGLCubeRenderTarget].</p>
+
+		<h2>مثال التعليمة البرمجية</h2>
+
+		<code>
+		// Create cube render target
+		var cubeRenderTarget = new THREE.WebGLCubeRenderTarget( 128, { format: THREE.RGBFormat, generateMipmaps: true, minFilter: THREE.LinearMipmapLinearFilter } );
+
+		// Create cube camera
+		var cubeCamera = new THREE.CubeCamera( 1, 100000, cubeRenderTarget );
+		scene.add( cubeCamera );
+
+		// Create car
+		var chromeMaterial = new THREE.MeshLambertMaterial( { color: 0xffffff, envMap: cubeRenderTarget.texture } );
+		var car = new Mesh( carGeometry, chromeMaterial );
+		scene.add( car );
+
+		// Update the render target cube
+		car.setVisible( false );
+		cubeCamera.position.copy( car.position );
+		cubeCamera.update( renderer, scene );
+
+		// Render the scene
+		car.setVisible( true );
+		renderer.render( scene, camera );
+		</code>
+
+		<h2>أمثلة (Examples)</h2>
+
+		<p>
+			[example:webgl_materials_cubemap_dynamic materials / cubemap / dynamic ]<br />
+			[example:webgl_shading_physical shading / physical ]
+		</p>
+
+		<h2>المنشئ (Constructor)</h2>
+
+
+		<h3>[name]( [param:Number near], [param:Number far], [param:WebGLCubeRenderTarget renderTarget] )</h3>
+		<p>
+		near -- مسافة الاقتطاع القريبة. <br />
+		far -- مسافة القطع البعيدة <br />
+		renderTarget -- هدف عرض مكعب الوجهة *cube render target*.
+		</p>
+
+		<p>
+			ينشئ CubeCamera الذي يحتوي على 6 [page:PerspectiveCamera PerspectiveCameras] ذلك
+			الذي سيتم عرضه من خلال [page:WebGLCubeRenderTarget].
+		</p>
+
+		<h2>الخصائص (Properties)</h2>
+		<p>راجع فئة [page: Object3D] الأساسية للخصائص العامة.</p>
+
+		<h3>[property:WebGLCubeRenderTarget renderTarget]</h3>
+		<p>
+		الهدف الخاص بـ*cube render target*.
+		</p>
+
+		<h2>الوظائف (Methods)</h2>
+		<p>راجع فئة [page: Object3D] الأساسية للخصائص العامة.</p>
+
+		<h3>[method:null update]( [param:WebGLRenderer renderer], [param:Scene scene] )</h3>
+		<p>
+		renderer -- عارض WebGL الحالي <br />
+		scene -- المشهد الحالي
+		</p>
+		<p>
+		استدعاء هذا لتحديث [page:CubeCamera.renderTarget renderTarget].
+		</p>
+
+		<h3>[method:null clear]( [param:WebGLRenderer renderer], [param:Boolean color], [param:Boolean depth], [param:Boolean stencil] )</h3>
+		<p>
+		قم باستدعاء هذا لمسح لون وعمق و / أو مخازن الاستنسل *stencil buffers* المؤقتة الخاصة بالهدف.
+		يتم تعيين مخزن الألوان على اللون الواضح الحالي لجهاز العرض. القيم الافتراضية هي *true*.
+		</p>
+
+		<h2>المصدر (Source)</h2>
+
+		<p>
+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
+		</p>
+	</body>
+</html>

+ 7 - 1
docs/list.js

@@ -524,7 +524,13 @@ var list = {
 				"AudioContext": "api/ar/audio/AudioContext",
 				"AudioListener": "api/ar/audio/AudioListener",
 				"PositionalAudio": "api/ar/audio/PositionalAudio"
-			}
+			},
+
+			"Cameras": {
+				"ArrayCamera": "api/ar/cameras/ArrayCamera",
+				"Camera": "api/ar/cameras/Camera",
+				"CubeCamera": "api/ar/cameras/CubeCamera",
+			},
 
 		}