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 @@ | |||
1 | |||
2 | MODIFICATIONS BY TROLLTECH | ||
3 | -------------------------- | ||
4 | |||
5 | Oct. 2001 | ||
6 | |||
7 | Just the Lib directory of the flash library source archive | ||
8 | has been copied in to the QPE CVS tree. For the full source code | ||
9 | to create a KDE screensaver or stand alone player etc, download | ||
10 | the orginal source tar ball from http://www.swift-tools.com/Flash | ||
11 | The files libflashplugin* have been added to wrapper the library | ||
12 | to produce a Qtopia Media Player plugin out of the code. | ||
13 | |||
14 | John R. | ||
15 | |||
16 | |||
17 | INTRODUCTION | ||
18 | ------------ | ||
19 | |||
20 | Jun. 12th 2000 | ||
21 | |||
22 | This the Version 0.4.10 of the Flash Library for Linux. | ||
23 | |||
24 | Flash Plugin is under GPL, see COPYING file. | ||
25 | |||
26 | Provides: | ||
27 | - Lib contains the FlashLib sources. | ||
28 | - Plugin contains plugin sources. | ||
29 | - Player contains the standalone player sources. | ||
30 | - Kflash a Flash KDE screen saver. | ||
31 | |||
32 | New features: | ||
33 | - Bug fixes. | ||
34 | - 24 and 32 modes supported. | ||
35 | - Flash Library as screen saver (for xcreensaver and KDE). | ||
36 | |||
37 | To get some information on this library check out the following link : | ||
38 | http://www.swift-tools.com/Flash | ||
39 | |||
40 | Authors:Olivier Debon <odebon@club-internet.fr> | ||
41 | Fabrice Bellard <fabrice.bellard@netgem.com> | ||
42 | |||
43 | FEATURES | ||
44 | -------- | ||
45 | |||
46 | Limitations : | ||
47 | - The plugin and the player use XShm extensions, so remote display is not possible. | ||
48 | - No Flash 4 features (but no crash on Flash 4 files). | ||
49 | |||
50 | Not functional : | ||
51 | - No Morphing. | ||
52 | - No vertical anti-aliasing. | ||
53 | |||
54 | SOUND SUPPORT | ||
55 | ------------- | ||
56 | |||
57 | Limitations : | ||
58 | - No streamed sound supported (interleaved data). | ||
59 | - No sound envelop. So no fading or balancing effect. | ||
60 | |||
61 | But the main feature is here and sound can be enjoyed. | ||
62 | |||
63 | I recommend OSS drivers, but it is not required at all | ||
64 | (http://www.opensound.com) | ||
65 | |||
66 | If you have troubles with sound put the -DNOSOUND option | ||
67 | for compilation. Also do this for non-Linux Unix. | ||
68 | |||
69 | THE PLAYER | ||
70 | ---------- | ||
71 | |||
72 | The standalone player can simply control movie by | ||
73 | pressing Q to quit, P to pause, C to continue and | ||
74 | R to replay. | ||
75 | There is also the possibility to zoom in or out | ||
76 | and scroll using Keypad +/- and cursor keys, but | ||
77 | it is buggy on frozen images. | ||
78 | |||
79 | THE SCREEN SAVERS | ||
80 | ----------------- | ||
81 | |||
82 | The standalone player can be run though xscreensaver. Modify | ||
83 | your .xscreensaver file to add swfplayer: | ||
84 | programs: swfplayer -root /home/olivier/Flash/Test/test.swf | ||
85 | (See xscreensaver doc for more details on Xscreensaver). | ||
86 | |||
87 | For KDE, just install the kflash.kss file from the Kflash | ||
88 | directory in /usr/bin (or where your KDE installation expects | ||
89 | kss file to be). | ||
90 | In your KDE start menu, select Settings->Desktop->Screensaver | ||
91 | Choose 'Flash Movies' and click on SetUp button. You'll have | ||
92 | to select a Flash file (take the test.swf file provided with | ||
93 | this distribution). The fullscreen option will scale the movie | ||
94 | to the entire screen (it can be very CPU intensive). The | ||
95 | enable sound option will allow to play sounds, but as a screen | ||
96 | saver mode this is not a good idea :) | ||
97 | |||
98 | BUG REPORT | ||
99 | ---------- | ||
100 | |||
101 | If Netscape crashes when it started to play a Flash file, please | ||
102 | report the complete url where you have found the file. | ||
103 | Do not send the actual file ! | ||
104 | |||
105 | If you have rendering problem also report the url. | ||
106 | |||
107 | If the plugin does not seem to show anything or does not do what it | ||
108 | is supposed to do, please consider that the plugin does not support | ||
109 | all Flash 2/4 features. Anyway it tries to play it but may fail then. | ||
110 | |||
111 | COMPILATION | ||
112 | ----------- | ||
113 | |||
114 | If you use Linux just type 'make'. | ||
115 | |||
116 | Warning : the plugin compilation should not fail, but you may | ||
117 | have problem with Netscape at startup. See INSTALLATION section | ||
118 | for workarounds. | ||
119 | |||
120 | For other Unices like FreeBSD or Solaris you may have to change | ||
121 | some flags. See Plugin/Makefile for hints. | ||
122 | |||
123 | INSTALLATION | ||
124 | ------------ | ||
125 | |||
126 | Once you have successfully compiled the plugin, put the file | ||
127 | npflash.so (located in the Plugin directory) into your | ||
128 | ~/.netscape/plugins directory or into the system-wide | ||
129 | /opt/netscape/plugins directory (depends on where you have installed | ||
130 | Netscape). | ||
131 | |||
132 | If Netscape already runs type 'javascript:navigator.plugins.refresh' | ||
133 | in the Location field. | ||
134 | |||
135 | PROBLEMS | ||
136 | -------- | ||
137 | |||
138 | If you have problem to successfully install the plugin, please | ||
139 | read the following hints. Otherwise, report the problem with full | ||
140 | description of your configuration : | ||
141 | - Distribution. | ||
142 | - Compiler. | ||
143 | - Libs (the output of ldconfig -p is useful). | ||
144 | - The netscape version and the output of 'ldd netscape'. | ||
145 | |||
146 | If some symbols like _rtti or _throw are unresolved, it seems | ||
147 | that you have egcs. Just uncomment the proper line in the main | ||
148 | Makefile. | ||
149 | You may then still have some unresolved symbols like __sigsetjmp. | ||
150 | This time, add -DC6R5 in the Plugin/Makefile at the PLUGIN_DEFINES | ||
151 | line. | ||
152 | |||
153 | CHECKING | ||
154 | -------- | ||
155 | |||
156 | To verify that the plugin is installed properly, type "about:plugins" | ||
157 | in Netscape's "Location:" or "Netsite:" field. The plugin should show | ||
158 | up there, something like | ||
159 | |||
160 | ___________________________________________________________________________ | ||
161 | |||
162 | Shockwave Flash | ||
163 | |||
164 | File name: /opt/netscape/plugins/npflash.so | ||
165 | |||
166 | Flash file player Version 0.4.10 | ||
167 | |||
168 | Shockwave is a trademark of Macromedia® | ||
169 | |||
170 | Author: Olivier Debon | ||
171 | |||
172 | --------------------------------------------------------------------------------- | ||
173 | | Mime Type | Description | Suffixes | Enabled | | ||
174 | |--------------------------------+-------------------+-------------+--------------| | ||
175 | | application/futuresplash | Flash Plugin | spl | Yes | | ||
176 | | application/x-shockwave-flash | | swf | Yes | | ||
177 | --------------------------------------------------------------------------------- | ||
178 | |||
179 | ___________________________________________________________________________ | ||
180 | |||
181 | |||
182 | If it shows up, but the "Enabled" column says "No", you need to | ||
183 | configure the Flash plugin as a helper application. Go to | ||
184 | Edit/Preferences/Navigator/Applications, and add it as follows: | ||
185 | |||
186 | Description: Flash Plugin | ||
187 | MIME Type: application/x-shockwave-flash | ||
188 | Suffixes: swf | ||
189 | Handled By: Plug In (select "Shockwave Flash") | ||
190 | |||
191 | ------ | ||