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

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

Разработчик

Ссылка платформы AppKit ссылка класса NSBitmapImageRep

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

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

NSBitmapImageRep

NSBitmapImageRep класс представляет изображение от растровых данных. Растровые поддерживаемые форматы данных включают GIF, JPEG, TIFF, PNG и различные перестановки необработанных растровых данных.

Альфа-умножение в обратном порядке и растровые форматы

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

Поэтому Вы не должны использовать NSBitmapImageRep возразите, хотите ли Вы управлять данными изображения. Для работы с данными, не предварительно умножающимися используйте Базовую Графическую платформу вместо этого. (В частности создайте изображения с помощью CGImageCreate функция и kCGImageAlphaLast параметр.) Также включают NSAlphaNonpremultipliedBitmapFormat отметьте при создании битового массива.

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


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


Swift

import AppKit

Objective C

@import AppKit;

Доступность


Доступный в OS X v10.0 и позже.
  • Создает и возвращается NSBitmapImageRep объект инициализируется с первым изображением в данных, которыми снабжают.

    Объявление

    Swift

    convenience init!(data bitmapData: NSData!)

    Objective C

    + (instancetype)imageRepWithData:(NSData *)bitmapData

    Параметры

    bitmapData

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

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

    NSBitmapImageRep экземпляр или nil если класс неспособен создать представление изображения.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Создает и возвращает массив инициализированных NSBitmapImageRep объекты, соответствующие изображениям в данных, которыми снабжают.

    Объявление

    Swift

    class func imageRepsWithData(_ bitmapData: NSData) -> [AnyObject]

    Objective C

    + (NSArray *)imageRepsWithData:(NSData *)bitmapData

    Параметры

    bitmapData

    Объект данных, содержащий один или несколько растровые изображения или nil если класс неспособен создать представление изображения. bitmapData параметр может содержать данные в любом поддерживаемом растровом формате.

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Colorizes полутоновое изображение.

    Объявление

    Swift

    func colorizeByMappingGray(_ midPoint: CGFloat, toColor midPointColor: NSColor?, blackMapping shadowColor: NSColor?, whiteMapping lightColor: NSColor?)

    Objective C

    - (void)colorizeByMappingGray:(CGFloat)midPoint toColor:(NSColor *)midPointColor blackMapping:(NSColor *)shadowColor whiteMapping:(NSColor *)lightColor

    Параметры

    midPoint

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

    midPointColor

    Цветовой объект, представляющий среднюю точку цвета для отображения изображение на.

    shadowColor

    Цветовой объект, представляющий черное отображение для использования для теней.

    lightColor

    Цветовой объект, представляющий белое отображение, которое будет использоваться в изображении.

    Обсуждение

    Этот метод отображает получатель, таким образом что:

    • Уровень яркости midPoint –> midPointColor;

    • черный –> shadowColor;

    • белый –> lightColor.

    Это работает над изображениями с 8-разрядным SPP, и таким образом поддерживает или 8-разрядный серый или 24-разрядный цвет (с дополнительной альфой).

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Инициализирует получатель, недавно выделенный NSBitmapImageRep объект, таким образом, это может представить указанное изображение.

    Объявление

    Swift

    init?(bitmapDataPlanes planes: UnsafeMutablePointer<UnsafeMutablePointer<UInt8>>, pixelsWide width: Int, pixelsHigh height: Int, bitsPerSample bps: Int, samplesPerPixel spp: Int, hasAlpha alpha: Bool, isPlanar isPlanar: Bool, colorSpaceName colorSpaceName: String, bitmapFormat bitmapFormat: NSBitmapFormat, bytesPerRow rowBytes: Int, bitsPerPixel pixelBits: Int)

    Objective C

    - (instancetype)initWithBitmapDataPlanes:(unsigned char **)planes pixelsWide:(NSInteger)width pixelsHigh:(NSInteger)height bitsPerSample:(NSInteger)bps samplesPerPixel:(NSInteger)spp hasAlpha:(BOOL)alpha isPlanar:(BOOL)isPlanar colorSpaceName:(NSString *)colorSpaceName bitmapFormat:(NSBitmapFormat)bitmapFormat bytesPerRow:(NSInteger)rowBytes bitsPerPixel:(NSInteger)pixelBits

    Параметры

    planes

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

    Если planes NULL или массив NULL указатели, этот метод выделяет достаточно памяти для содержания изображения, описанного другими параметрами. Можно тогда получить указатели на эту память (с getPixel:atX:y: метод или bitmapData свойство), и заполняют данные изображения. В этом случае выделенная память будет принадлежать объекту и будет освобождена, когда это будет освобождено.

    Если planes не NULL и массив содержит по крайней мере один указатель данных, возвращенный объект только сошлется на данные изображения; это не скопирует его. Объект обрабатывает данные изображения в буферах как неизменные и не попытается изменить их. Когда сам объект будет освобожден, он не попытается освободить буферы.

    width

    Ширина изображения в пикселях. Это значение должно быть больше, чем 0.

    height

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

    bps

    Число битов раньше указывало один пиксель в единственном компоненте данных. Все компоненты, как предполагается, имеют те же биты на выборку. bps должно быть одно из этих значений: 1, 2, 4, 8, 12, или 16.

    spp

    Число компонентов данных или выборки на пиксель. Это значение включает оба компонента цвета и компонент покрытия (альфа), если существующий. Значимые значения колеблются от 1 до 5. Изображение с голубым цветом, пурпурным, желтым цветом, и черный (CMYK) компоненты цвета плюс компонент покрытия имело бы spp из 5; полутоновое изображение, испытывающее недостаток в компоненте покрытия, имело бы spp из 1.

    alpha

    YEStrue если один из компонентов рассчитал в числе выборок на пиксель (spp) покрытие (альфа) компонент, и NOfalse если нет никакого компонента покрытия. Если YEStrue, компоненты цвета в растровых данных должны быть предварительно умножены с их компонентом покрытия.

    isPlanar

    YEStrue если компоненты данных размечаются в серии отдельных «плоскостей» или каналов (“планарная конфигурация”) и NOfalse если значения компонентов вплетены в единственном канале (“поймал в сети конфигурацию”). Если NOfalse, только первый буфер planes читается.

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

    colorSpaceName

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

    • NSCalibratedWhiteColorSpace

    • NSCalibratedBlackColorSpace

    • NSCalibratedRGBColorSpace

    • NSDeviceWhiteColorSpace

    • NSDeviceBlackColorSpace

    • NSDeviceRGBColorSpace

    • NSDeviceCMYKColorSpace

    • NSNamedColorSpace

    • NSCustomColorSpace

    Если bps 12, Вы не можете указать монохромное цветовое пространство.

    bitmapFormat

    Целое число, указывающее упорядочивание растровых компонентов. Это - маска, создаваемая путем объединения NSBitmapFormat константы NSAlphaFirstBitmapFormat, NSAlphaNonpremultipliedBitmapFormat и NSFloatingPointSamplesBitmapFormat использование оператора битового «ИЛИ» C.

    rowBytes

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

    Обычно, rowBytes может быть изображен от ширины изображения, числа бит на пиксель в каждой выборке (bps), и, если данные находятся в решетчатой конфигурации, числе выборок на пиксель (spp). Однако, если данные для каждой строки выровненные на слове или других границах, возможно, было необходимо выделить больше памяти для каждой строки, чем существуют данные для заполнения его. rowBytes сообщает объекту, имеет ли это место.

    Если Вы передаете в a rowBytes значение 0, растровые выделенные данные может быть дополнено для падения на длинное слово или большие границы для производительности. Если Ваш код хочет усовершенствовать строку строкой, использовать bytesPerRow и не предполагайте, что упаковываются данные. Передача в ненулевом значении позволяет Вам указывать точные усовершенствования строки.

    pixelBits

    Это целочисленное значение сообщает NSBitmapImageRep сколько битов фактически выделяется на пиксель в каждой плоскости данных. Если данные находятся в планарной конфигурации, это обычно равняется bps (биты на выборку). Если данные находятся в решетчатой конфигурации, они обычно равняются bps времена spp (выборки на пиксель). Однако для пиксельной спецификации возможно сопровождаться некоторыми бессмысленными битами (вакуум), как это может произойти, например, если пиксельные данные выровненные на границах байта. NSBitmapImageRep поддержки только ограниченное количество pixelBits значения (кроме значения по умолчанию): поскольку RGB отображает с 4 bps, pixelBits может быть 16; поскольку RGB отображает с 8 bps, pixelBits может быть 32. Юридические значения для pixelBits системно-зависимы.

    Если Вы указываете 0 для этого параметра, объект интерпретирует число бит на пиксель с помощью значений в bps и spp параметры, как описано в предыдущем абзаце, без любых бессмысленных битов.

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

    Инициализированный NSBitmapImageRep объект или nil если не может быть инициализирован объект.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Инициализирует получатель, недавно выделенный NSBitmapImageRep объект, таким образом, это может представить указанное изображение.

    Объявление

    Swift

    init?(bitmapDataPlanes planes: UnsafeMutablePointer<UnsafeMutablePointer<UInt8>>, pixelsWide width: Int, pixelsHigh height: Int, bitsPerSample bps: Int, samplesPerPixel spp: Int, hasAlpha alpha: Bool, isPlanar isPlanar: Bool, colorSpaceName colorSpaceName: String, bytesPerRow rowBytes: Int, bitsPerPixel pixelBits: Int)

    Objective C

    - (instancetype)initWithBitmapDataPlanes:(unsigned char **)planes pixelsWide:(NSInteger)width pixelsHigh:(NSInteger)height bitsPerSample:(NSInteger)bps samplesPerPixel:(NSInteger)spp hasAlpha:(BOOL)alpha isPlanar:(BOOL)isPlanar colorSpaceName:(NSString *)colorSpaceName bytesPerRow:(NSInteger)rowBytes bitsPerPixel:(NSInteger)pixelBits

    Параметры

    planes

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

    Если planes NULL или массив NULL указатели, этот метод выделяет достаточно памяти для содержания изображения, описанного другими параметрами. Можно тогда получить указатели на эту память (с getPixel:atX:y: метод или bitmapData свойство), и заполняют данные изображения. В этом случае выделенная память будет принадлежать объекту и будет освобождена, когда это будет освобождено.

    Если planes не NULL и массив содержит по крайней мере один указатель данных, возвращенный объект только сошлется на данные изображения; это не скопирует его. Объект обрабатывает данные изображения в буферах как неизменные и не попытается изменить их. Когда сам объект будет освобожден, он не попытается освободить буферы.

    width

    Ширина изображения в пикселях. Это значение должно быть больше, чем 0.

    height

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

    bps

    Число битов раньше указывало один пиксель в единственном компоненте данных. Все компоненты, как предполагается, имеют те же биты на выборку. bps должно быть одно из этих значений: 1, 2, 4, 8, 12, или 16.

    spp

    Число компонентов данных или выборки на пиксель. Это значение включает оба компонента цвета и компонент покрытия (альфа), если существующий. Значимые значения колеблются от 1 до 5. Изображение с голубым цветом, пурпурным, желтым цветом, и черный (CMYK) компоненты цвета плюс компонент покрытия имело бы spp из 5; полутоновое изображение, испытывающее недостаток в компоненте покрытия, имело бы spp из 1.

    alpha

    YEStrue если один из компонентов рассчитал в числе выборок на пиксель (spp) покрытие (альфа) компонент, и NOfalse если нет никакого компонента покрытия. Если YEStrue, компоненты цвета в растровых данных должны быть предварительно умножены с их компонентом покрытия.

    isPlanar

    YEStrue если компоненты данных размечаются в серии отдельных «плоскостей» или каналов (“планарная конфигурация”) и NOfalse если значения компонентов вплетены в единственном канале (“поймал в сети конфигурацию”). Если NOfalse, только первый буфер planes читается.

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

    colorSpaceName

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

    • NSCalibratedWhiteColorSpace

    • NSCalibratedBlackColorSpace

    • NSCalibratedRGBColorSpace

    • NSDeviceWhiteColorSpace

    • NSDeviceBlackColorSpace

    • NSDeviceRGBColorSpace

    • NSDeviceCMYKColorSpace

    • NSNamedColorSpace

    • NSCustomColorSpace

    Если bps 12, Вы не можете указать монохромное цветовое пространство.

    rowBytes

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

    Обычно, rowBytes может быть изображен от ширины изображения, числа бит на пиксель в каждой выборке (bps), и, если данные находятся в решетчатой конфигурации, числе выборок на пиксель (spp). Однако, если данные для каждой строки выровненные на слове или других границах, возможно, было необходимо выделить больше памяти для каждой строки, чем существуют данные для заполнения его. rowBytes сообщает объекту, имеет ли это место.

    Если Вы передаете в a rowBytes значение 0, растровые выделенные данные может быть дополнено для падения на длинное слово или большие границы для производительности. Если Ваш код хочет усовершенствовать строку строкой, использовать bytesPerRow и не предполагайте, что упаковываются данные. Передача в ненулевом значении позволяет Вам указывать точные усовершенствования строки.

    pixelBits

    Это целочисленное значение сообщает NSBitmapImageRep сколько битов фактически выделяется на пиксель в каждой плоскости данных. Если данные находятся в планарной конфигурации, это обычно равняется bps (биты на выборку). Если данные находятся в решетчатой конфигурации, они обычно равняются bps времена spp (выборки на пиксель). Однако для пиксельной спецификации возможно сопровождаться некоторыми бессмысленными битами (вакуум), как это может произойти, например, если пиксельные данные выровненные на границах байта. NSBitmapImageRep поддержки только ограниченное количество pixelBits значения (кроме значения по умолчанию): поскольку RGB отображает с 4 bps, pixelBits может быть 16; поскольку RGB отображает с 8 bps, pixelBits может быть 32. Юридические значения для pixelBits системно-зависимы.

    Если Вы указываете 0 для этого параметра, объект интерпретирует число бит на пиксель с помощью значений в bps и spp параметры, как описано в предыдущем абзаце, без любых бессмысленных битов.

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

    Инициализированный NSBitmapImageRep объект или nil если не может быть инициализирован объект.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Возвраты NSBitmapImageRep объект создается из Базового объекта Графического изображения.

    Объявление

    Swift

    init(CGImage cgImage: CGImage)

    Objective C

    - (instancetype)initWithCGImage:(CGImageRef)cgImage

    Параметры

    cgImage

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

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

    NSBitmapImageRep объект, инициализированный от содержания Базового Графического изображения или nil если NSBitmapImageRep не мог быть создан.

    Обсуждение

    При использовании этого метода необходимо обработать полученное растровое изображение NSBitmapImageRep возразите как только для чтения. Поскольку это только сохраняет значение в cgImage параметр, вместо того, чтобы распаковать данные, доступ к пиксельным данным требует создания копии тех данных в памяти. Изменения в тех данных не сохраняются назад к Базовому Графическому изображению.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    CGImage

  • Возвраты NSBitmapImageRep объект создается из Базового Объекта изображения.

    Объявление

    Swift

    init(CIImage ciImage: CIImage)

    Objective C

    - (instancetype)initWithCIImage:(CIImage *)ciImage

    Параметры

    ciImage

    Базовый Объект изображения, содержание которого должно быть скопировано в получатель. Этот прямоугольник изображения должен иметь конечный размер.

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

    NSBitmapImageRep объект, инициализированный от содержания Базового Изображения (CIImage) объект или nil если NSBitmapImageRep не мог быть создан.

    Обсуждение

    Изображение в ciImage параметр должен быть полностью представлен, прежде чем получатель может быть инициализирован. При указании объекта, рендеринг которого был задержан (и таким образом не имеет пикселей в наличии теперь), этот метод вынуждает изображение быть сразу представленным. Рендеринг изображения мог привести к потере производительности, если изображение имеет сложную цепочку рендеринга, или ускоренные аппаратные средства рендеринга не доступны. Рендеринг использует текущий графический контекст в потоке, от которого вызывают этот метод; для обеспечения непротиворечивых результатов через многократные потоки установите текущий контекст с помощью NSGraphicsContext класс прежде, чем вызвать этот метод.

    К этому времени этот метод возвраты, результант NSBitmapImageRep объекту можно было проверить его данные необработанного пикселя, может быть помещен на область монтажа и может быть закодирован к любому из стандартных форматов изображения это NSBitmapImageRep поддержки (JPEG, TIFF, и т.д.)

    Если Вы передаете в a CIImage возразите, чьи степени не конечны, этот метод повышает исключение.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – initWithBitmapImageRep: (CIImage)

  • Инициализирует недавно выделенный NSBitmapImageRep от предоставленных данных.

    Объявление

    Swift

    init?(data bitmapData: NSData)

    Objective C

    - (instancetype)initWithData:(NSData *)bitmapData

    Параметры

    bitmapData

    Объект данных, содержащий данные изображения. Содержание bitmapData может быть любой поддерживаемый растровый формат. Для данных TIFF, NSBitmapImageRep инициализируется от первого заголовка и данных изображения, найденных в bitmapData.

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

    Возвращает инициализированный NSBitmapImageRep если инициализация была успешна или nil если это было неспособно интерпретировать содержание bitmapData.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    init?(focusedViewRect rect: NSRect)

    Objective C

    - (instancetype)initWithFocusedViewRect:(NSRect)rect

    Параметры

    rect

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

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

    Возвращает инициализированный объект или nil Если по какой-либо причине не может быть инициализирован новый объект.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Инициализирует и возвращает получатель, недавно выделенный NSBitmapImageRep объект, для инкрементной загрузки.

    Объявление

    Swift

    init(forIncrementalLoad forIncrementalLoad: ())

    Objective C

    - (instancetype)initForIncrementalLoad

    Обсуждение

    Получатель возвращает себя после обнуления его размера и буфера данных. Можно тогда вызвать incrementalLoadFromData:complete: инкрементно добавить данные изображения.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • bitmapFormat bitmapFormat Свойство

    Формат представления растрового изображения. (только для чтения)

    Объявление

    Swift

    var bitmapFormat: NSBitmapFormat { get }

    Objective C

    @property(readonly) NSBitmapFormat bitmapFormat

    Обсуждение

    Возвраты 0 по умолчанию. Возвращаемое значение может указать несколько различных атрибутов, описанных в NSBitmapFormat.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    bytesPerRow

  • bitsPerPixel bitsPerPixel Свойство

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

    Объявление

    Swift

    var bitsPerPixel: Int { get }

    Objective C

    @property(readonly) NSInteger bitsPerPixel

    Обсуждение

    Если данные находятся в решетчатой конфигурации, числе битов в демонстрационные времена число выборок на пиксель, это число обычно равно числу битов на выборку или. Это может быть явно установлено в другое значение (в initWithBitmapDataPlanes:pixelsWide:pixelsHigh:bitsPerSample:samplesPerPixel:hasAlpha:isPlanar:colorSpaceName:bytesPerRow:bitsPerPixel:) в случае, если дополнительная память выделяется для каждого пикселя. Например, если пиксельные данные выровненные на границах байта, это может иметь место.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • bytesPerPlane bytesPerPlane Свойство

    Число байтов в каждой плоскости или канале данных. (только для чтения)

    Объявление

    Swift

    var bytesPerPlane: Int { get }

    Objective C

    @property(readonly) NSInteger bytesPerPlane

    Обсуждение

    Это число вычисляется от числа байтов на строку и высоту изображения.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    bytesPerRow

  • bytesPerRow bytesPerRow Свойство

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

    Объявление

    Swift

    var bytesPerRow: Int { get }

    Objective C

    @property(readonly) NSInteger bytesPerRow

    Обсуждение

    Строка развертки является единственной строкой пикселей, охватывающих ширину изображения. Если явно не установлено к другому значению (в initWithBitmapDataPlanes:pixelsWide:pixelsHigh:bitsPerSample:samplesPerPixel:hasAlpha:isPlanar:colorSpaceName:bytesPerRow:bitsPerPixel:), это число будет изображено от ширины изображения, числа битов на выборку, и, если данные будут в решетчатой конфигурации, числе выборок на пиксель. Это может быть установлено в другое значение указать, что каждая строка данных выровненная на слове или других границах.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    bytesPerPlane

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

    Объявление

    Swift

    var planar: Bool { get }

    Objective C

    @property(getter=isPlanar, readonly) BOOL planar

    Обсуждение

    Значение этого свойства YEStrue если данные находятся в планарной конфигурации или NOfalse если это находится в решетчатой конфигурации. В планарной конфигурации данные изображения являются отдельными в отдельную плоскость для каждого цвета и компонента покрытия. В решетчатой конфигурации данные интегрируются в единственную плоскость.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    samplesPerPixel

  • numberOfPlanes numberOfPlanes Свойство

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

    Объявление

    Swift

    var numberOfPlanes: Int { get }

    Objective C

    @property(readonly) NSInteger numberOfPlanes

    Обсуждение

    Если данные имеют отдельную плоскость для каждого компонента — т.е. planar YEStrue— значение этого свойства является числом выборок на пиксель. Если данные пойманы в сети, значение этого свойства 1.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    samplesPerPixel
    – hasAlpha (NSImageRep)
    – bitsPerSample (NSImageRep)

  • samplesPerPixel samplesPerPixel Свойство

    Число компонентов для каждого пикселя. (только для чтения)

    Объявление

    Swift

    var samplesPerPixel: Int { get }

    Objective C

    @property(readonly) NSInteger samplesPerPixel

    Обсуждение

    Это свойство отражает и число компонентов цвета и компонент покрытия, если существующий.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – hasAlpha (NSImageRep)
    – bitsPerSample (NSImageRep)

  • bitmapData bitmapData Свойство

    Указатель на растровые данные. (только для чтения)

    Объявление

    Swift

    var bitmapData: UnsafeMutablePointer<UInt8> { get }

    Objective C

    @property(readonly) unsigned char *bitmapData

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    func getBitmapDataPlanes(_ data: UnsafeMutablePointer<UnsafeMutablePointer<UInt8>>)

    Objective C

    - (void)getBitmapDataPlanes:(unsigned char **)data

    Параметры

    data

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

    Обсуждение

    Компоненты цвета в планарной конфигурации располагаются в ожидаемом порядке — например, красный прежде зеленый прежде синий для цвета RGB. Все цветные плоскости предшествуют плоскости покрытия. Для битовых массивов, чей bitmapFormat маска не включает NSAlphaNonpremultipliedBitmapFormat, если плоскость покрытия существует, компоненты цвета битового массива предварительно умножаются с нею. В этом случае при изменении содержания битового массива Вы ответственны за предварительное умножение данных.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    class func TIFFRepresentationOfImageRepsInArray(_ array: [AnyObject]) -> NSData?

    Objective C

    + (NSData *)TIFFRepresentationOfImageRepsInArray:(NSArray *)array

    Параметры

    array

    Массив, содержащий объекты, представляющие представления растрового изображения.

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

    Объект данных, содержащий представление изображения TIFF.

    Обсуждение

    Этот метод использует сжатие, возвращенное getCompression:factor: (если применимо). Если с проблемой встречаются во время генерации TIFF, этот метод повышает NSTIFFException или NSBadBitmapParametersException.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    TIFFRepresentation

  • Возвращает представление TIFF данных изображений с помощью указанной схемы сжатия и фактора.

    Объявление

    Swift

    class func TIFFRepresentationOfImageRepsInArray(_ array: [AnyObject], usingCompression compression: NSTIFFCompression, factor factor: Float) -> NSData?

    Objective C

    + (NSData *)TIFFRepresentationOfImageRepsInArray:(NSArray *)array usingCompression:(NSTIFFCompression)compression factor:(float)factor

    Параметры

    array

    Массив, содержащий объекты, представляющие представления растрового изображения.

    compression

    Перечислимая константа, представляющая схему сжатия данных TIFF. Юридические значения для compression может быть найден в NSBitmapImageRep.h и описаны в NSTIFFCompression.

    factor

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

    В настоящее время только сжатие JPEG использует фактор сжатия. Сжатие JPEG в файлах TIFF не поддерживается, и factor проигнорирован.

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

    Объект данных, содержащий представление изображения TIFF.

    Обсуждение

    Если указанное сжатие не применимо, никакое сжатие не используется. Если с проблемой встречаются во время генерации TIFF, метод повышает NSTIFFException или NSBadBitmapParametersException.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Представление TIFF данных растрового изображения. (только для чтения)

    Объявление

    Swift

    @NSCopying var TIFFRepresentation: NSData? { get }

    Objective C

    @property(readonly, copy) NSData *TIFFRepresentation

    Обсуждение

    Доступ к этому свойству приводит к вызову к TIFFRepresentationUsingCompression:factor: метод с помощью сохраненного типа сжатия и фактора, полученного от начальных данных изображения или измененного использования setCompression:factor: метод. Если сохраненный тип сжатия не поддерживается для записи данных TIFF (например, NSTIFFCompressionNEXT), сохраненное сжатие изменяется на NSTIFFCompressionNone прежде, чем вызвать TIFFRepresentationUsingCompression:factor: метод с помощью сжатия это возвращается getCompression:factor: (если применимо).

    Если с проблемой встречаются во время генерации TIFF, NSTIFFException или NSBadBitmapParametersException повышен.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Возвращает представление TIFF изображения с помощью указанного сжатия.

    Объявление

    Swift

    func TIFFRepresentationUsingCompression(_ compression: NSTIFFCompression, factor factor: Float) -> NSData?

    Objective C

    - (NSData *)TIFFRepresentationUsingCompression:(NSTIFFCompression)compression factor:(float)factor

    Параметры

    compression

    Перечислимая константа, представляющая схему сжатия данных TIFF. Юридические значения для compression может быть найден в NSBitmapImageRep.h и описаны в NSTIFFCompression.

    factor

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

    В настоящее время только сжатие JPEG использует фактор сжатия. Сжатие JPEG в файлах TIFF не поддерживается, и factor проигнорирован.

    Обсуждение

    Если тип сжатия не поддерживается для записи данных TIFF (например, NSTIFFCompressionNEXT), сохраненное сжатие изменяется на NSTIFFCompressionNone прежде чем представление TIFF сгенерировано.

    Если с проблемой встречаются во время генерации TIFF, TIFFRepresentationUsingCompression:factor: повышения NSTIFFException или NSBadBitmapParametersException.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Форматирует указанные растровые изображения с помощью указанного типа хранения и свойств и возвращает их в объекте данных.

    Объявление

    Swift

    class func representationOfImageRepsInArray(_ imageReps: [AnyObject], usingType storageType: NSBitmapImageFileType, properties properties: [NSObject : AnyObject]) -> NSData?

    Objective C

    + (NSData *)representationOfImageRepsInArray:(NSArray *)imageReps usingType:(NSBitmapImageFileType)storageType properties:(NSDictionary *)properties

    Параметры

    imageReps

    Массив NSBitmapImageRep объекты.

    storageType

    enum постоянное указание типа файла для растровых изображений. Это может быть NSBMPFileType, NSGIFFileType, NSJPEGFileType, NSPNGFileType, или NSTIFFFileType.

    properties

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

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

    Объект данных, содержащий данные растрового изображения в указанном формате. Можно записать эти данные в файл или использовать их для создания нового NSBitmapImageRep объект.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    func representationUsingType(_ storageType: NSBitmapImageFileType, properties properties: [NSObject : AnyObject]) -> NSData?

    Objective C

    - (NSData *)representationUsingType:(NSBitmapImageFileType)storageType properties:(NSDictionary *)properties

    Параметры

    storageType

    enum постоянное указание типа файла для растровых изображений. Это может быть NSBMPFileType, NSGIFFileType, NSJPEGFileType, NSPNGFileType, или NSTIFFFileType.

    properties

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

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

    Объект данных, содержащий данные изображения получателя в указанном формате. Можно записать эти данные в файл или использовать их для создания нового NSBitmapImageRep объект.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    class func getTIFFCompressionTypes(_ list: UnsafeMutablePointer<UnsafePointer<NSTIFFCompression>>, count numTypes: UnsafeMutablePointer<Int>)

    Objective C

    + (void)getTIFFCompressionTypes:(const NSTIFFCompression **)list count:(NSInteger *)numTypes

    Параметры

    list

    По возврату, массиву C NSTIFFCompression константы. Этот массив принадлежит NSBitmapImageRep класс; это не должно быть освобождено или изменено. См. NSTIFFCompression для поддерживаемых типов сжатия TIFF.

    numTypes

    Число констант в списке.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    class func localizedNameForTIFFCompressionType(_ compression: NSTIFFCompression) -> String?

    Objective C

    + (NSString *)localizedNameForTIFFCompressionType:(NSTIFFCompression)compression

    Параметры

    compression

    Тип сжатия TIFF. Для получения дополнительной информации посмотрите константы в NSTIFFCompression.

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

    Локализованное имя для compression или nil если compression является нераспознанным.

    Обсуждение

    При реализации пользовательского интерфейса для выбора типов сжатия TIFF использовать getTIFFCompressionTypes:count: для получения списка поддерживаемых типов сжатия затем используйте этот метод для получения локализованных имен для каждого типа сжатия.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Тесты, может ли получатель быть сжат указанной схемой сжатия.

    Объявление

    Swift

    func canBeCompressedUsing(_ compression: NSTIFFCompression) -> Bool

    Objective C

    - (BOOL)canBeCompressedUsing:(NSTIFFCompression)compression

    Параметры

    compression

    Тип сжатия TIFF. Для получения дополнительной информации посмотрите константы в NSTIFFCompression.

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

    YEStrue если соответствуют данные получателя compression с этим типом, NOfalse если не соответствуют данные compression или если compression не поддерживается..

    Обсуждение

    Юридические значения для compression может быть найден в NSBitmapImageRep.h и описаны в Сжатии TIFF в NSBitmapImageReps. Этот метод возвраты YEStrue если соответствуют данные получателя compression; например, если compression NSTIFFCompressionCCITTFAX3, тогда данные должны составить 1 бит за выборку и 1 выборка на пиксель.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Устанавливает тип сжатия получателя и фактор сжатия.

    Объявление

    Swift

    func setCompression(_ compression: NSTIFFCompression, factor factor: Float)

    Objective C

    - (void)setCompression:(NSTIFFCompression)compression factor:(float)factor

    Параметры

    compression

    enum постоянный, который идентифицирует один из поддерживаемых типов сжатия, как описано в NSTIFFCompression.

    factor

    Значение с плавающей точкой, которое является определенным для типа сжатия. Много типов сжатия не поддерживают различные степени сжатия и таким образом игнорируют factor. Сжатие JPEG позволяет фактор сжатия в пределах от 0,0 к 1,0, с 0,0 являющийся самым низким и 1.0 являющийся самым высоким.

    Обсуждение

    Когда NSBitmapImageRep создается, экземпляр хранит тип сжатия и фактор для исходных данных. TIFFRepresentation свойство и TIFFRepresentationOfImageRepsInArray: попытка метода класса использовать сохраненный тип сжатия и фактор. Используйте этот метод для изменения типа сжатия и фактора.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – canBeCompressedUsing:

  • Возвраты косвенно тип сжатия получателя и фактор сжатия.

    Объявление

    Swift

    func getCompression(_ compression: UnsafeMutablePointer<NSTIFFCompression>, factor factor: UnsafeMutablePointer<Float>)

    Objective C

    - (void)getCompression:(NSTIFFCompression *)compression factor:(float *)factor

    Параметры

    compression

    По возврату, enum постоянный, который представляет тип сжатия, используемый на данных; это соответствует одному из значений, возвращенных методом класса getTIFFCompressionTypes:count:.

    factor

    Значение плавающее, которое является определенным для типа сжатия. Много типов сжатия не поддерживают различные степени сжатия и таким образом игнорируют factor. Сжатие JPEG позволяет фактор сжатия в пределах от 0,0 к 1,0, с 0,0 являющийся самым низким и 1.0 являющийся самым высоким.

    Обсуждение

    Используйте этот метод для получения информации о типе сжатия для данных исходного изображения.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Устанавливает изображение property к value.

    Объявление

    Swift

    func setProperty(_ property: String, withValue value: AnyObject?)

    Objective C

    - (void)setProperty:(NSString *)property withValue:(id)value

    Параметры

    property

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

    value

    Значение, определенное для property. Если value nil, значение свойства очищено.

    Обсуждение

    Свойства могут влиять, как образ читается в и сохраняется к файлу.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Возвращает значение для указанного свойства.

    Объявление

    Swift

    func valueForProperty(_ property: String) -> AnyObject?

    Objective C

    - (id)valueForProperty:(NSString *)property

    Параметры

    property

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

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

    Значение, определенное для property, или nil если свойство не установлено для битового массива.

    Обсуждение

    Свойства изображения могут влиять, как образ читается в и сохраняется к файлу. При получении свойств растрового изображения, определенных в свойствах Растрового изображения, убедиться проверить возвращаемое значение этого метода для a nil значение. Если определенное значение не установлено для изображения, этот метод может возвратиться nil.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    func incrementalLoadFromData(_ data: NSData, complete complete: Bool) -> Int

    Objective C

    - (NSInteger)incrementalLoadFromData:(NSData *)data complete:(BOOL)complete

    Параметры

    data

    Объект данных, содержащий изображение, которое будет загружено.

    complete

    YEStrue если изображение полностью загружается, NOfalse иначе.

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

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

    Обсуждение

    После инициализации получателя с initForIncrementalLoad, необходимо вызвать этот метод для инкрементной загрузки изображения. Вызовите этот метод каждый раз, когда новые данные становятся доступными. Всегда передавайте весь буфер данных изображения в data, не только новейшие данные, потому что декомпрессору изображения, возможно, понадобятся исходные данные для отслеживания в обратном порядке. Этот метод блокирует, пока данные не распаковываются; это распакует как можно больше изображения на основе длины данных. Репутация изображения не сохраняет data, таким образом, необходимо гарантировать это data не выпущен на время этого вызова метода. Передача NOfalse для complete пока все изображение не загружается, в котором времени необходимо передать YEStrue. Необходимо также передать YEStrue для complete если Вы только частично загрузили данные, но не можете закончить загрузку.

    Этот метод возвраты NSImageRepLoadStatusUnknownType если Вы не передавали достаточно данных для определения формата изображения; необходимо продолжать вызывать этот метод с дополнительными данными.

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

    Этот метод возвраты NSImageRepLoadStatusWillNeedAllData если формат изображения не поддерживает инкрементную загрузку, или Набор Приложения еще не реализует инкрементную загрузку для формата изображения. Можно продолжать вызывать этот метод в этом случае, но пока Вы не передаете YEStrue для complete, этот метод будет продолжать возвращаться NSImageRepLoadStatusWillNeedAllData, и не выполнит распаковки. Как только Вы передаете YEStrue, изображение будет распаковано, и одно из заключительных трех сообщений о состоянии будет возвращено.

    Если формат изображения действительно поддерживает инкрементную загрузку, то, как только достаточно данных было считано, изображение распаковывается от вершины вниз строка за один раз. В этом случае, вместо значения состояния, этот метод возвращает число пиксельных строк, распакованных, запускающийся с вершины изображения. Можно использовать эту информацию для рисования части изображения, которое допустимо. Остальная часть изображения заполнена непрозрачным белым. Обратите внимание на то, что, если изображение является прогрессивным (как в прогрессивном JPEG или 2D чересстрочном PNG), этот метод может быстро возвратить полную высоту изображения, но изображение может все еще загружаться, не используйте это возвращаемое значение в качестве индикации относительно того, сколько из изображения остается быть распакованным.

    Если ошибка произошла при распаковке, этот метод возвраты NSImageRepLoadStatusInvalidData. Если complete YEStrue но недостаточно данных было доступно для распаковки, NSImageRepLoadStatusUnexpectedEOF возвращается. Если достаточно данных было предоставлено (независимо от complete флаг), тогда NSImageRepLoadStatusCompleted возвращается. Когда любой из этих трех результатов состояния возвращается, этот метод корректировался NSBitmapImageRep так, чтобы pixelsHigh и size, а также растровые данные, только содержит пиксели, которые допустимы, если таковые имеются.

    Для отмены распаковки просто передайте в существующих данных или nil и YEStrue для complete. Эта распаковка остановок метода сразу, корректирует размер изображения и возвраты NSImageRepLoadStatusUnexpectedEOF. Этот метод возвраты NSImageRepLoadStatusCompleted если Вы вызываете его после получения каких-либо ошибочных результатов (NSImageRepLoadStatusInvalidData или NSImageRepLoadStatusUnexpectedEOF) или если Вы обращаетесь к нему NSBitmapImageRep это не было инициализировано с initForIncrementalLoad.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – initForIncrementalLoad

  • Изменяет цвет пикселя в указанных координатах.

    Объявление

    Swift

    func setColor(_ color: NSColor, atX x: Int, y y: Int)

    Objective C

    - (void)setColor:(NSColor *)color atX:(NSInteger)x y:(NSInteger)y

    Параметры

    color

    Цветовой объект, представляющий цвет, который будет установлен.

    x

    Координата оси X пикселя.

    y

    Координата оси y пикселя.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – colorAtX:y:

  • Возвращает цвет пикселя в указанных координатах.

    Объявление

    Swift

    func colorAtX(_ x: Int, y y: Int) -> NSColor?

    Objective C

    - (NSColor *)colorAtX:(NSInteger)x y:(NSInteger)y

    Параметры

    x

    Координата оси X.

    y

    Координата оси y.

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

    Цветовой объект, представляющий цвет в указанных координатах.

    Обсуждение

    Вызов этого метода создает новое NSColor объект. Издержки создания объекта означают, что этот метод подходит лучше всего для нечастой цветной выборки. Если вместо этого необходимо работать с большими количествами пикселей, получите доступ к растровым данным непосредственно с помощью bitmapData свойство или getPixel:atX:y: метод для лучшей производительности.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setColor:atX:y:

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

    Объявление

    Swift

    func setPixel(_ pixelData: UnsafeMutablePointer<Int>, atX x: Int, y y: Int)

    Objective C

    - (void)setPixel:(NSUInteger [])pixelData atX:(NSInteger)x y:(NSInteger)y

    Параметры

    pixelData

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

    x

    Координата оси X пикселя.

    y

    Координата оси y пикселя.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    func getPixel(_ pixelData: UnsafeMutablePointer<Int>, atX x: Int, y y: Int)

    Objective C

    - (void)getPixel:(NSUInteger [])pixelData atX:(NSInteger)x y:(NSInteger)y

    Параметры

    pixelData

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

    x

    Координата оси X пикселя.

    y

    Координата оси y пикселя.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • CGImage CGImage Свойство

    Базовое Графическое изображение, основанное на объектах на данных репутации растрового изображения. (только для чтения)

    Объявление

    Swift

    var CGImage: CGImage? { get }

    Objective C

    @property(readonly) CGImageRef CGImage

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – initWithCGImage:

  • Константы, представляющие различные значения состояния, возвращенные incrementalLoadFromData:complete:.

    Объявление

    Swift

    enum NSImageRepLoadStatus : Int { case UnknownType case ReadingHeader case WillNeedAllData case InvalidData case UnexpectedEOF case Completed }

    Objective C

    typedef enum NSImageRepLoadStatus : NSInteger { NSImageRepLoadStatusUnknownType = -1, NSImageRepLoadStatusReadingHeader = -2, NSImageRepLoadStatusWillNeedAllData = -3, NSImageRepLoadStatusInvalidData = -4, NSImageRepLoadStatusUnexpectedEOF = -5, NSImageRepLoadStatusCompleted = -6 } NSImageRepLoadStatus;

    Константы

    • UnknownType

      NSImageRepLoadStatusUnknownType

      Недостаточно данных для определения формата изображения. Необходимо продолжать предоставлять больше данных.

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

    • ReadingHeader

      NSImageRepLoadStatusReadingHeader

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

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

    • WillNeedAllData

      NSImageRepLoadStatusWillNeedAllData

      Инкрементная загрузка не может поддерживаться. Пока Вы не вызываете incrementalLoadFromData:complete: с YEStrue, это состояние будет возвращено. Можно продолжать вызывать метод, но никакая распаковка не будет иметь место. Как только Вы действительно вызываете метод с YEStrue, тогда изображение будет распаковано, и одно из заключительных трех сообщений о состоянии будет возвращено.

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

    • InvalidData

      NSImageRepLoadStatusInvalidData

      Ошибка произошла во время распаковки изображения. Изображение содержит части данных, уже успешно распакованных, если любой

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

    • UnexpectedEOF

      NSImageRepLoadStatusUnexpectedEOF

      incrementalLoadFromData:complete: с вызвали YEStrue, но недостаточно данных было доступно для распаковки. Изображение содержит части данных, уже успешно распакованных, если таковые имеются.

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

    • Completed

      NSImageRepLoadStatusCompleted

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Свойства идентификации констант, использующиеся representationOfImageRepsInArray:usingType:properties:, representationUsingType:properties:, setPixel:atX:y:, и valueForProperty:.

    Объявление

    Swift

    var NSImageColorSyncProfileData: NSString! var NSImageCompressionFactor: NSString! var NSImageCompressionMethod: NSString! var NSImageDitherTransparency: NSString! var NSImageInterlaced: NSString! var NSImageRGBColorTable: NSString! var NSImageEXIFData: NSString! var NSImageFallbackBackgroundColor: NSString! var NSImageFrameCount: NSString! var NSImageGamma: NSString! var NSImageCurrentFrame: NSString! var NSImageCurrentFrameDuration: NSString! var NSImageProgressive: NSString! var NSImageLoopCount: NSString!

    Objective C

    NSString *NSImageCompressionMethod; NSString *NSImageCompressionFactor; NSString *NSImageDitherTransparency; NSString *NSImageRGBColorTable; NSString *NSImageInterlaced; NSString *NSImageColorSyncProfileData; NSString *NSImageFrameCount; NSString *NSImageCurrentFrame; NSString *NSImageCurrentFrameDuration; NSString *NSImageLoopCount; NSString *NSImageGamma; NSString *NSImageProgressive; NSString *NSImageEXIFData; NSString *NSImageFallbackBackgroundColor;

    Константы

    • NSImageColorSyncProfileData

      NSImageColorSyncProfileData

      Идентифицирует NSData объект, содержащий ColorSync, профилирует данные.

      Это может использоваться для TIFF, JPEG, GIF и файлов PNG. Это значение устанавливается при чтении в и используется при выписывании данных изображения. Можно получить данные профиля для определенного цветового пространства от соответствия NSColorSpace возразите или от менеджера ColorSync.

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

    • NSImageCompressionFactor

      NSImageCompressionFactor

      Идентифицирует NSNumber объект, содержащий фактор сжатия изображения.

      Используемый только для файлов JPEG. Сжатие JPEG в файлах TIFF не поддерживается, и фактор проигнорирован. Значение является плаванием между 0,0 и 1.0 с 1,0 получающимися ни в каком сжатии и 0,0 получающимися в максимальном возможном сжатии. Это устанавливается при чтении в и используется при выписывании изображения.

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

    • NSImageCompressionMethod

      NSImageCompressionMethod

      Идентифицирует NSNumber объект, идентифицирующий метод сжатия изображения.

      Используемый только для файлов TIFF. Значение соответствует одному из NSTIFFCompression константы, описанные ниже. Это устанавливается при чтении в и используется при выписывании.

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

    • NSImageDitherTransparency

      NSImageDitherTransparency

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

      Используемый только при записи файлов GIF.

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

    • NSImageInterlaced

      NSImageInterlaced

      Идентифицирует NSNumber объект, содержащий булево значение, указывающее, чередуется ли изображение.

      Используемый только при выписывании файлов PNG.

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

    • NSImageRGBColorTable

      NSImageRGBColorTable

      Идентифицирует NSData объект, содержащий таблицу цветов RGB.

      Используемый только для файлов GIF. Это сохранено как упакованный RGB. Это устанавливается при чтении в и используется при выписывании.

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

    • NSImageEXIFData

      NSImageEXIFData

      Идентифицирует NSDictionary объект, содержащий данные EXIF для изображения.

      Это свойство используется только при чтении или записи файлов JPEG. Словарь содержит ключи EXIF и значения. Стандартные ключи словаря (т.е. те, которые не являются определенными для поставщиков камеры) идентичны тем для kCGImagePropertyExifDictionary объявленный в CGImageSource API. Посмотрите kCGImagePropertyExifDictionary Ключи для подробных данных.

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

    • NSImageFallbackBackgroundColor

      NSImageFallbackBackgroundColor

      Указывает цвет фона для использования при записи в формат изображения (такой как JPEG), который не поддерживает альфу. Альфа-значение цвета проигнорировано. Цвет фона по умолчанию, когда это свойство не указано, является белым. Значение свойства должно быть NSColor объект. Эта константа соответствует kCGImageDestinationBackgroundColor постоянный в Кварце.

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

    • NSImageFrameCount

      NSImageFrameCount

      Идентифицирует NSNumber объект, содержащий число кадров в анимированном файле GIF.

      Это значение используется при чтении в данных.

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

    • NSImageGamma

      NSImageGamma

      Идентифицирует NSNumber объект, содержащий гамму, оценивает за изображение.

      Используемый только для файлов PNG. Гамма значения являются числом с плавающей точкой между 0,0 и 1.0, с 0,0 являющийся черным и 1.0 являющийся максимальным цветом. Это устанавливается при чтении в и используется при выписывании.

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

    • NSImageCurrentFrame

      NSImageCurrentFrame

      Идентифицирует NSNumber объект, содержащий текущий кадр для анимированного файла GIF.

      Первый кадр 0.

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

    • NSImageCurrentFrameDuration

      NSImageCurrentFrameDuration

      Идентифицирует NSNumber объект, содержащий продолжительность (в секундах) текущего кадра для анимированного изображения GIF.

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

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

    • NSImageProgressive

      NSImageProgressive

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

      Используемый только для файлов JPEG. Это устанавливается при чтении в и используется при выписывании.

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

    • NSImageLoopCount

      NSImageLoopCount

      Идентифицирует NSNumber объект, содержащий число циклов для создания при анимации изображения GIF.

      Значение 0 указывает, что анимация должна циклично выполниться неопределенно. Значения должны быть указаны как целые числа. Это используется при чтении в, но не при выписывании изображения.

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

    Обсуждение

    При использовании valueForProperty: метод, чтобы получить значение для любого из этих ключей, убедиться проверить, что возвращенное значение не -nil прежде чем Вы попытаетесь использовать его. Представление растрового изображения может возвратиться nil для любых еще не установленных значений.

  • Константы для указания типов растрового файла.

    Объявление

    Swift

    enum NSBitmapImageFileType : UInt { case NSTIFFFileType case NSBMPFileType case NSGIFFileType case NSJPEGFileType case NSPNGFileType case NSJPEG2000FileType }

    Objective C

    typedef enum NSBitmapImageFileType : NSUInteger { NSTIFFFileType, NSBMPFileType, NSGIFFileType, NSJPEGFileType, NSPNGFileType, NSJPEG2000FileType } NSBitmapImageFileType;

    Константы

    • NSTIFFFileType

      NSTIFFFileType

      Тегированный формат файлов изображений (TIFF)

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

    • NSBMPFileType

      NSBMPFileType

      Растровое изображение Windows (BMP) формат

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

    • NSGIFFileType

      NSGIFFileType

      Graphics Image Format (GIF), первоначально создаваемый CompuServe для онлайновых загрузок

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

    • NSJPEGFileType

      NSJPEGFileType

      Формат JPEG

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

    • NSPNGFileType

      NSPNGFileType

      Формат Переносимой сетевой графики (PNG)

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

    • NSJPEG2000FileType

      NSJPEG2000FileType

      Формат файла JPEG 2000 года.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Константы, представляющие поддерживаемые схемы сжатия данных TIFF.

    Объявление

    Swift

    enum NSTIFFCompression : UInt { case None case CCITTFAX3 case CCITTFAX4 case LZW case JPEG case NEXT case PackBits case OldJPEG }

    Objective C

    typedef enum NSTIFFCompression : NSUInteger { NSTIFFCompressionNone = 1, NSTIFFCompressionCCITTFAX3 = 3, NSTIFFCompressionCCITTFAX4 = 4, NSTIFFCompressionLZW = 5, NSTIFFCompressionJPEG = 6, NSTIFFCompressionNEXT = 32766, NSTIFFCompressionPackBits = 32773, NSTIFFCompressionOldJPEG = 32865 } NSTIFFCompression;

    Константы

    • None

      NSTIFFCompressionNone

      Никакое сжатие.

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

    • CCITTFAX3

      NSTIFFCompressionCCITTFAX3

      Группа факсов CCITT 3 сжатия.

      Используемый для 1-разрядных изображений факса отправил по телефонным линиям.

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

    • CCITTFAX4

      NSTIFFCompressionCCITTFAX4

      Группа факсов CCITT 4 сжатия.

      Используемый для 1-разрядных изображений факса отправил по линиям ISDN.

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

    • LZW

      NSTIFFCompressionLZW

      Сжатие LZW.

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

    • JPEG

      NSTIFFCompressionJPEG

      Сжатие JPEG. Больше поддерживаемый для ввода или вывода.

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

    • NEXT

      NSTIFFCompressionNEXT

      NeXT сжался. Поддерживаемый для ввода только.

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

    • PackBits

      NSTIFFCompressionPackBits

      Сжатие PackBits.

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

    • OldJPEG

      NSTIFFCompressionOldJPEG

      Старое сжатие JPEG. Больше поддерживаемый для ввода или вывода.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Константы, представляющие различные растровые форматы компонента.

    Объявление

    Swift

    struct NSBitmapFormat : RawOptionSetType { init(_ rawValue: UInt) init(rawValue rawValue: UInt) static var NSAlphaFirstBitmapFormat: NSBitmapFormat { get } static var NSAlphaNonpremultipliedBitmapFormat: NSBitmapFormat { get } static var NSFloatingPointSamplesBitmapFormat: NSBitmapFormat { get } static var NS16BitLittleEndianBitmapFormat: NSBitmapFormat { get } static var NS32BitLittleEndianBitmapFormat: NSBitmapFormat { get } static var NS16BitBigEndianBitmapFormat: NSBitmapFormat { get } static var NS32BitBigEndianBitmapFormat: NSBitmapFormat { get } }

    Objective C

    typedef enum NSBitmapFormat : NSUInteger { NSAlphaFirstBitmapFormat = 1 << 0, NSAlphaNonpremultipliedBitmapFormat = 1 << 1, NSFloatingPointSamplesBitmapFormat = 1 << 2 NS16BitLittleEndianBitmapFormat = (1 << 8), NS32BitLittleEndianBitmapFormat = (1 << 9), NS16BitBigEndianBitmapFormat = (1 << 10), NS32BitBigEndianBitmapFormat = (1 << 11) } NSBitmapFormat;

    Константы

    • NSAlphaFirstBitmapFormat

      NSAlphaFirstBitmapFormat

      Формат, где альфа-значение на первом месте. (Если эта опция не указана, альфа-значения являются последним указанным компонентом, как в CMYKA и RGBA.)

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

    • NSAlphaNonpremultipliedBitmapFormat

      NSAlphaNonpremultipliedBitmapFormat

      Формат, где альфа-значения не предварительно умножаются. (Если эта опция не указана, альфа-значения предварительно умножаются.)

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

    • NSFloatingPointSamplesBitmapFormat

      NSFloatingPointSamplesBitmapFormat

      Формат, где выборки указаны с помощью чисел с плавающей точкой. (Если эта опция не указана, выборки являются целочисленными значениями.)

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

    • NS16BitLittleEndianBitmapFormat

      NS16BitLittleEndianBitmapFormat

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

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

    • NS32BitLittleEndianBitmapFormat

      NS32BitLittleEndianBitmapFormat

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

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

    • NS16BitBigEndianBitmapFormat

      NS16BitBigEndianBitmapFormat

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

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

    • NS32BitBigEndianBitmapFormat

      NS32BitBigEndianBitmapFormat

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

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

    Обсуждение

    Можно объединить эти значения с помощью оператора битового «ИЛИ» C и передать их initWithBitmapDataPlanes:pixelsWide:pixelsHigh:bitsPerSample:samplesPerPixel:hasAlpha:isPlanar:colorSpaceName:bitmapFormat:bytesPerRow:bitsPerPixel: метод как растровый формат. Можно получить доступ к ним позже в bitmapFormat свойство.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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