פעולות נתמכות

Resize

?imop=Resize,width=<resized_width>,height=<resized_height>

https://www.example.com/image.jpg?imop=Resize,width=250,height=125

• width סוג: Integer (טווח: 1 עד 8192)
• height סוג: Integer (טווח: 1 עד 8192)

הגודל המקסימלי width * height לא יכול להיות גדול מ-67 מגה-פיקסל (67,108,864 פיקסלים).

הפעולה הזו לא שומרת על יחס הגובה-רוחב כשמציינים את פרמטר הרוחב וגם את פרמטר הגובה. אם משמיטים את אחד הממדים, Cloud CDN image optimization מחשב את הממד השני כדי לשמור על יחס הגובה-רוחב.

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

Scale

?imop=Scale,ratio=<scale_ratio>

https://www.example.com/image.jpg?imop=Scale,ratio=0.5

• טיפוס: Float (מוגבל ל-2 ספרות אחרי הנקודה העשרונית)
• אילוץ: 0 < value

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

אם כוללים את הפעולה Scale עם הפעולות Resize או Crop בבקשה אחת, המערכת מחזירה שגיאה.

Crop

?imop=Crop,shape=<shape>,left=<left>,right=<right>,top=<top&lgt;,bottom=<bottom>,snap_to_x=<snap_x>,snap_to_y=<snap_y>

https://www.example.com/image.jpg?imop=Crop,shape=rectangle,left=0.5,snap_to_x=512

• טיפוס: String (מחרוזת) (מלבן, עיגול)
• ברירת מחדל: מלבן
• תלות: חובה להשתמש בו עם הפרמטר crop. ערך לא תקין יחזיר HTTP 400.

• טיפוס: Float (מספר ממשי)
• טווח: 0.0 עד 1.0, עד 3 ספרות אחרי הנקודה העשרונית
• ברירת מחדל: 0.0, ‏ 1.0, ‏ 0.0, ‏ 1.0

• סוג: מספר שלם
• טווח: 0 ומעלה
• ברירת מחדל: 0
• מגבלה: חובה לכלול לפחות אחת מהאפשרויות הבאות: left, right, top, bottom.

הפעולה הזו חותכת את התמונה על סמך סמנים אזוריים. אם מציינים ערך לא תקין לפרמטר shape, המערכת מחזירה את הערך HTTP 400 Bad Request.

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

Canvas

?imop=Canvas,width=<canvas_width>,height=<canva_height>,background_color=<color>,gravity=<gravity>

https://www.example.com/image.jpg?imop=Canvas,width=250,height=125,background_color=FFF,gravity=center

• סוג: מספר שלם
• טווח: 1 עד 8,192
• הרוחב המקסימלי כפול הגובה המקסימלי לא יכול להיות גדול מ-67,108,864 פיקסלים.

• טיפוס: String (מחרוזת)
• ערכים: center, left, right, top, bottom, top_left, top_right, bottom_left, bottom_right
• ברירת מחדל: למרכז

• טיפוס: String (מחרוזת)
• פורמט: קודים הקסדצימליים בני 3, 4 או 6 ספרות
• ברירת מחדל: 000000 (שחור).

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

Rotate

?imop=Rotate,degrees=<rotate_degrees>

https://www.example.com/image.jpg?imop=Rotate,degrees=90

• סוג: מספר שלם
• הערכים המותרים: 90, ‏ 180, ‏ 270.

הפעולה הזו מסובבת את תמונת היעד בכיוון השעון.

Mirror

?imop=Mirror,flip=<flip>

https://www.example.com/image.jpg?imop=Mirror,flip=h

• טיפוס: String (מחרוזת)
• הערכים המותרים: h (אופקי), v (אנכי), hv (אופקי ואנכי).

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

Compress

?imop=Compress,strength=<value>

https://www.example.com/image.jpg?imop=Compress,strength=medium

• טיפוס: String (מחרוזת)
• הערכים המותרים: very_weak, ‏ weak, ‏ medium, ‏ strong, ‏ very_strong.
• הגבלה: נתמך רק בפורמטים jpeg,‏ avif ו-webp. ערכים מחוץ לטווח הזה מחזירים HTTP 400.

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

Convert

?imop=Convert,format=<format>

https://www.example.com/image.jpg?imop=Convert,format=webp

• סוג: מחרוזת.
• הערכים האפשריים: jpeg, ‏ png, ‏ webp, ‏ avif, ‏ gif
• הגבלה: כל ערך אחר שלא מופיע ברשימה יגרום לשגיאת עיבוד.

הפעולה הזו משנה את פורמט המסירה הסופי של התמונה. אם יש סתירה בעיבוד עם הגדרת הכותרת הנכנסת ACCEPT של הדפדפן, המערכת מחזירה שגיאה HTTP 406 Not Acceptable.

Metadata

?imop=Metadata,preserve=<preserve>

https://www.example.com/image.jpg?imop=Metadata,preserve=none

• טיפוס: String (מחרוזת)
• הערכים המותרים: none, ‏ copyright, ‏ max
• ברירת מחדל: copyright

הפעולה הזו קובעת איך מאפייני המטא-נתונים של התמונה מטופלים במהלך ההפעלה:

‫none: מסיר את כל מאפייני המטא-נתונים.

‫max: כל השדות נשמרים, מלבד נתוני הכיוון של EXIF ופרופילי הצבע שמוחלים על הטרנספורמציה

‫copyright: שומר רק את השדות Author,‏ Copyright ו-Caption.

Tone

?imop=tone,brightness=<brightness>,contrast=<contrast_level>, saturation=<saturation>

https://www.example.com/image.jpg?imop=tone,brightness=50,contrast=50,saturation=50

• brightness
  • סוג: מספר שלם
  • טווח: ‎-100 עד 100
• contrast
  • סוג: מספר שלם
  • טווח: ‎-100 עד 100
• saturation
  • סוג: מספר שלם
  • טווח: ‎-100 עד 100

הפעולה הזו משנה באופן דינמי את הרמות brightness,‏ contrast ו-saturation של תמונה. אם משמיטים פרמטר ספציפי או מגדירים אותו כ-0, המערכת לא משנה את המאפיין הזה. הגדרת הרוויה ל-‎-100 גורמת להמרה לגווני אפור.

Sharpen

?imop=Sharpen,strength=<sharpness>

https://www.example.com/image.jpg?imop=Sharpen,strength=50

• סוג: מספר שלם
• טווח: 0 עד 100

הפעולה הזו מגדילה את החדות של התמונה.

Blur

?imop=Blur,strength=<blur_size>

https://www.example.com/image.jpg?imop=Blur,strength=50

• סוג: מספר שלם
• טווח: 0 עד 100

הפעולה הזו מפעילה מסנן טשטוש מקומי על התמונה.

Freeze

?imop=freeze,frame=<frame>

https://www.example.com/image.gif?imop=freeze,frame=0

• סוג: מספר שלם
• הטווח: 0 עד 100.

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