Up

NSImage

Authors

Adam Fedor (fedor@colorado.edu)
Load, manipulate and display images

Copyright: (C) 1996, 2005 Free Software Foundation, Inc.


Contents -

  1. Software documentation for the NSImage class
  2. Software documentation for the NSBundle(NSImageAdditions) category
  3. Software documentation for the GSImageDelegateProtocol protocol

Software documentation for the NSImage class

NSImage : NSObject

Declared in:
AppKit/NSImage.h
Conforms to:
NSCoding
NSCopying
Availability: OpenStep

Description forthcoming.

Instance Variables

Method summary

_standardImageWithName: 

+ (NSImage*) _standardImageWithName: (NSString*)name;
Availability: Gui 0.0.0

Warning the underscore at the start of the name of this method indicates that it is private, for internal use only, and you should not use the method in your code.

canInitWithPasteboard: 

+ (BOOL) canInitWithPasteboard: (NSPasteboard*)pasteboard;
Availability: OpenStep

Description forthcoming.

imageFileTypes 

+ (NSArray*) imageFileTypes;
Availability: OpenStep

Description forthcoming.

imageNamed: 

+ (id) imageNamed: (NSString*)aName;
Availability: OpenStep

Returns the NSImage named aName. The search is done in the main bundle first and then in the usual images directories


imagePasteboardTypes 

+ (NSArray*) imagePasteboardTypes;
Availability: OpenStep

Description forthcoming.

imageUnfilteredFileTypes 

+ (NSArray*) imageUnfilteredFileTypes;
Availability: OpenStep

Description forthcoming.

imageUnfilteredPasteboardTypes 

+ (NSArray*) imageUnfilteredPasteboardTypes;
Availability: OpenStep

Description forthcoming.

TIFFRepresentation 

- (NSData*) TIFFRepresentation;
Availability: OpenStep

Description forthcoming.

TIFFRepresentationUsingCompression: factor: 

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

Description forthcoming.

addRepresentation: 

- (void) addRepresentation: (NSImageRep*)imageRep;
Availability: OpenStep

Adds the NSImageRep imageRep to the NSImage's representations array.

See Also: -addRepresentations: removeRepresentation:


addRepresentations: 

- (void) addRepresentations: (NSArray*)imageRepArray;
Availability: OpenStep

Adds the NSImageRep array imageRepArray to the NSImage's representations array.

See Also: -addRepresentation: -removeRepresentation:


backgroundColor 

- (NSColor*) backgroundColor;
Availability: OpenStep

Returns the color of the NSImage's background

See Also: -setBackgroundColor:


bestRepresentationForDevice: 

- (NSImageRep*) bestRepresentationForDevice: (NSDictionary*)deviceDescription;
Availability: OpenStep

Description forthcoming.

cacheDepthMatchesImageDepth 

- (BOOL) cacheDepthMatchesImageDepth;
Availability: OpenStep

Description forthcoming.

cacheMode 

- (NSImageCacheMode) cacheMode;
Availability: OpenStep

Description forthcoming.

compositeToPoint: fromRect: operation: 

- (void) compositeToPoint: (NSPoint)aPoint fromRect: (NSRect)aRect operation: (NSCompositingOperation)op;
Availability: OpenStep

Description forthcoming.

compositeToPoint: fromRect: operation: fraction: 

- (void) compositeToPoint: (NSPoint)aPoint fromRect: (NSRect)aRect operation: (NSCompositingOperation)op fraction: (float)delta;
Availability: MacOS-X 10.0.0

Description forthcoming.

compositeToPoint: operation: 

- (void) compositeToPoint: (NSPoint)aPoint operation: (NSCompositingOperation)op;
Availability: OpenStep

Description forthcoming.

compositeToPoint: operation: fraction: 

- (void) compositeToPoint: (NSPoint)aPoint operation: (NSCompositingOperation)op fraction: (float)delta;
Availability: MacOS-X 10.0.0

Description forthcoming.

delegate 

- (id) delegate;
Availability: OpenStep

Description forthcoming.

dissolveToPoint: fraction: 

- (void) dissolveToPoint: (NSPoint)aPoint fraction: (float)aFloat;
Availability: OpenStep

Description forthcoming.

dissolveToPoint: fromRect: fraction: 

- (void) dissolveToPoint: (NSPoint)aPoint fromRect: (NSRect)aRect fraction: (float)aFloat;
Availability: OpenStep

Description forthcoming.

drawAtPoint: fromRect: operation: fraction: 

- (void) drawAtPoint: (NSPoint)point fromRect: (NSRect)srcRect operation: (NSCompositingOperation)op fraction: (float)delta;
Availability: MacOS-X 10.0.0

Calls -drawAtPoint:fromRect:operation:fraction: with dstRect given by point and the size of srcRect.

drawInRect: fromRect: operation: fraction: 

- (void) drawInRect: (NSRect)dstRect fromRect: (NSRect)srcRect operation: (NSCompositingOperation)op fraction: (float)fraction;
Availability: MacOS-X 10.0.0

Takes the part of the receiver given by srcRect and draws it in dstRect in the current coordinate system, transforming the image as necessary.

The image is drawn as if it was drawn to a cleared window, then dissolved using the fraction delta to another cleared window, and finally composited using op to the destination.

Note that compositing and dissolving doesn't work on all devices (printers, in particular).


drawRepresentation: inRect: 

- (BOOL) drawRepresentation: (NSImageRep*)imageRep inRect: (NSRect)aRect;
Availability: OpenStep

Description forthcoming.

initByReferencingFile: 

- (id) initByReferencingFile: (NSString*)fileName;
Availability: OpenStep

Description forthcoming.

initWithBitmapHandle: 

- (id) initWithBitmapHandle: (void*)bitmap;
Availability: MacOS-X 10.0.0

Description forthcoming.

initWithContentsOfFile: 

- (id) initWithContentsOfFile: (NSString*)fileName;
Availability: OpenStep

Initializes and returns a new NSImage from the file fileName. fileName should be an absolute path.

See Also: [NSImageRep +imageRepsWithContentsOfFile:]


initWithContentsOfURL: 

- (id) initWithContentsOfURL: (NSURL*)anURL;
Availability: MacOS-X 10.0.0

Description forthcoming.

initWithData: 

- (id) initWithData: (NSData*)data;
Availability: OpenStep

Initializes and returns a new NSImage from the NSData data.

See Also: [NSImageRep +imageRepWithData:]


initWithIconHandle: 

- (id) initWithIconHandle: (void*)icon;
Availability: MacOS-X 10.0.0

Description forthcoming.

initWithPasteboard: 

- (id) initWithPasteboard: (NSPasteboard*)pasteboard;
Availability: OpenStep

Initializes and returns a new NSImage from the data in pasteboard. the pasteboard types can be whose defined in [NSImageRep +imagePasteboardTypes] or NSFilenamesPboardType

See Also: [NSImageRep+imageRepsWithPasteboard:


initWithSize: 

- (id) initWithSize: (NSSize)aSize;
Availability: OpenStep

Initialize and returns a new NSImage with aSize as specified size.

See Also: -setSize: -size


isCachedSeparately 

- (BOOL) isCachedSeparately;
Availability: OpenStep

Description forthcoming.

isDataRetained 

- (BOOL) isDataRetained;
Availability: OpenStep

Description forthcoming.

isFlipped 

- (BOOL) isFlipped;
Availability: OpenStep

Description forthcoming.

isValid 

- (BOOL) isValid;
Availability: OpenStep

Description forthcoming.

lockFocus 

- (void) lockFocus;
Availability: OpenStep

Locks the focus on the best representation

See Also: -lockFocusOnRepresentation:


lockFocusOnRepresentation: 

- (void) lockFocusOnRepresentation: (NSImageRep*)imageRep;
Availability: OpenStep

Locks the focus in the imageRep. if imageRep is nil this method locks the focus on the best representation


matchesOnMultipleResolution 

- (BOOL) matchesOnMultipleResolution;
Availability: OpenStep

Description forthcoming.

name 

- (NSString*) name;
Availability: OpenStep

Description forthcoming.

prefersColorMatch 

- (BOOL) prefersColorMatch;
Availability: OpenStep

Description forthcoming.

recache 

- (void) recache;
Availability: OpenStep

Description forthcoming.

removeRepresentation: 

- (void) removeRepresentation: (NSImageRep*)imageRep;
Availability: OpenStep

Remove the NSImageRep imageRep from the NSImage's representations array

See Also: -addRepresentations: -addRepresentation:


representations 

- (NSArray*) representations;
Availability: OpenStep

Description forthcoming.

scalesWhenResized 

- (BOOL) scalesWhenResized;
Availability: OpenStep

Description forthcoming.

setBackgroundColor: 

- (void) setBackgroundColor: (NSColor*)aColor;
Availability: OpenStep

Sets the color of the NSImage's background to aColor

See Also: -backgroundColor


setCacheDepthMatchesImageDepth: 

- (void) setCacheDepthMatchesImageDepth: (BOOL)flag;
Availability: OpenStep

Description forthcoming.

setCacheMode: 

- (void) setCacheMode: (NSImageCacheMode)mode;
Availability: OpenStep

Description forthcoming.

setCachedSeparately: 

- (void) setCachedSeparately: (BOOL)flag;
Availability: OpenStep

Description forthcoming.

setDataRetained: 

- (void) setDataRetained: (BOOL)flag;
Availability: OpenStep

Description forthcoming.

setDelegate: 

- (void) setDelegate: (id)anObject;
Availability: OpenStep

Description forthcoming.

setFlipped: 

- (void) setFlipped: (BOOL)flag;
Availability: OpenStep

Description forthcoming.

setMatchesOnMultipleResolution: 

- (void) setMatchesOnMultipleResolution: (BOOL)flag;
Availability: OpenStep

Description forthcoming.

setName: 

- (BOOL) setName: (NSString*)aName;
Availability: OpenStep

Description forthcoming.

setPrefersColorMatch: 

- (void) setPrefersColorMatch: (BOOL)flag;
Availability: OpenStep

Description forthcoming.

setScalesWhenResized: 

- (void) setScalesWhenResized: (BOOL)flag;
Availability: OpenStep

Description forthcoming.

setSize: 

- (void) setSize: (NSSize)aSize;
Availability: OpenStep

Sets the NSImage size to aSize. Changing the size recreate the cache

See Also: -size -initWithSize:


setUsesEPSOnResolutionMismatch: 

- (void) setUsesEPSOnResolutionMismatch: (BOOL)flag;
Availability: OpenStep

Description forthcoming.

size 

- (NSSize) size;
Availability: OpenStep

Returns NSImage size if the size have been set. Returns the size of the best representation otherwise.

See Also: -setSize: -initWithSize:


unlockFocus 

- (void) unlockFocus;
Availability: OpenStep

Description forthcoming.

usesEPSOnResolutionMismatch 

- (BOOL) usesEPSOnResolutionMismatch;
Availability: OpenStep

Description forthcoming.



Instance Variables for NSImage Class

_cacheMode

@protected NSImageCacheMode _cacheMode;
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.

_color

@protected NSColor* _color;
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.

_delegate

@protected id _delegate;
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.

_fileName

@protected NSString* _fileName;
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.

_flags

@protected struct __imageFlags _flags;
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.

_lockedView

@protected NSView* _lockedView;
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.

_name

@protected NSString* _name;
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.

_reps

@protected NSMutableArray* _reps;
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.

_size

@protected NSSize _size;
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.




Software documentation for the NSBundle(NSImageAdditions) category

NSBundle(NSImageAdditions)

Declared in:
AppKit/NSImage.h
Availability: OpenStep

Description forthcoming.
Method summary

pathForImageResource: 

- (NSString*) pathForImageResource: (NSString*)name;
Availability: OpenStep

Description forthcoming.

Software documentation for the GSImageDelegateProtocol protocol

GSImageDelegateProtocol

Declared in:
AppKit/NSImage.h
Availability: Gui 0.0.0

Description forthcoming.
Method summary

imageDidNotDraw: inRect: 

- (NSImage*) imageDidNotDraw: (id)sender inRect: (NSRect)aRect;
Availability: Gui 0.0.0

Description forthcoming.


Up