.\" cue2toc.1 - manual page for cue2toc .\" Copyright (C) 2004 Matthias Czapla .\" .\" This file is part of cue2toc. .\" .\" This program is free software; you can redistribute it and/or modify .\" it under the terms of the GNU General Public License as published by .\" the Free Software Foundation; either version 2 of the License, or .\" (at your option) any later version. .\" .\" This program is distributed in the hope that it will be useful, .\" but WITHOUT ANY WARRANTY; without even the implied warranty of .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the .\" GNU General Public License for more details. .\" .\" You should have received a copy of the GNU General Public License .\" along with this program; if not, write to the Free Software .\" Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA .\" .TH CUE2TOC 1 .SH "نام (NAME)" cue2toc \- تبدیل فرمت CUE به TOC .SH "خلاصه دستور (SYNOPSIS)" .BR "cue2toc" " [" "-hnqv" "] [" "-o" .IR "tocfile" "]" .RB "[" "-w" .IR "wavefile" "] [" "cuefile" "]" .SH "توضیحات (DESCRIPTION)" دستور .B Cue2toc پرونده .I cuefile را از قالب CUE به قالب TOC تبدیل کرده و نتیجه را در .IR "tocfile" "." می‌نویسد. اگر هر یک از پرونده‌های .IR "cuefile" " یا " "tocfile" مشخص نشوند یا یک خط تیره منفرد "-" قرار داده شود، .B cue2toc به ترتیب از ورودی استاندارد می‌خواند و در خروجی استاندارد می‌نویسد. فایل‌های CUE پرونده‌های متنی هستند که ساختار و چیدمان یک CD-Rom را توصیف می‌کنند و معمولاً پسوند ".cue" دارند. نرم‌افزار Cdrdao یک برنامه رایت CD است که قالب TOC بومی خود را برای توصیف ساختار دیسک دارد. هرچند cdrdao از خواندن مستقیم فایل‌های CUE پشتیبانی می‌کند، اما در حال حاضر این قابلیت تنها به شیارهای داده محدود است. بنابراین کاربرد اصلی .BR "cue2toc" در تبدیل فایل‌های CUE حاوی شیارهای صوتی است. خروجی داده‌های CD-Text را می‌توان با گزینه .B -n غیرفعال کرد. فایل‌های CUE اغلب همراه با فایل‌های MP3 ارائه می‌شوند، اما از آنجا که cdrdao از رمزگشایی همزمان و در لحظه آن‌ها پشتیبانی نمی‌کند، احتمالاً باید قبل از رایت CD با روش‌های دیگری (مثلاً با استفاده از .BR "lame" ")" رمزگشایی شوند. به همین دلیل می‌توانید با استفاده از گزینه .B -w یک نام فایل مشخص کنید تا به‌جای نام فایل موجود در پرونده CUE، برای تمامی شیارهای صوتی استفاده شود. البته این ویژگی تنها زمانی واقعاً مفید است که تمام شیارها مبتنی بر همان فایل یکسان باشند؛ با این حال به نظر می‌رسد این مورد در اکثر مواقع صادق است. دستور .B Cue2toc به‌طور معمول پیام‌های هشداری را برای دستورات و ساختارهای پشتیبانی‌نشده نمایش می‌دهد. گزینه .B -q این هشدارها را غیرفعال می‌کند. .SH "گزینه‌ها (OPTIONS)" .TP .B -h نمایش یک پیام راهنمای کوتاه .TP .B -n بدون CD-Text؛ غیرفعال کردن خروجی اطلاعات CD-Text .TP .BI "-o " "tocfile" نوشتن نتیجه در .I tocfile به‌جای خروجی استاندارد .TP .B -q حالت بی‌صدا؛ هشداری چاپ نشود .TP .B -v نمایش شماره نسخه .TP .BI "-w " "wavefile" استفاده از .I wavefile برای تمامی شیارهای صوتی .SH "قالب CUE (CUE FORMAT)" آنچه در ادامه می‌آید توصیفی از قالب CUE مورد انتظار .BR "cue2toc" است. برای اطلاعات بیشتر در مورد قالب TOC لطفاً به صفحه راهنمای .BR "cdrdao" "(1)" مراجعه فرمایید. فایل‌های CUE شامل دستورات و آرگومان‌های آن‌ها هستند که باید با هر تعداد نویسه فاصله خالی (whitespace) از یکدیگر جدا شوند. فاصله (Space)، تب افقی، خط جدید (newline) و بازگشت به ابتدای خط (carriage return) به عنوان نویسه‌های فاصله خالی شناخته می‌شوند مگر در داخل رشته‌های محصور در علامت نقل‌قول دوتایی، که در آنجا بخشی از خود رشته محسوب می‌شوند. دستورات به بزرگی و کوچکی حروف حساس نیستند. داده‌های CD-Text می‌توانند حداکثر ۸۰ نویسه برای هر مورد باشند. مقادیر کُد زمانی به قالب‌های "X:X:X"، "X:X" و "X" پذیرفته می‌شوند که در آن‌ها هر "X" باید حداکثر از دو رقم تشکیل شده باشد و ممکن است با صفر از سمت چپ پر شود. این مقادیر به ترتیب به‌صورت "M:S:F"، "S:F" و "F" تفسیر می‌شوند که در آن "M" به معنای "دقیقه" است و باید در محدوده 0 <= M <= 99 باشد، "S" به معنای "ثانیه" است و باید در محدوده 0 <= S <= 59 باشد، و "F" به معنای "فریم" است و باید در محدوده 0 <= F <= 74 باشد. فایل‌های CUE از نظر منطقی به یک بخش عمومی و یک تا ۹۹ بخش شیار تقسیم می‌شوند. در داخل این بخش‌ها دستورات زیر مجاز هستند: .SS "بخش عمومی (Global Section)" .B REM .I anything_to_newline .br .B CATALOG .I string .br .B CDTEXTFILE .I string .br .B TITLE .I string .br .B PERFORMER .I string .br .B SONGWRITER .I string .br .B FILE .I string .BR "BINARY" "|" "MOTOROLA" "|" "AIFF" "|" "WAVE" "|" "MP3" .TP .B REM اختیاری. معرفی یک یادداشت (کامنت). هر چیزی از آن نقطه تا نویسه خط جدید بعدی نادیده گرفته می‌شود. یادداشت‌ها می‌توانند در هر جای فایل قرار گیرند، اما نه بین یک دستور و آرگومان‌های آن. .TP .B CATALOG اختیاری. شماره کاتالوگ رسانه (MCN) دیسک. باید دقیقاً ۱۳ نویسه باشد. .TP .B CDTEXTFILE اختیاری. یک فایل خارجی حاوی داده‌های CD-Text را مشخص می‌کند. نادیده گرفته می‌شود. .TP .B TITLE اختیاری. عنوان CD-Text دیسک. .TP .B PERFORMER اختیاری. مجری یا خواننده CD-Text دیسک. .TP .B SONGWRITER اختیاری. ترانه‌سرای CD-Text دیسک. .TP .B FILE الزامی. نام و نوع فایلی که باید برای تمامی شیارهای بعدی استفاده شود. .I string شامل نام فایل است که پس از آن یکی از مقادیر .BR "BINARY" "، " "MOTOROLA" "، " "AIFF" "، " "WAVE" " یا " "MP3" می‌آید. از نظر .B cue2toc نوع فایل عملاً نادیده گرفته می‌شود. با این وجود مقادیر .BR "MOTOROLA" "، " "AIFF" " و " "MP3" باعث چاپ یک پیام هشدار می‌شوند زیرا این نوع فایل‌ها نمی‌توانند مستقیماً با cdrdao استفاده شوند. .LP اولین مشاهده دستور .B TRACK باعث خروج از بخش عمومی و ورود به بخش شیار می‌شود. .SS "بخش شیارها (Track Section)" .B TRACK .I number .I mode .br .B REM .I anything_to_newline .br .B FLAGS .RB "[" "DCP" "]" .RB "[" "4CH" "]" .RB "[" "PRE" "]" .RB "[" "SCMS" "]" .br .B ISRC .I string .br .B TITLE .I string .br .B PERFORMER .I string .br .B SONGWRITER .I string .br .B PREGAP .I timecode .br .B INDEX .I number .I timecode .br .B POSTGAP .I timecode .br .B FILE .I string .BR "BINARY" "|" "MOTOROLA" "|" "AIFF" "|" "WAVE" "|" "MP3" .TP .B TRACK الزامی. تعریف یک شیار جدید را آغاز می‌کند. مقدار .I number نادیده گرفته می‌شود. مقدار .I mode باید یکی از مقادیر .BR "AUDIO" "، " "MODE1/2048" "، " "MODE1/2352" "،" .BR "MODE2/2336" " یا " "MODE2/2352" باشد. .TP .B FLAGS اختیاری. فلگ‌های این شیار را تعریف می‌کند. باید پس از آن یک یا چند مورد از گزینه‌های زیر بیاید: .B DCP (کپی دیجیتال مجاز است)، .B 4CH (صدای ۴ کاناله)، .B PRE (تاکید اولیه فعال است) و .B SCMS (سامانه مدیریت کپی سریال). .B SCMS نادیده گرفته می‌شود زیرا هیچ گزینه متناظری در قالب TOC برای آن وجود ندارد. .TP .B ISRC اختیاری. کد استاندارد بین‌المللی ضبط (ISRC) برای این شیار. باید دقیقاً ۱۲ نویسه باشد. .TP .B TITLE اختیاری. عنوان CD-Text این شیار. .TP .B PERFORMER اختیاری. اجراکننده CD-Text این شیار. .TP .B SONWRITER اختیاری. ترانه‌سرای CD-Text این شیار. .TP .B PREGAP اختیاری. طول پیش‌فاصله (pregap) شیار که باید با داده‌های صفر پر شود. مانعة‌الجمع با .BR "INDEX 0" است. .TP .B POSTGAP اختیاری. طول پس‌فاصله (postgap) شیار که باید با داده‌های صفر پر شود. .TP .B INDEX اختیاری. مقدار .I number باید در محدوده 0 <= .I number <= 99 باشد. نمایه شماره ۱ شروع شیار را مشخص می‌کند. نمایه شماره ۰ شروع پیش‌فاصله شیار پرشده با داده‌های فایل است؛ یعنی تفاوت بین نمایه ۰ و نمایه ۱ طول پیش‌فاصله است. نمایه ۰ مانعة‌الجمع با .BR "PREGAP" است. شماره‌های نمایه بزرگ‌تر از ۱ نمایه‌های فرعی این شیار را مشخص می‌کنند و باید متوالی باشند. .TP .B FILE در بخش شیار اختیاری است. نحو آن همان است که در بالا توضیح داده شد و اگر درون مشخصات یک شیار قرار گیرد بر دستور .B TRACK بعدی اعمال می‌شود. .SH "محدودیت‌ها (LIMITATIONS)" دستور .B CDTEXTFILE و فلگ .B SCMS معادلی در قالب TOC ندارند و نادیده گرفته می‌شوند. فایل‌های CUE حاوی شیارهای داده‌ای که زمان شروعی بزرگ‌تر از صفر را مشخص می‌کنند نمی‌توانند توسط .B cue2toc تبدیل شوند زیرا قالب TOC هیچ راهی برای تعیین زمان شروع برای شیارهای داده فراهم نمی‌کند. با این حال اگر فایل CUE حاوی هیچ شیار صوتی نباشد، می‌توانید از فایل CUE مستقیماً در cdrdao استفاده کنید. .SH "مثال (EXAMPLE)" فرض کنید فایل CUE زیر به نام "uwe.froehn.cue" را داریم که یک CD صوتی همراه با داده‌های CD-Text را توصیف می‌کند: .nf .in +4m REM Example CUE file with audio tracks CATALOG 1234567890123 TITLE "Der Berg ruft" PERFORMER "Uwe Froehn" FILE "uwe.froehn.mp3" MP3 TRACK 01 AUDIO TITLE "Meine Mama ist die Beste" PERFORMER "Uwe Froehn" SONGWRITER "Hansi Klabuster" REM two seconds pregap filled with audio data INDEX 00 00:00:00 INDEX 01 00:02:00 REM subindexes INDEX 02 00:35:17 INDEX 03 01:12:44 TRACK 02 AUDIO TITLE "Hoch oben im Tal" SONGWRITER "Gabi Geil" REM no pregap INDEX 01 02:45:38 TRACK 03 AUDIO REM pregap with zero data PREGAP 00:4:47 INDEX 01 07:58:74 REM postgap with zero data POSTGAP 00:35:00 .in -4m .fi از آنجا که cdrdao نمی‌تواند فایل MP3 را در لحظه رمزگشایی کند، این مرحله باید به صورت دستی انجام شود، مثلاً با استفاده از lame: .nf .in +4m lame --decode uwe.froehn.mp3 uwe.froehn.wav .in -4m .fi اگرچه نام فایل تنها یک بار در فایل نمونه CUE ظاهر می‌شود، اما برای هر شیار در فایل TOC نوشته می‌شود، بنابراین لازم است دفعات تکرار نام فایل در پرونده TOC را به صورت دستی ویرایش کنید. به همین دلیل می‌توانید با گزینه .B -w یک رشته مشخص کنید تا توسط .B cue2toc به عنوان نام فایل برای تمامی شیارهای صوتی استفاده شود. دستور .nf .in +4m cue2toc -w uwe.froehn.wav -o uwe.froehn.toc uwe.froehn.cue .in -4m .fi باید فایلی به نام uwe.froehn.toc با محتوای زیر تولید کند: .nf .in +4m CATALOG "1234567890123" CD_DA CD_TEXT { LANGUAGE_MAP { 0 : EN } LANGUAGE 0 { TITLE "Der Berg ruft" PERFORMER "Uwe Froehn" } } TRACK AUDIO CD_TEXT { LANGUAGE 0 { TITLE "Meine Mama ist die Beste" PERFORMER "Uwe Froehn" SONGWRITER "Hansi Klabuster" } } AUDIOFILE "uwe.froehn.wav" 00:00:00 02:45:38 START 00:02:00 INDEX 00:35:17 INDEX 01:12:44 TRACK AUDIO CD_TEXT { LANGUAGE 0 { TITLE "Hoch oben im Tal" SONGWRITER "Gabi Geil" } } AUDIOFILE "uwe.froehn.wav" 02:45:38 05:13:36 TRACK AUDIO PREGAP 00:04:47 AUDIOFILE "uwe.froehn.wav" 07:58:74 SILENCE 00:35:00 .in -4m .fi .SH "همچنین ببینید (SEE ALSO)" .BR cdrdao (1), .BR lame (1) .SH "اشکالات (BUGS)" از آنجا که تعریف .BR "cue2toc" از قالب CUE کاملاً بر اساس تعدادی فایل‌های CUE مختلف است که نویسنده با آن‌ها مواجه شده، احتمال بسیار زیادی وجود دارد که با سایر فایل‌های CUE که ممکن است با آن‌ها برخورد کنید به درستی کار نکند. اگر این مورد برای شما پیش آمد، لطفاً فایل CUE دارای مشکل را همراه با شماره نسخه .B cue2toc به نشانی ارسال فرمایید. .SH "نویسنده (AUTHOR)" Matthias Czapla