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

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

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

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

פעולה תחביר ודוגמה מאפיינים תיאור

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 פיקסלים).

  • סוג ההתאמה לגודל (אופציונלי): enum, ערכים: proportional, ‏ stretch.
    		•

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

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

    Scale

    ?imop=Scale,ratio=<scale_ratio>

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

    		 ratio
    • טיפוס: 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

    		 shape
    • טיפוס: String (מחרוזת) (מלבן, עיגול)
    • ברירת מחדל: מלבן
    • תלות: חובה להשתמש בו עם הפרמטר crop. ערך לא תקין יחזיר HTTP 400.
    left, right, top, bottom
    • טיפוס: Float (מספר ממשי)
    • טווח: 0.0 עד 1.0, עד 3 ספרות אחרי הנקודה העשרונית
    • ברירת מחדל: 0.0, ‏ 1.0, ‏ 0.0, ‏ 1.0
    snap_to_x, snap_to_y
    • סוג: מספר שלם
    • טווח: 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

    		 width, height
    • סוג: מספר שלם
    • טווח: 1 עד 8,192
    • הרוחב המקסימלי כפול הגובה המקסימלי לא יכול להיות גדול מ-67,108,864 פיקסלים.
    gravity
    • טיפוס: String (מחרוזת)
    • ערכים: center, left, right, top, bottom, top_left, top_right, bottom_left, bottom_right
    • ברירת מחדל: למרכז
    background_color
    • טיפוס: String (מחרוזת)
    • פורמט: קודים הקסדצימליים בני 3, 4 או 6 ספרות
    • ברירת מחדל: 000000 (שחור).

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

    Rotate

    ?imop=Rotate,degrees=<rotate_degrees>

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

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

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

    Mirror

    ?imop=Mirror,flip=<flip>

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

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

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

    Compress

    ?imop=Compress,strength=<value>

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

    		 strength
    • טיפוס: 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

    		 format
    • סוג: מחרוזת.
    • הערכים האפשריים: 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

    		 preserve
    • טיפוס: 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

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

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

    Blur

    ?imop=Blur,strength=<blur_size>

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

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

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

    Freeze

    ?imop=freeze,frame=<frame>

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

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

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

    המאמרים הבאים