Author: jsundman
Date: 2006-12-08 08:13:07 -0800 (Fri, 08 Dec 2006)
New Revision: 2977
Modified:
openlaszlo/branches/legals/docs/src/dguide/browser-integration.html
openlaszlo/branches/legals/docs/src/dguide/media-resources.html
openlaszlo/branches/legals/docs/src/dguide/proxied.html
Log:
Updating Developer's Guide with respect to supported media, proxied/
SOLO & by runtime. Per Jim G., I'm checking into Legals and
requesting checkin to b1
Modified: openlaszlo/branches/legals/docs/src/dguide/browser-
integration.html
===================================================================
--- openlaszlo/branches/legals/docs/src/dguide/browser-
integration.html 2006-12-08 14:46:04 UTC (rev 2976)
+++ openlaszlo/branches/legals/docs/src/dguide/browser-
integration.html 2006-12-08 16:13:07 UTC (rev 2977)
@@ -23,7 +23,9 @@
</fixme>
<h1>Browser Integration</h1>
-<p>Though OpenLaszlo applications are not dependent on the browser or
+<p>
+Depending on what target runtime they're compiled for, OpenLaszlo
applications have different relationships with the JavaScript
engine of the browser in which they run. Applications compiled for
Flash are executed by the Flash player and must make use of the
<classname>LzBrowser</classname> service in order to "escape" to
the browser's JavaScript environment. Applications that are
compiled for DHTML, on the other hand, run within the browser's
JavaScript envinronment. </p>
+<p>Though OpenLaszlo applications delpoyed on the Flash runtime
are not dependent on the browser or
operating system for their look or behavior, there are some
important limitations that the browser container places on the
application. There are also a number of features that your
Modified: openlaszlo/branches/legals/docs/src/dguide/media-
resources.html
===================================================================
--- openlaszlo/branches/legals/docs/src/dguide/media-resources.html
2006-12-08 14:46:04 UTC (rev 2976)
+++ openlaszlo/branches/legals/docs/src/dguide/media-resources.html
2006-12-08 16:13:07 UTC (rev 2977)
@@ -14,20 +14,52 @@
<p>LZX is designed to make it easy for you to integrate media
resources into your application
in a flexible and dynamic manner. You can include images, audio,
video, and animations
that were created using standard third-party content creation tools.
-This chapter describes the media formats that are currently
supported as
-of OpenLaszlo 4.0. It then goes on to describes how to integrate
and control
+This chapter describes the media formats that are currently
supported as resources to <tagname>view</tagname>s in
+OpenLaszlo 4.0. It then goes on to describes how to integrate and
control
media in your application. It concludes with some
optimization tips.</p>
<p>
+Note that in addition to media that can be attached as resources
to views, streaming audio and video can be played by
<tagname>videoview</tagname>s. Please see <xref linkend="video"/>
for a discussion of streaming media.
+</p>
+<p>
For a discussion of streaming media, see <xref linkend="video"/>.
</p>
<h2>Supported media types</h2>
<p>
+The list of supported media types varies slightly depending on the
target runtime and whether the application is to be deployed SOLO
or proxied.
+</p>
+<h3>Media for SOLO applications</h3>
+<p>
+SOLO applications depend on Flash to load images (whereas the
proxied applications get help from the transcoder on the server).
This means that SOLO applications are limited to file types
supported natively by Flash.</p>
+<h4>Flash 7 and Flash 8 limitations</h4>
+<p>
+Flash player version 7 it can only load a limited set
+of jpegs encodings; it cannot do interleaved or progressive jpeg.
If you run
+Flash player 8 it can do more wide range of jpeg encoding. Set the
compiler to compile for Flash 8 as a target
+runtime to get this expanded range of image formats (also PNG and
GIF).
+</p>
+<h3>DHTML Limitations and workaround</h3>
+<p>
+Browsers do not natively support .swf or audio or video formats.
You must transcode them, omit them from your application, or embed
a flash player in your application to handle them.
+</p>
+<h4>Transcoding .swf to .png</h4>
+<p>
+Files in .swf format can be transcoded to .png format for display
by the DHTML runtime. OpenLaszlo provides a facility, called
autopng, for doing this automatically. As a convenience, the server
and compiler search for a corresponding png file if a swf file is
referenced in the DHTML runtime. To use this mechanism in your own
code, create a png file with the same basename as the swf file, and
place it in the same directory as the swf resource you want it to
replace.
+</p>
+<h4>Audio and Video in DHTML applications</h4>
+<note>
+The following discussion applies to audio and video resources
attached to <tagname>view</tagname>s, not to <tagname>videoview</
tagname>s. <tagname>videoview</tagname>s are not supported at all
for the DHTML runtime.
+</note>
+<p>
+In order to display swf-formatted audio and video within a DHTML
application, you may embedd a swf player in the page. For a
discussion of how to do this, see <xref linkend="browser-
integration"/>.
+</p>
+<h3>Summary of Supported Media</h3>
+<p>
OpenLaszlo 4.0 and above support the following media types:</p>
<dl>
<dt>JPEG</dt>
- <dd>All .jpg or .jpeg files are supported. See the <a
target="_blank" href="http://www.w3.org/Graphics/JPEG/";>W3C JPEG
JFIF Specification</a>.
+ <dd>Depending on target runtime and mode of deployment,
different .jpg and .jpeg files are supported. Progressive and
interleaved files are not supported for Flash 7 SOLO deployment.
See the <a target="_blank" href="http://www.w3.org/Graphics/
JPEG/">W3C JPEG JFIF Specification</a>.
<note><i>Progressive</i> files are re-encoded in the OpenLaszlo
Server.</note>
</dd>
<dt>GIF</dt>
@@ -38,11 +70,19 @@
<dd>All Portable Network Graphics files (<a target="_blank"
href="http://www.w3.org/Graphics/PNG/";>PNG details at W3C
information</a>)
are supported. This includes PNGs with alpha channels
(transparency).</dd>
<dt>MP3</dt>
- <dd>Support limited to audio MP3 files with <i>sample</i>-rates
of 44.1 kHz, 22.050 kHz, 11.025 kHz, 8.000 kHz and 5.512 kHz</dd>
+ <dd><p>For proxied applications compiled to .swf, support is
limited to audio MP3 files with <i>sample</i>-rates of 44.1 kHz,
22.050 kHz, 11.025 kHz, 8.000 kHz and 5.512 kHz.</p>
+ <p>
+ Flash behaves poorly with mp3s it doesn't like, which makes
tracking down problems difficult. If you run into a problem, a good
idea would be to find out whether your mp3 plays in a standalone
Flash app separate from OpenLaszlo. (You can use the mtasc.org
compiler to test this, using Flash's Sound class to load an play
your mp3.) If your mp3 works does not work in standalone Flash,
hen the problem is not OpenLaszlo.
+ </p>
+ Mp3s are not natively supported by browsers, so applications
that compile to DHTML should make provisions, as described above.
+ <p>
+ </p></dd>
<dt>SWF</dt>
<dd><p>Macromedia Flash (SWF) files. (See <a target="_blank"
href="http://www.macromedia.com/software/flash/open/licensing/
fileformat/">Macromedia documentation</a>).</p>
- <p>Support is limited to SWF files that contain stills or
animation only.
- Very limited ActionScript is allowed/supported (see below for
more details).
+ <p>For applications compiled to Flash, support is limited to SWF
files that contain stills or animation only. Very limited
ActionScript is allowed/supported (see below for more details).
+ </p>
+ <p>
+ For applications compiled to DHTML, .swf format files are not
supported. See above for a workaround.
</p></dd>
</dl>
<p>
Modified: openlaszlo/branches/legals/docs/src/dguide/proxied.html
===================================================================
--- openlaszlo/branches/legals/docs/src/dguide/proxied.html
2006-12-08 14:46:04 UTC (rev 2976)
+++ openlaszlo/branches/legals/docs/src/dguide/proxied.html
2006-12-08 16:13:07 UTC (rev 2977)
@@ -25,7 +25,12 @@
As explained in <xref linkend="architecture"/>, there are two
distinct ways in which
OpenLaszlo applications can be <i>deployed</i>, that is, made
available on the web:
</p>
-
+<p>
+The implementation of proxied and SOLO deployment models differs
depending on the target runtime. The discussion below pertains to
deploying for the Flash runtime.
+</p>
+<fixme>
+NEED INFO ON SOLO dhtml deployment!
+</fixme>
<ol>
<li>Deploy SOLO (Standalone OpenLaszlo Output) from any HTTP Web
server</li>
<li>Deploy with OpenLaszlo Server</li>
_______________________________________________
Laszlo-checkins mailing list
[email protected]
http://www.openlaszlo.org/mailman/listinfo/laszlo-checkins
