Skip to content

Commit 03cedd8

Browse files
Mugen87Mugen87
authored
Revert "Remove old docs. (mrdoob#30748)" (mrdoob#30773)
This reverts commit 3955b05.
1 parent 8ac8375 commit 03cedd8

File tree

1,196 files changed

+153220
-2
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

1,196 files changed

+153220
-2
lines changed

‎.gitignore

+1-1
Original file line numberDiff line numberDiff line change
@@ -20,4 +20,4 @@ test/e2e/chromium
2020
test/e2e/output-screenshots
2121

2222
**/node_modules
23-
**/docs
23+
**/docs_new

‎docs/api/CONTRIBUTING.md

+7
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
Contributing to the documentation
2+
=================================
3+
4+
- To link to the page for `ClassName`, use `[page:ClassName link title]` (or just `[page:ClassName]`). Use `[page:ClassName.memberName]` to link to a class member (a property or method) called `memberName` on the page for `ClassName`. You can write `[page:.memberName]` to link to a property or method called `memberName` on the same page.
5+
- Use `[example:exampleName title]` (not just `[example:exampleName]`) to link to the example `threejs.org/examples/#exampleName`.
6+
- Document a property by writing `<h3>[property:TypeName propertyName]</h3>`.
7+
- Document a method using `<h3>[method:ReturnType methodName]</h3>`.

‎docs/api/ar/animation/AnimationAction.html

+316
Large diffs are not rendered by default.

‎docs/api/ar/animation/AnimationClip.html

+134
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,134 @@
1+
<!DOCTYPE html>
2+
<html lang="ar">
3+
<head>
4+
<meta charset="utf-8" />
5+
<base href="../../../" />
6+
<script src="page.js"></script>
7+
<link type="text/css" rel="stylesheet" href="page.css" />
8+
</head>
9+
<body class="rtl">
10+
<h1>[name]</h1>
11+
12+
<p class="desc">
13+
AnimationClip عبارة عن مجموعة قابلة لإعادة الاستخدام من مسارات الإطارات الرئيسية التي تمثل رسمًا متحركًا.<br /><br />
14+
15+
للحصول على نظرة عامة حول العناصر المختلفة لنظام الرسوم المتحركة three.js ، راجع مقالة "نظام الحركات" في قسم "الخطوات التالية" من الدليل.
16+
</p>
17+
18+
19+
<h2>المنشئ (Constructor)</h2>
20+
21+
22+
<h3>[name]( [param:String name], [param:Number duration], [param:Array tracks] )</h3>
23+
<p>
24+
[page:String name] - اسم لهذا المقطع.<br />
25+
[page:Number duration] - مدة هذا المقطع (بالثواني). إذا تم تمرير قيمة سالبة ، فسيتم حساب المدة من *tracks* التي تم تمريرها.<br />
26+
[page:Array tracks] - مجموعة (جدول) من [page:KeyframeTrack KeyframeTracks].<br /><br />
27+
28+
ملاحظة: بدلاً من إنشاء AnimationClip مباشرةً مع المُنشئ ، يمكنك استخدام إحدى طرقه الثابتة لإنشاء AnimationClips: من JSON ([page:.parse parse]) ، من تسلسلات الهدف التحويلية ([page:.CreateFromMorphTargetSequence CreateFromMorphTargetSequence] ،
29+
[page:.CreateClipsFromMorphTargetSequences CreateClipsFromMorphTargetSequences]) أو من التسلسلات الهرمية للرسوم المتحركة ([page:.parseAnimation parseAnimation]) - إذا كان النموذج الخاص بك لا يحتوي بالفعل على AnimationClips في مجموعة الرسوم المتحركة الخاصة بهندسة.
30+
</p>
31+
32+
33+
<h2>الخصائص (Properties)</h2>
34+
35+
36+
<h3>[property:Number duration]</h3>
37+
<p>
38+
مدة هذا المقطع (بالثواني). يمكن حساب ذلك من مجموعة [page:.tracks tracks] عبر [page:.resetDuration resetDuration].
39+
</p>
40+
41+
<h3>[property:String name]</h3>
42+
<p>
43+
اسم لهذا المقطع. يمكن البحث عن مقطع معين طريق بإستعمال [page:.findByName findByName].
44+
</p>
45+
46+
<h3>[property:Array tracks]</h3>
47+
<p>
48+
جدول يحتوي على [page:KeyframeTrack] لكل خاصية يتم تحريكها بواسطة هذا المقطع.
49+
</p>
50+
51+
<h3>[property:String uuid]</h3>
52+
<p>
53+
[link:http://en.wikipedia.org/wiki/Universally_unique_identifier UUID] لهذا المقطع. يتم تعيينه تلقائيًا ولا يجب تحريره.
54+
</p>
55+
56+
57+
<h2>الوظائف (Methods)</h2>
58+
59+
60+
<h3>[method:AnimationClip clone]()</h3>
61+
<p>
62+
إرجاع نسخة من هذا المقطع.
63+
</p>
64+
65+
<h3>[method:this optimize]()</h3>
66+
<p>
67+
يحسن من أداء كل مسار عن طريق إزالة المفاتيح المتسلسلة المتكررة (الشائعة في تسلسلات هدف التحويل - morph target sequences).
68+
</p>
69+
70+
<h3>[method:this resetDuration]()</h3>
71+
<p>
72+
يضبط [page:.duration duration] للمقطع على أطول مدة [page:KeyframeTrack] ممكنة.
73+
</p>
74+
75+
<h3>[method:Object toJSON]()</h3>
76+
<p>
77+
Returns a JSON object representing the serialized animation clip.
78+
</p>
79+
80+
<h3>[method:this trim]()</h3>
81+
<p>
82+
اقتطاع كل المسارات حسب مدة المقطع.
83+
</p>
84+
85+
<h3>[method:Boolean validate]()</h3>
86+
<p>
87+
يقوم بتأدية الحد الأدنى من التحقق من الصحة على كل مسار في المقطع. إرجاع *true* إذا كانت جميع المسارات صالحة.
88+
</p>
89+
90+
91+
<h2>الوظائف الساكنة (Static Methods)</h2>
92+
93+
94+
<h3>[method:Array CreateClipsFromMorphTargetSequences]( [param:String name], [param:Array morphTargetSequence], [param:Number fps], [param:Boolean noLoop] )</h3>
95+
<p>
96+
تُرجع مصفوفة من AnimationClips الجديدة التي تم إنشاؤها من morph target sequences من الشكل الهندسي ، في محاولة لفرز أسماء الأهداف التحويلية إلى أنماط قائمة على مجموعة الرسوم المتحركة مثل "Walk_001 ، Walk_002 ، Run_001 ، Run_002 ...".
97+
</p>
98+
99+
<h3>[method:AnimationClip CreateFromMorphTargetSequence]( [param:String name], [param:Array morphTargetSequence], [param:Number fps], [param:Boolean noLoop] )</h3>
100+
<p>
101+
يُرجع مقطع رسوم متحركة جديدًا من morph targets array تم تمريره لشكل هندسي ، مع أخذ اسم وعدد الإطارات في الثانية.<br /><br />
102+
103+
ملاحظة: قيمة fps مطلوبة و ضرورية ، ولكن يمكن إعادة ضبظ سرعة الرسوم المتحركة في *AnimationAction* عبر [page:AnimationAction.setDuration animationAction.setDuration].
104+
</p>
105+
106+
<h3>[method:AnimationClip findByName]( [param:Object objectOrClipArray], [param:String name] )</h3>
107+
<p>
108+
يبحث عن AnimationClip بالاسم ، مع الأخذ كقيمة إما مصفوفة من AnimationClips ، أو شبكة أو شكل هندسي يحتوي على جدول مسمى "animations".
109+
</p>
110+
111+
<h3>[method:AnimationClip parse]( [param:Object json] )</h3>
112+
<p>
113+
يترجم تمثيل JSON لمقطع ويعيد AnimationClip.
114+
</p>
115+
116+
<h3>[method:AnimationClip parseAnimation]( [param:Object animation], [param:Array bones] )</h3>
117+
<p>
118+
يوزع تنسيق animation.hierarchy ويعيد AnimationClip.
119+
</p>
120+
121+
<h3>[method:Object toJSON]( [param:AnimationClip clip] )</h3>
122+
<p>
123+
يأخذ AnimationClip ويعيد كائن JSON.
124+
</p>
125+
126+
127+
<h2>المصدر (Source)</h2>
128+
129+
130+
<p>
131+
[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
132+
</p>
133+
</body>
134+
</html>

‎docs/api/ar/animation/AnimationMixer.html

+109
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,109 @@
1+
<!DOCTYPE html>
2+
<html lang="ar">
3+
<head>
4+
<meta charset="utf-8" />
5+
<base href="../../../" />
6+
<script src="page.js"></script>
7+
<link type="text/css" rel="stylesheet" href="page.css" />
8+
</head>
9+
<body class="rtl">
10+
<h1>[name]</h1>
11+
12+
<p class="desc">
13+
AnimationMixer هو مشغل للرسوم المتحركة على كائن معين في المشهد. عندما يتم تحريك كائنات متعددة في المشهد بشكل مستقل ، يمكن استخدام AnimationMixer واحد لكل كائن.<br /><br />
14+
15+
للحصول على نظرة عامة حول العناصر المختلفة لنظام الرسوم المتحركة three.js ، راجع مقالة "نظام الحركات" في قسم "الخطوات التالية" من الدليل.
16+
</p>
17+
18+
19+
<h2>المنشئ (Constructor)</h2>
20+
21+
22+
<h3>[name]( [param:Object3D rootObject] )</h3>
23+
<p>
24+
[page:Object3D rootObject] - الكائن الذي سيتم تشغيل رسومه المتحركة بواسطة هذا الخالط.<br />
25+
</p>
26+
27+
28+
<h2>الخصائص (Properties)</h2>
29+
30+
31+
<h3>[property:Number time]</h3>
32+
<p>
33+
وقت الخالط الكامل (بالثواني ؛ بدءًا من 0 عند إنشاء الخالط).
34+
</p>
35+
36+
<h3>[property:Number timeScale]</h3>
37+
<p>
38+
عامل تحجيم لـ [page:.time mixer time].<br /><br />
39+
40+
ملاحظة: يأدي ضبط مقياس وقت الخلاط على 0 والعودة لاحقًا إلى 1 إلى إمكانية إيقاف / إلغاء إيقاف مؤقت لجميع الإجراءات التي يتحكم فيها هذا الخالط.
41+
</p>
42+
43+
44+
<h2>الوظائف (Methods)</h2>
45+
46+
47+
<h3>[method:AnimationAction clipAction]([param:AnimationClip clip], [param:Object3D optionalRoot])</h3>
48+
<p>
49+
إرجاع [page:AnimationAction] للمقطع الذي تم تمريره ، اختيارياً باستخدام كائن جذر مختلف عن الجذر الافتراضي لجهاز المزج. يمكن أن تكون القيمة الأولى إما كائن [page:AnimationClip] أو اسم AnimationClip.<br /><br />
50+
51+
إذا لم يكن هناك إجراء يلائم المقطع ومعلمات الجذر ، فسيتم إنشاؤه بهذه الطريقة. استدعاء هذه الطريقة عدة مرات مع نفس المقطع ومعلمات الجذر يؤدي دائمًا إلى إرجاع نفس مثيل المقطع.
52+
</p>
53+
54+
<h3>[method:AnimationAction existingAction]([param:AnimationClip clip], [param:Object3D optionalRoot])</h3>
55+
<p>
56+
إرجاع [page:AnimationAction] موجود للمقطع الذي تم تمريره ، اختيارياً باستخدام كائن جذر مختلف عن الجذر الافتراضي لجهاز الخالط.<br /><br />
57+
58+
يمكن أن تكون القيمة الأولى إما كائن [page:AnimationClip] أو اسم AnimationClip.
59+
</p>
60+
61+
<h3>[method:Object3D getRoot]()</h3>
62+
<p>
63+
إرجاع جذركائن الخالط.
64+
</p>
65+
66+
<h3>[method:this stopAllAction]()</h3>
67+
<p>
68+
يقوم بإلغاء تنشيط كافة الإجراءات المجدولة مسبقًا على هذا الخالط.
69+
</p>
70+
71+
<h3>[method:this update]([param:Number deltaTimeInSeconds]) </h3>
72+
<p>
73+
يعمل على تقدم وقت الخالط العالمي وتحديث الرسوم المتحركة.<br /><br />
74+
75+
يتم ذلك عادةً في حلقة العرض ، حيث يتم تمرير [page:Clock.getDelta clock.getDelta] مقياسًا بواسطة جهاز الخلاط [page:.timeScale timeScale]).
76+
</p>
77+
78+
<h3>[method:this setTime]([param:Number timeInSeconds]) </h3>
79+
<p>
80+
يضبط الخالط العام على وقت محدد ويقوم بتحديث الرسوم المتحركة وفقًا لذلك.<br /><br />
81+
82+
يكون هذا مفيدًا عندما تحتاج إلى الانتقال إلى وقت محدد في رسم متحرك. سيتم قياس القيمة المدخلة حسب مقياس الوقت لجهاز الخالط [page:.timeScale timeScale].
83+
</p>
84+
85+
<h3>[method:undefined uncacheClip]([param:AnimationClip clip])</h3>
86+
87+
<p>
88+
إلغاء تخصيص كل موارد الذاكرة لمقطع.
89+
</p>
90+
91+
<h3>[method:undefined uncacheRoot]([param:Object3D root]) </h3>
92+
<p>
93+
إلغاء تخصيص كافة موارد الذاكرة لكائن جذر.
94+
</p>
95+
96+
<h3>[method:undefined uncacheAction]([param:AnimationClip clip], [param:Object3D optionalRoot])</h3>
97+
<p>
98+
إلغاء تخصيص كل موارد الذاكرة لإجراء ما.
99+
</p>
100+
101+
102+
<h2>المصدر (Source)</h2>
103+
104+
105+
<p>
106+
[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
107+
</p>
108+
</body>
109+
</html>

‎docs/api/ar/animation/AnimationObjectGroup.html

+87
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,87 @@
1+
<!DOCTYPE html>
2+
<html lang="ar">
3+
<head>
4+
<meta charset="utf-8" />
5+
<base href="../../../" />
6+
<script src="page.js"></script>
7+
<link type="text/css" rel="stylesheet" href="page.css" />
8+
</head>
9+
<body class="rtl">
10+
<h1>[name]</h1>
11+
12+
<p class="desc">مجموعة من الكائنات التي تتلقى حالة حركة مشتركة.<br /><br />
13+
14+
للحصول على نظرة عامة حول العناصر المختلفة لنظام الرسوم المتحركة three.js ، راجع مقالة "نظام الحركات" في قسم "الخطوات التالية" من الدليل.
15+
</p>
16+
17+
<h2>الإستعمال:</h2>
18+
19+
<p class="desc">
20+
تظيف كائنات يمكن تمريرها عبر المنشئ كـ'جذر' أو عبر وظيفة [page:AnimationMixer.clipAction clipAction] الخاصة بـ [page:AnimationMixer AnimationMixer] أو بدلا من دلك عبر تمرير هدا الكائن الأخير كـ'جذر'.<br /><br />
21+
22+
23+
لاحظ أن كائنات هذه الفئة تظهر ككائن واحد للخالط ، لذا يجب التحكم في ذاكرة التخزين المؤقت للكائنات الفردية على المجموعة.
24+
</p>
25+
26+
27+
<h2>التقييدات (Limitations)</h2>
28+
<p class="desc">
29+
يجب أن تكون الخصائص المتحركة متوافقة مع جميع الكائنات في المجموعة.<br /><br />
30+
31+
يمكن التحكم في خاصية واحدة إما من خلال مجموعة مستهدفة أو بشكل مباشر ، ولكن ليس كلاهما.
32+
</p>
33+
34+
35+
<h2>المنشئ (Constructor)</h2>
36+
37+
<h3>[name]( [param:Object obj1], [param:Object obj2], [param:Object obj3], ... )</h3>
38+
<p>
39+
[page:Object obj] - عدد عشوائي من الشبكات التي تشترك في نفس حالة الحركة.
40+
</p>
41+
42+
<h2>الخصائص (Properties)</h2>
43+
44+
<h3>[property:Boolean isAnimationObjectGroup]</h3>
45+
<p>
46+
Read-only flag to check if a given object is of type [name].
47+
</p>
48+
49+
50+
<h3>[property:Object stats]</h3>
51+
<p>
52+
كائن يحتوي على بعض المعلومات حول *AnimationObjectGroup* (العدد الإجمالي ، العدد المستخدم ، عدد الروابط لكل كائن)
53+
</p>
54+
55+
<h3>[property:String uuid]</h3>
56+
<p>
57+
[link:http://en.wikipedia.org/wiki/Universally_unique_identifier UUID] الخاص بهذا *AnimationObjectGroup*. يتم تعيينه تلقائيًا ولا يجب تحريره.
58+
</p>
59+
60+
61+
<h2>الوظائف (Methods)</h2>
62+
63+
64+
<h3>[method:undefined add]( [param:Object obj1], [param:Object obj2], [param:Object obj3], ... )</h3>
65+
<p>
66+
يضيف عددًا عشوائيًا من الكائنات إلى *AnimationObjectGroup*.
67+
</p>
68+
69+
<h3>[method:undefined remove]( [param:Object obj1], [param:Object obj2], [param:Object obj3], ... )</h3>
70+
<p>
71+
يزيل عددًا عشوائيًا من الكائنات من *AnimationObjectGroup*.
72+
</p>
73+
74+
<h3>[method:undefined uncache]( [param:Object obj1], [param:Object obj2], [param:Object obj3], ... )</h3>
75+
<p>
76+
إلغاء تخصيص كافة موارد الذاكرة للكائنات التي تم تمريرها من *AnimationObjectGroup*.
77+
</p>
78+
79+
80+
<h2>المصدر (Source)</h2>
81+
82+
83+
<p>
84+
[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
85+
</p>
86+
</body>
87+
</html>

0 commit comments

Comments
 (0)