Developer Documentation
PATH  Mac OS X Documentation > Application Kit Reference: Java

Table of Contents

NSPICTImageRep


Inherits from:
NSImageRep : NSObject
Package:
com.apple.yellow.application


Class Description


An NSPICTImageRep is an object that can render an image from a PICT format data stream as described in Inside Macintosh: Imaging With QuickDraw. This includes PICT format version 1, version 2, and extended version 2 pictures.

WARNING

There is no guarantee that the image will render exactly the same as it would under QuickDraw because of the differences between the display medium and QuickDraw. In particular, some transfer modes and region operations may not be supported.

Like most other kinds of NSImageReps, an NSPICTImageRep is generally used indirectly, through an NSImage object. An NSImage must be able to choose from among various representations of a given image. It also needs to provide an off-screen cache of the appropriate depth for any image it uses. It determines this information by querying its NSImageReps.

Thus to work with an NSImage, an NSPICTImageRep must be able to provide some information about its image. The bounding box is obtained from the PICT format data. Use these methods, inherited from the NSImageRep class, to set the other attributes of an NSPICTImageRep object:

Note that if these attributes aren't set, and an NSPICTImageRep is used in an NSImage with other representations, NSImage won't be able to select from among the representations. In actual practice, this usually isn't a problem.




Method Types


Constructors
NSPICTImageRep
Creating an NSPICTImageRep
imageRep
Getting image data
boundingBox
PICTRepresentation


Constructors



NSPICTImageRep

public NSPICTImageRep()

Description forthcoming.

public NSPICTImageRep(NSData aData)

Description forthcoming.


Static Methods



imageRep

public static native NSPICTImageRep imageRep(NSData pictData)

Creates a new NSPICTImageRep instance and then initializes it with the contents of pictData, a PICT format data stream. If the new object can't be initialized for any reason (for example, pictData doesn't conform to the PICT file format), this method returns null. Otherwise, it returns a new instance of NSPICTImageRep.

See Also: PICTRepresentation




Instance Methods



boundingBox

public NSRect boundingBox()

Returns the rectangle that bounds the image. The rectangle is obtained from the PICT format data, specifically the picFrame field in the picture header. See Inside Macintosh: Imaging With QuickDraw for information on the picture header.

PICTRepresentation

public NSData PICTRepresentation()

Returns the PICT representation of the receiver. The returned PICT data is a copy of the data minus the 512 byte header if it is present. Note, PICT files or documents contain a 512-byte header, so if you wish to save the returned data to a file you need to precede the data with 512 bytes (all zero) to conform to the PICT document format.


Table of Contents