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

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

Разработчик

Ссылка платформы ApplicationServices ссылка CGImage

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

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

Ссылка CGImage

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

Функции

Создание растровых изображений
  • CGImageCreate (_: _: _: _: _: _: _: _: _: _: _:) CGImageCreate

    Создает растровое изображение из данных, снабженных провайдером данных.

    Объявление

    Swift

    func CGImageCreate(_ width: UInt, _ height: UInt, _ bitsPerComponent: UInt, _ bitsPerPixel: UInt, _ bytesPerRow: UInt, _ colorspace: CGColorSpace!, _ bitmapInfo: CGBitmapInfo, _ provider: CGDataProvider!, _ decode: UnsafePointer<CGFloat>, _ shouldInterpolate: Bool, _ intent: CGColorRenderingIntent) -> CGImage!

    Objective C

    CGImageRef CGImageCreate ( size_t width, size_t height, size_t bitsPerComponent, size_t bitsPerPixel, size_t bytesPerRow, CGColorSpaceRef space, CGBitmapInfo bitmapInfo, CGDataProviderRef provider, const CGFloat decode[], bool shouldInterpolate, CGColorRenderingIntent intent );

    Параметры

    width

    Ширина, в пикселях, требуемого изображения.

    height

    Высота, в пикселях, требуемого изображения

    bitsPerComponent

    Число битов для каждого компонента в исходном пикселе. Например, если бы исходное изображение использует формат RGBA-32, Вы указали бы 8 битов за компонент.

    bitsPerPixel

    Общее количество битов в исходном пикселе. Это значение должно быть, по крайней мере, bitsPerComponent времена число компонентов на пиксель.

    bytesPerRow

    Число байтов памяти для каждой горизонтальной строки битового массива.

    colorspace

    Цветовое пространство для изображения. Кварц сохраняет цветовое пространство, в котором Вы передаете; по возврату можно безопасно выпустить его.

    bitmapInfo

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

    provider

    Источник данных для битового массива. Для получения информации о поддерживаемых форматах данных посмотрите обсуждение ниже. Кварц сохраняет этот объект; по возврату можно безопасно выпустить его.

    decode

    Массив декодирования для изображения. Если Вы не хотите позволять повторно отображаться значений цвета изображения, передачи NULL для массива декодирования. Для каждого компонента цвета в цветовом пространстве изображения (включая альфа-компонент), массив декодирования обеспечивает пару значений, обозначающих верхнее и нижние пределы диапазона. Например, массив декодирования для исходного изображения в цветовом пространстве RGB содержал бы шесть общих количеств записей, состоя из одной пары каждый для красного, зеленого цвета, и синий. Когда изображение представляется, Кварц использует линейное преобразование для отображения исходного значения компонента в относительное число в определяемом диапазоне, который является подходящим для целевого цветового пространства.

    shouldInterpolate

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

    intent

    Намерение рендеринга, постоянное, который указывает, как Кварц должен обработать цвета, не расположенные в палитре целевого цветового пространства графического контекста. Намерение рендеринга решает, что точный метод раньше отображал цвета от одного цветового пространства до другого. Для описаний определенных поглощенных рендерингом констант посмотрите Color Rendering Intents.

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

    Новое Кварцевое растровое изображение. Вы ответственны за выпуск этого объекта путем вызова CGImageRelease.

    Обсуждение

    Провайдер данных должен предоставить необработанные данные, который соответствует формат, указанный другими входными параметрами. Использовать закодированные данные (например, от файла, указанного ОСНОВАННЫМ НА URL провайдером данных), посмотрите CGImageCreateWithJPEGDataProvider и CGImageCreateWithPNGDataProvider. В версии 10.3 OS X и позже, можно также использовать функцию QuickTime GraphicsImportCreateCGImage декодировать файл образа в любом поддерживаемом формате и создать CGImage, в единственной работе.

    Для получения информации о поддерживаемых форматах пикселя посмотрите Кварц 2D Руководство по программированию.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGImageCreateCopy (_:) CGImageCreateCopy

    Создает копию растрового изображения.

    Объявление

    Swift

    func CGImageCreateCopy(_ image: CGImage!) -> CGImage!

    Objective C

    CGImageRef CGImageCreateCopy ( CGImageRef image );

    Параметры

    image

    Изображение для копирования.

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

    Копия изображения, указанного image параметр.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGImageCreateCopyWithColorSpace (_: _:) CGImageCreateCopyWithColorSpace

    Создайте копию растрового изображения, заменив его цветовое пространство.

    Объявление

    Swift

    func CGImageCreateCopyWithColorSpace(_ image: CGImage!, _ colorspace: CGColorSpace!) -> CGImage!

    Objective C

    CGImageRef CGImageCreateCopyWithColorSpace ( CGImageRef image, CGColorSpaceRef space );

    Параметры

    image

    Графическое изображение для копирования.

    colorspace

    Целевое цветовое пространство. Число компонентов в этом цветовом пространстве должно совпасть с числом в указанном изображении.

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

    Новое Кварцевое изображение, которое является копией изображения, передало как image параметр, но с его цветовым пространством, замененным указанным colorspace параметр. Возвраты NULL если image маска изображения, или если число компонентов colorspace не то же как число компонентов цветового пространства image. Вы ответственны за выпуск этого объектного использования CGImageRelease.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGImageCreateWithJPEGDataProvider (_: _: _: _:) CGImageCreateWithJPEGDataProvider

    Создает растровое изображение с помощью закодированных JPEG данных, снабженных провайдером данных.

    Объявление

    Swift

    func CGImageCreateWithJPEGDataProvider(_ source: CGDataProvider!, _ decode: UnsafePointer<CGFloat>, _ shouldInterpolate: Bool, _ intent: CGColorRenderingIntent) -> CGImage!

    Objective C

    CGImageRef CGImageCreateWithJPEGDataProvider ( CGDataProviderRef source, const CGFloat decode[], bool shouldInterpolate, CGColorRenderingIntent intent );

    Параметры

    source

    Провайдер данных, снабжающий закодированными JPEG данными.

    decode

    Массив декодирования для изображения. Обычно массив декодирования является ненужным, и необходимо передать NULL.

    shouldInterpolate

    Булево значение, указывающее, должна ли произойти интерполяция. Установка интерполяции указывает, должен ли Кварц применить пиксельный алгоритм сглаживания для изображения.

    intent

    A CGColorRenderingIntent постоянный, который указывает, как Кварц должен обработать цвета, не расположенные в палитре целевого цветового пространства графического контекста.

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

    Новое Кварцевое растровое изображение. Вы ответственны за выпуск этого объекта путем вызова CGImageRelease.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGImageCreateWithPNGDataProvider (_: _: _: _:) CGImageCreateWithPNGDataProvider

    Создает Кварцевое растровое изображение с помощью закодированных PNG данных, снабженных провайдером данных.

    Объявление

    Swift

    func CGImageCreateWithPNGDataProvider(_ source: CGDataProvider!, _ decode: UnsafePointer<CGFloat>, _ shouldInterpolate: Bool, _ intent: CGColorRenderingIntent) -> CGImage!

    Objective C

    CGImageRef CGImageCreateWithPNGDataProvider ( CGDataProviderRef source, const CGFloat decode[], bool shouldInterpolate, CGColorRenderingIntent intent );

    Параметры

    source

    Провайдер данных, снабжающий закодированными PNG данными.

    decode

    Массив декодирования для изображения. Обычно массив декодирования является ненужным, и необходимо передать NULL.

    shouldInterpolate

    Булево значение, указывающее, должна ли произойти интерполяция. Установка интерполяции указывает, должен ли Кварц применить пиксельный алгоритм сглаживания для изображения.

    intent

    A CGColorRenderingIntent постоянный, который указывает, как Кварц должен обработать цвета, не расположенные в палитре целевого цветового пространства графического контекста.

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

    Новое Кварцевое растровое изображение. Вы ответственны за выпуск этого объекта путем вызова CGImageRelease.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGImageCreateWithImageInRect (_: _:) CGImageCreateWithImageInRect

    Создает растровое изображение с помощью данных, содержавших в подобласти существующего растрового изображения.

    Объявление

    Swift

    func CGImageCreateWithImageInRect(_ image: CGImage!, _ rect: CGRect) -> CGImage!

    Objective C

    CGImageRef CGImageCreateWithImageInRect ( CGImageRef image, CGRect rect );

    Параметры

    image

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

    rect

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

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

    Объект CGImage, указывающий подызображение изображения. Если rect параметр определяет область, которая не находится в изображении, возвратах NULL.

    Обсуждение

    Кварц выполняет эти задачи создать подызображение:

    • Корректирует область, указанную rect параметр к интегральным границам путем вызывания функции CGRectIntegral.

    • Пересекает результат с прямоугольником, источник которого (0,0) и размер равен размеру изображения, указанного image параметр.

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

    Если W и H ширина и высота изображения, соответственно, тогда точка (0,0) соответствует первому пикселю данных изображения. Точка (W–1, 0) последний пиксель первой строки данных изображения в то время как (0, H–1) первый пиксель последней строки данных изображения и (W–1, H–1) последний пиксель последней строки данных изображения.

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGImageCreateWithMask (_: _:) CGImageCreateWithMask

    Создает растровое изображение из существующего изображения и маски изображения.

    Объявление

    Swift

    func CGImageCreateWithMask(_ image: CGImage!, _ mask: CGImage!) -> CGImage!

    Objective C

    CGImageRef CGImageCreateWithMask ( CGImageRef image, CGImageRef mask );

    Параметры

    image

    Изображение для применения mask параметр к. Это изображение не должно быть маской изображения и может не иметь маски изображения или маскирующий цвет, связанный с ним.

    mask

    Маска. Если маска является изображением, это должно быть в цветовом пространстве DeviceGray, не должно иметь альфа-компонента и не может самостоятельно быть замаскировано маской изображения или цветом маскирования. Если маска не является тем же размером как изображение, указанное image параметр, затем Кварц масштабирует маску для адаптации изображению.

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

    Изображение создается путем маскирования image с mask. Вы ответственны за выпуск этого объекта путем вызова CGImageRelease.

    Обсуждение

    Получающееся изображение зависит от ли mask параметр является маской изображения или изображением. Если mask параметр является маской изображения, тогда исходные выборки действия маски изображения как обратное альфа-значение. Т.е. если значение исходной выборки в маске изображения является S, то соответствующая область в image смешивается с местом назначения, использующим альфа-значение (1-S). Например, если S равняется 1, то область не красится, в то время как, если S 0, полностью красится область.

    Если mask параметр является изображением, тогда он служит альфа-маской для смешивания изображения на место назначения. Исходные выборки mask'действуйте как альфа-значение. Если значение исходной выборки в маске является S, то соответствующая область в изображении смешивается с местом назначения с альфой S. Например, если S 0, то область не красится, в то время как, если S равняется 1, полностью красится область.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGImageCreateWithMaskingColors (_: _:) CGImageCreateWithMaskingColors

    Создает растровое изображение путем маскирования существующего растрового изображения с предоставленными значениями цвета.

    Объявление

    Swift

    func CGImageCreateWithMaskingColors(_ image: CGImage!, _ components: UnsafePointer<CGFloat>) -> CGImage!

    Objective C

    CGImageRef CGImageCreateWithMaskingColors ( CGImageRef image, const CGFloat components[] );

    Параметры

    image

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

    components

    Массив компонентов цвета, указывающих цвет или диапазон цветов для маскирования изображения с. Массив должен содержать значения на 2 Н {минута [1], макс. [1]... минута [N], макс. [N]}, где N является числом компонентов в цвете пространство image. Каждое значение в components должно быть допустимое демонстрационное значение изображения. Если image имеет целочисленные пиксельные компоненты, тогда каждое значение должно быть в диапазоне [0.. 2 **bitsPerComponent - 1] (где bitsPerComponent число битов/компонента image). Если image имеет пиксельные компоненты с плавающей точкой, тогда каждое значение может быть любым числом с плавающей точкой, которое является допустимым компонентом цвета.

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

    Изображение создается путем маскирования image с цветами, указанными в components массив. Вы ответственны за выпуск этого объекта путем вызова CGImageRelease.

    Обсуждение

    Любая выборка изображения со значением цвета {c[1]... c [N]}, где минута [я] <= c [я] <= макс. [я] для 1 <= я <= N кашируюсь (т.е. не нарисованный). Это означает, что что-либо под непокрашенными выборками, такими как текущий цвет заливки, показывает через.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

Создание маски изображения
  • CGImageMaskCreate (_: _: _: _: _: _: _: _:) CGImageMaskCreate

    Создает маску растрового изображения из данных, снабженных провайдером данных.

    Объявление

    Swift

    func CGImageMaskCreate(_ width: UInt, _ height: UInt, _ bitsPerComponent: UInt, _ bitsPerPixel: UInt, _ bytesPerRow: UInt, _ provider: CGDataProvider!, _ decode: UnsafePointer<CGFloat>, _ shouldInterpolate: Bool) -> CGImage!

    Objective C

    CGImageRef CGImageMaskCreate ( size_t width, size_t height, size_t bitsPerComponent, size_t bitsPerPixel, size_t bytesPerRow, CGDataProviderRef provider, const CGFloat decode[], bool shouldInterpolate );

    Параметры

    width

    Ширина, в пикселях, требуемой маски изображения.

    height

    Высота, в пикселях, требуемой маски изображения.

    bitsPerComponent

    Число значительных битов маскирования в исходном пикселе. Например, если исходное изображение является 8-разрядной маской, Вы указываете 8 битов за компонент. Маски изображения должны быть 1, 2, 4, или 8 битов за компонент.

    bitsPerPixel

    Общее количество битов в исходном пикселе.

    bytesPerRow

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

    provider

    Источник данных для маски изображения.

    decode

    Обычно массив декодирования является ненужным, и необходимо передать NULL.

    shouldInterpolate

    Булево значение, указывающее, должна ли произойти интерполяция. Установка интерполяции указывает, должен ли Кварц применить граничный алгоритм сглаживания для маски изображения.

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

    Кварцевая маска растрового изображения. Вы ответственны за выпуск этого объекта путем вызова CGImageRelease.

    Обсуждение

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

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

    Маски изображения должны быть 1, 2, 4, или 8 битов за компонент. Для 1-разрядной маски, демонстрационного значения 1 указывает каширующиеся разделы маски; эти разделы блокируют текущий цвет заливки. Демонстрационное значение 0 указывает не каширующиеся разделы маски; когда маска красится, эти разделы показывают текущий цвет заливки состояния графики. Можно думать о демонстрационных значениях как об обратной альфе. Т.е. значение 1 прозрачно и 0 непрозрачно.

    Для масок изображения, которые равняются 2, 4, или 8 битов за компонент, каждый компонент отображается на диапазоне от 0 до 1 путем масштабирования использующий эту формулу:

    1/(2^bits per component – 1)

    Например, 4-разрядная маска имеет значения, колеблющиеся от 0 до 15. Эти значения масштабируются 1/15 так, чтобы каждый компонент колебался от 0 до 1. Значения компонентов, повторно масштабирующиеся к 0 или 1, ведут себя тот же путь, как они ведут себя для 1-разрядных масок изображения. Значения, масштабирующиеся к между 0 и 1 действием как обратная альфа. Т.е. цвет заливки красится, как будто он имеет альфа-значение (1 – MaskSampleValue). Например, если демонстрационное значение 8-разрядной маски масштабируется к 0.8, текущий цвет заливки красится, как будто он имеет альфа-значение 0.2, это (1–0.8).

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

Сохранение и выпуск изображений
  • CGImageRetain CGImageRetain

    Инкременты сохранить количество растрового изображения.

    Объявление

    Objective C

    CGImageRef CGImageRetain ( CGImageRef image );

    Параметры

    image

    Изображение для сохранения.

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

    То же изображение Вы передали в как image параметр.

    Обсуждение

    Эта функция эквивалентна CFRetain, за исключением того, что это не вызывает ошибку если image параметр NULL.

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

    Objective C

    @import CoreGraphics;

    Доступность

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

  • CGImageRelease CGImageRelease

    Декременты сохранить количество растрового изображения.

    Объявление

    Objective C

    void CGImageRelease ( CGImageRef image );

    Параметры

    image

    Изображение для выпуска.

    Обсуждение

    Эта функция эквивалентна CFRelease, за исключением того, что это не вызывает ошибку если image параметр NULL.

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

    Objective C

    @import CoreGraphics;

    Доступность

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

Получение ID CFType
  • CGImageGetTypeID () CGImageGetTypeID

    Возвращает идентификатор типа для Кварцевых растровых изображений.

    Объявление

    Swift

    func CGImageGetTypeID() -> CFTypeID

    Objective C

    CFTypeID CGImageGetTypeID ( void );

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

    Идентификатор для непрозрачного типа CGImageRef.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

Получение информации об изображении
  • CGImageGetAlphaInfo (_:) CGImageGetAlphaInfo

    Возвращает информацию об альфа-канале для растрового изображения.

    Объявление

    Swift

    func CGImageGetAlphaInfo(_ image: CGImage!) -> CGImageAlphaInfo

    Objective C

    CGImageAlphaInfo CGImageGetAlphaInfo ( CGImageRef image );

    Параметры

    image

    Изображение для исследования.

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

    A CGImageAlphaInfo постоянный, который указывает (1), содержит ли битовый массив альфа-канал, (2), где альфа-биты расположены в данных изображения, и (3), предварительно ли альфа-значение умножается. Для возможных значений посмотрите Константы. Функциональные возвраты kCGImageAlphaNone если image параметр относится к маске изображения.

    Обсуждение

    Альфа-значение - то, что определяет непрозрачность пикселя, когда это нарисовано.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGImageGetBitmapInfo (_:) CGImageGetBitmapInfo

    Возвращает растровую информацию для растрового изображения.

    Объявление

    Swift

    func CGImageGetBitmapInfo(_ image: CGImage!) -> CGBitmapInfo

    Objective C

    CGBitmapInfo CGImageGetBitmapInfo ( CGImageRef image );

    Параметры

    image

    Изображение.

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

    Растровая информация связалась с изображением.

    Обсуждение

    Эта функция возвращает константу, указывающую:

    • Тип растровых данных — плавающая точка или целое число. Вы используете константу kCGBitmapFloatComponents извлечь эту информацию.

    • Является ли альфа-канал в данных, и если так, как хранятся альфа-данные. Вы используете константу kCGBitmapAlphaInfoMask извлечь информацию об альфе. Информация об альфе указана как одна из констант, перечисленных в информации об Альфе для Изображений.

    Можно извлечь информацию об альфе

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGImageGetBitsPerComponent (_:) CGImageGetBitsPerComponent

    Возвращает число битов, выделенных для единственного компонента цвета растрового изображения.

    Объявление

    Swift

    func CGImageGetBitsPerComponent(_ image: CGImage!) -> UInt

    Objective C

    size_t CGImageGetBitsPerComponent ( CGImageRef image );

    Параметры

    image

    Изображение для исследования.

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

    Число битов, используемых в памяти для каждого компонента цвета указанного растрового изображения (или маска изображения). Возможные значения равняются 1, 2, 4, или 8. Например, для 16-разрядного RGB (A) цветовое пространство, функция возвратила бы значение 4 битов за компонент цвета.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGImageGetBitsPerPixel (_:) CGImageGetBitsPerPixel

    Возвращает число битов, выделенных для единственного пикселя в растровом изображении.

    Объявление

    Swift

    func CGImageGetBitsPerPixel(_ image: CGImage!) -> UInt

    Objective C

    size_t CGImageGetBitsPerPixel ( CGImageRef image );

    Параметры

    image

    Изображение для исследования.

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

    Число битов, используемых в памяти для каждого пикселя указанного растрового изображения (или маска изображения).

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGImageGetBytesPerRow (_:) CGImageGetBytesPerRow

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

    Объявление

    Swift

    func CGImageGetBytesPerRow(_ image: CGImage!) -> UInt

    Objective C

    size_t CGImageGetBytesPerRow ( CGImageRef image );

    Параметры

    image

    Изображение для исследования.

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

    Число байтов, используемых в памяти для каждой строки указанного растрового изображения (или маска изображения).

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGImageGetColorSpace (_:) CGImageGetColorSpace

    Возвратите цветовое пространство для растрового изображения.

    Объявление

    Swift

    func CGImageGetColorSpace(_ image: CGImage!) -> CGColorSpace!

    Objective C

    CGColorSpaceRef CGImageGetColorSpace ( CGImageRef image );

    Параметры

    image

    Изображение для исследования.

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

    Пространство исходного цвета для указанного растрового изображения, или NULL если изображение является маской изображения. Вы ответственны за то, что сохранили и освободили цветовое пространство по мере необходимости.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGImageGetDataProvider (_:) CGImageGetDataProvider

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

    Объявление

    Swift

    func CGImageGetDataProvider(_ image: CGImage!) -> CGDataProvider!

    Objective C

    CGDataProviderRef CGImageGetDataProvider ( CGImageRef image );

    Параметры

    image

    Изображение для исследования.

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

    Провайдер данных для указанного растрового изображения (или маска изображения). Вы ответственны за сохранение и выпуск провайдера данных по мере необходимости.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGImageGetDecode (_:) CGImageGetDecode

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

    Объявление

    Swift

    func CGImageGetDecode(_ image: CGImage!) -> UnsafePointer<CGFloat>

    Objective C

    const CGFloat * CGImageGetDecode ( CGImageRef image );

    Параметры

    image

    Изображение для исследования.

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

    Массив декодирования для растрового изображения (или маска изображения). Посмотрите обсуждение для описания возможных возвращаемых значений.

    Обсуждение

    Для растрового изображения или маски изображения, для каждого компонента цвета в пространстве исходного цвета, массив декодирования содержит пару значений, обозначающих верхнее и нижние пределы диапазона. Когда изображение представляется, Кварц использует линейное преобразование для отображения исходного значения компонента в относительное число в определяемом диапазоне, который является подходящим для целевого цветового пространства. Если переотображение значений цвета изображения не будет позволено, то возвращенное значение будет NULL.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGImageGetHeight (_:) CGImageGetHeight

    Возвращает высоту растрового изображения.

    Объявление

    Swift

    func CGImageGetHeight(_ image: CGImage!) -> UInt

    Objective C

    size_t CGImageGetHeight ( CGImageRef image );

    Параметры

    image

    Изображение для исследования.

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

    Высота в пикселях растрового изображения (или маска изображения).

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGImageGetShouldInterpolate (_:) CGImageGetShouldInterpolate

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

    Объявление

    Swift

    func CGImageGetShouldInterpolate(_ image: CGImage!) -> Bool

    Objective C

    bool CGImageGetShouldInterpolate ( CGImageRef image );

    Параметры

    image

    Изображение для исследования.

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

    Возвраты 1 если интерполяция включена для указанного растрового изображения (или маска изображения), иначе, возвраты 0.

    Обсуждение

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGImageGetRenderingIntent (_:) CGImageGetRenderingIntent

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

    Объявление

    Swift

    func CGImageGetRenderingIntent(_ image: CGImage!) -> CGColorRenderingIntent

    Objective C

    CGColorRenderingIntent CGImageGetRenderingIntent ( CGImageRef image );

    Параметры

    image

    Изображение для исследования.

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

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGImageGetWidth (_:) CGImageGetWidth

    Возвращает ширину растрового изображения.

    Объявление

    Swift

    func CGImageGetWidth(_ image: CGImage!) -> UInt

    Objective C

    size_t CGImageGetWidth ( CGImageRef image );

    Параметры

    image

    Изображение для исследования.

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

    Ширина, в пикселях, указанного растрового изображения (или маска изображения).

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGImageIsMask (_:) CGImageIsMask

    Возвраты, является ли растровое изображение маской изображения.

    Объявление

    Swift

    func CGImageIsMask(_ image: CGImage!) -> Bool

    Objective C

    bool CGImageIsMask ( CGImageRef image );

    Параметры

    image

    Изображение для исследования.

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

    Булево значение, указывающее, передало ли изображение в image параметр является маской изображения (true указывает, что изображение является маской изображения).

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

Типы данных

  • CGImageRef CGImageRef

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

    Объявление

    Swift

    typealias CGImageRef = CGImage

    Objective C

    typedef struct CGImage *CGImageRef;

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

Константы

  • Информация об альфе для изображений

    Возможности хранения для альфа-компонентных данных.

    Объявление

    Swift

    enum CGImageAlphaInfo : UInt32 { case None case PremultipliedLast case PremultipliedFirst case Last case First case NoneSkipLast case NoneSkipFirst case Only }

    Objective C

    enum CGImageAlphaInfo { kCGImageAlphaNone, kCGImageAlphaPremultipliedLast, kCGImageAlphaPremultipliedFirst, kCGImageAlphaLast, kCGImageAlphaFirst, kCGImageAlphaNoneSkipLast, kCGImageAlphaNoneSkipFirst, kCGImageAlphaOnly }; typedef enum CGImageAlphaInfo CGImageAlphaInfo;

    Константы

    • First

      kCGImageAlphaFirst

      Альфа-компонент сохранен в старших значащих битах каждого пикселя. Например, непредварительно умноженный ARGB.

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

    • Last

      kCGImageAlphaLast

      Альфа-компонент сохранен в младших значащих битах каждого пикселя. Например, непредварительно умноженный RGBA.

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

    • None

      kCGImageAlphaNone

      Нет никакого альфа-канала. Если общий размер пикселя больше, чем пространство, требуемое для числа компонентов цвета в цветовом пространстве, младшие значащие биты проигнорированы. Это значение эквивалентно kCGImageAlphaNoneSkipLast.

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

    • NoneSkipFirst

      kCGImageAlphaNoneSkipFirst

      Нет никакого альфа-канала. Если общий размер пикселя больше, чем пространство, требуемое для числа компонентов цвета в цветовом пространстве, старшие значащие биты проигнорированы.

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

    • Only

      kCGImageAlphaOnly

      Нет никаких цветных данных, только альфа-канала.

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

    • NoneSkipLast

      kCGImageAlphaNoneSkipLast

      Нет никакого альфа-канала. Если общий размер пикселя больше, чем пространство, требуемое для числа компонентов цвета в цветовом пространстве, младшие значащие биты проигнорированы. Это значение эквивалентно kCGImageAlphaNone.

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

    • PremultipliedFirst

      kCGImageAlphaPremultipliedFirst

      Альфа-компонент сохранен в старших значащих битах каждого пикселя, и компоненты цвета были уже умножены на это альфа-значение. Например, предварительно умноженный ARGB.

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

    • PremultipliedLast

      kCGImageAlphaPremultipliedLast

      Альфа-компонент сохранен в младших значащих битах каждого пикселя, и компоненты цвета были уже умножены на это альфа-значение. Например, предварительно умноженный RGBA.

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

    Обсуждение

    A CGImageAlphaInfo постоянный указывает (1), содержит ли битовый массив альфа-канал, (2), где альфа-биты расположены в данных изображения, и (3), предварительно ли альфа-значение умножается. Можно получить a CGImageAlphaInfo постоянный для изображения путем вызывания функции CGImageGetAlphaInfo. (Вы обеспечиваете a CGBitmapInfo постоянный к функции CGImageCreate, часть которого является a CGImageAlphaInfo постоянный.)

    Кварц выполняет альфу, смешивающуюся путем объединения компонентов цвета исходного изображения с компонентами цвета конечного изображения с помощью формулы линейной интерполяции, где «источник» является одним компонентом цвета одного пикселя новой краски, и «место назначения» является одним компонентом цвета фонового изображения.

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • Отобразите растровую информацию

    Информация компонента для растрового изображения.

    Объявление

    Swift

    struct CGBitmapInfo : RawOptionSetType { init(_ rawValue: UInt32) init(rawValue rawValue: UInt32) static var AlphaInfoMask: CGBitmapInfo { get } static var FloatComponents: CGBitmapInfo { get } static var ByteOrderMask: CGBitmapInfo { get } static var ByteOrderDefault: CGBitmapInfo { get } static var ByteOrder16Little: CGBitmapInfo { get } static var ByteOrder32Little: CGBitmapInfo { get } static var ByteOrder16Big: CGBitmapInfo { get } static var ByteOrder32Big: CGBitmapInfo { get } }

    Objective C

    enum { kCGBitmapAlphaInfoMask = 0x1F, kCGBitmapFloatComponents = (1 << 8), kCGBitmapByteOrderMask = 0x7000, kCGBitmapByteOrderDefault = (0 << 12), kCGBitmapByteOrder16Little = (1 << 12), kCGBitmapByteOrder32Little = (2 << 12), kCGBitmapByteOrder16Big = (3 << 12), kCGBitmapByteOrder32Big = (4 << 12) }; typedef uint32_t CGBitmapInfo;

    Константы

    • AlphaInfoMask

      kCGBitmapAlphaInfoMask

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

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

    • FloatComponents

      kCGBitmapFloatComponents

      Компоненты битового массива являются значениями с плавающей точкой.

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

    • ByteOrderMask

      kCGBitmapByteOrderMask

      Порядок байтов форматов пикселя.

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

    • ByteOrderDefault

      kCGBitmapByteOrderDefault

      Порядок байтов по умолчанию.

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

    • ByteOrder16Little

      kCGBitmapByteOrder16Little

      16-разрядный, формат с прямым порядком байтов.

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

    • ByteOrder32Little

      kCGBitmapByteOrder32Little

      32-разрядный, формат с прямым порядком байтов.

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

    • ByteOrder16Big

      kCGBitmapByteOrder16Big

      16-разрядный, формат с обратным порядком байтов.

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

    • ByteOrder32Big

      kCGBitmapByteOrder32Big

      32-разрядный, формат с обратным порядком байтов.

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

    Обсуждение

    Приложения, хранящие пиксельные данные в памяти с помощью формата ARGB, должны заботиться в том, как они считывают данные. Если код не записан правильно, возможно неправильно читать данные, приводящие к цветам или альфе, кажущимся неправильными. Кварцевые константы порядка байтов указывают порядок байтов форматов пикселя. Для указания порядка байтов к Кварцу используют оператора битового «ИЛИ» для объединения надлежащей константы с bitmapInfo параметр.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • Растровые форматы порядка байтов узла

    Константы битовой глубины для изображения побитово отображают в порядке байтов порядка байтов узла.

    Объявление

    Objective C

    #ifdef __BIG_ENDIAN__ #define kCGBitmapByteOrder16Host kCGBitmapByteOrder16Big #define kCGBitmapByteOrder32Host kCGBitmapByteOrder32Big #else #define kCGBitmapByteOrder16Host kCGBitmapByteOrder16Little #define kCGBitmapByteOrder32Host kCGBitmapByteOrder32Little #endif

    Константы

    • kCGBitmapByteOrder16Host

      kCGBitmapByteOrder16Host

      16-разрядный, формат порядка байтов узла.

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

    • kCGBitmapByteOrder32Host

      kCGBitmapByteOrder32Host

      32-разрядный, формат порядка байтов узла.

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