مبحث اختصاصی شرح کامل دستورات maxscript

تصمیم دارم برای پیشرفت سریعتر مبحث maxscript کدها و دستورات maxscript به صورت جدا و پشت سر هم بررسی و توضیح داده شوند

فقط کدها بیان شده و شرح داده میشن البته مفصل تر از خود هلپ

در این مبحث به این صورت عمل میکنیم که:

1: هر کد نوشته شده و قسمتهای آن که قابل تغییر هستند و باید مقدار دهی شوند بررسی میشه
2: برای هر کد یک مثال کوتاه زده میشه که در این مثال فقط عمل کرد کد بررسی میشه و تا جایی که بتونم کارایی کد معلوم بشه

باید توجه داشت که خیلی از کدها درهلپ مکس اسکریپت بدون مثال هستند و تنها راه فهمیدن کد کار کردن با کد و روش
آزمایش وخطاست به همین دلیل از دوستان علاقمند میخام اگر کدی قابل درک توسط بنده نشد خودشونو اونو تست کنند
و نتیجه رو اعلام کنند

کدها در هلپ مکس اسکریپت به صورت مرتب و پشت سرهم توضیح داده میشوند البته بر اساس مبحث اون کدها در هلپ.

منبع ما 3dsmax 2010 خواهد بود

کسانی که تازه کارند قبلش اینجارو مطالعه کنند

کد:

---

http://forum.p30world.com/showthread.php?t=315161

---

چون خیلی ها در تری دی مکس روی مدلینگ کار میکنند تصمیم گرفتم گروهی از کدهای مربوط به مدلینگ و یا در کل مربوط به مدلینگ میشن مورد برسی قرار بدم و کار رو با اونا شروع کنم

من برای هر کد یه شناسه قرار میدم تا مسیر قرار گیریه کد در هلپ و همچنین نوع کد مشخص بشه

مثال ها برای هر کد خیلی کوتاهه برای همین اگه توضیح بیشتر خواستین باید سوال کنید

از منوی هلپ maxscript refrence را اجرا کنید
از سر برگ Contents به مسیر زیر بروید

Maxscript Language refrence >
3ds max objects >
Editable Meshes, Splines, Patches and Polys>
Editable_Mesh and Tri mesh>
Mesh Vertex Methods


شما حالا در صفحه Mesh Vertex Methods هستید که شامل 13 دستور میباشد

Maxscript Language refrence >
3ds max objects >
Editable Meshes, Splines, Patches and Polys>
Editable_Mesh and Tri mesh>
Mesh Vertex Methods

لیست دستورات صفحه Mesh Vertex Methods

این صفحه شامل 13 دستور میباشد

کد:

---


getNumVerts <mesh>

setNumVerts <mesh> <vert_index_integer> [ <boolean> ]

getVert <mesh> <vert_index_integer>

setVert <mesh> <vert_index_integer> ( <point3> | <float> <float> <float> )

deleteVert <mesh> <vert_index_integer>




getNormal <mesh> <vert_index_integer>

setNormal <mesh> <vert_index_integer> <point3>




getVertSelection <node> [ <modifier_or_index> ] [ name:<name> ]

getVertSelection <mesh>

setVertSelection <node> [<modifier_or_index>] ( <sel_bitarray> | <sel_array> ) [name:<name>] [keep:<boolean>]

setVertSelection <mesh> ( <sel_bitarray> | <sel_array> ) [keep:<boolean>]

averageSelVertCenter <node>

averageSelVertNormal <node>

---

این دستورات کلی برای کا ر با vertexها میباشند

قبل از اجرای دستورات باید آبجکت شما به editable mesh تبدیل شده باشه

فقط یک نکته رو بگم که بعد از تغییرات توسط دستورات باید موضوع mesh , آپدیت بشه تا تغییرات در viewport دیده بشن

لذا ما از دستور زیر بعد از تغییرات لازم استفاده میکنیم تا موضوع آپدیت بشه

کد:

---


Update <mesh>

---

در قسمت <mesh> ما موضوع رو وارد میکنیم

======================
مثال1

موضوعی که در حالت انتخاب هست آپدیت میشه

کد:

---


update $

---

======================

مثال2

موضوعی که اسم اون صرفا وارد شده آپدیت میشه

کد:

---



update $box01

---

پس ممکنه این دستور را در مثالها کنار دستورات دیگه ببینید

مبحث وشماره کد: Mesh Vertex Methods_ code 1_index 1
************************************************** *********

دستور

کد:

---


getNumVerts <mesh>


---

-------------------------------------------------
توضیح بخشهای دستور:

1 در قسمت mesh موضوعی را که به mesh تبدیل شده وارد میکنیم
-------------------------------------------------
عمل کرد:

1 تعداد vertex های موجود در مش را بیان میکنه به صورت یک عدد صحیح

==========================================
مثال :

کد:

---


getNumVerts $box01

8

---

تعداد ورتکسها در موضوع مورد نظر 8 عدد هستش

مبحث وشماره کد: Mesh Vertex Methods_ code 2_index 2
************************************************** *********


دستور

کد:

---


setNumVerts <mesh> <vert_index_integer> [ <boolean> ]

---

-------------------------------------------------------
توضیح بخشهای مختلف دستور:

1: <mesh> موضوع مش را در این قسمت وارد میکنیم
2: <vert_index_integer> هر ورتکس شماره گذاری شده و توسط آن شماره قابلیت فراخوانی داره
مثلا در یک plane ما چهار ورتکس داریم که به این ترتیب قابلیت شناسایی دارن
1 2 3 4
پس در این قسمت شماره ورتکس را وارد میکنیم

3: [ <boolean> ] این قسمت قابلیت تنظیم دارد که به صورت on و یا off استفاده میشود
on باعث فعال شدن تنظیم میشود
off باعث خاموش شدن این تنظیم میشود
در صورت استفاده نکردن از این تنظیم off در نظر گرفته میشود

در واقع در این قسمت تایین میکنیم که ساختار قبلی مش حفظ شود و یا خیر

--------------------------------------------------------
عملکرد دستور:

تعداد ورتکسهای موجود در یک بافت مش را تایین میکند

----------------------------------------------------------

مثال1:

ما یک plane داریم که دارای چهار ورتکس هستش
حالا ما میخواهیم یک ورتکس دیگه به این موضوع اظافه کنیم تا جمعا پنج ورتکس داشته باشیم
برای اینکه شکل اولیه plane بهم نخوره بخش تنظیمیه <boolean> را روی on میگذاریم

کد:

---


setNumVerts $plane01 5 on

5

update $plane01

ok


---

برای دیدن ورتکس جدید درحالت مد ورتکس از مدیفایر editable mesh قرار بگیرید
همچنین به صورت پیشفرض ورتکسهای اضافه شده در مختصات 0 قرار میگیرن پس ممکن است چندین ورتکس روی هم قرار بگیرند
=======================================
مثال2:
ما یک plane داریم که دارای چهار ورتکس هستش
حلا ما میخواهیم مش ما فقط یک ورتکس داشته باشه
با اجرای دستور زیر سه ورتکس دیگر حذف میشوند و فقط یک ورتکس باقی میمونه

کد:

---


setNumVerts $plane01 1

1

update $plane01

ok

---

====================================
مثال3:

ما یک plane داریم که دارای چهار ورتکس هستش

کد:

---


setNumVerts $plane01 3

3

update $plane01

ok

---

مبحث وشماره کد: Mesh Vertex Methods_ code 3_index 3
************************************************** *********



دستور :

کد:

---


getVert <mesh> <vert_index_integer>

---

-----------------------------------------------------
توضیح بخشهای مختلف:

1: <mesh> موضوع مش را در اینجا وارد میکنیم
2: <vert_index_integer> شماره ورتکس مورد نظر راوارد میکنیم
---------------------------------------------------
عملکرد:

1:گزارشی از موقعیت یا position یک ورتکس را در فضای سه بعدی به ما میدهد
=======================================
مثال1:

کد:

---



getvert $box01 4

[0,10.55,45.1254]

---

===========================
مثال2:

کد:

---


myvert_pos = getvert $sphere01 25

[125.254,45.365,1.0]

---

مبحث وشماره کد: Mesh Vertex Methods_ code 4_index 4
************************************************** *********


دستور:

کد:

---


setVert <mesh> <vert_index_integer> ( <point3> | <float> <float> <float> )

---

توضیح قسمتهای مختلف اسکریپت:
1: <mesh> موضوع مش را در اینجا وارد میکنیم

2 :<vert_index_integer> شماره ایندکس ورتکس را اینجا وارد میکنیم

3: ( <point3> | <float> <float> <float> ) پوزیشن مورد نظر را اینجا وارد میکنیم

البته پوزیشن رو به دو صورت میتوان وارد کرد
حالت point3 مانند

کد:

---


[x,y,z]

---

و یا هر محور رابه صورت جدا وارد کنیم مانند

کد:

---


x  y  z

---

عملکرد:
میتوان برای ورتکس مورد نظر یک پوزیشن در فضا تعیین کرد

البته در این حالت ورتکس قابل انیمیت نیست


مثال1:

کد:

---


setVert $box01 1 0 0 0
OK
update $box01
OK

---

مثال2:

کد:

---


setVert $box01 1 [0,0,50]
OK
update $box01
OK

---

مبحث وشماره کد: Mesh Vertex Methods_ code 5_index 5
************************************************** *********



دستور:

کد:

---


deleteVert <mesh> <vert_index_integer>

---

توضیح بخشهای مختلف دستور:

1: <mesh> در اینجا موضوع مش رو وارد میکنیم
2 : <vert_index_integer> شماره ورتکس مورد نظر راوارد میکنیم

عملکر:

باعث حذف ورتکس مورد نظر از موضوع مش میشود

نکات:
1: حذف یک ورتکس باعث شماره گذاری مجدد ورتکس ها میشود
مثلا با حذف ورتکس شماره 1 ورتکس 2 به شماره ورتکس 1 نامگذاری میشود

2: حذف یک ورتکس باعث حذف پلیگانها و فیسهای مرتبط با آن ورتکس میشود


مثال:

کد:

---



deleteVert $sphere01 1
ok
update $sphere01
ok

---

بعد از توضیحات این پنجتا کد بدم نیومد یک مثال عملی تر از این مجموعه کدها بزنم

مثال:

قبلش یک sphere بسازید و تبدیل به editable mesh کنید

حالا کدهای زیر رو اجرا کنید

کد:

---



nv = getNumVerts $sphere01
for i = 1 to nv by 2 do
(
deleteVert $sphere01 i

)
update $sphere01

---

نتیجه:

[ برای مشاهده لینک ، با نام کاربری خود وارد شوید یا ثبت نام کنید ]

مبحث وشماره کد: Mesh Vertex Methods_ code 6_index 6
************************************************** *********

دستور:

کد:

---


getNormal <mesh> <vert_index_integer>

---

مشخصات بخشهای مختلف :
<mesh>موضوع مش را در اینجا وارد میکنیم

<vert_index_integer> ورتکس مورد نظر را وارد میکنیم

عملکرد:

direction یا جهت normal قرار گرفته روی ورتکس مورد نظر را بیان میکند


نکات:

*برای دیدن نرمالها گزینه show normal در تنظیمات editable mesh را فعال کنید و ورتکس یا ورتکسهایی را انتخاب کنید

*direction همان جهت یک موضوع به سوی یک نقطه در فضاست

*در اینجا منظور از normal ها , normal های نوری نیستند

*جهت این normal ها بستگی به جهت normalهای faceهایی دارد که ورتکس مورد نظر در آن قرار دارد

مثال:

کد:

---



getnormal  $plane01 2

[0,0,1]

---

مبحث وشماره کد: Mesh Vertex Methods_ code 7_index 7
************************************************** *********


دستور:

کد:

---


setNormal <mesh> <vert_index_integer> <point3>

---

مشخصات بخشهای مختلف :

<mesh>موضوع مش را در اینجا وارد میکنیم

<vert_index_integer>ورتکس مورد نظر را وارد میکنیم

<point3>یک پوینت یا نقطه در فضا تعیین میکنیم


عملکرد:

باعث تغییر direction یا جهت یک نرمال مربوط به ورتکس مورد نظر میشود

باید یک پوینت یا نقطه در فضا تایین کرد تا جهت وdirection نرمال مورد نظر به سوی آن تغییر کند


نکات:
با آپدیت کردن موضوع مش نرمال تغییر یافته به مقادیر اوله خود باز میگردد
همچنین تغییرات و ویرایش های مختلف باعث reset شدن تغییرات داده شده در نرمال مورد نظر خواهد شد

مثال1:

کد:

---



setNormal  $plane01  2  [0,0,-1]

[0,0,-1]

---

مثال2:

کد:

---


setnormal  $plane01  2  [0,0,-1]

[0,0,-1]

getnormal $plane01  2

[0,0,-1]

update $plane01

ok

getnormal $plane01  2

[0,0,1]

---