.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Pamtosvg User Manual" 0 "23 April 2006" "netpbm documentation"

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

.UN synopsis
.SH "خلاصه دستور (SYNOPSIS)"

\fBpamtosvg\fP

[\fB-background-color=\fP\fIcolorname\fP]
[\fB-centerline\fP]
[\fB-corner-threshold=\fP\fIangle\fP]
[\fB-corner-always-threshold=\fP\fIangle\fP]
[\fB-corner-surround=\fP\fIinteger\fP]
[\fB-tangent-surround=\fP\fIinteger\fP]
[\fB-error-threshold=\fP\fIfloat\fP]
[\fB-filter-iterations=\fP\fIcount\fP]
[\fB-line-reversion-threshold=\fP\fIfloat\fP]
[\fB-line-threshold=\fP\fIfloat\fP]
[\fB-width-weight-factor=\fP\fIfloat\fP]
[\fB-preserve-width\fP]
[\fB-remove-adjacent-corners\fP]
[\fB-log\fP]
[\fB-report-progress\fP] [\fIpnmfile\fP]
.PP
حداقل مخفف یکتای هر گزینه پذیرفته می‌شود. می‌توانید برای مشخص کردن گزینه‌ها به جای یک خط تیره از دو خط تیره استفاده کنید. همچنین می‌توانید به جای علامت مساوی، از نویسه فاصله برای جدا کردن نام گزینه از مقدار آن استفاده کنید.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBpamtosvg\fP یک تصویر PNM را به عنوان ورودی خوانده و یک تصویر SVG (گرافیک برداری مقیاس‌پذیر) در خروجی تولید می‌کند. در نتیجه، این ابزار منحنی‌های موجود در تصویر ورودی را ردیابی کرده و مجموعه‌ای از اسپلاین‌ها (splines) را که تصویر را بازنمایی می‌کنند، ایجاد می‌نماید.
.PP
فرمت SVG یک فرمت تصویر برداری است؛ به این معنی که منحنی‌های تشکیل‌دهنده تصویر را توصیف می‌کند. در مقابل، PNM یک فرمت شطرنجی (raster) است، به این معنی که نقاط تشکیل‌دهنده یک تصویر را توصیف می‌کند. تفاوت کاربردی اصلی میان این دو فرمت در این است که شما می‌توانید تصاویر برداری را بسیار بهتر مقیاس‌بندی کنید. همچنین اگر تصویر از منحنی‌های ساده تشکیل شده باشد، یک تصویر برداری برای توصیف آن به داده‌های بسیار کمتری نیاز دارد.
.PP
به همین دلیل، گفتن اینکه \fBpamtosvg\fP تنها یک مبدل فرمت تصویر است، دست‌کم گرفتن آن خواهد بود. این برنامه در واقع یک ردیاب تصویر (image tracer) است. وظیفه اصلی آن ردیابی یک تصویر شطرنجی و یافتن خطوط در آن است. سپس یافته‌های خود را در قالب فرمت SVG ارائه می‌دهد.
.PP
دستور \fBpamtosvg\fP کاری مشابه با نرم‌افزارهای StreamLine، CorelTrace و Autotrace انجام می‌دهد. در حقیقت این برنامه از Autotrace مشتق شده است.
.PP
فرمت SVG ساختاری بسیار بزرگ و توانایی انجام کارهای شگفت‌انگیزی دارد. ابزار \fBpamtosvg\fP تنها بخش کوچکی از قابلیت‌های آن را به کار می‌گیرد. تصویر SVG تولید شده توسط \fBpamtosvg\fP شامل یک عنصر یکتای <svg> است که دارای مشخصه‌های "width" و "height" می‌باشد. مقدار درون این عنصر تنها از عنصرهای <path> تشکیل شده است؛ و نه چیزی بیشتر.
.PP
در خروجی SVG، فاصله‌ها بدون واحد هستند و هر یک واحد متناظر با یک پیکسل از تصویر ورودی است.
.PP
برای اینکه \fBpamtosvg\fP بتواند منحنی‌های ساده را در تصویر پیدا کند، ممکن است بخواهید ابتدا با استفاده از \fBpbmclean\fP لکه‌ها را پاک کرده و با \fBpnmquant\fP سایه‌های رنگی مختلف را به رنگ‌های یکپارچه ادغام کنید.
.PP
برای اطلاعات بیشتر در مورد SVG، به 
.UR http://www.w3.org/Graphics/SVG
صفحه وب SVG کنسرسیوم وب جهان‌گستر (W3C)
.UE
\& مراجعه کنید.


.UN options
.SH "گزینه‌ها (OPTIONS)"
.PP
علاوه بر گزینه‌های مشترک در تمام برنامه‌های مبتنی بر libnetpbm (به‌ویژه \fB-quiet\fP؛ به 
.UR index.html#commonoptions
گزینه‌های مشترک
.UE
\& مراجعه کنید)، \fBpamtosvg\fP گزینه‌های خط فرمان زیر را نیز می‌شناسد:


.TP
\fB-background-color=\fP\fIcolorname\fP
رنگ مشخص‌شده را به عنوان رنگ پس‌زمینه در نظر می‌گیرد و از آن صرف‌نظر می‌کند.
.sp
اگر این گزینه را مشخص نکنید، \fBpamtosvg\fP هیچ رنگ پس‌زمینه‌ای را تشخیص نمی‌دهد.
.sp
رنگ (\fIcolorname\fP) را همان‌طور که برای 
.UR libnetpbm_image.html#colorname
آرگومان روتین کتابخانه‌ای \fBpnm_parsecolor()\fP
.UE
\& توضیح داده شده است مشخص کنید.

.TP
\fB-centerline\fP
ردیابی خط مرکزی شیء.
.sp
به‌طور پیش‌فرض، \fBpamtosvg\fP خطوط پیرامونی (outline) شیء را ردیابی می‌کند.

.TP
\fB-corner-always-threshold=\fP\fIangle\fP
هر زاویه‌ای را در یک پیکسل که کمتر از زاویه \fIangle\fP (بر حسب درجه با ممیز شناور اعشاری) باشد، به عنوان گوشه در نظر می‌گیرد؛ حتی اگر در مجاورت سایر پیکسل‌های گوشه قرار داشته باشد. مقدار پیش‌فرض ۶۰ درجه است.

.TP
\fB-corner-surround=\fP\fIinteger\fP
هنگام بررسی اینکه آیا یک نقطه گوشه است یا خیر، تعداد پیکسل‌های مشخص‌شده در هر طرف آن نقطه را در نظر می‌گیرد. مقدار پیش‌فرض ۴ است.

.TP
\fB-corner-threshold=\fP\fIangle\fP
هر پیکسلی را که با نقاط قبلی و بعدی خود زاویه‌ای کوچک‌تر از \fIangle\fP (بر حسب درجه با ممیز شناور اعشاری) تشکیل دهد، به عنوان گوشه در نظر می‌گیرد. مقدار پیش‌فرض ۱۰۰ است.

.TP
\fB-error-threshold=\fP\fIfloat\fP
منحنی‌های برازش‌شده‌ای را که انحراف آن‌ها بیش از تعداد پیکسل مشخص‌شده باشد، تقسیم (زیربخش) می‌کند. مقدار پیش‌فرض ۲٫۰ است.

.TP
\fB-filter-iterations=\fP\fIinteger\fP
پیش از برازش، منحنی را به تعداد دفعات مشخص‌شده هموارسازی می‌کند. مقدار پیش‌فرض ۴ است.

.TP
\fB-line-reversion-threshold=\fP\fIfloat\fP
هنگامی که یک اسپلاین نسبت به عدد حقیقی مشخص‌شده (وزن‌دهی‌شده بر پایه مجذور طول منحنی) به یک خط مستقیم نزدیک‌تر باشد، آن را به عنوان یک خط مستقیم حفظ می‌کند، حتی اگر فهرستی شامل منحنی‌ها باشد.
.sp
مقدار پیش‌فرض ۰٫۰۱ است.

.TP
\fB-line-threshold=\fP\fIfloat\fP
اگر یک اسپلاین از خط مستقیم تعیین‌شده توسط نقاط پایانی‌اش بیش از تعداد پیکسل مشخص‌شده منحرف نشود، با آن به عنوان یک خط مستقیم برخورد می‌شود.
.sp
مقدار پیش‌فرض ۱ است.

.TP
\fB-log\fP
یک فایل گزارش (لاگ) از فرآیند ردیابی منحنی (مناسب برای اشکال‌زدایی) ایجاد می‌کند. آن را در فایلی با نام \fIinputfile\fP\fB.log\fP در دایرکتوری جاری قرار می‌دهد، که در آن \fIinputfile\fP ریشه نام فایل ورودی است، یا اگر ورودی از ورودی استاندارد باشد یا فایل نام نامتعارفی داشته باشد، "pamtosvg" خواهد بود.

.TP
\fB-preserve-width\fP
حفظ ضخامت خط پیش از باریک‌سازی (thinning). تنها همراه با گزینه \fB-centerline\fP معنادار است.

.TP
\fBremove-adjacent-corners\fP
حذف گوشه‌های مجاور.

.TP
\fB-report-progress\fP
گزارش دادن لحظه‌ای پیشرفت فرآیند ردیابی به خروجی خطای استاندارد.

.TP
\fB-tangent-surround\fP
هنگام محاسبه خط مماس در یک نقطه، تعداد نقاط مشخص‌شده در دو طرف آن نقطه را در نظر می‌گیرد. مقدار پیش‌فرض ۳ است.

.TP
\fB-width-weight-factor\fP
ضریب وزن برای برازش ضخامت خط.



.UN applicationnotes
.SH "نکات کاربردی (APPLICATION NOTES)"
.PP
یک راه مناسب برای مشاهده اسناد SVG استفاده از مرورگرهای وب است. بسیاری از مرورگرها فایلی را که نامش به ".svg" ختم می‌شود به عنوان تصویر SVG شناسایی کرده و می‌توانند آن را نمایش دهند.


.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pnmquant" (1)\c
\&،
.BR "pbmclean" (1)\c
\&،
.BR "pnm" (1)\c
\&،
.UR http://autotrace.sourceforge.net
Autotrace
.UE
\&

.UN history
.SH "تاریخچه (HISTORY)"
.PP
ابزار \fBpamtosvg\fP در نسخه 10.33 (مارس 2006) به Netpbm افزوده شد.
.PP
هسته اصلی \fBpamtosvg\fP -- منطق ردیابی منحنی -- تقریباً بدون تغییر از برنامه Autotrace متعلق به Martin Weber گرفته شده است. آن برنامه بسیاری از عملکردهای Netpbm را مجدداً پیاده‌سازی می‌کرد، بنابراین \fBpamtosvg\fP برنامه‌ای بسیار سبک‌تر و بهینه‌تر است.
.PP
‏Bryan Henderson ابزار \fBpamtosvg\fP را اساساً تنها از طریق سازگار کردن Autotrace با Netpbm خلق کرد.
.PP
‏Autotrace نخستین بار در سال ۲۰۰۰ عرضه شد و به‌روزرسانی‌های آن تا سال ۲۰۰۲ منتشر گردید. افراد متعددی در نوشتن کدهای آن مشارکت داشتند، اما به نظر می‌رسد سازندگان اصلی آن Masatake Yamato و Martin Weber بوده‌اند.
.PP
تا ژوئن ۲۰۰۶، یک
.UR http://autotrace.sourceforge.net
پروژه Sourceforge
.UE
\& برای آن وجود داشت.
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار 'makeman' در Netpbm از روی فایل منبع HTML تولید شده است. مستندات اصلی در آدرس زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/pamtosvg.html
.PP