NAME

Mail::Thread::Arc - Generates a Thread Arc reperesentation of a thread

SYNOPSIS

 my $threader = Mail::Thread->new( @messages );
 my $arc = Mail::Thread::Arc->new;

 $threader->thread;

 my $i;
 for my $thread ($threader->rootset) {
     ++$i;
     my $svg = $arc->render( $thread );
     write_file( "thread_$i.svg", $svg->xmlify );
 }

DESCRIPTION

Mail::Thread::Arc takes a Mail::Thread::Container and generates an image of the Thread Arc. Thread Arcs are described in the documentation for IBM's remail project.

http://www.research.ibm.com/remail/

METHODS

new

Generic constructor, inherited from Class::Accessor::Chained::Fast

render( $root_container, %options )

The main method.

Renders the thread tree as a thread arc. Returns an SVG object.

draw_message( $message )

Draw the message on the SVG canvas.

make_link( $message )

Return an URI based on the message. By default returns undef meaning that that the message is not a link.

However if this module is subclassed then a meaningful URI can be returned where appropriate.

draw_arc( $from, $to )

draws an arc between two messages

message_radius

The radius of the message circles. The most magic of all the magic numbers.

message_style( $container )

Returns the style hash for the message circle.

maximum_arc_height

the maximum height of an arc. default is 17 message radii

arc_style( $from, $to )

Returns the style hash for the connecting arc,

message_x( $container )

returns the X co-ordinate for a message

message_y

returns the Y co-ordinate for a message (expected to be constant for all messages)

thread_generation( $message )

returns the thread generation of the container.

date_of( $container )

The date the message was sent, in epoch seconds

AUTHOR

Richard Clamp <richardc@unixbeard.net>

COPYRIGHT

Copyright (C) 2003 Richard Clamp. All Rights Reserved.

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

SEE ALSO

ReMail, the IBM Research project that implements Thread Arcs.

http://unixbeard.net/~richardc/mta/ - some sample output, alongside .pngs created with batik-rasteriser.

Mail::Thread, Mail::Thread::Chronological, SVG

cpanm Mail::Thread::Arc

perl -MCPAN -e shell
install Mail::Thread::Arc