NSBitmapImageRepMBS.bitmapImageRepByConvertingToColorSpace(colorSpace as NSColorSpaceMBS, renderingIntent as Integer) as NSBitmapImageRepMBS

targetSpace: The new colorSpace
renderingIntent: The rendering intent specifies how to handle colors that are not located within the target color space. The supported values are NSColorRenderingIntent.

Constant	Value
Default	0
AbsoluteColorimetric	1
RelativeColorimetric	2
Perceptual	3
Saturation	4

An NSBitmapImageRep, or nil, if the conversion fails. If the original NSBitmapImageRep already uses that colorSpace, it is returned as is.

Some examples using this method:

• /MacBase/ConvertToSRGB

NSBitmapImageRepMBS.bitmapImageRepByRetaggingWithColorSpace(newSpace as NSColorSpaceMBS) as NSBitmapImageRepMBS

newSpace: The desired colorSpace.

Returns an NSBitmapImageRep, or nil, if the conversion fails. If the original NSBitmapImageRep already uses that colorSpace, it is returned as is.

This method will definitely fail if you pass a colorSpace that has a different color space model than the receiver. That is, if your original image is sRGB, you can only retag with some other RGB colorspace.
Available in Mac OS X v10.6 and later.

NSBitmapImageRepMBS.BMPRepresentation(properties as dictionary = nil) as Memoryblock

NSBitmapImageRepMBS.canBeCompressedUsing(compression as Integer) as Boolean

Returns ture if the receiver's data matches compression with this type, false if the data doesn't match compression or if compression is unsupported..

Legal values for compression can be found in NSBitmapImageRep.h and are described in TIFF Compression in NSBitmapImageReps. This method returns true if the receiver's data matches compression; for example, if compression is NSTIFFCompressionCCITTFAX3, then the data must be 1 bit per sample and 1 sample per pixel.

NSBitmapImageRepMBS.Constructor(data as Memoryblock)

data: A data object containing image data. The contents of bitmapData can be any supported bitmap format. For TIFF data, the NSBitmapImageRep is initialized from the first header and image data found in bitmapData.

On success the handle property is not zero.

See also:

• Constructor(pic as Picture)
• Constructor(pixelsWide as Integer, pixelsHigh as Integer, bitsPerSample as Integer, samplesPerPixel as Integer, hasAlpha as boolean, colorSpaceName as string, bytesPerRow as Integer, bitsPerPixel as Integer)

NSBitmapImageRepMBS.Constructor(pic as Picture)

pic: A Core Graphics image object (an opaque type) from which to create the receiver. This opaque type is retained.

An NSBitmapImageRep object initialized from the contents of the Core Graphics image or nil if the NSBitmapImageRep couldn't be created.

If you use this method, you should treat the resulting bitmap NSBitmapImageRep object as read only. Because it only retains the value in the cgImage parameter, rather than unpacking the data, accessing the pixel data requires the creation of a copy of that data in memory. Changes to that data are not saved back to the Core Graphics image.

Available in OS X v10.5 and later.

See also:

• Constructor(data as Memoryblock)
• Constructor(pixelsWide as Integer, pixelsHigh as Integer, bitsPerSample as Integer, samplesPerPixel as Integer, hasAlpha as boolean, colorSpaceName as string, bytesPerRow as Integer, bitsPerPixel as Integer)

NSBitmapImageRepMBS.Constructor(pixelsWide as Integer, pixelsHigh as Integer, bitsPerSample as Integer, samplesPerPixel as Integer, hasAlpha as boolean, colorSpaceName as string, bytesPerRow as Integer, bitsPerPixel as Integer)

dim n as new NSImageMBS(300,300)
dim r as new NSBitmapImageRepMBS(300, 300, 8, 4, true, NSColorSpaceMBS.NSCalibratedRGBColorSpace, 4*300, 32)

dim g as new NSGraphicsMBS(r)
g.SetColorRGB 1.0,0,0,0.5
g.fillRect 0, 0, 100, 100
g = nil // flush
n.addRepresentation r

Backdrop = n.CopyPictureWithMask

The image bitmap data is allocated for you.

pixelsWide: The width of the image in pixels. This value must be greater than 0.
pixelsHigh: The height of the image in pixels. This value must be greater than 0.
bitsPerSample: The number of bits used to specify one pixel in a single component of the data. All components are assumed to have the same bits per sample. bps should be one of these values: 1, 2, 4, 8, 12, or 16.
samplesPerPixel: The number of data components, or samples per pixel. This value includes both color components and the coverage component (alpha), if present. Meaningful values range from 1 through 5. An image with cyan, magenta, yellow, and black (CMYK) color components plus a coverage component would have an spp of 5; a grayscale image that lacks a coverage component would have an spp of 1.
hasAlpha: True if one of the components counted in the number of samples per pixel (spp) is a coverage (alpha) component, and false if there is no coverage component. If true, the color components in the bitmap data must be premultiplied with their coverage component.
colorSpaceName: A string constant that indicates how data values are to be interpreted. It should be one of the following values: NSCalibratedWhiteColorSpace, NSCalibratedBlackColorSpace, NSCalibratedRGBColorSpace, NSDeviceWhiteColorSpace, NSDeviceBlackColorSpace, NSDeviceRGBColorSpace, NSDeviceCMYKColorSpace, NSNamedColorSpace or NSCustomColorSpace. (see NSColorSpaceMBS)
If bps is 12, you cannot specify the monochrome color space.
bytesPerRow: The number of bytes that are allocated for each scan line in each plane of data. A scan line is a single row of pixels spanning the width of the image.
Normally, rowBytes can be figured from the width of the image, the number of bits per pixel in each sample (bps), and, if the data is in a meshed configuration, the number of samples per pixel (spp). However, if the data for each row is aligned on word or other boundaries, it may have been necessary to allocate more memory for each row than there is data to fill it. rowBytes lets the object know whether that's the case.
If you pass in a rowBytes value of 0, the bitmap data allocated may be padded to fall on long word or larger boundaries for performance. If your code wants to advance row by row, use bytesPerRow and do not assume the data is packed. Passing in a non-zero value allows you to specify exact row advances.
bitsPerPixel: This integer value informs NSBitmapImageRep how many bits are actually allocated per pixel in each plane of data. If the data is in planar configuration, this normally equals bps (bits per sample). If the data is in meshed configuration, it normally equals bps times spp (samples per pixel). However, it's possible for a pixel specification to be followed by some meaningless bits (empty space), as may happen, for example, if pixel data is aligned on byte boundaries. NSBitmapImageRep supports only a limited number of pixelBits values (other than the default): for RGB images with 4 bps, pixelBits may be 16; for RGB images with 8 bps, pixelBits may be 32. The legal values for pixelBits are system dependent.
If you specify 0 for this parameter, the object interprets the number of bits per pixel using the values in the bps and spp parameters, as described in the preceding paragraph, without any meaningless bits.

On success the handle property is not zero.

You can add several NSBitmapImageRepMBS to NSImage to make a multi page tiff file.
To make a 300 dpi image, the size of the NSImage must be smaller than the size of the bitmap inside by factor 72/300.

See also:

• Constructor(data as Memoryblock)
• Constructor(pic as Picture)

NSBitmapImageRepMBS.GIFRepresentation(properties as dictionary = nil) as Memoryblock

NSBitmapImageRepMBS.JPEGRepresentation(properties as dictionary = nil) as Memoryblock

NSBitmapImageRepMBS.PNGRepresentation(properties as dictionary = nil) as Memoryblock

NSBitmapImageRepMBS.TIFFRepresentation as Memoryblock

This method invokes TIFFRepresentationUsingCompression using the stored compression type and factor retrieved from the initial image data or changed using setCompression. If the stored compression type isn't supported for writing TIFF data (for example, NSTIFFCompressionNEXT), the stored compression is changed to NSTIFFCompressionNone before invoking TIFFRepresentationUsingCompression. receiver, using the compression that's returned by getCompression (if applicable).

If a problem is encountered during generation of the TIFF, TIFFRepresentation raises an NSTIFFException or an NSBadBitmapParametersException.

See also:

• TIFFRepresentation(properties as dictionary = nil) as Memoryblock

NSBitmapImageRepMBS.TIFFRepresentation(properties as dictionary = nil) as Memoryblock

See also:

• TIFFRepresentation as Memoryblock

NSBitmapImageRepMBS.valueForProperty(key as string) as Variant

Value can be nil.
(Read and Write computed property)