'\"
.\" @(#)cdda2ogg.1	1.5 10/09/21 Copyright 2010 J. Schilling
.\"
.\" The contents of this file are subject to the terms of the
.\" Common Development and Distribution License, Version 1.0 only
.\" (the "License").  You may not use this file except in compliance
.\" with the License.
.\"
.\" See the file CDDL.Schily.txt in this distribution for details.
.\"
.\" When distributing Covered Code, include this CDDL HEADER in each
.\" file and include the License file CDDL.Schily.txt from this distribution.
.\"
.if t .ds a \v'-0.55m'\h'0.00n'\z.\h'0.40n'\z.\v'0.55m'\h'-0.40n'a
.if t .ds o \v'-0.55m'\h'0.00n'\z.\h'0.45n'\z.\v'0.55m'\h'-0.45n'o
.if t .ds u \v'-0.55m'\h'0.00n'\z.\h'0.40n'\z.\v'0.55m'\h'-0.40n'u
.if t .ds A \v'-0.77m'\h'0.25n'\z.\h'0.45n'\z.\v'0.77m'\h'-0.70n'A
.if t .ds O \v'-0.77m'\h'0.25n'\z.\h'0.45n'\z.\v'0.77m'\h'-0.70n'O
.if t .ds U \v'-0.77m'\h'0.30n'\z.\h'0.45n'\z.\v'0.77m'\h'-0.75n'U
.if t .ds s \\(*b
.if t .ds S SS
.if n .ds a ae
.if n .ds o oe
.if n .ds u ue
.if n .ds s sz
.if t .ds m \\(*m
.if n .ds m micro
.TH "cdda2ogg" 1 "Version 3.0"
.SH "نام (NAME)"
cdda2ogg \- استخراج قطعات صوتی از سی‌دی و تبدیل آن‌ها به فرمت Ogg
.SH "خلاصه دستور (SYNOPSIS)"
.PP
.B cdda2ogg
[
.I options
][
.BI dev= device
]
.RI [ "file prefix" ]
.RI [ "ogg opts" ]
.PP
.B cdda2mp3
[
.I options
][
.BI dev= device
]
.RI [ "file prefix" ]
.RI [ "lame opts" ]
.SH "توضیحات (DESCRIPTION)"
.PP
اسکریپت
.B cdda2ogg
از دستور
.B cdda2wav
برای استخراج تمام قطعات صوتی استفاده کرده و آن‌ها را با استفاده از انکودر
.B Ogg Vorbis
یعنی
.BR oggenc (1)
کدگذاری می‌کند.
.PP
اسکریپت
.B cdda2mp3
از دستور
.B cdda2wav
برای استخراج تمام قطعات صوتی استفاده کرده و آن‌ها را با استفاده از انکودر
.B MP3
یعنی
.BR lame (1)
کدگذاری می‌کند.
.PP
هنوز پشتیبانی از CDDB وجود ندارد.

.SH "گزینه‌ها (OPTIONS)"
.TP 12
.B \-help
یک پیام راهنمای کوتاه درباره نحوه استفاده نمایش داده و خارج می‌شود.
.TP
.BI dev= device
دستگاهی که داده‌ها باید از آن خوانده شوند. اگر فقط یک درایو CD-ROM در سیستم وجود داشته باشد، می‌توان از گزینه
.B dev=
صرف‌نظر کرد. برای مقادیر ممکن پارامتر
.IR device ،
صفحه راهنمای
.BR cdrecord (1)
را ببینید.
.TP
.B \-*
هر گزینه دیگری که با علامت «-» شروع شود، به برنامه
.B cdda2wav
ارسال می‌شود.
.PP
هر گزینه دیگری پس از آرگومان
.B file prefix
که با علامت «-» شروع شود، به برنامه انکودر ارسال می‌شود.
.PP
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
متغیرهای محیطی زیر می‌توانند برای تغییر رفتار دستورات
.B cdda2ogg
و
.B cdda2mp3
استفاده شوند:
.TP
.B CDDA2WAV
دستور مورد استفاده برای استخراج داده‌های WAV از سی‌دی را تعیین می‌کند.
مقدار پیش‌فرض
.BR cdda2wav
است.
.TP
.B CDDA2WAV_OPTS
گزینه‌های ارسالی به برنامه CDDA را هنگام استخراج از سی‌دی تعیین می‌کند.
مقدار پیش‌فرض
.BR "\-H \-q"
است.
.TP
.B MP_CODER
برنامه انکودر مورد استفاده برای فشرده‌سازی داده‌های صوتی.
مقدار پیش‌فرض برای
.B cdda2ogg
برابر با
.B oggenc
و برای
.B cdda2mp3
برابر با
.BR lame
است.
.TP
.B MP_OPTIONS
گزینه‌های ارسالی به برنامه انکودر.
مقدار پیش‌فرض خالی است.
.TP
.B FILEPREFIX
بخش اصلی نام فایل برای فایل‌های صوتی حاصل.
اگر هیچ آرگومان
.I file prefix
در خط فرمان داده نشده باشد، نام فایل پیش‌فرض برای
.B cdda2ogg
برابر با
.B $TRACK-$FILEPREFIX.ogg
و برای
.B cdda2mp3
برابر با
.B $TRACK-$FILEPREFIX.mp3
خواهد بود.
.ne 15
.SH "فایل‌ها (FILES)"
.PP
در صورت وجود فایل‌های زیر، اسکریپت‌ها آن‌ها را بارگذاری (source) می‌کنند
تا مقادیر پیش‌فرض محلی را تنظیم نمایند:
.TP
.B /etc/default/cdda2ogg
جهت تنظیم مقادیر پیش‌فرض برای
.BR cdda2ogg .
.TP
.B /etc/default/cdda2mp3
جهت تنظیم مقادیر پیش‌فرض برای
.BR cdda2mp3 .
.PP
محتوای آن‌ها می‌تواند برای تغییر متغیرهای محیطی یا اعمال تنظیمات پیش‌فرض محلی به کار رود.

.SH "همچنین ببینید (SEE ALSO)"
.BR cdda2wav (1),
.BR cdrecord (1),
.BR oggenc (1),
.BR lame (1).
.SH "نکات (NOTES)"
.PP
اگر یک سی‌دی دارای یک قطعه صوتی مخفی قبل از قطعه ۱ باشد، فایلی با شماره قطعه 00 حاوی محتوای این قطعه مخفی ایجاد می‌شود.
.PP
برنامه
.BR oggenc (1)
بخشی از پروژه
.B vorbis-tools
است.
برای اطلاعات بیشتر
.B http://www.vorbis.com
را ببینید.
.sp
برنامه
.BR lame (1)
بخشی از پروژه
.B lame
است.
برای اطلاعات بیشتر
.B http://lame.sourceforge.net
را ببینید.
.SH "نویسنده (AUTHOR)"
.PP
نسخه‌های اولیه این اسکریپت‌ها بر اساس مقاله‌ای خبری از Tom Kludy نوشته شده بودند.