$Header: /home/cvs/swfmill/README,v 1.5 2005/04/10 10:18:48 dan Exp $


WHAT IS SWFMILL?

swfmill is a tool to process Shockwave Flash(TM) (SWF) files.
It can convert SWF from and to an XML-dialect called "swfml", 
which is closely modeled after the SWF file format.

It also provides a libxslt-based XSL transformator that
supports an extension ("swft") which helps with generating
IDs for SWF objects and can import an SWF as XML using an
XPath command (swft:document()).

As a simple application of such functionality, swfmill can
pack together a bunch of media files (currently jpeg, other
SWFs and TTF) into an SWF as "library objects" for your
attachMovie() pleasure.


WARNING

swfmill is alpha-quality software. It might well not work
as it should. Please report your experiences if that seems
to be the case, send in (if possible small) SWFs or patches.


DEPENDENCIES

swfmill requires, and the windows binary release contains
code from:
	libxml2 - (C) 1998-2003 Daniel Veillard. 
	libxslt - (C) 2001-2002 Daniel Veillard.
	zlib - (C) 1995-2004 Jean-loup Gailly and Mark Adler
	
my references to the SWF format were:
	Alexis' SWF Reference 
		http://sswf.sourceforge.net/SWFalexref.html
	SSWF sources
		http://sswf.sourceforge.net/
	MTASC sources
		http://mtasc.org/


COMPILING AND INSTALLING
	
on linux, use the "GNU-standard"
	./configure && make && make install

on windoze, if you have use for a tool like this,
you know better than me where to put swfmill.exe.
	
	
USAGE

see swfmill -h for general usage options.

convert an SWF (foo.swf) to XML:
	swfmill swf2xml foo.swf bar.xml
	
convert such XML to SWF:
	swfmill xml2swf bar.xml meep.swf

pack some jpegs into foo.swf:
	swfmill library 320:240:12 foo.jpg bar.jpg meep.swf
	
	the jpegs will exported (that is, placed in the
	library) under their basename. foo.jpg from above
	can be put on the stage from an attached script with:
	_root.attachMovie("foo","somenewname", 1 );


COPYRIGHT
	swfmill is (C) 2005, daniel fischer.
	swfmill is licensed to you under the GPL.
	see COPYING for details.
	

GETTING (INVOLVED)

	updates and stuff will be available at:
		http://iterative.org/swfmill/

	to praise or complain, send mail to:
		dan@subsignal.org

	i've set up a mailing list for bug reports and general
	discussion, to subscribe, send an empty mail to:
		swfmill-subscribe@subsignal.org
