.TH OGMINFO "1" "نوامبر 2004" "ogminfo v1.5" "دستورهای کاربر"
.SH "نام (NAME)"
ogminfo \- نمایش اطلاعات مربوط به جریان‌ها در فایل‌های OGG/OGM
.SH "خلاصه دستور (SYNOPSIS)"
.B ogminfo
[\fIگزینه‌ها\fR] \fIinname\fR
.SH "توضیحات (DESCRIPTION)"
.LP
این برنامه تمام جریان‌های (streams) موجود در یک فایل OGM را به همراه اطلاعات مربوط به کُدک‌های استفاده‌شده فهرست می‌کند.
.TP
inname
استفاده از '\fIinname\fR' به‌عنوان منبع.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
حالت پرگو و نمایش هر بسته OGG. برای جزئیات به بخش '\fBسطوح پرگویی (VERBOSITY LEVELS)\fR' مراجعه کنید.
.TP
\fB\-s\fR, \fB\-\-summary\fR
چاپ خلاصه‌ای کوتاه برای هر جریان، شامل اندازه کل به بایت، نرخ بیت (bitrate)، تعداد بسته‌ها/فریم‌ها و طول مدت به ثانیه. این گزینه نیازمند تحلیل (parsing) کامل فایل است.
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش اطلاعات نحوه استفاده.
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش اطلاعات نسخه.
.SH "سطوح پرگویی (VERBOSITY LEVELS)"
.LP
گزینه \fB\-v\fR می‌تواند برای افزایش سطح پرگویی \fBogminfo\fR و چاپ اطلاعات بیشتر درباره فایل جاری استفاده شود.
.TP
سطح 0
تنها جریان‌هایی را که پیدا می‌کند و انواع آن‌ها را چاپ خواهد کرد.
.TP
سطح 1
همچنین محتویات سرایند (header) و بسته‌های توضیحات (comment packets) هر جریان را چاپ خواهد کرد. این دو حالت (برخلاف تمام حالت‌های دیگر) در صورتی که بسته‌های توضیحات به‌درستی قرار گرفته باشند، کل فایل را پردازش نخواهند کرد.
.TP
سطح 2
برای هر بسته OGG که با آن مواجه شود، سطری شامل جریانی که بسته به آن تعلق دارد، اندازه بار داده (payload size)، مقدار granulepos بسته، شماره بسته، زمان شروع، زمان پایان و چند پرچم (flag) را چاپ خواهد کرد. پرچم‌ها ممکن است شامل 'sync_ok' یا 'OUT_OF_SYNC' باشند که نشان می‌دهد آیا جای‌گیری بسته در فایل بر اساس granulepos آن صحیح است یا خیر. پرچم‌های دیگر 'IS_SYNCPOINT' یا 'EOS' هستند.
.br
سطح 2 و بالاتر به‌طور خودکار \fB\-\-summary\fR را اعمال می‌کنند.
.TP
سطح 3
همچنین هر زمان که یک صفحه OGG جدید به‌طور کامل خوانده شود، سطری را همراه با موقعیت دقیق صفحه در فایلی که از آن خوانده شده چاپ می‌کند.
.TP
سطح 4
کل ساختار stream_header یافت‌شده در بسته سرایند را برای هر جریان غیر Vorbis تخلیه (dump) می‌کند.
.LP
سطوح 3 و 4 تنها برای اهداف اشکال‌زدایی (debugging) در نظر گرفته شده‌اند.
.LP
.SH "نکات (NOTES)"
آنچه کار می‌کند:
.TP
*
فایل‌های OGM با صدای Vorbis، ویدیوی «عادی» (مانند DivX و غیره)، جریان‌های صوتی (PCM، MP3 و غیره)، جریان‌های متنی (زیرنویس‌ها).
.LP
آنچه کار نمی‌کند:
.TP
*
سرایندهای ایجادشده توسط نسخه‌های قدیمی‌تر فیلتر OggDS (DirectShow) پشتیبانی نمی‌شوند (و احتمالاً هرگز پشتیبانی نخواهند شد).
.SH "نویسندگان (AUTHORS)"
برنامه
.I ogminfo
توسط Moritz Bunkus <moritz@bunkus.org> نوشته شده است.
.SH "همچنین ببینید (SEE ALSO)"
.BR ogmmerge (1),
.BR ogmsplit (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