mozilla/shumway

Shumway is a Flash VM and runtime written in JavaScript

Shumway

Shumway is an HTML5 technology experiment that explores building a faithful and efficient renderer for the SWF file format without native code assistance.

Shumway is community-driven and supported by Mozilla. Our goal is to create a general-purpose, web standards-based platform for parsing and rendering SWFs. Integration with Firefox is a possibility if the experiment proves successful.

Getting started

Online demo

For an online demo, visit:

• http://mozilla.github.io/shumway/examples/racing/
• Or see all the demos at http://mozilla.github.io/shumway/

Extension

Install the Firefox extension: http://mozilla.github.io/shumway/extension/firefox/shumway.xpi

This development extension should be quite stable but still might break from time to time. Also, note that the development extension is updated on every merge and by default Firefox will auto-update extensions on a daily basis (you can change this through the extensions.update.interval option in about:config, time is in seconds).

To build the Firefox extension: use grunt firefox.

Contributing

Development

See the wiki.

If you don't want to hack on the project or have little spare time, you still can help! Just install the Firefox extension, test it on SWFs in the wild, and report any problems or unimplemented features.

Our GitHub contributors so far:

• https://github.com/mozilla/shumway/contributors

You can add your name to it! :)

The easiest way to get started is to grep for TODOs and implement them.

Additional resources

Talk to us on IRC:

• #shumway on irc.mozilla.org

Post on our mailing list:

• [email protected]

Subscribe either using lists.mozilla.org or Google Groups:

• https://lists.mozilla.org/listinfo/dev-shumway
• http://groups.google.com/group/mozilla.dev.shumway

shumway's Issues

Add simple sound support

... at least for WAVE data for now

baseClass is undefined error when Compile System is on

... in the inspector

Error message:

[11:42:13.981] TypeError: baseClass is undefined @ http://localhost:8000/src/avm2/domain.js:153

Workaround: turn off the Compile System

Calls to gotoAndPlay(x) should not advance the navigation until the frame script completes.

See: example/timeline/Timeline7.swf

Read section on Frame Execution: http://www.senocular.com/flash/tutorials/orderofoperations/

// frame script
trace(currentFrame); // 1
gotoAndStop(5);
trace(currentFrame); // 1

"Specifically, all frame navigation for an instance occurring within the frame scripts of that instance is queued and executed at the end of the call stack. This means the frame does not change directly after a navigation call is made."

Inherited interfaces are broken.

isInstance() fails when testing an inherited interface

Apply alpha mask for bitmaps defined via DefineBitsJPEG3

The mask image is already exported from the parser as a separate PNG data-uri. It needs to be applied on the actual JPEG.

Link to Simple Firefox Build on Wiki is broken

The link on this page: https://github.com/mozilla/shumway/wiki should be: https://developer.mozilla.org/en/docs/Simple_Firefox_build. The old link is broken.

issue in class création

[function fn122 () {
Runtime.stack.push($C[0]);
var $SS = $C[147];
var $S = $SS, $O = $S.object, $G = $S.global.object, $S = $SS;
var a;
var s1;
$S = new Scope($S, this, undefined);
$O = $S.object;
// file: E:\admin27_05_2012\src;W\recept;receptBase.as
// line: 23
s1 = $C[4].public$Object;
$S = new Scope($S, s1, undefined);
$O = $S.object;
s1 = $C[49].public$flash$events$EventDispatcher;
$S = new Scope($S, s1, undefined);
$O = $S.object;
s1 = $C[51].public$flash$display$DisplayObject;
$S = new Scope($S, s1, undefined);
$O = $S.object;
s1 = $C[53].public$flash$display$InteractiveObject;
$S = new Scope($S, s1, undefined);
$O = $S.object;
s1 = $C[55].public$flash$display$DisplayObjectContainer;
$S = new Scope($S, s1, undefined);
$O = $S.object;
s1 = $C[57].public$flash$display$Sprite;
$S = new Scope($S, s1, undefined);
$O = $S.object;
/******
*
*$C[95].public$MCM; is undefined
*
*
*
*/
s1 = $C[95].public$MCM;
$S = new Scope($S, s1, undefined);
$O = $S.object;
s1 = $C[5].runtime.createClass($C[149], $C[95].public$MCM, $S);
$S = $S.parent;
$O = $S.object;
$S = $S.parent;
$O = $S.object;
$S = $S.parent;
$O = $S.object;
$S = $S.parent;
$O = $S.object;
$S = $S.parent;
$O = $S.object;
$S = $S.parent;
$O = $S.object;
$S = $S.parent;
$O = $S.object;
$O.public$W$recept$receptBase = s1;
// file: E:\admin27_05_2012\src;W\recept;receptBase.as
// line: 1
Runtime.stack.pop();
return;
}][0]

package {
import flash.display.DisplayObject;
import flash.display.Graphics;
import flash.display.Shape;
import flash.display.Sprite;
import flash.geom.Matrix;
import flash.geom.Matrix3D;
import flash.geom.Point;
import flash.geom.Rectangle;
import flash.geom.Vector3D;
import S.E.Ev;
import S.io.console;
import S.T.T;
import W.recept.receptBase;

public class MCM extends Sprite {
.....
}

}

$C[95]

flags 0
id 8459
name "MCM"
qualifiedName "public$MCM"
namespaces[0]{
kind 22
originalURI ""
qualifiedName "public"
uri ""
}

---

Because $C[95].public$MCM; is undefined shumway fail at :
Erreur : TypeError: baseClass is undefined
Fichier Source : resource://shumway/avm2/domain.js
Ligne : 130

Does not work in Latest Nightly.

I downloaded the whole repo just now, packed the proper files into xpi, installed. Tested on youtube and facebook. The big play button with two button below it giving the option to choose flash and shumway appear. Clicking on either shumway or the big play button blanks the flash area, with a shumway label in bottom right and nothing else. I get these errors in error console :

Timestamp: 1/12/2013 8:38:20 PM
Error: ReferenceError: EXECUTION_MODE is not defined
Source File: resource://shumway/web/viewer.html
Line: 327

Timestamp: 1/12/2013 8:38:20 PM
Error: ReferenceError: enableVerifier is not defined
Source File: resource://shumway/web/avm2utils.js
Line: 1

Timestamp: 1/12/2013 8:38:20 PM
Error: ReferenceError: metrics is not defined
Source File: resource://shumway/web/viewer.html
Line: 56

Set MovieClip::_currentFrameLabel

...when a labeled frame is entered.

Generate morphing shape states

... and expose MorphingShape symbols.

Shumway doesn't work in the latest Nightly

Shumway version: 0.5.60
Nightly version: 22.0a1 (2013-02-21) (win32)

Even though Shumway is enabled in about:addons -> Extensions, swf objects are opened in Flash. It works in Firefox 19.0.

Pages with non-visible swfs that don't work in Shumway break

For pages with non-visible Flash content (e.g. Google Play Music), when that content breaks in Shumway, the page doesn't work. Shumway needs to provide an infobar or doorhanger to allow falling back to the native Flash player.

Implement ID3v2 tag parsing for the ID3 Class

After audio data is loaded we need to parse and populate the id3 property of the Audio class.

Promises not resolved.

See:

curl -O http://cdn.flashtalking.com/xre/50/502446/429614/swf/WAVE_round1_300x250.swf

The 'init' event is never fired the Loader because of some promise problem, I think.

Issues with the PolygonTracker: line1 is undefined

It seems that a simple MoveTo, LineTo will cause the PolygonTracker to get hung up.

See the issue with this example:

http://magcius.mecheye.net/flash/shumway/shape_example.swf

Example:Shumway doen't work on a simple text swf

Recently,I've tried to use shumway with this simple flash file(it's from paperc.de)http://www.file-upload.net/download-7043984/example.swf.html. I thought it should work because the shown examples are much more complex than this.But it doesn't work ,the window is white.
Sorry for my English
Cheers,theunreplicated

In the racing demo, best lap shows the last lap and not the best lap.

In the racing demo, best lap shows the last lap and not the best lap.

Simple Flex SWF results in Error: Cannot find property public::public _simpletest_mx_managers_SystemManager

[15:03:32.010] Error: Cannot find property public::public _simpletest_mx_managers_SystemManager @ http://localhost/shumway/src/avm2/util.js:22

This is with "developer" branch.

SWF at http://people.mozilla.org/~bsmedberg/simpletest.swf

Faceyourmanga.com KO

Faceyourmanga application not working

http://www.faceyourmanga.com

Skipping through timeline is broken

When jumping back and forth in the timeline (skipping multiple frames), display list is not constructed correctly.

request for h.264 support

I installed the firefox extension from current (5 July 2012) git master, then viewed http://vimeo.com. I was greeted by an "oops" message. Screencapture is attached.

What needs to be done to support H.264 with Shumway?

constructChildren is called twice on initialization

For a simple SWF that adds some children to the stage, constructChildren() is called twice. Once by the Sprite constructor, and once by the initial nextFrame(), which actually sets the frame number to 1.

This means that some frame scripts could be referencing the wrong child.

avm2 compiler fails to execute flash compiled switch statement

here is the test:

var f = function() {
  switch (0) {
  case 0:
      trace('PASS');
      break;
  }
};

f();
trace('OK');

avm2 compiles the f function as:

[function fn4 ($SS) {
Runtime.stack.push($C[0]);
var $S = $SS, $O = $S.object, $G = $S.global.object, $S = $SS;
var a, b;
a = 0;
if (0 !== a) {
s0 = 1;
} else {
s0 = 0;
}
a = undefined;
switch (s0) {
case 0: {
$S.findProperty($C[19], $C[3], true).public$trace.call($S.findProperty($C[19], $C[3], true), 'PASS');
break;
}
case 1:
default: {
break;
}
}
if ($label === 4) { // <!-- fails here
}
Runtime.stack.pop();
return;
}][0]

asc.jar must be version 1.0 build 23188 (from Common/Configuration/ActionScript 3.0; one from ftp://ftp.mozilla.org/pub/js/tamarin/builds/asc/latest/asc.jar does not compile function as a switch)

Extremely slow performance when mouse is inside

I have the latest Shumway extension. When I go to http://mozilla.github.com/shumway/examples/racing/race3.swf directly and have my mouse outside of the <canvas> element (anywhere in the window, even on the "Shumway X" text - just not on the <canvas>) it runs at normal speed.

However, if the mouse enters the <canvas> element, the performance goes down by AT LEAST a factor of 2. It feels really, really sluggish.

I am on Windows 7 (64bit), FF 19 (32bit), latest Shumway.

Implement support for masks

This includes timeline clipping (clipDepth) and masking (DisplayObject::mask)

Incorrect drawing of lines and bad performance.

See: examples/timeline/Timeline6.swf

Overlapping lines are not rendered correctly and performance degrades very quickly.

Progressive download of the SWF file

It takes some time to download whole swf. It will be nice to start the rendering of the partial data.

Vector3D

package
{
import flash.display.Sprite;
import flash.events.Event;
import flash.geom.Vector3D;
import flash.utils.getTimer;

public class Main extends Sprite 
{
    private static var  vect3D:Vector3D = new Vector3D( 0, 0, 0); 
    public function Main():void 
    {  
    }
}

}

// Special case Object, which has no base class but needs the Class class on the scope.

if (!baseClass) {
scope = new Scope(scope, domain.system.Class);
}
scope = new Scope(scope, null);
/*******
**
*
makeNativeClass is undefined at this pos with the precedent class
*
*
*/

cls = makeNativeClass(this, scope, this.createFunction(ii.init, scope), baseClass);
cls.classInfo = classInfo;
cls.scope = scope;
scope.object = cls;
if ((instance = cls.instance)) {
// Instance traits live on instance.prototype.
this.applyTraits(instance.prototype, scope, baseBindings, ii.traits,
cls.native ? cls.native.instance : undefined, true);
}

Hit areas are placed wrong for buttons

See examples/audio/mp3_player.swf, move your mouse over the "next" button, the state of the "previous" button changes. Hit areas are are shifted to the right.

MouseOut is not always firing on interactive objects

See examples/audio/mp3_player.swf, move your mouse over and out of the play button. State doesnt change from MouseOver to MouseOut.

Incorrect currentFrame reporting.

See examples/timeline/timeline-1.swf

TypeError: l32 is undefined

Shumway version: 0.5.1

1. Open http://games.adultswim.com/westerado-action-online-game.html
2. Error in the console:

TypeError: l32 is undefined @ resource://shumway/avm2/runtime.js:1002

Incorrect handling of child MovieClip frame actions.

Single frame child movie clips should not have their frame actions repeated. See: examples/timeline/Timeline4.swf

Fix mouseMove events

mouseMove events are fired continually if mouse is inside an InteractiveObject, even if the position doesn't really change.

Starfall hangs Firefox 21.0a2

http://www.starfall.com/n/level-k/index/load.htm?f is blank and hangs Firefox using 100% of a single CPU.

Initialize timeline in MovieClip

Display list for first frame should be constructed at MovieClip initialization.

Mouse events are completely broken for _mouseChildren=false; DisplayObjects

I'm not sure how to describe this, other than in terms of the event flow. Imagine a Sprite with two children, and _mouseChildren = false;, and the mouse over the first child. The flow:

1. PreVisitor visits the sprite, does a hit test, finds nothing. Visits the children.
2. Since _mouseChildren = false;, interactiveParent is the sprite.
3. Child 1 gets hit tested, it passes, so we queue up a mouseover event on the interactiveParent, and set the click target to it.
4. Child 2 gets hit tested, it fails. We queue up a mouseout event on theinteractiveParent, and set the click target to null, as it was previously the hit target.

This breaks SimpleButtons, and causes them not to have the hover state. I was working on useHandCursor, and ran into this.

Incorrect handling of child MovieClip constructors.

See: examples/timeline/Timeline3.swf

Two separate issues here:

1. The constructor of Timeline3Box should only be called once.
2. The Timeline3Box frame action should only be executed once.

See the order of events here:

http://blog.johannest.com/2009/05/22/the-movieclip-life-cycle-event-frame_constructed-and-event-exit_frame/

XML Support

Implement point-in-stroke in JavaScript

.. to support other browsers.

stroke-to-path algorithm might be considered

Implement support for button mode

If Sprite::buttonMode is true, sprites and instances of subclasses should act like a button (e.g. receives release events). If the instance is of type MovieClip and includes frames labeled _up, _over, and _down, automatic state changes should be provided.

Reuse/Reduce Event Objects

See examples/timeline/TimelineEvents.swf and examples/timeline/TimelineEventsStress.swf. Currently a new enter/exitFrame event object is created and fired for each movie clip. This can lead to thousands of events per second and we should try to reuse the event objects. In TimelineEvents.swf, the flash player reuses the enterFrame event object.

Passing flash variables to SWFs

per https://twitter.com/tobeytailor/status/269812225819172864

First frame of child movie clip is skipped over on second loop.

See: examples/timeline/Timeline8.swf

After one revolution, the last frame of the child movie clip is rendered twice, and then the second frame is rendered.

Font promises are resolved immediately

We should implement decent async load handling here.

control of imports and classes

Add a control of imports and classes used to throw an error if abcense of a class.
example:
Native class flash.geom.Vector3D not exist in the stack class inheritance of test class

Flash detection not working

I have just tested Shumway on a site and saw no flash content.
This was caused by the site using a Flash detection script that checked

navigator.plugins["Shockwave Flash"].description 

to ensure a compatible version of Flash could be found.

I'm not sure what can be done about this as the plugins collection is read-only. The only thing that leaps to mind is having a dummy plug-in that has a name of Shockwave Flash, but that seems messy

Cache static content to improve rendering performance

Render static content to off-screen canvases for simple/faster compositing.

Implementing FSCommand

I would like to implement FSCommand, which should be a few lines patch.
I need to intercept getURL, which is how FSCommand is implemented in AS2 bytecode, and also be able to retrieve the id of the swf element (or container).

FSCommand callbacks are called in this form:
getURL("FSCommand:[command]","[args]")
which should in turn execute the function:
[swf element id]_DoFSCommand([command],[args])

Add update mechanism to the extension

To allow others to participate on the project you might want to add the update mechanism to the extension. That means you would have to place an update.rdf file onto the gh-pages which references the latest version of the extension. Further in the install.rdf a reference to this update.rdf file has to be placed.

With that users wouldn't have to install a new version of the add-on after manually checking, but would get it automatically.

Thanks.