Configuring SWFTools

By default the application comes with a Tomcat bundle with pre-configured SWFTools.

Caution

In most cases it is not necessary to install SWFTools on your server. Only if it presents some problem with the pre-configured SWFTools in the Tomcat bundle.

Note

The application takes advantage of SWFTools to convert PDF documents to SWF to be shown in the UI preview tab.

See FlexPaper: Converting Documents for more info.

Ubuntu

sudo add-apt-repository ppa:guilhem-fr/swftools
sudo apt-get update
sudo apt-get install swftools

Improving performance

For better performance, use this configuration.

Property	Description
system.swftools.pdf2swf	The Pdf2swf tool is used to convert PDF documents to SWF. /usr/bin/pdf2swf -T 9 -f -t -G -s storeallcharacters ${fileIn} -o ${fileOut}

The parameters specify that:

• -f : Fonts should be embedded; this improves searchability in the document
• -t : Inserts a stop between each frame; this improves stability
• -G : Makes the document smaller and faster to render
• -s storeallcharacters : Stores all character information about the text in the document; this improves searchability

Red Hat and CentOS

It is better to compile version 0.9.x

yum install zlib-devel libjpeg-devel giflib-devel freetype-devel gcc gcc-c++
wget http://www.swftools.org/swftools-0.9.1.tar.gz
tar xzf swftools-0.9.1.tar.gz
cd swftools-0.9.1
./configure --prefix=/usr/local
make
make install

Improving performance

For better performance, use this configuration.

Property	Description
system.swftools.pdf2swf	The Pdf2swf tool is used to convert PDF documents to SWF. /usr/bin/pdf2swf -T 9 -f -t -G -s storeallcharacters ${fileIn} -o ${fileOut}

The parameters specify that:

• -f : Fonts should be embedded; this improves searchability in the document
• -t : Inserts a stop between each frame; this improves stability
• -G : Makes the document smaller and faster to render
• -s storeallcharacters : Stores all character information about the text in the document; this improves searchability

Note

Take a look at pdf2swf wiki for the complete parameters reference.

Debian

This package is not included in the Debian repositories, so you need to compile it from source:

aptitude install build-essential libgif-dev xpdf libfreetype6 libfreetype6-dev libjpeg62 libjpeg8 libjpeg8-dev
wget http://www.swftools.org/swftools-0.9.1.tar.gz
tar xzf swftools-0.9.1.tar.gz
cd swftools-0.9.1
./configure --prefix=/usr/local
make
make install

Note

Or you can try installing the Ubuntu package.

Note

Take a look at pdf2swf wiki for the complete parameters reference.

Improving performance

For better performance, use this configuration.

Property	Description
system.swftools.pdf2swf	The Pdf2swf tool is used to convert PDF documents to SWF. /usr/bin/pdf2swf -T 9 -f -t -G -s storeallcharacters ${fileIn} -o ${fileOut}

The parameters specify that:

• -f : Fonts should be embedded; this improves searchability in the document
• -t : Inserts a stop between each frame; this improves stability
• -G : Makes the document smaller and faster to render
• -s storeallcharacters : Stores all character information about the text in the document; this improves searchability

Windows

Download the latest SWFTools http://www.swftools.org/download.html and install it (for example at c:\tomcat-8.5.69\tools\swftools).

Improving performance

For better performance, use this configuration.

Property	Description
system.swftools.pdf2swf	The Pdf2swf tool is used to convert PDF documents to SWF. c:\tomcat-8.5.69\tools\swftools\pdf2swf.exe -T 9 -f -t -G -s storeallcharacters ${fileIn} -o ${fileOut}

The parameters specify that:

• -f : Fonts should be embedded; this improves searchability in the document
• -t : Inserts a stop between each frame; this improves stability
• -G : Makes the document smaller and faster to render
• -s storeallcharacters : Stores all character information about the text in the document; this improves searchability

Note

Take a look at pdf2swf wiki for the complete parameters reference.

Troubleshooting

Conversion problems with big files

If the document is large (has many pages) or is complex, the conversion may fail with this error:

Danger

ERROR   ID Table overflow

ERROR   This file is too complex to render - SWF only supports 65536 shapes at once

You can work around this error by adding the -s poly2bitmap parameter, which converts graphics to bitmaps:

Property	Description
system.swftools.pdf2swf	/usr/bin/pdf2swf -T 9 -f -t -G -s poly2bitmap -s storeallcharacters ${fileIn} -o ${fileOut}

Segmentation fault (core dumped)

This is a log of a segmentation fault error:

/home/openkm/tomcat-8.5.69/bin/pdf2swf -f -T 9 -t -s storeallcharacters input.pdf -o output.swf
NOTICE  processing PDF page 1 (878x1105:0:0) (move:0:0)
NOTICE  File contains forms
NOTICE  File contains pbm pictures
NOTICE  File contains soft masks
WARNING multiply blended transparency groups not yet supported!
NOTICE  File contains transparency groups
Segmentation fault (core dumped)

You can try the -s poly2bitmap or -s bitmap arguments. In our experience, the bitmap option is more reliable for fixing display issues, but of course it may decimate text and, in some cases, increase file size and processing time. You can also add the -s multiply=4 bitmap argument to get a really crisp bitmap output, further increasing size and processing time, but getting you pretty close to the original PDF.

/home/openkm/tomcat-8.5.69/bin/pdf2swf -f -T 9 -t -s bitmap -s storeallcharacters input.pdf -o output.swf
NOTICE  processing PDF page 1 (878x1105:0:0) (move:0:0)
NOTICE  Writing SWF file output.swf

Error with copy-protected PDF

Perhaps the PDF is copy-protected. Therefore, you’re not allowed to convert it.

Danger

FATAL   PDF disallows copying

If you created this PDF using Acrobat Distiller, try switching the copy protection checkbox off. If you can’t disable the protection, you can modify the ‘pdf2swf’ source code to disable this check (see http://www.foolabs.com/xpdf/cracking.html).

Note

The pre-configured pdf2swf tool in the Tomcat bundle comes with this hack.