<!--
{
  "documentType" : "article",
  "framework" : "AppKit",
  "identifier" : "/documentation/AppKit/nsimage-deprecated-symbols",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Deprecated Symbols"
}
-->

# Deprecated Symbols

Review symbols that are no longer supported, and find the replacements to use instead.

## Topics

### Class Methods

[`class func imageFileTypes() -> [String]`](/documentation/AppKit/NSImage/imageFileTypes())

Returns an array of strings identifying the image types supported by the registered image representation objects.

[`class func imageUnfilteredFileTypes() -> [String]`](/documentation/AppKit/NSImage/imageUnfilteredFileTypes())

Returns an array of strings identifying the file types supported directly by the registered image representation objects.

[`class func imagePasteboardTypes() -> [NSPasteboard.PasteboardType]`](/documentation/AppKit/NSImage/imagePasteboardTypes())

Returns an array of strings identifying the pasteboard types supported directly by the registered image representation objects.

[`class func imageUnfilteredPasteboardTypes() -> [NSPasteboard.PasteboardType]`](/documentation/AppKit/NSImage/imageUnfilteredPasteboardTypes())

Returns an array of strings identifying the pasteboard types supported directly by the registered image representation objects.

### Instance Methods

[`func lockFocus()`](/documentation/AppKit/NSImage/lockFocus())

Prepares the image to receive drawing commands.

[`func lockFocusFlipped(Bool)`](/documentation/AppKit/NSImage/lockFocusFlipped(_:))

Prepares the image to receive drawing commands using the specified flipped state.

[`func unlockFocus()`](/documentation/AppKit/NSImage/unlockFocus())

Removes the focus from the image.

[`convenience init(iconRef: IconRef)`](/documentation/AppKit/NSImage/init(iconRef:))

Initializes the image object with a Carbon-style icon resource.

[`- (void) lockFocusOnRepresentation:(NSImageRep *) imageRepresentation;`](/documentation/AppKit/NSImage/lockFocusOnRepresentation:)

Prepares the specified image representation to receive drawing commands.

[`- (NSImageRep *) bestRepresentationForDevice:(NSDictionary *) deviceDescription;`](/documentation/AppKit/NSImage/bestRepresentationForDevice:)

Returns the best representation for the device with the specified characteristics.

[`- (void) compositeToPoint:(NSPoint) point operation:(NSCompositingOperation) operation;`](/documentation/AppKit/NSImage/compositeToPoint:operation:)

Composites the entire image to the specified point in the current coordinate system.

[`- (void) compositeToPoint:(NSPoint) point fromRect:(NSRect) rect operation:(NSCompositingOperation) operation;`](/documentation/AppKit/NSImage/compositeToPoint:fromRect:operation:)

Composites a portion of the image to the specified point in the current coordinate system.

[`- (void) compositeToPoint:(NSPoint) point fromRect:(NSRect) rect operation:(NSCompositingOperation) operation fraction:(CGFloat) fraction;`](/documentation/AppKit/NSImage/compositeToPoint:fromRect:operation:fraction:)

Composites a portion of the image at the specified opacity to the current coordinate system.

[`- (void) compositeToPoint:(NSPoint) point operation:(NSCompositingOperation) operation fraction:(CGFloat) fraction;`](/documentation/AppKit/NSImage/compositeToPoint:operation:fraction:)

Composites the entire image at the specified opacity in the current coordinate system.

[`- (void) dissolveToPoint:(NSPoint) point fraction:(CGFloat) fraction;`](/documentation/AppKit/NSImage/dissolveToPoint:fraction:)

Composites the entire image to the specified location using the source-over operator.

[`- (void) dissolveToPoint:(NSPoint) point fromRect:(NSRect) rect fraction:(CGFloat) fraction;`](/documentation/AppKit/NSImage/dissolveToPoint:fromRect:fraction:)

Composites a portion of the image to the specified location using the source-over operator.

[`- (void) setScalesWhenResized:(BOOL) flag;`](/documentation/AppKit/NSImage/setScalesWhenResized:)

Sets whether to scale different-sized image representations to fit the image’s size.

[`- (BOOL) scalesWhenResized;`](/documentation/AppKit/NSImage/scalesWhenResized)

Returns a Boolean value that indicates whether to scale image representations to fit the image’s size.

[`- (void) setDataRetained:(BOOL) flag;`](/documentation/AppKit/NSImage/setDataRetained:)

Sets whether the image retains its source image data.

[`- (BOOL) isDataRetained;`](/documentation/AppKit/NSImage/isDataRetained)

Returns a Boolean value that incidates whether the image retains its source image data.

[`- (void) setCachedSeparately:(BOOL) flag;`](/documentation/AppKit/NSImage/setCachedSeparately:)

Sets whether each image representation uses a separate offscreen window to cache its contents.

[`- (BOOL) isCachedSeparately;`](/documentation/AppKit/NSImage/isCachedSeparately)

Returns a Boolean value that indicates whether each image representation caches its contents in a separate offscreen window.

[`- (void) setCacheDepthMatchesImageDepth:(BOOL) flag;`](/documentation/AppKit/NSImage/setCacheDepthMatchesImageDepth:)

Sets whether the image’s offscreen window caches use the same bit depth as the image data itself.

[`- (BOOL) cacheDepthMatchesImageDepth;`](/documentation/AppKit/NSImage/cacheDepthMatchesImageDepth)

Returns a Boolean value that indicates whether an image’s offscreen window caches use the same bit depth as the image data itself.

[`- (void) setFlipped:(BOOL) flag;`](/documentation/AppKit/NSImage/setFlipped:)

Sets whether the polarity of the y axis is inverted when drawing an image.

[`- (BOOL) isFlipped;`](/documentation/AppKit/NSImage/isFlipped)

Returns a Boolean value that indicates whether the image uses a flipped coordinate system.



---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)