Extract Subfiles

To convert all files in a container file, the container must be opened and its subfiles extracted to either a file or a stream using the File Extraction API. The extraction process is done repeatedly until all subfiles are extracted and exposed for conversion. Once a subfile is extracted, you can call Export API methods to convert the data.

If you require a container file, including subfiles, to be converted to a single file, you must extract all files from the container, convert the files, and then append each converted output to its parent.

To extract subfiles, follow this general procedure

  1. Open the source file by calling the extOpenDocument method. This call defines the parameters necessary to open a file for extraction.

  2. Determine whether the main file is a container file (contains subfiles) by calling the extGetMainFileInfo() method.

  3. If the call to extGetMainFileInfo() determined the source file is a container file, proceed to Determine whether the subfile is itself a container (contains subfiles) by calling the extGetSubFileInfo method.; otherwise, convert the file.

  4. Determine whether the subfile is itself a container (contains subfiles) by calling the extGetSubFileInfo method.

  5. Extract the subfile by calling the extExtractSubFile method.

  6. If the call to extGetSubFileInfo determined the subfile is a container file, repeat Open the source file by calling the extOpenDocument method. This call defines the parameters necessary to open a file for extraction. through Extract the subfile by calling the extExtractSubFile method. until all subfiles are extracted and the lowest level of subfiles is reached; otherwise, convert the file.


_HP_HTML5_bannerTitle.htm