NAME

NAME
SWF::ForcibleConverter - Convert SWF file into version 9 format forcibly
if version is under 9

SYNOPSIS
use SWF::ForcibleConverter;

my $fc = SWF::ForcibleConverter->new;
my $size = $fc->convert9($input, $output);

DESCRIPTION
SWF::ForcibleConverter is a utility that converts SWF file into version
9 format forcibly.

This program processes SWF that has version number of format less than
9. And version 9 or upper versions will be treated as it is, without
converting, except compressibility change.

A reason of the changing is convenient for my algorithm, it inflates a
file once. But this point does not become a problem.

CONSTRUCTOR
The constructor new() receives hash reference as an option.

my $fc = SWF::ForcibleConverter->new({
buffer_size => 4096,
});

The option has following key that is available.

buffer_size
Buffer size (bytes) when reading input data.

At least 4096 is required, or croak.

Default is 4096.

METHOD
On the following explanation, $input or $output are file path or opened
IO object.

Both are omissible. In that case, it uses STDIN or STDOUT.

As follows, this is convenient because of pipe processing.

$ cat in.swf | perl -MSWF::ForcibleConverter -e \
'SWF::ForcibleConverter->new->convert9' > out.swf

Note that when using STDIO, uncompress() or convert9*() can be called
only once.

buffer_size([$num])
This is accessor. When $num is given, it sets the member directly,
without validation. Regularly, please use [get|set]_buffer_size methods.

get_buffer_size
Get buffer size.

set_buffer_size($num)
Set buffer size.

At least 4096 is required, or croak.

version($input)
Get version number of SWF file.

is_compressed($input)
Return true if $input is compressed.

uncompress($input, $output)
Convert $input SWF into uncompressed $output SWF.

This method does not change version format, simply outputs with
uncompressing.

convert9($input, $output)
my $input = "/path/to/original.swf";
my $output = "converted.swf";
my $bytes = $fc->convert9($input, $output);

Convert $input SWF into $output SWF with changing version 9 format
forcibly. And it returns size of $output.

Note that if the $input is compressed format, that is known as CWS,
$output will be CWS as well. The another case is uncompressed, as FWS.
You can call convert9_compress() or convert9_uncompress() instead.

convert9_compress($input, $output)
convert9_compress() is the same as convert9() except $output is always
compressed (that is CWS).

convert9_uncompress($input, $output)
convert9_uncompress() is the same as convert9() except $output is always
uncompressed (that is FWS).

REPOSITORY
SWF::ForcibleConverter is hosted on github
https://github.com/hiroaki/SWF-ForcibleConverter

AUTHOR
WATANABE Hiroaki <[email protected]>

This library is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.

SEE ALSO
SWF::ForcibleConverter was prepared with reference to "ForcibleLoader"
that is produced by Spark project with the kind of respect:

<http://www.libspark.org/wiki/yossy/ForcibleLoader>