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

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

Разработчик

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

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

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

NSImage

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

NSImage класс служит многим целям, оказывая поддержку для следующих задач:

  • Загрузка изображений, сохраненных на диске или в указанном URL.

  • Вовлечение изображений в представление или графический контекст.

  • Обеспечение содержания a CALayer объект.

  • Создание новых изображений на основе ряда полученных команд рисования.

  • Создание версий изображения в другом формате.

NSImage сам класс способен к управлению данными изображения во множестве форматов. Определенный список форматов зависит от версии операционной системы, но включает много стандартных форматов, таких как TIFF, JPEG, GIF, PNG и PDF среди других. Каждым форматом управляет определенный тип объекта представления изображения, задание которого должно управлять данными действительного образа. Можно получить список поддерживаемых форматов с помощью методов, описанных в Определении Поддерживаемых Типов изображения.

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

Используя изображения с объектами CALayer

Несмотря на то, что можно присвоиться NSImage возразите непосредственно против contents свойство a CALayer объект, делая так может не всегда приводить к лучшим результатам. Вместо того, чтобы использовать Ваш объект изображения, можно использовать layerContentsForContentsScale: метод для получения объекта, который можно использовать для содержания уровня. Тот метод создает изображение, подходящее для использования в качестве содержания уровня, и это - поддержки все режимы силы тяжести уровня. В отличие от этого, NSImage класс поддерживает только kCAGravityResize, kCAGravityResizeAspect, и kCAGravityResizeAspectFill режимы.

Прежде, чем вызвать layerContentsForContentsScale: метод, используйте recommendedLayerContentsScale: метод для получения рекомендуемого масштабного коэффициента для получающегося изображения. Перечисление 1 показывает типичный пример, использующий масштабный коэффициент запоминающего устройства окна как желаемый масштабный коэффициент. От того масштабного коэффициента код получает рекомендуемый масштабный коэффициент для указанного объекта изображения и создает объект, который может быть присвоен уровню. Вы могли бы использовать этот код для изображений, соответствующих границам слоев точно или для которого Вы полагаетесь contentsGravity свойство уровня, чтобы расположить или масштабировать изображение.

Перечисление 1Assigning изображение к уровню
  • static void updateLayerWithImageInWindow1(NSImage *image, CALayer *layer, NSWindow *window) {
  • CGFloat desiredScaleFactor = [window backingScaleFactor];
  • CGFloat actualScaleFactor = [image recommendedLayerContentsScale:desiredScaleFactor];
  • id layerContents = [image layerContentsForContentsScale:actualScaleFactor];
  • [layer setContents:layerContents];
  • [layer setContentsScale:actualScaleFactor];
  • }

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

Соответствует

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

Swift

import AppKit

Objective C

@import AppKit;

Доступность

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

Инициализация нового объекта NSImage
  • init (byReferencingFile:) - initByReferencingFile:

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

    Объявление

    Swift

    init?(byReferencingFile filename: String)

    Objective C

    - (instancetype)initByReferencingFile:(NSString *)filename

    Параметры

    filename

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

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

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

    Обсуждение

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

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

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

    Этот метод вызывает setDataRetained: с параметром YEStrue, таким образом позволяя ему содержать на его имя файла. При архивации изображения, создаваемого с этим методом, только, имя файла изображения записано в архив.

    Если кэшированная версия изображения использует меньше памяти, чем данные исходного изображения, исходные данные сбрасываются, и кэшируемое изображение используется. (Это может произойти для изображений, разрешение которых больше, чем 72 точки на дюйм.) При изменении размеров изображения меньше чем на 50% данные загружаются в снова из файла. Если Вы ожидаете, что файл изменится или будет удален, необходимо использовать initWithContentsOfFile: вместо этого.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • init (byReferencingURL:) - initByReferencingURL:

    Инициализирует и возвращает объект изображения с помощью указанного URL.

    Объявление

    Swift

    init(byReferencingURL url: NSURL)

    Objective C

    - (instancetype)initByReferencingURL:(NSURL *)url

    Параметры

    url

    URL, идентифицирующий изображение.

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

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

    Обсуждение

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

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

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

    Этот метод вызывает setDataRetained: с параметром YEStrue, таким образом позволяя ему содержать на его URL. При архивации изображения, создаваемого с этим методом, только, URL изображения записано в архив.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • init (CGImage:size:) - initWithCGImage:size:

    Инициализирует и возвращает объект изображения с помощью содержания Базового Графического изображения.

    Объявление

    Swift

    init(CGImage cgImage: CGImage, size size: NSSize)

    Objective C

    - (instancetype)initWithCGImage:(CGImageRef)cgImage size:(NSSize)size

    Параметры

    cgImage

    Источник CGImage.

    size

    Размер нового изображения. Если размер NSZeroSize, пиксельные размерности cgImage приняты как размер изображения.

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

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

    Обсуждение

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

    Это не определяемый инициализатор.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • init (contentsOfFile:) - initWithContentsOfFile:

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

    Объявление

    Swift

    init?(contentsOfFile filename: String)

    Objective C

    - (instancetype)initWithContentsOfFile:(NSString *)filename

    Параметры

    filename

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

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

    Инициализированный NSImage объект или nil если метод не может создать представление изображения от содержания указанного файла.

    Обсуждение

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • init (contentsOfURL:) - initWithContentsOfURL:

    Инициализирует и возвращает объект изображения с содержанием указанного URL.

    Объявление

    Swift

    init?(contentsOfURL aUrl: NSURL)

    Objective C

    - (instancetype)initWithContentsOfURL:(NSURL *)aUrl

    Параметры

    aUrl

    URL, идентифицирующий изображение.

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

    Инициализированный NSImage объект или nil если метод не может создать представление изображения от содержания указанного URL.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • init (данные:) - initWithData:

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

    Объявление

    Swift

    init?(data data: NSData)

    Objective C

    - (instancetype)initWithData:(NSData *)data

    Параметры

    data

    Объект данных, содержащий данные изображения. Данные могут быть в любом формате, который OS X поддерживает, включая PDF, PICT, EPS или любое число растровых форматов данных.

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

    Инициализированный NSImage объект или nil если метод не может создать представление изображения от содержания указанного объекта данных.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • init (dataIgnoringOrientation:) - initWithDataIgnoringOrientation:

    Инициализирует и возвращает объект изображения с помощью предоставленных данных изображения и игнорируя теги ориентации EXIF.

    Объявление

    Swift

    init?(dataIgnoringOrientation data: NSData)

    Objective C

    - (instancetype)initWithDataIgnoringOrientation:(NSData *)data

    Параметры

    data

    Объект данных, содержащий данные изображения. Данные могут быть в любом формате, который OS X поддерживает, включая PDF, PICT, EPS или любое число растровых форматов данных.

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

    Инициализированный NSImage объект или nil если метод не может создать представление изображения от содержания указанного объекта данных.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • init (область монтажа:) - initWithPasteboard:

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

    Объявление

    Swift

    init?(pasteboard pasteboard: NSPasteboard)

    Objective C

    - (instancetype)initWithPasteboard:(NSPasteboard *)pasteboard

    Параметры

    pasteboard

    Область монтажа, содержащая данные изображения. Данные по области монтажа могут быть в любом формате, который OS X поддерживает, включая PDF, PICT, EPS или любое число растровых форматов данных.

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

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

    Обсуждение

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

    Табличная 1Default область монтажа вводит для представлений изображения

    Класс представления изображения

    Тип области монтажа по умолчанию

    Расширения файла по умолчанию

    NSBitmapImageRep

    NSTIFFPboardType

    tiff, gif, jpg, и другие

    NSPDFImageRep

    NSPDFPboardType

    pdf

    NSEPSImageRep

    NSPostscriptPboardType

    eps

    NSPICTImageRep

    NSPICTPboardType

    pict

    Если указанная область монтажа содержит значение NSFilenamesPboardType, каждому имени файла на области монтажа должен поддерживать расширение один из зарегистрированных NSImageRep подклассы. Можно использовать imageUnfilteredFileTypes метод данного подкласса для получения списка поддерживаемых типов для того класса.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • init (size:flipped:drawingHandler:) + imageWithSize:flipped:drawingHandler:

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

    Объявление

    Swift

    init(size size: NSSize, flipped drawingHandlerShouldBeCalledWithFlippedContext: Bool, drawingHandler drawingHandler: (NSRect) -> Bool) -> NSImage

    Objective C

    + (NSImage *)imageWithSize:(NSSize)size flipped:(BOOL)drawingHandlerShouldBeCalledWithFlippedContext drawingHandler:(BOOL (^)(NSRect dstRect))drawingHandler

    Параметры

    size

    Размер изображения, измеренного в точках.

    drawingHandlerShouldBeCalledWithFlippedContext

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

    drawingHandler

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

    dstRect

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

    Блок возвращает булевскую переменную, указывающую, нарисовал ли он изображение успешно. Возвратиться YEStrue от Вашего блока, если это успешно нарисовало содержание или NOfalse если это не сделало.

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

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

    Обсуждение

    Используйте этот метод для генерации изображения, которое корректно в любом разрешении. Этот метод создает объект изображения с синглом NSCustomImageRep объект управлять получением. Представление изображения использует блок в drawingHandler параметр, чтобы сделать фактическое получение.

    При рисовании изображения впервые представление основного изображения выполняется drawingHandler блок. Объект изображения кэширует результаты согласно своим обычным политикам кэширования; посмотрите cacheMode свойство. Пока конфигурация целевого графического контекста не изменяется значительным способом, последующие попытки нарисовать изображение снова используют кэшируемые результаты, когда это возможно. Если плотность пикселей или цветовое пространство целевого графического контекста изменяются, тем не менее, представление изображения выбрасывает любые кэши и выполняет блок снова для получения новой версии изображения. Например, если Вы первоначально нарисовали изображение на стандартном разрешении, выводят на экран, но тогда рисуют его на дисплее Сетчатки, блок выполняется снова для получения изображения в новом разрешении.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • init (размер:) - initWithSize:

    Инициализирует и возвращает объект изображения с указанными размерностями.

    Объявление

    Swift

    init(size aSize: NSSize)

    Objective C

    - (instancetype)initWithSize:(NSSize)aSize

    Параметры

    aSize

    Размер изображения, измеренного в точках.

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

    Инициализированный NSImage объект без представленного содержания.

    Обсуждение

    Этот метод не добавляет представлений изображения объекту изображения. Допустимо инициализировать объект изображения путем передачи размера (0.0, 0.0); однако, необходимо установить размер в ненулевое значение перед использованием его, или исключение будет повышено.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    размер

  • init (iconRef:) - initWithIconRef:

    Инициализирует объект изображения с ресурсом значка Стиля углерода.

    Объявление

    Swift

    init(iconRef iconRef: Icon)

    Objective C

    - (instancetype)initWithIconRef:(IconRef)iconRef

    Параметры

    iconRef

    Ссылка на ресурс значка Carbon.

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

    Инициализированный NSImage объект.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Что касается изображений по имени
  • init (названный:) + imageNamed:

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

    Объявление

    Swift

    init?(named name: String) -> NSImage

    Objective C

    + (NSImage *)imageNamed:(NSString *)name

    Параметры

    name

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

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

    NSImage объект связался с указанным именем или nil если не было найдено никакое такое изображение.

    Обсуждение

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

    1. Ищите объект, имя которого было определено явно с помощью setName: метод и в настоящее время находится в кэше изображений.

    2. Ищите основной пакет приложения файл, имя которого соответствует указанную строку. (Для получения информации о том, как ищется пакет, см. “Доступ к Содержанию Пакета” в Руководстве по программированию Пакета.)

    3. Ищите платформу Набора Приложения добавленное изображение с указанным именем.

    При поиске файлов в комплекте приложений лучше (но не требуемое) включать расширение файла в name параметр. При именовании изображения с setName: метод, это - соглашение не включать расширения файла в имена, которые Вы указываете. Тем путем можно легко различить изображения, которые Вы назвали явно, и те Вы хотите загрузиться от пакета приложения.

    Одно особенно полезное изображение, которое можно получить, является значком приложения. Это изображение установлено Какао автоматически и доступным использованием NSImageNameApplicationIcon постоянный. Значки для других приложений могут быть получены с помощью методов, объявленных в NSWorkspace класс. Можно также получить многие стандартные образы системы с помощью определенных констант Какао; для получения дополнительной информации посмотрите Константы Шаблона изображения, Совместное использование Полномочий Под названием Изображения, Изображения Системного объекта, Панель инструментов Под названием Изображения и Шаблонные разделы Изображений Типа Представления для применимых констант.

    Если приложение соединяется в Mac OS X v10.5 или позже, отображает требуемое использование этого метода и чьи концы имени в слове «Template» автоматически отмечены как шаблонные изображения.

    NSImage класс может кэшировать ссылку на возвращенный объект изображения для производительности в некоторых случаях. Однако класс содержит на кэшируемые объекты только, в то время как существует объект. Если все сильные ссылки к изображению впоследствии удалены, объект может быть бесшумно удален из кэша. Таким образом, если Вы планируете содержать на возвращенный объект изображения, необходимо поддержать сильную ссылку к нему как Вы, был бы любой объект Какао. Можно очистить объект изображения от кэша явно путем вызова setName объекта: метод и указание nil для названия картинки.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setName:
    – имя
    iconForFile: (NSWorkspace)
    + imageFileTypes

  • setName (_:) - setName:

    Регистрирует получатель под указанным именем.

    Объявление

    Swift

    func setName(_ aString: String?) -> Bool

    Objective C

    - (BOOL)setName:(NSString *)aString

    Параметры

    aString

    Имя для соединения с получателем. Указать nil если Вы хотите удалить изображение из кэша изображений.

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

    YEStrue если получатель был успешно зарегистрирован в имени; иначе, NOfalse.

    Обсуждение

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – имя
    + imageNamed:

  • имя () - имя

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

    Объявление

    Swift

    func name() -> String?

    Objective C

    - (NSString *)name

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

    Имя связалось с получателем, или nil если не присваивается никакое имя.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setName:

Установка атрибутов изображения
  • размер размер Свойство

    Размер получателя.

    Объявление

    Swift

    var size: NSSize

    Objective C

    @property NSSize size

    Обсуждение

    Значения по умолчанию к {0.0, 0.0} если никакой размер не был установлен, и размер не может быть определен ни от одного из представлений изображения получателя. Если размер изображения не был уже установлен, когда представление изображения добавляется, размер взят от данных представления изображения. Для изображений EPS размер взят от ограничительной рамки изображения. Для изображений TIFF размер взят от ImageLength и ImageWidth атрибуты.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • isTemplate () - isTemplate

    Возвращает булево значение, указывающее, является ли изображение шаблонным изображением.

    Объявление

    Swift

    func isTemplate() -> Bool

    Objective C

    - (BOOL)isTemplate

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

    YEStrue если изображение является шаблонным изображением; иначе, NOfalse.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setTemplate:

  • setTemplate (_:) - setTemplate:

    Наборы, представляет ли изображение шаблонное изображение.

    Объявление

    Swift

    func setTemplate(_ isTemplate: Bool)

    Objective C

    - (void)setTemplate:(BOOL)isTemplate

    Параметры

    isTemplate

    Указать YEStrue если изображение является шаблонным изображением; иначе, NOfalse.

    Обсуждение

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

    Шаблонные изображения не предназначаются, чтобы использоваться в качестве автономных изображений. Они всегда смешиваются с другим содержанием и обрабатываются для создавания желаемой видимости. Можно отметить изображение как “шаблонное изображение” для уведомления клиентов, заботящихся, что изображение содержит только черное и ясное содержание. Наиболее популярный способ использования шаблонных изображений находится в ячейках изображения. Например, Вы могли бы использовать шаблонное изображение для обеспечения содержания для кнопки или сегментированного управления. Ячейки какао используют в своих интересах природу шаблонных изображений — т.е. их упрощенная цветовая схема и использование прозрачности — для улучшения появления соответствующего управления в каждом из его поддерживаемых состояний.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – isTemplate

Определение поддерживаемых типов изображения
  • canInitWithPasteboard (_:) + canInitWithPasteboard:

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

    Объявление

    Swift

    class func canInitWithPasteboard(_ pasteboard: NSPasteboard) -> Bool

    Objective C

    + (BOOL)canInitWithPasteboard:(NSPasteboard *)pasteboard

    Параметры

    pasteboard

    Область монтажа, содержащая данные изображения.

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

    YEStrue если получатель знает, как обработать данные на области монтажа; иначе, NOfalse.

    Обсуждение

    Этот метод использует NSImageRep метод класса imageUnfilteredPasteboardTypes найти класс, который может обработать данные в указанной области монтажа. Если Вы создаете свое собственное NSImageRep подклассы, переопределите imageUnfilteredPasteboardTypes метод для уведомления NSImage из области монтажа вводит Ваши поддержки класса.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    + imagePasteboardTypes

  • imageTypes () + imageTypes

    Возвращает массив строк UTI, идентифицирующих типы изображения, поддерживаемые зарегистрированным NSImageRep объекты, или непосредственно или через установленную пользователями службу фильтра.

    Объявление

    Swift

    class func imageTypes() -> [AnyObject]

    Objective C

    + (NSArray *)imageTypes

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

    Массив NSString объекты, каждый из которых содержит UTI идентификация поддерживаемого типа изображения. Некоторые демонстрационные связанные с изображением строки UTI включают»public.image”, "public.jpeg”, и»public.tiff”. Для списка поддерживаемых типов посмотрите UTCoreTypes.h.

    Обсуждение

    Возвращенный список включает UTIs все типы файлов, поддерживаемые зарегистрированными подклассами NSImageRep плюс те, которые могут быть преобразованы в поддерживаемый тип установленной пользователями службой фильтра. Можно использовать возвращенные строки UTI с любым методом, поддерживающим UTIs.

    Не переопределяйте этот метод непосредственно. Если Ваше пользовательское изображение поддержек приложений вводит, создайте и зарегистрируйтесь NSImageRep подкласс, обрабатывающий те типы.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    + imageUnfilteredTypes

  • imageUnfilteredTypes () + imageUnfilteredTypes

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

    Объявление

    Swift

    class func imageUnfilteredTypes() -> [AnyObject]

    Objective C

    + (NSArray *)imageUnfilteredTypes

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

    Массив NSString объекты, каждый из которых содержит UTI идентификация поддерживаемого типа изображения. Некоторые демонстрационные связанные с изображением строки UTI включают»public.image”, "public.jpeg”, и»public.tiff”. Для списка поддерживаемых типов посмотрите UTCoreTypes.h.

    Обсуждение

    Возвращенный список включает строки UTI только для тех типов файлов, поддерживающихся непосредственно зарегистрированными подклассами NSImageRep. Это не включает типы, поддерживающиеся через установленные пользователями службы фильтра. Можно использовать возвращенные строки UTI с любым методом, поддерживающим UTIs.

    Не переопределяйте этот метод непосредственно. Если Ваше пользовательское изображение поддержек приложений вводит, создайте и зарегистрируйтесь NSImageRep подкласс, обрабатывающий те типы.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    + imageTypes

  • imageFileTypes () + imageFileTypes (OS X v10.10)

    Возвращает массив строк, идентифицирующих типы изображения, поддерживаемые зарегистрированным NSImageRep объекты.

    Объявление

    Swift

    class func imageFileTypes() -> [AnyObject]

    Objective C

    + (NSArray *)imageFileTypes

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

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

    Обсуждение

    Этот список включает все типы файлов, поддерживаемые зарегистрированными подклассами NSImageRep плюс те, которые могут быть преобразованы в поддерживаемый тип установленной пользователями службой фильтра. Можно передать массив, возвращенный этим методом непосредственно к runModalForTypes: метод NSOpenPanel.

    Не переопределяйте этот метод. Если Ваше пользовательское изображение поддержек приложений вводит, создайте и зарегистрируйтесь NSImageRep подкласс, обрабатывающий те типы.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    Осуждаемый в OS X v10.10.

    См. также

    + imageUnfilteredFileTypes

  • imageUnfilteredFileTypes () + imageUnfilteredFileTypes (OS X v10.10)

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

    Объявление

    Swift

    class func imageUnfilteredFileTypes() -> [AnyObject]

    Objective C

    + (NSArray *)imageUnfilteredFileTypes

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

    Массив NSString объекты, каждый из которых идентифицирует единственный поддерживаемый тип файла. Типы файлов идентифицируются расширением файла и типами файлов HFS.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    Осуждаемый в OS X v10.10.

    См. также

    + imageFileTypes

  • imagePasteboardTypes () + imagePasteboardTypes (OS X v10.10)

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

    Объявление

    Swift

    class func imagePasteboardTypes() -> [AnyObject]

    Objective C

    + (NSArray *)imagePasteboardTypes

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

    Массив NSString объекты, каждый из которых идентифицирует единственный поддерживаемый тип области монтажа. По умолчанию этот список содержит NSPDFPboardType, NSPICTPboardType, NSPostScriptPboardType, и NSTIFFPboardType типы.

    Обсуждение

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

    Не переопределяйте этот метод. Вместо этого переопределите imageUnfilteredPasteboardTypes метод для уведомления NSImage из области монтажа вводит Ваши поддержки класса.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    Осуждаемый в OS X v10.10.

    См. также

    + imageUnfilteredPasteboardTypes

  • imageUnfilteredPasteboardTypes () + imageUnfilteredPasteboardTypes (OS X v10.10)

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

    Объявление

    Swift

    class func imageUnfilteredPasteboardTypes() -> [AnyObject]

    Objective C

    + (NSArray *)imageUnfilteredPasteboardTypes

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

    Массив NSString объекты, каждый из которых идентифицирует единственный поддерживаемый тип области монтажа.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    Осуждаемый в OS X v10.10.

    См. также

    + imagePasteboardTypes

Работа с представлениями изображения
  • addRepresentation (_:) - addRepresentation:

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

    Объявление

    Swift

    func addRepresentation(_ imageRep: NSImageRep)

    Objective C

    - (void)addRepresentation:(NSImageRep *)imageRep

    Параметры

    imageRep

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

    Обсуждение

    После вызова этого метода Вы, возможно, должны явно установить функции нового представления изображения, такие как размер, число цветов, и т.д. Это - истина особенно когда NSImage объект имеет представления повторного изображения для выбора из. Посмотрите NSImageRep и его подклассы для методов Вы используете для завершения инициализации.

    Любое представление, добавленное этим методом, сохраняется получателем. Представления изображения не могут быть совместно использованы среди кратного числа NSImage объекты.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    представления
    – removeRepresentation:

  • addRepresentations (_:) - addRepresentations:

    Добавляет, что массив представления изображения возражает против получателя.

    Объявление

    Swift

    func addRepresentations(_ imageReps: [AnyObject])

    Objective C

    - (void)addRepresentations:(NSArray *)imageReps

    Параметры

    imageReps

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

    Обсуждение

    После вызова этого метода Вы, возможно, должны явно установить функции новых представлений изображения, таких как их размер, число цветов, и т.д. Это - истина особенно когда NSImage объект имеет представления повторного изображения для выбора из. Посмотрите NSImageRep и его подклассы для методов Вы используете для завершения инициализации.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    представления
    – removeRepresentation:

  • представления представления Свойство

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

    Объявление

    Swift

    var representations: [AnyObject] { get }

    Objective C

    @property(readonly, copy) NSArray *representations

    Обсуждение

    Это свойство может содержать нуль или больше NSImageRep объекты.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • removeRepresentation (_:) - removeRepresentation:

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

    Объявление

    Swift

    func removeRepresentation(_ imageRep: NSImageRep)

    Objective C

    - (void)removeRepresentation:(NSImageRep *)imageRep

    Параметры

    imageRep

    Представление изображения возражает, что Вы хотите удалить.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    представления

  • bestRepresentationForRect (_: context:hints:) - bestRepresentationForRect:context:hints:

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

    Объявление

    Swift

    func bestRepresentationForRect(_ rect: NSRect, context referenceContext: NSGraphicsContext?, hints hints: [NSObject : AnyObject]?) -> NSImageRep?

    Objective C

    - (NSImageRep *)bestRepresentationForRect:(NSRect)rect context:(NSGraphicsContext *)referenceContext hints:(NSDictionary *)hints

    Параметры

    rect

    Область изображения для возврата.

    referenceContext

    Графический контекст. Это значение может быть nil.

    hints

    Дополнительный словарь подсказок, обеспечивающих больше контекста для выбора или генерации a CGImage, и может переопределить свойства referenceContext. Посмотрите Ключи Словаря Подсказки Изображения для сводки возможных пар ключ/значение.

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Установка критериев выбора представления изображения
  • prefersColorMatch prefersColorMatch Свойство

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

    Объявление

    Swift

    var prefersColorMatch: Bool

    Objective C

    @property BOOL prefersColorMatch

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • usesEPSOnResolutionMismatch usesEPSOnResolutionMismatch Свойство

    Булево значение, указывающее, предпочтены ли представления EPS, когда никакие другие представления не соответствуют разрешение устройства.

    Объявление

    Swift

    var usesEPSOnResolutionMismatch: Bool

    Objective C

    @property BOOL usesEPSOnResolutionMismatch

    Обсуждение

    YEStrue если предпочтены представления изображения EPS; иначе, NOfalse. Значение по умолчанию NOfalse.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    matchesOnMultipleResolution

  • matchesOnMultipleResolution matchesOnMultipleResolution Свойство

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

    Объявление

    Swift

    var matchesOnMultipleResolution: Bool

    Objective C

    @property BOOL matchesOnMultipleResolution

    Обсуждение

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

    Значение по умолчанию YEStrue.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Рисование изображения
  • drawInRect (_:) - drawInRect:

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

    Объявление

    Swift

    func drawInRect(_ rect: NSRect)

    Objective C

    - (void)drawInRect:(NSRect)rect

    Параметры

    rect

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

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • drawAtPoint (_: fromRect:operation:fraction:) - drawAtPoint:fromRect:operation:fraction:

    Рисует все или часть изображения в указанной точке в текущей системе координат.

    Объявление

    Swift

    func drawAtPoint(_ point: NSPoint, fromRect srcRect: NSRect, operation op: NSCompositingOperation, fraction delta: CGFloat)

    Objective C

    - (void)drawAtPoint:(NSPoint)point fromRect:(NSRect)srcRect operation:(NSCompositingOperation)op fraction:(CGFloat)delta

    Параметры

    point

    Расположение в текущей системе координат, в которой можно нарисовать изображение.

    srcRect

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

    op

    Составляющая композит работа для использования при рисовании изображения. Посмотрите NSCompositingOperation константы.

    delta

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

    Обсуждение

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

    В отличие от этого compositeToPoint:fromRect:operation: и compositeToPoint:fromRect:operation:fraction: методы, этот метод проверяет прямоугольник, который Вы передаете srcRect параметр и удостоверяется, что не лежит вне границ изображения.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – dissolveToPoint:fraction:
    – drawInRect:fromRect:operation:fraction:

  • drawInRect (_: fromRect:operation:fraction:) - drawInRect:fromRect:operation:fraction:

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

    Объявление

    Swift

    func drawInRect(_ dstRect: NSRect, fromRect srcRect: NSRect, operation op: NSCompositingOperation, fraction delta: CGFloat)

    Objective C

    - (void)drawInRect:(NSRect)dstRect fromRect:(NSRect)srcRect operation:(NSCompositingOperation)op fraction:(CGFloat)delta

    Параметры

    dstRect

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

    srcRect

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

    op

    Составляющая композит работа для использования при рисовании изображения. Посмотрите NSCompositingOperation константы.

    delta

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

    Обсуждение

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

    В отличие от этого compositeToPoint:fromRect:operation: и compositeToPoint:fromRect:operation:fraction: методы, этот метод проверяет прямоугольник, который Вы передаете srcRect параметр и удостоверяется, что не лежит вне границ изображения.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – dissolveToPoint:fraction:
    – drawAtPoint:fromRect:operation:fraction:

  • drawInRect (_: fromRect:operation:fraction:respectFlipped:hints:) - drawInRect:fromRect:operation:fraction:respectFlipped:hints:

    Рисует все или часть изображения в указанном прямоугольнике, уважая flippedness и подсказки.

    Объявление

    Swift

    func drawInRect(_ dstSpacePortionRect: NSRect, fromRect srcSpacePortionRect: NSRect, operation op: NSCompositingOperation, fraction requestedAlpha: CGFloat, respectFlipped respectContextIsFlipped: Bool, hints hints: [NSObject : AnyObject]?)

    Objective C

    - (void)drawInRect:(NSRect)dstSpacePortionRect fromRect:(NSRect)srcSpacePortionRect operation:(NSCompositingOperation)op fraction:(CGFloat)requestedAlpha respectFlipped:(BOOL)respectContextIsFlipped hints:(NSDictionary *)hints

    Параметры

    dstSpacePortionRect

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

    srcSpacePortionRect

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

    op

    Составляющая композит работа для использования при рисовании изображения. Посмотрите NSCompositingOperation константы.

    requestedAlpha

    Альфа изображения, указанного как значение от 0,0 до 1,0. В то время как значение 1,0 рисует изображение как полностью непрозрачный, указание значения 0,0 рисует изображение, столь же полностью прозрачное. Значения, больше, чем 1,0, интерпретируются как 1,0.

    respectContextIsFlipped

    YEStrue если получение должно уважать контекст зеркально отраженное состояние, иначе NOfalse.

    hints

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

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • drawRepresentation (_: inRect:) - drawRepresentation:inRect:

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

    Объявление

    Swift

    func drawRepresentation(_ imageRep: NSImageRep, inRect dstRect: NSRect) -> Bool

    Objective C

    - (BOOL)drawRepresentation:(NSImageRep *)imageRep inRect:(NSRect)dstRect

    Параметры

    imageRep

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

    dstRect

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

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

    YEStrue если было успешно нарисовано изображение; иначе, возвраты NOfalse.

    Обсуждение

    Этот метод заполняет указанный прямоугольник текущим фоновым цветом изображения и затем отправляет сообщение в указанное представление изображения, спрашивающее, нарисовать ли себя. Если изображение поддерживает возможность масштабировать себя, когда это изменено, этот метод отправляет a drawInRect: сообщение; иначе, это отправляет a drawAtPoint: сообщение.

    Вы не должны вызывать этот метод непосредственно; NSImage возразите использует его, чтобы кэшировать и распечатать его представления изображения. Можно переопределить этот метод для изменения способа, которым изображения представляются в их кэшах и на печатную страницу. Например, Вы могли масштабировать или повернуть систему координат прежде, чем отправить это сообщение в super продолжать представлять представление изображения.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    backgroundColor

Управление опциями получения
  • допустимый допустимый Свойство

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

    Объявление

    Swift

    var valid: Bool { get }

    Objective C

    @property(getter=isValid, readonly) BOOL valid

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – initByReferencingFile:
    – initByReferencingURL:

  • backgroundColor backgroundColor Свойство

    Цвет фона для изображения.

    Объявление

    Swift

    @NSCopying var backgroundColor: NSColor

    Objective C

    @property(copy) NSColor *backgroundColor

    Обсуждение

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

    Цвет по умолчанию прозрачен, как возвращено clearColor метод NSColor.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – перекэш

Управление фокусом
  • lockFocus () - lockFocus

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

    Объявление

    Swift

    func lockFocus()

    Objective C

    - (void)lockFocus

    Обсуждение

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

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

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

    Если lockFocus неспособно фокусироваться на изображении, оно повышает NSImageCacheException.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – bestRepresentationForDevice:
    допустимый
    prefersColorMatch
    представления

  • lockFocusFlipped (_:) - lockFocusFlipped:

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

    Объявление

    Swift

    func lockFocusFlipped(_ flipped: Bool)

    Objective C

    - (void)lockFocusFlipped:(BOOL)flipped

    Параметры

    flipped

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • unlockFocus () - unlockFocus

    Удаляет фокус из получателя.

    Объявление

    Swift

    func unlockFocus()

    Objective C

    - (void)unlockFocus

    Обсуждение

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

    Не отправляйте это сообщение, если предыдущий вызов для блокировки фокуса повысил NSImageCacheException.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Работа с метаданными выравнивания
  • alignmentRect alignmentRect Свойство

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

    Объявление

    Swift

    var alignmentRect: NSRect

    Objective C

    @property NSRect alignmentRect

    Обсуждение

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

    Например, если у Вас есть значок на 20 x 20 пикселей, включающий эффект свечения, Вы могли бы установить прямоугольник выравнивания в {{2, 2}, {16, 16}} указать позицию базового значка без эффекта свечения. Это свойство значения по умолчанию к прямоугольнику с источником {0, 0} и размер, соответствующий размер изображения.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Управление кэширующимися опциями
  • cacheMode cacheMode Свойство

    Режим кэширования изображения.

    Объявление

    Swift

    var cacheMode: NSImageCacheMode

    Objective C

    @property NSImageCacheMode cacheMode

    Обсуждение

    Когда представления изображения используют внеэкранные кэши, кэширующийся режим определяет. Внеэкранные кэши ускоряют время рендеринга, но делают так при помощи дополнительной памяти. В режиме кэширования значения по умолчанию (NSImageCacheDefault), каждое представление изображения выбирает кэширующийся метод, производящий самые быстрые времена получения. Например, в режиме по умолчанию, NSPDFImageRep и NSEPSImageRep классы используют NSImageCacheAlways режим, но NSBitmapImageRep класс использует NSImageCacheBySize режим. Для списка возможных значений посмотрите NSImageCacheMode. Это значение установлено в NSImageCacheDefault по умолчанию.

    Для получения дополнительной информации о поведении кэширования изображения см. главу Изображений Руководства по Рисованию Какао.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • перекэш () - перекэш

    Лишает законной силы и освобождает внеэкранные кэши всех представлений изображения.

    Объявление

    Swift

    func recache()

    Objective C

    - (void)recache

    Обсуждение

    При изменении представления изображения необходимо отправить a recache обменивайтесь сообщениями к соответствующему объекту изображения, чтобы вынудить изменения повторно кэшироваться. В следующий раз, когда любое представление изображения нарисовано, просят воссоздать его кэшируемое изображение. Если Вы не отправляете это сообщение, представление изображения может использовать старые данные кэша. Этот метод просто очищает кэшируемые данные изображения; это не удаляет NSCachedImageRep объекты связались с любыми представлениями изображения.

    Если Вы не планируете использовать изображение снова сразу же, можно освободить его кэши для сокращения объема памяти, использованного программой.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Доступ к делегату
  • делегат делегат Свойство

    Объект делегата изображения.

    Объявление

    Swift

    unowned(unsafe) var delegate: NSImageDelegate?

    Objective C

    @property(assign) id< NSImageDelegate > delegate

    Обсуждение

    По умолчанию это свойство содержит nil.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Создание данных TIFF для изображения
  • TIFFRepresentation TIFFRepresentation Свойство

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

    Объявление

    Swift

    var TIFFRepresentation: NSData? { get }

    Objective C

    @property(readonly, strong) NSData *TIFFRepresentation

    Обсуждение

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

    Если одно из представлений изображения получателя не поддерживает создание данных TIFF исходно (PDF и изображения EPS, например), это свойство создает данные TIFF из который кэшируемое содержание представления. Это свойство содержит nil если не могут быть созданы данные TIFF.

    Дополнительные форматы изображения могут быть сохранены при помощи NSBitmapImageRep метод representationUsingType:properties:.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – TIFFRepresentationUsingCompression:factor:
    representationUsingType:properties: (NSBitmapImageRep)
    TIFFRepresentation (NSBitmapImageRep)
    TIFFRepresentationUsingCompression:factor: (NSBitmapImageRep)

  • TIFFRepresentationUsingCompression (_: фактор:) - TIFFRepresentationUsingCompression:factor:

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

    Объявление

    Swift

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

    Objective C

    - (NSData *)TIFFRepresentationUsingCompression:(NSTIFFCompression)comp factor:(float)aFloat

    Параметры

    comp

    Тип сжатия для использования. Для списка значений посмотрите константы в NSBitmapImageRep.

    aFloat

    Обеспечивает подсказку для типов сжатия та реализация переменные степени сжатия. В настоящее время только сжатие JPEG использует фактор сжатия.

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

    Объект данных, содержащий данные TIFF, или nil если не могли бы быть созданы данные TIFF.

    Обсуждение

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

    Если одно из представлений изображения получателя не поддерживает создание данных TIFF исходно (PDF и изображения EPS, например), этот метод создает данные TIFF из который кэшируемое содержание представления.

    Дополнительные форматы изображения могут быть сохранены при помощи NSBitmapImageRep метод representationUsingType:properties:.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    TIFFRepresentation
    representationUsingType:properties: (NSBitmapImageRep)
    TIFFRepresentation (NSBitmapImageRep)
    TIFFRepresentationUsingCompression:factor: (NSBitmapImageRep)

Создание CGImage от изображения
  • CGImageForProposedRect (_: context:hints:) - CGImageForProposedRect:context:hints:

    Возвраты a CGImage получение получения получателя.

    Объявление

    Swift

    func CGImageForProposedRect(_ proposedDestRect: UnsafeMutablePointer<NSRect>, context referenceContext: NSGraphicsContext?, hints hints: [NSObject : AnyObject]?) -> Unmanaged<CGImage>?

    Objective C

    - (CGImageRef)CGImageForProposedRect:(NSRect *)proposedDestRect context:(NSGraphicsContext *)referenceContext hints:(NSDictionary *)hints

    Параметры

    proposedDestRect

    На вводе, предложенном целевом прямоугольнике для рисования изображения. Если NULL, это принимает значение по умолчанию к самому маленькому интегральному пикселем прямоугольнику, содержащему {{0,0}, [сам размер]}. proposedDestRect находится в пространстве пользователя в ссылочном контексте.

    referenceContext

    Графический контекст.

    hints

    Словарь подсказок, обеспечивающих больше контекста для выбора или генерации a CGImage, и может переопределить свойства referenceContext.

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

    A CGImageRef. Это может быть существующим CGImage если Вы доступны. В противном случае новое CGImage создается.

    Обсуждение

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

    Все входные параметры являются дополнительными. Они обеспечивают подсказки для того, как выбрать среди существующего CGImages, или как создать тот, если уже нет доступного CGImage. Параметры являются только подсказками.

    Этот метод обычно вызывают, не переопределяют.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Управление инкрементными загрузками
  • cancelIncrementalLoad () - cancelIncrementalLoad

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

    Объявление

    Swift

    func cancelIncrementalLoad()

    Objective C

    - (void)cancelIncrementalLoad

    Обсуждение

    Если изображение не загружается, этот вызов не имеет никакого эффекта.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Хит, тестирующий изображение
  • hitTestRect (_: withImageDestinationRect:context:hints:flipped:) - hitTestRect:withImageDestinationRect:context:hints:flipped:

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

    Объявление

    Swift

    func hitTestRect(_ testRectDestSpace: NSRect, withImageDestinationRect imageRectDestSpace: NSRect, context referenceContext: NSGraphicsContext?, hints hints: [NSObject : AnyObject]?, flipped flipped: Bool) -> Bool

    Objective C

    - (BOOL)hitTestRect:(NSRect)testRectDestSpace withImageDestinationRect:(NSRect)imageRectDestSpace context:(NSGraphicsContext *)referenceContext hints:(NSDictionary *)hints flipped:(BOOL)flipped

    Параметры

    testRectDestSpace

    Прямоугольник для удара теста.

    imageRectDestSpace

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

    referenceContext

    Графический контекст. Это значение может быть nil.

    hints

    Дополнительный словарь подсказок, обеспечивающих больше контекста для выбора или генерации a CGImage, и может переопределить свойства referenceContext. Посмотрите Ключи Словаря Подсказки Изображения для сводки возможных пар ключ/значение.

    flipped

    YEStrue если изображение зеркально отражается, иначе NOfalse.

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

    YES, если testRectDestSpace пересекается с непрозрачным содержанием в imageRectDestSpace, иначе НЕТ.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Управление доступностью изображения
  • accessibilityDescription accessibilityDescription Свойство

    Описание доступности изображения.

    Объявление

    Swift

    var accessibilityDescription: String?

    Objective C

    @property(copy) NSString *accessibilityDescription

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Используя изображение с базовой анимацией
  • layerContentsForContentsScale (_:) - layerContentsForContentsScale:

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

    Объявление

    Swift

    func layerContentsForContentsScale(_ layerContentsScale: CGFloat) -> AnyObject

    Objective C

    - (id)layerContentsForContentsScale:(CGFloat)layerContentsScale

    Параметры

    layerContentsScale

    Масштабный коэффициент для получающегося изображения. Получите значение для этого параметра путем вызова recommendedLayerContentsScale: метод.

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

    Объект, который можно присвоить contents свойство a CALayer объект. Этот объект содержит данные изображения из текущего изображения, оптимизированного для указанного масштабного коэффициента.

    Обсуждение

    Используйте этот метод в ситуациях, где Вы хотите использовать изображение в качестве содержания уровня. Этот метод обеспечивает данные изображения, обернутые в объект, правильно уважающий все возможное содержание gravities поддерживаемый уровнем. Использование возвращенного объекта как содержание уровня рекомендуется по использованию NSImage возразите себе.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – recommendedLayerContentsScale:

  • recommendedLayerContentsScale (_:) - recommendedLayerContentsScale:

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

    Объявление

    Swift

    func recommendedLayerContentsScale(_ preferredContentsScale: CGFloat) -> CGFloat

    Objective C

    - (CGFloat)recommendedLayerContentsScale:(CGFloat)preferredContentsScale

    Параметры

    preferredContentsScale

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

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

    Рекомендуемый масштаб содержания уровня. Этот масштабный коэффициент может отличаться, чем тот в preferredContentsScale параметр.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – layerContentsForContentsScale:

Управление соответствием оси
  • matchesOnlyOnBestFittingAxis matchesOnlyOnBestFittingAxis Свойство

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

    Объявление

    Swift

    var matchesOnlyOnBestFittingAxis: Bool

    Objective C

    @property BOOL matchesOnlyOnBestFittingAxis

    Обсуждение

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

    NSImage всегда пытался использовать представление с, по крайней мере, столькими же пикселей сколько целевой прямоугольник. Много приложений пытаются реализовать баннеры и 3 части / 9 изображений части путем протяжения NSImage по намного большей области (обычно только на единственной оси).

    С добавлением 2x активы эти приложения находят, что эта политика выводит на экран 2x репутация изображения, когда они предпочли бы 1x репутация. Это поведение может быть изменено при помощи этого метода.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Устаревшие методы
  • lockFocusOnRepresentation: - lockFocusOnRepresentation: (OS X v10.6)

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

    Оператор осуждения

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

    Объявление

    Objective C

    - (void)lockFocusOnRepresentation:(NSImageRep *)imageRepresentation

    Параметры

    imageRepresentation

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

    Обсуждение

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

    Если imageRepresentation nil, этот метод действует как lockFocus метод, устанавливая фокус в лучшее представление для NSImage объект.

    Успешное lockFocusOnRepresentation: сообщение должно быть сбалансировано с соответствия unlockFocus обменивайтесь сообщениями к тому же NSImage объект. Эти сообщения заключают в скобки код, рисующий изображение.

    Если lockFocusOnRepresentation: неспособно фокусироваться на указанном представлении изображения, оно повышает NSImageCacheException.

    Специальные замечания

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

    • [image lockFocus];
    • [imageRepresentation drawInRect:NSMakeRect(0,0,[image size].width, [image size].height)];
    • [image unlockFocus];

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

    Objective C

    @import AppKit;

    Доступность

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

    Осуждаемый в OS X v10.6.

    См. также

    допустимый

  • bestRepresentationForDevice: - bestRepresentationForDevice: (OS X v10.6)

    Возвращает лучшее представление для устройства с заданными характеристиками.

    Оператор осуждения

    Использовать bestRepresentationForRect:context:hints: вместо этого.

    Объявление

    Objective C

    - (NSImageRep *)bestRepresentationForDevice:(NSDictionary *)deviceDescription

    Параметры

    deviceDescription

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

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

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

    Обсуждение

    Если deviceDescription nil, этот метод использует атрибуты устройства, на котором должно быть нарисовано содержание.

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

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

    Objective C

    @import AppKit;

    Доступность

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

    Осуждаемый в OS X v10.6.

    См. также

    представления
    prefersColorMatch
    matchesOnMultipleResolution
    usesEPSOnResolutionMismatch

  • compositeToPoint:operation: - compositeToPoint:operation: (OS X v10.6)

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

    Оператор осуждения

    Использовать drawAtPoint:fromRect:operation:fraction: вместо этого.

    Объявление

    Objective C

    - (void)compositeToPoint:(NSPoint)aPoint operation:(NSCompositingOperation)op

    Параметры

    aPoint

    Точка, в которой можно нарисовать изображение, указанное в текущей системе координат.

    op

    Составляющая композит работа для использования при рисовании изображения на экран. Поддерживаемые операции составления композита описаны в Константах.

    Обсуждение

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

    Во время печати этот метод игнорирует op параметр. Даже при том, что этот параметр проигнорирован, этот метод пытается представить изображение максимально близко к его появлению, когда составляющая композит работа используется на экране. В любом случае лучшее представление изображения выбрано для контекста печати.

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

    Objective C

    @import AppKit;

    Доступность

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

    Осуждаемый в OS X v10.6.

    См. также

    – dissolveToPoint:fraction:
    – drawAtPoint:fromRect:operation:fraction:
    – drawInRect:fromRect:operation:fraction:

  • compositeToPoint:fromRect:operation: - compositeToPoint:fromRect:operation: (OS X v10.6)

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

    Оператор осуждения

    Использовать drawInRect:fromRect:operation:fraction: вместо этого.

    Объявление

    Objective C

    - (void)compositeToPoint:(NSPoint)aPoint fromRect:(NSRect)srcRect operation:(NSCompositingOperation)op

    Параметры

    aPoint

    Точка, в которой можно нарисовать изображение, указанное в текущей системе координат.

    srcRect

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

    op

    Составляющая композит работа для использования при рисовании изображения на экран. Поддерживаемые операции составления композита описаны в Константах.

    Обсуждение

    Этот метод рисует указанную часть изображения, не проверяя прямоугольник границ, который Вы передаете в srcRect параметр. Если Вы указываете исходный прямоугольник, отклоняющийся за пределами прямоугольника границ изображения, возможно, что Вы могли составить части внеэкранного окна кэша, не принадлежащие изображению получателя. Можно избежать этой проблемы с помощью drawAtPoint:fromRect:operation:fraction: метод, проверяющий исходный прямоугольник перед получением.

    Во время получения изображение составляется от его внеэкранного кэша окна. Поскольку внеэкранный кэш не создается, пока представление изображения сначала не используется, этот метод, возможно, должен представить изображение перед составлением композита. Растровые представления в частности не кэшируются, пока они явно не представляются. Можно использовать lockFocus и unlockFocus методы, чтобы вынудить кэшированную версию, которая будет создаваться.

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

    Во время печати этот метод игнорирует op параметр. Даже при том, что этот параметр проигнорирован, этот метод пытается представить изображение максимально близко к его появлению, когда составляющая композит работа используется на экране. В любом случае лучшее представление изображения выбрано для контекста печати.

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

    Objective C

    @import AppKit;

    Доступность

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

    Осуждаемый в OS X v10.6.

    См. также

    – dissolveToPoint:fromRect:fraction:
    – drawAtPoint:fromRect:operation:fraction:
    – drawInRect:fromRect:operation:fraction:

  • compositeToPoint:fromRect:operation:fraction: - compositeToPoint:fromRect:operation:fraction: (OS X v10.6)

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

    Оператор осуждения

    Использовать drawInRect:fromRect:operation:fraction: вместо этого.

    Объявление

    Objective C

    - (void)compositeToPoint:(NSPoint)aPoint fromRect:(NSRect)srcRect operation:(NSCompositingOperation)op fraction:(CGFloat)delta

    Параметры

    aPoint

    Точка, в которой можно нарисовать изображение, указанное в текущей системе координат.

    srcRect

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

    op

    Составляющая композит работа для использования при рисовании изображения на экран. Поддерживаемые операции составления композита описаны в Константах.

    delta

    Желаемая непрозрачность изображения, указанного как значение между 0,0 и 1.0, с 1,0 представляющей общей непрозрачностью. Значения, больше, чем 1,0, интерпретируются как 1,0. Этот метод всегда ожидает представлять что-то, таким образом, для значений, которые равны или меньше чем 0, этот метод рендеринг в полной непрозрачности.

    Обсуждение

    Ведет себя то же как compositeToPoint:fromRect:operation: за исключением того, что можно указать сумму непрозрачности для использования при рисовании изображения.

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

    Objective C

    @import AppKit;

    Доступность

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

    Осуждаемый в OS X v10.6.

    См. также

    – dissolveToPoint:fromRect:fraction:
    – drawAtPoint:fromRect:operation:fraction:
    – drawInRect:fromRect:operation:fraction:

  • compositeToPoint:operation:fraction: - compositeToPoint:operation:fraction: (OS X v10.6)

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

    Оператор осуждения

    Использовать drawAtPoint:fromRect:operation:fraction: вместо этого.

    Объявление

    Objective C

    - (void)compositeToPoint:(NSPoint)aPoint operation:(NSCompositingOperation)op fraction:(CGFloat)delta

    Параметры

    aPoint

    Точка, в которой можно нарисовать изображение, указанное в текущей системе координат.

    op

    Составляющая композит работа для использования при рисовании изображения на экран. Поддерживаемые операции составления композита описаны в Константах.

    delta

    Желаемая непрозрачность изображения, указанного как значение между 0,0 и 1.0, с 1,0 представляющей общей непрозрачностью. Значения, больше, чем 1,0, интерпретируются как 1,0. Этот метод всегда ожидает представлять что-то, таким образом, для значений, которые равны или меньше чем 0, этот метод рендеринг в полной непрозрачности.

    Обсуждение

    Ведет себя то же как compositeToPoint:operation: за исключением того, что можно указать сумму непрозрачности для использования при рисовании изображения.

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

    Objective C

    @import AppKit;

    Доступность

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

    Осуждаемый в OS X v10.6.

    См. также

    – dissolveToPoint:fraction:
    – drawAtPoint:fromRect:operation:fraction:
    – drawInRect:fromRect:operation:fraction:

  • dissolveToPoint:fraction: - dissolveToPoint:fraction: (OS X v10.6)

    Составляет все изображение к указанному расположению с помощью NSCompositeSourceOver оператор.

    Оператор осуждения

    Использовать drawAtPoint:fromRect:operation:fraction: вместо этого.

    Объявление

    Objective C

    - (void)dissolveToPoint:(NSPoint)aPoint fraction:(CGFloat)delta

    Параметры

    aPoint

    Точка, в которой можно нарисовать изображение, указанное в текущей системе координат.

    delta

    Желаемая непрозрачность изображения, указанного как значение между 0,0 и 1.0. Значение 0,0 рендеринга изображение, полностью прозрачное, в то время как 1,0 рендеринга это полностью непрозрачный. Значения, больше, чем 1,0, интерпретируются как 1,0.

    Обсуждение

    За исключением выбора составляющего композит оператора, этот метод ведет себя таким же образом как compositeToPoint:operation: метод. Во время печати, delta параметр проигнорирован.

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

    Для медленного растворения этого изображения на другого можно вызвать этот метод (или dissolveToPoint:fromRect:fraction: метод) неоднократно с постоянно увеличивающимся delta значение. Поскольку delta параметр относится к видимой части исходного изображения, увеличивание значения заставляет исходное изображение постепенно заменять целевое содержание. Необходимо обычно выполнять этот тип работы с помощью буферизированного окна или другой внеэкранной среды получения.

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

    Objective C

    @import AppKit;

    Доступность

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

    Осуждаемый в OS X v10.6.

  • dissolveToPoint:fromRect:fraction: - dissolveToPoint:fromRect:fraction: (OS X v10.6)

    Составляет часть изображения к указанному расположению с помощью NSCompositeSourceOver оператор.

    Оператор осуждения

    Использовать drawInRect:fromRect:operation:fraction: вместо этого.

    Объявление

    Objective C

    - (void)dissolveToPoint:(NSPoint)aPoint fromRect:(NSRect)srcRect fraction:(CGFloat)delta

    Параметры

    aPoint

    Точка, в которой можно нарисовать изображение, указанное в текущей системе координат.

    srcRect

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

    delta

    Желаемая непрозрачность изображения, указанного как значение между 0,0 и 1.0. Значение 0,0 рендеринга изображение, полностью прозрачное, в то время как 1,0 рендеринга это полностью непрозрачный. Значения, больше, чем 1,0, интерпретируются как 1,0.

    Обсуждение

    За исключением выбора составляющего композит оператора, этот метод ведет себя таким же образом как compositeToPoint:fromRect:operation: метод. Во время печати, delta параметр проигнорирован.

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

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

    Objective C

    @import AppKit;

    Доступность

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

    Осуждаемый в OS X v10.6.

    См. также

    – dissolveToPoint:fraction:

  • setScalesWhenResized: - setScalesWhenResized: (OS X v10.6)

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

    Оператор осуждения

    Этот метод был связан с кэширующимся поведением. В Mac OS X v10.6 и позже, кэширование изображения больше не необходимо и в результате нет никакой необходимой замены.

    Объявление

    Objective C

    - (void)setScalesWhenResized:(BOOL)flag

    Параметры

    flag

    YEStrue если представления изображения масштабируются для адаптации; иначе NOfalse.

    Обсуждение

    Большинство изображений (особенно загруженные из файлов и URLs) содержит только единственное представление изображения, размер которого совпадает с получателем. Возможно добавить представления изображения с помощью addRepresentation: или addRepresentations: методы, но выполнение так редко необходимы, потому что современные аппаратные средства достаточно мощны, чтобы изменить размеры и масштабировать изображения быстро. Единственная причина рассмотреть создающие новые представления состоит в том, если каждый представления содержит настроенную версию изображения в определенном размере. (Изображения TIFF могут также содержать версию миниатюры изображения, которое сохранено с помощью отдельного представления изображения.), Если Вы передаете YEStrue в flag параметр, и впоследствии присваивает новое значение size свойство, все такие представления изображения масштабировались бы к тому же размеру. Масштабирование растровых изображений обычно приводит к интерполяции растровых данных.

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

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

    Objective C

    @import AppKit;

    Доступность

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

    Осуждаемый в OS X v10.6.

    См. также

    – scalesWhenResized

  • scalesWhenResized - scalesWhenResized (OS X v10.6)

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

    Оператор осуждения

    Этот метод был связан с кэширующимся поведением. В Mac OS X v10.6 и позже, кэширование изображения больше не необходимо и в результате нет никакой необходимой замены.

    Объявление

    Objective C

    - (BOOL)scalesWhenResized

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

    YEStrue если представления изображения масштабируются для адаптации получателю; иначе, NOfalse. Значение по умолчанию NOfalse.

    Обсуждение

    Если этот метод возвращается, изображения не изменены во время рисования YEStrue. Когда Вы присваиваете новое значение, они только изменены size свойство.

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

    Objective C

    @import AppKit;

    Доступность

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

    Осуждаемый в OS X v10.6.

    См. также

    – setScalesWhenResized:

  • setDataRetained: - setDataRetained: (OS X v10.6)

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

    Оператор осуждения

    В Mac OS v10.6 и позже, NSImage больше данные отбрасываний таким способом, которым больше не может восстанавливаться оригинал. Нет никакого метода замены.

    Объявление

    Objective C

    - (void)setDataRetained:(BOOL)flag

    Параметры

    flag

    YEStrue если Вы хотите, чтобы были сохранены данные исходного изображения; иначе NOfalse.

    Обсуждение

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

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

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

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

    Objective C

    @import AppKit;

    Доступность

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

    Осуждаемый в OS X v10.6.

  • isDataRetained - isDataRetained (OS X v10.6)

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

    Оператор осуждения

    В Mac OS v10.6 и позже, NSImage больше данные отбрасываний таким способом, которым больше не может восстанавливаться оригинал. Нет никакого метода замены.

    Объявление

    Objective C

    - (BOOL)isDataRetained

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

    YEStrue если изображение сохраняет свои исходные данные; иначе, NOfalse. Значение по умолчанию NOfalse за некоторыми исключениями, покрытыми обсуждением.

    Обсуждение

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

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

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

    Objective C

    @import AppKit;

    Доступность

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

    Осуждаемый в OS X v10.6.

  • setCachedSeparately: - setCachedSeparately: (OS X v10.6)

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

    Оператор осуждения

    NSImage больше кэши к окнам. Нет никакого метода замены

    Объявление

    Objective C

    - (void)setCachedSeparately:(BOOL)flag

    Параметры

    flag

    YEStrue если Вы хотите каждый из объектов представления изображения получателя использовать отдельное внеэкранное окно для кэширования; иначе, NOfalse.

    Обсуждение

    Если Вы указываете NOfalse, представление может кэшироваться вместе с другими изображениями, хотя на практике это не могло бы быть. Этот метод не лишает законной силы существующих кэшей.

    Если Вы планируете изменить размеры NSImage возражайте часто, обычно более эффективно кэшировать свои представления отдельно. Если Вы планируете использовать, в некоторых ситуациях Вы могли бы также хотеть включить отдельное кэширование compositeToPoint:fromRect:operation: или compositeToPoint:fromRect:operation:fraction:методы для рисования изображения.

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

    Objective C

    @import AppKit;

    Доступность

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

    Осуждаемый в OS X v10.6.

    См. также

    – перекэш

  • isCachedSeparately - isCachedSeparately (OS X v10.6)

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

    Оператор осуждения

    NSImage больше кэши к окнам. Нет никакого метода замены

    Объявление

    Objective C

    - (BOOL)isCachedSeparately

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

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

    Обсуждение

    Если возвращается этот метод NOfalse, это означает, что изображение может кэшироваться в совместно используемом окне, но не требуется, чтобы быть. Изображения кэшируются в совместно используемом окне, если у них есть те же общие атрибуты, такие как цветовое пространство, разрешение и битовая глубина.

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

    Objective C

    @import AppKit;

    Доступность

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

    Осуждаемый в OS X v10.6.

  • setCacheDepthMatchesImageDepth: - setCacheDepthMatchesImageDepth: (OS X v10.6)

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

    Оператор осуждения

    NSImage больше кэши к окнам. Кэш теперь сгенерирован подходящий для места назначения, где нарисовано изображение. Нет никакого метода замены.

    Объявление

    Objective C

    - (void)setCacheDepthMatchesImageDepth:(BOOL)flag

    Параметры

    flag

    YEStrue если внеэкранные кэши используют ту же битовую глубину, связанную с данными изображения; иначе, NOfalse для указания они должны использовать битовую глубину по умолчанию.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Доступность

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

    Осуждаемый в OS X v10.6.

    См. также

    – cacheDepthMatchesImageDepth
    – lockFocus
    – перекэш

  • cacheDepthMatchesImageDepth - cacheDepthMatchesImageDepth (OS X v10.6)

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

    Оператор осуждения

    NSImage больше кэши к окнам. Кэш теперь сгенерирован подходящий для места назначения, где нарисовано изображение. Нет никакого метода замены.

    Объявление

    Objective C

    - (BOOL)cacheDepthMatchesImageDepth

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

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

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

    Objective C

    @import AppKit;

    Доступность

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

    Осуждаемый в OS X v10.6.

    См. также

    – setCacheDepthMatchesImageDepth:

  • setFlipped: - setFlipped: (OS X v10.6)

    Наборы, инвертируется ли полярность оси y при рисовании изображения.

    Оператор осуждения

    Зеркально отраженное свойство изображения было широко неправильно понято и было осуждено. Использовать drawInRect:fromRect:operation:fraction:respectFlipped:hints: нарисовать уважение зеркально отраженного состояния контекста и lockFocusFlipped: вовлечь зеркально отраженное изображение.

    Объявление

    Objective C

    - (void)setFlipped:(BOOL)flag

    Параметры

    flag

    YEStrue если Вы хотите, чтобы данные изображения были инвертированы перед получением; иначе, NOfalse.

    Обсуждение

    Если flag YEStrue, ось y внутренней системы координат изображения инвертируется с источником в верхнем левом углу и положительной оси y, расширяющейся вниз. Этот метод влияет только на систему координат, используемую внутренне изображением и ориентацией изображения, когда это нарисовано; это не влияет на систему координат, используемую для указания позиции изображения в представлении. Этот метод не заставляет получатель повторно кэшировать себя.

    Если Вы устанавливаете flag к YEStrue и затем блокировка фокусируется и вовлекает изображение, содержание Вы, получение кэшируется в инвертированной (зеркально отраженной) ориентации. Изменение значения для flag не влияет на ориентацию кэшируемого изображения.

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

    Objective C

    @import AppKit;

    Доступность

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

    Осуждаемый в OS X v10.6.

    См. также

    – isFlipped
    – перекэш

  • isFlipped - isFlipped (OS X v10.6)

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

    Оператор осуждения

    Зеркально отраженное свойство изображения было широко неправильно понято и было осуждено. Использовать drawInRect:fromRect:operation:fraction:respectFlipped:hints: нарисовать уважение зеркально отраженного состояния контекста и lockFocusFlipped: вовлечь зеркально отраженное изображение.

    Объявление

    Objective C

    - (BOOL)isFlipped

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

    YEStrue если зеркально отражается система координат изображения; иначе, NOfalse. Значение по умолчанию NOfalse.

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

    Objective C

    @import AppKit;

    Доступность

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

    Осуждаемый в OS X v10.6.

    См. также

    – setFlipped:

Типы данных

  • NSCompositingOperation NSCompositingOperation

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

    Объявление

    Swift

    enum NSCompositingOperation : UInt { case CompositeClear case CompositeCopy case CompositeSourceOver case CompositeSourceIn case CompositeSourceOut case CompositeSourceAtop case CompositeDestinationOver case CompositeDestinationIn case CompositeDestinationOut case CompositeDestinationAtop case CompositeXOR case CompositePlusDarker case CompositeHighlight case CompositePlusLighter case CompositeMultiply case CompositeScreen case CompositeOverlay case CompositeDarken case CompositeLighten case CompositeColorDodge case CompositeColorBurn case CompositeSoftLight case CompositeHardLight case CompositeDifference case CompositeExclusion case CompositeHue case CompositeSaturation case CompositeColor case CompositeLuminosity }

    Objective C

    enum { NSCompositeClear = 0, NSCompositeCopy = 1, NSCompositeSourceOver = 2, NSCompositeSourceIn = 3, NSCompositeSourceOut = 4, NSCompositeSourceAtop = 5, NSCompositeDestinationOver = 6, NSCompositeDestinationIn = 7, NSCompositeDestinationOut = 8, NSCompositeDestinationAtop = 9, NSCompositeXOR = 10, NSCompositePlusDarker = 11, NSCompositeHighlight = 12, NSCompositePlusLighter = 13 } typedef NSUInteger NSCompositingOperation;

    Константы

    • CompositeClear

      NSCompositeClear

      Прозрачный. (R = 0)

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

    • CompositeCopy

      NSCompositeCopy

      Исходное изображение. (R = S)

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

    • CompositeSourceOver

      NSCompositeSourceOver

      Исходное изображение везде, где исходное изображение является непрозрачным, и конечным изображением в другом месте. (R = S + D*(1 - Sa))

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

    • CompositeSourceIn

      NSCompositeSourceIn

      Исходное изображение везде, где оба изображения непрозрачны, и прозрачны в другом месте. (R = S*Da)

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

    • CompositeSourceOut

      NSCompositeSourceOut

      Исходное изображение везде, где исходное изображение непрозрачно, но конечное изображение прозрачно, и прозрачно в другом месте. (R = S*(1 - Da))

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

    • CompositeSourceAtop

      NSCompositeSourceAtop

      Исходное изображение везде, где оба изображения являются непрозрачным, конечным изображением везде, где конечное изображение непрозрачно, но исходное изображение прозрачно, и прозрачно в другом месте. (R = S*Da + D*(1 - Sa))

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

    • CompositeDestinationOver

      NSCompositeDestinationOver

      Конечное изображение везде, где конечное изображение является непрозрачным, и исходным изображением в другом месте. (R = S*(1 - Da) + D)

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

    • CompositeDestinationIn

      NSCompositeDestinationIn

      Конечное изображение везде, где оба изображения непрозрачны, и прозрачны в другом месте. (R = D*Sa)

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

    • CompositeDestinationOut

      NSCompositeDestinationOut

      Конечное изображение везде, где конечное изображение непрозрачно, но исходное изображение прозрачно, и прозрачно в другом месте. (R = D*(1 - Sa))

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

    • CompositeDestinationAtop

      NSCompositeDestinationAtop

      Конечное изображение везде, где оба изображения являются непрозрачным, исходным изображением везде, где исходное изображение непрозрачно, но конечное изображение прозрачно, и прозрачно в другом месте. (R = S*(1 - Da) + D*Sa)

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

    • CompositeXOR

      NSCompositeXOR

      Монопольный OR исходных и конечных изображений. (R = S*(1 - Da) + D*(1 - Sa))

      Работы только с черными и белыми изображениями и не рекомендуются для цветных контекстов.

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

    • CompositePlusDarker

      NSCompositePlusDarker

      Сумма исходных и конечных изображений, со значениями цвета, приближающимися 0 как предел. (R = MAX(0, (1 - D) + (1 - S)))

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

    • CompositeHighlight

      NSCompositeHighlight

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

      Отображенный на NSCompositeSourceOver.

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

      Осуждаемый в OS X v10.0.

    • CompositePlusLighter

      NSCompositePlusLighter

      Сумма исходных и конечных изображений, со значениями цвета, приближающимися 1 как предел. (R = MIN(1, S + D))

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

    Обсуждение

    Эти операторы составления композита определяются в и используются compositeToPoint:fromRect:operation:, compositeToPoint:operation:, compositeToPoint:fromRect:operation:fraction:, compositeToPoint:operation:fraction:, drawAtPoint:fromRect:operation:fraction:, и drawInRect:fromRect:operation:fraction:. Они также используются методами рисования в других классах, берущих составляющего композит оператора.

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

    Таблица 2Placeholder оценивает за составление композита уравнений

    Параграф

    Параграф

    R

    Предварительно умноженный результирующий цвет.

    S

    Исходный цвет

    D

    Целевой цвет

    Sa

    Альфа-значение исходного цвета

    Da

    Альфа-значение целевого цвета

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • NSImageLoadStatus NSImageLoadStatus

    Эти константы являются значениями состояния, переданными инкрементному методу делегата загрузки image:didLoadRepresentation:withStatus:.

    Объявление

    Swift

    enum NSImageLoadStatus : UInt { case Completed case Cancelled case InvalidData case UnexpectedEOF case ReadError }

    Objective C

    enum { NSImageLoadStatusCompleted, NSImageLoadStatusCancelled, NSImageLoadStatusInvalidData, NSImageLoadStatusUnexpectedEOF, NSImageLoadStatusReadError } typedef NSUInteger NSImageLoadStatus;

    Константы

    • Completed

      NSImageLoadStatusCompleted

      Достаточно данных было предоставлено для завершенной распаковки изображения.

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

    • Cancelled

      NSImageLoadStatusCancelled

      Загрузка изображения была отменена.

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

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

    • InvalidData

      NSImageLoadStatusInvalidData

      Ошибка произошла во время распаковки изображения.

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

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

    • UnexpectedEOF

      NSImageLoadStatusUnexpectedEOF

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

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

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

    • ReadError

      NSImageLoadStatusReadError

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

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • NSImageCacheMode NSImageCacheMode

    Эти константы указывают кэширующуюся политику по на NSImage основание. Кэширующаяся политика установлена с помощью cacheMode свойство.

    Объявление

    Swift

    enum NSImageCacheMode : UInt { case Default case Always case BySize case Never }

    Objective C

    enum { NSImageCacheDefault, NSImageCacheAlways, NSImageCacheBySize, NSImageCacheNever } typedef NSUInteger NSImageCacheMode;

    Константы

    • Default

      NSImageCacheDefault

      Кэширование является неуказанным.

      Используйте значение по умолчанию репутации изображения.

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

    • Always

      NSImageCacheAlways

      Всегда генерируйте кэш при рисовании.

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

    • BySize

      NSImageCacheBySize

      Кэш, если размер кэша меньше, чем исходные данные.

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

    • Never

      NSImageCacheNever

      Никогда не кэшируйтесь; всегда рисуйте прямой.

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

    Обсуждение

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

    Отобразите класс члена палаты представителей

    Политика кэширования значения по умолчанию

    NSBitmapImageRep

    NSImageCacheBySize. Кэш, если битовый массив составляет 32 бита в 16-разрядном мире или больше, чем 72 точки на дюйм.

    NSPICTImageRep

    NSImageCacheBySize. То же обоснование как NSBitmapImageRep в конечном счете PICT содержит битовый массив.

    NSPDFImageRep

    NSImageCacheAlways

    NSCIImageRep

    NSImageCacheBySize. Кэш, если растровая глубина не соответствует экранную глубину или разрешение, больше, чем 72 точки на дюйм.

    NSEPSImageRep

    NSImageCacheAlways

    NSCustomImageRep

    NSImageCacheAlways

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Константы
  • Ключи словаря подсказки изображения

    Эти константы являются подмножеством ключей словаря, используемых в словаре подсказок для методов CGImageForProposedRect:context:hints:, bestRepresentationForRect:context:hints:, drawInRect:fromRect:operation:fraction:respectFlipped:hints:, и hitTestRect:withImageDestinationRect:context:hints:flipped:. Дополнительные ключи подсказки также допустимы включая: Context Options в CIContext, и записи в NSScreen словарь описания устройства, как описано в deviceDescription.

    Объявление

    Swift

    let NSImageHintCTM: NSString! let NSImageHintInterpolation: NSString!

    Objective C

    NSString *const NSImageHintCTM; NSString *const NSImageHintInterpolation;

    Константы

    • NSImageHintCTM

      NSImageHintCTM

      Обеспечивает контекст преобразовывают подсказку. Значение для этого ключа NSAffineTransform.

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

    • NSImageHintInterpolation

      NSImageHintInterpolation

      Обеспечивает подсказку интерполяции. Значение для этого ключа NSNumber с NSImageInterpolation значение.

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

  • Константы шаблона изображения

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

    Объявление

    Swift

    let NSImageNameQuickLookTemplate: NSString! let NSImageNameBluetoothTemplate: NSString! let NSImageNameIChatTheaterTemplate: NSString! let NSImageNameSlideshowTemplate: NSString! let NSImageNameActionTemplate: NSString! let NSImageNameSmartBadgeTemplate: NSString! let NSImageNamePathTemplate: NSString! let NSImageNameInvalidDataFreestandingTemplate: NSString! let NSImageNameLockLockedTemplate: NSString! let NSImageNameLockUnlockedTemplate: NSString! let NSImageNameGoRightTemplate: NSString! let NSImageNameGoLeftTemplate: NSString! let NSImageNameRightFacingTriangleTemplate: NSString! let NSImageNameLeftFacingTriangleTemplate: NSString! let NSImageNameAddTemplate: NSString! let NSImageNameRemoveTemplate: NSString! let NSImageNameRevealFreestandingTemplate: NSString! let NSImageNameFollowLinkFreestandingTemplate: NSString! let NSImageNameEnterFullScreenTemplate: NSString! let NSImageNameExitFullScreenTemplate: NSString! let NSImageNameStopProgressTemplate: NSString! let NSImageNameStopProgressFreestandingTemplate: NSString! let NSImageNameRefreshTemplate: NSString! let NSImageNameRefreshFreestandingTemplate: NSString!

    Objective C

    NSString *const NSImageNameQuickLookTemplate; NSString *const NSImageNameBluetoothTemplate; NSString *const NSImageNameIChatTheaterTemplate; NSString *const NSImageNameSlideshowTemplate; NSString *const NSImageNameActionTemplate; NSString *const NSImageNameSmartBadgeTemplate; NSString *const NSImageNamePathTemplate; NSString *const NSImageNameInvalidDataFreestandingTemplate; NSString *const NSImageNameLockLockedTemplate; NSString *const NSImageNameLockUnlockedTemplate; NSString *const NSImageNameGoRightTemplate; NSString *const NSImageNameGoLeftTemplate; NSString *const NSImageNameRightFacingTriangleTemplate; NSString *const NSImageNameLeftFacingTriangleTemplate; NSString *const NSImageNameAddTemplate; NSString *const NSImageNameRemoveTemplate; NSString *const NSImageNameRevealFreestandingTemplate; NSString *const NSImageNameFollowLinkFreestandingTemplate; NSString *const NSImageNameEnterFullScreenTemplate; NSString *const NSImageNameExitFullScreenTemplate; NSString *const NSImageNameStopProgressTemplate; NSString *const NSImageNameStopProgressFreestandingTemplate; NSString *const NSImageNameRefreshTemplate; NSString *const NSImageNameRefreshFreestandingTemplate;

    Константы

    • NSImageNameQuickLookTemplate

      NSImageNameQuickLookTemplate

      Изображение шаблона Quick Look. image: ../Art/NSQuickLookTemplate.jpg

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

    • NSImageNameBluetoothTemplate

      NSImageNameBluetoothTemplate

      Изображение шаблона Bluetooth. image: ../Art/NSBluetoothTemplate.jpg

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

    • NSImageNameIChatTheaterTemplate

      NSImageNameIChatTheaterTemplate

      Изображение шаблона iChat Theater. image: ../Art/NSIchatTheaterTemplate.jpg is missing from your submission.

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

    • NSImageNameSlideshowTemplate

      NSImageNameSlideshowTemplate

      Шаблонное изображение слайд-шоу. image: ../Art/NSSlideshowTemplate.jpg

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

    • NSImageNameActionTemplate

      NSImageNameActionTemplate

      Шаблонное изображение меню действий. image: ../Art/NSActionTemplate.jpg

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

    • NSImageNameSmartBadgeTemplate

      NSImageNameSmartBadgeTemplate

      Значок для «умного» элемента. image: ../Art/NSSmartBadgeTemplate.jpg

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

    • NSImageNamePathTemplate

      NSImageNamePathTemplate

      Кнопка пути обрабатывает изображение по шаблону. image: ../Art/NSPathTemplate.jpg

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

    • NSImageNameInvalidDataFreestandingTemplate

      NSImageNameInvalidDataFreestandingTemplate

      Недопустимые данные обрабатывают изображение по шаблону. Поместите этот значок направо от любых полей, содержащих недопустимые данные. Можно использовать это изображение для реализации безграничной кнопки. image: ../art/NSInvalidDataFreestandingTemplate_2x.png

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

    • NSImageNameLockLockedTemplate

      NSImageNameLockLockedTemplate

      Заблокированная блокировка обрабатывает изображение по шаблону. Используйте для указания заблокированного содержания. image: ../Art/NSLockLockedTemplate.jpg

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

    • NSImageNameLockUnlockedTemplate

      NSImageNameLockUnlockedTemplate

      Разблокированная блокировка обрабатывает изображение по шаблону. Используйте для указания модифицируемого содержания, которое может быть заблокировано. image: ../Art/NSLockUnlockedTemplate.jpg

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

    • NSImageNameGoRightTemplate

      NSImageNameGoRightTemplate

      «Движение» вперед обрабатывает изображение по шаблону. image: ../Art/NSGoRightTemplate.jpg

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

    • NSImageNameGoLeftTemplate

      NSImageNameGoLeftTemplate

      «Движение» назад обрабатывает изображение по шаблону. image: ../Art/NSGoLeftTemplate.jpg

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

    • NSImageNameRightFacingTriangleTemplate

      NSImageNameRightFacingTriangleTemplate

      Универсальный бывший обращенным к праву треугольник обрабатывает изображение по шаблону. image: ../Art/NSRightFacingTriangleTemplate.jpg

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

    • NSImageNameLeftFacingTriangleTemplate

      NSImageNameLeftFacingTriangleTemplate

      Универсальный треугольник лево-направления обрабатывает изображение по шаблону. image: ../Art/NSLeftFacingTriangleTemplate.jpg

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

    • NSImageNameAddTemplate

      NSImageNameAddTemplate

      Добавить элемент обрабатывает изображение по шаблону. image: ../Art/NSAddTemplate.jpg

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

    • NSImageNameRemoveTemplate

      NSImageNameRemoveTemplate

      Удалить элемент обрабатывает изображение по шаблону. image: ../Art/NSRemoveTemplate.jpg

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

    • NSImageNameRevealFreestandingTemplate

      NSImageNameRevealFreestandingTemplate

      Раскрывать содержание обрабатывает изображение по шаблону. Можно использовать это изображение для реализации безграничной кнопки. image: ../art/NSRevealFreestandingTemplate_2x.png

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

    • NSImageNameFollowLinkFreestandingTemplate

      NSImageNameFollowLinkFreestandingTemplate

      Шаблонное изображение ссылки. Можно использовать это изображение для реализации безграничной кнопки. image: ../art/NSFollowLinkFreestandingTemplate_2x.png

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

    • NSImageNameEnterFullScreenTemplate

      NSImageNameEnterFullScreenTemplate

      Ввести полноэкранный режим обрабатывает изображение по шаблону. image: ../Art/NSEnterFullScreenTemplate.jpg

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

    • NSImageNameExitFullScreenTemplate

      NSImageNameExitFullScreenTemplate

      Полноэкранный режим выхода обрабатывает изображение по шаблону. image: ../Art/NSExitFullScreenTemplate.jpg

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

    • NSImageNameStopProgressTemplate

      NSImageNameStopProgressTemplate

      Кнопка прогресса остановки обрабатывает изображение по шаблону. image: ../Art/NSStopProgressTemplate.jpg

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

    • NSImageNameStopProgressFreestandingTemplate

      NSImageNameStopProgressFreestandingTemplate

      Прогресс остановки обрабатывает изображение по шаблону. Можно использовать это изображение для реализации безграничной кнопки. image: ../art/NSStopProgressFreestandingTemplate_2x.png

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

    • NSImageNameRefreshTemplate

      NSImageNameRefreshTemplate

      Шаблонное изображение обновления. image: ../Art/NSRefreshTemplate.jpg

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

    • NSImageNameRefreshFreestandingTemplate

      NSImageNameRefreshFreestandingTemplate

      Шаблонное изображение обновления. Можно использовать это изображение для реализации безграничной кнопки. image: ../art/NSRefreshFreestandingTemplate_2x.png

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

    Обсуждение

    Для доступа к этим изображениям передайте указанную константу imageNamed: метод.

    Изображения со словом «Template» в их заголовке идентифицируют формы, не предназначающиеся как автономные изображения. Вы обычно использовали бы эти значки в качестве пользовательского изображения для кнопки, или Вы могли бы применить их к ячейке в управлении. Например, Вы могли бы использовать NSImageNameLockLockedTemplate изображение для указания элемента не является модифицируемым. Шаблонные изображения должны использовать черные и ясные цвета только, и хорошо включать переменные уровни альфы.

    Изображения со словом «Freestanding» в их заголовке могут использоваться для реализации безграничных кнопок. Вы не должны включать дополнительные иллюстрации внешней панели позади таких изображений.

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

    Размер и форматное соотношение образов системы могут измениться от выпуска до выпуска. В некоторых ситуациях необходимо явно изменить размеры изображений как подходящих для использования. Если Вы используете эти изображения в сочетании с NSButtonCell объект, однако, можно использовать setImageScaling: метод ячейки для управления масштабированием вместо этого. Точно так же для NSSegmentedCell объект, можно использовать setImageScaling:forSegment: метод для управления масштабированием.

    Строковое значение для каждой константы равно постоянному имени без части «ImageName». Вам, возможно, понадобилась бы эта информация для определения местоположения изображений по имени в Интерфейсном Разработчике. Например, константа NSImageNameRefreshFreestandingTemplate соответствовал бы изображению под названием «NSRefreshFreestandingTemplate» в Интерфейсном Разработчике.

  • Многократные документы перетаскивают изображение

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

    Объявление

    Swift

    let NSImageNameMultipleDocuments: NSString!

    Objective C

    NSString *const NSImageNameMultipleDocuments;

    Константы

    • NSImageNameMultipleDocuments

      NSImageNameMultipleDocuments

      Изображение перетаскивания для многократных элементов. image: ../Art/NSMultipleDocuments.jpg

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

    Обсуждение

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

    Размер и форматное соотношение образов системы могут измениться от выпуска до выпуска. В некоторых ситуациях необходимо явно изменить размеры изображений как подходящих для использования. Если Вы используете эти изображения в сочетании с NSButtonCell объект, однако, можно использовать setImageScaling: метод ячейки для управления масштабированием вместо этого. Точно так же для NSSegmentedCell объект, можно использовать setImageScaling:forSegment: метод для управления масштабированием.

    Строковое значение для каждой константы равно постоянному имени без части «ImageName». Вам, возможно, понадобилась бы эта информация для определения местоположения изображений по имени в Интерфейсном Разработчике. Например, константа NSImageNameMultipleDocuments соответствовал бы изображению под названием «NSMultipleDocuments» в Интерфейсном Разработчике.

  • Совместное использование полномочий под названием изображения

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

    Объявление

    Swift

    let NSImageNameUser: NSString! let NSImageNameUserGroup: NSString! let NSImageNameEveryone: NSString! let NSImageNameUserGuest: NSString!

    Objective C

    NSString *const NSImageNameUser; NSString *const NSImageNameUserGroup; NSString *const NSImageNameEveryone; NSString *const NSImageNameUserGuest;

    Константы

    • NSImageNameUser

      NSImageNameUser

      Полномочия для отдельного пользователя. image: ../Art/NSUser.jpg

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

    • NSImageNameUserGroup

      NSImageNameUserGroup

      Полномочия для группы пользователей. image: ../Art/NSUserGroup.jpg

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

    • NSImageNameEveryone

      NSImageNameEveryone

      Полномочия для всех пользователей. image: ../Art/NSEveryone.jpg

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

    • NSImageNameUserGuest

      NSImageNameUserGuest

      Полномочия для гостей.image: ../Art/NSUserGuest.png

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

    Обсуждение

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

    Размер и форматное соотношение образов системы могут измениться от выпуска до выпуска. В некоторых ситуациях необходимо явно изменить размеры изображений как подходящих для использования. Если Вы используете эти изображения в сочетании с NSButtonCell объект, однако, можно использовать setImageScaling: метод ячейки для управления масштабированием вместо этого. Точно так же для NSSegmentedCell объект, можно использовать setImageScaling:forSegment: метод для управления масштабированием.

    Строковое значение для каждой константы равно постоянному имени без части «ImageName». Вам, возможно, понадобилась бы эта информация для определения местоположения изображений по имени в Интерфейсном Разработчике. Например, константа NSImageNameEveryone соответствовал бы изображению под названием «NSEveryone» в Интерфейсном Разработчике.

  • Изображения системного объекта

    Изображения, представляющие элементы Средства поиска. Для доступа к этому изображению передайте указанную константу imageNamed: метод.

    Объявление

    Swift

    let NSImageNameBonjour: NSString! let NSImageNameComputer: NSString! let NSImageNameFolderBurnable: NSString! let NSImageNameFolderSmart: NSString! let NSImageNameNetwork: NSString!

    Objective C

    NSString *const NSImageNameBonjour; NSString *const NSImageNameDotMac; NSString *const NSImageNameComputer; NSString *const NSImageNameFolderBurnable; NSString *const NSImageNameFolderSmart; NSString *const NSImageNameNetwork;

    Константы

    • NSImageNameBonjour

      NSImageNameBonjour

      Значок Bonjour. image: ../Art/NSBonjour.jpg

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

    • NSImageNameDotMac

      NSImageNameDotMac

      Значок Dot Mac. image: ../Art/NSDotMac.jpg

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

      Осуждаемый в OS X v10.7.

    • NSImageNameComputer

      NSImageNameComputer

      Значок компьютера. image: ../Art/NSComputer.jpg

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

    • NSImageNameFolderBurnable

      NSImageNameFolderBurnable

      Горючий значок папки. image: ../Art/NSFolderBurnable.jpg

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

    • NSImageNameFolderSmart

      NSImageNameFolderSmart

      Умный значок папки. image: ../Art/NSFolderSmart.jpg

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

    • NSImageNameNetwork

      NSImageNameNetwork

      Значок сети. image: ../Art/NSNetwork.jpg

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

    Обсуждение

    Необходимо использовать эти изображения для отражения определенных элементов среды Mac OS X. Например, если Ваше программное обеспечение позволяет пользователю организовывать содержание для записи на оптический диск, Вы могли бы использовать горючий значок папки. Появление изображений может измениться между выпусками. При использовании изображения в его намеченной цели (и не из-за того, как это смотрит), код должен выглядеть корректным от выпуска до выпуска.

    Размер и форматное соотношение образов системы могут измениться от выпуска до выпуска. В некоторых ситуациях необходимо явно изменить размеры изображений как подходящих для использования. Если Вы используете эти изображения в сочетании с NSButtonCell объект, однако, можно использовать setImageScaling: метод ячейки для управления масштабированием вместо этого. Точно так же для NSSegmentedCell объект, можно использовать setImageScaling:forSegment: метод для управления масштабированием.

    Строковое значение для каждой константы равно постоянному имени без части «ImageName». Вам, возможно, понадобилась бы эта информация для определения местоположения изображений по имени в Интерфейсном Разработчике. Например, константа NSImageNameNetwork соответствовал бы изображению под названием «NSNetwork» в Интерфейсном Разработчике.

  • Панель инструментов под названием изображения

    Изображения, которые можно использовать в инструментальных панелях приложений. Для доступа к этому изображению передайте указанную константу imageNamed: метод.

    Объявление

    Swift

    let NSImageNameUserAccounts: NSString! let NSImageNamePreferencesGeneral: NSString! let NSImageNameAdvanced: NSString! let NSImageNameInfo: NSString! let NSImageNameFontPanel: NSString! let NSImageNameColorPanel: NSString! let NSImageNameFolder: NSString! let NSImageNameTrashEmpty: NSString! let NSImageNameTrashFull: NSString! let NSImageNameHomeTemplate: NSString! let NSImageNameBookmarksTemplate: NSString! let NSImageNameCaution: NSString! let NSImageNameStatusAvailable: NSString! let NSImageNameStatusPartiallyAvailable: NSString! let NSImageNameStatusUnavailable: NSString! let NSImageNameStatusNone: NSString! let NSImageNameApplicationIcon: NSString! let NSImageNameMenuOnStateTemplate: NSString! let NSImageNameMenuMixedStateTemplate: NSString! let NSImageNameMobileMe: NSString!

    Objective C

    NSString *const NSImageNameUserAccounts; NSString *const NSImageNamePreferencesGeneral; NSString *const NSImageNameAdvanced; NSString *const NSImageNameInfo; NSString *const NSImageNameFontPanel; NSString *const NSImageNameColorPanel; NSString *const NSImageNameFolder; NSString *const NSImageNameTrashEmpty; NSString *const NSImageNameTrashFull; NSString *const NSImageNameHomeTemplate; NSString *const NSImageNameBookmarksTemplate; NSString *const NSImageNameCaution; NSString *const NSImageNameStatusAvailable; NSString *const NSImageNameStatusPartiallyAvailable; NSString *const NSImageNameStatusUnavailable; NSString *const NSImageNameStatusNone; NSString *const NSImageNameApplicationIcon; NSString *const NSImageNameMenuOnStateTemplate; NSString *const NSImageNameMenuMixedStateTemplate; NSString *const NSImageNameMobileMe;

    Константы

    • NSImageNameUserAccounts

      NSImageNameUserAccounts

      Значок панели инструментов учетной записи пользователя. Используйте в предпочтительном окне только. image: ../Art/NSUserAccounts.jpg

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

    • NSImageNamePreferencesGeneral

      NSImageNamePreferencesGeneral

      Общий предпочтительный значок панели инструментов. Используйте в предпочтительном окне только. image: ../Art/NSPreferencesGeneral.jpg

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

    • NSImageNameAdvanced

      NSImageNameAdvanced

      Усовершенствованный предпочтительный значок панели инструментов. Используйте в предпочтительном окне только. image: ../Art/NSAdvanced.jpg

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

    • NSImageNameInfo

      NSImageNameInfo

      Информационный значок панели инструментов. image: ../Art/NSInfo.jpg

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

    • NSImageNameFontPanel

      NSImageNameFontPanel

      Значок панели инструментов панели шрифта. image: ../Art/NSFontPanel.jpg

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

    • NSImageNameColorPanel

      NSImageNameColorPanel

      Цветной значок панели инструментов панели. image: ../Art/NSColorPanel.jpg

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

    • NSImageNameFolder

      NSImageNameFolder

      Изображение папки. image: ../Art/NSFolder.png

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

    • NSImageNameTrashEmpty

      NSImageNameTrashEmpty

      Изображение пустой корзины.image: ../Art/NSTrashEmpty.png

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

    • NSImageNameTrashFull

      NSImageNameTrashFull

      Изображение полной корзины.image: ../Art/NSTrashFull.png

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

    • NSImageNameHomeTemplate

      NSImageNameHomeTemplate

      Домашнее изображение, подходящее для шаблона.image: ../Art/NSHomeTemplate.png

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

    • NSImageNameBookmarksTemplate

      NSImageNameBookmarksTemplate

      Изображение закладок, подходящее для шаблона.image: ../Art/NSBookmarksTemplate.png

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

    • NSImageNameCaution

      NSImageNameCaution

      Изображение предостережения.image: ../Art/NSCaution.png

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

    • NSImageNameStatusAvailable

      NSImageNameStatusAvailable

      Небольшой зеленый индикатор, подобный доступному изображению iChat. image: ../Art/NSStatusAvailable.png

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

    • NSImageNameStatusPartiallyAvailable

      NSImageNameStatusPartiallyAvailable

      Небольшой желтый индикатор, подобный неактивному изображению iChat.image: ../Art/NSStatusPartiallyAvailable.png

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

    • NSImageNameStatusUnavailable

      NSImageNameStatusUnavailable

      Небольшой красный индикатор, подобный недоступному изображению iChat.image: ../Art/NSStatusUnavailable.png

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

    • NSImageNameStatusNone

      NSImageNameStatusNone

      Небольшой ясный индикатор.image: ../Art/NSStatusNone.png

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

    • NSImageNameApplicationIcon

      NSImageNameApplicationIcon

      Значок приложения.

      На версиях  Mac OS X до v10.6 можно использовать строку @"NSApplicationIcon".

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

    • NSImageNameMenuOnStateTemplate

      NSImageNameMenuOnStateTemplate

      Галочка. Рисованию их за пределами меню обескураживают.image: ../Art/NSMenuOnStateTemplate.png

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

    • NSImageNameMenuMixedStateTemplate

      NSImageNameMenuMixedStateTemplate

      Горизонтальный тире. Рисованию их за пределами меню обескураживают. image: ../Art/NSMenuMixedStateTemplate.png

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

    • NSImageNameMobileMe

      NSImageNameMobileMe

      Логотип MobileMe. Обратите внимание на то, что это предпочтено использованию NSImageNameDotMac изображение, несмотря на то, что то изображение, как ожидают, не будет осуждено. image: ../art/NSMobileMe_2x.png

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

    Обсуждение

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

    Размер и форматное соотношение образов системы могут измениться от выпуска до выпуска. В некоторых ситуациях необходимо явно изменить размеры изображений как подходящих для использования. Если Вы используете эти изображения в сочетании с NSButtonCell объект, однако, можно использовать setImageScaling: метод ячейки для управления масштабированием вместо этого. Точно так же для NSSegmentedCell объект, можно использовать setImageScaling:forSegment: метод для управления масштабированием.

    Константы, заканчивающиеся в слове «Template», называют черные и ясные изображения тем возвратом YEStrue для isTemplate. Эти изображения могут быть обработаны в варианты, подходящие для различных ситуаций. Например, эти изображения могут инвертировать в выбранной строке табличного представления. Посмотрите setTemplate:: для большего количества комментариев. Эти изображения являются несоответствующими для дисплея без последующей обработки, но NSCell и его подклассы выполнят обработку.

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

    Строковое значение для каждой константы равно постоянному имени без части «ImageName». Вам, возможно, понадобилась бы эта информация для определения местоположения изображений по имени в Интерфейсном Разработчике. Например, константа NSImageNameColorPanel соответствовал бы изображению под названием «NSColorPanel» в Интерфейсном Разработчике.

  • Шаблонные изображения типа представления

    Изображения, используемые в сегментированных средствах управления для переключения типа текущего представления. Для доступа к этому изображению передайте указанную константу imageNamed: метод.

    Объявление

    Swift

    let NSImageNameIconViewTemplate: NSString! let NSImageNameListViewTemplate: NSString! let NSImageNameColumnViewTemplate: NSString! let NSImageNameFlowViewTemplate: NSString! let NSImageNameShareTemplate: NSString!

    Objective C

    NSString *const NSImageNameIconViewTemplate; NSString *const NSImageNameListViewTemplate; NSString *const NSImageNameColumnViewTemplate; NSString *const NSImageNameFlowViewTemplate; NSString *const NSImageNameShareTemplate;

    Константы

    • NSImageNameIconViewTemplate

      NSImageNameIconViewTemplate

      Режим представления в виде значков обрабатывает изображение по шаблону. image: ../Art/NSIconViewTemplate.jpg

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

    • NSImageNameListViewTemplate

      NSImageNameListViewTemplate

      Режим представления списка обрабатывает изображение по шаблону. image: ../Art/NSListViewTemplate.jpg

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

    • NSImageNameColumnViewTemplate

      NSImageNameColumnViewTemplate

      Режим представления столбца обрабатывает изображение по шаблону. image: ../Art/NSColumnViewTemplate.jpg

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

    • NSImageNameFlowViewTemplate

      NSImageNameFlowViewTemplate

      Поток покрытия просматривает шаблонное изображение режима. image: ../Art/NSFlowViewTemplate.jpg

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

    • NSImageNameShareTemplate

      NSImageNameShareTemplate

      Представление доли обрабатывает изображение по шаблону. image: ../art/NSShareTemplate_2x.png

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

    Обсуждение

    Изображения со словом «Template» в их заголовке идентифицируют формы, не предназначающиеся как автономные изображения. Вы обычно использовали бы эти значки в качестве пользовательского изображения для кнопки, или Вы могли бы применить их к ячейке в управлении. Например, Вы могли бы использовать NSImageNameIconViewTemplate изображение для указания элемента не является модифицируемым. Шаблонные изображения должны использовать черные и ясные цвета только, и хорошо включать переменные уровни альфы.

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

    Размер и форматное соотношение образов системы могут измениться от выпуска до выпуска. В некоторых ситуациях необходимо явно изменить размеры изображений как подходящих для использования. Если Вы используете эти изображения в сочетании с NSButtonCell объект, однако, можно использовать setImageScaling: метод ячейки для управления масштабированием вместо этого. Точно так же для NSSegmentedCell объект, можно использовать setImageScaling:forSegment: метод для управления масштабированием.

    Строковое значение для каждой константы равно постоянному имени без части «ImageName». Вам, возможно, понадобилась бы эта информация для определения местоположения изображений по имени в Интерфейсном Разработчике. Например, константа NSImageNameFlowViewTemplate соответствовал бы изображению под названием «NSFlowViewTemplate» в Интерфейсном Разработчике.