DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

SWFTOOLS for Linux

Author:Kasper Skårhøj
Created:2002-11-01T00:32:00
Changed by:Dirk Wildt
Changed:2013-02-05T12:32:43
Classification:swftools4linux
Description:SWFTOOLS for Linux: Install SWFTOOLS on a LINUX server. You must be root.
Keywords:forDevelopers, forIntegrators, swftools, swf, tools, flash, linux
Author:Dirk Wildt, Die Netzmacher
Email:http://wildt.at.die-netzmacher.de
Website:http://die-netzmacher.de
Language:en

img-1 img-2 extKey: swftools4linux img-3

SWFTOOLS for Linux

SWFTOOLS for Linux: Install SWFTOOLS on a LINUX server. You must be root.

img-4

Version: 0.0.3, 2013-02-05

Extension Key: swftools4linux

Language: en

Keywords: forDevelopers, forIntegrators, swftools, swf, tools, flash, linux

Copyright 2012-2013, Dirk Wildt, Die Netzmacher, <http://wildt.at.die- netzmacher.de>

This document is published under the Open Content License

available from http://www.opencontent.org/opl.shtml

The content of this document is related to TYPO3

- a GNU/GPL CMS/Framework available from www.typo3.org

Introduction

What does SWFTOOLS for Linux do?

  • SWFTOOLS for Linux delivers the source code for the installation of SWFTTOOLS on a Linux server.If you are using a Windows server, please refer to SWFTOOLS for Windows.
  • The manual explains step by step, how to install SWFTOOLS on a Linux server.
  • It describes too, how to uninstall SWFTOOLS.

Why SWFTOOLS?

  • SWFTOOLS can convert JPEG, PDF, PNG and WAV files to SWF / Flash filies.
  • You need SWFTOOLS, if you are using the extension Flip it! and you want, that Flip it! converts PDF filesto SWF / Flash files automatically.

What do you need?

  • You must be root, if you want to install SWFTOOLS on your server.
  • You don't need special know how about Linux.

Quick Installation

Install SWFTOOLS.

Installation

Check, if SWFTOOLS are installed

If SWFTOOLS are installed, please don't install it again.

Please don't work as root.

wwwrun@server:~> pdf2swf --version

pdf2swf - part of swftools 0.9.2www@server: ../swftools4linux/lib> cd swftools-0.9.2_fixed/

If the command returns a result like in the code snippet above, SWFTOOLS are installed.

Than there is noting to do – please don't install SWFTOOLS again.

Install swfttools4linux

Install this extension.

Unpack the Archive

Please don't work as root.

Move to the directory with the installer archive, unpack the archive and move to the installer directory.

www@server: .. > cd /typo3conf/ext/swftools4linux/lib/

www@server: ../swftools4linux/lib> tar -xzf swftools-0.9.2_fixed.tar.gz

www@server: ../swftools4linux/lib> cd swftools-0.9.2_fixed/

Configure the Package

Individual Needs

If there are needs for an individual configuration please refer to the file

swftools-0.9.2_fixed/INSTALL

Workflow

Check Requirements

Check if the configure file is executable. If not, change the mode (chmod) to executable.

www@server: ../swftools4linux/lib/swftools-0.9.2_fixed> ls -al configure

-rwxr-xr-x 1 wwwrun www 5598 12. Nov 2010 configure

Prepare the software for installation:

www@server: ../swftools4linux/lib/swftools-0.9.2 > ./configure

...

a lot of prompts ...

...

www@server: ../swftools4linux/lib/swftools-0.9.2_fixed> make

...

a lot of prompts ...

...

Installation

Login as root. Install it!

server: ../swftools4linux/lib/swftools-0.9.2_fixed> su

Password: ********

www@server: ../swftools4linux/lib/swftools-0.9.2_fixed # make install

...

a lot of prompts ...

...

Success?

Please don't work as root.

Check the version of one tool:

www@server: ../swftools4linux/lib/swftools-0.9.2_fixed # pdf2swf --version

pdf2swf - part of swftools 0.9.2

Prompt the list with the installed tools:

www@server: ../swftools4linux/lib/swftools-0.9.2_fixed # ls -1 /usr/local/bin/

as3compile

font2swf

jpeg2swf

pdf2swf

png2swf

swfbbox

swfc

swfcombine

swfdump

swfextract

swfrender

swfstrings

wav2swf

Remove Source-Code

If you remove the source-code, you can't deinstall the installed software without a new installation.

If you like to deinstall the software before removing the source-code, please refer to "Deinstallation" on page 8 below.

server: ../swftools4linux/lib # su www

www@server: ../swftools4linux/lib# rm -Rf swftools-0.9.2_fixed

Deinstallation

Requirements

You can deinstall the software only

  • if you have installed the software successfully and
  • if the configuration files are existent.
What to do in case of missing configuration files?

If the configuration files are missing, you can deinstall the software if you have reinstalled before. If you like to reinstall the software please refer to "Installation" on page 6 above.

Workflow

You must be root.

server: ../swftools4linux/lib/swftools-0.9.2_fixed # make uninstall

server: ../swftools4linux/lib/swftools-0.9.2_fixed # su www

www@server: ../swftools4linux/lib/swftools-0.9.2_fixed> make clean

...

a lot of prompts ...

www@server: ../swftools4linux/lib/swftools-0.9.2_fixed> make distclean

...

a lot of prompts ...

Success?

Please don't work as root.

Check the version of one tool:

www@server: ../swftools4linux/lib/swftools-0.9.2_fixed # pdf2swf --version

pdf2swf - part of swftools 0.9.2

Prompt the list with the installed tools:

www@server: ../swftools4linux/lib/swftools-0.9.2_fixed # ls -1 /usr/local/bin/

as3compile

font2swf

jpeg2swf

pdf2swf

png2swf

swfbbox

swfc

swfcombine

swfdump

swfextract

swfrender

swfstrings

wav2swf

Remove the source files

Please don't work as root.

Check the version of one tool:

www@server: ../swftools4linux/lib # rm -Rf swftools-0.9.2_fixed

Remove this extension

Disable and delete this extension with the extension manager.

Properties

Please refer to

http://www.swftools.org/pdf2swf_usage.html

jpeg2swf

wwwrun@server:/usr/local/bin> jpeg2swf --help

Usage: jpeg2swf [-options [value]] imagefiles[.jpg]|[.jpeg] [...]

-o , --output <outputfile> Explicitly specify output file. (otherwise, output.swf will be used)

-q , --quality <quality> Set compression quality (1-100, 1=worst, 100=best)

-r , --rate <framerate> Set movie framerate (frames per second)

-z , --zlib <zlib> Enable Flash 6 (MX) Zlib Compression

-M , --mx Use Flash MX H.263 compression (use for correlated images)

-x , --xoffset <offset> horizontally offset images by <offset>

-y , --yoffset <offset> vertically offset images by <offset>

-X , --width <width> Force movie width to <width> (default: autodetect)

-Y , --height <height> Force movie height to <height> (default: autodetect)

-T , --flashversion <version> Set flash file version to <version>

-v , --verbose <level> Set verbose level to <level> (0=quiet, 1=default, 2=debug)

-V , --version Print version information and exit

-f , --fit-to-movie Fit images to movie size

-e , --export <assetname> Make importable as asset with <assetname>

pdf2swf

wwwrun@server:/usr/local/bin> pdf2swf --help

Usage: pdf2swf [-options] file.pdf -o file.swf

-h , --help Print short help message and exit

-V , --version Print version info and exit

-o , --output file.swf Direct output to file.swf. If file.swf contains '%' (file%.swf),then each page goes to a separate file.

-p , --pages range Convert only pages in range with range e.g. 1-20 or 1,4,6,9-11 or

-P , --password password Use password for deciphering the pdf.

-v , --verbose Be verbose. Use more than one -v for greater effect.

-z , --zlib Use Flash 6 (MX) zlib compression.

-i , --ignore Allows pdf2swf to change the draw order of the pdf.This may make the generated

-j , --jpegquality quality Set quality of embedded jpeg pictures to quality. 0 is worst(small), 100 is best (big). (default:85)

-s , --set param=value Set a SWF encoder specific parameter. See pdf2swf -s help for

more information.

-w , --samewindow When converting pdf hyperlinks, don't make the links opena new window.

-t , --stop Insert a stop() command in each page.

-T , --flashversion num Set Flash Version in the SWF header to num.

-F , --fontdir directory Add directory to the font search path.

-b , --defaultviewer Link a standard viewer to the swf file.

-l , --defaultloader Link a standard preloader to the swf file which will be displayedwhile the main swf is loading.

-B , --viewer filename Link viewer filename to the swf file.

-L , --preloader filename Link preloader filename to the swf file.

-q , --quiet Suppress normal messages. Use -qq to suppress warnings, also.

-S , --shapes Don't use SWF Fonts, but store everything as shape.

-f , --fonts Store full fonts in SWF. (Don't reduce to used characters).

-G , --flatten Remove as many clip layers from file as possible.

-I , --info Don't do actual conversion, just display a list of all pagesin the PDF.

-Q , --maxtime n Abort conversion after n seconds. Only available on Unix.

param

wwwrun@server:/usr/local/bin> pdf2swf -s help

PDF Parameters:

PDF device global parameters:

fontdir=<dir> a directory with additional fonts

font=<filename> an additional font filename

pages=<range> the range of pages to convert (example: pages=1-100,210-)

zoom=<dpi> the resultion (default: 72)

languagedir=<dir> Add an xpdf language directory

multiply=<times> Render everything at <times> the resolution

poly2bitmap Convert graphics to bitmaps

bitmap Convert everything to bitmaps

SWF Parameters:

SWF layer options:

jpegsubpixels=<pixels> resolution adjustment for jpeg images (same as jpegdpi, but in pixels)

ppmsubpixels=<pixels resolution adjustment for lossless images (same as ppmdpi,but in pixels)

subpixels=<pixels> shortcut for setting both jpegsubpixels and ppmsubpixels

drawonlyshapes convert everything to shapes (currently broken)

ignoredraworder allow to perform a few optimizations for creating smaller SWFs

linksopennewwindow make links open a new browser window

linktarget target window name of new links

linkcolor=<color) color of links (format: RRGGBBAA)

linknameurl Link buttons will be named like the URL they refer to(handy for iterating through links with actionscript)

storeallcharacters don't reduce the fonts to used characters in the output file

enablezlib switch on zlib compression (also done if flashversion>=6)

bboxvars store the bounding box of the SWF file in actionscript variables

dots Take care to handle dots correctly

reordertags=0/1 (default: 1) perform some tag optimizations

internallinkfunction=<name> when the user clicks a internal link (to a different page)

in the converted file, this actionscript function is called

externallinkfunction=<name> when the user clicks an external link (e.g. http://www.foo.bar/)

on the converted file, this actionscript function is called

disable_polygon_conversion never convert strokes to polygons (will remove capstyles

and joint styles)

caplinewidth=<width> the minimum thichness a line needs to have so that capstyles

become visible (and are converted)

insertstop put an ActionScript "STOP" tag in every frame

protect add a "protect" tag to the file, to prevent loading in the Flash editor

flashversion=<version> the SWF fileversion (6)

framerate=<fps> SWF framerate

minlinewidth=<width> convert horizontal/vertical boxes smaller than this width

to lines (0.05)

simpleviewer Add next/previous buttons to the SWF

animate insert a showframe tag after each placeobject

(animate draw order of PDF files)

jpegquality=<quality> set compression quality of jpeg images

splinequality=<value> Set the quality of spline convertion to value (0-100, default: 100).

disablelinks Disable links.

png2swf

wwwrun@server:/usr/local/bin> png2swf --help

Usage: png2swf [-X width] [-Y height] [-o file.swf] [-r rate] file1.png [file2.png...]

-r , --rate <framerate> Set movie framerate (frames per second)

-o , --output <filename> Set name for SWF output file.

-j , --jpeg <quality> Generate a lossy jpeg bitmap inside the SWF,with a given quality (1-100)

-z , --zlib <zlib> Enable Flash 6 (MX) Zlib Compression

-T , --flashversion Set the flash version to generate

-X , --pixel <width> Force movie width to <width> (default: autodetect)

-Y , --pixel <height> Force movie height to <height> (default: autodetect)

-v , --verbose <level> Set verbose level (0=quiet, 1=default, 2=debug)

-q , --quiet Omit normal log messages, only log errors

-C , --cgi For use as CGI- prepend http header, write to stdout

-V , --version Print version information and exit

-s , --scale <percent> Scale image to <percent>

FAQ

This is a fixed version. What's fixed?

The installer tries to install the files

  • swfs/default_viewer.swf
  • swfs/default_loader.swf

but the files aren't part of the current SWFTOOLS version.

This failure is fexied.

If you like to know more about the fix, please refer to the file BUGFIX.

Known Bugs

There isn't any known bug.

To-Do List

Nothing to do.

Further Information

Other extensions published by Die Netzmacher

  • img-5 autositemap: A smart site-map optimised for the footer. It groups menus in columns. Great menus will get two columns. Configuration is based on TypoScript HMENU. http://typo3.org/extensions/repository/view/autositemap/
  • img-6 Browser – TYPO3 without PHP. Develop your TYPO3 extension 8 times faster! You need 1 line TypoScript for a result list with a search form, a record browser and an index browser. Images are wrapped self-acting. SEO, Search Engine Optimization, is integrated. http://typo3.org/extensions/repository/view/browser/
  • img-7 Flip it! Flip it! enables you to run over pages in PDF documents and magazines. Flip it! offers lovely and smooth page flip transitions. The visitor of your website does not need any PDF plugin but a Flash plugin. http://typo3.org/extensions/repository/view/flipit/
  • img-8 Green Cars (Grüne Autos) - Database optimized for ecological cars. It is a case study and demonstrates, how to get a complex database with the Browser in three hours only. http://gruene- autos.org/
  • img-9 Jobmarket is a catalogue with job offers. Views, the a-z-browser, the page-browser, the search, social bookmarks and a lot of other stuff can configured by the Browser plugin with the mouse. Job Market hasn't any PHP code, it should be easy to adapt it to your needs. http://typo3-job-market.de/

img-10 Majordomo: For subcribing to and unsubscribing from a majordomo mailing list. http://typo3.org/extensions/repository/view/majordomo/

  • img-11 Organiser provides a lot of features for handle news, events, staff, headquarters, locations, repertoire, workshops and a calendar. Sell your online tickets! Available from April of 2011 http://typo3-organiser.de/
  • img-12 Quick Shop (extkey: quick_shop): The fastest shop in the history of TYPO3. Install it with one mouse click only! Quick Shop is based on the Browser and powermail. http://typo3-quick-shop.de/
  • img-13 PDF Controller: Easy to install. Add to your HTML page the PDF-controller-button. Link from the button to the controller. Adjust the controller by mouseclicks. The PDF Controller supports CSS 3. http://typo3-pdfcontroller.de/
  • img-14 seo_dynamic_tag: Search Engine Optimisation. You can generate values dynamically with this extension especially for the <title>-tag, for the <meta>-tag description and the <meta>-tag keywords. http://typo3.org/extensions/repository/view/seo_dynamic_tag /
  • img-15 TSconfig Pages and Users by extManager (extkey: tsconf): Configure the the eight most commonly used TSconfig porperties with the mouse - like page tree uids, activated extended view, activated clipboard, ... http://typo3.org/extensions/repository/view/tsconf/
  • img-16 tt_news select configuration (extkey: ttnews_selectconf) enables to select tt_news by any SQL clause. The extension adds an andWhere clause to the SQL query of the tt_news plugin. I. e. it is possible to display tt_news items in dependence on the ownership of a fe_user. http://typo3.org/extensions/repository/view/ttnews_selectconf/
  • img-17 Wine Catalogue provides a data base for wine with regions, wineries, styles, variety and ageing among others. It is localized. English, German and Spanish ist of the box. Wine based on the extension Browser. http://typo3-wine.de/

Change Log

0.0.3 Update Manual

0.0.2 Development

0.0.1 Initial release

16