تغيير حجم الصور المصغّرة وقصها
تحذير
في 30 أكتوبر 2020، انتقلت واجهات برمجة التطبيقات بحث Bing من خدمات Azure الذكاء الاصطناعي إلى خدمات بحث Bing. تتوفر هذه الوثائق للرجوع إليها فحسب. للحصول على وثائق محدثة، راجع الوثائق الخاصة ببحث Bing API . للحصول على إرشادات حول إنشاء موارد Azure جديدة لبحث Bing، راجع إنشاء مورد بحث Bing من خلال Azure Marketplace.
تتضمن بعض الإجابات من واجهات برمجة تطبيقات بحث Bing عناوين URL للصور المصغّرة التي يقدمها Bing، والتي يمكنك تغيير حجمها وقصها، وقد تحتوي على معلمات الاستعلام. على سبيل المثال:
https://<host>/th?id=AMMS_92772df988...&w=110&h=73&rs=1&qlt=80&cdv=1&pid=16.1
إذا قمت بعرض مجموعة فرعية من هذه الصور المصغّرة، فوفّر خياراً لعرض الصور المتبقية.
ملاحظة
سيوفر التأكد من أن قص الصور المصغّرة وتغيير حجمها سيناريو بحث يحترم حقوق الجهات الأخرى، كما هو مطلوب من قِبل متطلبات الاستخدام والعرض لواجهة برمجة تطبيقات بحث Bing.
تغيير حجم صورة مصغّرة
لتغيير حجم صورة مصغّرة، يوصي Bing بتحديد معلمة استعلام واحدة فقط من w (العرض) أو h (الارتفاع) في عنوان URL الخاص بالصورة المصغّرة. يتيح تحديد الارتفاع أو العرض فقط لـ Bing الحفاظ على الجانب الأصلي للصورة. حدد العرض والارتفاع بالبكسل.
على سبيل المثال، إذا كانت الصورة المصغّرة الأصلية بحجم 480x620:
https://<host>/th?id=JN.5l3yzwy%2f%2fHj59U6XhssIQ&pid=Api&w=480&h=620
وتريد إنقاص حجمها، وضبط المعلمة w على قيمة جديدة (مثل 336)، وإزالة المعلمة h:
https://<host>/th?id=JN.5l3yzwy%2f%2fHj59U6XhssIQ&pid=Api&w=336
إذا قمت بتحديد ارتفاع الصورة المصغّرة أو عرضها فقط، فسيتم الحفاظ على نسبة العرض إلى الارتفاع الأصلية للصورة. إذا حددت كلتا المعلمتين، ولم يتم الاحتفاظ بنسبة العرض إلى الارتفاع، فسيضيف Bing مساحة بيضاء إلى حد الصورة.
على سبيل المثال، إذا قمت بتغيير حجم صورة 480x359 إلى 200x200 دون قص، فسيحتوي العرض الكامل على الصورة ولكن الارتفاع سيحتوي على 25 بكسل من المساحة البيضاء في أعلى الصورة وأسفلها. إذا كانت الصورة بحجم 359x480، فستحتوي الحدود اليسرى واليمنى على مساحة بيضاء. إذا قمت بقص الصورة، فلن تتم إضافة المساحة البيضاء.
تعرض الصورة التالية الحجم الأصلي لصورة مصغّرة (480x300).
تعرض الصورة التالية الصورة التي تم تغيير حجمها إلى 200x200. يتم الحفاظ على نسبة العرض إلى الارتفاع وتتم إضافة مساحة إلى الحدود العلوية والسفلية باللون الأبيض (يتم تضمين الحد الأسود هنا لإظهار المساحة البيضاء).
إذا حددت أبعاداً أكبر من العرض والارتفاع الأصليين للصورة، فسيضيف Bing مساحة بيضاء إلى الحدود اليسرى والعلوية.
طلب أحجام صور مصغّرة مختلفة
لطلب حجم صورة مصغّرة مختلف، قم بإزالة جميع معلمات الاستعلام من عنوان URL للصورة المصغّرة، باستثناء المعلمتين id وpid. ثم أضف إما معلمة الاستعلام من &w (العرض) أو &h (الارتفاع) بحجم الصورة المطلوب بالبكسل، ولكن ليس كليهما. سيحافظ Bing على نسبة العرض إلى الارتفاع الأصلية للصورة.
لزيادة عرض الصورة المحددة بواسطة عنوان URL أعلاه إلى 165 بكسل، يمكنك استخدام عنوان URL التالي:
https://<host>/th?id=AMMS_92772df988...&w=165&pid=16.1
إذا طلبت صورة أكبر من الحجم الأصلي للصورة، يضيف Bing مساحة بيضاء حول الصورة حسب الحاجة. على سبيل المثال، إذا كان الحجم الأصلي للصورة هو 474x316 وقمت بضبط &w إلى 500، فسيعمل Bing على الإرجاع إلى صورة بحجم 500x333. ستتوفر هذه الصورة بمساحة 8.5 بكسل من المساحة البيضاء على طول الحواف العلوية والسفلية، و13 بكسل من المساحة على الحواف اليسرى واليمنى.
لمنع Bing من إضافة مساحة بيضاء إذا كان الحجم المطلوب أكبر من الحجم الأصلي للصورة، قم بضبط معلمة الاستعلام &p على 0. على سبيل المثال، إذا قمت بإدراج المعلمة &p=0 في عنوان URL أعلاه، فسيعمل Bing على الإرجاع إلى صورة بحجم 474x316 بدلاً من صورة بحجم 500x333:
https://<host>/th?id=AMMS_92772df988...&w=500&p=0&pid=16.1
إذا قمت بتحديد معلمات الاستعلام &w و&h كليهما، فسيحافظ Bing على نسبة العرض إلى الارتفاع للصورة ويضيف مساحة بيضاء حسب الحاجة. على سبيل المثال، إذا كان الحجم الأصلي للصورة هو 474x316 وقمت بضبط معلمات العرض والارتفاع إلى 200x200 (&w=200&h=200)، يقوم Bing بإرجاع صورة تحتوي على 33 بكسل من المساحة البيضاء في الأعلى والأسفل. إذا قمت بتضمين معلمة الاستعلام &p، فإن Bing ترجع إلى صورة بحجم 200x134.
قص صورة مصغّرة
لقص صورة، قم بإدراج معلمة الاستعلام c (القص). يمكنك استخدام القيم التالية:
4- النسبة الخفية7- النسبة الذكية
القص بالنسبة الذكية
إذا طلبت القص بالنسبة الذكية (عن طريق ضبط المعلمة c على 7)، فسيقوم Bing بقص صورة من وسط منطقة الاهتمام فيها إلى الخارج، مع الحفاظ على نسبة العرض إلى الارتفاع للصورة. منطقة الاهتمام هي منطقة الصورة التي يحددها Bing والتي تحتوي على معظم أجزاء الاستيراد. يوضح ما يلي مثالاً على منطقة الاهتمام.
إذا قمت بتغيير حجم صورة وطلب القص بالنسبة الذكية، فإن Bing يقلل الصورة إلى الحجم المطلوب مع الحفاظ على نسبة العرض إلى الارتفاع. ثم يقوم Bing بقص الصورة حسب الأبعاد التي تم تغيير حجمها. على سبيل المثال، إذا كان العرض الذي تم تغيير حجمه أقل من الارتفاع أو مساوياً له، فسيقص Bing الصورة إلى يسار ويمين مركز منطقة الاهتمام. وإلا سيقوم Bing بقصها إلى أعلى وأسفل مركز منطقة الاهتمام.
يوضح المثال التالي الصورة التي تم إنقاصها إلى 200x200 باستخدام القص بالنسبة الذكية. نظرًا لأن Bing يقيس الصورة من الزاوية العلوية اليسرى، يتم قص الجزء الأسفل من الصورة.
يوضح المثال التالي الصورة التي تم إنقاصها إلى 200x100 باستخدام القص بالنسبة الذكية. نظرًا لأن Bing يقيس الصورة من الزاوية العلوية اليسرى، يتم قص الجزء الأسفل من الصورة.
يوضح المثال التالي الصورة التي تم إنقاصها إلى 100x200 باستخدام القص بالنسبة الذكية. نظراً لأن Bing يقيس الصورة من المركز، يتم قص الأجزاء اليمنى واليسرى من الصورة.
إذا لم يتمكن Bing من تحديد منطقة اهتمام الصورة، فستستخدم الخدمة القص بالنسبة الخفية.
القص بالنسبة الخفية
إذا طلبت القص بالنسبة الخفية (عن طريق ضبط المعلمة c على 4)، يستخدم Bing القواعد التالية لقص الصورة.
- إذا كان
(Original Image Width / Original Image Height) < (Requested Image Width / Requested Image Height)، يتم قياس الصورة من الزاوية العلوية اليسرى وقصها في الأسفل. - إذا كان
(Original Image Width / Original Image Height) > (Requested Image Width / Requested Image Height)، يتم قياس الصورة من المركز وقصها إلى اليسار واليمين.
يعرض المثال التالي صورة عمودية بحجم 225x300.
يوضح المثال التالي الصورة التي تم إنقاصها إلى 200x200 باستخدام القص بالنسبة الخفية. يتم قياس الصورة من الزاوية العلوية اليسرى، ما يؤدي إلى قص الجزء الأسفل من الصورة.
يوضح المثال التالي الصورة التي تم إنقاصها إلى 200x100 باستخدام القص بالنسبة الخفية. يتم قياس الصورة من الزاوية العلوية اليسرى، ما يؤدي إلى قص الجزء الأسفل من الصورة.
يوضح المثال التالي الصورة التي تم إنقاصها إلى 100x200 باستخدام القص بالنسبة الخفية. يتم قياس الصورة من المركز، ما يؤدي إلى قص الأجزاء اليمنى واليسرى من الصورة.
