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 |
extKey: swftools4linux
SWFTOOLS for Linux¶
SWFTOOLS for Linux: Install SWFTOOLS on a LINUX server. You must be root.
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
Table of Contents¶
What does SWFTOOLS for Linux do? 3
Check, if SWFTOOLS are installed 6
This is a fixed version. What's fixed? 12
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.
Copyright¶
SFWTOOLS is open-source-software.
Authors¶
Matthias Kramm
Maintainer, librfxswf(-python), pdf2swf, avi2swf, png2swf, swfcombine, swfextract, swfdump, swfc
Rainer Böhme
librfxswf, jpeg2swf, swfstrings
De Clarke
swifty, help with swfc, swfc documentation
See the file AUTHORS
Sources¶
Homepage: http://www.swftools.org
Mailinglist: http://mail.nongnu.org/mailman/listinfo/swftools-common
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¶
- 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/
- 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/
- 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/
- 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/
- 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/
Majordomo: For subcribing to and unsubscribing from a majordomo mailing list. http://typo3.org/extensions/repository/view/majordomo/
- 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/
- 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/
- 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/
- 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 /
- 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/
- 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/
- 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/