NAME

SWF::Builder::Gradient - SWF gradient object.

SYNOPSIS

    my $gr = $mc->new_gradient;
    $gr->add_color(   0 => '000000',
                     98 => '0000ff',
                    128 => 'ff0000',
                    158 => '0000ff',
                    255 => '000000',
                   );

    my $gm = $gr->matrix;
    my $shape = $mc->new_shape
        ->fillstyle($gr, 'linear', $gm)
        ->moveto( ... )
        ->lineto( ... )-> ... ;
    $gm->fit_to_rect(longer => $shape->get_bbox);

DESCRIPTION

Gradient object is a kind of fill styles of shapes. Colors are interpolated between the control points determined by ratios. Each gradient has 1-8 control points.

$gr = $mc->new_gradient: returns a new gradient object.
$gr->add_color( $ratio, $color [, $ratio, $color ...]): adds control points of the gradient. $ratio is a position of the point. 0 maps to left/center and 255 to right/outer for linear/radial gradient. $color can take a six or eight-figure hexadecimal string, an array reference of R, G, B, and optional alpha value, an array reference of named parameters such as [Red => 255], and SWF::Element::RGB/RGBA object.
$gm = $gr->matrix: returns a transformation matrix for the gradient.
$gm->fit_to_rect( $mode => @rect ): transforms the gradient matrix to fit to the rectangle. $mode can take as follows:

fit: to fit the gradient square to the rectangle. It does not keep proportion.
width: to fit the gradient square to the width of the rectangle, and scales it with keeping proportion.
height: to fit the gradient square to the height of the rectangle, and scales it with keeping proportion.
longer: to fit the gradient square to the longer side of the rectangle, and scales it with keeping proportion.
shorter: to fit the gradient square to the shorter side of the rectangle, and scales it with keeping proportion.

COPYRIGHT

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