.TH "oggz-chop" "1" 
.SH "نام (NAME)"
oggz-chop \- استخراج بخشی از یک فایل Ogg بین زمان‌های شروع و/یا پایان داده‌شده
 
.SH "خلاصه دستور (SYNOPSIS)"
.PP 
\fBoggz-chop\fR [\-o \fBfilename\fR  | \-\-output \fBfilename\fR ]  [\-s \fBstart_time\fR  | \-\-start \fBstart_time\fR ]  [\-e \fBend_time\fR  | \-\-end \fBend_time\fR ]  [\-k  | \-\-no-skeleton ] filename  
.PP 
\fBoggz-chop\fR [\-h  | \-\-help ]  [\-v  | \-\-version ]  
.SH "توضیحات (DESCRIPTION)"
.PP 
\fBoggz-chop\fR بخشی از یک فایل Ogg را برش می‌دهد. 
این ابزار برچسب‌های زمانی granulepos را در جریان‌های بیتی 
Ogg CELT، CMML، Dirac، FLAC، Kate، Opus، PCM، Speex، Theora، Vorbis و VP8 
به‌درستی تفسیر می‌کند. 
برای مشاهده فهرست کامل کُدک‌های شناخته‌شده توسط نسخه نصب‌شده oggz، فرمان 
\fBoggz-known-codecs\fP\fB(1)\fP را اجرا کنید. 
 
.PP 
فایل خروجی شامل رونوشت‌هایی از سرایندهای فایل ورودی، و تمام داده‌های کُدک 
مورد نیاز برای رمزگشایی صحیح محتوا بین زمان‌های شروع و پایان مشخص‌شده 
در خط فرمان است. برای کُدک‌هایی با وابستگی‌های داده‌ای مانند فریم‌های کلیدی ویدیو، 
فریم کلیدی پیش از زمان شروع در خروجی گنجانده خواهد شد. 
 
.PP 
توجه داشته باشید که \fBoggz-chop\fR از طریق رونوشت‌برداری از صفحه‌های داده 
Ogg عمل می‌کند؛ این ابزار بسته‌های جزئی را از اولین یا آخرین صفحه داده 
قرارگرفته در خروجی حذف نمی‌کند. با این حال اطمینان حاصل می‌کند که پرچم 
پایان جریان (end of stream flag) روی آخرین صفحه از هر جریان بیتی منطقی تنظیم شود. 
 
.PP 
مدیریت Skeleton: به‌طور پیش‌فرض، خروجی شامل یک شیار Skeleton خواهد بود 
که شروع برش را به‌عنوان زمان نمایش (presentation time) مشخص می‌کند. 
 
.SH "گزینه‌ها (OPTIONS)"
.PP 
\fBoggz-chop\fR گزینه‌های زیر را می‌پذیرد: 
 
.SS "گزینه‌های خروجی (Output options)" 
.IP "\-o \fBfilename\fR, \-\-output \fBfilename\fR" 10 
نوشتن خروجی در \fBfilename\fR مشخص‌شده به جای چاپ آن در خروجی استاندارد. 
 
.IP "\-s \fBstart_time\fR, \-\-start \fBstart_time\fR" 10 
مشخص کردن زمان شروع بخش برش‌داده‌شده برای خروجی. 
 
.IP "\-e \fBend_time\fR, \-\-end \fBend_time\fR" 10 
مشخص کردن زمان پایان بخش برش‌داده‌شده برای خروجی. 
 
.IP "\-k , \-\-no-skeleton" 10 
جریان بیتی Skeleton در خروجی گنجانده نشود. 
 
.IP "\-h, \-\-help" 10 
نمایش اطلاعات نحوه استفاده و خروج. 
.IP "\-v, \-\-version" 10 
نمایش اطلاعات نسخه و خروج. 

.SH "مثال‌ها (EXAMPLES)"
.PP
استخراج دقیقه اول از file.ogx:
.PP
.RS
\f(CWoggz chop \-e 1:00 file.ogx\fP
.RE
.PP
استخراج از دقیقه دوم تا دقیقه پنجم file.ogx:
.PP
.RS
\f(CWoggz chop \-s 2:00 \-e 5:00 \-o output.ogx file.ogx\fP
.RE
.PP
استخراج با تعیین آفست فریم‌های SMPTE-25:
.PP
.RS
\f(CWoggz chop \-s smpte\-25:00:02:03::12 \-e smpte\-25:00:05:02::04 \-o output.ogv file.ogv\fP
.RE

.SH "پیکربندی سرور (SERVER CONFIGURATION)" 
.PP 
پیکربندی زیر برای Apache httpd ابزار oggz-chop را فعال خواهد کرد. همانند بیشتر 
دستورالعمل‌های Apache، این تنظیمات البته می‌توانند به دایرکتوری‌ها یا مکان‌های (Locations) 
خاصی محدود شوند: 
.PP 
ScriptAlias /oggz-chop /usr/bin/oggz-chop 
 
.PP 
Action application/ogg /oggz-chop 
 
.SS "قابلیت ذخیره‌سازی موقت HTTP/1.1 (HTTP/1.1 Cacheability)" 
.PP 
ابزار oggz-chop سرایندهای HTTP از نوع Last-Modified را تولید کرده و 
به درخواست‌های مشروط GET حاوی If-Modified-Since به‌درستی پاسخ می‌دهد. 
 
.SH "نویسندگان (AUTHORS)"
.PP 
Conrad Parker        February 25, 2008;      
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.PP 
Copyright \(co 2008 Annodex Association 
 
.SH "همچنین ببینید (SEE ALSO)"
.PP 
\fBoggz-validate\fP\fB(1)\fP, 
\fBoggz-merge\fP\fB(1)\fP, 
\fBoggz-dump\fP\fB(1)\fP, 
\fBhogg\fP\fB(1)\fP      
.\" created by instant / docbook-to-man, Mon 23 Feb 2009, 12:35