تحولات تصویر

این که آیا برنامه وب یا موبایل شما تصاویر خود را با دقت انتخاب شده ، تصاویر آپلود شده توسط کاربران نهایی شما (UGC) یا هر دو ، ارائه می دهد ، احتمالاً شما نیاز به تنظیم اصالت دارید تا متناسب با طراحی گرافیکی وب سایت یا برنامه تلفن همراه خود باشد.

تحولات URL پویا Cloudinary شما را قادر می سازد بدون نیاز به طراحان گرافیک و ابزارهای ویرایش فانتزی ، به صورت برنامه ای و پرواز به آن اهداف برسید.

شما می توانید این URL ها را به صورت دستی در کد خود بسازید ، یا از SDK های Cloudinary استفاده کنید ، که به شما امکان می دهد کد تحول خود را با استفاده از نحو بصری طراحی شده برای زبان یا چارچوب برنامه نویسی مورد نظر خود بنویسید و اجازه دهید SDK به طور خودکار این URL ها را برای شما بسازد.

برنامه قیمت گذاری حساب شما تا حدودی به تعداد کل عملیات تحول انجام شده در طی یک چرخه صورتحساب بستگی دارد. اینها در درجه اول هنگامی شمارش می شوند که Cloudinary یک منبع جدید مشتق شده از دارایی بر اساس URL تحول ایجاد می کند. برای جزئیات کامل ، ببینید که چگونه تحولات حساب می شود؟

در اینجا فقط چند نمونه از موارد استفاده محبوب وجود دارد که می توانید با ترکیب تحولات ابری در پرواز انجام دهید. برای دیدن پارامترهای URL اعمال شده در هر مورد ، روی هر تصویر کلیک کنید:

تبدیل قالب ، گرد ، تغییر نسبت ابعاد و محصول به چهره ، اضافه کردن طرح ها و سایه ها مکان ، سبک و تصویر و لایه های متنی جلوه های ویژه ای مانند کارتونی و روشنایی را به کار می برند ، به هر زاویه ای می چرخند

بررسی اجمالی

Cloudinary به شما امکان می دهد تا تصاویر خود را به راحتی در پرواز به هر قالب ، سبک و ابعاد مورد نیاز تبدیل کنید و جلوه ها و سایر پیشرفت های بصری را اعمال کنید. همچنین می توانید تصاویر خود را بهینه کنید تا آنها را با حداقل اندازه پرونده در کنار کیفیت بصری بالا برای یک تجربه کاربر بهبود یافته و پهنای باند حداقل تحویل دهید. شما می توانید همه این کارها را با اجرای URL های تحول دینامیکی تصویر و تحویل انجام دهید. تصاویر تبدیل شده شما از طریق یک CDN سریع با ذخیره سازی بهینه شده به کاربران شما تحویل داده می شوند.

با تحولات تصویر ، می توانید:

• تصاویر را با استفاده از قالب تصویر متناسب با نیازهای شما ارائه دهید. تصاویر شما به ابعاد مورد نیاز با استفاده از تکنیک های مختلف مقیاس بندی و برداشت ، یا از تکنیک های کشت هوشمند ما ، از جمله تشخیص چهره یا جاذبه خودکار برای برداشت برای تمرکز بر روی قسمتهای مهم یک عکس استفاده می کنید.
• با لایه بندی تصاویر دیگر یا متن روی تصویر پایه خود ، یک تصویر جدید ایجاد کنید.
• انواع مختلفی از جلوه ها ، فیلترها و سایر پیشرفتهای بصری را برای کمک به تصویر خود در دستیابی به تأثیر مورد نظر استفاده کنید.

صفحات دیگر در این راهنما جزئیات را ارائه می دهد و از نمونه های موردی در انواع مختلف تحولات تصویری که می توانید در تصاویر خود استفاده کنید استفاده کنید.

مرجع API URL Transformation هر پارامتر تحول موجود برای تصاویر و فیلم ها را نشان می دهد.

محدودیت های استفاده برای بارگذاری ، تبدیل و تحویل پرونده ها به برنامه ابر شما بستگی دارد. برای جزئیات بیشتر ، برگه حساب را در تنظیمات کنسول ابری خود بررسی کنید.

مثال سریع

در زیر می توانید URL تحول و کد SDK مربوطه را برای تولید تصویری با چندین پارامتر تحول اعمال شده مشاهده کنید. این تحول تصویری را ایجاد می کند که در ابتدا به یک تصویر 400x400 برش داده می شود که به طور خودکار روی صورت متمرکز می شود ، سپس به یک دایره گرد می شود و در نهایت ، به عرض 200 پیکسل می رسد.

اصلی

تصویر تبدیل شده

نحو URL تحول

دارایی های رسانه ای ابر شما با استفاده از URL های تحویل ساده HTTP یا HTTPS ، که سپس از طریق یک CDN سریع جهانی در سراسر جهان به کاربران تحویل داده می شوند ، قابل دسترسی هستند. URL حاوی شناسه عمومی دارایی درخواست شده به علاوه هرگونه پارامترهای تحول اختیاری است. شناسه عمومی شناسه منحصر به فرد دارایی است و یا هنگام بارگذاری دارایی به Cloudinary تعریف می شود ، یا به طور خودکار توسط Cloudinary اختصاص داده می شود (برای اطلاعات بیشتر در مورد گزینه های مختلف برای مشخص کردن شناسه عمومی ، به بارگذاری دارایی ها مراجعه کنید).

ایجاد URL های تحول با SDK های ابر

SDK های Cloudinary به طور خودکار URL تحول را برای شما ایجاد می کنند. آنها به شما امکان می دهند تا در چارچوب توسعه دهنده مورد نظر خود به کار خود ادامه دهید و همچنین روش های یاور را برای ساده سازی برچسب های تصویر و URL های تحول تصویر ارائه دهید.

همچنین می توانید URL های تحول خود را با استفاده از ویرایشگر تحول یا سازنده جدید تحول (BETA) ایجاد کنید. از طرف دیگر ، می توانید یکی از دستور العمل های کتاب آشپزی ما را به عنوان نقطه شروع بگیرید و سپس آن را در ویرایشگر تحول بیشتر تغییر دهید تا متناسب با نیازهای شما باشد. ویرایشگر و سازنده کد URL و SDK را برای تحولی که تعریف می کنید ایجاد می کنند تا بتوانید آن را به زبان مورد نیاز خود کپی کنید.

ساختار URL تحول

URL پیش فرض تحویل دارایی ابر ساختار زیر دارد:

• نوع تصویر شامل فرمت های تصویر و عکس ثابت ، تصاویر متحرک ، PDF ، پرونده های لایه ای مانند TIFF و PSD و سایر موارد است.
• نوع ویدیو شامل فایلهای ویدئویی و صوتی است.
• نوع خام شامل هر پرونده ای است که در Cloudinary بارگذاری شده است که در یکی از دسته های فوق جای نمی گیرد. به طور کلی ، تحولات نمی تواند روی دارایی های خام انجام شود ، اما می توان آنها را برای اهداف بارگیری تحویل داد ، یا در برخی موارد ممکن است در رابطه با تصویر یا تحولات ویدیویی شما استفاده شود.

در عمومی ترین مورد ارائه ساده ای از تصاویر که در محیط محصول ابر شما و بدون هیچ گونه تحول بارگذاری شده اند ، URL تحویل در قالب خواهد بود:

به عنوان مثال ، ارائه تصویر با شناسه عمومی: نمونه ، بارگذاری شده در محیط محصول نمایشی Cloudinary با فرمت JPG:

موارد زیر نمونه ای از ارائه همان تصویر با پارامترهای تحول را نشان می دهد ، که در آن تصویر مقیاس بندی شده و برای پر کردن اندازه 250x300 پیکسل و یک اثر تاری استفاده می شود:

نکات URL تحول

• برای مشتریانی که دارای نام دامنه سفارشی (CNAME) هستند - برای برنامه پیشرفته Cloudinary و بالاتر از آن - URL تحویل تصویر اساسی در دسترس است: https: /// تصویر/بارگذاری.
• با تغییر ساده پسوند فایل فرمت تصویر می توانید تصویر خود را در سایر قالب های تصویر پشتیبانی شده تبدیل و تحویل دهید. برای جزئیات بیشتر ، به ارائه با فرمت دیگری مراجعه کنید.

می توانید با جایگزینی عنصر تصویر/بارگذاری URL با تصاویر ، پسوند SEO دوستانه را به URL خود اضافه کنید و سپس پس از شناسه عمومی و قبل از پسوند ، پسوند مورد نظر را با یک برش (/) اضافه کنید. به عنوان مثال ، اگر شما یک تصویر آشپزی با شناسه عمومی تصادفی مانند: ABC1DEF2 دارید ، می توانید تصویر خود را به عنوان:

همچنین می توانید هنگام ارائه پرونده های تصویری با استفاده از نوع بارگذاری پیش فرض ، از URL های میانبر استفاده کنید. با ویژگی URL مسیر ریشه Cloudinary ، عناصر و عناصر را می توان از URL حذف کرد (آنها به طور خودکار به تصویر مقادیر پیش فرض و بارگذاری می شوند). به عنوان مثال ، URL تحویل میانبر مسیر ریشه برای تصویر بریده شده در بالا:

آموزش ویدیویی URL تحول

فیلم زیر نمایشی سریع از نحوه عملکرد URL های تحول پویا با هر دو تصویر و فیلم ارائه می دهد.

انواع تحویل

عنصر نوع تحویل URL نشانگر نحوه تحویل دارایی است ، اگرچه در بیشتر موارد ، مقدار تحویل در زمان ذخیره دارایی در ابر تعیین می شود.

مقادیر نوع تحویل زیر پشتیبانی می شوند:

می توانید با استفاده از جستجوی پیشرفته در کتابخانه رسانه ، دارایی ها را با استفاده از نوع تحویل جستجو کنید. متداول ترین انواع را می توان مستقیماً در بخش نوع برگه جستجوی عمومی انتخاب کرد. همه انواع دیگر را می توان از لیست انواع بیشتری انتخاب کرد.

انواع پارامتری

دو نوع پارامتر تحول وجود دارد:

• پارامترهای عمل: پارامترهایی که تحول خاصی را بر روی دارایی انجام می دهند.
• پارامترهای صلاحیت: پارامترهایی که به تنهایی عملی را انجام نمی دهند ، بلکه رفتار پیش فرض را تغییر می دهند یا در غیر این صورت نتیجه پارامتر عمل مربوطه را تنظیم می کنند.

بهترین عمل است که فقط یک پارامتر عمل در هر مؤلفه URL را در بر می گیرد.

اگر می خواهید چندین عمل را در یک URL تحول واحد اعمال کنید ، آنها را در اجزای زنجیره ای جداگانه اعمال کنید ، جایی که هر عمل بر روی نتیجه قبلی انجام می شود.

در مقابل ، پارامترهای واجد شرایط باید با پارامتر عملی که واجد شرایط هستند ، در مؤلفه گنجانده شوند.

• اکثر صلاحیت ها اختیاری هستند ، به این معنی که پارامتر عمل مرتبط می تواند به طور مستقل مورد استفاده قرار گیرد ، اما می توانید برای تغییر رفتار پیش فرض ، صلاحیت های اختیاری را اضافه کنید.
• در بعضی موارد ، یک پارامتر عمل به یک یا چند مرحله مقدماتی نیاز دارد تا رفتار تحول را به طور کامل تعریف کند.
• چند پارامتر وجود دارد که می تواند به طور مستقل به عنوان پارامترهای اکشن مورد استفاده قرار گیرد ، اما می تواند در سناریوهای دیگر به عنوان صلاحیت عمل دیگری نیز مورد استفاده قرار گیرد.

به عنوان مثال ، تحول در زیر شامل یک عمل محصول ، یک عمل گرد و 2 عمل اثر است. تحولات واجد شرایط موجود در هر عمل ، تنظیمات اضافی را در رفتار عمل تحول تعریف می کند:

برگه URL بالا URL را همانطور که توسط SDK تولید می شود ، نشان می دهد. SDK ها همیشه پارامترها را در یک مؤلفه URL خاص به ترتیب حروف الفبا تولید می کنند (بنابراین برخی از مقدمات در URL ممکن است قبل از عملی که واجد شرایط هستند) انجام شود.

در این تحول:

• عرض ، نسبت ابعاد ، جاذبه و انتخابی های زوم ، نحوه عملکرد محصول محصول کوچک را کنترل می کنند.
• اقدام گرد در مرحله مقدماتی نیست.
• صلاحیت رنگ بر رنگ پیش فرض عملکرد اثر کلی غلبه می کند.
• صلاحیت های X و Y قرار دادن اثر سایه را تنظیم می کنند و صلاحیت رنگ بر رنگ سایه پیش فرض غلبه می کند.

پرچم های تحول

پرچم های تحول رفتار پیش فرض تحول را تغییر می دهد. در بعضی موارد ، آنها رفتار پیش فرض URL تحول را به طور کلی تغییر می دهند. در موارد دیگر ، آنها رفتار یک یا چند پارامتر تحول خاص را تغییر می دهند که باید در همان مؤلفه URL استفاده شوند.

به طور کلی ، ده ها پرچم در دسترس است که می تواند تحویل و فرمت ، برداشت و موقعیت یابی ، پوشش ، ابرداده و پروفایل های رنگی و همچنین رفتارهای PDF و متن را تغییر دهد ، فقط برای ذکر چند مورد.

FL_ATTACHMENT رفتار عادی تحول کلی را تغییر می دهد. به جای ارائه دارایی در یک صفحه وب ، باعث می شود پرونده رسانه تبدیل شده به عنوان ضمیمه بارگیری شود. این پرچم را می توان به طور مستقل از سایر تحولات استفاده کرد.

fl_releative روش ارزیابی پارامترهای تغییر اندازه روکش را تغییر می دهد. این پرچم فقط در رابطه با پارامتر پوشش (L_) قابل استفاده است.

FL_LAYER_APPLY به Cloudinary می گوید که تمام تحولات زنجیر شده را اعمال کند ، تا زمانی که یک مؤلفه تحول که شامل این پرچم است ، در آخرین پوشش اضافه شده یا دارایی زیر لایه به جای اعمال آنها بر روی دارایی پایه. این پرچم به عنوان یک شاخص برای بستن بخش لایه تحول ، شبیه به یک براکت پایانی عمل می کند. تعاریف قرارگیری برای نحوه استفاده از لایه ، مانند گرانش و جبران خسارت نیز در مؤلفه با این پرچم تعریف می شود.

برای جزئیات بیشتر در مورد تمام پرچم های تحول موجود ، به بخش پرچم مرجع تحول مراجعه کنید.

تولید URL های HTTPS ایمن با استفاده از SDK ها

به دلایل سازگاری به عقب ، بسیاری از نسخه های اصلی SDK قبلی Cloudinary URL های HTTP را به طور پیش فرض تولید می کنند. هنگام استفاده از یکی از این SDK ها ، می توانید به SDK دستور دهید URL های HTTPS را با تنظیم پارامتر ایمن روی True ، یا در سطح جهان به عنوان بخشی از پیکربندی SDK خود ، یا به صورت محلی در هر عملکرد تحول ، تولید کند. به عنوان مثال ، ارائه تصویر نمونه با HTTPS:

Verbose در مقابل نحو غیر فعل

برخی از پارامترهای تحول با گزینه های مختلف ، دو نحو جایگزین را برای تعریف مقادیر گزینه ارائه می دهند:

• Verbose ، Unoed: هر گزینه از تحول (اعم از مورد نیاز یا اختیاری) در قالب Verbose name_value مشخص شده است و هر گزینه بسته به تحول توسط یک روده بزرگ (:) یا نیمه کلون (؛) از هم جدا می شود.

   

گزینه ها را می توان به هر ترتیب مشخص کرد ، و شما فقط باید مواردی را که می خواهید (یا لازم است) برای تعریف آن درج کنید.

تحول هایی که از نحو URL url و غیر کلامی پشتیبانی می کنند ، در مرجع تحول نشان داده شده اند. هنگامی که هر دو پشتیبانی می شوند ، SDK ها همیشه نحو Verbose را خروجی می کنند.

Verbose در مقابل مثال غیر فعل

اثر موضوع از گزینه های رنگ و حساسیت به نور پشتیبانی می کند ، اما می توانید با استفاده از نحو Verbose ، آنها را به ترتیب دیگری مشخص کنید. مثلا:

با این حال ، هنگام استفاده از نحو غیر فعل ، باید پارامترها را به ترتیب مشخص کنید. بنابراین ، حتی اگر شما فقط می خواهید رفتار پیش فرض گزینه حساسیت به نور (آخرین) را تغییر دهید ، هنوز هم باید مقدار مورد استفاده برای گزینه Color (اول) را مشخص کنید:

تحولات زنجیره ای

Cloudinary از تحولات قدرتمندی که در پرواز با استفاده از URL های پویا اعمال می شود ، پشتیبانی می کند. شما می توانید چندین عمل تحول را به عنوان بخشی از یک درخواست تحویل واحد ، به عنوان مثال ، یک تصویر را با هم ترکیب کنید و سپس یک مرز به آن اضافه کنید.

به طور کلی ، بهترین عمل این است که هر عمل تحول را در URL خود به عنوان یک مؤلفه جداگانه در زنجیره زنجیر کنید.

برای پشتیبانی از تحولات زنجیره ای ، URL های تحول Cloudinary به شما امکان می دهد تا چندین مؤلفه تحول را درج کنید ، هر کدام توسط یک برش ( /) جدا می شوند ، جایی که هر یک از مؤلفه های تحول در نتیجه قبلی اجرا می شود. SDK های Cloudinary می توانند با مشخص کردن پارامتر تحول و تنظیم آن بر روی آرایه ای از نقشه های تحول ، چندین مؤلفه تحول را اعمال کنند.

نمونه هایی با تصویر JPG بارگذاری شده به نام گل:

دو تحول زنجیره ای: در یک مربع 150px پر شده و سپس به یک دایره دور شوید:

چهار تحول زنجیره ای: محصول به 150x100 با جبران سفارشی از مرکز ، محصول را تا 130x100 پر کنید ، 20 درجه بچرخید و سپس به 80 ٪ کاهش یابد:

تحولات نامگذاری شده

یک تحول نامگذاری شده مجموعه ای از پیش تعریف شده از پارامترهای تحول است که برای مرجع آسان نام سفارشی داده شده است. به جای استفاده از هر یک از تحولات مورد نیاز به طور جداگانه در یک دارایی ، می توانید یک تحول نامگذاری شده را اعمال کنید تا تمام تحولات تعریف شده برای آن را اعمال کنید. این کار را آسان می کند:

• استفاده مجدد از تحولات در دارایی های متعدد
• URL های تحول پیچیده را کوتاه کنید
• جزئیات یک تحول را در URL تحویل خود پنهان کنید.
• فعال کردن/غیرفعال کردن تحولات را در حالت تحولات سخت ساده کنید.

تحولات نامگذاری شده می تواند شامل سایر تحولات نامگذاری شده باشد ، که به شما امکان می دهد زنجیره ای از تحولات را تعریف کنید تا راحت تر روی دارایی های مختلف اجرا شود.

شما می توانید با استفاده از ویرایشگر تحول یا سازنده تحول جدید (BETA) تحولات نامگذاری شده را از طریق API یا در UI کنسول ایجاد و مدیریت کنید.

پس از تعریف تحول نامگذاری شده ، می توانید یک دارایی را با پارامتر تحول (T برای URL) و نام تحول نامگذاری شده خود تبدیل کنید. به عنوان مثال t_instagram-auto-crop.

شما می توانید متغیرهای تعریف شده توسط کاربر را در تحولات نامگذاری شده خود قرار دهید و سپس مقدار متغیر تعریف شده توسط کاربر را از یک منبع خارجی به تبدیل منتقل کنید. این امر باعث ایجاد یک "الگوی" تحول نامگذاری شده با انعطاف پذیری زیادی می شود.

به عنوان مثال ، می توانید یک تحول به نام مجتمع را تعریف کنید که شامل یک پوشش متن به عنوان یک تغییر نامگذاری شده است ، با استفاده از یک متغیر تعریف شده توسط کاربر برای مقدار رشته متن.

همچنین می توانید تحول های نامگذاری شده را به عنوان پیش تنظیم تحول تنظیم کنید ، که به شما امکان می دهد پیش نمایش نحوه نگاه دارایی های کتابخانه رسانه خود را با تحولات مختلف نامگذاری شده اعمال کنید.

برای اطلاعات بیشتر ، به متغیرهای تعریف شده توسط کاربر مراجعه کنید. برای یک مثال استفاده که نشان دهنده تحولات نامگذاری شده با متغیرهای تعریف شده توسط کاربر است ، با یک متغیر تعریف شده توسط کاربر ، به تغییر نامگذاری شده مراجعه کنید.

• به روزرسانی تعریف تحول برای یک تحول نامگذاری شده از طریق API Admin به طور خودکار دارایی هایی را که قبلاً مشتق شده و با آن تحول نامگذاری شده است به روز نمی کند. برای استفاده از تعریف جدید در هر دارایی که قبلاً مشتق شده است که از آن تحول نامگذاری شده است ، باید به طور خاص آن تحولات را باطل کنید یا در غیر این صورت پارامترهای دیگر را در آن URL تحویل اصلاح کنید ، تا دارایی با استفاده از تعریف جدید دوباره بدست آید.

   

ایجاد تحولات نامگذاری شده

شما می توانید یک تحول نامگذاری شده را به صورت برنامه ای ایجاد کنید یا از UI Transformations در کنسول ابر خود استفاده کنید:

برای ایجاد یک تحول نامگذاری شده به صورت برنامه ای ، از روش API Admin Transformations استفاده کنید. مثال زیر یک تحول نامگذاری شده به نام small_profile_thumbnail را تعریف می کند که از برداشت خودکار برای تغییر اندازه دارایی ها به اندازه مورد نیاز برای صفحه نمایش کوچک یک برنامه خاص استفاده می کند:

برای اطلاعات بیشتر و مثال های بیشتر ، به روش ایجاد تبدیل در مرجع API ADMAN مراجعه کنید.

برای ایجاد یک تحول نامگذاری شده به صورت برنامه ای: صفحه تحول را باز کنید ، از منوی ناوبری محصول کنسول قابل دسترسی است.

از اینجا ، چند روش برای ایجاد یک تحول نامگذاری شده وجود دارد:

1. قبل از صرفه جویی در آن با نام انتخابی خود ، با یک دستور العمل کتاب آشپزی به عنوان یک الگوی شروع کنید و آن را به نیازهای خود اصلاح کنید.
2. لیستی از تمام تحولات پویا خود را مشاهده کنید (آنهایی که در پرواز تولید کرده اید و تحویل داده اید) و یکی از موارد را با نام انتخابی خود ذخیره کنید.
3. با استفاده از ویرایشگر تحول یا سازنده تحول (BETA) یک تحول جدید از ابتدا ایجاد کنید و با نام انتخابی خود ذخیره کنید.

• فقط باید دارای نویسه های معتبر UTF8 باشد
• نباید بیش از 1024 نویسه داشته باشد
• نباید شامل هیچ یک از این شخصیت ها باشد: ، / ،؟، و ، # ، ٪ ،.، ،

پس از ذخیره تحولات نامگذاری شده خود ، می توانید لیستی از آنها را در صفحه تحول های نامگذاری شده کنسول مشاهده کنید. از اینجا ، می توانید تحولات سخت را ویرایش ، کپی یا فعال کنید.

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

سازنده تحول (بتا)

سازنده تحول Cloudinary یک UI کاملاً جدید است که به شما کمک می کند تا تحولات خود را به روشی ساده و آسان برای استفاده ایجاد و ذخیره کنید. در اینجا برخی از ویژگی ها و عملکردی که می توانید با استفاده از سازنده بدست آورید:

• UI ساده و بصری برای انتخاب و پیکربندی اقدامات تحول - به راحتی در هنگام ساخت اقدامات و پارامترها را کشف کنید.
• تحولات ساخته شده به عنوان یک سری اقدامات خودگردان ، بنابراین می توانید نتایج هر یک را هنگام استفاده از آن مشاهده کنید.
• کد URL و SDK آماده کپی و چسباندن مستقیم در کد شما است.
• امکان به روزرسانی تصویر پیش فرض پیش فرض به چیزی از کتابخانه رسانه خود.

سازنده از متداول ترین اقدامات تحول پشتیبانی می کند. اگر اقدام تحول مورد نظر برای استفاده ذکر نشده است ، می توانید یک عمل "تحول اضافی" اضافه کنید و از نحو URL تحول استفاده کنید تا تحول خود را مشخص کنید. از طرف دیگر ، می توانید برای ایجاد تحول خود به ویرایشگر میراث تغییر دهید.

سازنده تحول در حال حاضر در بتا است. برخی از جزئیات اجرای ممکن است قبل از انتشار رسمی تغییر کند. سازنده ایجاد تحولات نامگذاری شده برای همه مشتریان جدید فعال است. دستورالعمل های زیر را دنبال کنید تا بررسی کنید که آیا در دسترس شما است یا خیر. اگر آن را فعال نکردید و به بتا دسترسی دارید ، درخواست پشتیبانی را برای ما ارسال کنید و ما آن را برای شما فعال خواهیم کرد.

با استفاده از سازنده یک تحول ایجاد کنید

برای ایجاد یک تحول جدید و تأیید دسترسی به سازنده Transformation ، به صفحه Transformations بروید و روی Add New کلیک کنید. در صورت فعال بودن ، باید UI جدید Transformation Builder UI را مشاهده کنید که می توانید شروع به اضافه کردن اقدامات و ایجاد تحول خود کنید. برای طعم و مزه آنچه انتظار دارید ، به تصویر زیر نگاهی بیندازید:

نمونه های تحول نامگذاری شده است

در زیر چند نمونه از استفاده از تحولات نامگذاری شده زیر که برای محیط محصول Demo Cloudinary تعریف شده است آورده شده است:

• jpg_with_quality_30: تصویر را با کیفیت 30 ٪ به jpeg تبدیل کنید.
• CROP_400X400: تصویر را به 400x400 با گرانش مرکز بردارید.
• fit_100x150: تصویر را در یک مستطیل 100x150 قرار دهید.

برای ایجاد نسخه ای از تصویر نمونه بر اساس تحول fit_100x150:

برای ایجاد تحولی که تحولات اضافی را به JPG_WOWT_QUATY_30 به نام تحول اعمال می کند ، مانند قرار دادن آن در عرض 100 پیکسل و ارتفاع 50 پیکسل:

زنجیره ای تحولات نامگذاری شده

همچنین می توانید چندین تحول نامگذاری شده را زنجیر کنید. به عنوان مثال ، برای زنجیر کردن سه تحول نامگذاری شده در بالا که در بالا تعریف کردیم:

تحولات زنجیره ای می تواند URL های طولانی ایجاد کند ، بنابراین در عوض می توانید یک تحول نامگذاری شده را تعریف کنید که شامل زنجیره ای از تحولات دیگر ، از جمله سایر تحولات نامگذاری شده است. به عنوان مثال ، ما می توانیم یک تحول نامگذاری شده ایجاد کنیم که کامپوزیتی از سه تحول نامگذاری شده است که در بالا توضیح داده شده است. اکنون ساده است که به جای آن یک تحول نامگذاری شده را مشخص کنید:

جایی که T_DEMO_COMBINED به صورت زیر تعریف شده است: T_JPG_WOWT_QUATION_30/T_CROP_400X400/T_FIT_100X150.

محدودیت تحولات نامگذاری شده

فرمت اتوماتیک

پارامتر تحول با فرمت اتوماتیک (F_AUTO) در صورت استفاده در تحولات نامگذاری شده مؤثر نیست.

هنگامی که از F_AUTO در URL تحویل استفاده می شود ، لایه CDN بهترین قالب برای تحویل را تعیین می کند. اگر این پارامتر در یک تحول نامگذاری شده پنهان باشد ، برای CDN قابل مشاهده نیست.

با زنجیر کردن اجزای ، می توانید از F_Auto به همراه یک تحول نامگذاری شده استفاده کنید ، به عنوان مثال T_Square/F_Auto.

کیفیت اتوماتیک

پارامتر تحول کیفیت اتوماتیک (Q_AUTO) در تحولات نامگذاری شده مؤثر است ، مگر در یک وضعیت.

هنگامی که Q_Auto در یک URL تحویل استفاده می شود و مرورگر عنوان Save-Data HTTP را در درخواست تنظیم می کند ، Q_Auto به Q_Auto ترجمه می شود: ECO در سطح CDN. اگر این پارامتر در یک تحول نامگذاری شده پنهان باشد ، برای CDN قابل مشاهده نیست ، بنابراین سطح پیش فرض اعمال می شود ، q_auto: خوب.

برای قرار دادن این وضعیت ، ممکن است ترجیح دهید با زنجیر کردن اجزای سازنده ، از Q_Auto به همراه یک تحول نامگذاری شده استفاده کنید ، به عنوان مثال T_Square/Q_Auto.

اگر به صراحت نوع کیفیت را برای اعمال در یک تحول نامگذاری شده تنظیم کنید ، به عنوان مثال ، Q_AUTO: بهترین ، پس هیچ نگرانی وجود ندارد زیرا هیچ وابستگی به سطح CDN وجود ندارد.

تعبیه تصاویر در صفحات وب با استفاده از SDK

You access uploaded images or their derived transformations with URLs. These URLs can be used as the of the tags in your HTML code or other frontend functions to deliver your media assets.

اما ساده ترین راه برای ارائه آنها استفاده از SDK های چارچوب Cloudinary برای تولید خودکار URL های تحول و جاسازی آنها با استفاده از برچسب های تصویر HTML است. SDK ها دو روش اصلی یاور را ارائه می دهند: یاور URL و یاور برچسب تصویر.

روش یاور URL ابر

روش یاور URL ابر (به عنوان مثال ، Cloudinary_url در Ruby/Rails SDK) به طور خودکار URL منبع تصویر را تولید می کند. به عنوان مثال ، با استفاده از روش یاور URL برای بازگشت URL تصویر نمونه ، که به عرض مقیاس یافته و ارتفاع 300 پیکسل با پس زمینه آبی برای بالشتک بسته بندی شده است:

این کد SDK URL را خروجی می کند:

روش یاور برچسب تصویر ابر

به طور پیش فرض ، روش یاور برچسب Cloudinary Tag (به عنوان مثال ، CL_IMAGE_TAG در Ruby on Rail) به طور خودکار برچسب تصویر HTML را شامل URL منبع تصویر تولید می کند.

موارد زیر همان تحولات فوق را نشان می دهد ، اما این بار با استفاده از برچسب تصویر برای تولید یک برچسب تصویر HTML کامل.

این کد SDK کد HTML زیر را وارد می کند:

روش Helper Tag Image Tag Cloud Inteage به شما امکان می دهد نه تنها پارامترهای تحول ابر را مشخص کنید ، بلکه همچنین ویژگی های منظم برچسب تصویر HTML را مشخص کنید (به عنوان مثال ، ALT ، عنوان ، عرض ، ارتفاع). به عنوان مثال ، با استفاده از روش HELPER TAG IMAGE برای ایجاد یک برچسب تصویر HTML برای تصویر نمونه ، با ویژگی "Alt" روی "یک عکس نمونه" و ویژگی "ClassName" تنظیم شده روی "نمونه ها" تنظیم شده است:

برای اطلاعات بیشتر در مورد این روشهای یاور SDK ، به مستندات تحول در راهنمای SDK مربوطه مراجعه کنید.

به طور کلی ، هنگام استفاده از SDK ، احتمالاً از نام پارامتر SDK برای بهبود خوانایی و نگهداری کد خود استفاده خواهید کرد. با این حال ، شما همچنین می توانید به صورت اختیاری یک پارامتر تحول خام را منتقل کنید ، که مقدار آن یک تعریف تحول URL تحت اللفظی است. توجه داشته باشید که رشته ای که به عنوان مقدار تحول خام عبور می کنید ، همانطور که در آن قرار دارد (بدون پردازش یا اعتبار سنجی) تا پایان هر پارامترهای تحول دیگر که در همان مؤلفه زنجیره تحول منتقل می شود ، ضمیمه می شود.

پشتیبانی از قالب تصویر

تصاویر را می توان در قالب های مختلف (قالب های ورودی) به Cloudinary بارگذاری کرد ، و می توانید به راحتی این تصاویر را برای نمایش در وب سایت یا برنامه (قالب های خروجی) به قالب های دیگر تبدیل کنید. نمونه هایی از موقعیت هایی که ممکن است بخواهید قالب تصویر تحویل داده شده را تغییر دهید:

• ارائه JPEG برای عکس هایی که می خواهید به سرعت بارگیری کنید (یا اگر کاربران شما در مرورگر هستند که از این یا برنامه تلفن همراه که کنترل می کنید ، پشتیبانی می کند).
• ارائه PNG (24 بیتی) برای تصاویر با کیفیت بالا با پیش زمینه شفاف.
• ارائه تصویری که در آن قالب اصلی برای تحویل توسط مرورگر پشتیبانی نمی شود. به عنوان مثال ، شما می توانید یک تصویر فتوشاپ (. psd) را به عنوان JPG ارائه دهید.

ارائه با فرمت متفاوت

می توانید با مشخص کردن قالب مورد نیاز به عنوان پسوند پرونده URL تحویل ، تصاویر را با فرمت متفاوت تبدیل و تحویل دهید. هنگام استفاده از SDK برای ساخت URL ، می توانید فرمت جدید را به شناسه عمومی دارایی اضافه کنید یا از پارامتر فرمت استفاده کنید.

به عنوان مثال ، برای نمایش یک نسخه GIF از پرونده JPEG نمونه بارگذاری شده:

می توانید سایر تحولات تصویر را با تبدیل قالب ترکیب کنید. فقط اطمینان حاصل کنید که فرمی که استفاده می کنید برای تحولات پشتیبانی می شود ، طبق جدول فرمت های تصویر پشتیبانی شده. به عنوان مثال ، برای ارائه نسخه GIF با 150x100 Down Down از تصویر نمونه:

گزینه دیگر برای تغییر قالب ، صریح تماس با پارامتر تبدیل fetch_format (F در URL) است. این می تواند در شرایطی مفید باشد که شما نمی توانید پسوند پرونده را تغییر دهید ، به عنوان مثال ، هنگام واکشی تصاویر از راه دور که از قبل دارای پسوند فایل دیگری (قالب) به عنوان بخشی از URL های خود هستند.

به عنوان مثال ، برای واکشی یک تصویر از راه دور از ویکی مدیا در قالب PNG ، و تصویر را با فرمت JPG تحویل دهید (همچنین به عرض 400 پیکسل کاهش یافته است):

• اگر پسوند پرونده در URL تحویل حذف شود ، پرونده در قالب بارگذاری شده در ابتدا تحویل داده می شود مگر اینکه یک فرمت خاص (یا فرمت خودکار با استفاده از پارامتر تبدیل Fetch_format (F_) درخواست شود).
• هنگام تبدیل از یک قالب تصویر چند صفحه ای یا چند لایه (PDF ، GIF ، WebP ، TIFF ، PSD) به دیگری ، فقط 100 صفحه اول در پرونده جدید گنجانده شده است.
• نسخه های اصلی SDK با انتشار اولیه دیرتر از ژانویه 2020 به جای پارامتر fetch_format دارای یک پارامتر تحول فرمت هستند. f (قالب) را در مرجع تحول مشاهده کنید.

f_auto

شما می توانید از تبدیل قالب اتوماتیک Cloudinary (F_AUTO) استفاده کنید تا به طور خودکار تصاویر را با بهینه ترین فرمت که توسط مرورگر درخواست کننده پشتیبانی می شود ، ارائه دهید.

به عنوان مثال ، اگر یک تصویر JPG را با F_AUTO تحویل دهید ، Cloudinary بسته به مرورگر درخواست کننده و تنظیم حساب خود ، ممکن است تصویر را به عنوان یک فایل وب ، AVIF یا JPEG-2000 تولید و تحویل دهد. الگوریتم F_AUTO به طور مشابه بهترین فرمت را ارائه می دهد که دارایی اصلی PNG (با یا بدون شفافیت) ، یک GIF متحرک و غیره باشد.

قالب های تصویر پشتیبانی شده

جدول زیر قالب های تصویر پشتیبانی شده را خلاصه می کند.

1. If a format is supported only for upload, then the delivery URL enables a user to download the original file in its original format, but you caot apply transformation parameters. If a format is supported for transformations, but the browser doesn't support displaying that format, you can either provide the transformation URL with the original format to enable users to download the file, or you can provide the URL with a different delivery format specified. In that case, Cloudinary applies the transformation to the original format and then converts the image to the requested format for delivery. For example, you could provide a transformation URL for a PhotoShop (.psd) image and specify jpg as the delivery format to display the resulting transformation in the browser. You can transform an InDesign file if you deliver it as an image format, such as jpg or png , but you caot deliver an indd file with transformations. By default, when you request a jp2 image with a quality value less than 90, chroma sub-sampling (420) is automatically applied using Kakadu. You can also explicitly request chroma sub-sampling as part of your quality parameter. For example: q_90>: 420. اگر پارامتر صفحه مشخص نشده باشد ، تمام لایه ها به یک تصویر واحد مسطح می شوند. انواع فرمت 3D به عنوان یک فایل ZIP بارگذاری می شوند. برخی از تحولات ، مانند تبدیل به یک فیلم یا تصویر ، بر روی بسته نرم افزاری به طور کلی پشتیبانی می شوند. در حال حاضر هیچ تحول در دارایی های موجود در آن پشتیبانی نمی شود. برای اطلاعات بیشتر به تحولات در مدل های سه بعدی مراجعه کنید. پرونده های USDZ فقط به عنوان پرونده های خام قابل بارگذاری هستند. تحولات را نمی توان در پرونده های USDZ اعمال کرد ، اما می توانید هر مدل سه بعدی بارگذاری شده را به عنوان یک فایل USDZ ارائه دهید. تصاویر تبدیل شده به AVIF و AVIF متحرک از سایر قالب ها از سهمیه اضافی استفاده می کنند. تصاویر بیش از 9 مگاپیکسل را نمی توان به AVIF رمزگذاری کرد - اطمینان حاصل کنید که ابتدا آنها را در مقیاس قرار می دهید. در صورت فعال بودن ، ممکن است هنگام استفاده از انتخاب خودکار فرمت (F_AUTO) از AVIF (اما AVIF انیمیشن) تحویل داده شود. شما نمی توانید یک مدل سه بعدی با فرمت متفاوت را به FBX یا OBJ تبدیل کنید.

    

انواع تحول تصویر

این صفحه شما را از طریق اصول اولیه عملکرد تحولات تصویر طی کرد. بقیه صفحات موجود در این راهنما جزئیات ، استفاده از موارد و نمونه هایی از انواع مختلفی از تحولات را که می توانید برای تصاویری که ارائه می دهید استفاده می کنند:

ارائه رسانه های بهینه و پاسخگو

علاوه بر تغییر ظاهر دارایی های رسانه ای خود با تبدیل آنها ، می توانید از URL های ابر و انواع پارامترهای مختلف برای کنترل نحوه تحویل آنها نیز استفاده کنید: