fallback_font_name property

PclSaveOptions.fallback_font_name property

Name of the font that will be used if no expected font is found in printer and built-in fonts collections.

@property
def fallback_font_name(self) -> str:
    ...

@fallback_font_name.setter
def fallback_font_name(self, value: str):
    ...

Remarks

If no fallback is found, a warning is generated and “Arial” font is used.

Examples

Shows how to declare a font that a printer will apply to printed text as a substitute should its original font be unavailable.

doc = aw.Document()
builder = aw.DocumentBuilder(doc)

builder.font.name = "Non-existent font"
builder.write("Hello world!")

save_options = aw.saving.PclSaveOptions()
save_options.fallback_font_name = "Times New Roman"

# This document will instruct the printer to apply "Times New Roman" to the text with the missing font.
# Should "Times New Roman" also be unavailable, the printer will default to the "Arial" font.
doc.save(ARTIFACTS_DIR + "PclSaveOptions.fallback_font_name.pcl", save_options)

See Also