Graphics::Grid::Grob::Polyline - Polyline grob
version 0.001
use Graphics::Grid::Grob::Polyline; use Graphics::Grid::GPar; my $polyline = Graphics::Grid::Grob::Polyline->new( x => [ ( map { $_ / 10 } ( 0 .. 4 ) ), (0.5) x 5, ( map { $_ / 10 } reverse( 6 .. 10 ) ), (0.5) x 5 ], y => [ (0.5) x 5, ( map { $_ / 10 } reverse( 6 .. 10 ) ), (0.5) x 5, ( map { $_ / 10 } ( 0 .. 4 ) ), ], id => [ ( 1 .. 5 ) x 4 ], gp => Graphics::Grid::GPar->new( col => [qw(black red green3 blue cyan)], lwd => 3, ) ); # or use the function interface use Graphics::Grid::Functions qw(:all); my $polyline = polyline_grob(%params);
This class represents a polyline graphical object.
A Grahpics::Grid::Unit object specifying x-values.
Default to unit([0, 1], "npc").
unit([0, 1], "npc")
A Grahpics::Grid::Unit object specifying y-values.
x and y combines to define the points in the lines. x and y shall have same length. For example, the default values of x and y defines a line from point (0, 0) to (1, 1). If they have less than two elements, it is surely not enough to make a line and nothing would be drawn.
x
y
An array ref used to separate locations in x and y into multiple lines. All locations with the same id belong to the same line.
id needs to have the same length as x and y.
id
If id is not specified then all points would be regarded as being in one line.
An object of Graphics::Grid::GPar. Default is an empty gpar object.
A viewport object. When drawing a grob, if the grob has this attribute, the viewport would be temporily pushed onto the global viewport stack before drawing takes place, and be poped after drawing. If the grob does not have this attribute set, it would be drawn on the existing current viewport in the global viewport stack.
Get number of sub-elements in the grob.
Grob classes shall implement a _build_elems() method to support this attribute.
_build_elems()
This is an alias of elems.
elems
Returns info about the grob's extents (bounding box, etc) on the drawing layer, in cm.
Note that not all grob classes have got this method implemented.
For this module elems returns the number of lines (number of unique id) of a object.
Get unit indexes of attributes x, y, id, for a given id.
Returns an array ref.
Return an array ref of unique ids.
Graphics::Grid::Functions
Graphics::Grid::Grob
Stephan Loyd <sloyd@cpan.org>
This software is copyright (c) 2018-2023 by Stephan Loyd.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install Graphics::Grid, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Graphics::Grid
CPAN shell
perl -MCPAN -e shell install Graphics::Grid
For more information on module installation, please visit the detailed CPAN module installation guide.