Brian Cassidy > Image-TextMode-Reader-ANSI-XS-0.11 > Image::TextMode::Reader::ANSI::XS

Download:
Image-TextMode-Reader-ANSI-XS-0.11.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.11   Source  

NAME ^

Image::TextMode::Reader::ANSI::XS - Fast ANSI image parsing

SYNOPSIS ^

    # The XS reader will automatically be used instead of the pure-perl version
    my $ansi = Image::TextMode::Format::ANSI->new
    $ansi->read( shift );

DESCRIPTION ^

To parse an ANSI file, we use a simple state machine and examine each character individually. This proves to be a little on the slow side in pure-perl form.

This module endeavors to re-implement the parsing in XS/C. The results show a major speed increase; about 25 times faster.

INSTALLATION ^

        perl Makefile.PL
        make
        make test
        make install

METHODS ^

_read( $image, $fh, \%options )

This is an XS-based version of Image::TextMode::Reader::ANSI's method of the same name.

BENCHMARK ^

    Image::TextMode version 0.22
    Image::TextMode::Reader::ANSI::XS version 0.09
    Filesize: 75501 bytes
    Benchmark: timing 50 iterations of PP, XS...
            PP: 33 wallclock secs (32.03 usr +  0.01 sys = 32.04 CPU) @  1.56/s (n=50)
            XS:  1 wallclock secs ( 1.59 usr +  0.03 sys =  1.62 CPU) @ 30.86/s (n=50)
         Rate    PP    XS
    PP 1.56/s    --  -95%
    XS 30.9/s 1878%    --

AUTHOR ^

Brian Cassidy <bricas@cpan.org>

COPYRIGHT AND LICENSE ^

Copyright 2009-2013 by Brian Cassidy

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

syntax highlighting: