INTEGRITY Dokumentace

← Images / images / optimization / hosted-images

Vytvoření předdefinovaných variant

Varianty umožňují určit, jak se mají obrázky měnit velikostí pro různé případy použití. Ve výchozím nastavení se obrázky doručují s public varianta, ale můžete vytvořit až 100 variant podle svých potřeb. Variantu vytvoříte podle následujících kroků.

  1. V dashboardu Cloudflare přejděte na Hostované obrázky stránce.

    Přejděte na Hostované obrázky ↗

  2. Vyberte Doručování kartě.

  3. Vyberte Vytvoření varianty.

  4. Pojmenujte svou variantu a vyberte Vytvořit.

  5. Definujte proměnné pro novou variantu, například možnosti změny velikosti, typ přizpůsobení (fit) a konkrétní možnosti metadat.

Změna velikosti přes API

Vytvořte POST požadavek na vytvořit variantu.

curl "https://api.cloudflare.com/client/v4/accounts/{account_id}/images/v1/variants" \
--header "Authorization: Bearer <API_TOKEN>" \
--header "Content-Type: application/json" \
--data '{"id":"<NAME_OF_THE_VARIANT>","options":{"fit":"scale-down","metadata":"none","width":1366,"height":768},"neverRequireSignedURLs":true}

Možnosti Fit

Fit určuje, jak se mají interpretovat rozměry šířky a výšky. Následující tabulka popisuje jednotlivé možnosti.

Možnosti Fit Chování
Zmenšení Velikost obrázku se zmenší tak, aby se plně vešel do zadané šířky nebo výšky, ale nezvětší se.
Contain Velikost obrázku se změní (zmenší nebo zvětší) tak, aby byl co největší v rámci zadané šířky nebo výšky při zachování poměru stran.
Cover Velikost obrázku se změní tak, aby přesně vyplnil celou oblast danou šířkou a výškou, a v případě potřeby se ořízne.
Crop Obrázek se zmenší a ořízne tak, aby se vešel do oblasti dané šířkou a výškou. Obrázek se nezvětší. U obrázků menších, než jsou zadané rozměry, je to totéž jako scale-down. U obrázků větších, než jsou zadané rozměry, se chová stejně jako cover.
Pad Velikost obrázku se změní (zmenší nebo zvětší) tak, aby byl co největší v rámci zadané šířky nebo výšky při zachování poměru stran. Zbývající plocha se vyplní barvou pozadí (výchozí je bílá).

Možnosti metadat

Varianty vám umožňují určit, co se stane s metadaty obrázku. V Metadata rozevírací nabídce zvolte:

Veřejný přístup

Když Vždy povolit veřejný přístup je vybraná, konkrétní varianty budou vždy veřejně přístupné, i když jsou obrázky nastaveny jako soukromé pomocí podepsané URL adresy.