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!(databitmapData: 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?(bitmapDataPlanesplanes: 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 **)planespixelsWide:(NSInteger)widthpixelsHigh:(NSInteger)heightbitsPerSample:(NSInteger)bpssamplesPerPixel:(NSInteger)spphasAlpha:(BOOL)alphaisPlanar:(BOOL)isPlanarcolorSpaceName:(NSString *)colorSpaceNamebitmapFormat:(NSBitmapFormat)bitmapFormatbytesPerRow:(NSInteger)rowBytesbitsPerPixel:(NSInteger)pixelBitsПараметры
planesМассив символьных указателей, каждый из которых указывает на буферное, содержащее необработанные данные изображения. Если данные находятся в планарной конфигурации, каждый буфер содержит один компонент — одну плоскость — данных. Цветные плоскости располагаются в стандартном порядке — например, красный прежде зеленый прежде синий для цвета RGB. Все цветные плоскости предшествуют плоскости покрытия. Если плоскость покрытия существует, компоненты цвета битового массива должны быть предварительно умножены с нею. Если данные находятся в решетчатой конфигурации (т.е.
isPlanarNOfalse), только первый буфер читается.Если
planesNULLили массив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.alphaYEStrueесли один из компонентов рассчитал в числе выборок на пиксель (spp) покрытие (альфа) компонент, иNOfalseесли нет никакого компонента покрытия. ЕслиYEStrue, компоненты цвета в растровых данных должны быть предварительно умножены с их компонентом покрытия.isPlanarYEStrueесли компоненты данных размечаются в серии отдельных «плоскостей» или каналов (“планарная конфигурация”) иNOfalseесли значения компонентов вплетены в единственном канале (“поймал в сети конфигурацию”). ЕслиNOfalse, только первый буферplanesчитается.Например, в решетчатой конфигурации, красный, зеленый, синий цвет, и значения покрытия для первого пикселя изображения предшествовали бы красному, зеленому, синему цвету, и значения покрытия для второго пикселя, и т.д. В планарной конфигурации красные значения для всех пикселей в изображении предшествовали бы всем зеленым значениям, которые будут предшествовать всем синим значениям, которые предшествовали бы всем значениям покрытия.
colorSpaceNameСтроковая константа, указывающая, как должны быть интерпретированы значения данных. Это должно быть одно из следующих значений:
NSCalibratedWhiteColorSpaceNSCalibratedBlackColorSpaceNSCalibratedRGBColorSpaceNSDeviceWhiteColorSpaceNSDeviceBlackColorSpaceNSDeviceRGBColorSpaceNSDeviceCMYKColorSpaceNSNamedColorSpaceNSCustomColorSpace
Если
bps12, Вы не можете указать монохромное цветовое пространство.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?(bitmapDataPlanesplanes: 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 **)planespixelsWide:(NSInteger)widthpixelsHigh:(NSInteger)heightbitsPerSample:(NSInteger)bpssamplesPerPixel:(NSInteger)spphasAlpha:(BOOL)alphaisPlanar:(BOOL)isPlanarcolorSpaceName:(NSString *)colorSpaceNamebytesPerRow:(NSInteger)rowBytesbitsPerPixel:(NSInteger)pixelBitsПараметры
planesМассив символьных указателей, каждый из которых указывает на буферное, содержащее необработанные данные изображения. Если данные находятся в планарной конфигурации, каждый буфер содержит один компонент — одну плоскость — данных. Цветные плоскости располагаются в стандартном порядке — например, красный прежде зеленый прежде синий для цвета RGB. Все цветные плоскости предшествуют плоскости покрытия. Если плоскость покрытия существует, компоненты цвета битового массива должны быть предварительно умножены с нею. Если данные находятся в решетчатой конфигурации (т.е.
isPlanarNOfalse), только первый буфер читается.Если
planesNULLили массив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.alphaYEStrueесли один из компонентов рассчитал в числе выборок на пиксель (spp) покрытие (альфа) компонент, иNOfalseесли нет никакого компонента покрытия. ЕслиYEStrue, компоненты цвета в растровых данных должны быть предварительно умножены с их компонентом покрытия.isPlanarYEStrueесли компоненты данных размечаются в серии отдельных «плоскостей» или каналов (“планарная конфигурация”) иNOfalseесли значения компонентов вплетены в единственном канале (“поймал в сети конфигурацию”). ЕслиNOfalse, только первый буферplanesчитается.Например, в решетчатой конфигурации, красный, зеленый, синий цвет, и значения покрытия для первого пикселя изображения предшествовали бы красному, зеленому, синему цвету, и значения покрытия для второго пикселя, и т.д. В планарной конфигурации красные значения для всех пикселей в изображении предшествовали бы всем зеленым значениям, которые будут предшествовать всем синим значениям, которые предшествовали бы всем значениям покрытия.
colorSpaceNameСтроковая константа, указывающая, как должны быть интерпретированы значения данных. Это должно быть одно из следующих значений:
NSCalibratedWhiteColorSpaceNSCalibratedBlackColorSpaceNSCalibratedRGBColorSpaceNSDeviceWhiteColorSpaceNSDeviceBlackColorSpaceNSDeviceRGBColorSpaceNSDeviceCMYKColorSpaceNSNamedColorSpaceNSCustomColorSpace
Если
bps12, Вы не можете указать монохромное цветовое пространство.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(CGImagecgImage: 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(CIImageciImage: 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?(databitmapData: 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?(focusedViewRectrect: NSRect)Objective C
- (instancetype)initWithFocusedViewRect:(NSRect)rectПараметры
rectПрямоугольник, указывающий область текущего окна в текущей системе координат.
Возвращаемое значение
Возвращает инициализированный объект или
nilЕсли по какой-либо причине не может быть инициализирован новый объект.Обсуждение
Этот метод использование операторы обработки изображений для чтения данных изображения в буфер; объект тогда создается из тех данных. Объект инициализируется с информацией об изображении, полученном из сервера окна.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.0 и позже.
-
Инициализирует и возвращает получатель, недавно выделенный
NSBitmapImageRepобъект, для инкрементной загрузки.Объявление
Swift
init(forIncrementalLoadforIncrementalLoad: ())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Обсуждение
Значение этого свойства
YEStrueесли данные находятся в планарной конфигурации илиNOfalseесли это находится в решетчатой конфигурации. В планарной конфигурации данные изображения являются отдельными в отдельную плоскость для каждого цвета и компонента покрытия. В решетчатой конфигурации данные интегрируются в единственную плоскость.Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.10 и позже.
См. также
-
numberOfPlanes numberOfPlanesСвойствоЧисло разделяет плоскости, в которые организованы данные изображения. (только для чтения)
Объявление
Swift
var numberOfPlanes: Int { get }Objective C
@property(readonly) NSInteger numberOfPlanesОбсуждение
Если данные имеют отдельную плоскость для каждого компонента — т.е.
planarYEStrue— значение этого свойства является числом выборок на пиксель. Если данные пойманы в сети, значение этого свойства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 *)arrayusingCompression:(NSTIFFCompression)compressionfactor:(float)factorПараметры
arrayМассив, содержащий объекты, представляющие представления растрового изображения.
compressionПеречислимая константа, представляющая схему сжатия данных TIFF. Юридические значения для
compressionможет быть найден вNSBitmapImageRep.hи описаны в NSTIFFCompression.factorA
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)compressionfactor:(float)factorПараметры
compressionПеречислимая константа, представляющая схему сжатия данных TIFF. Юридические значения для
compressionможет быть найден вNSBitmapImageRep.hи описаны в NSTIFFCompression.factorA
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 *)imageRepsusingType:(NSBitmapImageFileType)storageTypeproperties:(NSDictionary *)propertiesПараметры
imageRepsМассив
NSBitmapImageRepобъекты.storageTypeenumпостоянное указание типа файла для растровых изображений. Это может быть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)storageTypeproperties:(NSDictionary *)propertiesПараметры
storageTypeenumпостоянное указание типа файла для растровых изображений. Это может быть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 **)listcount:(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.
Возвращаемое значение
YEStrueесли соответствуют данные получателяcompressionс этим типом,NOfalseесли не соответствуют данныеcompressionили еслиcompressionне поддерживается..Обсуждение
Юридические значения для
compressionможет быть найден вNSBitmapImageRep.hи описаны в Сжатии TIFF в NSBitmapImageReps. Этот метод возвратыYEStrueесли соответствуют данные получателяcompression; например, еслиcompressionNSTIFFCompressionCCITTFAX3, тогда данные должны составить 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)compressionfactor:(float)factorПараметры
compressionenumпостоянный, который идентифицирует один из поддерживаемых типов сжатия, как описано в 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 *)compressionfactor:(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 *)propertywithValue:(id)valueПараметры
propertyСтроковая константа, используемая в качестве ключа для свойства изображения. Эти свойства описаны в свойствах Растрового изображения.
valueЗначение, определенное для
property. Еслиvaluenil, значение свойства очищено.Обсуждение
Свойства могут влиять, как образ читается в и сохраняется к файлу.
Оператор импорта
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Объект данных, содержащий изображение, которое будет загружено.
completeYEStrueесли изображение полностью загружается,NOfalseиначе.Возвращаемое значение
Целочисленное постоянное указание состояния изображения во время работы загрузки. Посмотрите обсуждение для подробных данных.
Обсуждение
После инициализации получателя с
initForIncrementalLoad, необходимо вызвать этот метод для инкрементной загрузки изображения. Вызовите этот метод каждый раз, когда новые данные становятся доступными. Всегда передавайте весь буфер данных изображения вdata, не только новейшие данные, потому что декомпрессору изображения, возможно, понадобятся исходные данные для отслеживания в обратном порядке. Этот метод блокирует, пока данные не распаковываются; это распакует как можно больше изображения на основе длины данных. Репутация изображения не сохраняетdata, таким образом, необходимо гарантировать этоdataне выпущен на время этого вызова метода. ПередачаNOfalseдляcompleteпока все изображение не загружается, в котором времени необходимо передатьYEStrue. Необходимо также передатьYEStrueдляcompleteесли Вы только частично загрузили данные, но не можете закончить загрузку.Этот метод возвраты
NSImageRepLoadStatusUnknownTypeесли Вы не передавали достаточно данных для определения формата изображения; необходимо продолжать вызывать этот метод с дополнительными данными.Этот метод возвраты
NSImageRepLoadStatusReadingHeaderесли это имеет достаточно данных для определения формата изображения, но нуждается в большем количестве данных для определения размера и глубины и других характеристик изображения. Необходимо продолжать вызывать этот метод с дополнительными данными.Этот метод возвраты
NSImageRepLoadStatusWillNeedAllDataесли формат изображения не поддерживает инкрементную загрузку, или Набор Приложения еще не реализует инкрементную загрузку для формата изображения. Можно продолжать вызывать этот метод в этом случае, но пока Вы не передаетеYEStrueдляcomplete, этот метод будет продолжать возвращатьсяNSImageRepLoadStatusWillNeedAllData, и не выполнит распаковки. Как только Вы передаетеYEStrue, изображение будет распаковано, и одно из заключительных трех сообщений о состоянии будет возвращено.Если формат изображения действительно поддерживает инкрементную загрузку, то, как только достаточно данных было считано, изображение распаковывается от вершины вниз строка за один раз. В этом случае, вместо значения состояния, этот метод возвращает число пиксельных строк, распакованных, запускающийся с вершины изображения. Можно использовать эту информацию для рисования части изображения, которое допустимо. Остальная часть изображения заполнена непрозрачным белым. Обратите внимание на то, что, если изображение является прогрессивным (как в прогрессивном JPEG или 2D чересстрочном PNG), этот метод может быстро возвратить полную высоту изображения, но изображение может все еще загружаться, не используйте это возвращаемое значение в качестве индикации относительно того, сколько из изображения остается быть распакованным.
Если ошибка произошла при распаковке, этот метод возвраты
NSImageRepLoadStatusInvalidData. ЕслиcompleteYEStrueно недостаточно данных было доступно для распаковки,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 и позже.
См. также
-
Изменяет цвет пикселя в указанных координатах.
Объявление
Параметры
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 [])pixelDataatX:(NSInteger)xy:(NSInteger)yПараметры
pixelDataМассив целых чисел, представляющих значения необработанного пикселя. Значения должны быть в порядке, надлежащем растровому формату объекта. Маленькие пиксельные демонстрационные значения должны быть переданы как целочисленное значение. Значения с плавающей точкой должны быть брошены
int[].xКоордината оси X пикселя.
yКоордината оси y пикселя.
Оператор импорта
Objective C
@import AppKit;Swift
import AppKitДоступность
Доступный в OS X v10.4 и позже.
См. также
-
Возвраты косвенно пиксельные данные для указанного расположения в получателе.
Объявление
Objective C
- (void)getPixel:(NSUInteger [])pixelDataatX:(NSInteger)xy:(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 *)targetSpacerenderingIntent:(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;Константы
-
UnknownTypeNSImageRepLoadStatusUnknownTypeНедостаточно данных для определения формата изображения. Необходимо продолжать предоставлять больше данных.
Доступный в OS X v10.2 и позже.
-
ReadingHeaderNSImageRepLoadStatusReadingHeaderФормат изображения известен, но недостаточно данных было считано для определения размера, глубины, и т.д., изображения. Необходимо продолжать предоставлять больше данных.
Доступный в OS X v10.2 и позже.
-
WillNeedAllDataNSImageRepLoadStatusWillNeedAllDataИнкрементная загрузка не может поддерживаться. Пока Вы не вызываете
incrementalLoadFromData:complete:сYEStrue, это состояние будет возвращено. Можно продолжать вызывать метод, но никакая распаковка не будет иметь место. Как только Вы действительно вызываете метод сYEStrue, тогда изображение будет распаковано, и одно из заключительных трех сообщений о состоянии будет возвращено.Доступный в OS X v10.2 и позже.
-
InvalidDataNSImageRepLoadStatusInvalidDataОшибка произошла во время распаковки изображения. Изображение содержит части данных, уже успешно распакованных, если любой
Доступный в OS X v10.2 и позже.
-
UnexpectedEOFNSImageRepLoadStatusUnexpectedEOFincrementalLoadFromData:complete:с вызвалиYEStrue, но недостаточно данных было доступно для распаковки. Изображение содержит части данных, уже успешно распакованных, если таковые имеются.Доступный в OS X v10.2 и позже.
-
CompletedNSImageRepLoadStatusCompletedДостаточно данных было предоставлено для успешной распаковки изображения (независимо от полного: флаг).
Доступный в 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;Константы
-
NSImageColorSyncProfileDataNSImageColorSyncProfileDataИдентифицирует
NSDataобъект, содержащий ColorSync, профилирует данные.Это может использоваться для TIFF, JPEG, GIF и файлов PNG. Это значение устанавливается при чтении в и используется при выписывании данных изображения. Можно получить данные профиля для определенного цветового пространства от соответствия
NSColorSpaceвозразите или от менеджера ColorSync.Доступный в OS X v10.0 и позже.
-
NSImageCompressionFactorNSImageCompressionFactorИдентифицирует
NSNumberобъект, содержащий фактор сжатия изображения.Используемый только для файлов JPEG. Сжатие JPEG в файлах TIFF не поддерживается, и фактор проигнорирован. Значение является плаванием между 0,0 и 1.0 с 1,0 получающимися ни в каком сжатии и 0,0 получающимися в максимальном возможном сжатии. Это устанавливается при чтении в и используется при выписывании изображения.
Доступный в OS X v10.0 и позже.
-
NSImageCompressionMethodNSImageCompressionMethodИдентифицирует
NSNumberобъект, идентифицирующий метод сжатия изображения.Используемый только для файлов TIFF. Значение соответствует одному из
NSTIFFCompressionконстанты, описанные ниже. Это устанавливается при чтении в и используется при выписывании.Доступный в OS X v10.0 и позже.
-
NSImageDitherTransparencyNSImageDitherTransparencyИдентифицирует
NSNumberобъект, содержащий булевскую переменную, указывающую, размывается ли изображение.Используемый только при записи файлов GIF.
Доступный в OS X v10.0 и позже.
-
NSImageInterlacedNSImageInterlacedИдентифицирует
NSNumberобъект, содержащий булево значение, указывающее, чередуется ли изображение.Используемый только при выписывании файлов PNG.
Доступный в OS X v10.0 и позже.
-
NSImageRGBColorTableNSImageRGBColorTableИдентифицирует
NSDataобъект, содержащий таблицу цветов RGB.Используемый только для файлов GIF. Это сохранено как упакованный RGB. Это устанавливается при чтении в и используется при выписывании.
Доступный в OS X v10.0 и позже.
-
NSImageEXIFDataNSImageEXIFDataИдентифицирует
NSDictionaryобъект, содержащий данные EXIF для изображения.Это свойство используется только при чтении или записи файлов JPEG. Словарь содержит ключи EXIF и значения. Стандартные ключи словаря (т.е. те, которые не являются определенными для поставщиков камеры) идентичны тем для
kCGImagePropertyExifDictionaryобъявленный вCGImageSourceAPI. ПосмотритеkCGImagePropertyExifDictionaryКлючи для подробных данных.Доступный в OS X v10.4 и позже.
-
NSImageFallbackBackgroundColorNSImageFallbackBackgroundColorУказывает цвет фона для использования при записи в формат изображения (такой как JPEG), который не поддерживает альфу. Альфа-значение цвета проигнорировано. Цвет фона по умолчанию, когда это свойство не указано, является белым. Значение свойства должно быть
NSColorобъект. Эта константа соответствуетkCGImageDestinationBackgroundColorпостоянный в Кварце.Доступный в OS X v10.5 и позже.
-
NSImageFrameCountNSImageFrameCountИдентифицирует
NSNumberобъект, содержащий число кадров в анимированном файле GIF.Это значение используется при чтении в данных.
Доступный в OS X v10.2 и позже.
-
NSImageGammaNSImageGammaИдентифицирует
NSNumberобъект, содержащий гамму, оценивает за изображение.Используемый только для файлов PNG. Гамма значения являются числом с плавающей точкой между 0,0 и 1.0, с 0,0 являющийся черным и 1.0 являющийся максимальным цветом. Это устанавливается при чтении в и используется при выписывании.
Доступный в OS X v10.4 и позже.
-
NSImageCurrentFrameNSImageCurrentFrameИдентифицирует
NSNumberобъект, содержащий текущий кадр для анимированного файла GIF.Первый кадр 0.
Доступный в OS X v10.2 и позже.
-
NSImageCurrentFrameDurationNSImageCurrentFrameDurationИдентифицирует
NSNumberобъект, содержащий продолжительность (в секундах) текущего кадра для анимированного изображения GIF.Продолжительность кадра может быть значением с плавающей точкой. Это используется при чтении в, но не при выписывании.
Доступный в OS X v10.2 и позже.
-
NSImageProgressiveNSImageProgressiveИдентифицирует
NSNumberобъект, содержащий булевскую переменную, указывающую, использует ли изображение прогрессивное кодирование.Используемый только для файлов JPEG. Это устанавливается при чтении в и используется при выписывании.
Доступный в OS X v10.4 и позже.
-
NSImageLoopCountNSImageLoopCountИдентифицирует
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;Константы
-
NSTIFFFileTypeNSTIFFFileTypeТегированный формат файлов изображений (TIFF)
Доступный в OS X v10.0 и позже.
-
NSBMPFileTypeNSBMPFileTypeРастровое изображение Windows (BMP) формат
Доступный в OS X v10.0 и позже.
-
NSGIFFileTypeNSGIFFileTypeGraphics Image Format (GIF), первоначально создаваемый CompuServe для онлайновых загрузок
Доступный в OS X v10.0 и позже.
-
NSJPEGFileTypeNSJPEGFileTypeФормат JPEG
Доступный в OS X v10.0 и позже.
-
NSPNGFileTypeNSPNGFileTypeФормат Переносимой сетевой графики (PNG)
Доступный в OS X v10.0 и позже.
-
NSJPEG2000FileTypeNSJPEG2000FileTypeФормат файла 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;Константы
-
NoneNSTIFFCompressionNoneНикакое сжатие.
Доступный в OS X v10.0 и позже.
-
CCITTFAX3NSTIFFCompressionCCITTFAX3Группа факсов CCITT 3 сжатия.
Используемый для 1-разрядных изображений факса отправил по телефонным линиям.
Доступный в OS X v10.0 и позже.
-
CCITTFAX4NSTIFFCompressionCCITTFAX4Группа факсов CCITT 4 сжатия.
Используемый для 1-разрядных изображений факса отправил по линиям ISDN.
Доступный в OS X v10.0 и позже.
-
LZWNSTIFFCompressionLZWСжатие LZW.
Доступный в OS X v10.0 и позже.
-
JPEGNSTIFFCompressionJPEGСжатие JPEG. Больше поддерживаемый для ввода или вывода.
Доступный в OS X v10.0 и позже.
-
NEXTNSTIFFCompressionNEXTNeXT сжался. Поддерживаемый для ввода только.
Доступный в OS X v10.0 и позже.
-
PackBitsNSTIFFCompressionPackBitsСжатие PackBits.
Доступный в OS X v10.0 и позже.
-
OldJPEGNSTIFFCompressionOldJPEGСтарое сжатие 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;Константы
-
NSAlphaFirstBitmapFormatNSAlphaFirstBitmapFormatФормат, где альфа-значение на первом месте. (Если эта опция не указана, альфа-значения являются последним указанным компонентом, как в CMYKA и RGBA.)
Доступный в OS X v10.4 и позже.
-
NSAlphaNonpremultipliedBitmapFormatNSAlphaNonpremultipliedBitmapFormatФормат, где альфа-значения не предварительно умножаются. (Если эта опция не указана, альфа-значения предварительно умножаются.)
Доступный в OS X v10.4 и позже.
-
NSFloatingPointSamplesBitmapFormatNSFloatingPointSamplesBitmapFormatФормат, где выборки указаны с помощью чисел с плавающей точкой. (Если эта опция не указана, выборки являются целочисленными значениями.)
Доступный в OS X v10.4 и позже.
-
NS16BitLittleEndianBitmapFormatNS16BitLittleEndianBitmapFormat16-разрядный, формат с прямым порядком байтов.
Доступный в OS X v10.10 и позже.
-
NS32BitLittleEndianBitmapFormatNS32BitLittleEndianBitmapFormat32-разрядный, формат с прямым порядком байтов.
Доступный в OS X v10.10 и позже.
-
NS16BitBigEndianBitmapFormatNS16BitBigEndianBitmapFormat16-разрядный, формат с обратным порядком байтов.
Доступный в OS X v10.10 и позже.
-
NS32BitBigEndianBitmapFormatNS32BitBigEndianBitmapFormat32-разрядный, формат с обратным порядком байтов.
Доступный в 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 и позже.
-
