201 lines
5.6 KiB
Markdown
201 lines
5.6 KiB
Markdown
# English
|
||
|
||
# CCD2CUE - CCD to CUE File Converter
|
||
|
||
## Description
|
||
|
||
**ccd2cue** - Utility for converting CD/DVD image files in CCD (CloneCD) format to CUE files.
|
||
|
||
## Features
|
||
|
||
- Converts CCD files to CUE format
|
||
- Automatically detects image files (.img, .bin, .iso)
|
||
- Supports various track types (data and audio)
|
||
- Correctly handles timestamps and track indices
|
||
- No external dependencies (except the C standard library)
|
||
|
||
## Installation and Compilation
|
||
|
||
### Requirements
|
||
- GCC compiler
|
||
- C standard library
|
||
- POSIX-compliant operating system
|
||
|
||
### Compilation
|
||
|
||
```bash
|
||
gcc -o ccd2cue ccd2cue.c
|
||
```
|
||
|
||
## Usage
|
||
|
||
### Basic Syntax
|
||
|
||
```bash
|
||
ccd2cue -c <file.ccd>
|
||
```
|
||
|
||
### Command Line Options
|
||
|
||
| Option | Description |
|
||
|----------|----------|
|
||
| `-c <file>` | Required parameter. Specifies the path to the input CCD file. |
|
||
|
||
### Usage Examples
|
||
|
||
```bash
|
||
# Convert file example.ccd
|
||
./ccd2cue -c example.ccd
|
||
|
||
# Convert a file in a different directory
|
||
./ccd2cue -c /path/to/disc.ccd
|
||
```
|
||
|
||
## Input and Output Files
|
||
|
||
### Input Files
|
||
- **CCD File**: A file with the `.ccd` extension, containing metadata about the disc structure
|
||
- **Image File**: Automatically detected by extensions:
|
||
- `.img`
|
||
- `.bin`
|
||
- `.iso`
|
||
|
||
### Output Files
|
||
- **CUE File**: Created with the same name as the CCD file, but with the `.cue` extension
|
||
|
||
### Example File Structure
|
||
|
||
```
|
||
project_directory/
|
||
├── disc.ccd # Input File
|
||
├── disc.img # Image file (auto-detection)
|
||
└── disc.cue # Output file (created by the program)
|
||
```
|
||
|
||
## Supported Track Formats
|
||
|
||
The program supports two main track types:
|
||
|
||
| Track Type | Description | CUE Format |
|
||
|-----------|-----------|-----------|
|
||
| Data | Computer Data Tracks | `MODE1/2352` |
|
||
| Audio | Audio Tracks | `AUDIO` |
|
||
|
||
## Time Stamp Processing
|
||
|
||
The program automatically adjusts time stamps:
|
||
- Subtracts 2 seconds from the time of each track
|
||
- Correctly handles transitions after one minute
|
||
- Maintains frame accuracy
|
||
|
||
## Return Codes
|
||
|
||
| Code | Value |
|
||
|-----|----------|
|
||
| `0` | Successful completion |
|
||
| `1` | Error: No CCD file specified |
|
||
| `2` | Error: Unable to read CCD file |
|
||
| `3` | Error: Image file not found |
|
||
|
||
-----
|
||
|
||
# Русский
|
||
|
||
# CCD2CUE - Конвертер CCD в CUE файлы
|
||
|
||
## Описание
|
||
|
||
**ccd2cue** - Утилита для преобразования файлов образов CD/DVD в формате CCD (CloneCD) в CUE-файлы.
|
||
|
||
## Особенности
|
||
|
||
- Конвертирует CCD-файлы в CUE-формат
|
||
- Автоматически определяет файлы образов (.img, .bin, .iso)
|
||
- Поддерживает различные типы треков (данные и аудио)
|
||
- Корректно обрабатывает временные метки и индексы треков
|
||
- Не требует внешних зависимостей (кроме стандартной библиотеки C)
|
||
|
||
## Установка и компиляция
|
||
|
||
### Требования
|
||
- Компилятор GCC
|
||
- Стандартная библиотека C
|
||
- POSIX-совместимая операционная система
|
||
|
||
### Компиляция
|
||
|
||
```bash
|
||
gcc -o ccd2cue ccd2cue.c
|
||
```
|
||
|
||
## Использование
|
||
|
||
### Базовый синтаксис
|
||
|
||
```bash
|
||
ccd2cue -c <файл.ccd>
|
||
```
|
||
|
||
### Параметры командной строки
|
||
|
||
| Параметр | Описание |
|
||
|----------|----------|
|
||
| `-c <файл>` | Обязательный параметр. Указывает путь к входному CCD-файлу |
|
||
|
||
### Примеры использования
|
||
|
||
```bash
|
||
# Конвертировать файл example.ccd
|
||
./ccd2cue -c example.ccd
|
||
|
||
# Конвертировать файл в другом каталоге
|
||
./ccd2cue -c /path/to/disc.ccd
|
||
```
|
||
|
||
## Входные и выходные файлы
|
||
|
||
### Входные файлы
|
||
- **CCD-файл**: Файл с расширением `.ccd`, содержащий метаданные о структуре диска
|
||
- **Файл образа**: Автоматически определяется по расширениям:
|
||
- `.img`
|
||
- `.bin`
|
||
- `.iso`
|
||
|
||
### Выходные файлы
|
||
- **CUE-файл**: Создается с тем же именем, что и CCD-файл, но с расширением `.cue`
|
||
|
||
### Пример структуры файлов
|
||
|
||
```
|
||
директория_проекта/
|
||
├── disc.ccd # Входной файл
|
||
├── disc.img # Файл образа (автоопределение)
|
||
└── disc.cue # Выходной файл (создается программой)
|
||
```
|
||
|
||
## Форматы поддерживаемых треков
|
||
|
||
Программа поддерживает два основных типа треков:
|
||
|
||
| Тип трека | Описание | CUE-формат |
|
||
|-----------|----------|------------|
|
||
| Данные | Треки с компьютерными данными | `MODE1/2352` |
|
||
| Аудио | Аудио треки | `AUDIO` |
|
||
|
||
## Обработка временных меток
|
||
|
||
Программа автоматически корректирует временные метки:
|
||
- Вычитает 2 секунды из времени каждого трека
|
||
- Корректно обрабатывает переходы через минуту
|
||
- Сохраняет точность до кадров (frames)
|
||
|
||
## Коды возврата
|
||
|
||
| Код | Значение |
|
||
|-----|----------|
|
||
| `0` | Успешное выполнение |
|
||
| `1` | Ошибка: не указан CCD-файл |
|
||
| `2` | Ошибка: не удалось прочитать CCD-файл |
|
||
| `3` | Ошибка: не найден файл образа |
|
||
|