Pamtosvg User Manual(0) Pamtosvg User Manual(0)

pamtosvg - تبدیل تصویر Netpbm به تصویر SVG (گرافیک برداری مقیاس‌پذیر)

pamtosvg

[-background-color=colorname] [-centerline] [-corner-threshold=angle] [-corner-always-threshold=angle] [-corner-surround=integer] [-tangent-surround=integer] [-error-threshold=float] [-filter-iterations=count] [-line-reversion-threshold=float] [-line-threshold=float] [-width-weight-factor=float] [-preserve-width] [-remove-adjacent-corners] [-log] [-report-progress] [pnmfile]

حداقل مخفف یکتای هر گزینه پذیرفته می‌شود. می‌توانید برای مشخص کردن گزینه‌ها به جای یک خط تیره از دو خط تیره استفاده کنید. همچنین می‌توانید به جای علامت مساوی، از نویسه فاصله برای جدا کردن نام گزینه از مقدار آن استفاده کنید.

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

دستور pamtosvg یک تصویر PNM را به عنوان ورودی خوانده و یک تصویر SVG (گرافیک برداری مقیاس‌پذیر) در خروجی تولید می‌کند. در نتیجه، این ابزار منحنی‌های موجود در تصویر ورودی را ردیابی کرده و مجموعه‌ای از اسپلاین‌ها (splines) را که تصویر را بازنمایی می‌کنند، ایجاد می‌نماید.

فرمت SVG یک فرمت تصویر برداری است؛ به این معنی که منحنی‌های تشکیل‌دهنده تصویر را توصیف می‌کند. در مقابل، PNM یک فرمت شطرنجی (raster) است، به این معنی که نقاط تشکیل‌دهنده یک تصویر را توصیف می‌کند. تفاوت کاربردی اصلی میان این دو فرمت در این است که شما می‌توانید تصاویر برداری را بسیار بهتر مقیاس‌بندی کنید. همچنین اگر تصویر از منحنی‌های ساده تشکیل شده باشد، یک تصویر برداری برای توصیف آن به داده‌های بسیار کمتری نیاز دارد.

به همین دلیل، گفتن اینکه pamtosvg تنها یک مبدل فرمت تصویر است، دست‌کم گرفتن آن خواهد بود. این برنامه در واقع یک ردیاب تصویر (image tracer) است. وظیفه اصلی آن ردیابی یک تصویر شطرنجی و یافتن خطوط در آن است. سپس یافته‌های خود را در قالب فرمت SVG ارائه می‌دهد.

دستور pamtosvg کاری مشابه با نرم‌افزارهای StreamLine، CorelTrace و Autotrace انجام می‌دهد. در حقیقت این برنامه از Autotrace مشتق شده است.

فرمت SVG ساختاری بسیار بزرگ و توانایی انجام کارهای شگفت‌انگیزی دارد. ابزار pamtosvg تنها بخش کوچکی از قابلیت‌های آن را به کار می‌گیرد. تصویر SVG تولید شده توسط pamtosvg شامل یک عنصر یکتای <svg> است که دارای مشخصه‌های "width" و "height" می‌باشد. مقدار درون این عنصر تنها از عنصرهای <path> تشکیل شده است؛ و نه چیزی بیشتر.

در خروجی SVG، فاصله‌ها بدون واحد هستند و هر یک واحد متناظر با یک پیکسل از تصویر ورودی است.

برای اینکه pamtosvg بتواند منحنی‌های ساده را در تصویر پیدا کند، ممکن است بخواهید ابتدا با استفاده از pbmclean لکه‌ها را پاک کرده و با pnmquant سایه‌های رنگی مختلف را به رنگ‌های یکپارچه ادغام کنید.

برای اطلاعات بیشتر در مورد SVG، به صفحه وب SVG کنسرسیوم وب جهان‌گستر (W3C) مراجعه کنید.

علاوه بر گزینه‌های مشترک در تمام برنامه‌های مبتنی بر libnetpbm (به‌ویژه -quiet؛ به گزینه‌های مشترک مراجعه کنید)، pamtosvg گزینه‌های خط فرمان زیر را نیز می‌شناسد:

رنگ مشخص‌شده را به عنوان رنگ پس‌زمینه در نظر می‌گیرد و از آن صرف‌نظر می‌کند.

اگر این گزینه را مشخص نکنید، pamtosvg هیچ رنگ پس‌زمینه‌ای را تشخیص نمی‌دهد.

رنگ (colorname) را همان‌طور که برای آرگومان روتین کتابخانه‌ای pnm_parsecolor() توضیح داده شده است مشخص کنید.

ردیابی خط مرکزی شیء.

به‌طور پیش‌فرض، pamtosvg خطوط پیرامونی (outline) شیء را ردیابی می‌کند.

هر زاویه‌ای را در یک پیکسل که کمتر از زاویه angle (بر حسب درجه با ممیز شناور اعشاری) باشد، به عنوان گوشه در نظر می‌گیرد؛ حتی اگر در مجاورت سایر پیکسل‌های گوشه قرار داشته باشد. مقدار پیش‌فرض ۶۰ درجه است.
هنگام بررسی اینکه آیا یک نقطه گوشه است یا خیر، تعداد پیکسل‌های مشخص‌شده در هر طرف آن نقطه را در نظر می‌گیرد. مقدار پیش‌فرض ۴ است.
هر پیکسلی را که با نقاط قبلی و بعدی خود زاویه‌ای کوچک‌تر از angle (بر حسب درجه با ممیز شناور اعشاری) تشکیل دهد، به عنوان گوشه در نظر می‌گیرد. مقدار پیش‌فرض ۱۰۰ است.
منحنی‌های برازش‌شده‌ای را که انحراف آن‌ها بیش از تعداد پیکسل مشخص‌شده باشد، تقسیم (زیربخش) می‌کند. مقدار پیش‌فرض ۲٫۰ است.
پیش از برازش، منحنی را به تعداد دفعات مشخص‌شده هموارسازی می‌کند. مقدار پیش‌فرض ۴ است.
هنگامی که یک اسپلاین نسبت به عدد حقیقی مشخص‌شده (وزن‌دهی‌شده بر پایه مجذور طول منحنی) به یک خط مستقیم نزدیک‌تر باشد، آن را به عنوان یک خط مستقیم حفظ می‌کند، حتی اگر فهرستی شامل منحنی‌ها باشد.

مقدار پیش‌فرض ۰٫۰۱ است.

اگر یک اسپلاین از خط مستقیم تعیین‌شده توسط نقاط پایانی‌اش بیش از تعداد پیکسل مشخص‌شده منحرف نشود، با آن به عنوان یک خط مستقیم برخورد می‌شود.

مقدار پیش‌فرض ۱ است.

یک فایل گزارش (لاگ) از فرآیند ردیابی منحنی (مناسب برای اشکال‌زدایی) ایجاد می‌کند. آن را در فایلی با نام inputfile.log در دایرکتوری جاری قرار می‌دهد، که در آن inputfile ریشه نام فایل ورودی است، یا اگر ورودی از ورودی استاندارد باشد یا فایل نام نامتعارفی داشته باشد، "pamtosvg" خواهد بود.
حفظ ضخامت خط پیش از باریک‌سازی (thinning). تنها همراه با گزینه -centerline معنادار است.
حذف گوشه‌های مجاور.
گزارش دادن لحظه‌ای پیشرفت فرآیند ردیابی به خروجی خطای استاندارد.
هنگام محاسبه خط مماس در یک نقطه، تعداد نقاط مشخص‌شده در دو طرف آن نقطه را در نظر می‌گیرد. مقدار پیش‌فرض ۳ است.
ضریب وزن برای برازش ضخامت خط.

یک راه مناسب برای مشاهده اسناد SVG استفاده از مرورگرهای وب است. بسیاری از مرورگرها فایلی را که نامش به ".svg" ختم می‌شود به عنوان تصویر SVG شناسایی کرده و می‌توانند آن را نمایش دهند.

pnmquant(1)، pbmclean(1)، pnm(1)، Autotrace

ابزار pamtosvg در نسخه 10.33 (مارس 2006) به Netpbm افزوده شد.

هسته اصلی pamtosvg -- منطق ردیابی منحنی -- تقریباً بدون تغییر از برنامه Autotrace متعلق به Martin Weber گرفته شده است. آن برنامه بسیاری از عملکردهای Netpbm را مجدداً پیاده‌سازی می‌کرد، بنابراین pamtosvg برنامه‌ای بسیار سبک‌تر و بهینه‌تر است.

‏Bryan Henderson ابزار pamtosvg را اساساً تنها از طریق سازگار کردن Autotrace با Netpbm خلق کرد.

‏Autotrace نخستین بار در سال ۲۰۰۰ عرضه شد و به‌روزرسانی‌های آن تا سال ۲۰۰۲ منتشر گردید. افراد متعددی در نوشتن کدهای آن مشارکت داشتند، اما به نظر می‌رسد سازندگان اصلی آن Masatake Yamato و Martin Weber بوده‌اند.

تا ژوئن ۲۰۰۶، یک پروژه Sourceforge برای آن وجود داشت.

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

http://netpbm.sourceforge.net/doc/pamtosvg.html
23 April 2006 netpbm documentation