ImagePart

Contents of this package part as a sequence of bytes.

May be text or binary. Intended to be overridden by subclasses. Default behavior is to return load blob.

Content type of this part.

Native width of this image, calculated from its width in pixels and horizontal dots per inch (dpi).

Native height of this image, calculated from its height in pixels and vertical dots per inch (dpi).

Filename from which this image part was originally created.

A generic name, e.g. 'image.png', is substituted if no name is available, for example when the image was loaded from an unnamed stream. In that case a default extension is applied based on the detected MIME type of the image.

OpcPackage instance this part belongs to.

PackURI instance holding partname of this part, e.g. '/ppt/slides/slide1.xml'.

Dictionary mapping related parts by rId, so child objects can resolve explicit relationships present in the part XML, e.g. sldIdLst to a specific Slide instance.

Relationships instance holding the relationships for this part.

SHA1 hash digest of the blob of this image part.

Entry point for post-unmarshaling processing, for example to parse the part XML.

May be overridden by subclasses without forwarding call to super.

Entry point for pre-serialization processing, for example to finalize part naming if necessary.

May be overridden by subclasses without forwarding call to super.

Remove the relationship identified by rId if its reference count is less than 2.

Relationships with a reference count of 0 are implicit relationships.

Return an ImagePart instance newly created from image and assigned partname.

Called by docx.opc.package.PartFactory to load an image part from a package being opened by Document(...) call.

Return newly added _Relationship instance of reltype.

The new relationship relates the target part to this part with key rId.

Target mode is set to RTM.EXTERNAL if is_external is True. Intended for use during load from a serialized package, where the rId is well-known. Other methods exist for adding a new relationship to a part when manipulating a part.

Return part to which this part has a relationship of reltype.

Raises KeyError if no such relationship is found and ValueError if more than one such relationship is found. Provides ability to resolve implicitly related part, such as Slide -> SlideLayout.

Return rId key of relationship of reltype to target.

The returned rId is from an existing relationship if there is one, otherwise a new relationship is created.

Return URL contained in target ref of relationship identified by rId.