Diffstat (limited to 'core/multimedia/opieplayer/libflash/README') (more/less context) (ignore whitespace changes)
| -rw-r--r-- | core/multimedia/opieplayer/libflash/README | 191 |
1 files changed, 191 insertions, 0 deletions
diff --git a/core/multimedia/opieplayer/libflash/README b/core/multimedia/opieplayer/libflash/README new file mode 100644 index 0000000..9914a00 --- a/dev/null +++ b/core/multimedia/opieplayer/libflash/README @@ -0,0 +1,191 @@ + +MODIFICATIONS BY TROLLTECH +-------------------------- + +Oct. 2001 + +Just the Lib directory of the flash library source archive +has been copied in to the QPE CVS tree. For the full source code +to create a KDE screensaver or stand alone player etc, download +the orginal source tar ball from http://www.swift-tools.com/Flash +The files libflashplugin* have been added to wrapper the library +to produce a Qtopia Media Player plugin out of the code. + +John R. + + +INTRODUCTION +------------ + +Jun. 12th 2000 + +This the Version 0.4.10 of the Flash Library for Linux. + +Flash Plugin is under GPL, see COPYING file. + +Provides: +- Lib contains the FlashLib sources. +- Plugin contains plugin sources. +- Player contains the standalone player sources. +- Kflash a Flash KDE screen saver. + +New features: +- Bug fixes. +- 24 and 32 modes supported. +- Flash Library as screen saver (for xcreensaver and KDE). + +To get some information on this library check out the following link : +http://www.swift-tools.com/Flash + +Authors: Olivier Debon <odebon@club-internet.fr> + Fabrice Bellard <fabrice.bellard@netgem.com> + +FEATURES +-------- + +Limitations : + - The plugin and the player use XShm extensions, so remote display is not possible. + - No Flash 4 features (but no crash on Flash 4 files). + +Not functional : + - No Morphing. + - No vertical anti-aliasing. + +SOUND SUPPORT +------------- + +Limitations : + - No streamed sound supported (interleaved data). + - No sound envelop. So no fading or balancing effect. + +But the main feature is here and sound can be enjoyed. + +I recommend OSS drivers, but it is not required at all +(http://www.opensound.com) + +If you have troubles with sound put the -DNOSOUND option +for compilation. Also do this for non-Linux Unix. + +THE PLAYER +---------- + +The standalone player can simply control movie by +pressing Q to quit, P to pause, C to continue and +R to replay. +There is also the possibility to zoom in or out +and scroll using Keypad +/- and cursor keys, but +it is buggy on frozen images. + +THE SCREEN SAVERS +----------------- + +The standalone player can be run though xscreensaver. Modify +your .xscreensaver file to add swfplayer: +programs: swfplayer -root /home/olivier/Flash/Test/test.swf +(See xscreensaver doc for more details on Xscreensaver). + +For KDE, just install the kflash.kss file from the Kflash +directory in /usr/bin (or where your KDE installation expects +kss file to be). +In your KDE start menu, select Settings->Desktop->Screensaver +Choose 'Flash Movies' and click on SetUp button. You'll have +to select a Flash file (take the test.swf file provided with +this distribution). The fullscreen option will scale the movie +to the entire screen (it can be very CPU intensive). The +enable sound option will allow to play sounds, but as a screen +saver mode this is not a good idea :) + +BUG REPORT +---------- + +If Netscape crashes when it started to play a Flash file, please +report the complete url where you have found the file. +Do not send the actual file ! + +If you have rendering problem also report the url. + +If the plugin does not seem to show anything or does not do what it +is supposed to do, please consider that the plugin does not support +all Flash 2/4 features. Anyway it tries to play it but may fail then. + +COMPILATION +----------- + +If you use Linux just type 'make'. + +Warning : the plugin compilation should not fail, but you may +have problem with Netscape at startup. See INSTALLATION section +for workarounds. + +For other Unices like FreeBSD or Solaris you may have to change +some flags. See Plugin/Makefile for hints. + +INSTALLATION +------------ + +Once you have successfully compiled the plugin, put the file +npflash.so (located in the Plugin directory) into your +~/.netscape/plugins directory or into the system-wide +/opt/netscape/plugins directory (depends on where you have installed +Netscape). + +If Netscape already runs type 'javascript:navigator.plugins.refresh' +in the Location field. + + PROBLEMS + -------- + +If you have problem to successfully install the plugin, please +read the following hints. Otherwise, report the problem with full +description of your configuration : +- Distribution. +- Compiler. +- Libs (the output of ldconfig -p is useful). +- The netscape version and the output of 'ldd netscape'. + +If some symbols like _rtti or _throw are unresolved, it seems +that you have egcs. Just uncomment the proper line in the main +Makefile. +You may then still have some unresolved symbols like __sigsetjmp. +This time, add -DC6R5 in the Plugin/Makefile at the PLUGIN_DEFINES +line. + + CHECKING + -------- + +To verify that the plugin is installed properly, type "about:plugins" +in Netscape's "Location:" or "Netsite:" field. The plugin should show +up there, something like + +___________________________________________________________________________ + + Shockwave Flash + + File name: /opt/netscape/plugins/npflash.so + + Flash file player Version 0.4.10 + + Shockwave is a trademark of Macromedia® + + Author: Olivier Debon + + --------------------------------------------------------------------------------- +| Mime Type | Description | Suffixes | Enabled | +|--------------------------------+-------------------+-------------+--------------| +| application/futuresplash | Flash Plugin | spl | Yes | +| application/x-shockwave-flash | | swf | Yes | + --------------------------------------------------------------------------------- + +___________________________________________________________________________ + + +If it shows up, but the "Enabled" column says "No", you need to +configure the Flash plugin as a helper application. Go to +Edit/Preferences/Navigator/Applications, and add it as follows: + +Description: Flash Plugin +MIME Type: application/x-shockwave-flash +Suffixes: swf +Handled By: Plug In (select "Shockwave Flash") + +------ |