Změna velikosti a oříznutí miniatur obrázků

Upozornění

30. října 2020 se rozhraní API pro vyhledávání Bing přesunula ze služeb Cognitive Services na Bing Search Services. Tato dokumentace je k dispozici pouze pro referenci. Aktualizovanou dokumentaci najdete v dokumentaci k rozhraní API pro vyhledávání Bing. Pokyny k vytváření nových prostředků Azure pro vyhledávání Bing najdete v tématu Vytvoření Bing vyhledávacího prostředku prostřednictvím Azure Marketplace.

Některé odpovědi z rozhraní API pro vyhledávání Bing zahrnují adresy URL na miniatury obrázků obsluhované Bing, které můžete změnit velikost a oříznutí a mohou obsahovat parametry dotazu. Příklad:

https://<host>/th?id=AMMS_92772df988...&w=110&h=73&rs=1&qlt=80&cdv=1&pid=16.1

Pokud zobrazíte podmnožinu těchto miniatur, můžete zobrazit zbývající obrázky.

Poznámka

Ujistěte se, že oříznutí a změna velikosti obrázků miniatur poskytne scénář hledání, který respektuje práva třetích stran podle požadavků na Bing rozhraní API pro vyhledávání a zobrazení.

Změna velikosti miniatury

Pokud chcete změnit velikost miniatury, Bing doporučuje zadat pouze jeden w parametr dotazu (šířka) nebo h (výška) v adrese URL miniatury. Určení pouze výšky nebo šířky umožňuje Bing zachovat původní aspekt obrázku. Zadejte šířku a výšku v pixelech.

Pokud je například původní miniatura 480x620:

https://<host>/th?id=JN.5l3yzwy%2f%2fHj59U6XhssIQ&pid=Api&w=480&h=620

A chcete zmenšit jeho velikost, nastavte w parametr na novou hodnotu (například 336) a odeberte h parametr:

https://<host>/th?id=JN.5l3yzwy%2f%2fHj59U6XhssIQ&pid=Api&w=336

Pokud zadáte jenom výšku nebo šířku miniatury, zachová se původní poměr stran obrázku. Pokud zadáte oba parametry a poměr stran není zachován, Bing přidá na okraj obrázku bílé odsazení.

Pokud například změníte velikost obrázku 480x359 na 200x200 bez oříznutí, bude celá šířka obsahovat obrázek, ale výška bude obsahovat 25 pixelů bílé odsazení v horní a dolní části obrázku. Pokud je obrázek 359x480, levé a pravé ohraničení by obsahovalo bílé odsazení. Pokud obrázek oříznete, nepřidá se bílé odsazení.

Následující obrázek ukazuje původní velikost miniatury (480x300).

Original landscape image

Následující obrázek ukazuje velikost obrázku na 200x200. Poměr stran je zachován a horní a dolní ohraničení jsou vycpané bílou (černé ohraničení je zde zahrnuto, aby se zobrazil odsazení).

Resized landscape image

Pokud zadáte rozměry větší než původní šířka a výška obrázku, Bing přidá do levého a horního ohraničení bílé odsazení.

Vyžádání různých velikostí miniatur

Pokud chcete požádat o jinou velikost obrázku miniatur, odeberte všechny parametry dotazu z adresy URL miniatury s výjimkou id parametrů a pid parametrů. Potom přidejte &w parametr dotazu (šířka) nebo &h (výška) s požadovanou velikostí obrázku v pixelech, ale ne obojí. Bing zachová původní poměr stran obrázku.

Pokud chcete zvětšit šířku obrázku určeného výše uvedenou adresou URL na 165 pixelů, použijte následující adresu URL:

https://<host>/th?id=AMMS_92772df988...&w=165&pid=16.1

Pokud si vyžádáte obrázek, který je větší než původní velikost obrázku, Bing podle potřeby přidá kolem obrázku bílé odsazení. Pokud je například původní velikost obrázku 474x316 a nastavíte &w na 500, Bing vrátí obrázek 500x333. Tento obrázek bude mít 8,5 pixelů bílé odsazení podél horních a dolních okrajů a 13 pixelů odsazení na levých a pravých hranách.

Pokud chcete zabránit tomu, aby Bing přidávat bílé odsazení, pokud je požadovaná velikost větší než původní velikost obrázku, nastavte &p parametr dotazu na hodnotu 0. Pokud například zahrnete &p=0 parametr do výše uvedené adresy URL, Bing místo obrázku 500x333 vrátí obrázek 474x316:

https://<host>/th?id=AMMS_92772df988...&w=500&p=0&pid=16.1

Pokud zadáte parametry obou &w i &h dotazů, Bing zachová poměr stran obrázku a podle potřeby přidá bílé odsazení. Pokud je například původní velikost obrázku 474x316 a nastavíte parametry šířky a výšky na 200x200 (&w=200&h=200), Bing vrátí obrázek, který obsahuje 33 pixelů bílé odsazení v horní a dolní části. Pokud zahrnete &p parametr dotazu, Bing vrátí image 200x134.

Oříznutí miniatury

Pokud chcete obrázek oříznout, zadejte c parametr dotazu (oříznout). Můžete použít následující hodnoty:

  • 4 — Slepý poměr
  • 7 — Inteligentní poměr

Oříznutí inteligentního poměru

Pokud požadujete oříznutí inteligentního poměru (nastavením parametru c na 7), Bing ořízne obrázek ze středu oblasti zájmu směrem ven a přitom zachová poměr stran obrázku. Oblast zájmu je oblast obrázku, který Bing určuje, že obsahuje nejvíce importovaných částí. Následující příklad ukazuje oblast zájmu.

Region of interest

Pokud změníte velikost obrázku a vyžádáte oříznutí inteligentního poměru, Bing obrázek sníží na požadovanou velikost při zachování poměru stran. Bing pak obrázek ořezá na základě velikostí. Pokud je například změněná šířka menší nebo rovna výšce, Bing obrázek ořízne doleva a vpravo od středu oblasti zájmu. V opačném případě Bing ji ořízne na horní a dolní část středu oblasti zájmu.

Následující obrázek ukazuje zmenšení na 200x200 pomocí oříznutí Smart Ratio. Vzhledem k tomu, že Bing měří obrázek z levého horního rohu, ořízne se dolní část obrázku.

Landscape image cropped to 200x200

Následující obrázek ukazuje zmenšení na 200x100 pomocí oříznutí inteligentního poměru. Vzhledem k tomu, že Bing měří obrázek z levého horního rohu, ořízne se dolní část obrázku.

Landscape image cropped to 200x100

Následující obrázek ukazuje zmenšení na 100x200 pomocí oříznutí Smart Ratio. Vzhledem k tomu, že Bing měří obrázek ze středu, oříznou se levé a pravé části obrázku.

Landscape image cropped to 100x200

Pokud Bing nemůže určit oblast zájmu obrázku, služba bude oříznout nevidomý poměr.

Oříznutí slepého poměru

Pokud požadujete oříznutí slepého poměru (nastavením parametru c na 4), Bing použije k oříznutí obrázku následující pravidla.

  • Pokud (Original Image Width / Original Image Height) < (Requested Image Width / Requested Image Height)se obrázek měří z levého horního rohu a ořízne se v dolní části.
  • Pokud (Original Image Width / Original Image Height) > (Requested Image Width / Requested Image Height)se obrázek měří ze středu a ořízne doleva a doprava.

Následuje obrázek na výšku, který je 225x300.

Original sunflower image

Následující obrázek ukazuje zmenšení na 200x200 pomocí oříznutí slepého poměru. Obrázek se měří z levého horního rohu, což vede k oříznutí dolní části obrázku.

Sunflower image cropped to 200x200

Následující obrázek ukazuje zmenšení na 200x100 pomocí oříznutí slepého poměru. Obrázek se měří z levého horního rohu, což vede k oříznutí dolní části obrázku.

Sunflower image cropped to 200x100

Následující obrázek ukazuje zmenšení na 100x200 pomocí oříznutí slepého poměru. Obrázek se měří ze středu, což vede k oříznutí levé a pravé části obrázku.

Sunflower image cropped to 100x200

Další kroky