Experimental
The color definition found beside an imported JPEG’s bytes.
A mask or nonempty color key requires decoding the base JPEG at its original size. The base JPEG must contain at most 67,108,864 pixels, independently of the mask’s limits. Larger base images fail to decode.
Properties#
| Property | Type | Description |
|---|---|---|
colorSpace |
ImportedImageColorSpace |
Experimental The color space the engine decodes the samples in. ICCBased requires iccProfile. |
declaredColorSpace? |
ImportedImageColorSpace |
Experimental The color space the source file names. Defaults to colorSpace and does not change rendering. ICCBased is allowed only when colorSpace is ICCBased. |
iccProfile? |
Uint8Array |
Experimental Gray, RGB or CMYK ICC profile bytes. Required for ICCBased and not allowed otherwise. |
decode? |
number[] |
Experimental PDF /Decode ranges: a minimum and a maximum per component. A sample of 0 maps to the minimum and 255 to the maximum, clamped to [0, 1]. Omit for the identity mapping. |
colorTransform? |
number |
Experimental PDF /ColorTransform: 0 reads the samples as stored, 1 converts them from YCbCr or YCCK. Omit to follow the JPEG header. |
renderingIntent? |
ColorRenderingIntent |
Experimental The rendering intent for this image. Omit to use the scene’s rendering intent. |
importerRecord? |
string |
Experimental Data the importer keeps with the definition, at most 64 KiB. The engine does not read it. |
importerRecordFormat? |
string |
Experimental The format of importerRecord. Required when a record is present. |
colorKeyMask? |
number[] |
Experimental Inclusive integer ranges in [0, 255], one ordered low/high pair per source component. Applied before /Decode and resizing. An empty array means no color key. |
mask? |
ImportedImageMaskInput |
Experimental An owned stencil or soft mask. Soft masks replace colorKeyMask on assignment. Stencil masks cannot coexist with nonempty colorKeyMask. Unreadable mask resources are skipped when rendering. |