to_byte_array method

to_byte_array()

Returns the property value as byte array.

def to_byte_array(self):
    ...

Remarks

Throws an exception if the property type is not PropertyType.BYTE_ARRAY.

Examples

Shows how to add a thumbnail to a document that we save as an Epub.

doc = aw.Document()
builder = aw.DocumentBuilder(doc)
builder.writeln("Hello world!")

# If we save a document, whose "thumbnail" property contains image data that we added, as an Epub,
# a reader that opens that document may display the image before the first page.
properties = doc.built_in_document_properties

with open(IMAGE_DIR + "Logo.jpg", "rb") as file:
    thumbnail_bytes = file.read()

properties.thumbnail = thumbnail_bytes

doc.save(ARTIFACTS_DIR + "DocumentProperties.thumbnail.epub")

# We can extract a document's thumbnail image and save it to the local file system.
thumbnail = doc.built_in_document_properties.get_by_name("Thumbnail")

with open(ARTIFACTS_DIR + "DocumentProperties.thumbnail.gif", "wb") as file:
    file.write(thumbnail.to_byte_array())

See Also