class final Core · roukmoute/pdf 0.6.2
PDF\Specification\Dictionary\TransparencyGroupAttributesDictionaryTable147\CSEntryTable 147, /CS; PDF type: name or array; Sometimes required.Inheritance and contracts
Parent : PDF\Specification\SchemaEntry
Definition in the specification
Table 147 · Additional entries specific to a transparency group attributes dictionary
ISO 32000-1:2008, §11.6.6 · PDF page 358 ↗
/CS name or array
(Sometimes required) The group colour space, which is used for the following purposes: • As the colour space into which colours shall be converted when painted into the group • As the blending colour space in which objects shall be composited within the group (see “Blending Colour Space”) • As the colour space of the group as a whole when it in turn is painted as an object onto its backdrop The group colour space shall be any device or CIE-based colour space that treats its components as independent additive or subtractive values in the range 0.0 to 1.0, subject to the restrictions described in 11.3.4, "Blending Colour Space." These restrictions exclude Lab and lightness- chromaticity ICCBased colour spaces, as well as the special colour spaces Pattern, Indexed, Separation, and DeviceN. Device colour spaces shall be subject to remapping according to the DefaultGray, DefaultRGB, and DefaultCMYK entries in the ColorSpace subdictionary of the current resource dictionary (see “Default Colour Spaces”). Ordinarily, the CS entry may be present only for isolated transparency groups (those for which I is true), and even then it is optional. However, this entry shall be present in the group attributes dictionary for any transparency group XObject that has no parent group or page from which to inherit—in particular, one that is the value of the G entry in a soft-mask dictionary of subtype Luminosity (see “Soft-Mask Dictionaries”). Additionally, the CS entry may be present in the group attributes dictionary associated with a page object, even if I is false or absent. In the normal case in which the page is imposed directly on the output medium, the page group is effectively isolated regardless of the I value, and the specified CS value shall therefore be honoured. But if the page is in turn used as an element of some other page and if the group is non- isolated, CS shall be ignored and the colour space shall be inherited from the actual backdrop with which the page is composited (see “Page Group”). Default value: the colour space of the parent group or page into which this transparency group is painted. (The parent’s colour space in turn may be either explicitly specified or inherited.) For a transparency group XObject used as an annotation appearance (see “Appearance Streams”), the default colour space shall be inherited from the page on which the annotation appears.
Qualifier: Sometimes required
Conditional descriptions remain traceable. A definition alone does not implement a codec, a signature or every format mechanism. Read the coverage.
Construction
__construct()
public function __construct(PDF\Syntax\Object\NameType|PDF\Syntax\Object\ArrayType|PDF\Syntax\Object\IndirectReference $value)Inherited methods
3 methods from parents and contracts
definition()
public function definition(): PDF\Specification\EntryDefinitionkey()
public function key(): PDF\Syntax\Object\NameTypevalue()
public function value(): PDF\Syntax\FileStructure\BasicTypeProperties
| Declaration | Origin and documentation |
|---|---|
public readonly PDF\Syntax\Object\NameType $key | PDF\Syntax\Object\DictionaryObject\Entry |
public readonly PDF\Syntax\FileStructure\BasicType $value | PDF\Syntax\Object\DictionaryObject\Entry |
Constants
| Name | PHP value | Origin |
|---|---|---|
KEY | | PDF\Specification\Dictionary\TransparencyGroupAttributesDictionaryTable147\CSEntry |
TABLE | | PDF\Specification\Dictionary\TransparencyGroupAttributesDictionaryTable147\CSEntry |
VARIABLE | | PDF\Specification\SchemaEntry |