Ссылка CMTextMarkup
Этот документ описывает связанные атрибуты разметки текста, на которые отвечают Базовые Носители.
Базовые Носители включают поддержку четких мультимедийных потоков, таких как подзаголовки, заголовки и текст. В некоторых случаях клиенты, возможно, должны указать информацию о стилях для управления рендерингом. В других случаях информация о тексте и примененном моделировании может быть передана от Базовых Носителей до клиента. Для переноса этой информации Базовые Носители определяют ряд атрибутов, которые могут использоваться в словарях тот Базовое использование Носителей. Эти атрибуты могут также использоваться как 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
kCMTextMarkupAttribute_ForegroundColorARGB
Основной цвет для текста.
Значение должно быть a
CFArray
из 4CFNumber
s представление альфы, красных, зеленых, и синих полей со значениями между0.0
и1.0
. Красные, зеленые и синие компоненты интерпретируются в sRGB цветовом пространстве. Альфа указывает непрозрачность от0.0
для очевидного для1.0
для непрозрачных 100%.Доступный в OS X v10.9 и позже.
-
kCMTextMarkupAttribute_BackgroundColorARGB
kCMTextMarkupAttribute_BackgroundColorARGB
Цвет фона для формы, содержащей текст.
Значение должно быть a
CFArray
из 4CFNumber
s представление альфы, красных, зеленых, и синих полей со значениями между0.0
и1.0
. Красные, зеленые и синие компоненты интерпретируются в sRGB цветовом пространстве. Альфа указывает непрозрачность от0.0
для очевидного для1.0
для непрозрачных 100%.Цвет применяется к геометрии (например, поле) содержащий текст. Цвет фона контейнера может иметь альфу
0
таким образом, это не выведено на экран даже при том, что текст выведен на экран. Цвет позади отдельных символов дополнительно управляем сkCMTextMarkupAttribute_CharacterBackgroundColorARGB
атрибут.Если используется, этот атрибут должен быть применен ко всей приписанной строке.
Доступный в OS X v10.9 и позже.
-
kCMTextMarkupAttribute_CharacterBackgroundColorARGB
kCMTextMarkupAttribute_CharacterBackgroundColorARGB
Цвет фона позади отдельных текстовых символов.
Значение должно быть a
CFArray
из 4CFNumber
s представление альфы, красных, зеленых, и синих полей со значениями между0.0
и1.0
. Красные, зеленые и синие компоненты интерпретируются в sRGB цветовом пространстве. Альфа указывает непрозрачность от0.0
для очевидного для1.0
для непрозрачных 100%.Доступный в OS X v10.9 и позже.
-
kCMTextMarkupAttribute_BoldStyle
kCMTextMarkupAttribute_BoldStyle
Указывает стиль полужирного текста.
Значение должно быть a
CFBoolean
. Значение по умолчаниюkCFBooleanFalse
. Если этот атрибутkCFBooleanTrue
, текст будет составлен с полужирным стилем. Другие стили, такие как курсив могут или не могут использоваться также.Доступный в OS X v10.9 и позже.
-
kCMTextMarkupAttribute_ItalicStyle
kCMTextMarkupAttribute_ItalicStyle
Указывает курсивный стиль текста.
Значение должно быть a
CFBoolean
. Значение по умолчаниюkCFBooleanFalse
. Если этот атрибутkCFBooleanTrue
, текст будет представлен с курсивным стилем. Другие стили такой как полужирные могут или не могут использоваться также.Доступный в OS X v10.9 и позже.
-
kCMTextMarkupAttribute_UnderlineStyle
kCMTextMarkupAttribute_UnderlineStyle
Указывает стиль подчеркнутого текста.
Значение должно быть a
CFBoolean
. Значение по умолчаниюkCFBooleanFalse
. Если этот атрибутkCFBooleanTrue
, текст будет представлен с подчеркиванием. Другие стили такой как полужирные могут или не могут использоваться также.Доступный в OS X v10.9 и позже.
-
kCMTextMarkupAttribute_FontFamilyName
kCMTextMarkupAttribute_FontFamilyName
Имя шрифта.
Значение должно быть a
CFString
содержа фамилию установленного шрифта (например, «Helvetica»), который используется, чтобы представить и/или измерить текст.Когда продается четким выводом, приписанная строка будет иметь самое большее один из
kCMTextMarkupAttribute_FontFamilyName
илиkCMTextMarkupAttribute_GenericFontFamilyName
связанный с каждым символом.Доступный в OS X v10.9 и позже.
-
kCMTextMarkupAttribute_GenericFontFamilyName
kCMTextMarkupAttribute_GenericFontFamilyName
Атрибут, содержащий идентификатор обобщенного семейства шрифтов.
Значение должно быть одним из
CFString
константы в Универсальных Именах шрифтов. Универсальные шрифты должны быть отображены на фамилии установленного шрифта прежде, чем представить и/или измерить текст (см. Ссылку на функцию Доступности Носителей).Когда продается четким выводом, приписанная строка будет иметь самое большее один из
kCMTextMarkupAttribute_FontFamilyName
илиkCMTextMarkupAttribute_GenericFontFamilyName
связанный с каждым символом.Доступный в OS X v10.9 и позже.
-
kCMTextMarkupAttribute_BaseFontSizePercentageRelativeToVideoHeight
kCMTextMarkupAttribute_BaseFontSizePercentageRelativeToVideoHeight
Основной размер шрифта, выраженный как процент видео высоты.
Значение должно быть неотрицательным
CFNumber
. Это - число, содержащее процент высоты видеокадра. Например, значение5
указывает, что основной размер шрифта должен составить 5% высоты видео.Доступный в OS X v10.9 и позже.
-
kCMTextMarkupAttribute_RelativeFontSize
kCMTextMarkupAttribute_RelativeFontSize
Размер шрифта, выраженный как процент текущего размера стандартного шрифта.
Значение должно быть неотрицательным
CFNumber
. Это - число, содержащее процент размера расчетного размера стандартного шрифта. Значение120
указывает на 20% больше, чем размер стандартного шрифта. Значение80
указывает 80% размера стандартного шрифта. Значение по умолчанию100
не указывает различия в размере.Доступный в OS X v10.9 и позже.
-
kCMTextMarkupAttribute_VerticalLayout
kCMTextMarkupAttribute_VerticalLayout
Вид вертикального макета текстового блока.
Значение должно быть одним из
CFString
константы в Константах Вертикального макета, указывающих направление прогрессии для новых вертикальных строк текста. Если этот атрибут присутствует, он указывает, что направление записи является вертикальным. Значение атрибута указывает, добавляются ли новые строки вертикального текста слева направо или справа налево. Если этот атрибут отсутствует, направление записи является горизонталью.Если используется, этот атрибут должен быть применен ко всей приписанной строке.
Доступный в OS X v10.9 и позже.
-
kCMTextMarkupAttribute_Alignment
kCMTextMarkupAttribute_Alignment
Выравнивание текста в направлении записи первой строки текста.
Значение должно быть одним из
CFString
константы в Константах Типа Выравнивания, указывающих выравнивание в направлении записи первой строки текста сигнала. Направление записи обозначено значением (или отсутствие)kCMTextMarkupAttribute_VerticalLayout
атрибут. Значение по умолчанию этого атрибутаkCMTextMarkupAlignmentType_Middle
.Если используется, этот атрибут должен быть применен ко всей приписанной строке.
Доступный в OS X v10.9 и позже.
-
kCMTextMarkupAttribute_TextPositionPercentageRelativeToWritingDirection
kCMTextMarkupAttribute_TextPositionPercentageRelativeToWritingDirection
Размещение блока текста, указанного как процент в направлении записи.
Значение должно быть неотрицательным
CFNumber
. Это - число, выражающее позицию центра текста в направлении записи как процент видео размерностей в направлении записи. Для горизонтальных сигналов это - горизонтальная позиция. Для вертикали это - вертикальная позиция. Процент вычисляется от края кадра, где текст начинается (так для слева направо английского языка, это - левый край).Если используется, этот атрибут должен быть применен ко всей приписанной строке.
Доступный в OS X v10.9 и позже.
-
kCMTextMarkupAttribute_OrthogonalLinePositionPercentageRelativeToWritingDirection
kCMTextMarkupAttribute_OrthogonalLinePositionPercentageRelativeToWritingDirection
Размещение блока первой строки текста, указанной как процент в направлении, ортогональном к направлению записи.
Значение должно быть неотрицательным
CFNumber
. Это - число, выражающее позицию центра сигнала относительно направления записи. Позиция строки является ортогональной (или перпендикуляр) к направлению записи (т.е. для горизонтального направления записи, это вертикально и для вертикального направления записи, горизонталь). Этот атрибут выражает позицию строки как процент размерностей видеокадра в соответствующем направлении. Например, 0% вершина видеокадра, и 100% нижняя часть видеокадра для горизонтального расположения записи.Если используется, этот атрибут должен быть применен ко всей приписанной строке.
Доступный в OS X v10.9 и позже.
-
kCMTextMarkupAttribute_WritingDirectionSizePercentage
kCMTextMarkupAttribute_WritingDirectionSizePercentage
Размерность (ширина или высота) ограничительной рамки, содержащей текст, выраженный как процент.
Значение должно быть неотрицательным
CFNumber
. Это - число, выражающее ширину ограничительной рамки для текстового расположения как процент размерности видеокадра в направлении записи. Для горизонтального направления записи это - ширина. Для вертикального направления записи это - высота.Если используется, этот атрибут должен быть применен ко всей приписанной строке.
Доступный в OS X v10.9 и позже.
-
kCMTextMarkupAttribute_CharacterEdgeStyle
kCMTextMarkupAttribute_CharacterEdgeStyle
Указывает альтернативные формы для краев символов.
Значение должно быть одним из
CFString
константы в Символьных Граничных Константах Стиля, управляющих формой краев нарисованных символов. Значение по умолчаниюkCMTextMarkupCharacterEdgeStyle_None
.Доступный в OS X v10.9 и позже.
-
-
Значения для
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
kCMTextMarkupGenericFontName_Default
Универсальное имя шрифта, указывающее стандартный шрифт. Если никакое семейство шрифтов не указано, стандартный шрифт может также быть выбран.
Доступный в OS X v10.9 и позже.
-
kCMTextMarkupGenericFontName_Serif
kCMTextMarkupGenericFontName_Serif
Универсальное имя шрифта, указывающее шрифт с засечками (например, Times New Roman). Шрифт может быть пропорциональным или моноширинным.
Доступный в OS X v10.9 и позже.
-
kCMTextMarkupGenericFontName_SansSerif
kCMTextMarkupGenericFontName_SansSerif
Универсальное имя шрифта, указывающее шрифт без засечек (например, Helvetica). Шрифт может быть пропорциональным или моноширинным.
Доступный в OS X v10.9 и позже.
-
kCMTextMarkupGenericFontName_Monospace
kCMTextMarkupGenericFontName_Monospace
Универсальное имя шрифта, указывающее моноширинный шрифт (например, Курьер), с или без засечек.
Доступный в OS X v10.9 и позже.
-
kCMTextMarkupGenericFontName_ProportionalSerif
kCMTextMarkupGenericFontName_ProportionalSerif
Универсальное имя шрифта, указывающее пропорциональный шрифт с засечками.
Доступный в OS X v10.9 и позже.
-
kCMTextMarkupGenericFontName_ProportionalSansSerif
kCMTextMarkupGenericFontName_ProportionalSansSerif
Универсальное имя шрифта, указывающее пропорциональный шрифт без засечек.
Доступный в OS X v10.9 и позже.
-
kCMTextMarkupGenericFontName_MonospaceSerif
kCMTextMarkupGenericFontName_MonospaceSerif
Универсальное имя шрифта, указывающее моноширинный шрифт с засечками.
Доступный в OS X v10.9 и позже.
-
kCMTextMarkupGenericFontName_MonospaceSansSerif
kCMTextMarkupGenericFontName_MonospaceSansSerif
Универсальное имя шрифта, указывающее моноширинный шрифт без засечек.
Доступный в OS X v10.9 и позже.
-
kCMTextMarkupGenericFontName_Casual
kCMTextMarkupGenericFontName_Casual
Универсальное имя шрифта, указывающее «случайный» шрифт (например, Юридический адрес или Отпечаток).
Доступный в OS X v10.9 и позже.
-
kCMTextMarkupGenericFontName_Cursive
kCMTextMarkupGenericFontName_Cursive
Универсальное имя шрифта, указывающее рукописный шрифт (например, Coronet или Мэриголд).
Доступный в OS X v10.9 и позже.
-
kCMTextMarkupGenericFontName_Fantasy
kCMTextMarkupGenericFontName_Fantasy
Универсальное имя шрифта, указывающее «фэнтезийный» шрифт.
Доступный в OS X v10.9 и позже.
-
kCMTextMarkupGenericFontName_SmallCapital
kCMTextMarkupGenericFontName_SmallCapital
Универсальное имя шрифта, указывающее шрифт с набором строчных букв как маленькие прописные (например, готический шрифт Граверов).
Доступный в OS X v10.9 и позже.
Обсуждение
Некоторые форматы носителя позволяют спецификации имен семейства шрифтов использоваться для моделирования текста, который они переносят. Иногда, внешняя спецификация, такая как 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
kCMTextVerticalLayout_LeftToRight
Недавно добавленные вертикальные строки добавляются слева к праву.
Доступный в OS X v10.9 и позже.
-
kCMTextVerticalLayout_RightToLeft
kCMTextVerticalLayout_RightToLeft
Недавно добавленные вертикальные строки добавляются от права к левым.
Доступный в OS X v10.9 и позже.
Обсуждение
Присутствие этого атрибута указывает, что направление записи для текста является вертикальным. Если этот атрибут не присутствует, текст должен быть размечен горизонтально.
-
-
Значения для
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
kCMTextMarkupAlignmentType_Start
Текст визуально выровненный в его стартовой стороне.
Для горизонтально записанного текста в выравнивание уезжают слева направо текст и прямо для справа налево текста. Для вертикального текста выравнивание всегда наверху.
Доступный в OS X v10.9 и позже.
-
kCMTextMarkupAlignmentType_Middle
kCMTextMarkupAlignmentType_Middle
Текст визуально выравнивается центром (т.е. выравнивается между его запуском и конечными сторонами).
Доступный в OS X v10.9 и позже.
-
kCMTextMarkupAlignmentType_End
kCMTextMarkupAlignmentType_End
Текст визуально выровненный в его конечной стороне.
Для горизонтально записанного текста выравнивание является правильным для слева направо текста и уехавшее справа налево текст. Для вертикального текста выравнивание всегда в нижней части.
Доступный в OS X v10.9 и позже.
-
kCMTextMarkupAlignmentType_Left
kCMTextMarkupAlignmentType_Left
Для горизонтально записанного текста всегда визуально выравнивается по левому краю выравнивание текста (т.е. слева направо и справа налево обрабатываются унифицированно). Для вертикального текста это эквивалентно
kCMTextMarkupAlignmentType_Start
.В то время как читатели должны быть подготовлены составить
kCMTextMarkupAlignmentType_Left
быть эквивалентнымkCMTextMarkupAlignmentType_Start
для вертикального текста авторы отговорены использоватьkCMTextMarkupAlignmentType_Left
для вертикального текста.Доступный в OS X v10.9 и позже.
-
kCMTextMarkupAlignmentType_Right
kCMTextMarkupAlignmentType_Right
Для горизонтально записанного текста выравнивание текста всегда визуально выровнено по правому краю (т.е. слева направо и справа налево обрабатываются унифицированно). Для вертикального текста это эквивалентно
kCMTextMarkupAlignmentType_End
.В то время как читатели должны быть подготовлены составить
kCMTextMarkupAlignmentType_Right
быть эквивалентнымkCMTextMarkupAlignmentType_End
для вертикального текста авторы отговорены использоватьkCMTextMarkupAlignmentType_Right
для вертикального текста.Доступный в OS X v10.9 и позже.
-
-
Значения для
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
kCMTextMarkupCharacterEdgeStyle_None
Не указывает граничного стиля.
Доступный в OS X v10.9 и позже.
-
kCMTextMarkupCharacterEdgeStyle_Raised
kCMTextMarkupCharacterEdgeStyle_Raised
Указывает повышенный граничный стиль.
Доступный в OS X v10.9 и позже.
-
kCMTextMarkupCharacterEdgeStyle_Depressed
kCMTextMarkupCharacterEdgeStyle_Depressed
Указывает подавленный граничный стиль.
Доступный в OS X v10.9 и позже.
-
kCMTextMarkupCharacterEdgeStyle_Uniform
kCMTextMarkupCharacterEdgeStyle_Uniform
Указывает универсальную границу вокруг символа.
Доступный в OS X v10.9 и позже.
-
kCMTextMarkupCharacterEdgeStyle_DropShadow
kCMTextMarkupCharacterEdgeStyle_DropShadow
Указывает падающую тень.
Доступный в OS X v10.9 и позже.
Обсуждение
Значение кроме
kCMTextMarkupCharacterEdgeStyle_None
указывает, что текст должен быть составлен с помощью альтернативной формы для краев символов. Они соответствуют текстовым граничным стилям, доступным с предпочтениями Доступности Носителей (см. Ссылку на функцию Доступности Носителей). -