תמונה - מקוון בענן

תָכְנִית:

שֵׁם

pic - הרכב תמונות עבור troff או TeX

תַקצִיר

קצת [ -nvCSU ] [ שם הקובץ ... ]
קצת -t [ -cvzCSU ] [ שם הקובץ ... ]

תיאור

דף מדריך זה מתאר את גרסת GNU של קצת, שהוא חלק ממסמך הגרוף
מערכת עיצוב. קצת אוסף תיאורים של תמונות המוטמעות בתוכם טראף או TeX
הזנת קבצים לפקודות המובנות על ידי TeX או טראף. כל תמונה מתחילה בא
קו שמתחיל ב . PS ומסתיים בשורה שמתחילה ב .פ. כל דבר מחוץ ל . PS
ו .פ עובר ללא שינוי.

באחריות המשתמש לספק הגדרות מתאימות של PS ו PE
פקודות מאקרו. כאשר חבילת המאקרו שבה נעשה שימוש אינה מספקת הגדרות כאלה (לדוגמה,
גרסאות ישנות של -ms), ניתן לקבל הגדרות מתאימות עם -mpic: אלה ירצו
במרכז כל תמונה.

אפשרויות

אפשרויות שאינן לוקחות ארגומנטים עשויות להיות מקובצות מאחורי יחיד -. האפשרות המיוחדת
-- ניתן להשתמש כדי לסמן את סוף האפשרויות. שם קובץ של - מתייחס לתקן
קֶלֶט.

-C לזהות . PS ו .פ גם כאשר אחריו מופיע תו שאינו רווח או
שורה חדשה.

-S מצב בטוח יותר; לא לבצע sh פקודות. זה יכול להיות שימושי בעת הפעלה
קלט לא אמין (מופעל כברירת מחדל).

-U מצב לא בטוח; החזר את אפשרות ברירת המחדל -S.

-n אל תשתמש בהרחבות ה-groff לפקודות ציור הטרוף. כדאי להשתמש בזה
אם אתה משתמש ב-postprocessor שאינו תומך בהרחבות אלו. ה
הרחבות מתוארות ב groff_out(5). ה -n אפשרות גם גורמת קצת שלא להשתמש
קווים באורך אפס לציור נקודות במצב troff.

-t מצב TeX.

-c להיות יותר תואם עם tpic. מרמז -t. שורות שמתחילות ב לא עוברים
דרך שקוף. שורות שמתחילות ב . עוברים עם ההתחלה
. שונה ל . שורה שמתחילה ב .ps זוכה לטיפול מיוחד: זה לוקח
ארגומנט מספר שלם אופציונלי המציין את עובי הקו (גודל העט) במיליאינץ';
ארגומנט חסר משחזר את עובי הקו הקודם; עובי הקו המוגדר כברירת מחדל
הוא 8 מיליאינץ'. עובי הקו שצוין כך נכנס לתוקף רק כאשר לא
עובי קו שלילי לא צוין על ידי שימוש ב- עוֹבִי תכונה או
על ידי הגדרת ה- עובי קו משתנה

-v הדפס את מספר הגרסה.

-z במצב TeX צייר נקודות באמצעות קווים באורך אפס.

האפשרויות הבאות נתמכות על ידי גרסאות אחרות של קצת מתעלמים:

-D צייר את כל הקווים באמצעות רצף הבריחה \D. קצת תמיד עושה את זה.

-T dev צור פלט עבור טראף מכשיר dev. זה מיותר כי טראף
פלט שנוצר על ידי קצת הוא בלתי תלוי במכשיר.

נוהג

סעיף זה מתאר רק את ההבדלים בין GNU קצת והגרסה המקורית של
קצת. רבים מההבדלים הללו חלים גם על גרסאות חדשות יותר של Unix קצת. מלא
התיעוד זמין בתיק

/usr/share/doc/groff-base/pic.ms.gz

TeX מצב
מצב TeX מופעל על ידי -t אוֹפְּצִיָה. במצב TeX, קצת יגדיר vbox בשם \גרָף
עבור כל תמונה. להשתמש ב שם התאנה פקודה כדי לשנות את שם ה-vbox. אתה חייב
תדפיס את ה-vbox הזה באמצעות, למשל, הפקודה

\centerline{\box\graph}

למעשה, מכיוון של-vbox יש גובה אפס (הוא מוגדר עם \vtop) זה ייצור
מעט יותר שטח אנכי מעל התמונה מאשר מתחתיה;

\מרכז קו{\להעלות 1em\box\graph}

ימנע זאת.

לגרום ל-vbox להיות בעל גובה חיובי ועומק של אפס (כפי שמשמש למשל על ידי LaTeX
graphics.sty), הגדר את המאקרו הבא במסמך שלך:

\def\gpicbox#1{%
\vbox{\unvbox\csname #1\endcsname\kerne 0pt}}

עכשיו אתה יכול פשוט לומר \gpicbox{גרף} במקום \box\graph.

עליך להשתמש במנהל התקן TeX התומך ב- tpic מבצעים, גרסה 2.

שורות שמתחילות ב עוברים בשקיפות; א % מתווסף לסוף ה
קו כדי למנוע רווחים לא רצויים. אתה יכול להשתמש בבטחה בתכונה זו כדי לשנות גופנים או כדי
לשנות את הערך של \baselineskip. כל דבר אחר עשוי בהחלט להניב תוצאות לא רצויות;
השימוש על אחריותך בלבד. שורות המתחילות במחזור אינן זוכות ליחס מיוחד.

פקודות
ל משתנה = expr1 ל expr2 [by [*]expr3] do X גוּף X
לקבוע משתנה ל expr1. בעוד הערך של משתנה פחות או שווה ל expr2,
do גוּף ותוספת משתנה by expr3; אם by לא ניתן, תוספת משתנה by
1. אם expr3 קידומת על ידי * אז משתנה במקום זאת יוכפל ב expr3.
הערך של expr3 יכול להיות שלילי עבור מקרה התוסף; משתנה לאחר מכן נבדק
אם הוא גדול או שווה ל expr2. למקרה הכפל, expr3
חייב להיות גדול מאפס. אם האילוצים לא מתקיימים, הלולאה לא מבוצעת.
X יכול להיות כל תו שלא מופיע בו גוּף.

if ביטוי אז X אם זה נכון X [אחר Y אם-שקר Y]
להעריך ביטוי; אם הוא לא אפס אז תעשה אם זה נכון, אחרת תעשה אם-שקר. X יכול להיות
כל דמות שלא מופיעה ב אם זה נכון. Y יכול להיות כל תו שלא מופיע בו
אם-שקר.

הדפסה גדול מ...
שרשור את הטיעונים והדפיס כשורה על stderr. כל אחד גדול מ חייב להיות
ביטוי, עמדה או טקסט. זה שימושי לניפוי באגים.

הפקודה גדול מ...
שרשרו את הטיעונים והעבירו אותם כשורה ל-troff או ל-TeX. כל אחד
גדול מ חייב להיות ביטוי, עמדה או טקסט. יש לזה אפקט דומה לא
קו שמתחיל ב . or , אך מאפשר להעביר את ערכי המשתנים
דרך. לדוגמה,

. PS
x = 14
הפקודה ".ds מחרוזת x is " x "."
.פ
\*[חוּט]

הדפסים

x is 14.

sh X הפקודה X
לעבור הפקודה לקליפה. X יכול להיות כל תו שלא מופיע בו הפקודה.

העתק "שם הקובץ"
לכלול שם הקובץ בשלב זה בקובץ.

העתק ["שם הקובץ"] דרך X גוּף X [עד "מילה"]
העתק ["שם הקובץ"] דרך מאקרו [עד "מילה"]
המבנה הזה כן גוּף פעם אחת עבור כל שורה של שם הקובץ; הקו מפוצל ל
מילים מופרדות ריק, ומופעים של $i in גוּף, עבור i בין 1 ל-9, הם
הוחלף על ידי i-המילה של השורה. אם שם הקובץ לא ניתן, קווים נלקחים
מהקלט הנוכחי ועד .פ. אם עד הסעיף מצוין, שורות יהיו
לקרוא רק עד שורה שהמילה הראשונה שבה היא מילה; הקו הזה יהיה אז
מוּשׁלָך. X יכול להיות כל תו שלא מופיע בו גוּף. לדוגמה,

. PS
העתק דרך % מעגל at ($1,$2) % עד "סוֹף"
1 2
3 4
5 6
הסוף
קופסה
.פ

שווה

. PS
מעגל at (1,2)
מעגל at (3,4)
מעגל at (5,6)
קופסה
.פ

את הפקודות שיש לבצע עבור כל שורה ניתן לקחת גם ממאקרו מוגדר
קודם לכן על ידי מתן שם המאקרו כארגומנט ל דרך.

לאתחל
לאתחל משתנה 1[,] משתנה 2 ...
אפס משתנים מוגדרים מראש משתנה 1, משתנה 2 ... לערכי ברירת המחדל שלהם. אם
לא ניתנים ארגומנטים, אפס את כל המשתנים המוגדרים מראש לערכי ברירת המחדל שלהם.
שים לב שהקצאת ערך ל סולם גם גורם לכל המשתנים המוגדרים מראש כי
מידות בקרה שיאופסו לערכי ברירת המחדל שלהן כפול הערך החדש של
סוּלָם.

עלילה ביטוי ["טֶקסט"]
זהו אובייקט טקסט אשר נבנה באמצעות שימוש טֶקסט כמחרוזת פורמט עבור
sprintf עם טיעון של ביטוי. אם טֶקסט הושמט מחרוזת פורמט של "%g" is
בשימוש. ניתן לציין תכונות באותו אופן כמו עבור אובייקט טקסט רגיל. לִהיוֹת
זהיר מאוד שתציין מחרוזת פורמט מתאימה; קצת עושה רק מאוד
בדיקה מוגבלת של המחרוזת. זה מבוטל לטובת ספרינטף.

משתנה := ביטוי
זה דומה ל = אלא משתנה חייב להיות מוגדר כבר, ו ביטוי יהיה
שהוקצה ל משתנה מבלי ליצור משתנה מקומי לבלוק הנוכחי. (על ידי
בניגוד, = מגדיר את המשתנה בבלוק הנוכחי אם הוא עדיין לא מוגדר
שם, ולאחר מכן משנה את הערך בבלוק הנוכחי בלבד.) לדוגמה, ה-
הבא:

. PS
x = 3
y = 3
[
x := 5
y = 5
]
הדפסה x " " y
.פ

הדפסים

5 3

טיעונים של הטופס

X דבר X

מותר גם להיות בצורה

{ דבר }

במקרה הזה דבר יכול להכיל מופעים מאוזנים של { ו }. מחרוזות עשויות להכיל X
או מופעים לא מאוזנים של { ו }.

ביטויים
התחביר לביטויים הורחב משמעותית:

x ^ y (אקספונציה)
חטא(x)
cos (x)
atan2(y, x)
עֵץ(x) (בסיס 10)
exp (x) (בסיס 10, כלומר 10^x)
sqrt(x)
int (x)
ראנד () (החזר מספר אקראי בין 0 ל-1)
ראנד(x) (החזר מספר אקראי בין 1 ל x; הוצא משימוש)
srand(x) (הגדר את זרע המספר האקראי)
מקסימום(e1, e2)
דקה(e1, e2)
!e
e1 && e2
e1 || e2
e1 == e2
e1 != e2
e1 >= e2
e1 > e2
e1 <= e2
e1 < e2
"עמ' 1" == "עמ' 2"
"עמ' 1" != "עמ' 2"

יש לסמן ביטויי השוואת מחרוזות בסוגריים בהקשרים מסוימים כדי למנוע אי בהירות.

אחר שינויים
הבעה חשופה, ביטוי, מקובל כתכונה; זה שווה ערך ל dir ביטוי,
איפה dir הוא הכיוון הנוכחי. לדוגמה

קו 2i

פירושו לצייר קו באורך 2 אינץ' בכיוון הנוכחי. התו 'אני' (או 'אני') הוא
התעלמו; כדי להשתמש ביחידת מדידה אחרת, הגדר את סולם משתנה לערך מתאים.

הרוחב והגובה המרביים של התמונה נלקחים מהמשתנים maxpswid ו
maxpsht. בתחילה יש להם ערכים 8.5 ו-11.

סימון מדעי מותר למספרים. לדוגמה

x = 5e-2

ניתן להרכיב תכונות טקסט. לדוגמה,

"פו" מֵעַל ברור

תקף.

אין גבול לעומק שאליו ניתן לבחון בלוקים. לדוגמה,

[א: [ב: [C: קופסה ]]] עם .ABCsw at 1,2
מעגל at אחרון [].א ב ג

מקובל.

לקשתות יש כעת נקודות מצפן שנקבעות לפי המעגל שהקשת היא חלק ממנו.

מעגלים, אליפסות וקשתות יכולים להיות מנוקדים או מקווקו. במצב TeX ניתן לנקד קווים או
מקווקו גם.

לקופסאות יכולות להיות פינות מעוגלות. ה רד תכונה מציינת את הרדיוס של הרבע-
עיגולים בכל פינה. אם לא רד or קוטר נתון תכונה, רדיוס של בוקסרד משמש.
בתחילה, בוקסרד יש ערך של 0. תיבה עם פינות מעוגלות יכולה להיות מנוקדת או מקווקו.

לקופסאות יכולות להיות צדדים מלוכסנים. זה משנה למעשה את צורת הקופסה מא
מלבן למקבילית שרירותית. ה משופעת ו השתלט תכונות מציינות את
קיזוז x ו-y של הפינה הימנית העליונה של התיבה ממיקום ברירת המחדל שלה.

השמיים . PS לקו יכול להיות ארגומנט שני המציין גובה מקסימלי לתמונה. אם
הרוחב של אפס מצוין. הרוחב יתעלם בחישוב גורם קנה המידה
לתמונה. שימו לב ש-GNU קצת תמיד ישתלם תמונה באותה כמות
אנכית וגם אופקית. זה שונה מה-DWB 2.0 קצת שעלול
קנה קנה מידה של תמונה בכמות שונה אנכית מאשר אופקית אם גובה הוא
נָקוּב.

לכל אובייקט טקסט יש תיבה בלתי נראית המשויכת אליו. נקודות המצפן של טקסט
האובייקט נקבעים על ידי תיבה זו. התנועה המרומזת הקשורה לאובייקט היא גם
נקבע על ידי תיבה זו. מידות הקופסה הזו נלקחות מהרוחב והגובה
תכונות; אם תכונת הרוחב אינה מסופקת, הרי שהרוחב ייחשב ככזה
רוחב טקסט; אם תכונת הגובה לא מסופקת, הגובה ייחשב כ-
מספר מחרוזות טקסט המשויכות לזמני האובייקט textht. בתחילה רוחב טקסט ו
textht יש ערך של 0.

ב (כמעט בכל) המקומות שבהם ניתן להשתמש במחרוזת טקסט מצוטטת, ביטוי של הצורה

sprintf("פוּרמָט", גדול מ,...)

ניתן להשתמש גם; זה ייצור את הארגומנטים המעוצבים לפי פוּרמָט, אשר
צריכה להיות מחרוזת כמתואר ב הדפס(3) מתאים למספר הטיעונים
מסופק.

עובי הקווים המשמשים לציור אובייקטים נשלט על ידי עובי קו משתנה
זה נותן את עובי הקווים בנקודות. ערך שלילי פירושו להשתמש בברירת המחדל
עובי: במצב פלט TeX, זה אומר להשתמש בעובי של 8 מיליאינץ'; בפלט TeX
מצב עם ה -c אפשרות, זה אומר להשתמש בעובי הקו שצוין על ידי .ps שורות; ב
מצב פלט troff, זה אומר להשתמש בעובי פרופורציונלי ל-pointsize. ערך אפס
פירושו לצייר את הקו הדק ביותר האפשרי הנתמך על ידי התקן הפלט. בתחילה יש לו א
ערך של -1. יש גם עבה[נוס] תכונה. לדוגמה,

מעגל עוֹבִי 1.5

היה מצייר עיגול באמצעות קו בעובי של 1.5 נקודות. עובי הקווים
אינו מושפע מערכו של ה סולם משתנה, ולא לפי הרוחב או הגובה המופיעים ב
מה היא . PS קו.

קופסאות (כולל קופסאות עם פינות מעוגלות או צדדים מלוכסנים), עיגולים ואליפסות יכולים להיות
מילא על ידי מתן תכונה של למלא[ed]. זה דורש טיעון אופציונלי של an
ביטוי עם ערך בין 0 ל-1; 0 ימלא אותו בערכים של לבן, 1 בשחור
בין לבין עם גוון אפור פרופורציונלי. ניתן להשתמש גם בערך גדול מ-1:
המשמעות היא מילוי בגוון האפור המשמש כעת עבור טקסט ושורות.
בדרך כלל זה יהיה שחור, אבל התקני פלט עשויים לספק מנגנון לשינוי זה.
ללא ארגומנט, אז הערך של המשתנה fillval יהיה בשימוש. בתחילה זה
יש ערך של 0.5. התכונה הבלתי נראה אינה משפיעה על מילוי החפצים. כל
טקסט המשויך לאובייקט מלא יתווסף לאחר מילוי האובייקט, אז
שהטקסט לא יסתיר במילוי.

שלושה מתקנים נוספים זמינים לציון אובייקטים צבעוניים: מתווה[d] מגדיר את
צבע קו המתאר, מוצל צבע המילוי, ו קולו[u]r[ed] מגדיר את שניהם. כל השלושה
מילות מפתח מצפות לסיומת המציינת את הצבע, למשל

מעגל מוצל "ירוק" מתווה "שָׁחוֹר"

נכון לעכשיו, תמיכת צבע אינה זמינה במצב TeX. שמות צבע מוגדרים מראש עבור גרף
נמצאים בקובצי המאקרו של המכשיר, למשל ps.tmac; ניתן להגדיר צבעים נוספים עם
מה היא .defcolor בקשה (ראה את הדף המדריך של טראף(1) לפרטים נוספים).

כדי לשנות את שם ה-vbox במצב TeX, הגדר את הפסאודו-משתנה שם התאנה (שהוא
למעשה פקודה מנותחת במיוחד) בתוך תמונה. דוגמא:

. PS
שם התאנה = פו בר;
...
.פ

לאחר מכן, התמונה זמינה בקופסה \פו בר.

קצת מניח שבתחילת תמונה גם הגליף וגם צבע המילוי מוגדרים ל-
ערך ברירת מחדל.

ראשי חצים יצוירו כמשולשים מלאים אם המשתנה ראש חץ אינו אפס ו
או שמצב TeX מופעל או -n לא ניתנה אפשרות. בתחילה ראש חץ יש
ערך של 1. שימו לב שראשי חצים מלאים תמיד מלאים בצבע המתאר הנוכחי.

פלט הטרוף של קצת הוא בלתי תלוי במכשיר. ה -T לכן האופציה מיותרת. את כל
מספרים נחשבים באינצ'ים; מספרים אף פעם לא מתפרשים להיות במכונת troff
יחידות.

לאובייקטים יכול להיות מיושר תְכוּנָה. זה יעבוד רק אם ה-postprocessor כן מגששים,
or gropdf. כל טקסט המשויך לאובייקט בעל ה- מיושר תכונה תהיה
מסתובב סביב מרכז האובייקט כך שהוא מיושר בכיוון מה-
נקודת התחלה לנקודת הסיום של האובייקט. שים לב שלתכונה זו לא תהיה השפעה
עבור אובייקטים שנקודות ההתחלה והסיום שלהם מקבילות.

במקומות שבהם nth מותר "ביטויה' מותר גם כן. ציין זאת ה' הוא אסימון בודד:
אין מרווח בין ה " ו th. לדוגמה,

ל i = 1 ל 4 do {
קו החל מ- אני box.nw ל 'אני+1' box.se
}

המרה

לקבלת תמונה עצמאית מא קצת קובץ, צרף את שלך קצת קוד עם . PS ו .פ
בקשות; roff ניתן להוסיף פקודות תצורה בתחילת הקובץ, אך לא
roff טקסט.

יש צורך להזין את הקובץ הזה גרף מבלי להוסיף שום מידע על הדף, אז אתה
חייב לבדוק איזה . PS ו .פ בקשות נקראות למעשה. לדוגמה, המאקרו mm
החבילה מוסיפה מספר עמוד, וזה מאוד מעצבן. כרגע, שיחות רגילות גרף
בלי שום חבילת מאקרו עובד. לחלופין, אתה יכול להגדיר בקשות משלך, למשל ל
לעשות כלום:

. של PS
..
. של PE
..

גרף עצמו אינו מספק המרה ישירה לפורמטים אחרים של קבצי גרפיקה. אבל
יש המון אפשרויות אם תהפוך את התמונה שלך לראשונה ל-PostScript®
פורמט באמצעות ה גרף אוֹפְּצִיָה -Tps. מאז psקובץ חסר מידע BoundingBox זה
הוא לא מאוד שימושי בפני עצמו, אבל הוא עשוי להיות מוזן לתוכניות המרה אחרות, בדרך כלל
בשם ps2אַחֵר or pstoאַחֵר או דומה. יתר על כן, מתורגמן PostScript סקריפט רפאים
(gs) יש התקני המרת גרפיקה מובנים שנקראים עם האפשרות

gs -sDEVICE=

שִׂיחָה

gs - עזרה

לקבלת רשימה של המכשירים הזמינים.

חלופה עשויה להיות להשתמש ב- -Tpdf אפשרות להמיר את התמונה שלך ישירות לתוך PDF
פוּרמָט. ניתן לשלוט ב-MediaBox של הקובץ שהופק על ידי העברת א -עמ גודל נייר
לכעוס.

כפורמט קובץ PostScript Encapsulated EPS נהיה יותר ויותר חשוב, וה
המרה לא נחשבה טריוויאלית בעבר, אולי יעניין אותך לדעת זאת שם
הוא כלי המרה בשם ps2eps שעושה את העבודה הנכונה. זה הרבה יותר טוב מה
כלי ps2epsi ארוז עם gs.

עבור פורמטים גרפיים של מפת סיביות, עליך להשתמש pstopnm; המתקבל (בינוני) PNM
לאחר מכן ניתן להמיר את הקובץ כמעט לכל פורמט גרפי באמצעות הכלים של netpbm
חבילה.

השתמש בתמונה באינטרנט באמצעות שירותי onworks.net