Skip to content

Commit 62813ff

Browse files
mrdoobmrdoob
authored
Merge pull request #20149 from hassanMuhamad/dev
Docs(Ar): Reference - Add more pages to the "Animation" section
2 parents 39551ee + 62830d9 commit 62813ff

File tree

3 files changed

+242
-0
lines changed

3 files changed

+242
-0
lines changed

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

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

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

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

‎docs/list.js‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -499,6 +499,8 @@ var list = {
499499

500500
"الحركات": {
501501
"AnimationAction": "api/ar/animation/AnimationAction",
502+
"AnimationClip": "api/ar/animation/AnimationClip",
503+
"AnimationMixer": "api/ar/animation/AnimationMixer"
502504
}
503505

504506
}

0 commit comments

Comments
 (0)