Link to the Bitmap Image Data object.
Also appears in: PowerFont Record, PowerFont, Library Polyline, Library Shape, Line, Rectangle, Circle/Ellipse, Pattern, Grid, Gradient, Gradient (As Fast Rectangle), Gradient (As Inverter), Library Bitmap Image, 3D Model
In general, this property represents the width of a line, shape or some other object in document units. Most objects assume a positive width. However, some objects (e.g. lines) can have either a positive or a negative width. In these cases, this property also indicates the direction.
This property may also be used for some other more specific purposes. For example, in PowerFonts it refers to the font's base width (or horizontal units per em-square). Similarly, in PowerFont records this property serves as the advance width of a glyph.
Sample values:
500 = Width of 500 document units
-200 = Width of -200 document units
Also appears in: PowerFont, Library Polyline, Library Shape, Line, Rectangle, Circle/Ellipse, Pattern, Grid, Gradient, Gradient (As Fast Rectangle), Gradient (As Inverter), Library Bitmap Image, 3D Model
In general, this property represents the height of a line, shape or other object in document units. Most objects assume a positive height. But some objects (e.g. lines) can have either a positive or a negative height. In these cases, the height property also indicates the direction.
This property may also be used for some other more specific purposes. For example, in PowerFonts this property refers to the font's base height (or vertical units per em-square).
Sample values:
400 = Height of 400 document units
-100 = Height of -100 document units
Also appears in: Library Bitmap Image
Transparency. The value 0 means minimum intensity, 255 means maximum intensity.
Sample values:
0 = Fully opaque
127 = 50% transparent
255 = Fully transparent
Also appears in: Library Bitmap Image
Quality.
Supported values:
0 = Low Quality But Fast
1 = High Quality But Slower
2 = Very High Quality But Slower
3 = Very High Quality (More Blur) But Slower
Also appears in: Library Bitmap Image
Edge smoothing for bitmap images. Respected only when the bitmap image's quality level is set to 1, 2 or 3.
Supported values:
0 = Edge smoothing is off
1 = Edge smoothing is on, inward (does not change the image boundary)
2 = Edge smoothing is on, outward (extends the image boundary by a small amount)
Also appears in: Library Bitmap Image
Initial and final intensity of red (2 bytes). Used for grayscale images.
Sample values:
"00 FF" = initial intensity is 0, final intensity is 255
"CC 0A " = initial intensity is 204, final intensity is 10
Also appears in: Library Bitmap Image
Background color bytes when edge smoothing is enabled (4 bytes). This property is respected only when edge smoothing is enabled, as follows:
- In RGBA images all 4 bytes are used; these 4 bytes represent the background color of an image. The color value is interpreted the same way as the color value of each individual pixel in the corresponding pdImageDataRGBAlpha property of the Bitmap Image Data object.
- In RGB images the first three bytes are used; these 3 bytes represent the background color of an image. The color value is interpreted the same way as the color value of each individual pixel in the corresponding pdImageDataRGB property of the Bitmap Image Data object. The fourth byte is unused and should be set to 255.
- In GA images the first two bytes are used; these 2 bytes represent the background color of an image. The color value is interpreted the same way as the color value of each individual pixel in the corresponding pdImageDataGrayAlpha property of the Bitmap Image Data object. The last two bytes are unused and should be set to 255.
- In G images only the first byte is used; this byte represent the background color of an image. The color value is interpreted the same way as the color value of each individual pixel in the corresponding pdImageDataGray property of the Bitmap Image Data object. The last three bytes are unused and should be set to 255.
In all cases, the pdOrderingArr property affects the used bytes the same way as it affects the corresponding bytes in the pdImageDataRGBAlpha, pdImageDataRGB, pdImageDataGrayAlpha and pdImageDataGray properties.
Also appears in: Library Bitmap Image
Initial and final intensity of green (2 bytes). Used for grayscale images.
Sample values:
"00 FF" = initial intensity is 0, final intensity is 255
"CC 0A " = initial intensity is 204, final intensity is 10
Also appears in: Library Bitmap Image
Initial and final intensity of blue (2 bytes). Used for grayscale images.
Sample values:
"00 FF" = initial intensity is 0, final intensity is 255
"CC 0A " = initial intensity is 204, final intensity is 10
For images that contain an alpha channel (pdImageDataGrayAlpha and pdImageDataRGBAlpha), this is the interpretation of the alpha channel. For monochrome images (pdImageDataMono) this is the interpretation of the bits (pixels) in each byte.
Supported values:
For GA and RGBA images
0 = Ignore the 2nd byte in GA images and 4th byte in RGBA images. Assuming that the channels are not reordered using the pdOrderingArr property, this will result in the alpha channel being ignored.
1 = Alpha channel represents transparency. This is true even if the channels are reordered using the pdOrderingArr property.
2 = Alpha channel represents opacity. This is true even even if the channels are reordered using the pdOrderingArr property.
For monochrome images
0 = Bits (pixels) in each byte are ordered left to right; 1 represent black, 0 represent white
1 = Bits (pixels) in each byte are ordered left to right; 1 represent white, 0 represent black
2 = Bits (pixels) in each byte are ordered right to left; 1 represent black, 0 represent white
3 = Bits (pixels) in each byte are ordered right to left; 1 represent white, 0 represent black
An array that specifies the order of the bytes (color channels) in each pixel in a bitmap image. This property works with all supported bitmap image formats that have at least 2 bytes (color channels) per pixel: pdImageDataGrayAlpha, pdImageDataRGB and pdImageDataRGBAlpha. It makes it possible to pass to D-Type Power Engine bitmap images in which individual pixels are stored using a pattern of GA, RGB or RGBA bytes in any order.
The number of elements in the array must equal bytes_per_pixel, where bytes_per_pixel is 2 for pdImageDataGrayAlpha, 3 for pdImageDataRGB and 4 for pdImageDataRGBAlpha. The value of each element is the index of the corresponding color channel in each pixel and must not be smaller than 0 or greater than bytes_per_pixel - 1.
If the size of the pdOrderingArr is not properly defined, D-Type Power Engine will not be able to display the bitmap image. It the value of some of the elements is out of range, D-Type Power Engine will display the image but will use the modulo bytes_per_pixel arithmetic to index the channels.
Sample values for pdImageDataGrayAlpha bitmap images:
0, 1 = G channel's index is 0, A channel's index is 1
1, 0 = G channel's index is 1, A channel's index is 0
Sample values for pdImageDataRGB bitmap images:
0, 1, 2 = R channel's index is 0, G channel's index is 1, B channel's index is 2
2, 1, 0 = R channel's index is 2, G channel's index is 1, B channel's index is 0
1, 2, 0 = R channel's index is 1, G channel's index is 2, B channel's index is 0
0, 2, 2 = R channel's index is 0, G channel's index is 2, B channel's index is 2 (in other words G and B color channels map to the same value)
1, 1, 1 = R channel's index is 1, G channel's index is 1, B channel's index is 1 (in other words all color channels map to the same value, resulting in grayscale output)
Sample values for pdImageDataRGBA bitmap images:
0, 1, 2, 3 = R channel's index is 0, G channel's index is 1, B channel's index is 2, A channel's index is 3
2, 1, 0, 3 = R channel's index is 2, G channel's index is 1, B channel's index is 0, A channel's index is 3
1, 2, 3, 0 = R channel's index is 1, G channel's index is 2, B channel's index is 3, A channel's index is 0
3, 2, 1, 0 = R channel's index is 3, G channel's index is 2, B channel's index is 1, A channel's index is 0
C/C++
INTEGRAL DSL