لماذا تظهر الصورة مقلوبة بعد التصغير؟ طبّق اتجاه EXIF قبل إنشاء المعاينة
في الاختبار المحلي أرجع النهج المعيب المقاس (4,2)، وأرجع المسار المصحح (2,4)، من عينة JPEG اصطناعية أبعادها المخزنة 8×4 وتحمل Orientation=6 مع حد تصغير 4. لم نختبر ملف هاتف أو متصفحاً؛ الصورة الرئيسية مشهد توضيحي لكاميرا ومطبوعتين لنبات، وليست مخرج الكود. ما تغير في التجربة هو ترتيب التعامل مع مصفوفة البكسلات: صححنا الاتجاه قبل إنشاء المعاينة. يربط هذا الفرق الصغير بين خطوة قراءة الوسم والخطوة التي تقرر عرض الصورة وارتفاعها، بدلاً من محاولة معالجة النتيجة الخاطئة بوصفها عيباً في تصميم الصفحة.
اقرأ فرق 4×2 و2×4 قبل تعديل التصميم
يمكن لملف الصورة أن يجمع بين ترتيب مخزن للبكسلات ووسم يصف تحويلها عند العرض. عينة المشروع تفعل ذلك صراحة: يولد fixture نمطاً صغيراً من قيم RGB ثم يحفظه إلى JPEG مع الوسم 274 وقيمة اتجاهه 6. لا نحتاج إلى افتراض كيف يخزن كل هاتف صوره لتكرار هذه الحالة. حين يصغر broken_preview_size مصفوفة 8×4 مباشرة إلى حد 4، تصبح النتيجة 4×2. هذا يصف محاور البيانات التي قرأتها الدالة، ولا يثبت وحده أن كل عارض سيعرض الملف على الجانب أو أن نسبة الصورة تعرضت لتشويه هندسي.
أما في المسار المصحح، فإن قراءة الوسم وتطبيق التحويل اللازم يسبقان عملية التحجيم والتصغير. بمجرد فك ترميز ملف الاختبار وتطبيق التدوير المناسب لوسم التوجيه السادس، تتبدل المحاور الهندسية للبكسلات قبل إعادة تشكيل الأبعاد؛ فتتحول المصفوفة المكونة من ثمانية بكسلات عرضاً وأربعة بكسلات ارتفاعاً إلى مصفوفة رأسية فعلية بعرض أربعة بكسلات وارتفاع ثمانية بكسلات. وعند إخضاع هذه المصفوفة الرأسية للقيد الرقمي نفسه البالغ أربعة بكسلات، يُحسب التناسب بناءً على البعد الأطول الرأسي، مما يؤدي إلى تقليص الارتفاع إلى أربعة بكسلات وخفض العرض تناسبياً إلى بكسلين اثنين، فتكون النتيجة النهائية معاينة صحيحة هندسياً بقياس اثنين في أربعة.
ليست محاولة الدوران داخل الواجهة سبباً حتمياً لتشويه النسبة؛ يمكن أن تكون معالجة عرض مقصودة في تصميم آخر. اخترنا هنا تسوية الاتجاه في المعاينة نفسها حتى يصل ناتج محدد إلى المستهلك، ثم نقارن أبعاده وبكسلاته ضمن الاختبارات. إذا كان نظام قائم يستعمل تحويلات CSS أيضاً، فيحتاج إلى مراجعة العلاقة بين التحويلين كي لا يطبق دوراناً إضافياً بلا قصد. لا تحسم المجموعة المحلية مكان المعالجة المناسب لكل تطبيق، لكنها توفر مثالاً قابلاً للتكرار لمسار خلفي يعيد PNG بعد معالجة JPEG محدد.
شغّل مسار JPEG إلى معاينة PNG بوحدتين منفصلتين
يتطلب التحليل الدقيق لبنية المسار البرمجي فصل المعالجة الساذجة المباشرة عن المعالجة المنضبطة هندسياً عبر وحدتين برمجيتين مستقلتين داخل ملف الكود المعتمد. صُممت الدالة الأولى broken_preview_size كنموذج يجسد الخلل البرمجي الشائع؛ إذ تستقبل البيانات الثنائية وتمررها مباشرة إلى قارئ الصور دون أي تحقق من وسوم البيانات الوصفية أو نوع الملف. تقوم هذه الدالة بفتح بايتات الصورة عبر تدفق الذاكرة BytesIO، ثم تستدعي دالة thumbnail المضمنة في مكتبة Pillow مع تمرير قيد التحجيم المحدد افتراضياً بأربعة بكسلات. نظراً لأن دالة thumbnail تعدل كائن الصورة في موضعه الأصلي دون إعادة كائن جديد وتعتمد كلياً على أبعاد التخزين المادية المفكوكة دون تفسير لوسم التوجيه، فإنها تعيد حجماً ناتجاً يعكس مصفوفة الملف الخام كما سُجلت، متجاهلة أي تدوير مقصود.
تطبق ImageOps.exif_transpose التحويل المناسب لوسم Orientation غير المحايد، وتزيل بيانات الاتجاه بعد تطبيقه. Pillow ImageOps.exif_transpose reference
تتحقق upright_preview أولاً من أن bound عدد صحيح موجب، باستخدام type(bound) is int حتى لا تدخل True بوصفها واحداً. ثم تفتح المدخل وتفحص source.format، فتقبل JPEG وحده وفق عقد هذا المثال. لا يثبت هذا الفحص أن الملف آمن أو أن عملية فك الترميز لا يمكن أن تفشل؛ فقد بدأت القراءة بالفعل عند فتح الملف، وهناك أنواع أخطاء لا تختبرها المجموعة. الغرض هو إبقاء مدخلات المثال واضحة. رفض PNG قرار في هذه الدالة، وليس وصفاً لقدرة Pillow العامة أو دليلاً على أن PNG لا يستطيع حمل بيانات وصفية.
تحافظ هوية مسار الأصل في الفهرس على الفصل بين JPEG المصدر وPNG المعاينة. تعديل الاسم لا يطبق اتجاه EXIF على البكسلات؛ احتفظ بالأصل واربط ناتج التحويل به حتى تستطيع تفسير ما تغير عند إعادة بناء المعرض.
بمجرد استيفاء شروط العقد، يُمرر كائن الصورة إلى دالة ImageOps.exif_transpose لفك ارتباط التوجيه البصري بالوسم الرقمي. تُجري هذه العملية التحويل الهندسي المطلوب لمصفوفة البكسلات وفق وسم Orientation الموجود وتنتج كائناً جديداً مجرداً من وسم الاتجاه غير المحايد، مما يجعل مصفوفة البكسلات متطابقة بنيوياً مع الاتجاه الفعلي للعرض. بعد استقرار المحاور الهندسية الصحيحة، يُطبق قيد التحجيم عبر استدعاء thumbnail على الكائن المصحح، ليعمل التناسب الحسابي على الأبعاد الرأسية أو الأفقية السليمة. تُختتم المعالجة بتحويل الكائن إلى الفضاء اللوني RGB وتصديره بصيغة PNG داخل تدفق BytesIO منفصل، ثم استخراج مصفوفة البايتات النهائية عبر getvalue. إن اختيار تصدير المعاينة بصيغة PNG يحقق هدفين تقنيين محددين: أولهما تجنب تشوهات الضغط الإضافية الناتجة عن إعادة ضغط الصور بنسق JPEG عند أبعاد شديدة الصغر، وثانيهما تثبيت حالة البكسلات المعالجة دون نقل وسم الاتجاه القديم.
المسار هنا أحادي الاتجاه: يقبل JPEG ويعيد PNG، ولذلك سترفض الدالة ناتجها إذا أعيد تمريره إليها. بيئة التشغيل المسجلة هي Python 3.12.3 وPillow 12.3.0 على Windows، بينما تعرض الوثائق الحالية التي راجعناها الإصدار 13.0.0. لا نخلط بين الإصدارين أو نسمي اختبارنا تجربة للإصدار الأحدث. مقارنة الأبعاد في العينة الكبيرة نسبياً داخل الفحص مستقلة عن مقارنة البكسلات في العينة التي لا تصغر. الفصل بين التأكيدين يوضح ما أثبته كل منهما، لكنه لا يعزل تلقائياً أي خطأ محتمل في الألوان أو في عرض النتيجة داخل واجهة خارجية.
upright_photo.py
from io import BytesIO
from PIL import Image, ImageOps
def broken_preview_size(blob, bound=4):
with Image.open(BytesIO(blob)) as source:
source.thumbnail((bound,bound))
return source.size
def upright_preview(blob, bound=4):
if type(bound) is not int or bound <= 0:
raise ValueError('Expected a positive integer bound')
with Image.open(BytesIO(blob)) as source:
if source.format != 'JPEG':
raise ValueError('This local input contract accepts JPEG only')
image = ImageOps.exif_transpose(source)
image.thumbnail((bound,bound))
output = BytesIO()
image.convert('RGB').save(output, format='PNG')
return output.getvalue()
نطاق التحقق المحلي: عشر طرائق unittest على أنماط بكسلية أصلية صغيرة محفوظة بصيغة JPEG. فُحص الدوران للقيمة 6 والانعكاس للقيمة 2 والقيمة 1 وغياب الوسم، وأبعاد التصغير وغياب وسم الاتجاه، ومدخل PNG مرفوض وبايتات غير صالحة وثلاث قيم حد مرفوضة. مرجع البكسلات هو JPEG المفكوك نفسه دون تصغير، وليس ما قبل ضغطه. البيئة Python 3.12.3 وPillow 12.3.0 على Windows؛ وثائق الإنترنت المعاينة تعرض 13.0.0. لا يشمل ذلك ملفات هاتف فعلية أو كل الاتجاهات أو الخصوصية والألوان والشفافية أو أداء المعالجة.
تتبع الوسم السادس وتبديل المحاور قبل التصغير
رقم وسم Orientation هو 274، أما 6 فهي إحدى قيم هذا الوسم. في الحالة السادسة تقارن تجربتنا الناتج مع Image.Transpose.ROTATE_270، أي تدوير 270 درجة عكس عقارب الساعة بما يكافئ 90 درجة مع عقارب الساعة. لا يكفي تبديل حقلي العرض والارتفاع في وصف الملف كي تطابق البكسلات هذا الدوران؛ يلزم ترتيب جديد لها. هذا ما يستهدفه اختبار المقارنة دون تصغير. وعندما يكون المطلوب معاينة أصغر، نطبق التوجيه أولاً ثم نترك thumbnail تحسب النسبة من المحاور الجديدة.
في بيئة الاختبار المحددة التي استخدمت بايثون 3.12.3 ومكتبة Pillow 12.3.0 على نظام ويندوز، أُجري فحص دقيق لعينة بكسلية اصطناعية بأبعاد أساسية تبلغ ثمانية أعمدة في أربعة صفوف، مع ضبط وسم الاتجاه على القيمة السادسة. أظهر المسار المعيب الذي يتجاوز خطوة نقل البيانات الوصفية أن تطبيق التحجيم بحد أقصى أربعة بكسلات ينتج عنه أبعاد معاينة تبلغ أربعة في اثنين بناءً على محور التخزين الخام. بالمقابل، فإن استخدام دالة المعالجة المسبقة لتعديل المحاور عبر ImageOps.exif_transpose يغير أبعاد المصفوفة الأصلية لتصبح أربعة أعمدة في ثمانية صفوف قبل تطبيق حد التحجيم، مما يضمن خضوع البكسلات للنسب الصحيحة واستقرار المعاينة عند أبعاد اثنين في أربعة.
تتطلب معالجة الوسم السادس فهماً دقيقاً لطبيعة التحويل الهندسي المرتبط به، إذ تنفذ الدالة المستخدمة عملية تدوير توافقية تعيد ترتيب مصفوفة الذاكرة بشكل كامل. هذا التبديل لا يقتصر على مجرد تعديل أرقام الأبعاد في ترويسة الملف، بل يعيد توزيع قيم البكسلات فعلياً داخل كائن الصورة. ولهذا السبب، فإن تطبيق هذا الإجراء قبل استدعاء دالة thumbnail يضمن أن خوارزميات التناسب الحسابي تعمل على الأبعاد الهندسية الفعلية للمشهد وليس على الأبعاد الوهمية الناتجة عن طريقة التقاط الصورة بالكاميرا أو تخزينها المؤقت في الوسائط الرقمية.
تثبت المجموعة إزالة الوسم 274 من المعاينة في حالة الدوران المختبرة، ولا تثبت معالجة كل حالات الاتجاه الثماني أو سلامة كل قارئ خارجي. ولا نفترض أن القيمة 6 أكثر شيوعاً من غيرها؛ اخترناها لأنها تبدل المحاور وتكشف الفرق المطلوب بوضوح في العينة 8×4. يوجد أيضاً فحص مستقل للقيمة 2 وفحص للقيمة 1 وآخر لغياب الوسم. هذا توزيع لحالات مسماة، وليس مسحاً شاملاً لملفات الكاميرات. والنتيجة PNG لا تعاد إلى wrapper نفسه لأنه يقبل JPEG فقط، ولذلك لا نصف المسار بأنه اختبار تكرار دائري للعملية.
افحص الوسم الثاني كعملية انعكاس لا كدوران آخر
تتطلب معالجة الصور الرقمية فهماً دقيقاً للفروق الجوهرية بين عمليات الدوران الهندسي وتلك المرتبطة بالانعكاس المحوري، خصوصاً عند التعامل مع بيانات الاتجاه الوصفية الواردة بصيغ مثل EXIF. لا تقتصر وسوم الاتجاه على تدوير الصورة بزوايا قياسية مثل تسعين أو مائة وثمانين درجة، بل تشمل أيضاً حالات انعكاس أفقي أو عمودي تعكس طبيعة توجيه المستشعر أثناء التقاط اللقطة. عندما تحمل الصورة وسم الاتجاه الثاني، فإن المعالجة الرياضية المطلوبة لا تتضمن أي دوران زاوي، بل تقتصر حصراً على قلب المحاور أفقياً. هذا التفريق التقني حاسم لكي لا تتعامل مع الصورة كأنها بحاجة إلى تدوير عشوائي يؤدي إلى تشويه المحتوى البصري وإتلاف التناسق المكاني للعناصر الظاهرة فيها.
أظهرت الاختبارات المجرّاة على مصفوفة بكسلية اصطناعية أُعطيت قيمة الوسم الثاني أن كائن الصورة يخضع لعملية قلب أفقي باستخدام دالة FLIP_LEFT_RIGHT المطابقة للتحويل المطلوب قبل أي عملية تصغير لاحقة. عند تمرير ملف مصطنع بأبعاد ثلاثة في اثنين عبر مسار المعالجة، يطابق الناتج البكسلي تماماً الصورة الأصلية بعد إجراء عملية الانعكاس المحوري المباشر عليها ودون المساس بالأبعاد العددية الإجمالية للملف. يثبت هذا السلوك أن النظام يتعامل مع كل وسم بصورة مستقلة وفق دلالته الرياضية المحددة في معايير البيانات الوصفية، بدلاً من تطبيق وصفة معالجة عمياء تعتمد على تدوير ثابت لكل الصور التي تعرض توجيهاً غير افتراضي.
إن محاولة دمج أو الخلط بين الوسم السادس المرتبط بالدوران بزوايا قائمة والوسم الثاني المرتبط بالانعكاس يؤدي حتماً إلى نتائج مشوهة في المعاينة النهائية، لأن الاتجاه الهندسي الناتج يختلف جذرياً في كل حالة. فعندما يمر ملف يحمل الوسم الثاني عبر دالة تصحيح الاتجاه، فإن الترتيب الداخلي للبكسلات ينعكس أفقياً قبل أن تصل الصورة إلى مرحلة تطبيق الحد الأقصى للتحجيم عبر دالة thumbnail. هذا الترتيب يضمن بقاء النسبة الحسابية وأبعاد المحاور متسقة مع ما ينتظره المستخدم في واجهة العرض، متجاوزاً المشاكل التي تظهر عند الاعتماد على أبعاد التخزين الخام وحدها دون تفسير الوسوم الوصفية.
يرتبط الاختبار الانعكاسي بعقد المدخل الصغير، لكنه لا يعتمد تقنياً على حظر كل صيغة غير JPEG في المكتبة. نرفض PNG في wrapper حتى تبقى الأمثلة قابلة للمقارنة، بينما تقوم المكتبة بالتحويل المناسب للصورة المقبولة. اختبار test_png_refused يتحقق من هذا القرار المحلي فقط. إذا احتاج التطبيق لاحقاً إلى صيغ إضافية، فليوسع العقد ومجموعة العينات صراحة بدلاً من حذف الشرط وادعاء أن التغطية السابقة تكفي. وبالمثل، إزالة وسم الاتجاه لا تمثل ضماناً وحيداً لكل جوانب صحة الصورة أو جودتها أو توافقها مع واجهة غير مختبرة.
ميّز مقارنة البكسلات المفكوكة عن الصورة قبل ضغط JPEG
ينشئ fixture قيماً بكسلية أصلية ثم يحفظها إلى JPEG. لكن مرجع المقارنة في الاختبار ليس تلك القيم قبل الحفظ؛ يفتح الاختبار بايتات JPEG نفسها ويطبق transpose على الصورة المفكوكة، ثم يقارنها مع PNG الناتج من الدالة. بهذا نختبر ترتيب البكسلات بعد التحويل من المصدر المفكوك نفسه. لا نزعم أن الحفظ الأول إلى JPEG حافظ على كل لون بلا تغيير، ولا نستخدم تطابق المعاينة مع هذا المرجع لإعلان جودة ضغط أو أمان نقل. النتيجة المطلوبة هنا أضيق: تطابق التحويل المقصود في حالتي الدوران والانعكاس دون تصغير.
في سياق الاختبارات المبرمجة التي تعتمد على مقارنة مصفوفات البكسلات المفكوكة، يجب أن تتم مطابقة الصورة المعالجة بنسخة من الصورة الأصلية التي مرت بعملية تحويل هندسية متطابقة باستخدام الدوال الداخلية للمكتبة نفسها وليس بالاعتماد على القيم الخام السابقة للضغط. فعندما نقارن مصفوفة الألوان الناتجة عن دالة التصحيح مع مصفوفة ناتجة عن تدوير نفس الملف المفكوك برمجياً، فإننا نتحقق من صحة خوارزمية تبديل المحاور والانعكاس في بيئة معزولة. هذا الأسلوب يعزل تأثيرات ضغط JPEG عن الأخطاء البرمجية المحتملة في معالجة وسوم الاتجاه، مما يتيح للمطورين رصد أي انحراف في ترتيب صفوف البكسلات أو أعمدتها بشكل دقيق وموضوعي.
إن محاولة قياس تطابق البكسلات بين صورة مصغرة خضعت لعملية التحجيم وصورة أصلية لم تمر بنفس الخطوات تؤدي إلى نتائج مضللة بسبب فقدان التفاصيل الناتج عن إعادة العينة وتقليص الأبعاد. لذلك، تحصر الاختبارات الموثوقة مقارنة البيانات البكسلية في الحالات التي لا يتم فيها تصغير الأبعاد، أو تتم مقارنة مصفوفة المعاينة بعد تطبيق التحويل الهندسي وحده قبل تقليص الحجم النهائي. هذا الفصل المنهجي بين مرحلة تعديل الاتجاه ومرحلة تقليص الأبعاد يضمن بقاء المؤشرات البرمجية واضحة وقابلة للتكرار داخل بيئة الاختبار المحددة دون تداخل في المتغيرات.
علاوة على ذلك، فإن الاعتماد على مقارنة البكسلات المفكوكة يستوجب الانتباه إلى أن مخرجات المعاينة النهائية تُحفظ بصيغة PNG لضمان عدم ضياع أي تفاصيل بكسلية إضافية أثناء عملية التخزين الخاصة بالمعاينة، بينما يكون المدخل بصيغة JPEG يحتوي على بيانات EXIF والوسوم الوصفية المطلوبة. هذا التباين في صيغ المدخلات والمخرجات ضمن مسار العمل البرمجي يعني أن تقييم صحة الصورة يجب أن يركز على الأبعاد والمصفوفات الداخلية الناتجة بعد اكتمال مرحلة فك الترميز والمعالجة الهندسية، مع تجنب أي تعميمات تخص جودة الضغط أو مقارنات الأداء التي لم يتم قياسها بشكل مباشر داخل بيئة الاختبار الفعلية.
حدد عقد الصيغ والحد الرقمي وأخطاء المدخلات
تغيّر thumbnail كائن الصورة لتنتج معاينة لا تتجاوز الحد المطلوب مع الحفاظ على النسبة؛ لا تعيد صورة جديدة كقيمة للمقارنة. Pillow Image.thumbnail and getexif reference
تعتمد سلامة مسار المعالجة بشكل أساسي على فرض قيود صارمة على مدخلات النظام وتحديد الصيغ المقبولة بدقة لضمان عدم حدوث استثناءات غير متوقعة أثناء تنفيذ الوظائف البرمجية. يفرض كود الاختبار المعياري هنا عقداً تقنياً صارماً يقضي بقبول ملفات JPEG حصراً لكونها الصيغة الشائعة التي تحتوي غالباً على بيانات الاتجاه الوصفية، بينما يرفض صراحةً الصيغ الأخرى مثل PNG في هذه الدالة المحددة بغرض حصر نطاق العمليات وعدم تشتيت الاختبار. هذا الرفض المتعمد لا يعني بالضرورة عجز المكتبة عن قراءة صيغ بديلة، بل يعكس تصميماً برمجياً محكماً يحدد بوضوح متطلبات المدخلات ويفصل بين مسؤوليات فك الترميز ومعالجة الوسوم الوصفية للملفات المحددة.
إلى جانب تقييد صيغة الملف المدخل، يتطلب بناء المعاينة تحديد قيمة رقمية موجبة وصحيحة لمتغير الحد الأقصى للأبعاد وهو ما يمنع تمرير قيم سالبة أو صفرية أو قيم منطقية غير ملائمة. عند محاولة تمرير معاملات غير صالحة مثل الأعداد السالبة أو القيم الصفرية، يطلق النظام استثناءً برمجياً فورياً من نوع خطأ القيم لقطع التنفيذ وتنبيه المطور إلى وجود خطأ في البيانات الممررة. وبالمثل، فإن تمرير بيانات ثنائية تالفة أو غير مكتملة كمدخلات للدالة يؤدي إلى إثارة استثناء خطأ التعرف على الصورة، وهو ما يؤكد أهمية التعامل مع الملفات التالفة بحذر واكتشافها قبل الشروع في عمليات تبديل المحاور الهندسية أو إجراء حسابات المعاينة.
توجد في مجموعة المدخلات المرفوضة حدود محددة: True و0 و-1 للحد الرقمي، وPNG للصيغة، وسلسلة بايتات لا تمثل صورة. تؤكد هذه الحالات مسارات خطأ معينة، لكنها لا تختبر ملفاً ضخماً أو كل بنية JPEG تالفة أو ضغطاً يستنزف الذاكرة. وكذلك لا تقيس كلفة التحويل أو زمنه. إذا كان المشروع سيستقبل ملفات من مصادر خارجية، فسيحتاج إلى سياسة موارد وفحوص إضافية يناسب بها ذلك الاستقبال. لا ينبغي إسناد هذه المهام إلى شرط bound، لأن هذا الشرط يضبط مقاس المعاينة المطلوبة، ولا يضع وحده سقفاً لحجم الصورة المدخلة.
احتفظ بالأصل وافصل إصلاح الاتجاه عن سياسة الألوان والخصوصية
تعتمد استراتيجية معالجة الصور الآمنة على الاحتفاظ بملف البايتس الأصلي للمدخل دون تعديل مباشر عليه، وترك مسار تصحيح الاتجاه والهندسة يعمل على نسخة في ذاكرة المعالجة العشوائية. إن الحفاظ على الملف الثنائي للمصدر يتيح للأنظمة البرمجية إعادة استخدام الصورة الأصلية في سياقات أخرى تتطلب دقة كاملة أو مواصفات مختلفة تماماً عن المعاينة المصغرة، مثل استخراج بيانات وصفية إضافية أو توليد مقاسات متعددة للعرض. عندما يتم تمرير الملف عبر دالة التحويل، فإن التعامل مع تدفق البيانات الثنائية داخل الذاكرة المؤقتة يمنع الكتابة التخريبية على ملفات التخزين ويقلل من احتمالات ضياع البيانات الوصفية الأصلية التي قد يحتاج إليها المطور لاحقاً في أغراض أرشيفية.
من الضروري فصل المعالجة الهندسية المرتبطة بوسم الاتجاه عن سياسات إدارة الألوان والخصائص اللفظية للبيانات الوصفية الحساسة. لقد أظهرت اختبارات وحدة المعالجة المحلية أن دالة التصحيح تزيل وسم الاتجاه رقم 274 بعد إتمام عملية تدوير المحاور بنجاح، إلا أن هذا السلوك المقتصر على إزالة الوسم المعني بالاتجاه لا يعني أبداً التخلص الشامل من كافة المكونات الأخرى للبيانات الوصفية. قد تظل معلومات نظام تحديد الموقع العالمي، أو تعليقات الكاميرا، أو ملفات تعريف الألوان موجودة في الملف المصدر ما لم يتم تطبيق سياسة صريحة ومستقلة لإزالتها بشكل كامل.
يمكن أن تفصل خطة التكامل بين تصحيح الاتجاه وإدارة الألوان، لكن الفصل بين الدوال لا يضمن تلقائياً أن أحد الفشلين لن يؤثر في الآخر. تختبر عيناتنا RGB صغيرة ولا تحتوي على مجموعة ملفات ICC أو صور CMYK أو معطيات موقع حقيقية. ولذلك لا نستنتج من convert إلى RGB أن الألوان محفوظة على جميع الشاشات، ولا من غياب Orientation أن بقية البيانات الوصفية مُسحت. يحدد المستهلك ما يحتاج إلى إبقائه أو حذفه، ثم تضاف عينات تثبت تلك السياسة. تظل نتائج الاتجاه والأبعاد صالحة ضمن نطاقها المحدد من دون توسيعها إلى مراجعة ألوان أو خصوصية.
جهز تكاملاً لاحقاً مع معرض الصور دون ادعاء اختبار الهاتف
في تكامل مقترح مع المعرض، احفظ JPEG المصدر مستقلاً ثم عرّف ناتج المعاينة بأنه PNG بأبعاد مقروءة من الملف الناتج. قد تستعمل الواجهة هذا النقيض الصريح لتجنب حساب أبعادها من JPEG المخزن، لكنها ما زالت تحتاج اختبار عرض وتحققاً من عدم وجود تحويل آخر يطبق دوراناً إضافياً. لم يشغل المشروع واجهة هاتف، ولذلك لا يضمن أن كل مستخدم سيرى الصورة صحيحة في كل برنامج. ما يمكن تسليمه الآن هو الدالة واختباراتها والعينة الصغيرة المحفوظة، مع قرار واضح بشأن النقطة التي تخرج عندها المعاينة من المعالجة الهندسية.
إذا أضيف تخزين مؤقت أو مقاسات متعددة في المستقبل، فحدد في سجل المشتق الأصل الذي استُعمل والحد المطلوب ونسخة المعالجة. ويمكن عندها مقارنة معاينتين لمعرفة هل اختلف المصدر أم الإعداد أم الكود. هذا اقتراح لربط النتائج، وليس مخزناً نفذناه هنا. أما العلامة المائية فيمكن أن يحدد مشروعها ترتيباً يناسب إحداثياتها؛ لم نختبرها ولا نفرض قانوناً عاماً بأن كل معالجة لاحقة يجب أن تقع بعد التصغير. إبقاء كل توسع معرفاً بهذه الطريقة يتيح إعادة استعمال المثال الحالي كمرجع صغير بدلاً من تحويل نجاح عشرة اختبارات إلى شهادة لتطبيق معرض كامل.
أعد تشغيل المثال مع الاختبارات الأصلية
احفظ وحدة الدوال والملف test_example.py في مجلد مشروع واحد، ثم شغّل unittest discover من بيئة Python التي تتضمن المكتبات المذكورة. الاختبارات أدناه هي المصدر الأصلي الذي شُغل في السجل المحلي، وتعرض المدخلات والتأكيدات بدلاً من مطالبتك بالثقة في وصف النتيجة وحده. المسارات التنفيذية تختلف من جهاز لآخر؛ المهم أن يستورد ملف الفحص وحدة الدوال المجاورة له. لا تنقل نسخة أخرى تحمل الاسم نفسه إلى مسار الاستيراد، حتى لا تقارن نتائج برنامج مختلف بالكود المعروض هنا.
from io import BytesIO
import unittest
from PIL import Image,UnidentifiedImageError
from upright_photo import upright_preview,broken_preview_size
def fixture(size=(8,4),orientation=6,format='JPEG'):
image=Image.new('RGB',size)
image.putdata([((x*29)%256,(y*53)%256,((x+y)*17)%256) for y in range(size[1]) for x in range(size[0])])
output=BytesIO();kwargs={}
if orientation is not None:
exif=Image.Exif();exif[274]=orientation;kwargs['exif']=exif
image.save(output,format=format,**kwargs);return output.getvalue()
class ExifTests(unittest.TestCase):
def test_broken_measures_stored_axes(self):self.assertEqual(broken_preview_size(fixture()),(4,2))
def test_upright_then_resize(self):
with Image.open(BytesIO(upright_preview(fixture()))) as image:self.assertEqual(image.size,(2,4))
def test_tag_removed(self):
with Image.open(BytesIO(upright_preview(fixture()))) as image:self.assertNotIn(274,image.getexif())
def test_rotation_pixels_without_resize(self):
blob=fixture((3,2),6)
with Image.open(BytesIO(blob)) as original,Image.open(BytesIO(upright_preview(blob,100))) as actual:
expected=original.transpose(Image.Transpose.ROTATE_270);self.assertEqual(actual.size,expected.size);self.assertEqual(actual.tobytes(),expected.tobytes())
def test_mirror_tag(self):
blob=fixture((3,2),2)
with Image.open(BytesIO(blob)) as original,Image.open(BytesIO(upright_preview(blob,100))) as actual:self.assertEqual(actual.tobytes(),original.transpose(Image.Transpose.FLIP_LEFT_RIGHT).tobytes())
def test_orientation_one(self):
with Image.open(BytesIO(upright_preview(fixture((3,2),1),100))) as image:self.assertEqual(image.size,(3,2))
def test_missing_orientation(self):
with Image.open(BytesIO(upright_preview(fixture((3,2),None),100))) as image:self.assertEqual(image.size,(3,2))
def test_bad_bound(self):
for bound in [True,0,-1]:
with self.subTest(bound=bound),self.assertRaises(ValueError):upright_preview(fixture(),bound)
def test_png_refused(self):
with self.assertRaises(ValueError):upright_preview(fixture(format='PNG'))
def test_bad_bytes(self):
with self.assertRaises(UnidentifiedImageError):upright_preview(b'not an image')
يعرف fixture في ملف الفحص نمط الألوان الاصطناعي، ويضيف الوسم عند الحفظ قبل أن يستدعي أياً من الدالتين. يبدأ القارئ بذلك من بايتات قابلة لإعادة البناء، وليس من صورة هاتف لا يمكن مشاركة بياناتها. لتتبع المقارنة البكسلية، انتبه إلى أن الحد 100 أكبر من العينة 3×2 فلا يحدث تصغير في حالتي الدوران والانعكاس. أما عينة 8×4 وحدها فتستعمل الحد 4 لإظهار اختلاف المحاور بعد التصغير. لا تخلط نتيجة مقارنة البكسلات في الحالة الأولى مع تأكيد الأبعاد في الثانية، لأن كل اختبار يعزل سؤالاً مختلفاً. وفي المشروع المحفوظ يوجد أيضاً JPEG اصطناعي حجمه 8×4 ومعاينة PNG حجمها 2×4 بلا وسم Orientation. هذان مخرجا الكود الفعليان، بينما تبقى الصورة الفوتوغرافية الرئيسية مجرد توضيح موضوعي للمقال.
يفحص شرط source.format صيغة الملف التي تعرف إليها Pillow من البايتات، وليس اسماً أرسله المستخدم؛ فالدالة لا تستقبل اسم ملف أصلاً. لذلك فإن رفض عينة PNG هنا متعلق بمحتواها، لا بامتداد نصي في مسار. كذلك فإن الحد الافتراضي 4 مخصص لهذه التجربة الصغيرة حتى تظهر الفروق في تأكيدات مختصرة، وليس مقاساً مقترحاً لمعاينة صور الإنتاج. يختار المشروع الحقيقي حده وفق حاجته، ثم يختبر الأبعاد الناتجة بذلك الحد. لا يستنتج من نجاح عينة من بضعة بكسلات كيف سيبدو ملف كبير أو مقدار الذاكرة التي يحتاجها.
أُعد المقال بمساعدة أدوات ذكاء اصطناعي ومراجعات آلية. شُغلت الشيفرة الأصلية محلياً ضمن نطاق الاختبارات المسجل. الصورة الرئيسية توضيحية، وليست تصويراً ميدانياً أو لقطة لنتيجة اختبار في هاتف أو متصفح.
التعليقات
كن أول من يعلّق على هذا المقال.