Küçük resim görüntülerini yeniden boyutlandırma ve kırpma

Makale
07/08/2019

Uyarı

30 Ekim 2020'de Bing Arama API'leri Azure yapay zeka hizmetlerinden Bing Arama Hizmetlerine taşındı. Bu belgeler yalnızca başvuru için sağlanır. Güncelleştirilmiş belgeler için Bing arama API'sinin belgelerine bakın. Bing araması için yeni Azure kaynakları oluşturma yönergeleri için bkz. Azure Market aracılığıyla Bing Arama kaynağı oluşturma.

Bing Arama API'lerinden bazı yanıtlar, Bing tarafından sunulan, yeniden boyutlandırıp kırpabileceğiniz ve sorgu parametreleri içerebilen küçük resimlerin URL'lerini içerir. Örnek:

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

Bu küçük resimlerin bir alt kümesini görüntülerseniz, kalan görüntüleri görüntüleme seçeneği sağlayın.

Not

Küçük resim görüntülerini kırpmanın ve yeniden boyutlandırmanın, Bing Arama API kullanımı ve görüntüleme gereksinimlerinin gerektirdiği şekilde üçüncü taraf haklarına uyan bir arama senaryosu sağlayacağından emin olun.

Küçük resmi yeniden boyutlandırma

Bing, küçük resmi yeniden boyutlandırmak için küçük resmin URL'sinde yalnızca bir w (genişlik) veya h (yükseklik) sorgu parametresi belirtmenizi önerir. Yalnızca yükseklik veya genişlik belirtilmesi, Bing'in görüntünün özgün yönünü korumasını sağlar. Genişliği ve yüksekliği piksel cinsinden belirtin.

Örneğin, özgün küçük resim 480x620 ise:

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

Boyutunu küçültmek, parametresini yeni bir değere ayarlamak w (örneğin 336) ve parametresini h kaldırmak istiyorsunuz:

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

Küçük resmin yalnızca yüksekliğini veya genişliğini belirtirseniz, görüntünün özgün en boy oranı korunur. Her iki parametreyi de belirtirseniz ve en boy oranı korunmazsa, Bing görüntünün kenarlığını beyaz doldurmaya ekler.

Örneğin, kırpmadan 480x359 görüntüsünü 200x200 olarak yeniden boyutlandırdığınızda, tam genişlik görüntüyü içerir, ancak yükseklik resmin üstünde ve altında 25 piksel beyaz doldurma içerir. Görüntü 359x480 ise, sol ve sağ kenarlıklar beyaz doldurma içeriyor olurdu. Resmi kırptığınızda beyaz doldurma eklenmez.

Aşağıdaki resimde küçük resim görüntüsünün özgün boyutu (480x300) gösterilmektedir.

Özgün yatay resim

Aşağıdaki resimde 200x200 olarak yeniden boyutlandırılmış resim gösterilmektedir. En boy oranı korunur ve üst ve alt kenarlıklar beyazla doldurulur (doldurmayı göstermek için buradaki siyah kenarlık dahil edilir).

Yeniden boyutlandırılmış yatay resim

Resmin özgün genişliği ve yüksekliğinden daha büyük boyutlar belirtirseniz, Bing sol ve üst kenarlıklara beyaz dolgu ekler.

Farklı küçük resim boyutları isteme

Farklı bir küçük resim görüntüsü boyutu istemek için ve parametreleri dışında idpid küçük resmin URL'sinden tüm sorgu parametrelerini kaldırın. Ardından istenen görüntü boyutuna (width) veya &h (height) sorgu parametresini piksel olarak ekleyin &w , ancak ikisini birden eklemeyin. Bing, görüntünün özgün en boy oranını korur.

Yukarıdaki URL tarafından belirtilen görüntünün genişliğini 165 piksele yükseltmek için aşağıdaki URL'yi kullanabilirsiniz:

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

Resmin özgün boyutundan daha büyük bir görüntü isterseniz, Bing gerektiğinde resmin çevresine beyaz doldurma ekler. Örneğin, görüntünün özgün boyutu 474x316 ise ve siz 500 olarak ayarlarsanız &w , Bing 500x333 görüntüsü döndürür. Bu görüntüde üst ve alt kenarlar boyunca 8,5 piksel beyaz doldurma, sol ve sağ kenarlarda ise 13 piksel doldurma olacaktır.

İstenen boyut görüntünün özgün boyutundan büyükse Bing'in beyaz doldurma eklemesini önlemek için sorgu parametresini &p 0 olarak ayarlayın. Örneğin, yukarıdaki URL'ye parametresini &p=0 eklerseniz, Bing 500x333 görüntüsü yerine 474x316 görüntüsü döndürür:

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

Hem &h hem de &w sorgu parametrelerini belirtirseniz, Bing görüntünün en boy oranını korur ve gerektiğinde beyaz doldurma ekler. Örneğin, görüntünün özgün boyutu 474x316 ise ve genişlik ve yükseklik parametrelerini 200x200 ()&w=200&h=200 olarak ayarlarsanız, Bing üstte ve altta 33 piksel beyaz doldurma içeren bir görüntü döndürür. Sorgu parametresini &p eklerseniz, Bing bir 200x134 görüntüsü döndürür.

Küçük resmi kırpma

Görüntüyü kırpmak için (kırpma) sorgu parametresini ekleyin c . Aşağıdaki değerleri kullanabilirsiniz:

4 — Kör Oran
7 — Akıllı Oran

Akıllı Oran kırpma

Akıllı Oran kırpması isterseniz (parametresini c7olarak ayarlayarak), Bing bir görüntüyü ilgilendiği bölgenin merkezinden dışa doğru kırparak görüntünün en boy oranını korur. İlgi alanı, Bing'in en çok içeri aktarılan parçaları içerdiğini belirlediğini görüntünün alanıdır. Aşağıda ilgi çekici örnek bir bölge gösterilmektedir.

İlgi bölgesi

Bir görüntüyü yeniden boyutlandırıp Akıllı Oran kırpması isterseniz, Bing en boy oranını korurken görüntüyü istenen boyuta düşürür. Bing daha sonra yeniden boyutlandırılan boyutlara göre görüntüyü kırpıyor. Örneğin, yeniden boyutlandırılan genişlik yükseklik değerinden küçük veya buna eşitse, Bing görüntüyü ilgilendiğin bölgenin merkezinin solunda ve sağından kırpacaktır. Aksi takdirde, Bing ilgi bölgesinin merkezinin en üstüne ve altına kırpacaktır.

Aşağıda, Akıllı Oran kırpma kullanılarak görüntü 200x200'e düşürülmüştür. Bing, görüntüyü sol üst köşeden ölçteği için görüntünün alt kısmı kırpılır.

200x200'e kırpılan yatay resim

Aşağıda, Akıllı Oran kırpma kullanılarak görüntü 200x100'e düşürülmüştür. Bing, görüntüyü sol üst köşeden ölçteği için görüntünün alt kısmı kırpılır.

200x100'e kırpılan yatay resim

Aşağıda, Akıllı Oran kırpma kullanılarak görüntü 100x200'e düşürülmüştür. Bing görüntüyü merkezden ölçteğinden, görüntünün sol ve sağ bölümleri kırpılır.

100x200'e kırpılan yatay resim

Bing görüntünün ilgilendiği bölgeyi belirleyemezse, hizmet Kör Oran kırpmasını kullanır.

Kör Oran kırpması isterseniz (parametresini c4olarak ayarlayarak), Bing görüntüyü kırpmak için aşağıdaki kuralları kullanır.

ise (Original Image Width / Original Image Height) < (Requested Image Width / Requested Image Height), görüntü sol üst köşeden ölçülür ve altta kırpılır.
ise (Original Image Width / Original Image Height) > (Requested Image Width / Requested Image Height), görüntü merkezden ölçülür ve sola ve sağa doğru kırpılır.

Aşağıda 225x300 olan dikey bir resim gösterilmektedir.

Özgün ayçiçeği görüntüsü