راهنمای کاربری Pamvalidate(0) راهنمای کاربری Pamvalidate(0)

pamvalidate - اعتبارسنجی ساختار و بررسی سلامت داده‌های تصویر در قالب Netpbm

pamvalidate

این برنامه بخشی از Netpbm(1) است.

دستور pamvalidate یک تصویر Netpbm را از ورودی استاندارد به خروجی استاندارد کپی می‌کند، با این تفاوت که اگر مغایرت‌ها یا خطاهای مشخصی در قالب تصویر ورودی وجود داشته باشد، pamvalidate بدون تولید هیچ‌گونه خروجی با خطا متوقف می‌شود.

این قابلیت بیش از همه در خط‌لوله‌ها (پایپ‌لاین‌ها) کاربرد دارد، پیش از مرحله‌ای که نمی‌خواهید پردازش ورودی Netpbm آغاز شود مگر اینکه اطمینان حاصل شود جریان داده به طور کامل و بی‌نقص قابل خواندن است. برای نمونه، فرض کنید در حال تبدیل تصاویر PPM به PNG هستید و نمی‌خواهید تحت هیچ شرایطی یک فایل ناقص PNG تولید شود. اگر تنها از دستور pnmtopng استفاده کنید و ورودی PPM در میانه داده‌های شطرنجی (رستر) قطع شده باشد، pnmtopng با خطا متوقف می‌شود اما حدود نیمی از یک فایل PNG را نیز تولید می‌کند. برای جلوگیری از این اتفاق، ورودی PPM خود را پیش از رسیدن به pnmtopng از میان pamvalidate عبور دهید. در این حالت، pamvalidate پیش از آنکه pnmtopng داده‌ای دریافت کند و در نتیجه پیش از تولید هرگونه خروجی توسط pnmtopng، با خطا متوقف شده و کل پایپ‌لاین خاتمه می‌یابد.

انواع نقض قالب که توسط pamvalidate شناسایی می‌شوند عبارتند از:

  • مقدار یک نمونه رنگی (Sample) از بیشینه مقدار تعریف‌شده (maxval) فراتر رود.
  • جریان داده به صورت نابهنگام و پیش از موعد به پایان برسد.

این برنامه بر روی جریان‌های چندتصویری نیز کار کرده و جریان خروجی متناظر را تولید می‌کند.

برای یافتن روشی جهت بازیابی و نجات جریان داده تصویر خراب Netpbm، صفحه راهنمای pamfix را ببینید.

هیچ گزینه خط فرمانی به صورت اختصاصی برای pamvalidate تعریف نشده است، اما این ابزار گزینه‌های مشترک تمام برنامه‌های مبتنی بر libnetpbm را می‌شناسد (به بخش گزینه‌های مشترک مراجعه کنید).

pam(1), pnm(1), pamfix(1)

ابزار pamvalidate در Netpbm 10.66 (مارس 2014) معرفی شد.

این صفحه راهنما توسط ابزار 'makeman' از Netpbm و بر اساس منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارد:

http://netpbm.sourceforge.net/doc/pamvalidate.html
22 مارس 2014 مستندات netpbm