قص صورة إلى مربع محدد

تستقبل هذه الأداة عرض الصورة المصدر وارتفاعها، إلى جانب مربع قص تحدده قيم x وy والعرض والارتفاع. وهي تفحص كل قيمة، وتتأكد من بقاء المستطيل كاملًا داخل الصورة، ثم تعيد أبعاد الجزء المقصوص عندما يكون المربع صالحًا. لا يلزم رفع الصورة أو فك ترميزها، ولذلك يمكنكم استخدامها قبل تشغيل معالج صور، أو إنشاء معاينة للقص، أو قبول إحداثيات واردة من خدمة أخرى.

حددوا الصورة المصدر ومربع القص

ابدؤوا بأبعاد الصورة الأصلية بالبكسل. ضعوا في image_width العدد الإجمالي للبكسلات أفقيًا، وفي image_height العدد الإجمالي للبكسلات عموديًا. بعد ذلك صفوا المستطيل بالقيم x وy وwidth وheight. تحدد x وy موضع الزاوية العلوية اليسرى للمربع نسبة إلى الزاوية العلوية اليسرى للصورة، وإحداثياتها 0,0. يمتد width نحو اليمين ويمتد height نحو الأسفل. يجب أن تكون القيم الست أعدادًا صحيحة لأن الأداة تتعامل مع قص صورة نقطية بمحاذاة البكسلات، لا مع هندسة كسرية. يجب أن تكون أبعاد الصورة والقص موجبة، بينما يجوز أن تكون x وy صفرًا. فمثلًا، تعني القيمة 240 في x تجاوز أول 240 عمودًا من البكسلات قبل بدء القص. يمكن للمربع أن يلامس أي حافة تمامًا؛ لذلك يجوز أن يساوي مجموع x وwidth قيمة image_width، وأن يساوي مجموع y وheight قيمة image_height. استخدموا أبعاد ملف الصورة نفسه الذي سيُقص، وحولوا إحداثيات المعاينة المصغرة إلى مقياس الصورة الأصلية أولًا.

افهموا كيفية التحقق من الحدود

ترفض الأداة أولًا القيم الناقصة، والأعداد غير الصحيحة، والإحداثيات السالبة، والمربعات عديمة المساحة، والقيم الخارجة عن النطاق الموثق. ثم تفحص الحدين اللذين يحددان احتواء المستطيل. أفقيًا، يجب أن يكون مجموع x وwidth أقل من image_width أو مساويًا له. وعموديًا، يجب أن يكون مجموع y وheight أقل من image_height أو مساويًا له. إذا كان أحد المجموعين أكبر، وقع جزء من القص خارج الصورة المصدر وأعاد الطلب خطأ إدخال غير صالح. تمنع هذه القاعدة الواضحة التباسًا شائعًا بمقدار وحدة واحدة: فالقص الذي عرضه 100 بكسل ويبدأ عند x بقيمة 0 يشغل امتدادًا كاملًا قدره 100 بكسل، ولذلك يلائم تمامًا صورة عرضها 100 بكسل. لا تقيد الأداة المربع غير الصالح ولا تحركه ولا تصغره، لأن تغيير الإحداثيات بصمت قد ينتج موضوعًا أو تكوينًا مختلفًا. كما أنها لا تفحص بيانات الصورة نفسها. يعتمد القرار فقط على الأبعاد والإحداثيات المقدمة، فيكون سريعًا وقابلًا للتكرار ومناسبًا للنماذج التفاعلية ومسارات العمل الآلية.

استخدموا النتيجة قبل تنفيذ القص

تعيد الاستجابة الناجحة عرض الجزء الناتج وارتفاعه. تطابق هاتان القيمتان المربع المطلوب لأن هذه الأداة تتحقق من الهندسة ولا تعيد أخذ العينات ولا تغير المستطيل. استخدموا الاستجابة كحاجز أمان قبل تمرير الإحداثيات نفسها إلى مكتبة صور أو خدمة وسائط أو مهمة تصيير في قائمة انتظار. وبذلك تفصلون التحقق قليل التكلفة عن فك ترميز الصورة الأعلى تكلفة، وتمنعون أخطاء الحدود المتوقعة من الوصول إلى العمليات اللاحقة. في محرر القص، نفذوا التحقق بعد تأكيد التحديد أو بعد تحويل إحداثيات المعاينة إلى بكسلات الصورة الأصلية. وفي مسار البيانات، افحصوا بيانات القص الوصفية فور وصولها ووجهوا السجلات غير الصالحة إلى التصحيح. انتبهوا إلى الاتجاه: إذا أدارت خطوة أخرى الصورة فعليًا، فاستخدموا الأبعاد بعد التدوير وإحداثيات معبرًا عنها بالاتجاه نفسه. تبلغ تكلفة طلب API مقدار $0.002؛ وينفذ مشغل المتصفح الحساب الحتمي نفسه محليًا. لا يرفع أي من المسارين صورة، لأن الإجابة تحتاج إلى الهندسة الرقمية وحدها.