[שימו לב: מדריך זה הוא לתוכנה Pawno, התוכנה איתה מתכנתים בPawn. לא ל Pawn עצמה.]
מה זה Pawno?
התוכנה Pawno הינה תוכנה המשמשת לתכנות Pawn שמיועד ל SA-MP.
מקבלים את התוכנה עם השרת הביתי (Windows) שניתן להורדה ב
www.sa-mp.com.
התוכנה תמצא במיקום
סוגי קבצים
סוג הקובץ הראשון שאכתוב עליו הוא ".pwn".
קובץ זה הינו קובץ המקור של כל סקריפט ל SA-MP שנוצר ב Pawn, רצוי לפתוח אותו באמצעות התוכנה Pawno (רק בעזרתה תוכלו לקמפל* אותו).
קובץ זה
אינו ניתן להרצה על שרת ואין צורך להעלות אותו ל FTP או בכלל לתיקיית המודים. הוא נמצא בתיקית המודים בשרת הביתי רק כדי שיהיה קל לגשת אליו.
קיימים גם קבצי ".amx".
קבצים אלו הם קבצים אשר
ניתנים להרצה על השרת.
התחביר והשפה שלהם לא בדיוק ניתנים לשינוי על ידי משהו אחר חוץ מהקומפלייר. אפשר להגיד שהם בילתי אפשריים לשינוי... הדרך היחידה לכתוב קבצי AMX היא להשתמש בקומפלייר.
בנוסף קיימים קבצי ".inc".
קבצים אלו הינם ספריות
שלא ניתנות להרצה על שרת.
הספריות משמשות בתור עזר למתכנת בקובץ ה .pwn, הן מכילות קטעי קוד שניתן להדביק בסקריפטים שלנו.
* לקמפל - להשתמש בקומפלייר. בשפה יותר גבוהה, זה נקרא להדר - להשתמש במהדר. המהדר הינו תכונה שימושית מאוד(!) ב Pawno המאפשרת לכם לבדוק אם כתבתם נכון את הסקריפט שלכם (ובמידה ולא לרשום בעיות כוללות סוג הבעיה ומספר השורה שלה, וגם מיקום הקובץ), ובמידה והכל עובד כראוי ייווצר קובץ AMX.
שימוש בתוכנה
הכנסו לתוכנה ולאחר מכן תראו מסך כזה:
1. הלשונית File (קובץ):
New – התחלת קובץ PWN חדש (קיצור: Ctrl+N | תמונת הדף הלבן).
Open – פתיחת קובץ PWN קיים (קיצור: Ctrl+O | תמונת התיקייה).
Save – שמירה (קיצור: Ctrl+S | תמונת הדיסק).
Save As – שמירה בשם.
Exit – יציאה מהתוכנה.
2. הלשונית Edit (עריכה):
Undo – ביטול הפעולה הקודמת (קיצור: Ctrl+Z).
Cut – העתקת ומחיקת טקסט.
Copy – העתקת טקסט (קיצור: Ctrl+C).
Paste – הדבקת טקסט (קיצור: Ctrl+V).
Delete – מחיקת טקסט (קיצור: Ctrl+X).
Find – חיפוש טקסט, כולל אפשרויות חיפוש שונות (קיצור: Ctrl+F | תמונת המשקפת).
Find Next – מציאת טקסט נוסף השווה למה שחיפשת (קיצור: F3 | תמונת משקפת עם חץ המופנה לצד ימין).
Find Prev – מציאת הטקסט הקודם שמצאתם (קיצור: F4 | תמונת המשקפת עם חץ המופנה לצד שמאל).
Replace – החלפת טקסט אחד בטקסט אחר, כולל אפשרויות חיפוש שונות (קיצור: Ctrl+H | תמונת החצים והאותיות A B).
Go to – מעבר לשורה (קיצור: Ctrl+G).
Select All – בחירת כל הטקסט (קיצור: Ctrl+A).
3. הלשונית Build (בנייה):
Complie – הכנת קובץ AMX (קיצור: F5 | תמונת החלון עם הבורג).
Complie/Run – אני לא יודע באמת מה זה אמור לעשות, אבל זה מבצע את אותה הפעולה שעושה האפשרות הקודמת (קיצור: F6 | תמונת החץ הכחול).
Run Options – אפשרויות הרצה.
קצת על המהדר:
לאחר שלוחצים על כפתור השימוש במהדר (Compiler) יכולים לקבל מספר דברים:
1. שורה אחת, "קרדיט" ליוצרי המהדר: היא אומרת שהסקריפט שלכם תקין ונוצר קובץ AMX.
2.
error (בעיה) - בעיה בתכנות הסקריפט, חובה לתקן אותה. אם קיים קובץ AMX הוא יימחק.
מקסימום: יכולות להיות מקסימום 26 בעיות בכל פעם.
תיקון: יכול להיות קל ויכול להיות קשה. הכמות אינה משנה את רמת הקושי. יכולות להיות 26 בעיות קלות לתיקון, ובעיה אחת שקשה מכולן.
3. fatal error (בעיה גורלית) - בעיה שחובה לתקן אותה בכדי לראות את שאר הבעיות. פועלת בערך כמו הבעיה הרגילה.
מקסימום: בעיה גורלית אחת בכל פעם.
תיקון: לרוב המתכנתים יכול להיות קשה ודורש יידע בדברים שהם מעבר ל Pawn פשוטה.
4. warning (אזהרה) - לא חובה לתקן בכדי ליצור AMX, יש 2-3 סוגי אזהרות שאפשר להתעלם מהן, אבל את רובן צריך לתקן. אני אישית ממליץ לתקן הכל.
מקסימום: לא יידוע לי על מספר מקסימאלי של אזהרות.
תיקון: קל מאוד בדרך כלל.
4. הלשונית Options (אפשרויות):
Font – בחירת פונט הטקסט.
Show Function List – אפשרות בחירה להצגת רשימת הפונקציות (בצד ימין).
Associate with .pwn files – אפשרות לקשר את הPawno לקבצי .pwn.
[אני ממליץ להשאיר את האפשרויות שלמעלה כמו שהן]
5. הלשונית Help (עזרה):
Help Topics – אמור להיות כנראה מסמכי עזרה, אבל הם לא קיימים (קיצור: F1 | תמונת סימן השאלה).
About Pawno – הצגת מידע וקרדיטים ליוצר התוכנה,
spookie וגם ל
אתר SA-MP בשבילו נבנתה התוכנה.
6. חלון הטקסט:
בכל המרובע הלבן ששם תוכלו לכתוב את הסקריפט שלכם.
בצד שמאל, החלק האפור, תוכלו לראות מספרי שורות.
7. רשימת הפונקציות:
ברשימה הזאת נמצאים כל הפונקציות שהוגדרו.
תוכלו ללחוץ על פונקציה על מנת לקבל מידע עליה בשורת המידע.
לחצו על פונקציה פעמיים על מנת שהתוכנה תכתוב אותה.
8. שורת מידע:
בשורת המידע תוכלו לראות את הפעולה האחרונה שביצעתם (שמירה, חיפוש וכו').
בנוסף, לקראת סוף שורת המידע יש קו: לאחר הקו הזה תוכלו לראות באיזה שורה אתם נמצאים ובאיזה מספר תו.
מידע שימושי נוסף
*
מספרי שורות: בחלק האפור כהה בתמונה שהוראתה קודם יופיעו מספרי השורות.
*
מעבר של הרבה שורות בבת אחת (לסקריפטים גדולים): ניתן לעבור 60 שורות קדימה בעזרת הכפתור Page Down או 60 שורות אחורה בעזרת Page Up.
*
סימון שורות: יש לכם אפשרות למספר סימון, בצורה כזאת שאם תלחצו על צירוף מקשים מסויים תועברו אליהן אוטומטית: אם תלחצו על Ctrl + Shift + מספר (0-9) תראו מספר קטן בריבוע ליד מספר השורה. כדי להגיע אליו, פשוט לחצו Ctrl + המספר. לדוגמה אם לחצתי Ctrl + Shift + 5 ייווצר ריבוע ובתוכו המספר 5 ליד מספר השורה שאני נמצא בה. ברגע שארצה להגיע אל אותה השורה - פשוט אלחץ Ctrl + 5.
-END-