Ссылка DRCoreCDText.h

Текстовый объект CD, используемый в Диске, Записывающем APIs.

Текст CD позволяет авторам аудиокомпакт-диска кодировать текстовую информацию о CD и его дорожках на диск. Информация, такая как название альбома, имена дорожки, художник, автор песен, исполнитель, и больше может быть закодировано этот путь. Когда диск, содержащий текст CD, вставляется в текст CD осведомленный проигрыватель, эта информация выведена на экран как игры CD.

Текст CD только для аудиокомпакт-дисков; это не применяется к и не работает над данными CDs или DVDs.

Вот концептуальное описание того, как работает текст CD. Информация о тексте CD для диска может содержать до восьми блоков текстовой информации. Каждый блок имеет связанный кодовый набор языка и набор символов, и содержит полный набор информации о диске.

       
   +----------------------------+
   | +------------------------+ |
   | | CD-Text block 1        | |
   | |  - language code       | |
   | |  - character set       | |
   | +------------------------+ |
   |            .               |
   |            .               |
   |            .               |
   | +------------------------+ |
   | | CD-Text block 8        | |
   | |  - language code       | |
   | |  - character set       | |
   | +------------------------+ |
   +----------------------------+
 


  

В типичном использовании каждый блок текста CD содержит различный язык - английский, французский, японский язык, китайский язык, и т.д. - несмотря на то, что только в настоящее время поддерживаются однобайтовые кодировки. Это возможно и допустимо иметь многократные блоки, что каждый содержит тот же язык.

Каждый блок может содержать полный набор информации о диске и его дорожках. Эта информация хранится как массив словарей значения ключа. Существует один словарь на дорожку с дополнительным словарем для самого диска/альбома (представлен индексом массива 0). На диске с дорожками n будут n+1 словари.

       
   +----------------------------+
   | CD-Text block              |
   |  - language code           |
   |  - character set           |
   | +------------------------+ |
   | | Index 0 - disc info    | |
   | +------------------------+ |
   | +------------------------+ |
   | | Index 1 - track 1 info | |
   | +------------------------+ |
   | +------------------------+ |
   | | Index 2 - track 2 info | |
   | +------------------------+ |
   |            .               |
   |            .               |
   |            .               |
   | +------------------------+ |
   | | Index n - track n info | |
   | +------------------------+ |
   +----------------------------+
 


  

Словари для отдельных дорожек содержат текстовую информацию, которая будет выведена на экран. Эта информация строго ограничивается набором символов, указанным блоком включения, и, как аналогично предполагается, находится на указанном языке.

       
   +----------------------------+
   | Track info dictionary      |
   |                            |
   |  Title = "title"           |
   |  Artist = "artist"         |
   |  Performer = "performer"   |
   |            .               |
   |            .               |
   |            .               |
   +----------------------------+
 


  

Для совместимости с самым широким диапазоном проигрывателей компакт-дисков текстовые значения в словарях текста CD должны составить 160 байтов или меньший. Так как кодировки в настоящее время поддерживаемого символа являются всеми однобайтовыми кодировками, это означает максимум 160 символов на запись.

Включенные заголовки

<CoreFoundation/CoreFoundation.h>
<DiscRecording/DRCoreObject.h>
<AvailabilityMacros.h>

Функции

Прочие условия


    
    DRCDTextBlockCreate (_: _:)
    DRCDTextBlockCreate

Создает Текстовый блок CD с предоставленным содержанием.

Объявление

Swift

func DRCDTextBlockCreate(_ language: CFString!, _ encoding: CFStringEncoding) -> Unmanaged<DRCDTextBlock>!

Objective C

DRCDTextBlockRef DRCDTextBlockCreate ( CFStringRef language, CFStringEncoding encoding );

Параметры

`language`	CFString описание кода языка ISO 639. Текст CD позволяет понятие неизвестного языка, который может быть представлен здесь пустой строкой.
`encoding`	Значение CFStringEncoding поддерживается Текстовым форматом CD.

Возвращаемое значение

Новый Текстовый блок CD.

Оператор импорта

Objective C

@import DiscRecording;

Swift

import DiscRecording

Доступность

Доступный в OS X v10.4 и позже.

DRCDTextBlockCreateArrayFromPackList (_:) DRCDTextBlockCreateArrayFromPackList

Данные текста CD сырых данных синтаксических анализов в объекты DRCDTextBlock.

Объявление

Swift

func DRCDTextBlockCreateArrayFromPackList(_ packs: CFData!) -> Unmanaged<CFArray>!

Objective C

CFArrayRef DRCDTextBlockCreateArrayFromPackList ( CFDataRef packs );

Параметры

packs

CFDataRef, содержащий необработанный текст CD PACKs.

Возвращаемое значение

Объект CFArray, содержащий объекты DRCDTextBlock, описывающие информацию в необработанном PACKs или NULL, если не могли бы быть проанализированы данные. Вызывающая сторона ответственна за выпуск этого массива.

Обсуждение

Можно использовать эту функцию для парсинга любого блоба данных, содержащего текст CD PACKs, такой как результат DRDeviceReadCDText или данные, возвращенные IOKit ioctl DKIOCCDREADTOC с format=5.

CFData должен быть измерен для адаптации точному числу PACKs. Каждый PACK занимает 18 байтов, и 4-байтовый заголовок от команды READ TOC может дополнительно быть включен.

Оператор импорта

Objective C

@import DiscRecording;

Swift

import DiscRecording

Доступность

Доступный в OS X v10.4 и позже.
DRCDTextBlockFlatten (_:) DRCDTextBlockFlatten
Сглаживает Текстовый блок CD, чтобы определить, будет ли информация усеченной.

Объявление

Swift

func DRCDTextBlockFlatten(_ block: DRCDTextBlock!) -> UInt32

Objective C

UInt32 DRCDTextBlockFlatten ( DRCDTextBlockRef block );

Параметры

block

Текстовый блок CD для выравнивания.

Возвращаемое значение

Число байтов, которые будут усеченными от Текстового блока CD. Если эта функция возвратится 0, то никакое усечение не произойдет.
Обсуждение

При записи информации о тексте CD к CD Запись Диска автоматически усечет часть информации, которую Вы указали, не соответствует ли это.

Предел размера для текста CD приблизительно 3K на блок. Этот предел приблизителен из-за издержек и потому что могут иногда объединяться двойные строки. Единственный способ определить заключительный размер байта Текстового блока CD состоит в том, чтобы попросить, чтобы Запись Диска сгладила его. Можно тогда определить, будет ли необходимо усечение.

Усечение Записи диска сохраняет наиболее важную информацию и обеспечивает самый простой пользовательский опыт. Если Вы не хотите использовать автоматическое усечение Записи Диска, именно Ваша ответственность гарантировать, чтобы Вы обеспечили, содержание Текстового блока CD соответствует.

Следующее является простым алгоритмом, чтобы избежать иметь Ваши усеченные данные текста CD:
1. Вызовите DRCDTextBlockFlatten.
2. Если результат 0, никакое усечение не необходимо. Остановиться.
3. Иначе, усечение произойдет - редактируют или удаляют некоторые данные.
4. Повториться.
Оператор импорта

Objective C

@import DiscRecording;

Swift

import DiscRecording

Доступность

Доступный в OS X v10.4 и позже.


    
    DRCDTextBlockGetProperties (_:)
    DRCDTextBlockGetProperties

Свойства возвратов Текстового блока CD.

Объявление

Swift

func DRCDTextBlockGetProperties(_ block: DRCDTextBlock!) -> Unmanaged<CFDictionary>!

Objective C

CFDictionaryRef DRCDTextBlockGetProperties ( DRCDTextBlockRef block );

Параметры


      block

Текстовый блок CD для запросов. Если этот параметр не является допустимой ссылкой на объект Текстового блока CD, поведение не определено.

Возвращаемое значение

Объект CFDictionary, содержащий свойства указанного Текстового блока CD. Вызывающая сторона неявно не сохраняет ссылку и не ответственна за выпуск его.

Оператор импорта

Objective C

@import DiscRecording;

Swift

import DiscRecording

Доступность

Доступный в OS X v10.4 и позже.

DRCDTextBlockGetTrackDictionaries (_:) DRCDTextBlockGetTrackDictionaries

Возвращает массив словарей дорожки для данного блока.

Объявление

Swift

func DRCDTextBlockGetTrackDictionaries(_ block: DRCDTextBlock!) -> Unmanaged<CFArray>!

Objective C

CFArrayRef DRCDTextBlockGetTrackDictionaries ( DRCDTextBlockRef block );

Параметры

block

Текстовый блок CD для запросов.

Возвращаемое значение

Объект CFArray, содержащий неизменные словари объектов CFString, каждый из которых содержит информацию о тексте CD.

Обсуждение

Каждый элемент в массиве является словарем, поочередно содержащим закодированную информацию значения ключа о дорожке или диске. Индекс массива 0 содержит информацию о диске, индекс 1 содержит информацию о дорожке 1, индекс 2 содержит информацию о дорожке 2 и т.д. Вызывающая сторона неявно не сохраняет ссылку и не ответственна за выпуск его.

Оператор импорта

Objective C

@import DiscRecording;

Swift

import DiscRecording

Доступность

Доступный в OS X v10.4 и позже.
DRCDTextBlockGetTypeID () DRCDTextBlockGetTypeID

Возвращает идентификатор типа для всех экземпляров DRCDTextBlock.

Объявление

Swift

func DRCDTextBlockGetTypeID() -> CFTypeID

Objective C

CFTypeID DRCDTextBlockGetTypeID ( void );

Возвращаемое значение

Базовый идентификатор типа Основы.

Оператор импорта

Objective C

@import DiscRecording;

Swift

import DiscRecording

Доступность

Доступный в OS X v10.4 и позже.


    
    DRCDTextBlockGetValue (_: _: _:)
    DRCDTextBlockGetValue

Возвраты одно определенное значение для дорожки.

Объявление

Swift

func DRCDTextBlockGetValue(_ block: DRCDTextBlock!, _ trackIndex: CFIndex, _ key: CFString!) -> Unmanaged<AnyObject>!

Objective C

CFTypeRef DRCDTextBlockGetValue ( DRCDTextBlockRef block, CFIndex trackIndex, CFStringRef key );

Параметры

`block`	Текстовый блок CD для запросов.
`trackIndex`	Индекс Дорожки, в диапазоне 0-99, для запросов. Если это значение больше, чем число дорожек в блоке языка, функция возвращает NULL.
`key`	Определенный ключ для поиска.

Возвращаемое значение

Базовая Основа вводит ссылочную ссылку на копию указанного значения Текстового блока CD.

Обсуждение

Эта функция ищет значение для указанного индекса дорожки и ключа, и возвращает значение. Если никакой ключ не был найден, возвращенное значение будет CFString, CFData, или объектом CFNumber или будет NULL. Вызывающая сторона неявно не сохраняет ссылку и не ответственна за выпуск его.

Оператор импорта

Objective C

@import DiscRecording;

Swift

import DiscRecording

Доступность

Доступный в OS X v10.4 и позже.


    
    DRCDTextBlockSetProperties (_: _:)
    DRCDTextBlockSetProperties

Устанавливает свойства Текстового блока CD.

Объявление

Swift

func DRCDTextBlockSetProperties(_ block: DRCDTextBlock!, _ properties: CFDictionary!)

Objective C

void DRCDTextBlockSetProperties ( DRCDTextBlockRef block, CFDictionaryRef properties );

Параметры

`block`	Текстовый блок CD для изменения.
`properties`	Объект CFDictionary, содержащий свойства CD-Text. Если этот параметр не является допустимой ссылкой на объект словаря, поведение не определено.

Оператор импорта

Objective C

@import DiscRecording;

Swift

import DiscRecording

Доступность

Доступный в OS X v10.4 и позже.


    
    DRCDTextBlockSetTrackDictionaries (_: _:)
    DRCDTextBlockSetTrackDictionaries

Устанавливает массив словарей дорожки для данного Текстового блока CD.

Объявление

Swift

func DRCDTextBlockSetTrackDictionaries(_ block: DRCDTextBlock!, _ array: CFArray!)

Objective C

void DRCDTextBlockSetTrackDictionaries ( DRCDTextBlockRef block, CFArrayRef array );

Параметры

`block`	Текстовый блок CD для изменения.
`array`	Объект CFArray, содержащий неизменные словари объектов CFString, каждый из которых содержит информацию о тексте CD.

Обсуждение

Каждый элемент в массиве является словарем, поочередно содержащим закодированную информацию значения ключа о дорожке или диске. Индекс массива 0 содержит информацию о диске, индекс 1 содержит информацию о дорожке 1, индекс 2 содержит информацию о дорожке 2 и т.д.

Входящие строки автоматически изменяются для приспосабливания набору символов, указанному в блоке языка. При вызове DRCDTextCopyTrackArray () функция сразу после DRCDTextSetTrackArray () возвращает измененные значения, которые могут не совпасть с теми, Вы передали в, но соответствуйте тому, что будет фактически использоваться.

Оператор импорта

Objective C

@import DiscRecording;

Swift

import DiscRecording

Доступность

Доступный в OS X v10.4 и позже.


    
    DRCDTextBlockSetValue (_: _: _: _:)
    DRCDTextBlockSetValue

Наборы одно определенное значение для дорожки.

Объявление

Swift

func DRCDTextBlockSetValue(_ block: DRCDTextBlock!, _ trackIndex: CFIndex, _ key: CFString!, _ value: AnyObject!)

Objective C

void DRCDTextBlockSetValue ( DRCDTextBlockRef block, CFIndex trackIndex, CFStringRef key, CFTypeRef value );

Параметры

`block`	Текстовый блок CD для изменения.
`trackIndex`	Индекс дорожки, в диапазоне 0-99, для изменения. Если это значение больше, чем число дорожек в блоке языка, функция создает новые записи в массиве дорожки по мере необходимости.
`key`	Ключ, указывающий значение для установки.
`value`	Новое текстовое значение.

Обсуждение

Значение текста CD может быть CFString, CFData или объектом CFNumber, но должно соответствовать типу, определенному в описании ключа.

Если входящее значение является строкой, оно автоматически изменяется для приспосабливания набору символов блока языка. При вызове DRCDTextCopyValue () функция сразу после DRCDTextSetValue () возвращает измененное значение, которое может не совпасть с тем, в котором Вы передали, но соответствуете тому, что будет фактически использоваться.

Установка в NULL значения удаляет ключ из указанного словаря дорожки.

Оператор импорта

Objective C

@import DiscRecording;

Swift

import DiscRecording

Доступность

Доступный в OS X v10.4 и позже.

Типы данных

Посмотрите раздел Overview выше для документации уровня заголовка.

DRCDTextBlockRef DRCDTextBlockRef

Ссылка на экземпляры DRCDTextBlock.

Объявление

Swift

typealias DRCDTextBlockRef = DRCDTextBlock

Objective C

typedef const struct __DRCDTextBlock* DRCDTextBlockRef;

Оператор импорта

Objective C

@import DiscRecording;

Swift

import DiscRecording

Доступность

Доступный в OS X v10.4 и позже.

Константы

Посмотрите раздел Overview выше для документации уровня заголовка.

Глобальные константы
Объявление

Swift

let kDRCDTextArrangerKey: CFString! let kDRCDTextCFStringEncodingKey: CFString! let kDRCDTextCharacterCodeKey: CFString! let kDRCDTextClosedKey: CFString! let kDRCDTextComposerKey: CFString! let kDRCDTextCopyrightAssertedForNamesKey: CFString! let kDRCDTextCopyrightAssertedForSpecialMessagesKey: CFString! let kDRCDTextCopyrightAssertedForTitlesKey: CFString! let kDRCDTextDiscIdentKey: CFString! let kDRCDTextGenreCodeKey: CFString! let kDRCDTextGenreKey: CFString! let kDRCDTextLanguageKey: CFString! let kDRCDTextMCNISRCKey: CFString! let kDRCDTextPerformerKey: CFString! let kDRCDTextSizeKey: CFString! let kDRCDTextSongwriterKey: CFString! let kDRCDTextSpecialMessageKey: CFString! let kDRCDTextTitleKey: CFString! let kDRCDTextTOC2Key: CFString! let kDRCDTextTOCKey: CFString!

Objective C

extern const CFStringRef kDRCDTextArrangerKey; extern const CFStringRef kDRCDTextCFStringEncodingKey; extern const CFStringRef kDRCDTextCharacterCodeKey; extern const CFStringRef kDRCDTextClosedKey; extern const CFStringRef kDRCDTextComposerKey; extern const CFStringRef kDRCDTextCopyrightAssertedForNamesKey; extern const CFStringRef kDRCDTextCopyrightAssertedForSpecialMessagesKey; extern const CFStringRef kDRCDTextCopyrightAssertedForTitlesKey; extern const CFStringRef kDRCDTextDiscIdentKey; extern const CFStringRef kDRCDTextGenreCodeKey; extern const CFStringRef kDRCDTextGenreKey; extern const CFStringRef kDRCDTextLanguageKey; extern const CFStringRef kDRCDTextMCNISRCKey; extern const CFStringRef kDRCDTextPerformerKey; extern const CFStringRef kDRCDTextSizeKey; extern const CFStringRef kDRCDTextSongwriterKey; extern const CFStringRef kDRCDTextSpecialMessageKey; extern const CFStringRef kDRCDTextTitleKey; extern const CFStringRef kDRCDTextTOC2Key; extern const CFStringRef kDRCDTextTOCKey;

Константы
- kDRCDTextArrangerKey
  
  kDRCDTextArrangerKey
  
  Ключ словаря Текстового блока CD, значение которого, объект CFString, содержит имя аранжировщика для дорожки или, если для информационного блока диска, для диска в целом.
  
  Доступный в OS X v10.4 и позже.
- kDRCDTextCFStringEncodingKey
  
  kDRCDTextCFStringEncodingKey
  
  Это - требуемый ключ свойства для Текстового блока CD. Его значение является ссылкой на объект CFNumber, содержащий значение CFStringEncoding для текста блока.
  
  Это свойство должно остаться постоянным, как только создается блок. При изменении его после создания блока результаты не определены.
  
  Доступный в OS X v10.4 и позже.
- kDRCDTextCharacterCodeKey
  
  kDRCDTextCharacterCodeKey
  
  Это - требуемый ключ свойства для Текстового блока CD. Его значение является ссылкой на объект CFNumber, содержащий значение набора символов Красной книги для текста блока.
  
  Значение не является CFStringEncoding или типом данных NSStringEncoding и не должно использоваться как таковое.
  
  Это свойство должно остаться постоянным, как только создается блок. При изменении его после создания блока результаты не определены.
  
  Доступный в OS X v10.4 и позже.
- kDRCDTextClosedKey
  
  kDRCDTextClosedKey
  
  Ключ словаря Текстового блока CD, значение которого, объект CFString, содержит произвольные данные о диске. Текстовый формат произволен и до контент-провайдера. Эта информация является частной, и проигрыватели не должны отображать ее пользователю диска.
  
  В соответствии со спецификациями текста CD, эта строка всегда кодируется с помощью кодирования kDRCDTextEncodingISOLatin1Modified, независимо от кодирования блока.
  
  Доступный в OS X v10.4 и позже.
- kDRCDTextComposerKey
  
  kDRCDTextComposerKey
  
  Ключ словаря Текстового блока CD, значение которого, объект CFString, содержит имя композитора для дорожки или, если для информационного блока диска, для диска в целом.
  
  Доступный в OS X v10.4 и позже.
- kDRCDTextCopyrightAssertedForNamesKey
  
  kDRCDTextCopyrightAssertedForNamesKey
  
  Это - дополнительный ключ свойства для Текстового блока CD. Его значение является ссылкой на объект CFBoolean, указывающий, утверждается ли авторское право на именах в блоке, включающих значения, связанные с kDRCDTextPerformerKey, kDRCDTextSongwriterKey, kDRCDTextComposerKey, и kDRCDTextArrangerKey ключами.
  
  Если это значение не указано, никакое авторское право не утверждается для этих элементов.
  
  Доступный в OS X v10.4 и позже.
- kDRCDTextCopyrightAssertedForSpecialMessagesKey
  
  kDRCDTextCopyrightAssertedForSpecialMessagesKey
  
  Это - дополнительный ключ свойства для Текстового блока CD. Его значение является ссылкой на объект CFBoolean, указывающий, утверждается ли авторское право на блочном тексте, связанном с kDRCDTextSpecialMessageKey ключом.
  
  Если это значение не указано, никакое авторское право не утверждается для текста.
  
  Доступный в OS X v10.4 и позже.
- kDRCDTextCopyrightAssertedForTitlesKey
  
  kDRCDTextCopyrightAssertedForTitlesKey
  
  Это - дополнительный ключ свойства для Текстового блока CD. Его значение является ссылкой на объект CFBoolean, указывающий, утверждается ли авторское право на диске или заголовке дорожки, связанном с kDRCDTextTitleKey ключом.
  
  Если это значение не указано, никакое авторское право не утверждается для этого текста.
  
  Доступный в OS X v10.4 и позже.
- kDRCDTextDiscIdentKey
  
  kDRCDTextDiscIdentKey
  
  Ключ словаря Текстового блока CD, значение которого, объект CFString, содержит информацию об идентификации диска, такую как число каталога и имя звукозаписывающей компании, кода торговой точки, год, и т.д. Каждый элемент должен быть разделен наклонной чертой (» / «).
  
  В соответствии со спецификациями текста CD, эта строка всегда кодируется с помощью кодирования kDRCDTextEncodingISOLatin1Modified, независимо от кодирования блока.
  
  Этот ключ допустим только для диска в целом, а именно, для индекса массива 0. Это проигнорировано, когда установлено в словарях для дорожек.
  
  Доступный в OS X v10.4 и позже.
- kDRCDTextGenreCodeKey
  
  kDRCDTextGenreCodeKey
  
  Ключ словаря Текстового блока CD, значение которого, объект CFNumber, содержит числовой код жанра для диска в целом, как перечислено в перечислении Жанров текста CD.
  
  Этот ключ допустим только для диска в целом, а именно, для индекса массива 0. Это проигнорировано, когда установлено в словарях для дорожек.
  
  Доступный в OS X v10.4 и позже.
- kDRCDTextGenreKey
  
  kDRCDTextGenreKey
  
  Ключ словаря Текстового блока CD, значение которого, объект CFString, содержит имя жанра для диска в целом.
  
  В соответствии со спецификациями текста CD, эта строка всегда кодируется с помощью кодирования kDRCDTextEncodingISOLatin1Modified, независимо от кодирования блока.
  
  Этот ключ допустим только для диска в целом, а именно, для индекса массива 0. Это проигнорировано, когда установлено в словарях для дорожек.
  
  Доступный в OS X v10.4 и позже.
- kDRCDTextLanguageKey
  
  kDRCDTextLanguageKey
  
  Это - требуемый ключ свойства для Текстового блока CD. Его значение является ссылкой на объект CFString, содержащий код языка ISO 639, описывающий язык для текста блока. Текст CD позволяет понятие неизвестного языка, представленного здесь пустой строкой.
  
  Можно изменить язык блока после создания блока.
  
  Доступный в OS X v10.4 и позже.
- kDRCDTextMCNISRCKey
  
  kDRCDTextMCNISRCKey
  
  Ключ словаря Текстового блока CD, значение которого, объект CFData, содержит любые 13 байтов Числа Каталога Носителей (MCN, для диска в целом) или 12 байтов Кода записи по международному стандарту (ISRC, для дорожек). Эта информация может также быть указана в свойствах дорожки и записи. Текст CD просто обеспечивает альтернативу, возможно избыточную, способ закодировать эту информацию. Если бы данные MCN или ISRC были указаны в свойствах для записи или дорожки, то это значение должно быть тем же. Дополнительную информацию см. в описаниях kDRMediaCatalogNumberKey и kDRTrackISRCKey на точном формате данных.
  
  Доступный в OS X v10.4 и позже.
- kDRCDTextPerformerKey
  
  kDRCDTextPerformerKey
  
  Ключ словаря Текстового блока CD, значение которого, объект CFString, содержит имя исполнителя для дорожки или, если для информационного блока диска, для диска в целом.
  
  Доступный в OS X v10.4 и позже.
- kDRCDTextSizeKey
  
  kDRCDTextSizeKey
  
  Ключ словаря Текстового блока CD, значение которого, объект CFData, содержит информацию о числе пакетов и языков, связанных с каждым блоком.
  
  Этот ключ для выходного использования только при чтении текста CD из диска. Это проигнорировано, когда указано в записи.
  
  Доступный в OS X v10.4 и позже.
- kDRCDTextSongwriterKey
  
  kDRCDTextSongwriterKey
  
  Ключ словаря Текстового блока CD, значение которого, объект CFString, содержит имя автора песен для дорожки или, если для информационного блока диска, для диска в целом.
  
  Доступный в OS X v10.4 и позже.
- kDRCDTextSpecialMessageKey
  
  kDRCDTextSpecialMessageKey
  
  Ключ словаря Текстового блока CD, значение которого, объект CFString, содержит текстовое сообщение, которое может быть выведено на экран пользователю некоторыми проигрывателями.
  
  Доступный в OS X v10.4 и позже.
- kDRCDTextTitleKey
  
  kDRCDTextTitleKey
  
  Ключ словаря Текстового блока CD, значение которого, объект CFString, содержит заголовок для дорожки или, если для информационного блока диска, для диска в целом.
  
  Доступный в OS X v10.4 и позже.
- kDRCDTextTOC2Key
  
  kDRCDTextTOC2Key
  
  Ключ словаря Текстового блока CD, значение которого, объект CFData, содержит дополнительную информацию об оглавлении.
  
  Этот ключ для выходного использования только при чтении текста CD из диска. Это проигнорировано, когда указано в записи.
  
  Доступный в OS X v10.4 и позже.
- kDRCDTextTOCKey
  
  kDRCDTextTOCKey
  
  Ключ словаря Текстового блока CD, значение которого, объект CFData, содержит информацию об оглавлении.
  
  Этот ключ для выходного использования только при чтении текста CD из диска. Это проигнорировано, когда указано в записи.
  
  Доступный в OS X v10.4 и позже.
Кодировки текста CD

Специальные значения CFStringEncoding поддерживаются Текстовым форматом CD.

Объявление

Objective C

enum { kDRCDTextEncodingISOLatin1Modified = kCFStringEncodingISOLatin1 , /* ISO-Latin-1, as of Mac OS X 10.5 the appropriate CD-Text variant will now be used */ kDRCDTextEncodingASCII = kCFStringEncodingASCII /* 7-bit ASCII */ };

Обсуждение

Текстовый формат CD поддерживает только кодировки, перечисленные здесь.

С Mac OS X 10.5 поддерживаются два новых кодировок, они - kTextEncodingDOSJapanese (kTextEncodingShiftJIS) (вариант текста CD) и kCFStringEncodingUTF8. Отметьте, у них нет определенного значения DR как с ранее поддерживаемыми кодировками.

Эти новые кодировки предназначаются, чтобы быть указанными вдоль стороны, существующие кодировки, относительно помощника в процессе локализации должны много языковой текст CD быть желаемыми. Поддержка Сдвига JIS, в то время как задокументировано в спецификацию Красной книги, не может поддерживаться на большей части текста CD способные устройства. Поддержку UTF-8 не определяют в спецификации Красной книги и нужно считать поставщиком определенным улучшением, конструкторы, взволнованные по поводу совместимости, должны избежать его использования.
Жанры текста CD

Числовые значения для жанров звукового содержимого.

Объявление

Objective C

enum { kDRCDTextGenreCodeUnknown = 0x0001, kDRCDTextGenreCodeAdultContemporary = 0x0002, kDRCDTextGenreCodeAlternativeRock = 0x0003, kDRCDTextGenreCodeChildrens = 0x0004, kDRCDTextGenreCodeClassical = 0x0005, kDRCDTextGenreCodeContemporaryChristian = 0x0006, kDRCDTextGenreCodeCountry = 0x0007, kDRCDTextGenreCodeDance = 0x0008, kDRCDTextGenreCodeEasyListening = 0x0009, kDRCDTextGenreCodeErotic = 0x000A, kDRCDTextGenreCodeFolk = 0x000B, kDRCDTextGenreCodeGospel = 0x000C, kDRCDTextGenreCodeHipHop = 0x000D, kDRCDTextGenreCodeJazz = 0x000E, kDRCDTextGenreCodeLatin = 0x000F, kDRCDTextGenreCodeMusical = 0x0010, kDRCDTextGenreCodeNewAge = 0x0011, kDRCDTextGenreCodeOpera = 0x0012, kDRCDTextGenreCodeOperetta = 0x0013, kDRCDTextGenreCodePop = 0x0014, kDRCDTextGenreCodeRap = 0x0015, kDRCDTextGenreCodeReggae = 0x0016, kDRCDTextGenreCodeRock = 0x0017, kDRCDTextGenreCodeRhythmAndBlues = 0x0018, kDRCDTextGenreCodeSoundEffects = 0x0019, kDRCDTextGenreCodeSoundtrack = 0x001A, kDRCDTextGenreCodeSpokenWord = 0x001B, kDRCDTextGenreCodeWorldMusic = 0x001C };

Обсуждение

Проигрыватели компакт-дисков могут использовать числовые коды, связанные с этими жанрами для автоматического присвоения настроек эквалайзера. Если никакой код жанра не указан, значение kDRCDTextGenreCodeUnknown используется.

Можно также указать текстовое описание жанра, с помощью kDRCDTextGenreKey ключа словаря текста CD, для дополнения числового кода. В типичных реализациях текстовый жанр будет видим слушателю независимо от кода жанра.