.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "SPUMUX" "1" "Fri Dec 30 19:47:26 CET 2005" "" "DVDAuthor Man Pages"

.SH "نام (NAME)"
spumux \- تولید و ادغام زیرنویس‌ها در یک جریان برنامه mpeg2 موجود
.SH "خلاصه دستور (SYNOPSIS)"

\fBspumux\fR [ \fB-m dvd\fR | \fB-m cvd\fR | \fB-m svcd\fR ] [ \fB-s \fIstream\fB\fR ] [ \fB-v \fIlevel\fB\fR ] [ \fB-P\fR ] [ \fB--nomux\fR ] [ \fB--nodvdauthor-data\fR ] \fB\fIfile\fB\fR \fB< \fImpeg\fB\fR \fB> \fImpeg-with-subtitles\fB\fR

.SH "توضیحات (DESCRIPTION)"
.PP
دستور \fBspumux\fR زیرنویس‌ها را کدگذاری کرده و در جریان برنامه (program stream) mpeg2 ادغام (multiplex) می‌کند.
.TP
\fB-m \fImode\fB\fR
کدگذاری زیرنویس‌ها را تنظیم می‌کند. می‌تواند dvd، cvd یا svcd باشد.
پیش‌فرض dvd است.
.TP
\fB-s \fIstream\fB\fR
شناسهٔ جریان (stream ID) زیرنویس را تنظیم می‌کند. پیش‌فرض 0 است.
.TP
\fB-v \fIlevel\fB\fR
سطح پرگویی (verbosity) را تنظیم می‌کند.
.TP
\fB-P\fR
نوار پیشرفت را فعال می‌کند.
.TP
\fB--nomux\fR
خواندن جریان MPEG از ورودی استاندارد را غیرفعال می‌کند. در عوض، خروجی تنها شامل جریان زیرتصویر (subpicture stream) خواهد بود.
.TP
\fB--nodvdauthor-data\fR
ارسال اطلاعات رنگ و دکمه را به dvdauthor غیرفعال می‌کند.
.PP
در اینجا یک نمونه فایل پیکربندی آورده شده است:

.nf
<subpictures>
   <stream>
      <spu start="\fIstart-time\fR" [ end="\fIend-time\fR" ] [ image="\fIpicture.png\fR" ]
           [ highlight="\fIpicture.png\fR" ] [ select="\fIpicture.png\fR" ]
           [ transparent="\fIcolor-spec\fR" ] [ force="yes" ]
           [ autooutline="infer" [ outlinewidth="\fIwidth\fR" ]
             [ autoorder="rows" | autoorder="columns" ] ]
           [ xoffset="\fIx-coord\fR" yoffset="\fIy-coord\fR" ] >
         <button [ name="\fIname\fR" ] [ x0="\fIx0\fR" ] [ y0="\fIy0\fR" ] [ x1="\fIx1\fR" ]
                 [ y1="\fIy1\fR" ] [ up="\fIname\fR" ] [ down="\fIname\fR" ]
                 [ left="\fIname\fR" ] [ right="\fIname\fR" ] />
         <action [ name="\fIname\fR" ] [ x0="\fIx0\fR" ] [ y0="\fIy0\fR" ] [ x1="\fIx1\fR" ]
                 [ y1="\fIy1\fR" ] />
      </spu>
   </stream>
</subpictures>
.fi
.PP
هر تصویر زیرنویس توسط یک برچسب <spu> توصیف می‌شود. مشخصه‌های start و مشخصهٔ اختیاری end، زمان نمایش زیرنویس روی صفحه را بر حسب «HR:MM:SS.HU» مشخص می‌کنند. مشخصهٔ image تصویر اصلی زیرنویس را توصیف می‌کند که می‌تواند یک فایل PNG یا BMP باشد. اگر تصویر شما تمام‌صفحه نیست، می‌توانید از xoffset و yoffset برای جابه‌جا کردن تصویر استفاده کنید. در صورتی که ایجادکننده نتواند از یک قالب گرافیکی دارای کانال آلفا (alpha channel) استفاده کند، می‌توان از مشخصهٔ transparent برای تعیین رنگی که باید کاملاً شفاف شود، استفاده کرد. برای قالب‌های معتبر \fIcolor-spec\fR، بخش «مشخص کردن رنگ‌ها (SPECIFYING COLORS)» را در ادامه ببینید. اگر می‌خواهید نمایش زیرنویس را بدون توجه به اینکه کاربر زیرنویس را فعال کرده یا نه، اجباری کنید، می‌توانید از مشخصهٔ force استفاده نمایید. هنگام ایجاد منوها، برچسب force الزامی است.
.PP
سایر مشخصه‌ها و برچسب‌ها مربوط به ایجاد منو هستند. مشخصهٔ highlight شکل ظاهری تمام دکمه‌ها را هنگام برجسته‌شدن نشان می‌دهد (یعنی زمانی که در منو از کلیدهای جهت‌نما استفاده می‌کنید)، و مشخصهٔ select شکل دکمه‌ها را هنگام انتخاب‌شدن نمایش می‌دهد (یعنی به مدت ۱ تا ۲ ثانیه پس از فشردن enter در منو). اگر هر یک از این‌ها (یا مشخصهٔ image) حذف شوند، spumux یک تصویر خالی (کاملاً شفاف) ایجاد می‌کند. بدیهی است که حداقل یک برچسب باید مشخص شود.
.PP
برای کمک به ایجاد دکمه‌ها، مشخصهٔ autooutline به spumux دستور می‌دهد که محل قرارگیری دکمه‌ها را استنباط کند. این کار را با تلاش برای رسم مستطیل‌هایی پیرامون ترکیبی از تصاویر highlight و select انجام می‌دهد که با هیچ پیکسل کدر یا نیمه‌کدری تلاقی نداشته باشند. به منظور پشتیبانی از دکمه‌های متنی، مشخصهٔ outlinewidth به شما اجازه می‌دهد پهنای مستطیل مورد آزمایش را مشخص کنید. مستطیل‌های عریض‌تر نمی‌توانند بین حروف جای گیرند. در نهایت، autoorder جهت مرتب‌سازی دکمه‌های شناسایی‌شدهٔ خودکار را توصیف می‌کند، که این امر برای دکمه‌های انتخابی عددی و همچنین نگاشت دکمه‌ها به نام‌های آن‌ها یا نام‌های ضمنی اهمیت دارد.
.PP
برچسب‌های button و action، دکمه‌ها (اشیاء قابل‌انتخابِ بصری روی صفحه) و کنش‌ها (دستوراتی که به محض فشرده شدن کلید مربوطه روی کنترل از راه دور اجرا می‌شوند) را توصیف می‌کنند. اگر از ویژگی autooutline استفاده می‌کنید، فقط در حال طراحی دکمه‌ها هستید، از پیمایش استنباط‌شدهٔ دکمه‌ها رضایت دارید و با سیستم نام‌گذاری ساده مشکلی ندارید، در واقع نیازی به مشخص کردن هیچ دکمه یا کنشی ندارید. در غیر این صورت، ادامه را بخوانید.
.PP
مشخصهٔ name برای دادن یک نام خوانا و ارجاع‌پذیر به دکمه یا کنش استفاده می‌شود. به طور پیش‌فرض، آن‌ها به صورت متوالی و با شروع از «1» شماره‌گذاری می‌شوند. نام‌های up، down، left و right مشخص می‌کنند که هنگام برجسته‌بودن دکمهٔ جاری، کدام دکمه یا کنش باید به کلید متناظر پیوند بخورد؛ هرچند در صورت حذف، spumux از الگوریتمی نسبتاً هوشمند برای تعیین دکمه‌ای که باید به آن حرکت کرد استفاده خواهد کرد.
.PP
مختصات (x0,y0) گوشهٔ بالا و چپ را به صورت فراگیر (شامل)، و مختصات (x1,y1) گوشهٔ پایین و راست را به صورت غیرفراگیر (بدون شمول) توصیف می‌کنند. مبدأ مختصات 0,0 برای گوشهٔ بالا و چپ است. در حالت ایده‌آل، هر دو مختصات y0 و y1 باید زوج باشند، تا لبه‌های دکمه به طور کامل دو خط پویش درهم‌بافته (interlaced scanlines) را در بر بگیرند، حتی اگر داده‌ای در خط پویش اضافی وجود نداشته باشد. برخی از دستگاه‌های پخش DVD در صورت مشخص نشدن خط پویش اضافی، آن را پر می‌کنند؛ spumux تلاش می‌کند اطمینان حاصل کند که آن بخش شفاف خواهد بود، اما تضمینی وجود ندارد.
.SH "مدیریت زیرنویس‌های متنی (HANDLING TEXT-BASED SUBTITLES)"
.PP
ابزار \fBspumux\fR همچنین قادر به مدیریت زیرنویس‌های متنی است که توسط خود spumux به گرافیک رندر خواهند شد. قالب‌های متنی مختلفی (حتماً باید غیرگرافیکی باشند) پشتیبانی می‌شوند (.sub، .srt، .ssa، .smi، .rt، .txt، .aqt، .jss، .js، ass). ابزار spumux تلاش خواهد کرد تا قالب را به طور خودکار تشخیص دهد.
.PP
در صورت پردازش زیرنویس‌های متنی، هیچ جریان دیگری نمی‌تواند تعریف شود؛ دکمه‌ها یا سایر موارد باید در گذر دیگری با spumux و با استفاده از یک فایل xml دیگر پردازش شوند.
.PP
فایل .xml زیر برچسب‌های موجود و تنظیمات پیش‌فرض آن‌ها را نشان می‌دهد. تنها برچسب textsub الزامی است و در صورت عدم تعیین برچسب مشخص، مقادیر پیش‌فرض استفاده می‌شوند.

.nf
<subpictures [format="NTSC|PAL"]>
   <stream>
      <textsub filename="demo1.srt" characterset="UTF-8"
         fontsize="28.0" font="arial" fill-color="\fIcolor-spec\fR"
         outline-color="\fIcolor-spec\fR" outline-thickness="3.0"
         shadow-offset="0, 0" shadow-color="\fIcolor-spec\fR"
         horizontal-alignment="left"  vertical-alignment="bottom"
         left-margin="60" right-margin="60"
         top-margin="20" bottom-margin="30" subtitle-fps="\fIfps\fR"
         movie-fps="\fIfps\fR"
         movie-width="720" movie-height="\fIheight\fR" aspect="4:3"
         force="yes"
      />
   </stream>
</subpictures>
.fi
.PP
برچسب textsub تنظیمات رندر متن به گرافیک را مشخص می‌کند.
.PP
مشخصهٔ filename مسیر و نام فایل متنی ورودی زیرنویس را مشخص می‌کند؛ این تنها مشخصه‌ای است که اجباری است.
.PP
مشخصهٔ characterset مجموعه نویسهٔ مورد استفاده را مشخص می‌کند؛ مجموعه‌های نویسهٔ موجود را می‌توان در <http://www.gnu.org/software/libiconv> یافت.
.PP
مشخصهٔ fontsize اندازهٔ قلم را بر حسب واحدهای قلم مشخص می‌کند. مشخصهٔ font قلمِ مورد استفاده را تعیین می‌نماید. دستور spumux در صورت موجود بودن، نام قلم را با استفاده از Fontconfig مطابقت می‌دهد، وگرنه در سیستم‌های لینوکس آن را به عنوان نام فایل در نظر می‌گیرد و برای اجراهای مبتنی بر ویندوز، پوشهٔ windows/fonts، زیرپوشهٔ spumux از پوشهٔ خانگی cygwin/mingw و پوشهٔ محل اجرا را به دنبال قلم مشخص‌شده بررسی می‌کند. آیا به دنبال قلم‌های رایگان هستید؟ یک فهرست در <http://www.microsoft.com/typography/links/links.asp?type=free&part=1> موجود است (این فهرست صرفاً دربارهٔ قلم‌هاست، نه سیستم‌های عامل).
.PP
مشخصهٔ fill-color رنگ مورد استفاده برای پر کردن داخل متن را تعیین می‌کند، در حالی که outline-color رنگ کادر پیرامونی را که دور هر نویسه کشیده می‌شود مشخص می‌سازد تا از پس‌زمینهٔ ویدیو متمایز شود. مشخصهٔ outline-thickness ضخامت این کادر پیرامونی را مشخص می‌کند. برای قالب‌های معتبر \fIcolor-spec\fR، بخش «مشخص کردن رنگ‌ها (SPECIFYING COLORS)» را در ادامه ببینید. رنگ پرکردن پیش‌فرض سفید و رنگ حاشیهٔ پیش‌فرض سیاه است.
.PP
مشخصه‌های shadow-offset و shadow-color اثر سایه‌ای را که باید روی متن اعمال شود تعیین می‌کنند. مشخصهٔ shadow-offset به صورت ۲ عدد صحیح علامت‌دار، به ترتیب جابه‌جایی افقی و عمودی، مشخص می‌شود که مقادیر مثبت به سمت راست و پایین هستند. برای قالب‌های معتبر \fIcolor-spec\fR، بخش «مشخص کردن رنگ‌ها (SPECIFYING COLORS)» را در ادامه ببینید. رنگ سایهٔ پیش‌فرض سیاه است.
.PP
مشخصهٔ horizontal-alignment تراز افقی زیرنویس‌ها را مشخص می‌کند. گزینه‌ها عبارتند از: «left»، «right»، «center» و «default». مقدار «default» باعث می‌شود در صورتی که قالب فایل زیرنویس متنی از این مشخصه پشتیبانی کند، spumux از مشخصهٔ تعریف‌شده در همان فایل استفاده کند.
.PP
مشخصهٔ vertical-alignment تراز عمودی را مشخص می‌کند. گزینه‌ها عبارتند از: «top»، «center» و «bottom».
.PP
مشخصه‌های margin حداقل فاصلهٔ پیکسلی خالی بین حاشیهٔ تصویر و حاشیهٔ خطوط زیرنویس را تعیین می‌کنند.
.PP
مشخصهٔ subtitle-fps برای قالب‌های زیرنویسی لازم است که به جای کسرهای ثانیه، از شماره فریم برای مشخص کردن زمان‌های زیرنویس استفاده می‌کنند؛ در حالی که movie-fps نرخ فریم ویدیویی است که زیرنویس‌ها با آن ادغام می‌شوند؛ در صورت عدم تعیین، مقدار پیش‌فرض هر دو برای NTSC برابر با ۲۹٫۹۷ و برای PAL برابر با ۲۵ است.
.PP
وجود مشخصه‌های جداگانهٔ subtitle-fps و movie-fps این امکان را به spumux می‌دهد که در صورت یکسان نبودن این مقادیر، زمان‌بندی زیرنویس را دوباره محاسبه کند.
.PP
مشخصه‌های movie-width و movie-height حداکثر اندازهٔ صفحهٔ زیرنویس را تعیین می‌کنند؛ این اندازه‌ها نباید بزرگتر از اندازهٔ فریم ویدیو باشند (۷۲۰x۴۸۰ برای NTSC و ۷۲۰x۵۷۶ برای PAL) و معمولاً با آن یکسان هستند. برخی از دستگاه‌های پخش DVD ترجیح می‌دهند ارتفاع فریم‌های زیرنویس ۲ یا ۴ پیکسل کوچکتر باشد. در صورت حذف، عرض فیلم پیش‌فرض ۷۲۰ و ارتفاع آن ۲ پیکسل کمتر از ارتفاع فریم ویدیو خواهد بود.
.PP
مشخصهٔ aspect به شما امکان می‌دهد مشخص کنید که نسبت تصویر ویدیو 16:9 (عریض) است یا 4:3. این مشخصه همراه با قالب ویدیو برای تنظیم رندر متن استفاده می‌شود تا اطمینان حاصل شود که بدون اعوجاج نمایش می‌یابد.
.PP
گزینهٔ force به شما امکان می‌دهد نمایش زیرنویس را صرف‌نظر از اینکه کاربر زیرنویس‌ها را فعال کرده باشد یا خیر، اجباری کنید.
.SH "مشخص کردن رنگ‌ها (SPECIFYING COLORS)"
.PP
رنگ‌ها برای شفافیت تصویر، پر کردن متن و حاشیه‌ها را می‌توان به روش‌های مختلفی تعیین کرد:
.TP 0.2i
\(bu
به صورت یک نام رنگ، مثلاً «green». می‌توانید از بیشتر نام‌های رنگ فهرست‌شده در <http://www.imagemagick.org/script/color.php>\& استفاده کنید.
.TP 0.2i
\(bu
به صورت یک رشتهٔ هگزادسیمال همراه با پیشوند «#»، شبیه به قالب HTML، مثلاً «#FF8080». تعداد ارقام باید مضربی از ۳ باشد؛ گروه اول مؤلفهٔ قرمز، گروه دوم سبز و سومی آبی را مشخص می‌کند.
.TP 0.2i
\(bu
به صورت نام یک فضای رنگی (color space)، به دنبال آن یک تا چهار مقدار مؤلفه درون پرانتز، مثلاً «hsv(120, 50%, 90%)».
.PP
فضاهای رنگی معتبر عبارتند از: «gray» (۱ مؤلفه)، «graya» (۲ مؤلفه)، «hsl» (۳ مؤلفه)، «hsla» (۴ مؤلفه)، «hsv» (۳ مؤلفه)، «hsva» (۴ مؤلفه)، «rgb» (۳ مؤلفه) و «rgba» (۴ مؤلفه). هر مؤلفه را می‌توان به صورت درصدی از حداکثر مقدار همراه با پسوند «%»، یا یک مقدار مطلق در محدودهٔ 0-360 برای رنگ‌ها (فام / hue)، و 0-255 برای بقیه مشخص کرد. برای نام‌های فضای رنگی که به «a» ختم می‌شوند، آخرین مؤلفه مقدار آلفا (شفافیت) است.
.PP
توجه داشته باشید که مقادیر آلفا برای مشخصهٔ «transparent» در برچسب <spu> در بالا بی‌معنی هستند.
<marc.leeman@gmail.com>
MarcLeeman2003Marc Leeman