Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека Разработчика iOS

Разработчик

Ссылка платформы CoreMedia ссылка CMTextMarkup

Опции
Развертывание Target:

На этой странице
Язык:

Ссылка CMTextMarkup

Наследование

Не применимый

Соответствует

Не применимый

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

Swift

import CoreMedia

Objective C

@import CoreMedia;

Этот документ описывает связанные атрибуты разметки текста, на которые отвечают Базовые Носители.

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

Константы

  • Текстовые атрибуты разметки

    Приписанные строковые ключи используются Базовыми Носителями.

    Объявление

    Swift

    let kCMTextMarkupAttribute_ForegroundColorARGB: CFString! let kCMTextMarkupAttribute_BackgroundColorARGB: CFString! let kCMTextMarkupAttribute_CharacterBackgroundColorARGB: CFString! let kCMTextMarkupAttribute_BoldStyle: CFString! let kCMTextMarkupAttribute_ItalicStyle: CFString! let kCMTextMarkupAttribute_UnderlineStyle: CFString! let kCMTextMarkupAttribute_FontFamilyName: CFString! let kCMTextMarkupAttribute_GenericFontFamilyName: CFString! let kCMTextMarkupAttribute_BaseFontSizePercentageRelativeToVideoHeight: CFString! let kCMTextMarkupAttribute_RelativeFontSize: CFString! let kCMTextMarkupAttribute_VerticalLayout: CFString! let kCMTextMarkupAttribute_Alignment: CFString! let kCMTextMarkupAttribute_TextPositionPercentageRelativeToWritingDirection: CFString! let kCMTextMarkupAttribute_OrthogonalLinePositionPercentageRelativeToWritingDirection: CFString! let kCMTextMarkupAttribute_WritingDirectionSizePercentage: CFString! let kCMTextMarkupAttribute_CharacterEdgeStyle: CFString!

    Objective C

    const CFStringRef kCMTextMarkupAttribute_ForegroundColorARGB; const CFStringRef kCMTextMarkupAttribute_BackgroundColorARGB; const CFStringRef kCMTextMarkupAttribute_CharacterBackgroundColorARGB; const CFStringRef kCMTextMarkupAttribute_BoldStyle; const CFStringRef kCMTextMarkupAttribute_ItalicStyle; const CFStringRef kCMTextMarkupAttribute_UnderlineStyle; const CFStringRef kCMTextMarkupAttribute_FontFamilyName; const CFStringRef kCMTextMarkupAttribute_GenericFontFamilyName; const CFStringRef kCMTextMarkupAttribute_BaseFontSizePercentageRelativeToVideoHeight; const CFStringRef kCMTextMarkupAttribute_RelativeFontSize; const CFStringRef kCMTextMarkupAttribute_VerticalLayout; const CFStringRef kCMTextMarkupAttribute_Alignment; const CFStringRef kCMTextMarkupAttribute_TextPositionPercentageRelativeToWritingDirection; const CFStringRef kCMTextMarkupAttribute_OrthogonalLinePositionPercentageRelativeToWritingDirection; const CFStringRef kCMTextMarkupAttribute_WritingDirectionSizePercentage; const CFStringRef kCMTextMarkupAttribute_CharacterEdgeStyle;

    Константы

    • kCMTextMarkupAttribute_ForegroundColorARGB

      Основной цвет для текста.

      Значение должно быть a CFArray из 4 CFNumbers представление альфы, красных, зеленых, и синих полей со значениями между 0.0 и 1.0. Красные, зеленые и синие компоненты интерпретируются в sRGB цветовом пространстве. Альфа указывает непрозрачность от 0.0 для очевидного для 1.0 для непрозрачных 100%.

      Доступный в iOS 6.0 и позже.

    • kCMTextMarkupAttribute_BackgroundColorARGB

      Цвет фона для формы, содержащей текст.

      Значение должно быть a CFArray из 4 CFNumbers представление альфы, красных, зеленых, и синих полей со значениями между 0.0 и 1.0. Красные, зеленые и синие компоненты интерпретируются в sRGB цветовом пространстве. Альфа указывает непрозрачность от 0.0 для очевидного для 1.0 для непрозрачных 100%.

      Цвет применяется к геометрии (например, поле) содержащий текст. Цвет фона контейнера может иметь альфу 0 таким образом, это не выведено на экран даже при том, что текст выведен на экран. Цвет позади отдельных символов дополнительно управляем с kCMTextMarkupAttribute_CharacterBackgroundColorARGB атрибут.

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

      Доступный в iOS 6.0 и позже.

    • kCMTextMarkupAttribute_CharacterBackgroundColorARGB

      Цвет фона позади отдельных текстовых символов.

      Значение должно быть a CFArray из 4 CFNumbers представление альфы, красных, зеленых, и синих полей со значениями между 0.0 и 1.0. Красные, зеленые и синие компоненты интерпретируются в sRGB цветовом пространстве. Альфа указывает непрозрачность от 0.0 для очевидного для 1.0 для непрозрачных 100%.

      Доступный в iOS 7.0 и позже.

    • kCMTextMarkupAttribute_BoldStyle

      Указывает стиль полужирного текста.

      Значение должно быть a CFBoolean. Значение по умолчанию kCFBooleanFalse. Если этот атрибут kCFBooleanTrue, текст будет составлен с полужирным стилем. Другие стили, такие как курсив могут или не могут использоваться также.

      Доступный в iOS 6.0 и позже.

    • kCMTextMarkupAttribute_ItalicStyle

      Указывает курсивный стиль текста.

      Значение должно быть a CFBoolean. Значение по умолчанию kCFBooleanFalse. Если этот атрибут kCFBooleanTrue, текст будет представлен с курсивным стилем. Другие стили такой как полужирные могут или не могут использоваться также.

      Доступный в iOS 6.0 и позже.

    • kCMTextMarkupAttribute_UnderlineStyle

      Указывает стиль подчеркнутого текста.

      Значение должно быть a CFBoolean. Значение по умолчанию kCFBooleanFalse. Если этот атрибут kCFBooleanTrue, текст будет представлен с подчеркиванием. Другие стили такой как полужирные могут или не могут использоваться также.

      Доступный в iOS 6.0 и позже.

    • kCMTextMarkupAttribute_FontFamilyName

      Имя шрифта.

      Значение должно быть a CFString содержа фамилию установленного шрифта (например, «Helvetica»), который используется, чтобы представить и/или измерить текст.

      Когда продается четким выводом, приписанная строка будет иметь самое большее один из kCMTextMarkupAttribute_FontFamilyName или kCMTextMarkupAttribute_GenericFontFamilyName связанный с каждым символом.

      Доступный в iOS 6.0 и позже.

    • kCMTextMarkupAttribute_GenericFontFamilyName

      Атрибут, содержащий идентификатор обобщенного семейства шрифтов.

      Значение должно быть одним из CFString константы в Универсальных Именах шрифтов. Универсальные шрифты должны быть отображены на фамилии установленного шрифта прежде, чем представить и/или измерить текст (см. Ссылку на функцию Доступности Носителей).

      Когда продается четким выводом, приписанная строка будет иметь самое большее один из kCMTextMarkupAttribute_FontFamilyName или kCMTextMarkupAttribute_GenericFontFamilyName связанный с каждым символом.

      Доступный в iOS 7.0 и позже.

    • kCMTextMarkupAttribute_BaseFontSizePercentageRelativeToVideoHeight

      Основной размер шрифта, выраженный как процент видео высоты.

      Значение должно быть неотрицательным CFNumber. Это - число, содержащее процент высоты видеокадра. Например, значение 5 указывает, что основной размер шрифта должен составить 5% высоты видео.

      Доступный в iOS 7.0 и позже.

    • kCMTextMarkupAttribute_RelativeFontSize

      Размер шрифта, выраженный как процент текущего размера стандартного шрифта.

      Значение должно быть неотрицательным CFNumber. Это - число, содержащее процент размера расчетного размера стандартного шрифта. Значение 120 указывает на 20% больше, чем размер стандартного шрифта. Значение 80 указывает 80% размера стандартного шрифта. Значение по умолчанию 100 не указывает различия в размере.

      Доступный в iOS 6.0 и позже.

    • kCMTextMarkupAttribute_VerticalLayout

      Вид вертикального макета текстового блока.

      Значение должно быть одним из CFString константы в Константах Вертикального макета, указывающих направление прогрессии для новых вертикальных строк текста. Если этот атрибут присутствует, он указывает, что направление записи является вертикальным. Значение атрибута указывает, добавляются ли новые строки вертикального текста слева направо или справа налево. Если этот атрибут отсутствует, направление записи является горизонталью.

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

      Доступный в iOS 7.0 и позже.

    • kCMTextMarkupAttribute_Alignment

      Выравнивание текста в направлении записи первой строки текста.

      Значение должно быть одним из CFString константы в Константах Типа Выравнивания, указывающих выравнивание в направлении записи первой строки текста сигнала. Направление записи обозначено значением (или отсутствие) kCMTextMarkupAttribute_VerticalLayout атрибут. Значение по умолчанию этого атрибута kCMTextMarkupAlignmentType_Middle.

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

      Доступный в iOS 7.0 и позже.

    • kCMTextMarkupAttribute_TextPositionPercentageRelativeToWritingDirection

      Размещение блока текста, указанного как процент в направлении записи.

      Значение должно быть неотрицательным CFNumber. Это - число, выражающее позицию центра текста в направлении записи как процент видео размерностей в направлении записи. Для горизонтальных сигналов это - горизонтальная позиция. Для вертикали это - вертикальная позиция. Процент вычисляется от края кадра, где текст начинается (так для слева направо английского языка, это - левый край).

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

      Доступный в iOS 7.0 и позже.

    • kCMTextMarkupAttribute_OrthogonalLinePositionPercentageRelativeToWritingDirection

      Размещение блока первой строки текста, указанной как процент в направлении, ортогональном к направлению записи.

      Значение должно быть неотрицательным CFNumber. Это - число, выражающее позицию центра сигнала относительно направления записи. Позиция строки является ортогональной (или перпендикуляр) к направлению записи (т.е. для горизонтального направления записи, это вертикально и для вертикального направления записи, горизонталь). Этот атрибут выражает позицию строки как процент размерностей видеокадра в соответствующем направлении. Например, 0% вершина видеокадра, и 100% нижняя часть видеокадра для горизонтального расположения записи.

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

      Доступный в iOS 7.0 и позже.

    • kCMTextMarkupAttribute_WritingDirectionSizePercentage

      Размерность (ширина или высота) ограничительной рамки, содержащей текст, выраженный как процент.

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

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

      Доступный в iOS 7.0 и позже.

    • kCMTextMarkupAttribute_CharacterEdgeStyle

      Указывает альтернативные формы для краев символов.

      Значение должно быть одним из CFString константы в Символьных Граничных Константах Стиля, управляющих формой краев нарисованных символов. Значение по умолчанию kCMTextMarkupCharacterEdgeStyle_None.

      Доступный в iOS 7.0 и позже.

  • Универсальные имена шрифтов

    Значения для kCMTextMarkupAttribute_GenericFontFamilyName шрифты указания атрибута их общими свойствами.

    Объявление

    Swift

    let kCMTextMarkupGenericFontName_Default: CFString! let kCMTextMarkupGenericFontName_Serif: CFString! let kCMTextMarkupGenericFontName_SansSerif: CFString! let kCMTextMarkupGenericFontName_Monospace: CFString! let kCMTextMarkupGenericFontName_ProportionalSerif: CFString! let kCMTextMarkupGenericFontName_ProportionalSansSerif: CFString! let kCMTextMarkupGenericFontName_MonospaceSerif: CFString! let kCMTextMarkupGenericFontName_MonospaceSansSerif: CFString! let kCMTextMarkupGenericFontName_Casual: CFString! let kCMTextMarkupGenericFontName_Cursive: CFString! let kCMTextMarkupGenericFontName_Fantasy: CFString! let kCMTextMarkupGenericFontName_SmallCapital: CFString!

    Objective C

    const CFStringRef kCMTextMarkupGenericFontName_Default; const CFStringRef kCMTextMarkupGenericFontName_Serif; const CFStringRef kCMTextMarkupGenericFontName_SansSerif; const CFStringRef kCMTextMarkupGenericFontName_Monospace; const CFStringRef kCMTextMarkupGenericFontName_ProportionalSerif; const CFStringRef kCMTextMarkupGenericFontName_ProportionalSansSerif; const CFStringRef kCMTextMarkupGenericFontName_MonospaceSerif; const CFStringRef kCMTextMarkupGenericFontName_MonospaceSansSerif; const CFStringRef kCMTextMarkupGenericFontName_Casual; const CFStringRef kCMTextMarkupGenericFontName_Cursive; const CFStringRef kCMTextMarkupGenericFontName_Fantasy; const CFStringRef kCMTextMarkupGenericFontName_SmallCapital;

    Константы

    • kCMTextMarkupGenericFontName_Default

      Универсальное имя шрифта, указывающее стандартный шрифт. Если никакое семейство шрифтов не указано, стандартный шрифт может также быть выбран.

      Доступный в iOS 7.0 и позже.

    • kCMTextMarkupGenericFontName_Serif

      Универсальное имя шрифта, указывающее шрифт с засечками (например, Times New Roman). Шрифт может быть пропорциональным или моноширинным.

      Доступный в iOS 7.0 и позже.

    • kCMTextMarkupGenericFontName_SansSerif

      Универсальное имя шрифта, указывающее шрифт без засечек (например, Helvetica). Шрифт может быть пропорциональным или моноширинным.

      Доступный в iOS 7.0 и позже.

    • kCMTextMarkupGenericFontName_Monospace

      Универсальное имя шрифта, указывающее моноширинный шрифт (например, Курьер), с или без засечек.

      Доступный в iOS 7.0 и позже.

    • kCMTextMarkupGenericFontName_ProportionalSerif

      Универсальное имя шрифта, указывающее пропорциональный шрифт с засечками.

      Доступный в iOS 7.0 и позже.

    • kCMTextMarkupGenericFontName_ProportionalSansSerif

      Универсальное имя шрифта, указывающее пропорциональный шрифт без засечек.

      Доступный в iOS 7.0 и позже.

    • kCMTextMarkupGenericFontName_MonospaceSerif

      Универсальное имя шрифта, указывающее моноширинный шрифт с засечками.

      Доступный в iOS 7.0 и позже.

    • kCMTextMarkupGenericFontName_MonospaceSansSerif

      Универсальное имя шрифта, указывающее моноширинный шрифт без засечек.

      Доступный в iOS 7.0 и позже.

    • kCMTextMarkupGenericFontName_Casual

      Универсальное имя шрифта, указывающее «случайный» шрифт (например, Юридический адрес или Отпечаток).

      Доступный в iOS 7.0 и позже.

    • kCMTextMarkupGenericFontName_Cursive

      Универсальное имя шрифта, указывающее рукописный шрифт (например, Coronet или Мэриголд).

      Доступный в iOS 7.0 и позже.

    • kCMTextMarkupGenericFontName_Fantasy

      Универсальное имя шрифта, указывающее «фэнтезийный» шрифт.

      Доступный в iOS 7.0 и позже.

    • kCMTextMarkupGenericFontName_SmallCapital

      Универсальное имя шрифта, указывающее шрифт с набором строчных букв как маленькие прописные (например, готический шрифт Граверов).

      Доступный в iOS 7.0 и позже.

    Обсуждение

    Некоторые форматы носителя позволяют спецификации имен семейства шрифтов использоваться для моделирования текста, который они переносят. Иногда, внешняя спецификация, такая как CSS использоваться для моделирования текста, который переносит формат носителя. В любом случае спецификация может быть конкретной, указав установленный шрифт платформы (например, «Times New Roman», Helvetica). Это может быть абстрактно, указав категорию шрифта для использования (например, засечка, гротесковый шрифт). Это абстрактное обозначение часто называют «обобщенным семейством шрифтов».

    Платформа Доступности Носителей может отобразить восемь категорий абстрактных шрифтов к установленному шрифту. Пользователи могут принять решение переопределить каждую из этих категорий к различному установленному шрифту. (См. Ссылку на функцию Доступности Носителей.)

  • Константы вертикального макета

    Значения для kCMTextMarkupAttribute_VerticalLayout атрибут, указывающий расположение вертикального текста.

    Объявление

    Swift

    let kCMTextVerticalLayout_LeftToRight: CFString! let kCMTextVerticalLayout_RightToLeft: CFString!

    Objective C

    const CFStringRef kCMTextVerticalLayout_LeftToRight; const CFStringRef kCMTextVerticalLayout_RightToLeft;

    Константы

    • kCMTextVerticalLayout_LeftToRight

      Недавно добавленные вертикальные строки добавляются слева к праву.

      Доступный в iOS 7.0 и позже.

    • kCMTextVerticalLayout_RightToLeft

      Недавно добавленные вертикальные строки добавляются от права к левым.

      Доступный в iOS 7.0 и позже.

    Обсуждение

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

  • Константы типа выравнивания

    Значения для kCMTextMarkupAttribute_Alignment атрибут, указывающий выравнивание текста в его направлении записи.

    Объявление

    Swift

    let kCMTextMarkupAlignmentType_Start: CFString! let kCMTextMarkupAlignmentType_Middle: CFString! let kCMTextMarkupAlignmentType_End: CFString! let kCMTextMarkupAlignmentType_Left: CFString! let kCMTextMarkupAlignmentType_Right: CFString!

    Objective C

    const CFStringRef kCMTextMarkupAlignmentType_Start; const CFStringRef kCMTextMarkupAlignmentType_Middle; const CFStringRef kCMTextMarkupAlignmentType_End; const CFStringRef kCMTextMarkupAlignmentType_Left; const CFStringRef kCMTextMarkupAlignmentType_Right;

    Константы

    • kCMTextMarkupAlignmentType_Start

      Текст визуально выровненный в его стартовой стороне.

      Для горизонтально записанного текста в выравнивание уезжают слева направо текст и прямо для справа налево текста. Для вертикального текста выравнивание всегда наверху.

      Доступный в iOS 7.0 и позже.

    • kCMTextMarkupAlignmentType_Middle

      Текст визуально выравнивается центром (т.е. выравнивается между его запуском и конечными сторонами).

      Доступный в iOS 7.0 и позже.

    • kCMTextMarkupAlignmentType_End

      Текст визуально выровненный в его конечной стороне.

      Для горизонтально записанного текста выравнивание является правильным для слева направо текста и уехавшее справа налево текст. Для вертикального текста выравнивание всегда в нижней части.

      Доступный в iOS 7.0 и позже.

    • kCMTextMarkupAlignmentType_Left

      Для горизонтально записанного текста всегда визуально выравнивается по левому краю выравнивание текста (т.е. слева направо и справа налево обрабатываются унифицированно). Для вертикального текста это эквивалентно kCMTextMarkupAlignmentType_Start.

      В то время как читатели должны быть подготовлены составить kCMTextMarkupAlignmentType_Left быть эквивалентным kCMTextMarkupAlignmentType_Start для вертикального текста авторы отговорены использовать kCMTextMarkupAlignmentType_Left для вертикального текста.

      Доступный в iOS 7.0 и позже.

    • kCMTextMarkupAlignmentType_Right

      Для горизонтально записанного текста выравнивание текста всегда визуально выровнено по правому краю (т.е. слева направо и справа налево обрабатываются унифицированно). Для вертикального текста это эквивалентно kCMTextMarkupAlignmentType_End.

      В то время как читатели должны быть подготовлены составить kCMTextMarkupAlignmentType_Right быть эквивалентным kCMTextMarkupAlignmentType_End для вертикального текста авторы отговорены использовать kCMTextMarkupAlignmentType_Right для вертикального текста.

      Доступный в iOS 7.0 и позже.

  • Символьные граничные константы стиля

    Значения для kCMTextMarkupAttribute_CharacterEdgeStyle атрибут, управляющий визуальным стилем для символьных краев.

    Объявление

    Swift

    let kCMTextMarkupCharacterEdgeStyle_None: CFString! let kCMTextMarkupCharacterEdgeStyle_Raised: CFString! let kCMTextMarkupCharacterEdgeStyle_Depressed: CFString! let kCMTextMarkupCharacterEdgeStyle_Uniform: CFString! let kCMTextMarkupCharacterEdgeStyle_DropShadow: CFString!

    Objective C

    const CFStringRef kCMTextMarkupCharacterEdgeStyle_None; const CFStringRef kCMTextMarkupCharacterEdgeStyle_Raised; const CFStringRef kCMTextMarkupCharacterEdgeStyle_Depressed; const CFStringRef kCMTextMarkupCharacterEdgeStyle_Uniform; const CFStringRef kCMTextMarkupCharacterEdgeStyle_DropShadow;

    Константы

    • kCMTextMarkupCharacterEdgeStyle_None

      Не указывает граничного стиля.

      Доступный в iOS 7.0 и позже.

    • kCMTextMarkupCharacterEdgeStyle_Raised

      Указывает повышенный граничный стиль.

      Доступный в iOS 7.0 и позже.

    • kCMTextMarkupCharacterEdgeStyle_Depressed

      Указывает подавленный граничный стиль.

      Доступный в iOS 7.0 и позже.

    • kCMTextMarkupCharacterEdgeStyle_Uniform

      Указывает универсальную границу вокруг символа.

      Доступный в iOS 7.0 и позже.

    • kCMTextMarkupCharacterEdgeStyle_DropShadow

      Указывает падающую тень.

      Доступный в iOS 7.0 и позже.

    Обсуждение

    Значение кроме kCMTextMarkupCharacterEdgeStyle_None указывает, что текст должен быть составлен с помощью альтернативной формы для краев символов. Они соответствуют текстовым граничным стилям, доступным с предпочтениями Доступности Носителей (см. Ссылку на функцию Доступности Носителей).