.\" 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 "DVDAUTHOR" "1" "19 August 2026" "" "راهنمای DVDAuthor"

.SH "نام (NAME)"
dvdauthor \- گردهم‌آوری چندین جریان برنامه mpeg در یک فایل‌سیستم مناسب DVD
.SH "خلاصه دستور (SYNOPSIS)"

\fBdvdauthor\fR [ \fB-o \fIoutput-dir\fB\fR ] \fB-x \fIxml-control-file\fB\fR


\fBdvdauthor\fR [ \fB-o \fIoutput-dir\fB\fR ] [ \fB-j\fR | \fB--jumppad\fR | \fB-g\fR | \fB--allgprm\fR ] [ \fB-T\fR | \fB--toc\fR ] [ \fB\fIگزینه‌های منو یا عنوان\fB\fR ]

.SH "پیش‌زمینه DVD (DVD BACKGROUND)"
.PP
در سطحی کلی، یک DVD مجموعه‌ای از منوها و عنوان‌ها (titles) است.
از نظر مفهومی، یک منو شامل دکمه‌هایی است که می‌توان به آن‌ها اقداماتی اختصاص داد
و فهرستی از گزینه‌ها را به کاربر نهایی ارائه می‌دهد، در حالی که یک عنوان شامل
محتوای اصلی DVD است. با این حال، در واقعیت بسیاری از ویژگی‌های
موجود در منوها (شامل دکمه‌ها، مکث و تکرار حلقه) در عنوان‌ها نیز
در دسترس هستند.
.PP
منوها و عنوان‌ها به مجموعه‌های عنوان (titlesets) و مجموعه منوی VMGM تقسیم می‌شوند.
یک titleset می‌تواند شامل تعدادی منو و عنوان باشد که قرار است
با یکدیگر کار کنند. دکمه‌های «menu»، «audio»، «subtitle» و «angle» روی
کنترل از راه دور دستگاه پخش DVD همگی به منوهای موجود در همان
titleset مربوط به عنوانی که در حال پخش است دسترسی خواهند داشت. تمامی عنوان‌ها و منوهای
یک titleset معین دارای تنظیمات ویدیو، صدا و زیرنویس یکسانی هستند
(تعاریف منوها مستقل از تعاریف
عنوان‌ها است)، بنابراین اگر می‌خواهید تنظیمات متفاوتی داشته باشید (برای
مثال نسبت تصویر عریض در برابر استاندارد)، به titlesetهای جداگانه
نیاز دارید. Titlesetها برای پرش به یکدیگر طراحی نشده‌اند، بنابراین از دامنه
منوی VMGM استفاده می‌شود. این دامنه مجموعه‌ای از منوها (بدون عنوان) است
که می‌تواند به منوها و عنوان‌های تمام titlesetها دسترسی داشته باشد.
.PP
یکی از چالش‌برانگیزترین موارد هنگام تصمیم‌گیری در مورد نحوه ساخت DVD
این است که اغلب راه‌های متعددی برای انجام یک کار یکسان وجود دارد. برای
مثال، باید تصمیم بگیرید که منوها را در سطح VMGM قرار دهید یا
سطح titleset. یک ساختار معمول این است که منوهای سطح بالا را در
سطح VMGM قرار دهید، و منوهای پیکربندی سطح پایین (انتخاب صحنه /
صدا / زیرنویس) را در titleset بگذارید. اگر بخش‌های اضافی (DVD extras) وجود دارد،
شاید با یک تراک صوتی با کیفیت پایین‌تر و نسبت تصویر ۴:۳، در این صورت
آن‌ها در یک titleset جداگانه همراه با یک منو برای انتخاب میان موارد
اضافی در سطح titleset قرار می‌گیرند.
.SH "توضیحات DVDAUTHOR (DVDAUTHOR DESCRIPTION)"
.PP
دستور
.B dvdauthor
به‌صورت عملیات گسسته کار می‌کند. این ابزار
هر titleset را یکی یکی می‌سازد و سپس در نهایت VMGM را می‌سازد
تا دیسک تکمیل شود. در آن نقطه می‌توان محتوا را روی
یک DVD نوشت. اگر
.B dvdauthor
را با آرگومان‌های خط فرمان کنترل می‌کنید، هر مرحله به‌طور مستقل رخ خواهد داد؛
اما اگر از فایل کنترلی XML استفاده می‌کنید، این امکان را دارید که
برخی یا همه مراحل را در یک مرحله ترکیب کنید.
.PP
فایل‌های VOB ارسال‌شده به
.B dvdauthor
باید بسته‌های DVD NAV (VOBU) را در مکان‌های مناسب هم‌تافته (multiplex) داشته باشند.
بسیاری از ابزارها می‌توانند این کار را انجام دهند، از جمله
.B mplex
از mjpegtools نسخه ۱.۶.۰ یا بالاتر. سپس
.B dvdauthor
این بسته‌ها را با داده‌های صحیح پر می‌کند. دقت ویژه‌ای به‌کار رفته است تا
اطمینان حاصل شود
.B dvdauthor
با fifo سازگار است؛ به این معنی که هر
VOB منبع می‌تواند خروجی برنامه دیگری باشد (مانند
\fBmplex\fR). این امر می‌تواند با جلوگیری از دسترسی‌های اضافی به فایل‌سیستم،
اجرا را در بسیاری از سیستم‌ها سریع‌تر کند.
.SH "توضیحات خط فرمان (COMMAND LINE DESCRIPTION)"
.TP
\fB-o \fIoutput-dir\fB\fR
.TP
\fB-O \fIoutput-dir\fB\fR
دایرکتوری مقصد برای ذخیره ساختار فایل DVD-Video.
اگر گزینه
.B \-O
مشخص شود، هر دایرکتوری موجود به‌صورت (ایمن) حذف می‌شود (فقط مواردی که
شبیه بخشی از ساختار DVD-Video هستند حذف می‌شوند).
.TP
\fB-x \fIxml-control-file\fB\fR
فایل کنترلی توصیف‌کننده ساختار خروجی جهت ایجاد را مشخص می‌کند.
.PP
توجه داشته باشید که باقی گزینه‌های خط فرمان
.B منسوخ شده‌اند
و بهتر است به جای آن‌ها از فایل کنترلی XML استفاده کنید.
.TP
\fB-j\fR
.TP
\fB--jumppad\fR
ایجاد پدهای پرش (jumppads) را فعال می‌کند، که انعطاف‌پذیری بیشتری در انتخاب مقصدهای پرش/فراخوانی (jump/call) فراهم می‌سازد.
.TP
\fB-g\fR
.TP
\fB--allgprm\fR
استفاده از تمام ۱۶ ثبات همه‌منظوره را فعال می‌کند. استفاده از jumppad و برخی عبارت‌های پیچیده که نیاز به ثبات‌های موقت دارند را غیرمجاز می‌کند.
.TP
\fB-T\fR
به جای یک titleset، فایل جدول محتویات (TOC) را ایجاد می‌کند.
اگر از این گزینه استفاده شود، باید ابتدا ذکر گردد و
نباید هیچ عنوانی را مشخص کنید.
.TP
\fB-m\fR
یک منو ایجاد می‌کند.
.TP
\fB-t\fR
یک عنوان ایجاد می‌کند.
.TP
\fB-v \fIvideo-opts\fB\fR
.TP
\fB--video=\fIvideo-opts\fB\fR
فهرستی از گزینه‌های ویدیو که با علامت مثبت (+) جدا شده‌اند. ابزار dvdauthor
سعی می‌کند گزینه‌های مشخص‌نشده را استنتاج کند. گزینه‌ها شامل: pal، ntsc، 4:3، 16:9،
720xfull، 720x576، 720x480، 704xfull، 704x576، 704x480، 352xfull،
352x576، 352x480، 352xhalf، 352x288، 352x240، nopanscan، noletterbox، crop.
پیش‌فرض 4:3, 720xfull است.
.TP
\fB-a \fIaudio-opts\fB\fR
.TP
\fB--audio=\fIaudio-opts\fB\fR
فهرستی از گزینه‌ها برای یک تراک صوتی که با علامت مثبت (+) جدا شده‌اند،
و هر تراک با کاما (,) از دیگری تفکیک می‌شود. برای مثال
.B \-a ac3+en,mp2+de
دو تراک صوتی را مشخص می‌کند: اولی یک تراک انگلیسی
کدگذاری‌شده با AC3 است، و دومی یک تراک آلمانی کدگذاری‌شده با
فشرده‌سازی MPEG-1 layer 2 است. گزینه‌ها شامل ac3، mp2، pcm، dts، 16bps، 20bps، 24bps،
drc، surround، nolang، 1ch، 2ch، 3ch، 4ch، 5ch، 6ch، 7ch، 8ch، و هر
کد اختصاری زبان دو حرفی ISO 639 است. پیش‌فرض عبارت است از ۱ تراک، mp2،
20bps، nolang، 2ch. گزینه 'ac3' متضمن drc و 6ch است.
.TP
\fB-s \fIsubpicture-opts\fB\fR
.TP
\fB--subpictures=\fIsubpicture-opts\fB\fR
فهرستی از گزینه‌ها برای یک تراک زیرتصویر (subpicture)، که با علامت مثبت (+) جدا شده‌اند
و هر تراک با کاما (,) جدا می‌شود. شامل nolang و هر اختصار دو حرفی
زبان (به گزینه
.B \-a
مراجعه کنید). پیش‌فرض بدون تراک زیرتصویر است.
.TP
\fB-e \fIentry(s)\fB\fR
.TP
\fB--entry=\fIentry(s)\fB\fR
منوی جاری را به منوی پیش‌فرض برای شرایط
خاص تبدیل می‌کند. این گزینه فهرستی جداشده با کاما از موارد زیر است:

برای
منوهای TOC: مورد title

برای منوهای VTS: موارد root، ptt، audio،
subtitle، angle
.TP
\fB-p \fIpalette-file\fB\fR
.TP
\fB--palette=\fIpalette-file\fB\fR
محل دریافت پالت زیرتصویر را مشخص می‌کند.
قابل تنظیم به ازای هر عنوان و هر منو. اگر نام فایل به .rgb ختم شود
(بدون حساسیت به حروف بزرگ و کوچک) فرض می‌شود RGB است، در غیر این صورت
YUV در نظر گرفته می‌شود. ورودی‌ها باید ۶ رقم هگزادسیمال
باشند. مقدار پیش‌فرض \fIFILE\fR برابر با
xste-palette.dat است.
.TP
\fB-c \fIchapterpts\fB\fR
.TP
\fB--chapters=\fIchapterpts\fB\fR
فهرستی جداشده با کاما (,) از نشانگرهای فصل را مشخص می‌کند.
هر نشانگر به شکل [[h:]mm:]ss[.frac] است و نسبت به
SCR فایل بعدی فهرست‌شده سنجیده می‌شود (مستقل از هرگونه جابه‌جایی
برچسب زمانی که درون dvdauthor رخ می‌دهد). نشانگرهای فصل فقط
روی فایل بعدی اعمال می‌شوند. پیش‌فرض 0 است.
.TP
\fB-f \fImpeg-file\fB\fR
.TP
\fB--file=\fImpeg-file\fB\fR
.TP
\fB\fImpeg-file\fB\fR
یک فایل، لوله (pipe) یا دستور پوسته منتهی به | را مشخص می‌کند
که جریان سیستم MPEG-2 با بخش‌های VOB درج‌شده در مکان‌های
مناسب را تأمین می‌کند (ایجادشده با استفاده از mplex -f 8).
.TP
\fB-b \fIbuttondef\fB\fR
.TP
\fB--button=\fIX1xY1-X2xY2,commandlist\fB\fR
دکمه‌ای با اندازه مشخص‌شده ایجاد می‌کند. برای شرح \fIcommandlist\fR به
بخش «توضیحات زبان» مراجعه کنید.
.TP
\fB-i \fI[pre|post]=commandlist\fB\fR
.TP
\fB--instructions=\fI[pre|post]=commandlist\fB\fR
دستورالعمل‌های \fIcommandlist\fR را قبل از شروع
یا در انتهای منو/عنوان اجرا می‌کند. برای ساختار \fIcommandlist\fR به
بخش «توضیحات زبان» مراجعه کنید.
.SH "توضیحات XML (XML DESCRIPTION)"
.PP
ساختار پایه فایل کنترلی به این صورت است:

.nf
<dvdauthor [dest="\fIoutput-dir\fR"] [jumppad="1|on|yes" | allgprm="1|on|yes"] [format="ntsc|pal"] [provider="\fIprovider\fR"]>
   <vmgm>
      [<fpc>\fIcommands;\fR</fpc>]
      <menus [lang="\fIlanguage-code\fR"]>
         <video [format="ntsc|pal"] [aspect="4:3|16:9"]
                [resolution="\fIXxY\fR"] [caption="field1|field2"]
                [widescreen="nopanscan|noletterbox|crop"] />
         <audio [format="mp2|ac3|dts|pcm"] [channels="\fInumchannels\fR"]
                [quant="16bps|20bps|24bps|drc"] [dolby="surround"]
                [samplerate="48khz|96khz"] [lang="\fIlanguage\fR"]
                [content="normal|impaired|comments1|comments2"] />
         [<audio ... />]
         <subpicture [lang="\fIlanguage-code\fR"]>
            <stream mode="normal|widescreen|letterbox|panscan"
                [content="normal|large|children|normal_cc|large_cc|children_cc|forced|director|large_director|children_director"]
                id="\fIstreamid\fR" />
            [<stream ... />]
         </subpicture>
         [<subpicture ... />]
         <pgc [entry="title"] [palette="\fIyuvfile|rgbfile\fR"]
              [pause="\fIseconds\fR|inf"]>
            <subpicture>
               [<stream ... />]
            </subpicture>
            <pre> \fIcommands;\fR </pre>
            <vob file="\fIfile.mpg\fR" [chapters="\fIchapter-list\fR"]
                 [pause="\fIseconds\fR|inf"]>
                 <cell [start="\fItimestamp\fR"] [end="\fItimestamp\fR"]
                    [chapter="1|on|yes" | program="1|on|yes"] [pause="\fIseconds\fR|inf"]>
                    \fIcommands;\fR
                 </cell>
            </vob>
            [<vob ... />]
            <button [name="\fIbuttonname\fR"]> \fIcommands;\fR </button>
            [<button ... />]
            <post> \fIcommands;\fR </post>
         </pgc>
         [<pgc ... />]
      </menus>
      [<menus ... />]
   </vmgm>
   <titleset>
      <menus [lang="\fIlanguage-code\fR"]>
         [<video ... />]
         [<audio ... />]
         <pgc [entry="\fIentries\fR"]
              [palette="\fIyuvfile|rgbfile\fR"] [pause="\fIseconds\fR|inf"]>
            [...]
         </pgc>
         [<pgc ... />]
      </menus>
      [<menus ... />]
      <titles>
         [<video ... />]
         [<audio ... />]
         <pgc [entry="notitle"] [palette="\fIyuvfile|rgbfile\fR"] [pause="\fIseconds\fR|inf"]>
            [...]
         </pgc>
         [<pgc ... />]
      </titles>
   </titleset>
   [<titleset ... />]
</dvdauthor>
.fi
.PP
تفکیک بخش‌های فایل کنترلی:
.TP
\fB<dvdauthor [dest="\fIoutput-dir\fB"] [jumppad="1|on|yes" | allgprm="1|on|yes"] [format="ntsc|pal"] [provider="\fIprovider\fB"]>\fR
برنامه dvdauthor را آغاز می‌کند. مشخصه dest دایرکتوری محل نوشتن فایل‌ها توسط
.B dvdauthor
را تعیین می‌کند. این مشخصه با گزینه
.B \-o
بازنویسی می‌شود. شامل حداکثر یک تگ <vmgm> و هر تعداد تگ <titleset> است.
.TP
\fB<vmgm>\fR
.TP
\fB<titleset>\fR
ساختارهای یک مجموعه منوی سطح VMGM یا یک مجموعه عنوان (titleset).
شامل صفر یا چند تگ <menus> و در صورت titleset بودن، حداکثر یک تگ <titles> است.
.TP
\fB<menus [lang="\fIlanguage-code\fB"]>\fR
فهرستی از منوها با یک زبان مشترک را برای این مجموعه منوی VMGM
یا titleset مشخص می‌کند، که در اصطلاح
.B dvdauthor
یک «pgcgroup» نامیده می‌شود. شامل حداکثر یک تگ <video>،
حداکثر یک تگ <audio>، حداکثر یک تگ
<subpicture>، و هر تعداد تگ
<pgc> است.
.TP
\fB<titles>\fR
فهرست عنوان‌ها را برای این titleset مشخص می‌کند، که در
اصطلاح
.B dvdauthor
یک «pgcgroup» نامیده می‌شود. شامل حداکثر
یک تگ <video>، حداکثر هشت تگ
<audio>، حداکثر ۳۲ تگ
<subpicture>، و هر تعداد تگ
<pgc> است.
.TP
\fB<video [format="ntsc|pal"] [aspect="4:3|16:9"] [resolution="\fIXxY\fB"] [caption="field1|field2"] [widescreen="nopanscan|noletterbox|crop"] />\fR
پارامترهای ویدیویی را برای این pgcgroup به‌صورت دستی
پیکربندی می‌کند. اگر هر یک از این موارد تنظیم نشود، از
جریان منبع استنتاج خواهد شد. توجه داشته باشید که فرمت DVD تنها
به‌طور خاص از وضوح‌های 720x480، 704x480، 352x480 و 352x240 برای NTSC
و وضوح‌های 720x576، 704x576، 352x576 و 352x288 برای PAL پشتیبانی می‌کند،
اما dvdauthor محدوده وسیع‌تری از ورودی‌ها را می‌پذیرد و به نزدیک‌ترین اندازه گرد می‌کند.
.TP
\fB<audio [format="mp2|ac3|dts|pcm"] [channels="\fInumchannels\fB"] [dolby="surround"] [quant="16bps|20bps|24bps|drc"] [samplerate="48khz|96khz"] [lang="\fIlanguage\fB"] [content="normal|impaired|comments1|comments2"] />\fR
یک جریان صوتی را برای این pgcgroup به‌صورت دستی
پیکربندی می‌کند. برای هر جریان یک بار ذکر کنید. اکثر پارامترها به‌طور
خودکار از VOBهای منبع استنتاج می‌شوند، به جز پارامترهای PCM.
با این حال، زبان و محتوا باید به‌طور دستی مشخص شوند. توجه داشته باشید که امکان دارد
فقط مشخصه‌های lang و content را ذکر کرده و بگذارید
.B dvdauthor
بقیه موارد را پر کند.
.TP
\fB<subpicture [lang="\fIlanguage\fB"] [content="normal|large|children|normal_cc|large_cc|children_cc|forced|director|large_director|children_director"] />\fR
یک زیرتصویر/زیرنویس را برای این pgcgroup یا PGC به‌صورت دستی پیکربندی می‌کند.
در سطح pgcgroup، برای هر زبان یک بار ذکر کنید. مواردی که در سطح PGC می‌آیند
مشخصه lang یا content ندارند؛ آن‌ها این موارد را
از تگ <subpicture> متناظر در سطح pgcgroup به ارث می‌برند.
.TP
\fB<stream mode="normal|widescreen|letterbox|panscan" id="\fIstreamid\fB" />\fR
شناسه (ID) جریانی را مشخص می‌کند که بازنمایی این زیرتصویر
در یک حالت نمایش خاص است. این مورد را می‌توان به ازای هر PGC یا
در سطح کل pgcgroup مشخص کرد.
.TP
\fB<pgc [entry="\fIentries\fB"] [palette="\fIyuvfile|rgbfile\fB"] [pause="\fIseconds\fB|inf"]>\fR
یک PGC صرفاً اصطلاحی تخصصی برای یک منو یا یک
عنوان است. این مفهوم معنای خاصی در استاندارد DVD دارد، از این رو کاربرد آن
در اینجا حفظ شده است. PGCها می‌توانند دستوراتی داشته باشند که قبل از
شروع پخش یا پس از پایان آن اجرا شوند؛ تگ‌های <pre> و
<post> را در ادامه مشاهده کنید.

اگر PGC یک منو باشد، می‌توانید یک یا چند ورودی (entry) برای
آن مشخص کنید. این بدان معناست که اگر دکمه متناظر را روی کنترل
از راه دور DVD فشار دهید، به این منو هدایت می‌شود. برای منوی سطح VMGM، تنها
گزینه title است، که در کنترل‌ها متناظر با
دکمه منوی اصلی (top menu) است. برای منوی سطح titleset،
می‌توانید از root، subtitle، audio، angle و ptt استفاده کنید. اگر بیش از
یک مورد می‌خواهید، آن‌ها را با فاصله یا کاما جدا کنید. توجه داشته باشید که
ورودی root برای دستوراتی در نظر گرفته شده که از یک منوی سطح
VMGM به یک منوی titleset پرش می‌کنند.

اگر PGC درون یک titleset باشد، فرض می‌شود یک عنوان است مگر اینکه
entry="notitle" مشخص شده باشد.

تمام ماسک‌های دکمه و منو و تمام زیرنویس‌ها در یک PGC باید
از یک پالت رنگی یکسان ۱۶ رنگی استفاده کنند. اگر از
.B spumux
برای تولید بسته‌های زیرنویس/زیرتصویر استفاده کنید، اطلاعات رنگ
به‌طور خودکار به
.B dvdauthor
منتقل می‌شود؛ با این حال، اگر از ابزار زیرنویس‌ساز دیگری استفاده می‌کنید یا
می‌خواهید کنترل بیشتری روی پالت داشته باشید، می‌توانید آن را به‌صورت دستی
با مشخصه palette تعیین کنید. ۱۶ ورودی نخست
فایل باید ۱۶ رنگ پالت باشند که به‌صورت اعداد هگزادسیمال ۶ رقمی
نمایش‌دهنده تفکیک RGB (اگر نام فایل به \&.rgb ختم شود) یا تفکیک YUV (اگر
نام فایل به \&.rgb ختم نشود) هستند. پس از آن، اطلاعات گروه
دکمه را می‌توان به‌صورت جفت‌های اعداد هگزادسیمال ۸ رقمی فهرست کرد؛
حداکثر تا سه گروه دکمه قابل تعیین است.

اگر یک سکانس ویدیویی کوتاه دارید یا می‌خواهید ویدیو
در انتها مکث کند، می‌توانید از مشخصه pause برای
تنظیم تعداد ثانیه‌ها (به‌صورت عدد صحیح) از ۱ تا ۲۵۴ استفاده کنید. اگر
می‌خواهید ویدیو به‌طور نامحدود مکث کند، از
inf استفاده کنید.
.TP
\fB<pre> \fIcommands;\fB </pre>\fR
.TP
\fB<post> \fIcommands;\fB </post>\fR
دستوراتی را برای اجرا قبل یا بعد از پخش یک PGC
تعیین می‌کند. می‌توان از آن برای تکرار ویدیوی جاری (با داشتن توالی
<post> jump ... </post>)، یا برای
رد کردن شرطی برخی فصل‌ها در صورت تنظیم بودن یک پرچم استفاده کرد.
.TP
\fB<fpc> \fIcommands;\fB </fpc>\fR
دستوراتی را تعیین می‌کند که هنگام قرار دادن دیسک برای اولین بار در
دستگاه پخش اجرا می‌شوند (FPC = First Program Chain یا نخستین زنجیره برنامه). می‌توان از آن برای پرش
به یک منوی خاص یا مقداردهی اولیه ثبات‌ها هنگام راه‌اندازی استفاده کرد. اگر
مشخص نشود، یک زنجیره ضمنی ایجاد خواهد شد که به اولین
منوی یافت‌شده پرش می‌کند، یا اگر منویی وجود نداشته باشد به اولین عنوان می‌پرد.
.TP
\fB<vob file="\fIfile.mpg\fB" [chapters="\fIchapter-list\fB"] [pause="\fIseconds\fB|inf"] />\fR
یک فایل ویدیویی ورودی را برای یک منو یا عنوان، با نقاط فصل اختیاری و مکث در انتها مشخص می‌کند.
.TP
\fB<cell [start="\fItimestamp\fB"] [end="\fItimestamp\fB"] [chapter="1|on|yes" | program="1|on|yes"] [pause="\fIseconds\fB|inf"]> \fIcommands;\fB </cell>\fR
روشی دقیق‌تر برای تعیین نقاط نشانگر در یک عنوان. در صورت وجود،
تگ <vob> دربرگیرنده نباید مشخصه chapters داشته باشد.
یک سلول می‌تواند یک دستور ماشین مجازی (VM) متصل به خود داشته باشد تا هنگام پخش آن اجرا شود. اگر
مشخصه program تنظیم شده باشد، این سلول نقطه‌ای خواهد بود که
کاربر می‌تواند با استفاده از دکمه‌های prev/next روی کنترل از راه دور دستگاه DVD به آن بپرد. اگر
مشخصه chapter تنظیم شده باشد (متضمن تنظیم بودن program نیز
هست)، این سلول یک نقطه فصل نیز محسوب می‌شود.
.TP
\fB<button [name="\fIbuttonname\fB"]> \fIcommands;\fB </button>\fR
دستوراتی را مشخص می‌کند که هنگام انتخاب دکمه با نام مشخص‌شده توسط کاربر اجرا می‌شوند.
نام‌ها و موقعیت‌های دکمه را با
.B spumux
تعریف می‌کنید.
.SH "توضیحات زبان (LANGUAGE DESCRIPTION)"
.PP
زبان بسیار ساده است و تقریباً شبیه به C است.
.TP 0.2i
\(bu
دستورها با یک نقطه ویرگول (semicolon) خاتمه می‌یابند.
.TP 0.2i
\(bu
دستورها می‌توانند در چندین خط امتداد یابند.
.TP 0.2i
\(bu
چندین دستور می‌توانند در یک خط ظاهر شوند.
.TP 0.2i
\(bu
فاصله‌های خالی (فاصله، تب، خط جدید) اهمیت ندارند، مگر برای جداسازی کلمات کلیدی و شناسه‌ها.
.TP 0.2i
\(bu
توضیحات به سبک زبان C به شکل /* ... */ مجاز هستند. یا می‌توانید از توضیحات XML
به شکل <!-- مانند این --> استفاده کنید.
.SS "متغیرها (VARIABLES)"
.PP
ماشین مجازی DVD مقادیر ۱۶ بیتی را پردازش می‌کند. این ماشین حداکثر
از ۱۶ ثبات همه‌منظوره پشتیبانی می‌کند؛ با این حال
.B dvdauthor
تعداد ۳ ثبات را برای استفاده داخلی رزرو می‌کند. بنابراین ثبات‌های ۰ تا ۱۲ برای
استفاده در دسترس هستند و از آن‌ها با عنوان g0 تا
g12 یاد می‌شود.
.PP
همچنین ۲۴ ثبات سیستمی وجود دارد که می‌توان به آن‌ها با عنوان
s0 تا s23 اشاره کرد. همه این
ثبات‌ها قابل تنظیم نیستند. بسیاری از آن‌ها مترادف‌های یادافزا (mnemonic) دارند.
.TP
\fBaudio (s1, rw)\fR
جریان صوتی را مشخص می‌کند، در محدوده 0-7.
.TP
\fBsubtitle (s2, rw)\fR
تراک زیرنویس، در محدوده 0-31. اگر می‌خواهید زیرنویس همیشه
نمایش داده شود، باید مقدار ۶۴ را به آن اضافه کنید (یعنی 64-95 را انتخاب کنید). صرفاً
انتخاب تراک (0-31) به این معنی است که فقط زیرنویس‌های اجباری (forced)
نمایش داده می‌شوند، در حالی که فعال‌سازی تراک (64-95) به این معنی است که تمام
زیرنویس‌ها نمایش داده خواهند شد. این ویژگی به شما اجازه می‌دهد زیرنویس‌های اجباری را
تنها برای بخش‌هایی از فیلم که بازیگران به زبان خارجی (برای بیننده) صحبت می‌کنند فعال کنید،
اما همچنان زیرنویس‌های عادی را برای افراد کم‌شنوا داشته باشید. بینندگان کم‌شنوا
تراک را فعال می‌کنند (64-95) در حالی که سایر بینندگان فقط تراک را انتخاب می‌کنند
(0-31) و به این ترتیب می‌توانند از یک تراک مشترک
استفاده کنند.
.TP
\fBangle (s3, rw)\fR
زاویه دید (angle) را انتخاب می‌کند (در حال حاضر آزمایش‌نشده).
.TP
\fBbutton (s8, rw)\fR
دکمه‌ای که در حال حاضر هایلایت شده است را مشخص می‌کند. توجه داشته باشید که مقدار در
۱۰۲۴ ضرب می‌شود، بنابراین دکمه اول ۱۰۲۴، دکمه دوم ۲۰۴۸
و به همین ترتیب است.
.SS "عبارت‌ها (EXPRESSIONS)"
.PP
عبارت‌ها از نحو معمول C پیروی می‌کنند، به جز اینکه مقادیر بولی به
اعداد صحیح و برعکس قابل تبدیل نیستند. عملگرها و مقایسه‌ها
عبارتند از:
.PP
==, !=, >=, >, <=, <, &&, ||, !, eq, ne, ge, gt, le, lt, and, or, xor, not, +, -, *, /, %, &, |, ^
.PP
از آنجا که کد درون XML محصور شده است، تجزیه‌کننده هر کاراکتر
< اسکیپ‌نشده را (یعنی اگر به صورت "&lt;" نوشته نشود) به عنوان خطا می‌گیرد، بنابراین کلمات اختصاری الفبایی
برای تمام عملگرهای مقایسه جهت یکدستی ارائه شده‌اند. همچنین می‌توانید کد را
درون یک بخش <![CDATA[ ... ]]> قرار دهید.
.PP
همچنین یک تابع عددی وجود دارد:
.TP
\fBrandom(\fIEXPRESSION\fB)\fR
یک عدد شبه‌تصادفی، بین ۱ و عدد
ارائه‌شده، به‌صورت شامل دو سر بازه محاسبه می‌کند.
.SS "بلاک‌ها (BLOCKS)"
.PP
بلاک‌ها یا یک دستور تکی (منتهی به
نقطه ویرگول) هستند، یا گروهی از دستورها که درون آکولاد محصور شده‌اند. برای
مثال:
.TP 0.2i
\(bu
.nf
g3 = s7;
.fi
.TP 0.2i
\(bu
.nf
{
  audio = 1;
  subtitle = 65;
  jump vmgm menu 3;
}
.fi
.SS "دستورها (STATEMENTS)"
.PP
دستورهای پشتیبانی‌شده در حال حاضر نسبتاً ساده هستند.
.TP
\fB\fIVARIABLE\fB = \fIEXPRESSION\fB;\fR
یک متغیر را برابر با نتیجه یک معادله قرار می‌دهد.
.TP
\fBif (\fIEXPRESSION\fB) \fIBLOCK;\fB\fR
.TP
\fBif (\fIEXPRESSION\fB) \fIBLOCK;\fB else \fIBLOCK;\fB\fR
عبارت را محاسبه می‌کند؛ اگر درست باشد،
بلاک کد را اجرا می‌کند.
.TP
\fBjump \fITARGET\fB;\fR
.TP
\fBcall \fITARGET\fB [resume \fICELL\fB];\fR
.TP
\fBresume;\fR
به یک عنوان یا منوی خاص پرش می‌کند، یا منوی
خاصی را فراخوانی می‌کند، یا به عنوان فراخواننده بازمی‌گردد. شما فقط می‌توانید
یک call را از یک عنوان به یک منو اجرا کنید؛ تمام اشکال دیگر غیرمجاز هستند.
هدف از استفاده از call به جای
jump (علاوه بر این واقعیت که آن‌ها از فهرستی از مقصدهای مانعةالجمع پشتیبانی می‌کنند)
این است که به منو اجازه دهد با استفاده از resume به نقطه‌ای از
عنوان که فراخوانی از آنجا آغاز شده بود
بازگردد. می‌توانید سلول بازگشت را با استفاده از کلمه کلیدی resume به‌صورت
دستی مشخص کنید، اما اگر مقداری مشخص نکنید و از این
دستور در یک بلاک دستورالعمل post استفاده کنید،
سلول ۱ فرض خواهد شد.
.SS "مقصدها (TARGETS)"
.PP
موارد زیر مقصدهای ممکن هستند (توجه داشته باشید که منوها
فصل ندارند):
.TP
\fB[vmgm | titleset \fIX\fB] menu\fR
.TP
\fB[vmgm | titleset \fIX\fB] menu \fIY\fB\fR
.TP
\fB[vmgm | titleset \fIX\fB] menu entry \fIZ\fB\fR
منوی پیش‌فرض، منوی شماره Y، یا منویی که به عنوان ورودی Z مشخص شده است را به عنوان مقصد تعیین می‌کند. منو در دامنه VMGM یا titleset قرار دارد. اگر می‌خواهید منویی را در دامنه جاری مقصد قرار دهید، می‌توانید از ذکر نام دامنه صرف‌نظر کنید.
.TP
\fB[titleset \fIX\fB] title \fIY\fB [chapter \fIZ\fB]\fR
یک عنوان یا فصلی در یک عنوان را به عنوان مقصد تعیین می‌کند. شماره‌گذاری
از ۱ شروع می‌شود. تمام عنوان‌های روی دیسک در دامنه VMGM قابل دسترسی
هستند، یا می‌توانید در عوض بر حسب titleset به آن‌ها
دسترسی پیدا کنید.
.TP
\fBpgc \fIZ\fB\fR
یک PGC را در VMGM یا titleset جاری مقصد قرار می‌دهد.
.TP
\fBchapter \fIZ\fB\fR
فصلی در عنوان جاری را مقصد قرار می‌دهد.
.TP
\fBprogram \fIZ\fB\fR
.TP
\fBcell \fIZ\fB\fR
یک برنامه یا سلول را در PGC جاری مقصد قرار می‌دهد. می‌توانید از
این مورد برای ایجاد منوهای تکرارشونده در حلقه استفاده کنید: jump cell
1;
.TP
\fBcell top\fR
.TP
\fBnext cell\fR
.TP
\fBprev cell\fR
.TP
\fBprogram top\fR
.TP
\fBnext program\fR
.TP
\fBprev program\fR
.TP
\fBpgc top\fR
.TP
\fBnext pgc\fR
.TP
\fBprev pgc\fR
.TP
\fBup pgc\fR
.TP
\fBpgc tail\fR
(فقط در Jump) انتقال‌های نسبی کنترل را درون منو/عنوان جاری انجام می‌دهد.
عبارت "cell/program/pgc top" به ابتدای سلول/برنامه/PGC جاری بازمی‌گردد؛
عبارت "next/prev cell/program/pgc" به سلول/برنامه/PGC بعدی یا قبلی می‌رود؛
عبارت "up pgc" به PGC بالادست («up») می‌رود (در حال حاضر در
.B dvdauthor
قابل تنظیم نیست)؛ و "pgc tail" به توالی
<post> در PGC جاری می‌رود.
.PP
فصل‌ها از ۱ در هر عنوان شماره‌گذاری می‌شوند، در حالی که برنامه‌ها از
۱ در هر PGC شماره‌گذاری می‌شوند. بنابراین، وقتی بیش از یک PGC در یک عنوان وجود دارد،
شماره‌گذاری برنامه‌ها می‌تواند مستقل از فصل‌ها بازنشانی شود.
.SH "محدودیت‌ها (LIMITATIONS)"
.PP
محدودیت‌های زیر توسط استاندارد DVD-Video اعمال می‌شوند.
.PP
بیش از ۹۹ titleset، بیش از ۹۹ منو در VMG
یا یک titleset، و بیش از ۹۹ عنوان در یک titleset نمی‌تواند وجود داشته باشد.
.PP
هر عنوان می‌تواند از حداکثر ۹۹۹ PGC تشکیل شود. هر PGC می‌تواند شامل حداکثر ۲۵۵ برنامه باشد.
بخش‌های <pre> و <post> یک PGC
در مجموع نمی‌توانند بیش از ۱۲۸ دستور ماشین مجازی (VM) داشته باشند.
.PP
از آنجا که تنها یک فایل VOB به نام (VIDEO_TS.VOB) در VMG وجود دارد،
کل مقدار ویدیو در منوهای VMG باید در ۱۰۷۳۷۰۹۰۵۶ بایت (۵۲۴۲۷۲
بخش ۲ کیبی‌بایتی) جا شود. در هر titleset، تمام ویدیوی منو باید در اولین VOB
به نام (VTS_nn_0.VOB) جا شود، بنابراین به همان مقدار محدود است.
.SH "نویسندگان (AUTHORS)"
.PP
Marc Leeman
<marc.leeman@gmail.com>
MarcLeeman2003Marc Leeman