| fig2dev(1) | General Commands Manual | fig2dev(1) |
نام (NAME)
fig2dev - تبدیل کدهای Fig به انواع زبانهای گرافیکی
خلاصه دستور (SYNOPSIS)
fig2dev [-L language] [-m mag] [-s fsize] [-Z maxdimension] [-D +/-rangelist [-K]] [گزینههای دیگر] [fig-file [out-file]]
fig2dev -h|-V
توضیحات (DESCRIPTION)
دستور fig2dev کدهای fig موجود در fig-file مشخصشده را به language گرافیکی تعیینشده ترجمه کرده و در out-file قرار میدهد. زبان گرافیکی از پسوند out-file استنباط میشود، یا اینکه باید با گزینهٔ -L تعیین گردد. مقادیر پیشفرض برای fig-file و out-file بهترتیب ورودی استاندارد و خروجی استاندارد هستند. قرار دادن یک خط تیره (-) بهجای fig-file یا out-file نیز نشاندهندهٔ ورودی یا خروجی استاندارد است.
نرمافزار Xfig (امکان ایجاد تعاملی اشکال - Facility for Interactive Generation of figures) ابزاری مبتنی بر صفحه نمایش است که تحت سیستم پنجرهای X Window System اجرا میشود و به کاربر امکان رسم و ویرایش تعاملی اشیاء را میدهد. این نسخه از fig2dev با نسخههای 1.3، 1.4، 2.0، 2.1، 3.0، 3.1 و 3.2 برنامه xfig سازگار است.
نسخه 3.2.3 و بالاتر Xfig امکان ذخیره و ویرایش توضیحات (کامنتها) را برای هر شیء Fig در اختیار کاربر میگذارد. این توضیحات به همراه چندین زبان خروجی تولید میشوند، مانند PostScript، CGM، EMF، LaTeX، MetaFont، PicTeX (بهصورت توضیحات %)، tk (بهصورت توضیحات #) و pic (بهصورت توضیحات .\").
گزینههای عمومی (همه راهاندازها) (GENERAL OPTIONS (all drivers))
- -L language
- تنظیم زبان
گرافیکی
خروجی.
زبانهای
مجاز
عبارتند از:
box, cgm, dxf, epic, eepic, eepicemu, emf, eps, gbx (Gerber beta
driver), gif, ibmgl, jpeg, latex, map (HTML image map), mf
(MetaFont), mp (MetaPost), pcx, pdf, pdftex, pdftex_t, pic,
pict2e, pictex, png, ppm, ps, pstex, pstex_t, pstricks, ptk
(Perl/tk), shape (LaTeX shaped paragraphs), sld (AutoCad slide
format), svg, textyl, tiff, tikz, tk (tcl/tk), tpic, xbm and
xpm.
نکات:
برای دریافت خروجی pdf باید ghostscript نصب باشد، و برای قالبهای تصویر بیتمپ (png، jpeg و غیره) وجود ghostscript و یکی از بستههای netpbm، ImageMagick یا GraphicsMagick الزامی است. - -h
- نمایش پیام راهنما شامل تمام گزینهها برای تمام زبانهای خروجی و سپس خروج.
- -V
- نمایش شماره نسخه برنامه و خروج.
- -D +/-rangelist
- بههمراه +rangelist، تنها عمقهای (depths) موجود در فهرست را نگه میدارد. بههمراه -rangelist، تمام عمقها بهجز موارد موجود در فهرست را نگه میدارد. فهرست دامنهها (rangelist) میتواند فهرستی از اعداد جداشده با ویرگول یا محدودههای جداشده با دونقطه (:) باشد. برای نمونه، -D +10,40,55:70,80 به این معنی است که تنها لایههای ۱۰، ۴۰، ۵۵ تا ۷۰، و ۸۰ نگه داشته شوند.
- -K
- انتخاب عمقها با گزینهٔ -D +/-rangelist معمولاً بر محاسبهٔ کادر محصورکننده (bounding box) تأثیری نمیگذارد. بنابراین ممکن است سند تولیدشده کادر محصورکنندهای بسیار بزرگتر از حد نیاز داشته باشد. اگر -K داده شود، کادر محصورکننده بهگونهای تنظیم میشود که تنها اشیاء موجود در عمقهای انتخابشده را در بر بگیرد.
- -E encoding
- کدگذاری نویسههای (character encoding) فایل ورودی را مشخص میکند. باید یکی از رشتههای فهرستشده توسط `iconv --list` باشد؛ مانند ISO-8859-1 یا UTF-8. پیشفرض آن کدگذاری لوکال (locale) فعلی است. در صورتی که فایل ورودی در رایانهٔ دیگری یا در یک محیط زبانی متفاوت ایجاد شده باشد، تنظیم این گزینه ممکن است لازم باشد.
- -G minor[:major][:unit]
- یک شبکه (grid)
روی صفحه
رسم میکند.
فاصلهٔ
خطوط
باریک، یا
باریک و
ضخیم را بر
حسب یکی از
چندین واحد
تعیین
میکند.
برای
نمونه، -G .25:1cm
در هر ۰٫۲۵
سانتیمتر
یک خط باریک
خاکستری و
در هر ۱
سانتیمتر
یک خط
خاکستری
ضخیمتر
رسم میکند.
مشخص کردن
-G 1in در هر ۱
اینچ یک خط
باریک رسم
میکند.
کسرها نیز
قابل
استفاده
هستند؛
برای نمونه
-G :1/2in در هر
۱/۲ اینچ یک
خط ضخیم رسم
خواهد کرد.
واحدهای مجاز عبارتند از: i، in، inch، f، ft، feet، c، cm، mm، و m.
تنها برای راهاندازهای PostScript، EPS، PDF، pstricks، tikz و بیتمپ (GIF، JPEG و غیره) مجاز است. - -m mag
- میزان بزرگنمایی رندر شدن شکل را روی mag تنظیم میکند. پیشفرض 1.0 است. این گزینه نمیتواند همراه با گزینهٔ بیشینه ابعاد (-Z) استفاده شود.
- -s fsize
- اندازه قلم پیشفرض (بر حسب پوینت، ۱/۷۲ اینچ) را برای اشیاء متنی روی fsize تنظیم میکند. پیشفرض 11*mag است و بنابراین با گزینهٔ -m مقیاسبندی میشود. اگر مقیاسبندی وجود نداشته باشد، قلم پیشفرض Roman با اندازه ۱۱ پوینت است.
- -Z maxdimension
- شکل را بهگونهای مقیاسبندی میکند که بیشینه بعد آن (عرض یا ارتفاع) برابر با maxdimension اینچ یا سانتیمتر باشد، بسته به این که شکل با واحدهای امپریال یا متریک ذخیره شده باشد. این گزینه نمیتواند همراه با گزینهٔ بزرگنمایی (-m) استفاده شود.
- گزینههای دیگر
- سایر گزینهها مختص به language گرافیکی انتخابی هستند که در ادامه شرح داده شدهاند..SH "گزینههای مشترک در تمام قالبهای بیتمپ (OPTIONS COMMON TO ALL BITMAP FORMATS)"
- -b borderwidth
- ایجاد حاشیهای خالی در اطراف تصویر به پهنای borderwidth (۱/۷۲ اینچ).
- -F
- استفاده از اندازههای قلم صحیح (برحسب پوینت، ۱/۷۲ اینچ) بهجای اندازه سنتی مورد استفاده در xfig/fig2dev که ۱/۸۰ اینچ است. گزینه خط فرمان متناظر در xfig عبارت است از -correct_font_size.
- -g color
- استفاده از color برای رنگ پسزمینه.
- -N
- تبدیل تمام رنگها به مقیاس خاکستری (grayscale).
- -S smoothfactor
- این گزینه با ارسال smoothfactor به ghostscript در گزینههای -dTextAlphaBits و -dGraphicsAlphaBits خروجی را برای بهبود رندر قلم و هموارسازی گرافیکی، هموار میکند. مقدار ۲ برای smoothfactor تا حدی هموارسازی فراهم میکند و مقدار ۴ هموارسازی بیشتری ایجاد میکند.
گزینههای GIF (GIF OPTIONS)
- -t color
- استفاده از color بهعنوان رنگ شفاف در فایل GIF. این مقدار باید در همان قالبی که ppmmake(1) مجاز میداند مشخص شود. این گزینه ممکن است نام یک رنگ در X11 را بپذیرد، اما دستکم میتوانید از یک مقدار هگزادسیمال ششرقمی RGB با استفاده از نشانهی # استفاده کنید؛ برای نمونه #ff0000 (قرمز).
گزینههای JPEG (JPEG OPTIONS)
- -q image_quality
- استفاده از مقدار عدد صحیح image_quality برای فاکتور «کیفیت» (Quality) تصویر JPEG. مقادیر معتبر بین ۰ تا ۱۰۰ هستند که مقدار پیشفرض آن ۷۵ است.
گزینههای CGM (CGM OPTIONS)
قالب CGM مخفف Computer Graphics Metafile، توسعهیافته توسط ISO و ANSI، یک زبان برداری بههمراه بیتمپ است. نرمافزارهای Microsoft WORD، PowerPoint و احتمالاً محصولات دیگر میتوانند این قالب را وارد کرده و آن را روی صفحه نمایش دهند، کاری که با فایلهای EPS دارای پیشنمایش ASCII انجام نمیدهند.
- -a
- تولید خروجی باینری.
- -r
- موقعیتدهی نوک پیکانها برای نمایشدهندههای CGM که نوک پیکانها را گرد نمایش میدهند. در حالت عادی، نوک پیکانها نوکتیز هستند، بنابراین fig2dev با برگرداندن نقطه پایانی خط به سمت عقب این مسئله را جبران میکند تا نوک پیکان در همان جایی که نقطه پایانی خط اصلی قرار داشت پایان یابد. اگر از گزینه -r استفاده شود، موقعیت پیکانها برای جبران اثرات پهنای خط اصلاح نخواهد شد، چرا که نوک پیکان گرد فراتر از نقطه پایانی خط امتداد پیدا نمیکند..SH "گزینههای DXF (DXF OPTIONS)" DXF قالب تبادل ترسیم (Drawing Interchange File Format) است. خروجی به DXF بهصورت آزمایشی است.
- -P
- تصویر را به حالت عمودی (portrait) میچرخاند. حالت پیشفرض، افقی (landscape) است.
گزینههای EMF (EMF OPTIONS)
قالب EMF یا Enhanced Metafile توسط مایکروسافت توسعه یافته و یک زبان مبتنی بر بردار بههمراه تصویر نقطهای (بیتمپ) است. نرمافزارهای Microsoft WORD، PowerPoint و احتمالاً محصولات دیگر میتوانند این قالب را وارد کرده و آن را روی صفحه نمایش دهند، کاری که با فایلهای EPS دارای پیشنمایش ASCII انجام نمیدهند.
گزینههای EPIC (EPIC OPTIONS)
بستهٔ EPIC یک بهبود برای محیط رسم تصویر LaTeX است.
بستهٔ EEPIC یک افزونه برای EPIC و محیط رسم تصویر LaTeX است که از ویژگیهای خاص tpic بهعنوان سازوکار گرافیکی استفاده میکند. این بسته توسط Conrad Kwok از بخش علوم کامپیوتر در دانشگاه کالیفرنیا، دیویس نوشته شده است. Conrad Kwok همچنین درایور EEPIC را برای fig2dev نوشته است.
بستهٔ EEPIC-EMU یک بستهٔ شبیهساز EEPIC است که از ویژگیهای خاص tpic استفاده نمیکند.
هنگام گنجاندن خروجی EPIC/EEPIC در یک فایل LaTeX، از "\usepackage{epic,eepic}" در مقدمه (preamble) استفاده کنید.
- -d factor
- نوک پیکانها را با ضریب factor مقیاسبندی میکند. پهنا و ارتفاع نوک پیکانها بر این ضریب تقسیم میشود. این به این دلیل است که نوک پیکانهای EPIC بهطور معمول حدود دو برابر اندازهٔ نوک پیکانهای TeX هستند.
- -F
- طرح قلم، رده و سبک آن را تعیین نمیکند؛ فقط اندازهٔ قلم و baselineskip را تنظیم میکند. بهطور پیشفرض، fig2dev هنگام درج متن، هر ۵ پارامتر قلم را تعیین میکند. عیب این کار این است که نمیتوانید قلم را از درون سند LaTeX خود مشخص کنید. با فعال بودن این گزینه، میتوانید قلم را از سند LaTeX خود تعیین نمایید.
- اگر هر یک از تصاویر گنجاندهشده در سند LaTeX شما با گزینهٔ -F تولید شده باشد، آنگاه تمامی تصاویر باید با این گزینه ایجاد شوند.
- -f font
- قلم پیشفرض مورد استفاده برای اشیاء متنی را روی font تنظیم میکند، که در آن font یکی از گزینههای rm، bf، it، sf یا tt است. پیشفرض rm میباشد.
- -l lwidth
- هنگامی که پهنای خط برابر یا بیشتر از lwidth باشد، از "\thicklines" استفاده میکند. پیشفرض 2 است.
- -P
- یک فایل کامل LaTeX تولید میکند. به عبارت دیگر، فایل خروجی را میتوان بدون نیاز به اعمال هیچ تغییری قالببندی و کامپایل کرد.
- -R dummyarg
- متن چرخاندهشده را مجاز میکند. متن چرخیده با استفاده از دستور \rotatebox درج خواهد شد. بنابراین باید عبارت "\usepackage{graphics}" را در مقدمهٔ سند LaTeX خود قرار دهید. یک آرگومان صوری بعد از -R الزامی است.
- اگر این گزینه تنظیم نشود، متن چرخیده بهصورت افقی درج خواهد شد.
- -S scale
- مقیاسی را که تصویر در آن رندر میشود تنظیم میکند. این گزینه بهطور خودکار مقادیر magnification و fsize را به ترتیب روی scale/12 و scale تنظیم میکند. مقدار scale باید عددی بین 8 و 12 (شامل هر دو) باشد.
- -t stretch
- ضریب کشیدگی خطوط خطچین را روی stretch تنظیم میکند. پیشفرض 30 است.
- -v
- توضیحات (کامنتها) را در فایل خروجی میگنجاند.
- -W
- پهنای خط متغیر را فعال میکند. بهطور پیشفرض، فقط دو پهنای خط در دسترس است: پهنای خط عادی ("\thinlines") و خطوط ضخیم ("\thicklines"). گزینهٔ -l در بالا را نیز ببینید.
- -w
- پهنای خط
متغیر را
غیرفعال
میکند.
تنها
دستورات
"\thicklines" و/یا
"\thinlines" در
فایل خروجی
تولید
خواهند شد.
هنگامی که گزینهٔ پهنای خط متغیر فعال است، اگر ضخامت خط کمتر از LineThick باشد، دستور "\thinlines" همچنان استفاده میشود. یک مشکل بالقوه این است که پهنای "\thinlines" برابر با 0.4pt است، اما وضوح Fig برابر با 1/80 اینچ (تقریباً 1pt) است. اگر LineThick روی 2 تنظیم شود، خطوط معمولی با پهنای 0.4pt رسم میشوند، اما پهنای خط بعدی از همان ابتدا 2pt خواهد بود. یک راهکار ممکن این است که LineThick را روی 1 قرار دهید و پهنای خطوطی را که میخواهید با "\thinlines" رسم شوند روی 0 تنظیم کنید.
به دلیل این مشکل، پهنای خط متغیر بهطور پیشفرض غیرفعال است (-w)..SH "گزینههای IBM-GL (HP/GL) (IBM-GL (HP/GL) OPTIONS)" IBM-GL (زبان گرافیکی IBM) با HP-GL (زبان گرافیکی Hewlett-Packard) سازگار است.
- -a
- انتخاب اندازه کاغذ ANSI A به جای اندازه پیشفرض ISO A4.
- -c
- تولید دستورالعملها برای رسام رنگی IBM 6180 بدون کارتریج بهبود گرافیکی IBM (IBM-GEC).
- -d xll,yll,xur,yur
- محدود کردن ترسیم به یک ناحیه مستطیلی از کاغذ رسام که گوشه پایین سمت چپ آن در (xll,yll) و گوشه بالا سمت راست آن در (xur,yur) قرار دارد. هر چهار عدد بر حسب اینچ هستند و پس از -d در یک فهرستِ جداشده با کاما — xll,yll,xur,yur — بدون هیچ فاصلهای بین آنها میآیند.
- -f fontfile
- بارگذاری
مشخصات
نویسههای
متنی از
جدول موجود
در فایل fontfile.
این جدول
باید دارای
۳۶ ورودی
باشد — یکی
برای هر قلم
بهعلاوه
یک مورد
پیشفرض. هر
ورودی شامل
۵ عدد است
که موارد
زیر را مشخص
میکنند:
۱.) مجموعه نویسه استاندارد (0 - 4, 6 - 9, 30 - 39)،
۲.) مجموعه نویسه جایگزین (0 - 4, 6 - 9, 30 - 39)،
۳.) زاویه شیب نویسه (به درجه)،
۴.) ضریب مقیاس پهنای نویسه و
۵.) ضریب مقیاس بلندی نویسه. - -k
- قرار دادن دستور PCL در ابتدای خروجی جهت استفاده از HP/GL.
- -l pattfile
- بارگذاری
الگوهای
خطوط پر
کردن ناحیه
از جدول
موجود در
فایل pattfile این
جدول باید
دارای ۲۱
ورودی باشد
— یکی برای
هر یک از
الگوهای پر
کردن ناحیه.
هر ورودی
شامل ۵ عدد
است که
موارد زیر
را مشخص
میکنند:
۱.) شماره الگو (-1 - 6)،
۲.) طول الگو (بر حسب اینچ)،
۳.) نوع پر کردن (1 - 5)،
۴.) فاصله پر کردن (بر حسب اینچ) و
۵.) زاویه پر کردن (به درجه). - -P
- چرخاندن شکل به حالت عمودی (portrait). پیشفرض حالت افقی (landscape) است.
- -p penfile
- بارگذاری
مشخصات قلم
رسام از
جدول موجود
در فایل penfile
این جدول
باید دارای
۹ ورودی
باشد — یکی
برای هر رنگ
بهعلاوه
یک مورد
پیشفرض. هر
ورودی شامل
۲ عدد است
که موارد
زیر را مشخص
میکنند:
۱.) شماره قلم (1 - 8) و
۲.) ضخامت قلم (بر حسب میلیمتر). - -S speed
- تنظیم سرعت قلم روی speed (سانتیمتر بر ثانیه).
- -v
- ترسیم شکل بهصورت وارونه در حالت عمودی یا معکوس در حالت افقی. این امکان به شما اجازه میدهد روی سطح رویی طلقهای شفاف اورهد بنویسید بدون اینکه به جوهر رسام روی سطح زیرین آسیبی برسد.
- -x offset
- انتقال شکل به سمت چپ به میزان offset اینچ.
- -y offset
- انتقال شکل به سمت بالا به میزان offset اینچ.
ابزار Fig2dev ممکن است با هر یک از اندازههای کاغذ پیشفرض ANSI A یا ISO A4 نصب شده باشد. گزینه -a اندازه کاغذ دیگر را انتخاب میکند. Fig2dev منحنیهای پیوسته بسته (closed splines) را پر نمیکند. برای پر کردن سایر چندضلعیها، وجود IBM-GEC الزامی است. Fig2dev ممکن است برای رسامهای دارای IBM-GEC یا فاقد آن نصب شده باشد. گزینه -c مجموعه دستورالعمل جایگزین را انتخاب میکند..SH "گزینههای LATEX (LATEX OPTIONS)" LaTeX نمیتواند تمام اشیاء گرافیکی را که توسط Fig توصیف میشوند بهطور دقیق نمایش دهد. برای نمونه، شیبهای ممکنی که خطوط میتوانند داشته باشند محدود است. برخی اشیاء، مانند منحنیهای اسپلاین (spline)، اصلاً قابل ترسیم نیستند. دستور Fig2latex نزدیکترین شیب خط ممکن را برمیگزیند و در صورتی که اشیاء نتوانند بهطور دقیق ترسیم شوند، پیامهای خطا چاپ میکند.
- -b borderwidth
- یک حاشیه خالی در اطراف شکل به پهنای borderwidth (۱/۷۲ اینچ) ایجاد میکند.
- -d dmag
- بزرگنمایی جداگانهای را برای طول خطچینها روی dmag تنظیم میکند.
- -F
- خانواده قلم (face)، رده (series) و سبک (style) قلم را تنظیم نکنید؛ تنها اندازه و baselineskip آن را تنظیم کنید. بهطور پیشفرض، fig2dev هنگام درج متن هر ۵ پارامتر قلم را تنظیم میکند. عیب این کار در آن است که نمیتوانید قلم را از درون سند LaTeX خود تعیین کنید. با فعال بودن این گزینه، میتوانید قلم را از درون سند LaTeX خود مشخص کنید.
- اگر هر یک از تصاویر گنجاندهشده در سند LaTeX شما با -F تولید شده باشد، آنگاه تمام تصاویر دیگر نیز باید با این گزینه تولید شوند.
- -f font
- قلم پیشفرض بهکاررفته برای اشیاء متنی را روی font تنظیم میکند، که در آن font یکی از موارد rm، bf، it، sf یا tt است. پیشفرض rm میباشد.
- -l lwidth
- آستانه میان خطوط باریک و ضخیم LaTeX را روی lwidth پیکسل تنظیم میکند. LaTeX تنها از دو پهنای خط مختلف پشتیبانی میکند: \thinlines و \thicklines. خطوطی با پهنای بیشتر از lwidth پیکسل بهصورت \thicklines رسم میشوند. همچنین بر اندازه نقطهها در سبک خطوط نقطهچین تأثیر میگذارد. پیشفرض ۱ است.
- -v
- حالت پرگویی (verbose). توضیحات را در فایل خروجی میگنجاند.
گزینههای MAP (نقشه تصویری HTML) (MAP (HTML image map) OPTIONS)
برنامه Xfig نگارش ۳.۲.۳ و بالاتر امکان ذخیره و ویرایش توضیحات (کامنتها) را برای هر شیء Fig در اختیار کاربر قرار میدهد. زبان خروجی map در fig2dev با استفاده از اشیاء Fig که در توضیحات خود دارای href="some_html_reference" هستند، یک نقشه تصویری HTML تولید میکند. هر شیء Fig بهجز اشیاء مرکب (compound objects) را میتوان برای این منظور استفاده کرد. معمولاً افزون بر تولید فایل map، یک فایل PNG نیز تولید میکنید که تصویری است که نقشه به آن ارجاع میدهد.
برای نمونه، ممکن است یک ترسیمه xfig داشته باشید که شامل یک تصویر واردشده با توضیح href="go_here.html" و یک شیء جعبهای با توضیح href="go_away.html" باشد. این کار یک فایل نقشه تصویری تولید میکند بهگونهای که کاربر میتواند روی تصویر کلیک کند تا مرورگر صفحه "go_here.html" را بارگذاری کند، یا روی جعبه کلیک کند تا مرورگر صفحه "go_away.html" را بارگذاری نماید.
پس از آنکه فایل map توسط fig2dev تولید شد، باید آن را ویرایش کرده تا هرگونه اطلاعات اضافی مورد نیاز در آن تکمیل گردد.
- -b borderwidth
- یک حاشیه خالی در اطراف شکل به پهنای borderwidth (۱/۷۲ اینچ) ایجاد میکند.
گزینههای METAFONT (METAFONT OPTIONS)
Fig2dev پیش از تولید کد METAFONT، مقیاس شکل را به میزان ۱/۸ تغییر میدهد. بزرگنمایی را میتوان با استفاده از گزینه -m یا با دادن گزینههای بزرگنمایی به mf بیشتر تغییر داد.
برای پردازش کد تولیدشده METAFONT، ماکروهای mfpic باید در جایی نصب شده باشند که mf بتواند آنها را بیابد. بسته ماکروی mfpic در هر سایت CTAN و در زیردایرکتوری graphics/mfpic در دسترس است.
- -C code
- کد قلم آغازین METAFONT را مشخص میکند. پیشفرض ۳۲ است.
- -n name
- نام مورد استفاده در فایل خروجی را مشخص میکند.
- -p pen_magnification
- میزان بزرگنمایی پهنای خط را در مقایسه با شکل اصلی مشخص میکند. پیشفرض ۱ است.
- -t top
- بالاترین نقطه کل دستگاه مختصات را مشخص میکند. پیشفرض ypos است.
- -x xmin
- کمینه مقدار مختصات x شکل را (به اینچ) مشخص میکند. پیشفرض ۰ است.
- -y ymin
- کمینه مقدار مختصات y شکل را (به اینچ) مشخص میکند. پیشفرض ۰ است.
- -X xmax
- بیشینه مقدار مختصات x شکل را (به اینچ) مشخص میکند. پیشفرض ۸ است.
- -Y ymax
- بیشینه مقدار مختصات y شکل را (به اینچ) مشخص میکند. پیشفرض ۸ است..SH "گزینههای METAPOST (METAPOST OPTIONS)"
- -d file
- محتوای فایل را به عنوان سرآیند اضافی ضمیمه میکند.
- -i file
- محتوای فایل را از طریق دستور \input وارد میکند.
- -M
- حالت چندصفحهای؛ برای هر عمق یک شکل تولید میکند.
- -o
- حالت قدیمی (بدون latex).
- -p number
- خط «prologues:=number» را به خروجی اضافه میکند.
گزینههای PIC (PIC OPTIONS)
- -f font
- قلم پیشفرض مورد استفاده برای اشیاء متنی را روی font تنظیم میکند، که در آن font یکی از موارد R (معمولی)، B (ضخیم)، I (مورب)، H (بدون گوشه) یا C (ماشینتحریر) است. پیشفرض R است.
- -p ext
- امکان استفاده از افزونههای خاص PIC را که با بسته groff سازگار هستند فعال میکند؛ سازگاری با DWB PIC مشخص نیست. افزونههایی که با هر گزینه فعال میشوند عبارتند از:
arc مجاز ساختن ARC_BOX یعنی استفاده از گوشههای گرد line استفاده از مقدار 'line_thickness' fill اجازه دادن به پر شدن بیضیها all استفاده از تمام موارد بالا psfont قلمهای PostScript را به نوع عمومی تبدیل نمیکند (مفید برای فایلهایی که قرار است Ditroff شده و روی چاپگر PS چاپ شوند). سازگار با DWB. allps استفاده از تمام موارد بالا (یعنی "all" + "psfont")
گزینههای PICT2E (PICT2E OPTIONS)
PICT2E ارتقایی برای محیط picture در LaTeX است. این قابلیت با درج «\usepackage{pict2e}» در مقدمه سند فعال میشود. بسته به محتوای شکل، ممکن است درج «\usepackage{color}» و «\usepackage{graphics}» نیز لازم باشد. اشکال تولیدشده با درایور PICT2E را میتوان با هر موتور LaTeX پردازش کرد، مانند LaTeX + dvips، LaTeX + dvipdfm، pdflatex، xelatex، ConTeX و غیره. پر کردن با الگو (Pattern fills) توسط زبان خروجی PICT2E پشتیبانی نمیشود. درایور PICT2E الگوها را با پر کردن ناحیه مربوطه با رنگ قلم در شدت ۲۵٪، یعنی یک سایه ۷۵٪ از رنگ قلم، رندر میکند. درایور PICT2E اجازه میدهد هر قلم موجود در موتور LaTeX، از جمله قلمهای PostScript انتخاب شود. قلمهای TeX و PostScript میتوانند در کنار یکدیگر در یک سند ظاهر شوند.
- -b borderwidth
- یک حاشیه خالی در اطراف شکل به پهنای borderwidth*(1/72) اینچ ایجاد میکند.
- -C num
- دستور \color را
برای شماره
رنگ num صادر
نمیکند (0 =
سیاه، 1 =
آبی، 2 = سبز -
ابزارک
انتخاب رنگ
در Xfig را
ببینید). به
طور
پیشفرض،
fig2dev برای
اشیایی که
رنگ آنها
در xfig روی "Default"
تنظیم شده
باشد دستور
\color صادر
نمیکند. با
این گزینه،
دستور "\color"
برای
اشیایی که
دارای رنگ
num هستند
نیز حذف
میشود. رنگ
این اشیاء،
و همچنین
اشیایی که
رنگ آنها
روی "Default"
تنظیم شده
است، از سند
LaTeX
دربرگیرنده
گرفته
میشود.
گزینه -C 0 بسیار کاربردی است. به طور پیشفرض، xfig با رنگ سیاه شروع به کار میکند. سپس fig2dev دستورات "\color{black}" را صادر میکند و در نتیجه بسته color باید در مقدمه سند اضافه شود. برای متنهای سیاه و ترسیمهای سیاهوسفید، این کار غیرضروری است.
- -e
- برای
سازگاری با
epic/eepic تلاش
نمیکند. به
طور
پیشفرض،
میتوانید
«\usepackage{pict2e, epic, eepic}» را
(به همین
ترتیب!) در
مقدمه سند
قرار دهید و
تصاویر LaTeX با
مجموعه
دستورات epic/eepic
و تصاویر
تولیدشده
با زبان
خروجی PICT2E را
در یک سند
ترکیب کنید.
با فعال
بودن این
گزینه،
تصاویر epic یا
eepic را
نمیتوان
با تصاویر PICT2E
ترکیب کرد.
به طور پیشفرض، fig2dev از بهکارگیری دستورات "\circle" و "\oval" که توسط epic تعریف شدهاند، به جای دستور "\circlearc" که مختص pict2e است، خودداری میکند. علاوه بر این، ضخامت خطوط نه تنها با "\linethickness"، بلکه با دستور eepic یعنی "\allinethickness" (در صورت تعریف شدن) نیز تنظیم میشود.
- -F
- خانواده، سری یا شکل قلم را تنظیم نمیکند. به طور پیشفرض، fig2dev خانواده، سری، شکل، اندازه قلم و baselineskip را تعیین میکند. با فعال بودن این گزینه، قلم متن را میتوان از سند LaTeX دربرگیرنده تنظیم کرد، مانند «\itshape \input{fig1.pict2e}». همچنین گزینه -o (بدون اندازه قلم) را ببینید.
- -f font
- قلم پیشفرض مورد استفاده برای اشیاء متنی را روی font تنظیم میکند. رشته font میتواند یکی از موارد rm، bf، it، sf، tt، \rmfamily، \bfseries، \itshape، \sffamily، \ttfamily، یا یکی از ۳۵ نام استاندارد قلم PostScript باشد. پیشفرض \rmfamily است.
- -i dir
- رشته dir را به ابتدای فایلهای گرافیکی موجود در تصویر pict2e اضافه میکند. برای نمونه، پس از وارد کردن "image.jpg" در xfig، با -i '$HOME/Figures/' کد "\incudegraphics{$HOME/Figures/image.jpg}" تولید خواهد شد.
- -o
- اندازه قلم یا baselineskip را تنظیم نمیکند. متن با اندازهای که در محل درج کد pict2e در سند LaTeX حاکم است رندر میشود، مانند «\small \input{fig1.pict2e}». همچنین گزینه -F (بدون ویژگیهای قلم) را ببینید.
- -O
- نویسههای خاص TeX/LaTeX را اسکیپ نمیکند. این گزینه در مواردی کاربرد دارد که مثلاً یک x مورب میخواهید، نه $x$، و تنظیم نشانگر متنی "TeX" در xfig فراموش شده است. این گزینه عملاً نشانگر "TeX" را برای تمام متنها فعال میکند.
- -P
- حالت صفحه (Pagemode)؛ یک فایل LaTeX مستقل را به عنوان out-file تولید میکند. سند ایجادشده از فایل LaTeX اندازه کاغذی برابر با کادر احاطهکننده (bounding box) شکل خواهد داشت (اما برای افزودن حاشیه گزینه -b را ببینید). فایل LaTeX تولیدشده بسته "geometry.sty" را برای تنظیم اندازه کاغذ فراخوانی میکند.
- -R num
- پیکانهای num را با فلشهای LaTeX ("\vector") جایگزین میکند. شماره یک پیکان ("Arrow Type" در xfig) را میتوان با باز کردن ابزارک انتخاب پیکان در xfig و شمارش فلشها از ۱ پیدا کرد. برای نمونه، جهت جایگزینی پیکانهای مثلثی توپر با دستورات \vector در LaTeX، از -R 3 استفاده کنید.
- -r
- تمام فلشها را با فلشهای LaTeX جایگزین میکند.
- -T
- تنها از قلمهای TeX استفاده میکند، حتی در جاهایی که قلمهای PostScript تعیین شده باشند.
- -v
- حالت پرگو (Verbose). خطوط توضیحات را در فایل خروجی مینویسد، که معمولاً نام نوع شیءِ در حال رسم را مشخص میکند.
- -w
- پسوند را از فایلهای گرافیکی گنجاندهشده حذف میکند. با فعال بودن این گزینه، fig2dev کدی تولید میکند که به عنوان مثال حاوی «\includegraphics{fig1}» است، به جای «\includegraphics{fig1.eps}»..SH "گزینههای PICTEX (PICTEX OPTIONS)" بهمنظور گنجاندن تصاویر PiCTeX در یک سند، بارگذاری ماکروهای PiCTeX ضروری است.
PiCTeX از محاسبات ثبات عدد صحیح TeX برای تولید منحنیها استفاده میکند، و به همین دلیل بسیار کُند است. PiCTeX منحنیها را با درج مکرر psymbol از طریق دستور \put رسم میکند، و بنابراین نیازمند مقدار زیادی از حافظهٔ داخلی TeX است، و فایلهای DVI بزرگی تولید میکند. اندازهٔ حافظهٔ TeX تعداد نمادهای رسم در یک تصویر را محدود میکند. در نتیجه، بهتر است از PiCTeX برای تولید تصاویر کوچک استفاده شود.
- -f font
- تنظیم قلم پیشفرضِ مورداستفاده برای اشیاء متنی روی font، که در آن font یکی از موارد rm، bf، it، sf یا tt است. پیشفرض rm است.
- -l dimen
- تنظیم ضخامت خط روی dimen. پیشفرض "1pt" است.
- -p psymbol
- تنظیم نماد رسم (psymbol). پیشفرض "\makebox(0,0)[l]{\tencirc\symbol{'160}}" است.
- -r
- اجازه ندادن به چرخش متن. در غیر این صورت، فایلهای دارای ماکروهای PiCTeX و متن چرخاندهشده باید با dvips پردازش شوند.
گزینههای GBX (Gerber, RS-247-X) (GBX OPTIONS (Gerber, RS-247-X))
معمولاً مایل خواهید بود که مقیاس y را روی -1 تنظیم کنید. برای اطلاعات بیشتر -g را ببینید.
- -d [mm|in]
- ابعاد خروجی باید میلیمتر (mm) یا اینچ (in) فرض شوند. پیشفرض میلیمتر است.
- -p [pos|neg]
- انتخاب قطبیت تصویر. برای تصاویر مثبت، خطوط رسمشده در فایل fig خطوطی از ماده تولید خواهند کرد. برای تصاویر منفی، خطوط رسمشده در فایل fig منجر به حذف ماده خواهند شد. حکاکی یک ماسک عبور کروم روی شیشه را در نظر بگیرید. رسم خطوط در فایل fig و انتخاب 'neg' باعث میشود این خطوط از میان لایهٔ کروم حکاکی شده و خطوطی شفاف بر جای بگذارند.
- -g <x scale>x<y scale>+<x offset>+<y offset>
- این گزینه هندسهٔ خروجی را کنترل میکند؛ ابعاد را مطابق با مقدار نشاندادهشده مقیاسبندی کرده و آفست مشخصشده را اعمال مینماید. معمولاً مایل خواهید بود مقیاس y را روی -1 تنظیم کنید تا حول محور x بازتاب شود. دلیل این امر آن است که Gerber مبدأ مختصات را در پایین-چپ فرض میکند، در حالی که xfig بالا-چپ را انتخاب مینماید.
- -f <n digits>.<n digits>
- این گزینه تعداد ارقام دقت را قبل و بعد از نقطهٔ ممیز اعشاری ضمنی کنترل میکند. با -f 5.3 عدد 12345678 متناظر با 12345.678 خواهد بود. در حالی که با -f 3.5 متناظر با 123.45678 است. پیشفرض ۳ رقم قبل از ممیز و ۵ رقم بعد از آن است. این مقدار متناظر با محدودهای از 0 تا 1 متر در گامهای 10 میکرونی است.
- -v
- تولید توضیحاتی که نوع اشیاء در حال ارسال به خروجی را توصیف میکنند. متن بهصورت توضیحاتی که در هر خط فایل خروجی با ## آغاز میشوند ظاهر خواهد شد.
گزینههای POSTSCRIPT، ENCAPSULATED POSTSCRIPT (EPS) و PDF (POSTSCRIPT, ENCAPSULATED POSTSCRIPT (EPS), and PDF OPTIONS)
با PostScript، میتوان از xfig برای ایجاد اشکال چندصفحهای استفاده کرد. گزینهٔ -M را برای تولید خروجی چندصفحهای مشخص کنید. برای پوسترها، گزینهٔ -O را اضافه کنید تا صفحات کمی همپوشانی داشته باشند تا مشکل ناحیهٔ غیرقابل چاپ در بیشتر چاپگرها دور زده شود، سپس صفحات را بریده و به هم بچسبانید. برای متنهایی با حروف بسیار بزرگ عالی است.
درایور EPS
تفاوتهای
زیر را با PostScript
دارد:
o هیچ showpageای
تولید
نمیشود
چرا که
خروجی قرار
است به
برنامه یا
سندی دیگر
وارد شود و
چاپ نگردد
o گزینههای
افقی/عمودی
(landscape/portrait) نادیده
گرفته
میشوند
o گزینهٔ
وسطچینسازی
نادیده
گرفته
میشود
o گزینهٔ
چندصفحهای
نادیده
گرفته
میشود
o گزینهٔ
اندازهٔ
کاغذ
نادیده
گرفته
میشود
o گزینههای
آفست x/y
نادیده
گرفته
میشوند
درایور EPS دو گزینهٔ ویژهٔ زیر را دارد:
- -B 'Wx [Wy X0 Y0]'
- این گزینه مشخص میکند که کادر احاطهکنندهٔ (bounding box) فایل EPS باید دارای پهنای Wx و ارتفاع Wy باشد. توجه داشته باشید که این گزینه شکل را به این اندازه مقیاسبندی نمیکند، بلکه صرفاً کادر احاطهکننده را تنظیم مینماید. اگر مقداری کمتر یا مساوی 0 برای Wx یا Wy مشخص شود، این مقادیر بهترتیب روی پهنا/ارتفاع شکل تنظیم میشوند. مبدأ نسبت به مختصات (0,0) صفحهٔ نمایش (بالا-چپ) است. Wx، Wy، X0 و Y0 بسته به مقیاس اندازهگیری ارائهشده در fig-file بر حسب سانتیمتر یا اینچ تفسیر میشوند. به یاد داشته باشید که برای گروهبندی آرگومانها به -B از گیومه (") یا آپوستروف (') استفاده کنید.
- -R 'Wx [Wy X0 Y0]'
- مشابه گزینهٔ -B است، با این تفاوت که X0 و Y0 نسبت به گوشهٔ پایین-چپِ شکل هستند. به یاد داشته باشید که برای گروهبندی آرگومانها به -R از گیومه (") یا آپوستروف (') استفاده کنید.
در صورت ارائهٔ گزینهٔ -P (حالت صفحه یا pagemode)، درایور PDF همهٔ گزینههای PostScript را میپذیرد. در این حالت، اندازهٔ PDF برابر با اندازهٔ صفحهٔ مشخصشده در فایل یا تنظیمشده از طریق خط فرمان با گزینهٔ -z است. در غیر این صورت، اگر -P داده نشود، PDF به کادر احاطهکنندهٔ شکل برش میخورد (اختیاراً همراه با حاشیهٔ خالی تعیینشده توسط گزینهٔ -b)، و تمام گزینههای EPS پشتیبانی میشوند.
متن اکنون میتواند شامل کدهای مختلف نویسههای ISO بالاتر از 0x7f باشد که برای چاپ مستقیم نویسههای ویژهٔ زبانها سودمند است. همهٔ نویسههای ISO پیادهسازی نشدهاند.
پشتیبانی از رنگ: اشیاء رنگیِ ایجادشده توسط Fig میتوانند روی یک چاپگر PostScript رنگی چاپ شوند. ۳۲ رنگ استاندارد وجود دارد: سیاه، زرد، سفید، طلایی، پنج سایه از آبی، چهار سایه از سبز، چهار سایه از فیروزهای، چهار سایه از قرمز، پنج سایه از سرخابی، چهار سایه از قهوهای، و چهار سایه از صورتی. علاوه بر این ممکن است رنگهای تعریفشده توسط کاربر در فایل وجود داشته باشند. برای تعریف این رنگها، فایل FORMAT3.2 مربوط به xfig را ببینید. روی یک چاپگر تکرنگ، اشیاء رنگی توسط چاپگر به طیفهای خاکستری مختلفی نگاشت میشوند. اشیاء توپُر با استفاده از پرکننده و رنگ ناحیهٔ مشخصشده چاپ میشوند. ۲۱ «سایه» (shade) از سیاه تا اشباع کامل رنگ پرکننده، و ۲۱ «تهرنگ» (tint) دیگر از اشباع کامل + ۱ تا سفید وجود دارد. علاوه بر این، ۱۶ الگو مانند آجر، خطوط مورب، هاشور متقاطع (crosshatch) و غیره وجود دارد.
- -A
- افزودن پیشنمایش ASCII (EPSI). برای PDF کاربرد ندارد.
- -b borderwidth
- ایجاد حاشیهٔ خالی در اطراف شکل با پهنای borderwidth (1/72 اینچ).
- -C dummy_arg
- افزودن پیشنمایش TIFF *دودویی* رنگی برای محصولات مایکروسافت که به پیشنمایش دودویی نیاز دارند. همچنین -T (پیشنمایش تکرنگ) را ببینید. به دلایل تاریخی باید یک آرگومان صوری (dummy) ارائه شود. برای خروجی PDF کاربرد ندارد.
- -c
- وسطچین کردن شکل روی صفحه. اگر متنهایی در fig_file وجود داشته باشد که بیش از حد به سمت راستِ سایر اشیاء امتداد یابد، ممکن است وسطچین کردن دقیق نباشد..TP -e قرار دادن شکل در لبه صفحه (نه در مرکز). در EPS در دسترس نیست.
- -F
- استفاده از اندازههای قلم صحیح (بر حسب پوینت، ۱/۷۲ اینچ) بهجای اندازه سنتی مورد استفاده xfig/fig2dev که ۱/۸۰ اینچ است. گزینه معادل در خط فرمان xfig عبارت است از -correct_font_size.
- -f font
- تنظیم قلم پیشفرض استفادهشده برای اشیاء متنی روی font، که در آن font یکی از ۳۵ نام قلم استاندارد PostScript است. پیشفرض Times-Roman است.
- -g color
- استفاده از color برای پسزمینه.
- -j
- فعالسازی قلمهای ترکیبی برای اشیاء متنی حاوی متون ژاپنی یا کرهای. با فعال بودن این گزینه و در صورتی که متغیر محیطی LC_CTYPE روی یکی از ja_JP.eucJP، ja_JP.EUC، ja_JP، ja_JP.ujis، ja، japanese، ko_KR.eucKR، ko_KR.EUC، ko_KR، ko یا korean تنظیم شده باشد، fig2dev یک مقدمه PostScript برداشتهشده از دایرکتوری fig2dev/i18n را درون فایل خروجی درج خواهد کرد. نویسههای ژاپنی نوشتهشده با قلم Times-Roman سپس از قلمهای Ryumin-Light-EUC-H یا HeiseiMin-W3-EUC-H و نویسههای ژاپنی نوشتهشده با Times-Bold از GothicBBB-Medium-EUC-H گرفته خواهند شد. برای لوکالهای کرهای، نویسههای کرهای ظاهرشده در اشیاء متنی که برای آنها Times-Roman انتخاب شده است، از Munhwa-Regular-KSC-EUC-H یا HLaTeX-Myoungjo-Regular-KSC-EUC-H گرفته میشوند. نویسههای کرهای در متن Times-Bold از MunhwaGothic-Bold-KSC-EUC-H یا HLaTeX-Gothic-Regular-KSC-EUC-H برداشته خواهند شد. Ghostscript باید بتواند این قلمها را پیدا کند.
- -l dummy_arg
- تولید شکل در حالت افقی (landscape). آرگومان ساختگی نادیده گرفته میشود، اما به دلایل سازگاری باید در خط فرمان مشخص شود. این گزینه مشخصات جهتگیری درون فایل را (برای فایلهای نسخه ۳.۰ و بالاتر) لغو و بازنویسی میکند. در EPS در دسترس نیست.
- -M
- تولید چندین صفحه در صورتی که شکل از اندازه کاغذ فراتر رود. در EPS در دسترس نیست.
- -N
- تبدیل تمام رنگها به مقیاس خاکستری (grayscale).
- -n name
- تنظیم بخش عنوان (Title) خروجی PostScript به name. این ویژگی زمانی مفید است که ورودی fig2dev از ورودی استاندارد تامین شود.
- -O
- هنگامی که همراه با -M استفاده شود، صفحات را کمی روی هم همپوشانی میدهد تا مشکل ناحیه غیرقابل چاپ در اکثر چاپگرها برطرف شود. در EPS در دسترس نیست.
- -p dummy_arg
- تولید شکل در حالت عمودی (portrait). آرگومان ساختگی نادیده گرفته میشود، اما به دلایل سازگاری باید در خط فرمان مشخص شود. این گزینه مشخصات جهتگیری درون فایل را (برای فایلهای نسخه ۳.۰ و بالاتر) لغو و بازنویسی میکند. این مقدار پیشفرض برای فایلهای Fig نسخه ۲.۱ یا پایینتر است. در EPS در دسترس نیست.
- -T
- افزودن یک پیشنمایش TIFF تکرنگ *دودویی* (binary) برای محصولات مایکروسافت که نیازمند پیشنمایش باینری هستند. همچنین -C (پیشنمایش رنگی) را ببینید. برای خروجی PDF در دسترس نیست.
- -x offset
- جابجایی شکل در جهت محور X به میزان offset پوینت PostScript (۱/۷۲ اینچ). مقدار منفی شکل را به سمت چپ و مقدار مثبت آن را به راست منتقل میکند. در EPS در دسترس نیست.
- -y offset
- جابجایی شکل در جهت محور Y به میزان offset پوینت (۱/۷۲ اینچ). مقدار منفی شکل را به بالا و مقدار مثبت به پایین منتقل میکند. در EPS در دسترس نیست.
- -z papersize
- تنظیم
اندازه
کاغذ. در EPS در
دسترس نیست.
اندازههای کاغذ موجود عبارتند از:
Letter (8.5" x 11" همچنین A), Legal ( 11" x 14") Ledger ( 11" x 17"), Tabloid ( 17" x 11", در واقع Ledger در حالت افقی), A (8.5" x 11" همچنین Letter), B ( 11" x 17" همچنین Ledger), C ( 17" x 22"), D ( 22" x 34"), E ( 34" x 44"), A9 ( 37 mm x 52 mm), A8 ( 52 mm x 74 mm), A7 ( 74 mm x 105 mm), A6 (105 mm x 148 mm), A5 (148 mm x 210 mm), A4 (210 mm x 297 mm), A3 (297 mm x 420 mm), A2 (420 mm x 594 mm), A1 (594 mm x 841 mm), A0 (841 mm x1189 mm), B10 ( 32 mm x 45 mm), B9 ( 45 mm x 64 mm), B8 ( 64 mm x 91 mm), B7 ( 91 mm x 128 mm), B6 (128 mm x 182 mm), B5 (182 mm x 257 mm), B4 (257 mm x 364 mm), B3 (364 mm x 515 mm), B2 (515 mm x 728 mm), B1 (728 mm x1030 mm), B0 (1030mm x1456 mm).
زبانهای pstex و pdftex گونهای از ps هستند که متنهای دارای پرچم «TeX Text» را حذف میکنند. زبانهای pstex_t و pdftex_t رفتاری مکمل دارند: آنها تنها متنی را تولید میکنند که پرچم «TeX Text» برای آن تنظیم شده باشد، بههمراه دستورهای لازم برای تعیین موقعیت این متن. آنها همچنین دستورهای لازم را برای رویهمگذاری فایل PostScript یا PDF تولیدشده با pstex/pdftex ایجاد میکنند. از این دو درایور میتوان برای تولید شکلی استفاده کرد که انعطافپذیری گرافیکهای PostScript را با قالببندی متنی LaTeX برای متنهای علامتگذاریشده با «TeX Text» ترکیب میکند.
درایورهای pstex و pdftex همان گزینههایی را میپذیرند که درایور EPS میپذیرد.
- -n name
- بخش Title در خروجی PostScript را روی name تنظیم میکند. این گزینه زمانی مفید است که ورودی fig2dev از ورودی استاندارد تأمین شود.
گزینههای PSTEX_T و PDFTEX_T (PSTEX_T and PDFTEX_T OPTIONS)
زبانهای pstex_t و pdftex_t تنها متنی را تولید میکنند که با پرچم «TeX Text» علامتگذاری شده باشد، بههمراه دستورهای لازم برای جایگذاری این متن و دستورهای لازم برای رویهمگذاری فایل PostScript یا PDF تولیدشده با استفاده از pstex یا pdftex (بالا را ببینید).
- -F
- نوع قلم (face)، رده (series) و سبک (style) قلم را تعیین نمیکند؛ فقط اندازه آن و baselineskip را تنظیم میکند. بهطور پیشفرض، fig2dev هنگام درج متن هر ۵ پارامتر قلم را تنظیم میکند. عیب این حالت آن است که نمیتوانید قلم را از درون سند LaTeX خود تعیین کنید. با فعال بودن این گزینه، میتوانید قلم را از سند LaTeX خود تعیین نمایید (مانند «\sfshape \input picture.eepic»).
- -p file
- نام فایل PostScript را که باید رویهمگذاری شود مشخص میکند. اگر تنظیم نشود یا مقدار آن تهی باشد، هیچ فایل PS درج نخواهد شد.
گزینههای PSTricks (PSTricks OPTIONS)
درایور PSTricks قالببندی کامل متنی و ریاضی LaTeX را برای طرحهای XFig، بدون نیاز به رویهمگذاری خروجیهای مجزا (مشابه روشهای PSTEX ) فراهم میکند. کیفیت خروجی، بهجز متن، با کیفیت خروجی درایور PostScript برابری میکند؛ در مورد متن، همانند سایر درایورهای LaTeX در fig2dev از سازوکار گزینش قلم Latex استفاده میشود. علاوهبر این، متن بهرنگ سیاه ترسیم میشود، هرچند که کد تغییر رنگ قلم در LaTex میتواند درون طرح تعبیه شود. کد PSTricks تولیدشده طوری نوشته شده که خوانا باشد. هر دستور مستقل بوده و به متغیرهای وضعیت سراسری وابستگی ندارد. بنابراین کاربر میتواند بهسادگی از XFig برای طراحی اولیه شکل PSTricks استفاده کند و سپس آن را با ویرایش دستی تکمیل نماید.
جهت استفاده از خروجی این درایور، دستور «\usepackage{pstricks}» را در دیباچه (preamble) سند خود قرار دهید. همچنین ممکن است بستههای graphicx و pstricks-add مورد نیاز باشند؛ اولی برای گرافیکهای بیتی (bitmap) و دومی برای سبکهای خطی پیچیده و/یا پیکانهای توخالی PSTricks (با گزینه -R 1) به کار میرود. درایور مشخص خواهد کرد که چه بستههایی مورد نیاز هستند. در بدنه سند، شکل را با «\input{pstfile}» وارد کنید که در آن pstfile.tex فایل خروجی است. از پرچم XFig TeX text استفاده کنید تا متن بدون هیچ تغییری به LaTeX ارسال شود. برای متنهای غیر TeX، از همان سازوکار درایورهای LaTeX و epic برای تطبیق مشخصات قلم استفاده میشود، اما این روش دقیق نیست.
- باگها و محدودیتهای شناختهشده (Known bugs and limitations).
- پشتیبانی PSTricks از سبکهای اتصال (join styles) به نسخه آن وابسته است. در نسخههای قدیمی هنگامی که اتصالی غیر از اتصالات زاویهدار نیاز باشد، کد خام PostScript از طریق «\pstVerb» درج میشود. گزینه -t این رفتار را کنترل میکند. PSTricks بهطور مستقیم از بیضیهای چرخیده پشتیبانی نمیکند، از این رو دستور rput صادر میشود تا یک بیضی افقی را چرخانده و جایگذاری کند. این موضوع باعث بروز مشکل در الگوهای هاشور (hatch patterns) میشود که همراه با بیضی جابهجا شده و میچرخند. چرخش هاشور با یک چرخش معکوس اصلاح میشود، اما مبدأ مختصات تنظیم نمیگردد، بنابراین انطباق با الگوهای هاشور مجاور نادرست خواهد بود. تصاویر نگاشت بیتی وارونهشده (flipped) از یک قابلیت نامستند بسته graphicx استفاده میکنند: ارتفاع منفی تصویر را بهصورت عمودی وارونه میکند. به نظر میرسد این قابلیت بهدرستی کار میکند؛ با این حال، جهت اطمینان بیشتر، ممکن است بخواهید پیش از درج تصاویر در طرحهای Xfig آنها را با برنامه دیگری وارونه کنید. با استفاده از گزینه -p ، درایور تلاش میکند تصاویر غیر EPS را با استفاده از برنامه bmeps توزیع TeX به EPS تبدیل کند، اما bmeps فرمتهای زیادی از جمله gif را پشتیبانی نمیکند.
- -f font
- قلم پیشفرض مورد استفاده برای اشیاء متنی را روی font تنظیم میکند، که در آن font یکی از مقادیر rm، bf، it، sf یا tt است. مقدار پیشفرض rm است.
- -G dummy_arg
- یک توری (grid) استاندارد PSTricks را به رنگ خاکستری روشن، با نادیده گرفتن پارامترهای اندازه و با شمارهگذاری بر اساس واحدهای PSTricks رسم میکند.
- -l weight
- ضریب ضخامت خط را تنظیم میکند که در پهنای واقعی خط Fig ضرب میشود. مقدار پیشفرض 0.5 تقریباً با خروجی درایور PS مطابقت دارد.
- -n 0|1|2|3
- نوع محیط (environment) را مشخص میکند. مقدار پیشفرض 0 یک محیط \picture با کادر احاطهکننده (bounding box) دقیقاً متناسب با تصویر میسازد (اما گزینههای -x و -y را نیز ببینید). مقدار 1 فقط دستورهای PSTricks را بدون هیچ محیطی تولید میکند که میتوان آن را با \input{commands} درون یک محیط \pspicture از پیش موجود استفاده کرد. مقدار 2 یک سند کامل LaTeX تولید میکند. مقدار 3 نیز یک سند کامل LaTeX تولید میکند اما سعی میکند واحد PSTricks را بهگونهای تنظیم کند که درون یک کادر ۷٫۵ در ۱۰ اینچ (حالت عمودی) جا گیرد.
- -P
- کوتاهنوشتی برای -n 3 است.
- -p dir
- تلاش میکند برنامه bmeps را برای تبدیل فایلهای تصویری به EPS (که برای PSTricks الزامی است) اجرا کند. فایلهای تبدیلشده در دایرکتوری dir قرار میگیرند، که باید از پیش وجود داشته باشد (درایور آن را نخواهد ساخت). علاوهبر این، (یک هشدار بسیار مهم) درایور بدون اخطار فایلهای موجود در این دایرکتوری را بازنویسی میکند! فایلهای شخصی خود را در این مسیر قرار ندهید. دستورهای includegraphics در فایل خروجی به این دایرکتوری اشاره میکنند. حتی اگر گزینه -p استفاده نشود، دستورهای includegraphics از این قرارداد با دایرکتوری پیشفرض ./eps پیروی میکنند. در این حالت، کاربر باید تبدیلات را بهصورت جداگانه انجام دهد. برنامه bmeps بخشی از توزیع استاندارد TeX است و فرمتهای زیر را به EPS تبدیل میکند: png jpg pnm tif. میتوانید دستور bmeps را با گزینه -v مشاهده کنید..TP -R 0|1|2 سبک پیکان (arrow) را تعیین میکند. با سبک پیشفرض 0، پیکانهای Fig به خطوط و چندضلعیها تبدیل میشوند. با سبک 1، ابعاد سرپیکان Fig به ابعاد سرپیکان PSTricks تبدیل شده و گزینههای سرپیکان PSTricks صادر میشوند. پیکانهای توخالی به بسته اضافی pstricks-add نیاز خواهند داشت. با سبک 2، گزینههای سرپیکان PSTricks بدون هیچ ابعادی صادر میشوند و اندازه سرپیکان را میتوان بهطور سراسری با psset کنترل کرد.
- -S scale
- تصویر را طبق همان قرارداد درایور EPIC، یعنی به اندازه scale/12 مقیاسبندی میکند.
- -t version
- شماره نسخه PSTricks را به درایور ارائه میدهد تا خروجی با ورودی مورد انتظار LaTeX مطابقت داشته باشد.
- -v
- چاپ هشدارهای پرجزئیات و توضیحات اضافی در فایل خروجی. اطلاعات ارائهشده شامل جزئیات جایگزینی فونت، دستورهای bmeps استفادهشده برای تبدیل تصویر (در صورت وجود)، و یک کامنت به ازای هر شیء Fig در خروجی است.
- -x marginsize
- مقدار marginsize را به سمت چپ و راست کادر احاطهکننده (bounding box) مربوط به PStricks اضافه میکند. بهطور پیشفرض، کادر دقیقاً تصویر را در بر میگیرد.
- -y marginsize
- مقدار marginsize را به بالا و پایین کادر احاطهکننده (bounding box) مربوط به PStricks اضافه میکند. بهطور پیشفرض، کادر دقیقاً تصویر را در بر میگیرد.
- -z 0|1|2
- گزینه مدیریت فونت را تعیین میکند. گزینه پیشفرض 0 سعی میکند نامها و اندازههای فونت Fig را رعایت کرده و بهترین تطابق را با یک فونت استاندارد LaTeX پیدا کند. گزینه 1 فقط اندازه فونت LaTeX را تنظیم میکند. گزینه 2 اصلاً هیچ دستوری برای فونت صادر نمیکند.
گزینههای TEXTYL (TEXTYL OPTIONS)
گزینههای TIKZ (TIKZ OPTIONS)
ابزار TIKZ یک فرانتاند قدرتمند برای Portable Graphics Format (PGF) در TeX/LaTeX است. برای استفاده از شکلهای ایجاد شده توسط درایور TIKZ در یک سند LaTeX، عبارت "\usepackage{tikz}" و بسته به محتوای شکل خود، عبارات "\usetikzlibrary{arrows.meta, bending}" و "\usetikzlibrary{patterns}" را در دیباچه (preamble) سند قرار دهید. به سادگی فایل خروجی را با \input فراخوانی کرده یا آن را در سند TeX کپی کنید. فایلهای TIKZ تولید شده توسط fig2dev میتوانند درون یک سند plain TeX قرار گیرند. با این حال، فایل مستقلی که با گزینه -P تولید میشود باید با یک موتور LaTeX پردازش شود. علاوه بر این، دستورهای فونت ممکن است به یک موتور LaTeX نیاز داشته باشند.
- -b borderwidth
- یک حاشیه خالی در اطراف شکل به پهنای borderwidth*(1/72) اینچ ایجاد میکند.
- -C num
- دستور \color را برای شماره رنگ num صادر نمیکند. (0 = مشکی، 1 = آبی، 2 = سبز - ابزارک انتخاب رنگ را در Xfig ببینید). بهطور پیشفرض، fig2dev برای اشیایی که رنگ آنها در xfig روی "Default" تنظیم شده است دستور \color صادر نمیکند. با این گزینه، دستور "\color" برای اشیایی که دارای رنگ num هستند نیز حذف میشود. رنگ این اشیاء و همچنین اشیایی که رنگ آنها روی "Default" تنظیم شده است، از سند دربرگیرنده گرفته میشود.
- -F
- خانواده فونت (font family)، رده (series) یا شکل (shape) را تنظیم نمیکند. بهطور پیشفرض، fig2dev خانواده فونت، رده، شکل، اندازه فونت و baselineskip را تعیین میکند. به عنوان یک اثر جانبی، این کار به New Font Selection Scheme (NFSS) در LaTeX نیاز دارد. با فعال بودن این گزینه، فونت متن را میتوان از طریق سند دربرگیرنده (که میتواند TeX یا LaTeX باشد) تنظیم کرد. همچنین گزینه -o (عدم تعیین اندازه فونت) را ببینید.
- -f font
- فونت پیشفرض مورد استفاده برای اشیاء متنی را روی font تنظیم میکند. رشته font میتواند یکی از مقادیر rm، bf، it، sf، tt، \rmfamily، \bfseries، \itshape، \sffamily، \ttfamily، یا یکی از 35 نام فونت استاندارد PostScript باشد. پیشفرض \rmfamily است.
- -i dir
- رشته dir را به ابتدای فایلهای گرافیکی گنجاندهشده در tikz-picture اضافه میکند. برای نمونه، پس از وارد کردن "image.jpg" در xfig، همراه با - i '$HOME/Figures/' کد "\pgfimage[width=..., height=...]{$HOME/Figures/image.jpg}" تولید خواهد شد.
- -O
- نویسههای ویژه TeX/LaTeX را اسکیپ (quote) نمیکند. این گزینه برای مثال جهت بهدست آوردن یک x خوابیده (ایتالیک) به جای $x$، در صورتی که تنظیم پرچم متنی "TeX" در xfig فراموش شده باشد، مفید است. این گزینه در عمل پرچم "TeX" را برای تمام متنها فعال میکند.
- -o
- اندازه فونت یا baselineskip را تنظیم نمیکند. متن با اندازهای رندر میشود که در محل درج کد tikz در سند حاکم است، مانند: "\small\input fig1.tikz". همچنین گزینه -F (عدم تعیین ویژگیهای فونت) را ببینید.
- -P
- حالت صفحه (Pagemode)؛ یک فایل مستقل LaTeX به عنوان out-file تولید میکند. فایل out-file را با LaTeX پردازش کنید تا یک خروجی pdf یا eps از تصویر ایجاد شود. سند تولید شده از out-file اندازه کاغذی برابر با کادر احاطهکننده شکل خواهد داشت (البته برای افزودن حاشیه، گزینه -b را بررسی کنید). بسته "geometry.sty" در out-file برای تنظیم اندازه کاغذ به کار میرود.
- -T
- تنها از فونتهای TeX استفاده میکند، حتی در مواردی که فونتهای PostScript مشخص شده باشند.
- -v
- حالت پرجزئیات (Verbose mode). خطوط توضیحی (کامنت) را در فایل خروجی مینویسد که معمولاً نوع شیءِ رسمشده را ذکر میکند.
- -W
- کدی را در ابتدای فایل درج نمیکند که اجازه تنظیم پهنا یا ارتفاع شکل را از طریق سند TeX دربرگیرنده بدهد. در غیر این صورت، برای مثال "\newdimen\XFigwidth\XFigwidth=\linewidth" باعث میشد شکلهای پس از آن با عرض خط مقیاسبندی شوند.
- -w
- پسوند
فایلهای
گرافیکی
گنجاندهشده
را حذف
میکند. با
فعال بودن
این گزینه،
fig2dev کدی
تولید
میکند که
به جای
"\pgfimage{fig1.pdf}" شامل
"\pgfimage{fig1}"
خواهد بود..SH
"گزینههای
TK و PTK (tcl/tk و Perl/tk) (TK and PTK OPTIONS)"
جعبههای قوسی (Arc-boxes) در زبان خروجی tk پشتیبانی نمیشوند و به دلیل محدودیتهای canvas در tk، تنها تصاویر X bitmap پشتیبانی میگردند.
اشیاء تصویری با ضریب بزرگنمایی در خروجی tk مقیاسبندی نمیشوند.
از آنجا که tk عناصر بوم (canvas) را بر اساس وضوح نمایشگر X مقیاسبندی میکند، چندضلعیها، خطوط و غیره ممکن است به شکلی متفاوت از تصاویر واردشده (بیتمپها) که اصلاً مقیاسبندی نمیشوند، مقیاسبندی شوند. - -g color
- استفاده از color برای پسزمینه.
- -l dummy_arg
- تولید شکل در حالت افقی (landscape). آرگومان صوری (dummy) نادیده گرفته میشود، اما به دلایل سازگاری باید در خط فرمان درج شود. این گزینه جهتگیری تعیینشده در فایل را بازنویسی میکند (برای نسخههای فایل 3.0 و بالاتر).
- -p dummy_arg
- تولید شکل در حالت عمودی (portrait). آرگومان صوری نادیده گرفته میشود، اما به دلایل سازگاری باید در خط فرمان درج شود. این گزینه جهتگیری تعیینشده در فایل را بازنویسی میکند (برای نسخههای فایل 3.0 و بالاتر). این مقدار پیشفرض برای فایلهای Fig نسخهٔ 2.1 یا پایینتر است.
- -P
- تولید بوم (canvas) به اندازهٔ کامل صفحه بهجای استفاده از جعبهٔ محصورکننده (bounding box) اشیاء شکل. حالت پیشفرض استفاده از تنها جعبهٔ محصورکننده است.
- -w
- پیچیدن شکل در کُد بهمنظور تولید یک فایل کامل perl. به این صورت که میتوانید دستور زیر را اجرا کنید: fig2dev -L ptk -w f.fig f.pl; perl f.pl و ابزارکی باز میشود که گرافیکهای موجود در f.pl را نمایش میدهد. این گزینه تنها برای خروجی ptk در دسترس است.
- -z papersize
- تنظیم اندازهٔ کاغذ. برای مشاهدهٔ اندازههای کاغذ موجود به POSTSCRIPT OPTIONS مراجعه کنید. این گزینه تنها زمانی استفاده میشود که گزینهٔ -P (استفاده از تمام صفحه) به کار رفته باشد.
گزینههای TPIC (TPIC OPTIONS)
- -f font
- تنظیم قلم پیشفرض مورد استفاده برای اشیاء متنی به font. مقدار پیشفرض rm است. رشتهٔ font میتواند یکی از مقادیر زیر باشد: rm, bf, it, sf, tt, avant, avantcsc, avantd, avantdi, avanti, bookd, bookdi, bookl, booklcsc, bookli, chanc, cour, courb, courbi, couri, helv, helvb, helvbi, helvc, helvcb, helvcbi, helvci, helvcsc, helvi, pal, palb, palbi, palbu, palc, palcsc, pali, palsl, palu, palx, times, timesb, timesbi, timesc, timescsc, timesi, timessl یا timesx.
همچنین ببینید (SEE ALSO)
گزارش باگها و محدودیتها (BUGS AND RESTRICTIONS)
لطفاً
گزارش
باگها،
اصلاحات،
قابلیتهای
جدید و غیره
را به نشانی
زیر ارسال
کنید:
thomas.loimer@tuwien.ac.at Copyright (c) 1991 Micah Beck
Parts Copyright (c) 1985-1988 Supoj Sutantavibul
Parts Copyright (c) 1989-2015 Brian V. Smith
Parts Copyright (c) 2015-2018 by Thomas Loimer
بدینوسیله مجوز استفاده، نسخهبرداری، تغییر، توزیع و فروش این نرمافزار و مستندات آن برای هر هدفی بدون دریافت هزینه اعطا میشود، مشروط بر اینکه اعلان حق نشر بالا در تمامی نسخهها درج شده و اعلان حق نشر مذکور به همراه این اعلان مجوز در مستندات پشتیبان گنجانده شوند. نویسندگان هیچگونه مسئولیتی در قبال مناسب بودن این نرمافزار برای هر هدفی بر عهده نمیگیرند. این نرمافزار «همانطور که هست» و بدون هرگونه ضمانت صریح یا ضمنی ارائه میشود.
نویسندگان هرگونه ضمانت در رابطه با این نرمافزار، از جمله تمام ضمانتهای ضمنی مربوط به قابلیت فروش و مناسب بودن برای هدفی خاص را از خود سلب میکنند. در هیچ شرایطی نویسندگان در قبال هرگونه خسارت خاص، غیرمستقیم یا تبعی، یا هر نوع خسارت ناشی از، از دست رفتن کارایی، داده یا سود، خواه در قالب یک اقدام قراردادی، سهلانگاری یا سایر اقدامات شبهجرم که ناشی از یا مرتبط با استفاده یا عملکرد این نرمافزار باشد، مسئول نخواهند بود.
نویسندگان (AUTHORS)
Micah Beck
دانشگاه Cornell
۲۸ سپتامبر
۱۹۹۰
و Frank Schmuck (در آن
زمان از
دانشگاه Cornell)
و Conrad Kwok (در آن
زمان از U.C. Davis).
درایورهای
اهدا شده
توسط
Jose Alberto Fernandez R. (از
دانشگاه Maryland)
و Gary Beihl (MCC)
پشتیبانی
از رنگ،
کدگذاری
نویسههای ISO
و پشتیبانی
از پوستر
توسط
Herbert Bauer (heb@regent.e-technik.tu-muenchen.de)
اصلاحشده
از f2p (تبدیل fig
به PIC)، توسط
نویسندهی Fig
Supoj Sutanthavibul (supoj@sally.utexas.edu)
دانشگاه Texas
در Austin.
درایور MetaFont
توسط
Anthony Starks (ajs@merck.com)
کد X-splines توسط
Carole Blanc (blanc@labri.u-bordeaux.fr)
Christophe Schlick (schlick@labri.u-bordeaux.fr)
پیادهسازی
اولیه توسط C.
Feuille، S. Grobois، L. Maziere و L. Minihot
به عنوان یک
تمرین
دانشجویی
(دانشگاه Bordeaux،
فرانسه)
انجام شده
است.
پشتیبانی از متن ژاپنی برای خروجی LaTeX نوشته شده توسط T. Sato (VEF00200@niftyserve.or.jp)
درایور tk
نوشته شده
توسط
Mike Markowski (mm@udel.edu) با
اصلاحاتی
جزئی از Brian Smith
درایور CGM (Computer
Graphics Metafile) نوشته
شده توسط
Philippe Bekaert (Philippe.Bekaert@cs.kuleuven.ac.be)
درایور EMF (Enhanced
Metafile) نوشته شده
توسط
Michael Schrick (m_schrick@hotmail.com)
درایور GBX (Gerber)
نوشته شده
توسط
Edward Grace (ej.grace@imperial.ac.uk).
| Aug 2023 | Version 3.2.9 |