Creates and returns an image representation object using the contents of the specified file.
- macOS 10.0+
A full or relative pathname specifying the file to open. This string should include the filename extension.
An initialized instance of an
NSImage subclass, or
nil if the image data could not be read.
If sent to the
NSImage class object, this method returns a newly allocated instance of a subclass of
NSImage (chosen through the use of
image) initialized with the contents of the specified file. If sent to a subclass of
NSImage that recognizes the type of data in the file, it returns an instance of that subclass initialized with the contents of the file.
This method returns
nil in any of the following cases:
The message is sent to the
NSImageclass object and there are no subclasses in the
NSImageclass registry that handle the type of data in the specified file.
The message is sent to a subclass of
NSImageand that subclass cannot handle the type of data in the specified file.
NSImagesubclass is unable to initialize itself with the contents of the specified file.
NSImage subclass is initialized by creating an
NSData object based on the contents of the file and passing it to the
image method. By default, the files handled include those with the extensions “