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
