NSBitmapImageRep
NSBitmapImageRep
класс представляет изображение от растровых данных. Растровые поддерживаемые форматы данных включают GIF, JPEG, TIFF, PNG и различные перестановки необработанных растровых данных.
Альфа-умножение в обратном порядке и растровые форматы
При создании битового массива с помощью предварительно умноженного формата, если покрытие (альфа) плоскость существует, компоненты цвета битового массива предварительно умножаются с ним. В этом случае при изменении содержания битового массива Вы поэтому ответственны за предварительное умножение данных. Обратите внимание на то, что предварительное умножение обычно имеет незначительный эффект на выходное качество. Для данных изображения с плавающей точкой предварительное умножение компонентов цвета является работой без потерь, но для данных изображения фиксированной точки, умножение в обратном порядке может представить небольшие погрешности округления. В любом случае больше погрешностей округления может появиться при составлении композита многих предварительно умноженных изображений; однако, такие ошибки обычно не с готовностью видимы.
Поэтому Вы не должны использовать NSBitmapImageRep
возразите, хотите ли Вы управлять данными изображения. Для работы с данными, не предварительно умножающимися используйте Базовую Графическую платформу вместо этого. (В частности создайте изображения с помощью CGImageCreate
функция и kCGImageAlphaLast
параметр.) Также включают NSAlphaNonpremultipliedBitmapFormat
отметьте при создании битового массива.
Соответствует
-
AnyObject
-
CVarArgType
-
Сопоставимый
-
Hashable
-
NSCoding
-
NSCopying
-
NSObjectProtocol
-
NSSecureCoding
-
Печатаемый
-
NSCoding
-
NSCopying
-
NSObject
-
NSSecureCoding
Оператор импорта
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]Параметры
bitmapData
Объект данных, содержащий один или несколько растровые изображения или
nil
если класс неспособен создать представление изображения.bitmapData
параметр может содержать данные в любом поддерживаемом растровом формате.Возвращаемое значение
Массив
NSBitmapImageRep
экземпляры или пустой массив, если класс неспособен создать какие-либо представления изображения.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
colorizeByMappingGray (_: toColor:blackMapping:whiteMapping:) - colorizeByMappingGray:toColor:blackMapping:whiteMapping:
Colorizes полутоновое изображение.
Объявление
Параметры
midPoint
Значение плавающее, представляющее среднюю точку полутонового изображения.
midPointColor
Цветовой объект, представляющий среднюю точку цвета для отображения изображение на.
shadowColor
Цветовой объект, представляющий черное отображение для использования для теней.
lightColor
Цветовой объект, представляющий белое отображение, которое будет использоваться в изображении.
Обсуждение
Этот метод отображает получатель, таким образом что:
Уровень яркости
midPoint
–>midPointColor
;черный –>
shadowColor
;белый –>
lightColor
.
Это работает над изображениями с 8-разрядным SPP, и таким образом поддерживает или 8-разрядный серый или 24-разрядный цвет (с дополнительной альфой).
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
init(bitmapDataPlanes:pixelsWide:pixelsHigh:bitsPerSample:samplesPerPixel:hasAlpha:isPlanar:colorSpaceName:bitmapFormat:bytesPerRow:bitsPerPixel:) - initWithBitmapDataPlanes:pixelsWide:pixelsHigh:bitsPerSample:samplesPerPixel:hasAlpha:isPlanar:colorSpaceName:bitmapFormat:bytesPerRow:bitsPerPixel:
Инициализирует получатель, недавно выделенный
NSBitmapImageRep
объект, таким образом, это может представить указанное изображение.Объявление
Swift
init?(bitmapDataPlanes
planes
: UnsafeMutablePointer<UnsafeMutablePointer<UInt8>>, pixelsWidewidth
: Int, pixelsHighheight
: Int, bitsPerSamplebps
: Int, samplesPerPixelspp
: Int, hasAlphaalpha
: Bool, isPlanarisPlanar
: Bool, colorSpaceNamecolorSpaceName
: String, bitmapFormatbitmapFormat
: NSBitmapFormat, bytesPerRowrowBytes
: Int, bitsPerPixelpixelBits
: 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
NO
false
), только первый буфер читается.Если
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
YES
true
если один из компонентов рассчитал в числе выборок на пиксель (spp
) покрытие (альфа) компонент, иNO
false
если нет никакого компонента покрытия. ЕслиYES
true
, компоненты цвета в растровых данных должны быть предварительно умножены с их компонентом покрытия.isPlanar
YES
true
если компоненты данных размечаются в серии отдельных «плоскостей» или каналов (“планарная конфигурация”) иNO
false
если значения компонентов вплетены в единственном канале (“поймал в сети конфигурацию”). ЕслиNO
false
, только первый буфер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 отображает с 4bps
,pixelBits
может быть 16; поскольку RGB отображает с 8bps
,pixelBits
может быть 32. Юридические значения дляpixelBits
системно-зависимы.Если Вы указываете 0 для этого параметра, объект интерпретирует число бит на пиксель с помощью значений в
bps
иspp
параметры, как описано в предыдущем абзаце, без любых бессмысленных битов.Возвращаемое значение
Инициализированный
NSBitmapImageRep
объект илиnil
если не может быть инициализирован объект.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
-
init(bitmapDataPlanes:pixelsWide:pixelsHigh:bitsPerSample:samplesPerPixel:hasAlpha:isPlanar:colorSpaceName:bytesPerRow:bitsPerPixel:) - initWithBitmapDataPlanes:pixelsWide:pixelsHigh:bitsPerSample:samplesPerPixel:hasAlpha:isPlanar:colorSpaceName:bytesPerRow:bitsPerPixel:
Инициализирует получатель, недавно выделенный
NSBitmapImageRep
объект, таким образом, это может представить указанное изображение.Объявление
Swift
init?(bitmapDataPlanes
planes
: UnsafeMutablePointer<UnsafeMutablePointer<UInt8>>, pixelsWidewidth
: Int, pixelsHighheight
: Int, bitsPerSamplebps
: Int, samplesPerPixelspp
: Int, hasAlphaalpha
: Bool, isPlanarisPlanar
: Bool, colorSpaceNamecolorSpaceName
: String, bytesPerRowrowBytes
: Int, bitsPerPixelpixelBits
: 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
NO
false
), только первый буфер читается.Если
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
YES
true
если один из компонентов рассчитал в числе выборок на пиксель (spp
) покрытие (альфа) компонент, иNO
false
если нет никакого компонента покрытия. ЕслиYES
true
, компоненты цвета в растровых данных должны быть предварительно умножены с их компонентом покрытия.isPlanar
YES
true
если компоненты данных размечаются в серии отдельных «плоскостей» или каналов (“планарная конфигурация”) иNO
false
если значения компонентов вплетены в единственном канале (“поймал в сети конфигурацию”). ЕслиNO
false
, только первый буфер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 отображает с 4bps
,pixelBits
может быть 16; поскольку RGB отображает с 8bps
,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 и позже.
См. также
-
Возвраты
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 и позже.
См. также
-
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
СвойствоМинимальное число байтов, требуемых указать строку развертки в каждой плоскости данных. (только для чтения)
Обсуждение
Строка развертки является единственной строкой пикселей, охватывающих ширину изображения. Если явно не установлено к другому значению (в
initWithBitmapDataPlanes:pixelsWide:pixelsHigh:bitsPerSample:samplesPerPixel:hasAlpha:isPlanar:colorSpaceName:bytesPerRow:bitsPerPixel:
), это число будет изображено от ширины изображения, числа битов на выборку, и, если данные будут в решетчатой конфигурации, числе выборок на пиксель. Это может быть установлено в другое значение указать, что каждая строка данных выровненная на слове или других границах.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Булево значение, указывающее, являются ли данные изображения в планарной конфигурации. (только для чтения)
Объявление
Swift
var planar: Bool { get }
Objective C
@property(getter=isPlanar, readonly) BOOL planar
Обсуждение
Значение этого свойства
YES
true
если данные находятся в планарной конфигурации илиNO
false
если это находится в решетчатой конфигурации. В планарной конфигурации данные изображения являются отдельными в отдельную плоскость для каждого цвета и компонента покрытия. В решетчатой конфигурации данные интегрируются в единственную плоскость.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.10 и позже.
См. также
-
numberOfPlanes numberOfPlanes
СвойствоЧисло разделяет плоскости, в которые организованы данные изображения. (только для чтения)
Объявление
Swift
var numberOfPlanes: Int { get }
Objective C
@property(readonly) NSInteger numberOfPlanes
Обсуждение
Если данные имеют отдельную плоскость для каждого компонента — т.е.
planar
YES
true
— значение этого свойства является числом выборок на пиксель. Если данные пойманы в сети, значение этого свойства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 и позже.
См. также
планарный
– initWithBitmapDataPlanes:pixelsWide:pixelsHigh:bitsPerSample:samplesPerPixel:hasAlpha:isPlanar:colorSpaceName:bitmapFormat:bytesPerRow:bitsPerPixel:
– initWithBitmapDataPlanes:pixelsWide:pixelsHigh:bitsPerSample:samplesPerPixel:hasAlpha:isPlanar:colorSpaceName:bytesPerRow:bitsPerPixel:
-
Возвращает представление TIFF данных изображений
Объявление
Swift
class func TIFFRepresentationOfImageRepsInArray(_
array
: [AnyObject]) -> NSData?Параметры
array
Массив, содержащий объекты, представляющие представления растрового изображения.
Возвращаемое значение
Объект данных, содержащий представление изображения TIFF.
Обсуждение
Этот метод использует сжатие, возвращенное
getCompression:factor:
(если применимо). Если с проблемой встречаются во время генерации TIFF, этот метод повышаетNSTIFFException
илиNSBadBitmapParametersException
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
TIFFRepresentationOfImageRepsInArray (_: usingCompression:factor:) + TIFFRepresentationOfImageRepsInArray:usingCompression:factor:
Возвращает представление TIFF данных изображений с помощью указанной схемы сжатия и фактора.
Объявление
Swift
class func TIFFRepresentationOfImageRepsInArray(_
array
: [AnyObject], usingCompressioncompression
: NSTIFFCompression, factorfactor
: 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 и позже.
-
TIFFRepresentation TIFFRepresentation
СвойствоПредставление 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, factorfactor
: 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 и позже.
-
representationOfImageRepsInArray (_: usingType:properties:) + representationOfImageRepsInArray:usingType:properties:
Форматирует указанные растровые изображения с помощью указанного типа хранения и свойств и возвращает их в объекте данных.
Объявление
Swift
class func representationOfImageRepsInArray(_
imageReps
: [AnyObject], usingTypestorageType
: NSBitmapImageFileType, propertiesproperties
: [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, propertiesproperties
: [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>>, countnumTypes
: 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) -> BoolObjective C
- (BOOL)canBeCompressedUsing:(NSTIFFCompression)
compression
Параметры
compression
Тип сжатия TIFF. Для получения дополнительной информации посмотрите константы в NSTIFFCompression.
Возвращаемое значение
YES
true
если соответствуют данные получателяcompression
с этим типом,NO
false
если не соответствуют данныеcompression
или еслиcompression
не поддерживается..Обсуждение
Юридические значения для
compression
может быть найден вNSBitmapImageRep.h
и описаны в Сжатии TIFF в NSBitmapImageReps. Этот метод возвратыYES
true
если соответствуют данные получателяcompression
; например, еслиcompression
NSTIFFCompressionCCITTFAX3
, тогда данные должны составить 1 бит за выборку и 1 выборка на пиксель.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает тип сжатия получателя и фактор сжатия.
Объявление
Swift
func setCompression(_
compression
: NSTIFFCompression, factorfactor
: 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 и позже.
См. также
-
Возвраты косвенно тип сжатия получателя и фактор сжатия.
Объявление
Swift
func getCompression(_
compression
: UnsafeMutablePointer<NSTIFFCompression>, factorfactor
: 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, withValuevalue
: 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 и позже.
-
Загружает данные текущего изображения в инкрементно загруженное представление изображения и возвращает текущий статус изображения.
Объявление
Параметры
data
Объект данных, содержащий изображение, которое будет загружено.
complete
YES
true
если изображение полностью загружается,NO
false
иначе.Возвращаемое значение
Целочисленное постоянное указание состояния изображения во время работы загрузки. Посмотрите обсуждение для подробных данных.
Обсуждение
После инициализации получателя с
initForIncrementalLoad
, необходимо вызвать этот метод для инкрементной загрузки изображения. Вызовите этот метод каждый раз, когда новые данные становятся доступными. Всегда передавайте весь буфер данных изображения вdata
, не только новейшие данные, потому что декомпрессору изображения, возможно, понадобятся исходные данные для отслеживания в обратном порядке. Этот метод блокирует, пока данные не распаковываются; это распакует как можно больше изображения на основе длины данных. Репутация изображения не сохраняетdata
, таким образом, необходимо гарантировать этоdata
не выпущен на время этого вызова метода. ПередачаNO
false
дляcomplete
пока все изображение не загружается, в котором времени необходимо передатьYES
true
. Необходимо также передатьYES
true
дляcomplete
если Вы только частично загрузили данные, но не можете закончить загрузку.Этот метод возвраты
NSImageRepLoadStatusUnknownType
если Вы не передавали достаточно данных для определения формата изображения; необходимо продолжать вызывать этот метод с дополнительными данными.Этот метод возвраты
NSImageRepLoadStatusReadingHeader
если это имеет достаточно данных для определения формата изображения, но нуждается в большем количестве данных для определения размера и глубины и других характеристик изображения. Необходимо продолжать вызывать этот метод с дополнительными данными.Этот метод возвраты
NSImageRepLoadStatusWillNeedAllData
если формат изображения не поддерживает инкрементную загрузку, или Набор Приложения еще не реализует инкрементную загрузку для формата изображения. Можно продолжать вызывать этот метод в этом случае, но пока Вы не передаетеYES
true
дляcomplete
, этот метод будет продолжать возвращатьсяNSImageRepLoadStatusWillNeedAllData
, и не выполнит распаковки. Как только Вы передаетеYES
true
, изображение будет распаковано, и одно из заключительных трех сообщений о состоянии будет возвращено.Если формат изображения действительно поддерживает инкрементную загрузку, то, как только достаточно данных было считано, изображение распаковывается от вершины вниз строка за один раз. В этом случае, вместо значения состояния, этот метод возвращает число пиксельных строк, распакованных, запускающийся с вершины изображения. Можно использовать эту информацию для рисования части изображения, которое допустимо. Остальная часть изображения заполнена непрозрачным белым. Обратите внимание на то, что, если изображение является прогрессивным (как в прогрессивном JPEG или 2D чересстрочном PNG), этот метод может быстро возвратить полную высоту изображения, но изображение может все еще загружаться, не используйте это возвращаемое значение в качестве индикации относительно того, сколько из изображения остается быть распакованным.
Если ошибка произошла при распаковке, этот метод возвраты
NSImageRepLoadStatusInvalidData
. Еслиcomplete
YES
true
но недостаточно данных было доступно для распаковки,NSImageRepLoadStatusUnexpectedEOF
возвращается. Если достаточно данных было предоставлено (независимо отcomplete
флаг), тогдаNSImageRepLoadStatusCompleted
возвращается. Когда любой из этих трех результатов состояния возвращается, этот метод корректировалсяNSBitmapImageRep
так, чтобыpixelsHigh
иsize
, а также растровые данные, только содержит пиксели, которые допустимы, если таковые имеются.Для отмены распаковки просто передайте в существующих данных или
nil
иYES
true
дляcomplete
. Эта распаковка остановок метода сразу, корректирует размер изображения и возвратыNSImageRepLoadStatusUnexpectedEOF
. Этот метод возвратыNSImageRepLoadStatusCompleted
если Вы вызываете его после получения каких-либо ошибочных результатов (NSImageRepLoadStatusInvalidData
илиNSImageRepLoadStatusUnexpectedEOF
) или если Вы обращаетесь к немуNSBitmapImageRep
это не было инициализировано сinitForIncrementalLoad
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.2 и позже.
См. также
-
Изменяет цвет пикселя в указанных координатах.
Объявление
Параметры
color
Цветовой объект, представляющий цвет, который будет установлен.
x
Координата оси X пикселя.
y
Координата оси y пикселя.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
См. также
-
Возвращает цвет пикселя в указанных координатах.
Объявление
Параметры
x
Координата оси X.
y
Координата оси y.
Возвращаемое значение
Цветовой объект, представляющий цвет в указанных координатах.
Обсуждение
Вызов этого метода создает новое
NSColor
объект. Издержки создания объекта означают, что этот метод подходит лучше всего для нечастой цветной выборки. Если вместо этого необходимо работать с большими количествами пикселей, получите доступ к растровым данным непосредственно с помощьюbitmapData
свойство илиgetPixel:atX:y:
метод для лучшей производительности.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
См. также
-
Устанавливает пиксель получателя в указанных координатах к указанным значениям необработанного пикселя.
Объявление
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 и позже.
См. также
-
Возвраты косвенно пиксельные данные для указанного расположения в получателе.
Объявление
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 и позже.
См. также
-
Базовое Графическое изображение, основанное на объектах на данных репутации растрового изображения. (только для чтения)
Обсуждение
Автовыпущенный
CGImageRef
непрозрачный тип в этом свойстве имеет пиксельные размерности, которые идентичны тем из объекта репутации растрового изображения. Если существующееCGImageRef
непрозрачный тип не доступен, получение доступ к этому свойству создает новое. При изменении содержания репутации растрового изображения позже получение доступ к этому свойству снова могло бы возвратить различноеCGImageRef
непрозрачный тип.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
См. также
-
bitmapImageRepByConvertingToColorSpace (_: renderingIntent:) - bitmapImageRepByConvertingToColorSpace:renderingIntent:
Преобразовывает репутацию изображения в указанное цветовое пространство
Объявление
Swift
func bitmapImageRepByConvertingToColorSpace(_
targetSpace
: NSColorSpace, renderingIntentrenderingIntent
: NSColorRenderingIntent) -> NSBitmapImageRep?Objective C
- (NSBitmapImageRep *)bitmapImageRepByConvertingToColorSpace:(NSColorSpace *)
targetSpace
renderingIntent:(NSColorRenderingIntent)renderingIntent
Параметры
targetSpace
Новое цветовое пространство
renderingIntent
Намерение рендеринга указывает, как обработать цвета, не расположенные в пространстве целевого цвета. Поддерживаемые значения
NSColorRenderingIntent
.Возвращаемое значение
NSBitmapImageRep
, илиnil
, если преобразование перестало работать. Если оригиналNSBitmapImageRep
уже использование, что цветовое пространство, это возвращается, как.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.6 и позже.
-
Изменяет тег цветового пространства получателя.
Объявление
Swift
func bitmapImageRepByRetaggingWithColorSpace(_
newSpace
: NSColorSpace) -> NSBitmapImageRep?Objective C
- (NSBitmapImageRep *)bitmapImageRepByRetaggingWithColorSpace:(NSColorSpace *)
newSpace
Параметры
newSpace
Желаемое цветовое пространство.
Возвращаемое значение
NSBitmapImageRep
, илиnil
, если преобразование перестало работать. Если оригиналNSBitmapImageRep
уже использует то цветовое пространство, оно возвращается, как.Обсуждение
Этот метод определенно перестанет работать при передаче цветового пространства, имеющего различную модель цветового пространства, чем получатель. Т.е. если Ваше исходное изображение является sRGB, можно только повторно тегировать с некоторым другим цветовым пространством RGB.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.6 и позже.
-
Цветовое пространство битового массива. (только для чтения)
Объявление
Swift
var colorSpace: NSColorSpace { get }
Objective C
@property(readonly, strong) NSColorSpace *colorSpace
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.6 и позже.
-
Константы, представляющие различные значения состояния, возвращенные
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:
сYES
true
, это состояние будет возвращено. Можно продолжать вызывать метод, но никакая распаковка не будет иметь место. Как только Вы действительно вызываете метод сYES
true
, тогда изображение будет распаковано, и одно из заключительных трех сообщений о состоянии будет возвращено.Доступный в OS X v10.2 и позже.
-
InvalidData
NSImageRepLoadStatusInvalidData
Ошибка произошла во время распаковки изображения. Изображение содержит части данных, уже успешно распакованных, если любой
Доступный в OS X v10.2 и позже.
-
UnexpectedEOF
NSImageRepLoadStatusUnexpectedEOF
incrementalLoadFromData:complete:
с вызвалиYES
true
, но недостаточно данных было доступно для распаковки. Изображение содержит части данных, уже успешно распакованных, если таковые имеются.Доступный в 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(rawValuerawValue
: 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 и позже.
-