You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

496 lines
23 KiB

<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
<html>
<head>
<meta http-equiv="Content-Type"
content="text/html; charset=iso-8859-1">
<meta name="GENERATOR" content="Microsoft FrontPage 2.0">
<title>DirectAnimation Readme</title>
</HEAD>
<!--TOOLBAR_START-->
<!--TOOLBAR_END-->
<body bgcolor="#FFFFFF">
<p align="center"><a name="Top of Page"><font size="5"
face="Verdana, Arial, Helvetica"><strong>DirectAnimation Readme</strong></font></a></p>
<p><a href="http://www.microsoft.com/misc/cpyright.htm" target="_top" class="cpslug"><font
color="#006600" size="1" face="MS SANS SERIF">&copy; 1997, 1998 Microsoft
Corporation. All rights reserved. Terms of use.</font></a><font
color="#006600" size="1" face="MS SANS SERIF"> </font><br
clear="all">
<p><font size="2" face="Verdana, Arial, Helvetica">This document
provides late-breaking or other information that supplements the
Microsoft DirectAnimation documentation. </font></p>
<p><a href="#Overview"><font size="2"
face="Verdana, Arial, Helvetica">Overview</font></a></p>
<p><a href="#Requirements and Dependencies"><font size="2"
face="Verdana, Arial, Helvetica">Requirements, Dependencies, and
Installation</font></a></p>
<p><a href="#Additional Information"><font size="2"
face="Verdana, Arial, Helvetica">Additional Information</font></a></p>
<p><a href="#Known Bugs"><font size="2"
face="Verdana, Arial, Helvetica">Known Bugs</font></a></p>
<p><a href="#Contact Info"><font size="2"
face="Verdana, Arial, Helvetica">Contact Information</font></a></p>
<hr>
<h3><a name="Overview"><font size="2"
face="Verdana, Arial, Helvetica"><strong>Overview</strong></font></a></h3>
<p><font size="2" face="Verdana, Arial, Helvetica">DirectAnimation
was released as an integrated component of Internet Explorer 4.0
minimal install. This provides unprecedented animation and
multimedia capabilities built into a major Internet browser (no
special download is needed). Furthermore, DirectAnimation allows
for integration with DHTML, and hence is especially suitable for
adding compact and lightweight animation effects to web pages. </font></p>
<p><font size="2" face="Verdana, Arial, Helvetica">DirectAnimation
is the component of the DirectX family of APIs that provides rich
animation and integrated media support for Web pages, CD-ROM
titles, and multimedia applications. DirectAnimation provides
unified and comprehensive support for the different media types,
including: 2-D vector graphics, 3-D graphics, sprites, audio,
video, and a rich time and event model that applies uniformly
across the different media types. DirectAnimation is a COM API
and an underlying engine/run time whose functionally can be
accessed in different ways by different user groups: </font></p>
<ul>
<li><font size="2" face="Verdana, Arial, Helvetica">HTML
authors can integrate animation using the DirectAnimation
controls.</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">Visual
Basic&#174; Scripting Edition (VBScript), JScript&trade;
users, and Java applet writers can program animation for
web pages with integration with DHTML.</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">Finally,
Java, Visual Basic, and C++ programmers can develop
ActiveX Controls or full applications with rich media and
interactivity. </font></li>
</ul>
<p><font size="2" face="Verdana, Arial, Helvetica">The supported
media types are as follows:</font></p>
<blockquote>
<ul>
<li><font size="2" face="Verdana, Arial, Helvetica">2-D
images (.bmp, .gif, .png, and .jpeg files)</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">3-D
models (.x and VRML files) </font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">Sounds
(.wav and .midi files)</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">Movies
(.avi, .mpeg, and .mov files)</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">Text</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">Vector
graphics</font></li>
</ul>
</blockquote>
<p><font size="2" face="Verdana, Arial, Helvetica">In the case of
movies and sounds, additional media formats can be supported by
supplying DirectShow CODECs for those formats.</font></p>
<p><font size="2" face="Verdana, Arial, Helvetica">One of the key
DirectAnimation classes is the Behavior class. Different types of
media are incorporated into the animation by encapsulating them
as DirectAnimation Behavior objects. Behavior objects can be used
interchangeably, and have a number of methods applied to them,
independent of the media type they are encapsulating. Of course,
you can still access methods that are specific to the different
types of behaviors, based on the type of media.</font></p>
<p><a href="#Top of Page"><font size="2"
face="Verdana, Arial, Helvetica"><strong>Back to the top</strong></font></a></p>
<h3><a name="Requirements and Dependencies"><font size="2"
face="Verdana, Arial, Helvetica"><strong>Requirements,
Dependencies, and Installation</strong></font></a></h3>
<p><font size="2" face="Verdana, Arial, Helvetica">The <strong>minimum</strong>
requirements in order to run DirectAnimation applications and
content are as follows:</font></p>
<ul>
<li><font size="2" face="Verdana, Arial, Helvetica">Pentium-based
computer with 16 Megabytes of memory</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">Windows
95 or NT 4.0</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">DirectX, <u>including
Direct3D</u> (for NT users, we recommend SP3)</font></li>
</ul>
<p><font size="2" face="Verdana, Arial, Helvetica">The
DirectAnimation run time comes as part of </font><a
href="http://www.microsoft.com/ie/ie40/"><font size="2"
face="Verdana, Arial, Helvetica">IE4 minimal install</font></a><font
size="2" face="Verdana, Arial, Helvetica">. DirectAnimation will
also be part of Windows 98 and future releases of Windows NT.</font></p>
<p><a href="#Top of Page"><font size="2"
face="Verdana, Arial, Helvetica"><strong>Back to the top</strong></font></a></p>
<h3><a name="Additional Information"><font size="2"
face="Verdana, Arial, Helvetica"><strong>Additional Information</strong></font></a></h3>
<font size="2" face="Verdana, Arial, Helvetica"><!--Due to a bug with the Java VM, running DirectAnimation Java-based
content under Windows NT causes Internet Explorer to "hang"
(sometimes you are able to run a few applets before IE
stops responding). If you are authoring Java-based content, use
Windows 95 for this release.--></font>
<p><font size="2" face="Verdana, Arial, Helvetica">DirectAnimation
supports several scripting languages (JScript and VBScript), as
well as the integration of the multimedia controls (in Internet
Explorer 4.x) with the DirectAnimation run time. In addition to
the multimedia controls, a windowed control is provided which can
be used, not only with IE 4.0, but also with IE 3.02 and with
Visual Basic 5.0. With the addition of the multimedia controls,
content developers can now access DirectAnimation functionality
through different levels, from PARAM tags at the control level,
to scripting, to raw COM.</font></p>
<p><font size="2" face="Verdana, Arial, Helvetica">The
DirectAnimation Java classes are dependent on the version of the
Java VM that ships with the Microsoft SDK for Java 2.0 and
Internet Explorer 4.x. We used Microsoft Visual J++ 1.1 to author
the Java samples.</font></p>
<p><font size="2" face="Verdana, Arial, Helvetica">In order to
use DirectAnimation Java-based content within Netscape's
Navigator, follow these instructions:</font></p>
<blockquote>
<p><font size="2" face="Verdana, Arial, Helvetica">Microsoft
has made a plug-in available to users of Netscape Navigator
2.02 and 3.0 which allows them to make use of the Microsoft
Java VM. Netscape Communicator is not yet supported because
of changes made to the plug-in interface. Note that this
plug-in does not replace the Netscape Java VM, but it does
provide access to the MS VM through the use of the
&lt;embed&gt; tag. To get an applet up and running under
Netscape, follow these simple steps:</font></p>
</blockquote>
<blockquote>
<ol>
<li><font size="2" face="Verdana, Arial, Helvetica">Get
the plug-in from the Java SDK 2.0 and place it in
your Navigator\Program\Plugins directory. </font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">Install
the required MS Java VM, if you haven&#39;t already.
</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">Change
the applet tag in your source html from this: </font></li>
</ol>
<blockquote>
<p><font size="2" face="Verdana, Arial, Helvetica">&lt;applet
code=&quot;myjava.class&quot; width=100
height=100&gt;&lt;/applet&gt;</font></p>
<p><font size="2" face="Verdana, Arial, Helvetica">To
this: </font></p>
<p><font size="2" face="Verdana, Arial, Helvetica">&lt;embed
src=&quot;myjava.class&quot; width=100
height=100&gt;&lt;/embed&gt;</font></p>
</blockquote>
</blockquote>
<p><font size="2" face="Verdana, Arial, Helvetica">In general, we
recommend that you upgrade to the DirectX 5 set of video drivers.
Several visual artifacts that appear under older versions of
video drivers disappear with the newer set.</font></p>
<p><font size="2" face="Verdana, Arial, Helvetica">We have added
some C++ based samples to the SDK. Some samples rely on the DA
control, while others composite directly to a DirectDraw surface.</font></p>
<p><font size="2" face="Verdana, Arial, Helvetica">When possible,
we suggest that you take advantage of the asynchronous import
methods. This leads to more responsive content, since the end
user does not have to wait for all the content to load, before
experiencing the animation.</font></p>
<p><a href="#Top of Page"><font size="2"
face="Verdana, Arial, Helvetica"><strong>Back to the top</strong></font></a></p>
<h3><a name="Known Bugs"><font size="2"
face="Verdana, Arial, Helvetica"><strong>Known Bugs</strong></font></a></h3>
<p><font size="2" face="Verdana, Arial, Helvetica">The following
is a list of current known problems. We strongly encourage you to
send us mail if you find a problem (</font><a
href="mailto:dxmbug@microsoft.com"><font size="2"
face="Verdana, Arial, Helvetica">dxmbug@microsoft.com</font></a><font
size="2" face="Verdana, Arial, Helvetica">). There are newsgroups
set up to allow DirectAnimation content developers to discuss
issues and ideas; however, mailing a bug description is the only
sure way to get a fix for a bug.</font></p>
<p><font size="2" face="Verdana, Arial, Helvetica"><u>The release
of DirectAnimation in this SDK and accompanying redist package is
newer than that distributed with IE 4.0</u>. There were many bug
fixes related to memory leaks, as well as the following
functional changes:</font></p>
<ul>
<li><font size="2" face="Verdana, Arial, Helvetica">In the
size parameter for text, a negative quantity can be
specified. The negative quantity allows you to indicate
to DirectAnimation that the text behavior's
size/orientation is not going to be animated (although
animating the position is fine), allowing us to produce a
higher quality text. We will carry support for this
parameter forward, but eventually you will get the same
high quality text regardless of transforms applied to the
text behavior.</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">The timer
source for the DirectAnimation control can be selected
using the IDAViewerControl::TimerSource property. This is
useful for Web scripting. By default, DirectAnimation
uses WM_TIMER messages<br>
You can use the IE 4.0 DHTML timers by specifying values
of DA_TIMER_SOURCE type, which allows your
DirectAnimation content to be in sync with other controls
or DHTML elements. Note that, if you use this property,
you should check for the version number which is
accessible through the VersionString method on DAStatics.
Failure to do so will cause an error when the page is
viewed with the previous version of DirectAnimation.</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">If you
find a problem with your scripting-based content that
seems to make your Web page appear unresponsive to
events and timers outside of your DirectAnimation
content, you should set the UpdateInterval property of
the control to 0.15 (this causes a new frame to be
drawn every 0.15 seconds, meaning that the content gets
6.66 frames per second).</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">The
DirectAnimation Java classes fully enforce the Java
security model, only allowing media located in
directories below the location of the Web page to be
opened by the applet.</font></li>
</ul>
<p><font size="2" face="Verdana, Arial, Helvetica"><b>General</b></font></p>
<ul>
<font size="2" face="Verdana, Arial, Helvetica"><!--Java-based DirectAnimation content will "hang" the browser
under NT. This is only for Java-based content and will be
fixed in future releases of the VM.--></font>
<li><font size="2" face="Verdana, Arial, Helvetica">For Java
content, all <b>initialization</b> of DirectAnimation
behaviors and events needs to happen in methods (cannot
happen in classes outside of methods); however, you can
have <b>declarations</b> of behaviors outside methods to
make them accessible from other classes and throughout
the methods of a class.</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">There are
some small memory leaks, most notably when using 3-D,
sounds, or notifiers. To fix this in Java, implement <b>public
void cleanup()</b> to the class that extends Model. In
this method, call <b>super.cleanup()</b> and set all
behaviors that are suspected of leaking memory to NULL.
If you have other classes which contain DA behaviors,
implement <b>public void cleanup()</b> and only set
suspect behaviors to NULL. Also, add the <b>public void
destroy()</b> to the class that extends DXMApplet. In
this method, call <b>super.destroy()</b> and set the model to
NULL.</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">For Java
content, sometimes the LeftButtonPress events miss.</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">The
cursor is considered to be in the middle of the window
when DirectAnimation first comes up.</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">TextPath
and TextImage are now obsolete. Please use StringPath and
StringImage instead.</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">Notifiers
can only be implemented in Java.</font></li>
<font size="2" face="Verdana, Arial, Helvetica"><!--New font styles will be added for final
release (strikethrough and underline).--></font>
<li><font size="2" face="Verdana, Arial, Helvetica">AnimateControlPosition
takes parameters in meters, even if you are using the
pixel library.</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">Only
DirectDraw surfaces created through DirectDrawEx can be
imported.</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">bvrhook
does not get called at snapshot time.</font></li>
</ul>
<p><font size="2" face="Verdana, Arial, Helvetica"><b>Graphics</b></font></p>
<ul>
<li><font size="2" face="Verdana, Arial, Helvetica">Shearing
movies and lines does not work properly.</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">Color
palette is not correct for 256 colors displays under NT.</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">SubstituteTime
does not work right when applied to splines.</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">FollowPathAngleUpright
isn't doing the uprightness.</font></li>
<font size="2" face="Verdana, Arial, Helvetica"><!--BorderEndStyle will be
removed for final release.--></font>
<li><font size="2" face="Verdana, Arial, Helvetica">Although
class browsers or Visual Basic show the parameters to arc
and roundedrect as radius, they are really the diameter.</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">Using
Java, time-varying opacity may cause the whole object to
become solid after some time.</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">TextMatte
isn't allowing enough of the image to be drawn through.</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">Knot
duplicity for splines is not handled.</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">Bounding
box of a sheared behavior is incorrect.</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">Overlaying
an image on a solidColorImage, cropping it, and then
adding a rotation transform, results in the
solidColorImage disappearing. The workaround is to crop
the solidColorImage into a matte.</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">Underline
and strikethrough don't work on NT.</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">When
loading a large number of JPEG images, there is a
significant delay. A workaround is to make use of the
asynchronous import method.</font></li>
</ul>
<p><font size="2" face="Verdana, Arial, Helvetica"><b>Audio</b></font></p>
<ul>
<li><font size="2" face="Verdana, Arial, Helvetica">Sound
does not turn off all the time.</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">SinSynth
plays at 440Hz no matter what rate is specified.</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">Dynamic
phasing isn't enabled.</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">Loop
causes the leaf sounds to loop, not the combined sound
behavior (this is the intended behavior).</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">SinSynth
mixed with static sound gives a choppy sinusoidal sound.</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">Audio
time substitutions not accumulating</font></li>
</ul>
<p><font size="2" face="Verdana, Arial, Helvetica"><b>3-D</b></font></p>
<ul>
<li><font size="2" face="Verdana, Arial, Helvetica">Textures
are not propagating down the leaf geometries for
.X-files-based 3-D objects.</font></li>
</ul>
<p><font size="2" face="Verdana, Arial, Helvetica"><strong>Movies</strong></font></p>
<ul>
<li><font size="2" face="Verdana, Arial, Helvetica">To use a
movie as a texture, you have to use the following
workaround (code snippet in JScript):</font></li>
</ul>
<blockquote>
<blockquote>
<p><font size="2" face="Verdana, Arial, Helvetica">movieImport
= m.ImportMovie(&quot;http://movie.avi&quot;);<br>
movieImg = movieImport .Image;<br>
<br>
// This is the workaround<br>
movieBBox = movieImg.BoundingBox;<br>
solidImg = m.SolidColorImage(m.White);<br>
solidImg = solidImg.Crop(movieBBox.Min,movieBBox.Max);<br>
<br>
movieImg = m.Overlay(movieImg,solidImg);</font></p>
</blockquote>
</blockquote>
<p><font size="2" face="Verdana, Arial, Helvetica"><b>Controls</b></font></p>
<ul>
<li><font size="2" face="Verdana, Arial, Helvetica">When
using the Sprite multimedia control, source .bmp images
over 2048 pixels long have to be broken into arrays of
images (rows and columns of images, instead of just one
long row or column).</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">Under
some video drivers, filtered transparent pixels render as
black.</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">For the
Path control, TimeMarker persistence parameter
&quot;-1&quot; works like FALSE in JScript.</font></li>
</ul>
<p><font size="2" face="Verdana, Arial, Helvetica"><b>Using
Visual Basic</b></font></p>
<ul>
<li><font size="2" face="Verdana, Arial, Helvetica">Use the
DirectAnimation Windowed Control when creating Visual
Basic samples. There is a buffering problem in Visual
Basic 5.0 that causes flashing if the DirectAnimation
Windowless Control is used instead. This will be fixed in
a future version of Visual Basic.</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">Button
events do not work.</font></li>
<li><font size="2" face="Verdana, Arial, Helvetica">If the
animation runs too slowly, increase the value of the <b>UpdateInterval</b>
property.</font></li>
</ul>
<p><a href="#Top of Page"><font size="2"
face="Verdana, Arial, Helvetica"><strong>Back to the top</strong></font></a></p>
<h3><a name="Contact Info"><font size="2"
face="Verdana, Arial, Helvetica"><strong>Contact Information</strong></font></a></h3>
<blockquote>
<p><font size="2" face="Verdana, Arial, Helvetica">We've set
public news groups on the </font><a
href="news://msnews.microsoft.com"><font size="2"
face="Verdana, Arial, Helvetica">Microsoft Public News Server</font></a><font
size="2" face="Verdana, Arial, Helvetica">, as a forum for
the DirectAnimation user community. We encourage you to post
all questions related to the use of DirectAnimation on the
appropriate news group: </font></p>
<ul>
<li><a
href="news:microsoft.public.multimedia.directx.danimation.controls"><font
size="2" face="Verdana, Arial, Helvetica">microsoft.public.multimedia.directx.danimation.controls</font></a><font
size="2" face="Verdana, Arial, Helvetica"> is for
users of the DirectAnimation controls.</font></li>
<li><a
href="news:microsoft.public.multimedia.directx.danimation.programming"><font
size="2" face="Verdana, Arial, Helvetica">microsoft.public.multimedia.directx.danimation.programming
</font></a><font size="2"
face="Verdana, Arial, Helvetica">is for programmers
of the DirectAnimation API.</font></li>
</ul>
<p><font size="2" face="Verdana, Arial, Helvetica">For
reporting bugs against the preview version, send mail to </font><a
href="mailto:dxmbug@microsoft.com"><font size="2"
face="Verdana, Arial, Helvetica">dxmbug@microsoft.com</font></a><font
size="2" face="Verdana, Arial, Helvetica">. When you do so,
make sure to be specific about the OS, PC/graphics card,
version of IE4, and specific host language/control that
you're using to access DirectAnimation.</font></p>
<p><font size="2" face="Verdana, Arial, Helvetica"><br>
</font></p>
</blockquote>
<p><a href="#Top of Page"><font size="2"
face="Verdana, Arial, Helvetica"><strong>Back to the top</strong></font></a></p>
</body>
</html>