پرش به مطلب اصلی
logologo
مستندات
اتاق خبربلاگتماس با ما
راهنمای فنیانجمنارجاعاتپرسش‌های رایج

URL پردازش تصویر

آروان ایمیج پردازش تصویر را از طریق URL انجام می‌دهد. یک درخواست HTTP GET به آروان ایمیج ارسال می‌کنید و سرویس با یک فایل تصویری پردازش‌شده و هدر Content-Type: image پاسخ می‌دهد.

ساختار URL​

https://your-subdomain.arvanimage.ir/{شناسه}/{گزینه‌های پردازش}/v1/{مسیر فایل}[.{پسوند خروجی}]

نمونه:

https://acme.arvanimage.ir/brandkit/c_fill,w_300,h_400,g_center/e_brightness:20/e_blur:100/q_80/v1/products/photo.jpg.webp

این URL تصویر را به ابعاد ۳۰۰×۴۰۰ برش می‌دهد، گرانش مرکزی را اعمال می‌کند، روشنایی را افزایش می‌دهد، تصویر را blur می‌کند، کیفیت ۸۰ را تنظیم می‌کند و خروجی WebP می‌دهد.

گزینه‌های پردازش​

تغییر اندازه و برش​

c_<type>

نحوه‌ی تغییر اندازه یا برش تصویر را مشخص می‌کند.

مقداررفتار
fitتصویر را با حفظ نسبت ابعاد درون کادر جا می‌دهد
fillتصویر را با حفظ نسبت ابعاد تا پر شدن کادر بزرگ می‌کند و اضافه‌ها را می‌برد
scaleتصویر را دقیقن به ابعاد داده‌شده کشیده می‌کند
limitمانند fit است اما از بزرگ‌نمایی جلوگیری می‌کند
lfillمانند fill است اما از بزرگ‌نمایی جلوگیری می‌کند
cropیک ناحیه‌ی مستطیلی با ابعاد داده‌شده را از تصویر می‌برد
padتصویر را با حفظ نسبت ابعاد درون کادر جا می‌دهد و فضای خالی را با رنگ پس‌زمینه پر می‌کند
lpadمانند pad است اما از بزرگ‌نمایی جلوگیری می‌کند

نمونه‌ها:

# fit
https://acme.arvanimage.ir/brandkit/c_fit,w_800,h_600/v1/products/photo.jpg

# fill
https://acme.arvanimage.ir/brandkit/c_fill,w_300,h_400/v1/products/photo.jpg

# scale
https://acme.arvanimage.ir/brandkit/c_scale,w_800,h_600/v1/products/photo.jpg

# limit
https://acme.arvanimage.ir/brandkit/c_limit,w_800,h_600/v1/products/photo.jpg

# lfill
https://acme.arvanimage.ir/brandkit/c_lfill,w_300,h_400/v1/products/photo.jpg

# crop
https://acme.arvanimage.ir/brandkit/c_crop,w_300,h_300/v1/products/photo.jpg

# pad
https://acme.arvanimage.ir/brandkit/c_pad,w_800,h_600/v1/products/photo.jpg

# lpad
https://acme.arvanimage.ir/brandkit/c_lpad,w_800,h_600/v1/products/photo.jpg

عرض و ارتفاع​

w_<value>

h_<value>

عرض و ارتفاع خروجی را به پیکسل مشخص می‌کنند.

نمونه:

https://acme.arvanimage.ir/brandkit/c_fit,w_800,h_600/v1/products/photo.jpg

نسبت تصویر​

ar_<width>:<height>

ar_<decimal>

نسبت تصویر خروجی را مشخص می‌کند. باید همراه با _w یا _h استفاده شود.

نمونه‌ها:

# نسبت 16:9 با تعیین عرض
https://acme.arvanimage.ir/brandkit/c_fill,w_800,ar_16:9/v1/products/photo.jpg

# نسبت 1.5 با تعیین ارتفاع
https://acme.arvanimage.ir/brandkit/c_fit,h_600,ar_1.5/v1/products/photo.jpg

گرانش​

g_<position>

موقعیت تصویر را هنگام برش مشخص می‌کند.

مقدارهای قابل استفاده: center، north، south، east، west، north_east، north_west، south_east و south_west.

نمونه‌ها:

# مرکز
https://acme.arvanimage.ir/brandkit/c_fill,w_400,h_400,g_center/v1/products/photo.jpg

# بالا
https://acme.arvanimage.ir/brandkit/c_fill,w_400,h_400,g_north/v1/products/photo.jpg

# پایین راست
https://acme.arvanimage.ir/brandkit/c_fill,w_400,h_400,g_south_east/v1/products/photo.jpg

جابه‌جایی نقطه‌ی برش​

x_<value>

y_<value>

این گزینه‌ها فقط همراه با c_crop قابل استفاده هستند.

نمونه:

https://acme.arvanimage.ir/brandkit/c_crop,w_400,h_400,x_30,y_-20/v1/products/photo.jpg

کیفیت​

q_<value>

کیفیت خروجی را از ۱ تا ۱۰۰ تعیین می‌کند.

نمونه:

https://acme.arvanimage.ir/brandkit/q_80/v1/products/photo.jpg.webp

چرخش​

a_<angle>

تصویر را با زاویه‌ی مضرب ۹۰ می‌چرخاند.

نمونه:

https://acme.arvanimage.ir/brandkit/a_90/v1/products/photo.jpg

برگرداندن تصویر​

a_hflip

a_vflip

نمونه‌ها:

# برگرداندن افقی
https://acme.arvanimage.ir/brandkit/a_hflip/v1/products/photo.jpg

# برگرداندن عمودی
https://acme.arvanimage.ir/brandkit/a_vflip/v1/products/photo.jpg

پس‌زمینه​

b_rgb:<hex_color>

رنگ پس‌زمینه‌ی خروجی را مشخص می‌کند.

نمونه:

https://acme.arvanimage.ir/brandkit/c_pad,w_800,h_600/b_rgb:FC41CB/v1/products/photo.png

DPR​

dpr_<value>

ضریب DPR خروجی را مشخص می‌کند.

نمونه:

https://acme.arvanimage.ir/brandkit/c_fit,w_800,h_600/dpr_2/v1/products/photo.jpg

فیلترها​

blur​

e_blur

e_blur:<strength>

نمونه‌ها:

# مقدار پیش‌فرض
https://acme.arvanimage.ir/brandkit/e_blur/v1/products/photo.jpg

# strength برابر ۲۰۰
https://acme.arvanimage.ir/brandkit/e_blur:200/v1/products/photo.jpg

sharpen​

e_sharpen

e_sharpen:<strength>

نمونه‌ها:

https://acme.arvanimage.ir/brandkit/e_sharpen/v1/products/photo.jpg
https://acme.arvanimage.ir/brandkit/e_sharpen:200/v1/products/photo.jpg

pixelate​

e_pixelate

e_pixelate:<size>

نمونه‌ها:

https://acme.arvanimage.ir/brandkit/e_pixelate/v1/products/photo.jpg
https://acme.arvanimage.ir/brandkit/e_pixelate:12/v1/products/photo.jpg

روشنایی​

e_brightness:<level>

نمونه:

https://acme.arvanimage.ir/brandkit/e_brightness:20/v1/products/photo.jpg

کنتراست​

e_contrast:<level>

نمونه:

https://acme.arvanimage.ir/brandkit/e_contrast:-15/v1/products/photo.jpg

اشباع رنگ​

e_saturation:<level>

نمونه:

https://acme.arvanimage.ir/brandkit/e_saturation:25/v1/products/photo.jpg

سیاه‌وسفید​

e_grayscale

نمونه:

https://acme.arvanimage.ir/brandkit/e_grayscale/v1/products/photo.jpg

حذف پس‌زمینه‌ی یکدست​

e_trim

e_trim:<tolerance>

e_trim:<tolerance>:rgb:<hex_color>

نمونه‌ها:

# tolerance پیش‌فرض
https://acme.arvanimage.ir/brandkit/e_trim/v1/products/logo.png

# tolerance برابر ۱۰
https://acme.arvanimage.ir/brandkit/e_trim:10/v1/products/logo.png

# حذف پس‌زمینه‌ی سفید
https://acme.arvanimage.ir/brandkit/e_trim:10:rgb:FFFFFF/v1/products/logo.png

گزینه‌های تکمیلی​

نوع تغییر اندازه​

ip_resizing_type:<type>

نمونه:

https://acme.arvanimage.ir/brandkit/ip_resizing_type:fill/v1/products/photo.jpg

بزرگ‌نمایی​

ip_enlarge:<value>

نمونه:

https://acme.arvanimage.ir/brandkit/ip_enlarge:1/v1/products/photo.jpg

حداقل ابعاد​

ip_min_width:<value>

ip_min_height:<value>

نمونه:

https://acme.arvanimage.ir/brandkit/ip_min_width:300,ip_min_height:200/v1/products/photo.jpg

Zoom​

ip_zoom:<x>

ip_zoom:<x>:<y>

نمونه‌ها:

https://acme.arvanimage.ir/brandkit/ip_zoom:1.5/v1/products/photo.jpg
https://acme.arvanimage.ir/brandkit/ip_zoom:1.5:2/v1/products/photo.jpg

گسترش تصویر​

ip_extend:<value>[:<gravity>[:<x>:<y>]]

نمونه‌ها:

https://acme.arvanimage.ir/brandkit/ip_extend:1/v1/products/photo.jpg
https://acme.arvanimage.ir/brandkit/ip_extend:1:center:10:20/v1/products/photo.jpg

گسترش بر اساس نسبت تصویر​

ip_extend_aspect_ratio:<value>[:<gravity>[:<x>:<y>]]

نمونه:

https://acme.arvanimage.ir/brandkit/ip_extend_aspect_ratio:1:center/v1/products/photo.jpg

گرانش پیشرفته​

ip_gravity:<type>[:<x>:<y>]

نمونه‌ها:

https://acme.arvanimage.ir/brandkit/ip_gravity:ce/v1/products/photo.jpg
https://acme.arvanimage.ir/brandkit/ip_gravity:fp:0.33:0.5/v1/products/photo.jpg

برش پیشرفته​

ip_crop:<width>[:<height>[:<gravity>[:<x>:<y>]]]

نمونه:

https://acme.arvanimage.ir/brandkit/ip_crop:400:400:ce/v1/products/photo.jpg

حذف پس‌زمینه‌ی پیشرفته​

ip_trim:<threshold>[:<hex_color>[:<equal_h>:<equal_v>]]

نمونه:

https://acme.arvanimage.ir/brandkit/ip_trim:10:FFFFFF:1:1/v1/products/logo.png

فاصله‌ی داخلی​

ip_padding:<top>[:<right>:<bottom>:<left>]

نمونه‌ها:

https://acme.arvanimage.ir/brandkit/ip_padding:10/v1/products/photo.png
https://acme.arvanimage.ir/brandkit/ip_padding:10:20:15:5/v1/products/photo.png

چرخش خودکار بر اساس EXIF​

ip_auto_rotate:<value>

نمونه:

https://acme.arvanimage.ir/brandkit/ip_auto_rotate:1/v1/products/photo.jpg

فیلترهای مستقیم​

ip_blur:<sigma>

ip_sharpen:<sigma>

ip_pixelate:<size>

نمونه:

https://acme.arvanimage.ir/brandkit/ip_blur:10,ip_sharpen:5,ip_pixelate:8/v1/products/photo.jpg

واترمارک​

ip_watermark:<opacity>[:<position>:<x>:<y>:<scale>]

نمونه‌ها:

https://acme.arvanimage.ir/brandkit/ip_watermark:0.5/v1/products/photo.jpg
https://acme.arvanimage.ir/brandkit/ip_watermark:0.5:se:10:10:0.25/v1/products/photo.jpg

متادیتا​

ip_strip_metadata:<value>

ip_keep_copyright:<value>

ip_strip_color_profile:<value>

ip_preserve_hdr:<value>

نمونه:

https://acme.arvanimage.ir/brandkit/ip_strip_metadata:1,ip_keep_copyright:0,ip_strip_color_profile:1,ip_preserve_hdr:0/v1/products/photo.jpg

Thumbnail توکار​

ip_enforce_thumbnail:<value>

نمونه:

https://acme.arvanimage.ir/brandkit/ip_enforce_thumbnail:1/v1/products/photo.jpg

کیفیت بر اساس فرمت​

ip_format_quality:<format>:<quality>[:<format>:<quality>...]

نمونه:

https://acme.arvanimage.ir/brandkit/ip_format_quality:webp:80:jpg:75/v1/products/photo.jpg.webp

حداکثر حجم خروجی​

ip_max_bytes:<bytes>

نمونه:

https://acme.arvanimage.ir/brandkit/ip_max_bytes:200000/v1/products/photo.jpg.webp

فرمت خروجی​

فرمت خروجی با پسوند انتهایی مسیر فایل مشخص می‌شود:

# حفظ فرمت اصلی
https://acme.arvanimage.ir/brandkit/v1/products/photo.jpg

# تبدیل JPG به WebP
https://acme.arvanimage.ir/brandkit/v1/products/photo.jpg.webp

# تبدیل PNG به AVIF
https://acme.arvanimage.ir/brandkit/v1/products/photo.png.avif