Document files

class djvu.decode.DocumentFiles

Component files of a document.

Use Document.files to obtain instances of this class.

File indexing is zero-based, i.e. files[0] stands for the first file.

len(files) might raise NotAvailable when called before receiving a DocInfoMessage.

class djvu.decode.File

Component file of a document.

Use Document.files[N] to obtain instances of this class.

document
Return type:

Document

n
Returns:

the component file number.

File indexing is zero-based, i.e. 0 stands for the very first file.

get_info([wait=1])

Attempt to obtain information about the component file.

If wait is true, wait until the information is available.

Raises:
type
Returns:

the type of the compound file.

The following types are possible:

FILE_TYPE_PAGE
FILE_TYPE_THUMBNAILS
FILE_TYPE_INCLUDE
Raises:
n_page
Returns:

the page number, or None when not applicable.

Page indexing is zero-based, i.e. 0 stands for the very first page.

Raises:
page
Returns:

the page, or None when not applicable.

Raises:
size
Returns:

the compound file size, or None when unknown.

Raises:
id
Returns:

the compound file identifier, or None.

Raises:
name
Returns:

the compound file name, or None.

Raises:
title
Returns:

the compound file title, or None.

Raises:
dump
Returns:

a text describing the contents of the file using the same format as the djvudump command.

If the information is not available, raise NotAvailable exception. Then, PageInfoMessage messages with empty page_job may be emitted.

Raises:

NotAvailable – see above.