Working with Artifacts in Python via .NET

Contents
[ ]

Artifacts in PDF are graphics objects or other elements that are not part of the actual content of the document. They are usually used for decoration, layout, or background purposes. Examples of artifacts include page headers, footers, separators, or images that do not convey any meaning.

The purpose of artifacts in PDF is to allow the distinction between content and non-content elements. This is important for accessibility, as screen readers and other assistive technologies can ignore artifacts and focus on the relevant content. Artifacts can also improve the performance and quality of PDF documents, as they can be omitted from printing, searching, or copying.

To create an element as an artifact in PDF, you need to use the Artifact class. It contains following useful properties:

  • custom_type - Gets name of artifact type. May be used if artifact type is non standard.
  • custom_subtype - Gets name of artifact subtype. May be used if artifact subtype is not standard subtype.
  • type - Gets artifact type.
  • subtype - Gets artifact subtype. If artifact has non-standard subtype, name of the subtype may be read via CustomSubtype.
  • contents - Gets collection of artifact internal operators.
  • form - Gets XForm of the artifact (if XForm is used).
  • rectangle - Gets rectangle of the artifact.
  • position - Gets or sets artifact position. If this property is specified, then margins and alignments are ignored.
  • right_margin - Right margin of artifact.If position is specified explicitly (in Position property) this value is ignored.
  • left_margin - Left margin of artifact.If position is specified explicitly (in Position property) this value is ignored.
  • top_margin - Top margin of artifact. If position is specified explicitly (in Position property) this value is ignored.
  • bottom_margin - Bottom margin of artifact.If position is specified explicitly (in Position property) this value is ignored.
  • artifact_horizontal_alignment - Horizontal alignment of artifact. If position is specified explicitly (in Position property) this value is ignored.
  • artifact_vertical_alignment - Vertical alignment of artifact. If position is specified explicitly (in Position property) this value is ignored.
  • rotation - Gets or sets artifact rotation angle.
  • text - Gets text of the artifact.
  • image - Gets image of the artifact (if presents).
  • opacity - Gets or sets opacity of the artifact. Possible values are in range 0..1.
  • lines - Lines of multiline text artifact.
  • text_state - Text state for artifact text.
  • is_background - If true Artifact is placed behind page contents.

The following classes may also be useful for work with artifacts:

Please review the following sections of the article:

Working with Attachments in PDF using Python Accessibility and Tagged PDFs via Python