תרשימי מפה

בדף הזה מוסבר איך ליצור מפה צבעונית באמצעות Graph API. התרשים הזה הוא גרסה חדשה ומשופרת שתומכת במפה גדולה יותר ובתכונות נוספות בהשוואה לתרשים המפה הישן (cht=t).

תוכן העניינים

סקירה כללית

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

פרמטרים נתמכים

תרשימי מפות תומכים בפרמטרים הבאים:

פרמטר נדרש או אופציונלי תיאור
cht=map<opt_zoom_and_center> חובה

מציין תרשים מפה.

Opt_zoom_and_center - מחרוזת אופציונלית שמאפשרת לשנות את מרחק התצוגה או למרכז את התרשים באזור ספציפי. לפרטים נוספים.

chs חובה גודל המפה. המימדים המקסימליים של מפה הם רוחב של 600 פיקסלים, גובה של 600 פיקסלים או סה"כ 300,000 פיקסלים.
chd=
 <first_country_value>,
 ...,
 <last_country_value>
אופציונלי אם נעשה בו שימוש, ערך הנתונים יציין את הצבע של המדינה התואמת, לאורך ההדרגתיות של הצבעים שצוינה על ידי chco.
chld=
 <country_or_region_codes>|...|
חובה

רשימה מופרדת בקווים אנכיים של מדינות או מדינות, שתודגש בצבעים שמצוינים על ידי chco. המפה תגדל באופן אוטומטי כך שתכלול את כל המדינות שצוינו, אלא אם תתבצע שינוי מרחק התצוגה או מרכוז בהתאמה אישית. הקודים חייבים להיות באותיות גדולות. הקודים האלה הם קודי ISO 3166-1-alpha-2: שתי אותיות רישיות, אופציונליות לאחר מכן מקף ומזהה שני לאזורים או לערים. דוגמאות: GB (בריטניה), GB-LND (לונדון), US-NJ (מדינת ניו ג'רזי בארצות הברית)

chco

  • אם chd לא בשימוש:
    chco=
     <unselected_land_color>|
     <first_region_color>|
       ...|
     <last_region_color>
  • אם chd נעשה שימוש:
    chco=
     <unselected_land_color>,
     <color_range_start>,
       ...,
     <color_range_end>
אופציונלי

צבעי התרשים. הפורמט של המחרוזת הזו תלוי באפשרות שבה משתמשים ב-chd. בשני התחבירים, <unselected_land_color> הוא הצבע של האזורים שלא צוינו ב-chld. חשוב לזכור שהקווים המפרידים שונים בשימוש בתחביר שונה (פסיקים באחד, בקווים ישרים באחר). אם לא משתמשים בהם, האזורים יופיעו בקווים בלבד, אבל לא יהיו בצבעים.

  • chd used - הצבע השני ואילך מתאר טווח צבעים. לכל מדינה בchld צריך להיות ערך אחד של chd, והמדינה המתאימה תסומן לאורך טווח מ-<first_region_color> (הערך המינימלי של טווח הנתונים) עד <last_region_color> (הערך המקסימלי של טווח הנתונים). בטבלה שבהמשך מוצגות דוגמאות.
  • chd not used - הצבע השני ואילך יחול על האזורים התואמים בchld, לפי הסדר הבא. אם יש יותר מדינות מאשר צבעים, הצבע האחרון יוחל על כל המדינות העודפות ברשימה.
chtt, chts אופציונלי שם וסגנון של התרשים
chm אופציונלי סמנים לתרשים
chma אופציונלי השוליים של התרשים
chf=bg... אופציונלי מילויים מלאים (ברקע בלבד)
chdl אופציונלי מקרא לתרשימים

 

דוגמאות

תיאור דוגמה

בדוגמה הזו:

  • cht=map:fixed=-60,0,80,-35 - אזור הזום של התרשים הוא -60 קווי רוחב עד 80 קו רוחב, 0 קווי אורך עד -35 קו אורך
  • chld=CA-BC|CN|IT|GR|US-UT – האזורים הנתמכים הם קולומביה הבריטית, סין, איטליה, גריזה ויוטה.
  • chm – סמני תרשים של הדגלים.
  • chma=0,110,0,0 - הגבול הימני הוגדל ל-110 פיקסלים כדי להתאים למקרא כמו שצריך.
  • chtt=Last+Five+Olympic+Hosts - כותרת התרשים עם + משמש לציון רווחים.

מפה של חמש מדינות מארחות משחקים אולימפיים, עם סמני דגל.
cht=map:fixed=-60,0,80,-35
chs=600x350
chld=CA-BC|CN|IT|GR|US-UT
chdl=Vancouver|Beijing|Torino|Athens|Salt+Lake+City
chco=B3BCC0|5781AE|FF0000|FFC726|885E80|518274
chtt=Last+Five+Olympic+Hosts
chm=f2010+Winter,000000,0,0,10
f2008+Summer,000000,0,1,10
f2008+Winter,000000,0,2,10,1,:-5:10
f2004+Summer,000000,0,3,10
f2004+Summer,000000,0,4,10
chma=0,110,0,0

מפה שמציגה את צרפת, עם שני אזורים מודגשים:

  • chld=FR-D|FR-B|FR - צוינו שלושה אזורים: Bourgogne (במזרח), Aquitaine (בדרום-מערב) וצרפת.
  • chco=676767|FF4444|44FF44|4444FF - לא צוין פרמטר chd במפה הזו, כך שכל ערך צבע שמופיע אחרי הראשון משמש לציון המדינה המתאימה. אדום עבור בורגון, ירוק עבור Aquitaine, כחול לצרפת. ניתן לראות שצבעים מאוחרים יותר לא כוללים מסכה לצבעים מוקדמים יותר.
מפת צרפת, עם הדגשה של שני מחוזות.
chld=FR-D|FR-B|FR
chco=676767|FF4444|44FF44|4444FF

מפה זו מדגימה באמצעות הדרגה של צבעים.

  • chd=t:0,50,100 - הפרמטר chd מציין הדרגה של צבעים. כאן מצוין קידוד הטקסט, שהטווח שלו נע בין 0 ל-100.
  • chco=CCCCCC,FF0000,000000 - צבע הרקע הוא אפור בהיר (CCCCCC) וטווח הצבעים הוא מאדום (FF0000) לשחור (000000). המדינה האמצעית שמוצגת היא צבע ביניים בהדרגתיות הזו.
מפה שמציגה הדרגה של צבעים.
chd=t:0,50,100
chco=CCCCCC,FF0000,000000
חשוב לזכור שאפשר לחתוך את המפה בתוך הגודל שצוין בתרשים. הסיבה לכך היא שלא נעוות את המפה כך שתתאים לגודל התרשים שצוין, אבל אנחנו מגבילים את המפה לאזורים שציינת ב-chld. לכן, כדי למנוע חיתוך של אזורים שנמצאים בתוך גבולות התרשים, ייתכן שיהיה צורך להתאים את גודל המפה באופן ידני.
מפה מרובעת של מדינה ארוכה

cht=map
chs=300x300
chld=GB

באופן טבעי, אנגליה ארוכה וצרה, לכן ציון של מפה מרובעת כולל אזור חתוך בצד ימין:

מפה מרובעת של מדינה ארוכה

cht=map
chs=180x300
chld=GB

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

מפה מרובעת של מדינה ארוכה

cht=map
chs=180x300
chld=GB

צורתה של צרפת הרבה יותר סדירה, ולכן היא משתלבת בטבעיות יותר במפה ריבועית.

חזרה למעלה

שינוי מרחק התצוגה ומרכוז

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

לפי פיקסל

כדי להתאים את הגבולות לפי גודל הפיקסל, יש להשתמש בפורמט הבא:

cht=map:auto=<left_border>,<right_border>,<top_border>,<bottom_border>

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

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

לדוגמה:

כולן מציגות את לונדון (Lat

ללא שינוי מרחק התצוגה (ברירת מחדל) הקטנת התצוגה 30 פיקסלים בכל צד הקטנת התצוגה מימין

עוד מפה ריקה בחלק התחתון.
cht=map

מפה מיותרת למטה.
cht=map:auto=30,30,30,30
שינוי הפריים של אזור הזום.
cht=map:auto=50,0,80,0

 

לפי קו רוחב וקו אורך

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

cht=map:fixed=<bottom_border_lat>,<left_border_long>,<top_border_lat>,<right_border_long>

כאשר <bottom_border_lat> ו-<top_border_lat> מציינים את קו הרוחב של הגבולות התחתון והגבול העליון, ו-<left_border_long> ו-<right_border_long> מציינים את קו האורך של הגבולות השמאליים והימניים.

הערה: בגלל עיוות ההיטל של Mercator (למעשה, הצגת מפה מעוקלת על תמונה שטוחה), התמקדות ברצועה צרה וגבוהה עלולה לגרום להבדלים לא צפויים בגודל המפה.

לדוגמה:

בדוגמאות הבאות אפשר לראות את לונדון (מודגש בכחול) – קו אורך של 0.1°, קו רוחב של 51.5°. שימו לב שיש חיתוך של המפה כי מתבצע ניסיון להציג במפה רק את בריטניה (כפי שצוין) ולמלא את התרשים הייעודי ללא עיוות.

מרוכזת קווי הרוחב הוזזו +10* שינוי מרחק התצוגה על ידי הקטנת כל הערכים

cht=map:fixed=40,-10,60,10


cht=map:fixed=50,-10,70,10


cht=map:fixed=48,-3,54,3

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

חזרה למעלה

תכונות רגילות

שאר התכונות בדף הזה הן תכונות רגילות של תרשים.

כותרת התרשים chtt, chts [כל התרשימים]

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

תחביר

chtt=<chart_title>
chts=<color>,<font_size>,<opt_alignment>

 

chtt – מציין את כותרת התרשים.

<chart_title>
כותרת להצגה לתרשים. לא ניתן לציין איפה יופיע השם, אבל אפשר לציין את גודל הגופן והצבע. כדי לציין רווחים, צריך להשתמש בסימן + ובקו ניצב ( | ) כדי לציין מעברי שורה.

 

chts [אופציונלי] – צבעים וגודל גופן לפרמטר chtt.

<color>
צבע הכותרת, בפורמט הקסדצימלי של RRGGBB. צבע ברירת המחדל הוא שחור.
<font_size>
גודל הגופן של הכותרת, בנקודות.
<opt_alignment>
[אופציונלי] יישור הכותרת. בוחרים אחד מערכי המחרוזת הבאים תלויי אותיות רישיות: "l" (שמאל), "c" (במרכז) "r" (ימין). ברירת המחדל היא "c".

 

דוגמאות

תיאור דוגמה

תרשים עם כותרת, עם צבע וגודל גופן שמוגדרים כברירת מחדל.

צריך לציין רווח עם סימן חיבור (+).

כדי לאלץ מעבר שורה, צריך להשתמש בתו קו אנכי (|).

chts לא צוין כאן.

תרשים עמודות אנכי עם כותרת
chtt=Site+visitors+by+month|
January+to+July

תרשים עם כותרת כחולה ביישור לימין של 20 נקודות.

תרשים עמודות אנכי עם כחול, 20 פיקסלים, כותרת
chtt=Site+visitors
chts=FF0000,20,r

חזרה למעלה

שולי התרשים chma [כל התרשימים]

אפשר לציין את גודל השוליים של התרשים, בפיקסלים. השוליים מחושבים פנימה מהגודל שצוין בתרשים (chs). הגדלה של השוליים לא מגדילה את הגודל הכולל של התרשים, אלא רק מכווצת את שטח התרשים, במקרה הצורך.

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

שולי התרשים, אזור המקרא ואזור התרשים

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

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

 

תחביר

chma=
  <left_margin>,<right_margin>,<top_margin>,<bottom_margin>|<opt_legend_width>,<opt_legend_height>
<left_margin>, <left_margin>, <left_margin>, <left_margin>
גודל השוליים המינימלי מסביב לאזור התרשים, בפיקסלים. יש להגדיל את הערך כדי להוסיף מרווח פנימי מסוים כדי למנוע חפיפה בין תוויות הצירים לבין גבולות התרשים.
<opt_legend_width>, <opt_legend_height>
[אופציונלי] רוחב השוליים סביב המקרא, בפיקסלים. ניתן להשתמש באפשרות הזו כדי שהמקרא לא יקפוץ באזור התרשים או בקצוות התמונה.

 

דוגמאות

תיאור דוגמה

בדוגמה הזו, בתרשים יש שוליים מינימליים של 30 פיקסלים בכל צד. המקרא של התרשים הוא ברוחב של יותר מ-30 פיקסלים, ולכן השוליים שבצד שמאל מוגדרים לרוחב של מקרא התרשים, והם שונים מהשוליים האחרים.

תוויות הצירים נמצאות מחוץ לאזור התרשים, ולכן הן משורטטות בתוך שטח השוליים.

תרשים קו עם רקע אפור ושוליים בכל צד.
chma=30,30,30,30

כדי להוסיף שוליים סביב המקרא, מגדירים ערך לפרמטרים <opt_legend_width> ו-<opt_legend_height>.

בדוגמה הזו, המקרא הוא ברוחב של כ-60 פיקסלים. אם תגדירו את <opt_legend_width> ל-80 פיקסלים, השוליים יורחבו ל-20 פיקסלים מחוץ למקרא.

תרשים קו עם רקע אפור ושוליים בכל צד.
chma=20,20,20,30|80,20

חזרה למעלה

מילוי ברקע chf [כל התרשימים]

אפשר לציין צבעים וסגנונות מילוי לאזור הנתונים של התרשים ו/או לכל הרקע של התרשים. סוגי המילוי כוללים מילויים מלאים, מילויים מפוספסים והדרגה. אפשר לציין מילויים שונים לאזורים שונים (לדוגמה, לכל אזור התרשים או רק לאזור הנתונים). מילוי השטח של התרשים יחליף את המילוי ברקע. כל המילויים מצוינים באמצעות הפרמטר chf, וניתן לשלב סוגי מילוי שונים (מלאים, פסים, צבעים הדרגתיים) באותו תרשים, על ידי הפרדה בין ערכים באמצעות קו אנכי ( | ). מילוי אזור התרשים מחליף את מילויי הרקע של התרשים.

מילוי מלא chf [כל התרשימים]

אפשר לציין מילוי מלא לרקע ו/או לאזור התרשים, או להקצות ערך שקיפות לכל התרשים. אפשר לציין מספר מילויים באמצעות התו בצינורות (|). (מפות: רקע בלבד).

תחביר

chf=<fill_type>,s,<color>|...
<fill_type>
החלק בתרשים שממלא. אפשר לציין את אחד מהערכים הבאים:
  • bg - מילוי רקע
  • c – מילוי אזור התרשים. האפשרות הזו לא נתמכת בתרשימי מפה.
  • a - הגדרת כל התרשים (כולל רקעים) שקופים. המערכת מתעלמת משש הספרות הראשונות של <color>, ורק שתי הספרות האחרונות (ערך השקיפות) חלות על התרשים כולו ועל כל המילוי.
  • b<index> - מילויים מלאים בעמודות (בתרשימי עמודות בלבד). מחליפים את <index> באינדקס הסדרה של העמודות שיתמלאו בצבע אחיד. האפקט דומה לציון הערך chco בתרשים עמודות. מידע נוסף מופיע בקטע צבעי סדרת העמודות.
שנ'
מציין מילוי מלא או שקיפות.
<color>
צבע המילוי, בפורמט הקסדצימלי של RRGGBB. במקרה של שקפים, המערכת מתעלמת משש הספרות הראשונות, אבל בכל זאת צריך לכלול אותן.

 

דוגמאות

תיאור דוגמה

הדוגמה הזו ממלאת את רקע התרשים בצבע אפור בהיר (EFEFEF).

תרשים קו אדום עם מילוי שטח שחור.

chf=bg,s,EFEFEF

הדוגמה הזו ממלאת את רקע התרשים בצבע אפור בהיר (EFEFEF) וממלאת את אזור התרשים בשחור (000000).

תרשים קו אדום עם שטח תרשים שחור ורקע אפור בהיר.

chf=c,s,000000|
bg,s,EFEFEF

בדוגמה הזו ניתן להחיל שקיפות של 50% על כל התרשים (80 בהקסדצימליים הם 128, או כ-50% שקיפות). שמים לב לרקע של התא בטבלה שמוצג דרך התרשים.

תרשים פיזור עם נקודות בכחול, ושקיפות של 50%.

chf=a,s,00000080

חזרה למעלה

טקסט וסגנון של מקרא התרשים chdl, chdlp, chdls [כל התרשימים]

המקרא הוא קטע צדדי בתרשים, שמספק תיאור קצר של כל סדרה. אפשר לציין את הטקסט שמשויך לכל סדרה במקרא הזה ולציין איפה הוא יופיע בתרשים.

למידע נוסף על הגדרת השוליים סביב המקרא, אפשר לעיין גם בchma.

הערה לגבי ערכי מחרוזת: מותר להשתמש רק בתווים שמתאימים לכתובת URL במחרוזות תוויות. מטעמי אבטחה, יש לקודד כתובות URL של מחרוזות שמכילות תווים שלא נכללים בקבוצת התווים 0-9a-zA-Z. אפשר למצוא מקודד של כתובות URL במסמכי התיעוד של Google החזותית.

תחביר

chdl=<data_series_1_label>|...|<data_series_n_label>
chdlp=<opt_position>|<opt_label_order>
chdls=<color>,<size>

 

chdl – הטקסט של כל סדרה, שיוצג במקרא.

<data_series_label>
הטקסט של הפריטים מהמקרא. כל תווית חלה על הסדרה המתאימה במערך chd. הוספת סימן חיבור (+) למרחב משותף. אם לא מציינים את הפרמטר הזה, התרשים לא יקבל מקרא. אין אפשרות לציין מעבר שורה בתווית. המקרא בדרך כלל יורחב כדי להציג את הטקסט של המקרא, ואזור התרשים יצטמצם כדי להתאים למקרא.

chdlp – [אופציונלי] המיקום של המקרא והסדר של שמות הפריטים במקרא. אפשר לציין <position> ו/או <label_order>. אם מציינים את שניהם, צריך להפריד ביניהם באמצעות תו בר. אפשר להוסיף 's' לכל ערך אם רוצים לדלג על רשומות ריקות במקרא chdl במקרא. דוגמאות: chdlp=bv, chdlp=r, chdlp=bv|r, chdlp=bvs|r

<opt_position>
[אופציונלי] מציין את המיקום של המקרא בתרשים. כדי להוסיף מרווח פנימי נוסף בין המקרא לאזור התרשים או לגבולות התמונה, אפשר להשתמש בפרמטר chma. בוחרים אחד מהערכים הבאים:
  • b - מקרא בתחתית התרשים, רשומות מקרא בשורה אופקית.
  • bv - מקרא בתחתית התרשים, רשומות מקרא בעמודה אנכית.
  • t - מקרא בראש התרשים, רשומות מקרא בשורה אופקית.
  • tv - מקרא בראש התרשים, ערכים מהמקרא בעמודה אנכית.
  • r - [ברירת מחדל] מקרא מימין לתרשים, הערכים של המקרא בעמודה אנכית.
  • l - מקרא משמאל לתרשים, ערכים מהמקרא בעמודה אנכית.
<opt_label_order>
[אופציונלי] הסדר שבו התוויות מוצגות במקרא. בוחרים אחד מהערכים הבאים:
  • l - [ברירת המחדל של מקרא אנכי] הצגת התוויות לפי הסדר שנקבע ל-chdl.
  • r - הצגת התוויות בסדר ההפוך כפי שניתן ל-chdl. האפשרות הזו שימושית בתרשימי עמודות אופקיים מוערם כדי להציג את המקרא
    באותו סדר שבו מופיעות העמודות.
  • a - [ברירת המחדל של מקרא אופקי] סידור אוטומטי: כלומר, מיון לפי אורך, הקצר ביותר תחילה, כפי שנמדד בבלוקים של 10 פיקסלים. כששני רכיבים הם באורך זהה (חלוקה ל-10 בלוקים של פיקסלים), הרכיב הראשון שמופיע ראשון מופיע ראשון.
  • 0,1,2... - סדר של תוויות מותאמות אישית. זוהי רשימה של אינדקסים מבוססי-אפס של תוויות מ-chdl, מופרדים בפסיקים.

chdls – [אופציונלי] קביעת הצבע וגודל הגופן של הטקסט במקרא.

<color>
צבע הטקסט במקרא, בפורמט הקסדצימלי של RRGGBB.
<size>
גודל הנקודות בטקסט המקרא.

 

דוגמאות

תיאור דוגמה

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

תרשים קו אדום, כחול וירוק עם מקרא

chdl=NASDAQ|FTSE100|DOW
chco=FF0000,00FF00,0000FF

תרשים ון עם שני עיגולים קטנים יותר המוקפים במעגל גדול יותר


chdl=First|Second|Third
chco=ff0000,00ff00,0000ff

בתרשים הראשון מוצגים פריטים מהמקרא האופקי (chdlp=t, פריסת ברירת המחדל היא אופקית), והתרשים השני כולל רשומות מקרא אנכיות תחתונות (chdlp=bv).

תרשים ון עם שני עיגולים קטנים יותר המוקפים במעגל גדול יותר
chdl=First|Second|Third
chco=ff0000,00ff00,0000ff
chdlp=t


תרשים ון עם שני עיגולים קטנים יותר המוקפים במעגל גדול יותר
chdl=First|Second|Third
chco=ff0000,00ff00,0000ff
chdlp=bv

בדוגמה הזו אפשר לראות את שינוי גודל הגופן.

תרשים ון עם שני עיגולים קטנים יותר המוקפים במעגל גדול יותר
chdls=0000CC,14

חזרה למעלה

סמני צורות chm [סרגל, קו, מכ"ם, פיזור]

אפשר לציין סמנים גרפיים לכל הנקודות או לנתונים בודדים בתרשים. אם שני סמנים או יותר נמצאים באותה נקודה, הסמנים משורטטים לפי הסדר שבו הם מופיעים בפרמטר chm. אפשר גם ליצור סמני טקסט בנקודות על הגרף. המידע הזה זמין במאמר סמנים של נקודות נתונים.

אפשר לשלב סמני צורות עם פרמטרים אחרים של chm באמצעות תו קו אנכי ( | ) כדי להפריד בין הפרמטרים של chm.

תחביר

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

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

chm=
  [@]<marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_offset>
    |...|
  [@]<marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_offset>
@
[אופציונלי] אם לפני סוג הסמן מופיע תו @ אופציונלי, צריך להשתמש בפורמט x:y עבור <opt_what_points>.
<mark_type>
סוג הסמן שבו יש להשתמש. מציינים את אחד מהסוגים הבאים:
  • a – חץ
  • c – צלב
  • C – מלבן. אם סמן מלבן, צריך שיהיו לך לפחות שתי סדרות נתונים, כאשר סדרה 0 מציינת את הקצה התחתון וסדרה 1 מציינת את הקצה העליון. <size> מציין את רוחב המלבן, בפיקסלים.
  • d – יהלום
  • E - סמן סרגל שגיאה ( ) כדי ליצור סמן זה, נדרשות שתי סדרות נתונים, ערך אחד לתחתית והנקודה המתאימה בסדרה השנייה בחלק העליון. הוא גם חושף תחביר מורחב של <size>: line_thickness[:top_and_bottom_width], כאשר top_and_bottom_width הוא אופציונלי. ראו דוגמאות בהמשך.
  • h - קו אופקי לרוחב התרשים בגובה שצוין. (הפורמט החוקי היחיד לפרמטר <opt_which_points> הוא opt_which_points.)
  • H - קו אופקי דרך סמן הנתונים שצוין. יש תמיכה בתחביר <size> מורחב שמאפשר לציין אורך שורה מדויק: line_thickness[:length]. התו :length הוא אופציונלי, וברירת המחדל היא רוחב השטח המלא של התרשים.
  • o - מעגל
  • s - ריבוע
  • v - קו אנכי מציר ה-X לנקודת הנתונים
  • V - קו אנכי באורך שניתן להתאמה. יש תמיכה בתחביר מורחב של ערכים מסוג <size> שמאפשר לציין אורך שורה מדויק: line_thickness[:length]. התו :length הוא אופציונלי, וברירת המחדל היא גובה השטח המלא של התרשים. הסמן ממורכז בנקודת הנתונים.
  • x – X
<color>
צבע הסמנים לסדרה הזו, בפורמט הקסדצימלי של RRGGBB.
<series_index>
האינדקס מבוסס האפס של סדרת הנתונים שעליו משרטטים את הסמנים. המערכת תתעלם מסמנים וסמנים של h שמציינים מיקום לפי מיקום x/y (מתחילים בתו @). ניתן להשתמש בסדרות נתונים מוסתרות כמקור לסמנים. מידע נוסף זמין בתרשימים מורכבים. תרשימי עמודות אנכיים מקובצים תומכים בתחביר מורחב מיוחד לצורך יישור סמנים לעמודות מסוימות.
<opt_which_points>
[אופציונלי] על אילו נקודות לשרטט סמנים. ברירת המחדל היא כל הסמנים. צריך להשתמש באחד מהערכים הבאים:
  • n.d – איפה לשרטט את הסמן. המשמעות תלויה בסוג הסמן:
    • כל הסוגים מלבד h - על אילו נתונים מצביעים על הסמן, כאשר n.d הוא האינדקס המבוסס על אפס בסדרה. אם מציינים ערך שאינו מספר שלם, השבר מציין נקודת ביניים מחושבת. לדוגמה, 3.5 הוא חצי הדרך בין נקודה 3 לנקודה 4.
    • h - מספר בין 0.0 ל-1.0, כאשר 0.0 הוא החלק התחתון של התרשים ו-1.0 הוא החלק העליון של התרשים.
  • -1 - שרטט סמן בכל נקודות הנתונים. אפשר גם להשאיר את הפרמטר הזה ריק כדי לשרטט על כל נקודות הנתונים.
  • -n - שרטט סמן בכל נקודת נתונים n. ערך של נקודה צפה (floating-point). אם n קטן מ-1, התרשים יחשב עבורך נקודות ביניים נוספות . לדוגמה, הוספה של -0.5 תציב מספר כפול של סמנים מנקודות נתונים.
  • start:end:n - שרטט סמן על כל נקודת נתונים n בטווח, מערכי האינדקס התחלה עד סיום, כולל. כל הפרמטרים הם אופציונליים (ייתכן שחסר אותם), לכן 3::1 יופיע מהאלמנט הרביעי עד האחרון, שלב 1, ואם משמיטים את הפרמטר הזה לחלוטין, ברירת המחדל תהיה first:last:1. כל הערכים יכולים להיות מספרים של נקודות צפות. start ו-end יכולים להיות שליליים, על מנת לספור לאחור מהערך האחרון. אם גם start וגם end שליליים, כדאי לוודא שהם רשומים בערך עולה (לדוגמה, -6:-1:1). אם הערך של השלב n קטן מ-1, המערכת תחשב נקודות נתונים נוספות באמצעות אינטרפולציה של ערכי הנתונים הנתונים. ערכי ברירת המחדל הם first:last:1
  • x:y - שרטט סמן בנקודת x/y ספציפית בתרשים. הנקודה הזו לא חייבת להיות על קו. כדי להשתמש באפשרות הזו, צריך להוסיף את התו @ לפני סוג הסמן. אפשר לציין את הקואורדינטות כערכי נקודה צפה (floating-point). הערך 0:0 הוא הפינה הימנית התחתונה של התרשים ו-1:1 הוא הפינה השמאלית העליונה של התרשים. לדוגמה, כדי להוסיף יהלום אדום בגודל 15 פיקסלים למרכז תרשים, אפשר להשתמש בפונקציה @d,FF0000,0,0.5:0.5,15.
<size>
גודל הסמן, בפיקסלים. ברוב המקרים, הסמנים V , H ו-S תומכים בתחביר <size>[:width], כאשר החלק השני האופציונלי מציין את אורך הקו או הסמן.
<opt_z_order>
[אופציונלי] השכבה שבה יש לצייר את הסמן, בהשוואה לסמנים אחרים ולכל שאר האלמנטים בתרשים. זהו מספר נקודה צפה (floating-point) מ-1.0- עד 1.0, כולל, כאשר -1.0 הוא החלק התחתון ו-1.0 הוא החלק העליון. רכיבי תרשים (קווים ועמודות) נמוכים מאפס. אם לשני סמנים יש ערך זהה, הם ישורטטו לפי הסדר שנקבע על ידי כתובת ה-URL. ערך ברירת המחדל הוא 0.0 (מעל רכיבי התרשים).
<opt_offset>
[אופציונלי] הגדרת היסט אופקי ואנכי מהמיקום שצוין. הנה התחביר, שמשתמש במפריד : reserved:<horizontal_offset>:<vertical_offset>. אם מציינים את הפרמטר הזה, אפשר לכלול ערך ריק במחרוזת הפרמטר chm עבור <opt_z_order>. דוגמאות: o,FF9900,0,4,12,,:10 o,FF9900,0,4,12.0,,:-10:20 o,FF9900,0,4,12,1,::20
  • reserve - משאירים ריק.
  • <horizontal_offset> - מספר חיובי או שלילי לציון ההיסט האופקי, בפיקסלים. אופציונלי; אם לא נעשה שימוש, יש להשאיר ריק.
  • <vertical_offset> - מספר חיובי או שלילי לציון ההיסט האנכי, בפיקסלים. אופציונלי; אם לא נעשה שימוש, יש להשאיר ריק.

 

דוגמאות

תיאור דוגמה

כאן מוצגת דוגמה של כמה מסמני צורה וקווים.

  • a,990066,0,0.0,9.0 - חץ סגול, סדרה ראשונה, נקודה ראשונה, גודל 9.
  • c,FF0000,0,1.0,20.0 - צלב אדום, סדרה ראשונה, נקודה שנייה, גודל 9.
  • d,80C65A,0,2,20.0 – יהלום ירוק, סדרה ראשונה, נקודה שלישית, גודל 9.
  • H,000000,0,3,1:40 - קו אופקי שחור, סדרה ראשונה, נקודת נתונים 3, רוחב של פיקסל אחד, אורך ארבעים פיקסלים.
  • o,FF9900,0,4.0,12.0 - עיגול כתום, סדרה ראשונה, נקודה חמישית, גודל 12.
  • s,3399CC,0,5.0,11.0 - ריבוע כחול, סדרה ראשונה, נקודה שישית, גודל 11.
  • v,BBCCED,0,6.0,1.0 - קו אנכי עד לנקודה, סדרה ראשונה, נקודה שביעית, ברוחב פיקסל אחד.
  • V,3399CC,0,7.0,1.0 - קו אנכי מלמטה למעלה בתרשים, סדרה ראשונה, נקודה שמינית, ברוחב פיקסל אחד.
  • x,FFCC33,0,8.0,20.0 - 'X' צהוב, סדרה ראשונה, נקודה תשיעית, מידה 20.
  • H,FFFF00,0,9,2 - קו צהוב אופקי של רוחב התרשים בנקודת נתונים 9.
  • h,FF0000,0,0.5,1 - קו אופקי אדום בגובה שהוגדר, סדרה ראשונה, באמצע התרשים, ברוחב פיקסל אחד.
תרשים קו עם סמנים
chm=
  a,990066,0,0.0,9.0|
  c,FF0000,0,1.0,20|
  d,80C65A,0,2.0,20.0|
  H,000000,0,3,1:40|
  o,FF9900,0,4.0,12.0|
  s,3399CC,0,5.0,11.0|
  v,BBCCED,0,6,1.0|
  V,3399CC,0,7,1.0|
  x,FFCC33,0,8,20|
  H,FFFF00,0,9,2|
  h,FF0000,0,0.5,1

בהמשך מוצגת דוגמה לשימוש ברמת יהלומים בסדרת נתונים אחת ובמעגלים אחרים בסדרת נתונים אחרת.

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

תרשים קו. בקו אחד יש עיגולים של 15 פיקסלים בכל נקודה על הגרף, ובקו השני יש 10 יהלומים. יהלום מצויר בנקודה המשותפת לשני הקווים
chm=
  o,FF9900,0,-1,15.0|
  d,FF0000,1,-1,10.0

הנה תרשים קו עם סמן על כל נקודת נתונים שנייה (-2 פירושו כל נקודה אחרת).

תרשים קו עם סמן בכל נקודה שנייה
chd=t:
  0,20,20,50,40,70,70,90,85,45,40,50
chm=
  o,0066FF,0,-2,6
לפניכם תרשים קו שמכיל מספר כפול של סמנים מנקודות נתונים ( -0.5 פירושו כל חצי נקודה). תרשים קו עם סמן בכל נקודה שנייה
chd=t:
  0,20,20,50,40,70,70,90,85,45,40,50
chm=
  o,0066FF,0,-.5,6
הדוגמה הזו מראה איך להשתמש בסמנים h ו-v כדי ליצור קווי רשת עם עובי וצבעים בהתאמה אישית. הערך של סדר ה-z (הערך האחרון) מוגדר ל-1-, כך שקווי הרשת ישורטטו מתחת לקו הנתונים.
תרשים קו עם סמן בכל נקודה שנייה
chm=
  h,76A4FB,0,0:1:.2,2,-1|
  V,76A4FB,0,::2,0.5,-1

בתרשים הזה מתווספים קווי מילוי אנכיים לתרשים קו:

  • v – קווים אנכיים לתרשים
  • FF0000 – קווים אדומים
  • 0 – אינדקס של סדרה
  • : :.5 - מציין הטווח: מההתחלה ועד הסוף, כל 0.5 נקודות.
  • 2 – עובי 2 פיקסלים.
תרשים קו עם סמן בכל נקודה שנייה
chm=
  v,FF0000,0,::.5,2
בדוגמה הזו מתווסף חץ וסמני טקסט לתרשים באמצעות קואורדינטות מדויקות. סמן D הראשון הוא קו המעקב שמתחת לעמודות. הסמן השני הוא החץ והסמן השלישי הוא טקסט החץ.
chm=
  D,003971,1,0,3|
  @a,000000,0,.25:.75,7|
  @tExpected,000000,0,.35:.85,10
קו אופקי הקבוע לנקודה ספציפית על הגרף (H) יכול לעזור לך להציג ערכים יחסיים, או להדגיש את הגובה של ערך נתונים בתרשים.
chm=H,FF0000,0,18,1

התרשים הזה מדגים את הסמנים שיכולים לציין את עובי והאורך של קו בפרמטר <size>.

  • E,000000,0,6,1:20 - סרגל שגיאה שחור עם קווים רחבים של פיקסל אחד, עמודות עליונות ותחתונות באורך 20 פיקסלים. החלק התחתון מעוגן לסדרה 0 נקודות 8, החלק העליון מעוגן לסדרה 1 נקודה 8.
  • H,990066,1,2,5:50 - סגול, קו אופקי ברוחב 5 פיקסלים, באורך 50 פיקסלים באורך 5 פיקסלים במרכז מעל נקודה 2.
  • V,3399CC,0,8,3:50- קו כחול אנכי ברוחב 3 פיקסלים, באורך 50 פיקסלים, במרכז נקודת הנתונים 8.
title="cht=lc&chd=s:2gounjqLaCf,jqLaCf2goun&chco=008000,00008033&chls=2.0,4.0,1.0&chs=250x150&chm=H,990066,1,2,5:50
chm=
  E,000000,0,6,1:20|
  H,990066,1,2,5:50|
  V,3399CC,0,8,3:50

חזרה למעלה

סמנים של ערכי טקסט ונתונים chm [סרגל, קו, מכ"ם, פיזור]

אפשר להוסיף תוויות לנקודות ספציפיות בתרשים באמצעות טקסט בהתאמה אישית או באמצעות גרסאות מעוצבות של הנתונים.

אפשר לשלב כל סמני chm באמצעות תו קו אנכי ( | ) כדי להפריד בין קבוצות הפרמטרים של chm.

הערה לגבי ערכי מחרוזת: מותר להשתמש רק בתווים שמתאימים לכתובת URL במחרוזות תוויות. מטעמי אבטחה, יש לקודד כתובות URL של מחרוזות שמכילות תווים שלא נכללים בקבוצת התווים 0-9a-zA-Z. אפשר למצוא מקודד של כתובות URL במסמכי התיעוד של Google החזותית.

תחביר

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

chm=
  <marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_placement>
    |...|
  <marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_placement>
<mark_type>
סוג הסמן שבו יש להשתמש. אפשר לבחור מבין הסוגים הבאים:
  • f<text> – דגל שמכיל טקסט. צריך לציין את התו 'f' ואחריו טקסט בהתאמה אישית עם קידוד כתובת URL. כדי לסמן בתו בריחה (escape) פסיקים בסמני טקסט, צריך להוסיף את הסימן \ לפני הפסיק. דוגמה: fHello\,+World!
  • t<text> - סמן טקסט פשוט. צריך לציין את התו 't' ואחריו טקסט מקודד בהתאמה אישית. כדי לסמן בתו בריחה (escape) פסיקים בסמני טקסט, צריך להוסיף את הסימן \ לפני הפסיק. דוגמה: tHello\,+World!
  • A<text> – סמן הערות. פעולה זו דומה לסמן דגל, אבל סמנים יתאמו את המיקום שלהם כך שלא תהיה חפיפה. הפורמט החוקי היחיד עבור <opt_which_points> הוא opt_which_points, לציון האינדקס של נקודה בסדרה.
  • N<formatting_string> - ערך הנתונים בשלב זה, עם עיצוב אופציונלי. אם לא משתמשים בפרמטר chds (התאמה אישית), הוא מספק את הערך המקודד המדויק. אם משתמשים בפרמטר הזה בכל סוג פורמט, הערך יותאם לטווח שתציינו. הנה דוגמה של chds עם סמנים מספריים. כשמציינים את סוג הסמן הזה בתרשים עמודות מוערם, אם מציינים -1 עבור <series_index>, נוצר סמן שמציג את סכום כל הערכים בעמודה המוערמת הזו. זהו התחביר של מחרוזת העיצוב:
           <preceding_text>*<number_type><decimal_places>zs<x or y>*<following_text>.
    כל הרכיבים האלה הם אופציונליים. הסברים על המשמעות של כל רכיב:
    • <preceding_text> - הטקסט שמופיע לפני כל ערך.
    • *...* - בלוק אופציונלי שמוקף בכוכביות ליטרליות, שבו אפשר לציין פרטי עיצוב של מספרים. הערכים הבאים נתמכים, וכולם אופציונליים:
      • <number_type> - פורמט המספרים, לערכים מספריים. בוחרים אחת מהאפשרויות הבאות:
        • f - [ברירת מחדל] פורמט של נקודות צפות. כדאי לציין דיוק גם באמצעות הערך <decimal_places>.
        • p – פורמט באחוזים. סימן % מצורף באופן אוטומטי. הערה: כשמשתמשים בפורמט הזה, ערכי נתונים בין 0.0 ל-1.0 ממופים ל-0 עד 100% (לדוגמה, 0.43 יוצגו כ-43%).
        • e - פורמט סימון מדעי.
        • c<CUR> - פורמט המספר במטבע שצוין, עם סמן המטבע המתאים. מחליפים את הערך <CUR> בקוד מטבע בן שלוש אותיות. דוגמה: cEUR עבור אירו. אפשר למצוא רשימת קודים באתר האינטרנט של ISO, אם כי לא כל הסמלים נתמכים.
      • <decimal_places> - מספר שלם שמציין כמה ספרות אחרי הנקודה העשרונית. הערך מעוגל (לא נחתך) לאורך הזה. ברירת המחדל היא 2.
      • z - הצגת אפסים בסוף. ברירת המחדל היא לא.
      • s - הצגה של מפרידי קבוצות. ברירת המחדל היא לא.
      • x או y -הצגת הנתונים מקואורדינטת ה-x או ה-Y, כפי שצוין. המשמעות של נתוני x משתנה לפי סוג התרשים: כדאי להתנסות בתרשים כדי להבין מה המשמעות שלו. ברירת המחדל היא 'y'.
    • <following_text> - הטקסט שיופיע אחרי כל ערך.
<color>
צבע הסמנים עבור הקבוצה הזו, בפורמט הקסדצימלי של RRGGBB.
<series_index>
האינדקס מבוסס האפס של סדרת הנתונים שעליו משרטטים את הסמנים. אם מדובר בתרשים עמודות מוערם וסוג הסמן הוא N (ערכי נקודות על הגרף), אפשר לציין -1 כדי ליצור סמן ערכים מסכם לכל ערימת עמודות. אפשר לראות דוגמה בהמשך.
<opt_which_points>
[אופציונלי] על אילו נקודות לשרטט סמנים. ברירת המחדל היא כל הסמנים. צריך להשתמש באחד מהערכים הבאים:
  • n.d – נקודת הגרף שעליה משרטטים את הסמן, כאשר n.d הוא האינדקס המבוסס על אפס בסדרה. אם מציינים ערך שאינו מספר שלם, השבר מציין נקודת ביניים מחושבת. לדוגמה, 3.5 הוא חצי הדרך בין נקודה 3 לנקודה 4.
  • -1 - שרטט סמן בכל נקודות הנתונים. אפשר גם להשאיר את הפרמטר הזה ריק כדי לשרטט על כל נקודות הנתונים.
  • -n - שרטט סמן בכל נקודת נתונים n.
  • start:end:n - שרטט סמן על כל נקודת נתונים n בטווח, מערכי האינדקס התחלה עד סיום, כולל. כל הפרמטרים הם אופציונליים (ייתכן שחסר אותם), לכן 3::1 יופיע מהרכיב הרביעי עד האחרון, שלב 1, ואם משמיטים את הפרמטר הזה לחלוטין, ברירת המחדל תהיה first:last:1. כל הערכים יכולים להיות מספרים של נקודות צפות. start ו-end יכולים להיות שליליים, על מנת לספור לאחור מהערך האחרון. אם גם start וגם end הערכים שליליים, כדאי לוודא שהם רשומים בערך עולה (לדוגמה, -6:-1:1). אם ערך השלב n קטן מ-1, הוא יחשב נקודות נתונים נוספות באמצעות אינטרפולציה של ערכי הנתונים הנתונים. ערכי ברירת המחדל הם first:last:1
  • x:y - [התכונה לא נתמכת לסמנים מסוג N] משרטטים סמן בנקודת x/y ספציפית בתרשים. הנקודה הזו לא חייבת להיות על קו. כדי להשתמש באפשרות הזו, צריך להוסיף את התו (@) לפני סוג הסמן. אפשר לציין את הקואורדינטות כערכי נקודות צפה (floating-point). הערך 0:0 הוא הפינה הימנית התחתונה של התרשים, 0.5:0.5 הוא מרכז התרשים ו-1:1 הוא הפינה הימנית העליונה של התרשים. לדוגמה, כדי להוסיף יהלום אדום בגודל 15 פיקסלים למרכז תרשים, אפשר להשתמש בפונקציה @d,FF0000,0,0.5:0.5,15.
<size>
גודל הסמן בפיקסלים. אם מדובר בתרשים פיזור עם סדרת נתונים שלישית (משמשת לציון גודל הנקודות), הערך הזה יותאם לפי טווח הנתונים. לכן, אם טווח הנתונים הוא 0-100 ו-<size> הוא 30, ערך נתונים של 100 יהיה ברוחב של 30 פיקסלים, ערך נתונים של 50 יהיה ברוחב 15 פיקסלים וכן הלאה.
<opt_z_order>
[אופציונלי] השכבה שבה יש לצייר את הסמן, בהשוואה לסמנים אחרים ולכל שאר האלמנטים בתרשים. זהו מספר נקודה צפה (floating-point) מ-1.0- עד 1.0, כולל, כאשר -1.0 הוא החלק התחתון ו-1.0 הוא החלק העליון. רכיבי תרשים (קווים ועמודות) נמוכים מאפס. אם לשני סמנים יש ערך זהה, הם ישורטטו לפי הסדר שנקבע על ידי כתובת ה-URL. ערך ברירת המחדל הוא 0.0 (מעל רכיבי התרשים).
<opt_placement>
[אופציונלי] פרטים נוספים על מיקום הסמן ביחס לנקודה על הגרף. אפשר לציין מיקום יחסי אופקי ו/או אנכי, וכן קיזוזים. תחביר המיקום הוא מחרוזת עם תווי הפרדה: , כפי שמוצג כאן. כל הרכיבים הם אופציונליים: <horizontal_and_vertical_justification>:<horizontal_offset>:<vertical_offset>. אם מציינים, אפשר לכלול ערך ריק במחרוזת הפרמטר chm עבור <opt_z_order>. לדוגמה: N,000000,0,1,10,,b, N,000000,0,1,10,,lv וגם N,000000,0,1,10,,r::10.
horizontal_and_vertical_justification
נקודת העוגן של הסמן. ההתנהגות הזו הפוכה מהנימוקים, ולכן עוגן שמאלי למעשה מציב את הסמן לימין לנקודת הנתונים. אפשר לבחור מגביל אופקי ו/או אנכי מהרשימה הבאה:
  • מיקום אופקי: 'l', 'h' או 'r' – שמאל, מרכז או בעיגון ימני, אופקי. ברירת המחדל היא 'l'.
  • מיקום אנכי: 'b', 'v', 't' - למטה, באמצע או למעלה, אנכית. ברירת המחדל היא 'b'.
  • מיקום יחסי בר [תרשימי עמודות בלבד]: 's', 'c', 'e' – בסיס, מרכז או החלק העליון של עמודה. בתרשימים מוערם, זהו ביחס לקטע של העמודה בכל סדרה, ולא לעמודה כולה. אם אינדקס הסדרה הנתון הוא -1 (סכום כולל בערימה), הוא ביחס לעמודה כולה. ניתן לשלב זאת עם ערכים של מיקום אנכי: לדוגמה, 'be' או 'vs'. ערך ברירת המחדל הוא 'e'.
horizontal_offset
היסט אופקי לסמן הזה, בפיקסלים. ברירת המחדל היא 0.
vertical_offset
היסט אנכי לסמן הזה, בפיקסלים. ברירת המחדל של תרשים ללא עמודות: 15; ברירת המחדל של תרשים עמודות: 2.

תיאור דוגמה

דוגמה לתוויות של ערכים בתרשים עמודות.

התרשים הראשון (N*p0*) מציין סמן של ערך נתונים. הערכים מוצגים כאחוז, ומעוגלים לאפס ספרות אחרי הנקודה העשרונית, בצבע שחור לכל הערכים, בטקסט של 11 נקודות. חשוב לשים לב שכל ערכי הנתונים הם בין 0.0 ל-1.0, בפורמט באחוזים נעים למעלה עם שתי ספרות אחרי הנקודה העשרונית.

בתרשים השני (N*cEUR1*) מוצגים אותם ערכים בפורמט של ערכים באירו, מקום עשרוני אחד, בשחור, בכל הערכים, בטקסט עם 11 נקודות.

תרשים עמודות עם תוויות של אחוזים מעל כל עמודה
chm=
  N*p0*,000000,0,-1,11
chd=t:
  0.4356,0.3562,0.4834,0.575,0.673,0.6091


תרשים עמודות עם תוויות אירו מעל כל עמודה


chm=
  N*cEUR1*,000000,0,-1,11

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

בדוגמה הזו מוצג תרשים עם הערכים בקידוד פשוט של 46, 39, 29, 30, 43, 41. טווח הקידוד הפשוט הוא 0-61 . הפרמטר chds מגדיר סולם סמנים מותאם אישית של 0 עד 1, כך שערכי הסמנים יותאמו לטווח הזה, אבל גובה העמודות לא יושפע (אם מדובר בנתונים של פורמט טקסט, גם העמודות יוגדלו).


chd=s:underp
chm=N,000000,0,-1,11
chds=0,1

בהמשך מוצגת דוגמה לתרשים עם תווית טקסט בנקודה המינימלית ותווית דגל בנקודה המקסימלית.

תרשים קו עם תווית טקסט כחולה של 10 נקודות ודגל עם טקסט אדום באורך 15 נקודות, שמשורטטים על נקודות הנתונים של קו ירוק מקווקו.
chm=
  tMin,0000FF,0,1,10|
  fMax,FF0000,0,3,15

בדוגמה הזו מוצג תרשים מוערם עם ערכים לסדרות בודדות, וגם הסכום הכולל של הסדרה. כדי להציג את ערכי הסדרות המוערם, עלינו להשתמש באפשרות המיקום 'c'. אם לא, ערך העמודה העליונה יחפוף לערך הסכום בראש כל עמודה.
chm=
  N,FF0000,-1,,12|
  N,000000,0,,12,,c|
  N,000000,1,,12,,c|
  N,ffffff,2,,12,,c
כמה הדגמות נוספות של אופן הפעולה של מיקומי מודעות אנכיים ואופקיים. בדוגמה הזו מוצגים שילובים שונים של ערכי עוגן לתרשימי עמודות (שבהם נעשה שימוש ב-s , c ו-e למיקום אנכי). שימו לב איך עוגן ימני מזיז סמן שמאלה ועוגן עליון מזיז סמן למטה ולהפך. הנקודות האדומות מייצגות את הבסיס, המרכז ובחלק העליון של כל עמודה. המספר הוא ערך הנתונים, שקבוע באמצעות ערכי עוגן שונים בכל עמודה.
chm=
  N,000000,0,0,10,,rs
  N,000000,0,1,10,,ls
  N,000000,0,2,10,,c
  N,000000,0,3,10,,e
  N,000000,0,4,10,,e::15
  N,000000,0,5,10,,e::-12
סמני הערה מתאימים אוטומטית את מיקום התווית כך שלא תהיה חפיפה. הערך הראשון של chm מיועד למילוי השורה. הערכים הבאים הם כל סמני ההערות.
chm=B,C5D4B5BB,0,0,0
  AA,666666,0,3,15
  AB,666666,0,5,15
  AC,666666,0,24,15
  AD,666666,0,25,15
  AE,666666,0,26,15
  AF,666666,0,51,15
  AG,666666,0,60,15
  AH,666666,0,73,15
  AI,666666,0,80,15
  AJ,666666,0,99,15
דוגמה נוספת לסמן הערה שמראה את הגובה של העיר בשוויץ.

חזרה למעלה