Skip to content

Commit 7ec8ce7

Browse files
mrdoobmrdoob
authored
Merge pull request #20377 from hassanMuhamad/dev
 Docs(Ar): Reference - Initiate Cameras section
2 parents 2b6ce37 + 08427de commit 7ec8ce7

File tree

4 files changed

+231
-1
lines changed

4 files changed

+231
-1
lines changed

‎docs/api/ar/cameras/ArrayCamera.html‎

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
<!DOCTYPE html>
2+
<html lang="ar">
3+
<head>
4+
<meta charset="utf-8" />
5+
<base href="../../../" />
6+
<script src="list.js"></script>
7+
<script src="page.js"></script>
8+
<link type="text/css" rel="stylesheet" href="page.css" />
9+
</head>
10+
<body class="rtl">
11+
[page:Object3D] &rarr; [page:Camera] &rarr; [page:PerspectiveCamera] &rarr;
12+
13+
<h1>[name]</h1>
14+
15+
<p class="desc">
16+
يمكن استخدام [name] لتقديم مشهد بكفاءة مع مجموعة محددة مسبقًا من الكاميرات. يعد هذا جانبًا مهمًا من جوانب الأداء لعرض مشاهد الواقع الافتراضي.<br />
17+
يحمل دائمًا نموذج لـ [name] مصفوفة من الكاميرات الفرعية. من الضروري تحديد خاصية *viewport* لكل كاميرا فرعية والتي تحدد جزء منفذ العرض الذي يتم تقديمه باستخدام هذه الكاميرا.
18+
</p>
19+
20+
<h2>أمثلة (Examples)</h2>
21+
22+
<p>[example:webgl_camera_array camera / array ]</p>
23+
24+
<h2>المنشئ (Constructor)</h2>
25+
26+
<h3>[name]( [param:Array array] )</h3>
27+
<p>
28+
مجموعة من الكاميرات.
29+
</p>
30+
31+
32+
<h2>الخصائص (Properties)</h2>
33+
<p>راجع الفئة [page:PerspectiveCamera] الأساسية للممتلكات العامة.</p>
34+
35+
<h3>[property:Array cameras]</h3>
36+
<p>
37+
مجموعة من الكاميرات.
38+
</p>
39+
40+
<h2>الوظائف (Methods)</h2>
41+
<p>راجع الفئة الأساسية [page:PerspectiveCamera] للتعرف على الطرق الشائعة.</p>
42+
43+
<h2>المصدر (Source)</h2>
44+
45+
<p>
46+
[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
47+
</p>
48+
</body>
49+
</html>

‎docs/api/ar/cameras/Camera.html‎

Lines changed: 79 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,79 @@
1+
<!DOCTYPE html>
2+
<html lang="ar">
3+
<head>
4+
<meta charset="utf-8" />
5+
<base href="../../../" />
6+
<script src="list.js"></script>
7+
<script src="page.js"></script>
8+
<link type="text/css" rel="stylesheet" href="page.css" />
9+
</head>
10+
<body class="rtl">
11+
[page:Object3D] &rarr;
12+
13+
<h1>[name]</h1>
14+
15+
<p class="desc">
16+
فئة أساسية مجردة للكاميرات. يجب أن يتم توريث هذه الفئة دائمًا عند إنشاء كاميرا جديدة.
17+
</p>
18+
19+
20+
<h2>المنشئ (Constructor)</h2>
21+
22+
23+
<h3>[name]()</h3>
24+
<p>
25+
ينشئ كائن [name] جديد. لاحظ أن هذه الفئة لا يُقصد أن يتم استدعاؤها مباشرة ؛
26+
ربما تريد [page:PerspectiveCamera] أو [page:OrthographicCamera] بدلاً من ذلك.
27+
</p>
28+
29+
30+
<h2>الخصائص (Properties)</h2>
31+
<p>راجع الفئة [page: Object3D] الأساسية للممتلكات العامة.</p>
32+
33+
<h3>[property:Layers layers]</h3>
34+
<p>
35+
ال [page:Layers layers] التي تعد الكاميرا عضو فيها. هذه ملكية موروثة من [page:Object3D].<br /><br />
36+
37+
يجب أن تشترك الكائنات في طبقة واحدة على الأقل مع الكاميرا لتظهر عند عرض وجهة نظر الكاميرا.
38+
</p>
39+
40+
<h3>[property:Matrix4 matrixWorldInverse]</h3>
41+
<p>
42+
هذه القيمة هي نتيجة عكس matrixWorld. يحتوي MatrixWorld على Matrix الذي يحتوي على عالم تحويل الكاميرا.
43+
</p>
44+
45+
<h3>[property:Matrix4 projectionMatrix]</h3>
46+
<p>هذه هي المصفوفة التي تحتوي على الإسقاط.</p>
47+
48+
<h3>[property:Matrix4 projectionMatrixInverse]</h3>
49+
<p>معكوس مصفوفة الإسقاط *projectionMatrix*.</p>
50+
51+
52+
<h2>الوظائف (Methods)</h2>
53+
<p>راجع الفئة الأساسية [page:Object3D] للتعرف على الطرق الشائعة.</p>
54+
55+
<h3>[method:Camera clone]( )</h3>
56+
<p>
57+
ترجع كاميرا جديدة بنفس خصائص هذه الكاميرا.
58+
</p>
59+
60+
<h3>[method:Camera copy]( [param:Camera source], [param:Boolean recursive] )</h3>
61+
<p>
62+
تنسخ الخصائص من الكاميرا المصدر إلى هذه الكاميرا.
63+
</p>
64+
65+
<h3>[method:Vector3 getWorldDirection]( [param:Vector3 target] )</h3>
66+
<p>
67+
[page:Vector3 target] — سيتم نسخ النتيجة في الـ*Vector3* الحالي. <br /><br />
68+
69+
ترجع [page:Vector3] التي تمثل اتجاه الفضاء العالمي الذي تنظر فيه الكاميرا.
70+
(ملاحظة: تنظر الكاميرا إلى محورها z المحلي والسالب).<br /><br />
71+
</p>
72+
73+
<h2>المصدر (Source)</h2>
74+
75+
<p>
76+
[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
77+
</p>
78+
</body>
79+
</html>

‎docs/api/ar/cameras/CubeCamera.html‎

Lines changed: 96 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,96 @@
1+
<!DOCTYPE html>
2+
<html lang="ar">
3+
<head>
4+
<meta charset="utf-8" />
5+
<base href="../../../" />
6+
<script src="list.js"></script>
7+
<script src="page.js"></script>
8+
<link type="text/css" rel="stylesheet" href="page.css" />
9+
</head>
10+
<body class="rtl">
11+
[page:Object3D] &rarr;
12+
13+
<h1>[name]</h1>
14+
15+
<p class="desc">يقوم بإنشاء 6 كاميرات يتم تحويلها إلى [page:WebGLCubeRenderTarget].</p>
16+
17+
<h2>مثال التعليمة البرمجية</h2>
18+
19+
<code>
20+
// Create cube render target
21+
var cubeRenderTarget = new THREE.WebGLCubeRenderTarget( 128, { format: THREE.RGBFormat, generateMipmaps: true, minFilter: THREE.LinearMipmapLinearFilter } );
22+
23+
// Create cube camera
24+
var cubeCamera = new THREE.CubeCamera( 1, 100000, cubeRenderTarget );
25+
scene.add( cubeCamera );
26+
27+
// Create car
28+
var chromeMaterial = new THREE.MeshLambertMaterial( { color: 0xffffff, envMap: cubeRenderTarget.texture } );
29+
var car = new Mesh( carGeometry, chromeMaterial );
30+
scene.add( car );
31+
32+
// Update the render target cube
33+
car.setVisible( false );
34+
cubeCamera.position.copy( car.position );
35+
cubeCamera.update( renderer, scene );
36+
37+
// Render the scene
38+
car.setVisible( true );
39+
renderer.render( scene, camera );
40+
</code>
41+
42+
<h2>أمثلة (Examples)</h2>
43+
44+
<p>
45+
[example:webgl_materials_cubemap_dynamic materials / cubemap / dynamic ]<br />
46+
[example:webgl_shading_physical shading / physical ]
47+
</p>
48+
49+
<h2>المنشئ (Constructor)</h2>
50+
51+
52+
<h3>[name]( [param:Number near], [param:Number far], [param:WebGLCubeRenderTarget renderTarget] )</h3>
53+
<p>
54+
near -- مسافة الاقتطاع القريبة. <br />
55+
far -- مسافة القطع البعيدة <br />
56+
renderTarget -- هدف عرض مكعب الوجهة *cube render target*.
57+
</p>
58+
59+
<p>
60+
ينشئ CubeCamera الذي يحتوي على 6 [page:PerspectiveCamera PerspectiveCameras] ذلك
61+
الذي سيتم عرضه من خلال [page:WebGLCubeRenderTarget].
62+
</p>
63+
64+
<h2>الخصائص (Properties)</h2>
65+
<p>راجع فئة [page: Object3D] الأساسية للخصائص العامة.</p>
66+
67+
<h3>[property:WebGLCubeRenderTarget renderTarget]</h3>
68+
<p>
69+
الهدف الخاص بـ*cube render target*.
70+
</p>
71+
72+
<h2>الوظائف (Methods)</h2>
73+
<p>راجع فئة [page: Object3D] الأساسية للخصائص العامة.</p>
74+
75+
<h3>[method:null update]( [param:WebGLRenderer renderer], [param:Scene scene] )</h3>
76+
<p>
77+
renderer -- عارض WebGL الحالي <br />
78+
scene -- المشهد الحالي
79+
</p>
80+
<p>
81+
استدعاء هذا لتحديث [page:CubeCamera.renderTarget renderTarget].
82+
</p>
83+
84+
<h3>[method:null clear]( [param:WebGLRenderer renderer], [param:Boolean color], [param:Boolean depth], [param:Boolean stencil] )</h3>
85+
<p>
86+
قم باستدعاء هذا لمسح لون وعمق و / أو مخازن الاستنسل *stencil buffers* المؤقتة الخاصة بالهدف.
87+
يتم تعيين مخزن الألوان على اللون الواضح الحالي لجهاز العرض. القيم الافتراضية هي *true*.
88+
</p>
89+
90+
<h2>المصدر (Source)</h2>
91+
92+
<p>
93+
[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
94+
</p>
95+
</body>
96+
</html>

‎docs/list.js‎

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -524,7 +524,13 @@ var list = {
524524
"AudioContext": "api/ar/audio/AudioContext",
525525
"AudioListener": "api/ar/audio/AudioListener",
526526
"PositionalAudio": "api/ar/audio/PositionalAudio"
527-
}
527+
},
528+
529+
"Cameras": {
530+
"ArrayCamera": "api/ar/cameras/ArrayCamera",
531+
"Camera": "api/ar/cameras/Camera",
532+
"CubeCamera": "api/ar/cameras/CubeCamera",
533+
},
528534

529535
}
530536

0 commit comments

Comments
 (0)