.TH "oggdec" "1" "2008 September 9" "Xiph.Org Foundation" "Vorbis Tools"

.SH "نام (NAME)"
oggdec \- رمزگشای ساده برای تبدیل فایل‌های Ogg Vorbis به فایل‌های صوتی PCM (قالب Wave یا RAW)

.SH "خلاصه دستور (SYNOPSIS)"
.B oggdec
[
.B -Qhv
] [
.B -b bits_per_sample
] [
.B -e endianness
] [
.B -R
] [
.B -s signedness
] [
.B -o outputfile
] 
.B file ...

.SH "توضیحات (DESCRIPTION)"

.B oggdec
فایل‌های Ogg Vorbis را به فایل‌های صوتی با کدگذاری PCM («فشرده‌نشده») در قالب Wave یا RAW رمزگشایی می‌کند.

برای هر فایل ورودی، 
.B oggdec
خروجی را در فایلی با نام برگرفته از نام فایل ورودی و تغییر پسوند آن به «.wav» یا «.raw» بر حسب نیاز، می‌نویسد.

اگر فایل ورودی به صورت
.B "-"
مشخص شود، آن‌گاه 
.B oggdec
داده‌ها را از stdin خوانده و در stdout می‌نویسد، مگر اینکه نام فایل خروجی مشخص شده باشد. به همین ترتیب، تعیین
.B -
به عنوان فایل خروجی موجب ارسال خروجی به stdout می‌شود.

نوشتن قالب Wave در stdout ایدهٔ مناسبی نیست. قالب Wave نیازمند یک رسانه با قابلیت جست‌وجو (seekable) است تا سرآیند (header) پس از نوشتن تمام داده‌ها مجدداً بازنویسی شود؛ خروجی استاندارد (stdout) فاقد قابلیت جست‌وجو است.

.SH "گزینه‌ها (OPTIONS)"
.IP "-Q, --quiet"
خروجی برنامه را فرونشانی (بی‌صدا) می‌کند.
.IP "-h, --help"
پیام راهنما را چاپ می‌کند.
.IP "-V, --version"
اطلاعات نسخه را نمایش می‌دهد.
.IP "-b n, --bits=n"
تعداد بیت در هر نمونه (Bits per sample). مقادیر معتبر 8 یا 16 هستند.
.IP "-e n, --endian=n"
ترتیب بایت‌ها (endianness) را برای خروجی ۱۶ بیتی تعیین می‌کند. مقدار 0 (پیش‌فرض) little-endian (ترتیب بایت Intel) است. مقدار 1 big-endian (ترتیب بایت استاندارد) است.
.IP "-R, --raw"
خروجی در قالب raw. در صورت عدم تعیین، فایل Wave (همراه با سرآیند RIFF) نوشته می‌شود.
.IP "-s n, --sign=n"
علامت‌دار بودن خروجی را مشخص می‌کند. 0 برای بدون علامت (unsigned) و 1 (پیش‌فرض) برای علامت‌دار (signed).
.IP "-o filename, --output=filename"
خروجی را در نام فایل مشخص‌شده می‌نویسد. این گزینه تنها زمانی معتبر است که یک [فایل] ورودی تعیین شده باشد، یا اینکه حالت raw به کار رفته باشد.

.SH "مثال‌ها (EXAMPLES)"
رمزگشایی یک فایل 
.B enabler.ogg
به 
.B enabler.wav
به صورت ۱۶ بیتی علامت‌دار با ترتیب بایت little-endian (گزینه‌های پیش‌فرض):
.RS
oggdec enabler.ogg
.RE

رمزگشایی یک فایل 
.B enabler.ogg
به 
.B enabler.raw
به صورت ۱۶ بیتی علامت‌دار بدون سرآیند با ترتیب بایت little-endian:
.RS
oggdec --raw enabler.ogg
.RE

رمزگشایی 
.B enabler.ogg
به 
.B enabler.crazymonkey
به صورت ۸ بیتی بدون علامت:
.RS
oggdec -b 8 -s 0 -o enabler.crazymonkey enabler.ogg
.RE

رمزگشایی 
.B enabler.ogg
به 
.B enabler.raw
به صورت ۱۶ بیتی علامت‌دار با ترتیب بایت big-endian (با هر یک از روش‌های زیر):
.RS
oggdec -R -e 1 -b 16 enabler.ogg
.RE
.RS
oggdec -R -e 1 -b 16 -o enabler.raw - < enabler.ogg
.RE
.RS
oggdec -R -e 1 -b 16 - < enabler.ogg > enabler.raw
.RE

رمزگشایی گروهی (تبدیل foo.ogg به foo.wav، bar.ogg به bar.wav، quux.ogg به quux.wav و غیره):
.RS
oggdec *.ogg
.RE

.SH "نویسندگان (AUTHORS)"
.SS "نویسندگان برنامه"
Michael Smith <msmith@xiph.org>
.SS "نویسندگان صفحه راهنما"

.br

Frederick Lee <phaethon@linux.ucla.edu>، با همراهی چند میلیون میمون مجهز به صفحه‌کلید در irc://irc.openprojects.net/#vorbis

.SH "همچنین ببینید (SEE ALSO)"

.PP
\fBogg123\fR(1), \fBoggenc\fR(1), \fBvorbiscomment\fR(1), \fBflac\fR(1), \fBspeexdec\fR(1)