|
Gets a resource from the resources dictionary.
Resources are cached for fast lookup of repeated requests. If
you change the resources of a Page or Form XObject after looking
them up, call ClearCache so that
subsequent lookups reflect the change.
The ResourceType enumeration may take the following values:
- ExtGState - External graphics states.
- ColorSpace - Color space for graphics.
- Pattern - Pattern for filling areas.
- Shading - Shading type for filling areas.
- XObject - Encapsulated image in raster or vector form.
- Font - Font typeface for drawing text.
- ProcSet - Predefined procedure sets. This property is
deprecated in the PDF specification.
- Properties - Marked content properties.
Almost all Form XObjects hold all the resources they use, so in
practice you can look resources up in the owner of the stream
alone. However, the PDF specification does allow a Form XObject to
omit some or all of its resources and take them from the content
stream in which it appears - the page, or another Form XObject
which draws it. This is a legacy of very early versions of PDF and
is rare.
To find such resources, pass the call chain. This starts with
the owner of the stream which references the resource, followed by
the owner of the stream which invokes it, and so on, typically
ending with the page. The first one which holds the resource is
used. When processing content using a ContentStreamScanner,
the Owners
stack holds the call chain in exactly this order, so you can pass
it directly.
|