.TH OGMSPLIT "1" "نوامبر 2004" "ogmsplit v1.5" "دستورهای کاربری"
.SH "نام (NAME)"
ogmsplit \- تقسیم فایل‌های OGG/OGM به چندین فایل کوچک‌تر OGG/OGM
.SH "خلاصه دستور (SYNOPSIS)"
.B ogmsplit
[\fIگزینه‌ها\fR] \fIinname\fR
.SH "توضیحات (DESCRIPTION)"
.LP
دستور \fBogmsplit\fP می‌تواند برای تقسیم آسان یک فایل OGM پس از رسیدن به اندازه‌ای مشخص استفاده شود.
چندین فایل OGM ایجاد خواهند شد که هر کدام با یک فریم کلیدی (keyframe) آغاز می‌شوند.
.TP
inname
استفاده از «\fIinname\fR» به عنوان منبع ورودی.
.TP
\fB\-o\fR, \fB\-\-output\fR \fIout\fR
استفاده از «\fIout\fR» به عنوان نام پایه. شماره بخش‌ها به ترتیب صعودی به آن اضافه خواهد شد. مقدار پیش‌فرض «\fIinname\fR» است. مثال‌ها:
.br
۱) اگر \fB\-o\fR \fIoutput.ogg\fR در خط فرمان مشخص شود، \fBogmsplit\fR فایل‌های \fIoutput\-000001.ogg\fR و \fIoutput\-000002.ogg\fR و غیره را ایجاد خواهد کرد.
.br
۲) اگر هیچ گزینه \fB\-o\fR مشخص نشود و نام ورودی \fImovie.ogm\fR باشد، \fBogmsplit\fR فایل‌های \fImovie-000001.ogm\fR و غیره را ایجاد خواهد کرد.
.LP
حالت عملکرد را می‌توان با دقیقاً یکی از گزینه‌های \fB\-s\fR، \fB\-t\fR، \fB\-c\fR یا \fB\-p\fR تعیین کرد. حالت پیش‌فرض تقسیم بر اساس اندازه (\fB\-s\fR) است.
.TP
\fB\-s\fR, \fB\-\-size\fR \fIsize\fR
اندازه بر حسب مبی‌بایت (MiB = 1024 * 1024 بایت) که پس از آن (تقریباً) یک فایل جدید باز خواهد شد. مقدار پیش‌فرض 700MiB است.
اندازه می‌تواند با 'B' پایان یابد تا به جای 'MiB' نشان‌دهنده بایت ('bytes') باشد.
.TP
\fB\-t\fR, \fB\-\-time\fR \fItime\fR
تقسیم پس از زمان سپری‌شده مشخص (تقریباً).
شناسه «\fItime\fR» قالبی به صورت \fIHH:MM:SS.sss\fR یا صرفاً \fISS\fR(.\fIsss\fR) می‌گیرد، مانند 00:05:00.000 یا 300.000 یا به سادگی 300.
.TP
\fB\-c\fR, \fB--cuts\fR \fIcuts\fR
تولید فایل‌های خروجی مطابق با \fIcuts\fR؛ فهرستی از برش‌ها به صورت «\fIstart\fR\-\fIend\fR» یا «\fIstart\fR+\fIlength\fR» که با کاما از هم جدا شده‌اند. اگر \fIstart\fR حذف شود، به صورت پیش‌فرض پایان برش قبلی در نظر گرفته می‌شود. \fIstart\fR و \fIend\fR قالبی مشابه آرگومان‌های \fB\-t\fR دارند.
.TP
\fB\-n\fR, \fB\-\-num\fR \fInum\fR
بیش از \fInum\fR فایل جداگانه ایجاد نشود. آخرین فایل ممکن است بزرگ‌تر از اندازه مورد نظر باشد. مقدار پیش‌فرض تعداد نامحدود فایل است.
تنها همراه با \fB-s\fR یا \fB-t\fR قابل استفاده است.
.TP
\fB\-\-frontend\fR
حالت رابط کاربری (frontend). خروجی پیشرفت به جای \\r با \\n خاتمه می‌یابد.
.TP
\fB\-p\fR, \fB\-\-print-splitpoints\fR
تنها چاپ فریم‌های کلیدی و تعداد بایت‌های دیده‌شده پیش از هر فریم. برای یافتن نقطه تقسیم دقیق مفید است.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
نمایش خروجی با جزئیات کامل و نمایش تک‌تک بسته‌های OGG.
می‌تواند دو بار برای افزایش سطح جزئیات استفاده شود.
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش این راهنما.
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش اطلاعات نسخه.
.SH "اطلاعات فصل‌ها (CHAPTER INFORMATION)"
دستور \fBogmsplit\fR اطلاعات فصل‌ها را به درستی پردازش می‌کند. در گام اول، اطلاعات فصل (در صورت وجود) به گونه‌ای تنظیم می‌شود تا با فایل‌های خروجی تولیدشده منطبق باشد. فصل‌هایی که در فایل خروجی جاری وجود ندارند، به طور کامل حذف می‌شوند. سایر فصل‌ها دوباره شماره‌گذاری می‌شوند تا از ۱ آغاز شوند، و برچسب‌های زمانی آن‌ها مجدداً محاسبه خواهد شد.
.br
مثال: اگر فایل منبع شما حاوی این چهار فصل باشد:
.LP
CHAPTER01=00:00:00.000
.br
CHAPTER01NAME=Chapter 01
.br
CHAPTER02=00:10:00.000
.br
CHAPTER02NAME=Chapter 02
.br
CHAPTER03=00:20:00.000
.br
CHAPTER03NAME=Chapter 03
.br
CHAPTER04=00:25:00.000
.br
CHAPTER04NAME=Chapter 04
.LP
و شما فایل را پس از ۱۵ دقیقه تقسیم کنید، اولین فایل خروجی تنها شامل دو فصل اول خواهد بود همان‌طور که در بالا نشان داده شد، و دومین فایل خروجی شامل دو فصل بعدی و بخش باقی‌مانده از فصل اول خواهد بود:
.LP
CHAPTER01=00:00:00.000
.br
CHAPTER01NAME=Chapter 02 (continued)
.br
CHAPTER02=00:05:00.000
.br
CHAPTER02NAME=Chapter 03
.br
CHAPTER03=00:10:00.000
.br
CHAPTER03NAME=Chapter 04
.LP
توجه داشته باشید که تنها نام متغیرها تغییر می‌کنند، نه نام خود فصل‌ها. تنها استثنا اولین فصل از فایل دوم و فایل‌های بعدی است که عبارت «(continued)» به آن اضافه می‌شود تا نشان دهد این شروع این فصل نیست. اگر می‌خواهید آن‌ها را نیز تغییر دهید، باید فایل حاصل را مجدداً با یک فایل فصل جدید ادغام کنید.
.SH "نویسنده (AUTHOR)"
برنامه \fIogmsplit\fR توسط Moritz Bunkus <moritz@bunkus.org> نوشته شده است.
.SH "همچنین ببینید (SEE ALSO)"
.BR ogmmerge (1),
.BR ogminfo (1),
.BR ogmdemux (1),
.BR ogmcat (1),
.BR dvdxchap (1)
.SH "وب‌گاه (WWW)"
جدیدترین نسخه را همیشه می‌توان در نشانی زیر یافت:
.UR http://www.bunkus.org/videotools/ogmtools
<http://www.bunkus.org/videotools/ogmtools>
.UE