=head1 VERSION
-Version 0.01
+Version 0.02
=cut
-our $VERSION = '0.01';
+our $VERSION = '0.02';
use Scope::Guard ();
use Any::Moose 'Role';
-requires qw(
- draw
-);
+=head1 ATTRIBUTES
+
+=head2 C<mods>
+
+Returns the list of the L<LaTeX::TikZ::Mod> objects associated with the current set.
+
+=cut
has '_mods' => (
is => 'ro',
sub mods { @{$_[0]->_mods} }
+=head1 METHODS
+
+This method is required by the interface :
+
+=over 4
+
+=item *
+
+C<draw $formatter>
+
+Returns an array reference of TikZ code lines required to effectively draw the current set object, formatted by the L<LaTeX::TikZ::Formatter> object C<$formatter>.
+
+=back
+
+=cut
+
+requires qw(
+ draw
+);
+
+=head2 C<mod @mods>
+
+Apply the given list of L<LaTeX::TikZ::Mod> objects to the current set.
+
+=cut
+
my $ltm_tc = LaTeX::TikZ::Tools::type_constraint('LaTeX::TikZ::Mod');
my $ltml_tc = LaTeX::TikZ::Tools::type_constraint('LaTeX::TikZ::Mod::Layer');
my $ltmc_tc = LaTeX::TikZ::Tools::type_constraint('LaTeX::TikZ::Mod::Clip');
sub mod {
my $set = shift;
- push @{$set->_mods},
- map { $ltm_tc->check($_) ? $_ : $ltm_tc->coerce($_) }
- @_;
+ my @mods = map $ltm_tc->coerce($_), @_;
+ $ltm_tc->assert_valid($_) for @mods;
+
+ push @{$set->_mods}, @mods;
$set;
}
our %mods;
our $last_mod = 0;
- sub mods_unique {
- my ($set) = @_;
-
- my (@mods, $has_layer);
-MOD:
- for my $mod ($set->mods) {
- $has_layer = 1 if $ltml_tc->check($mod);
- my $tag = $mod->tag;
- my $old = $mods{$tag} || [];
- for (@$old) {
- next MOD if $_->[0]->cover($mod);
- }
- push @{$mods{$tag}}, [ $mod, $last_mod++ ];
- push @mods, $mod;
- }
-
- if ($has_layer) {
- # Clips and mods don't propagate through layers. Hence if a layer is set,
- # force their reuse.
- @mods = map $_->[0], sort { $a->[1] <=> $b->[1] } map @$_, values %mods;
- }
-
- return @mods;
- }
-
around 'draw' => sub {
my ($orig, $set, $tikz) = @_;
}
});
- my @mods = $set->mods_unique;
+ my (@mods, $last_layer);
+MOD:
+ for my $mod ($set->mods) {
+ my $is_layer = $ltml_tc->check($mod);
+ $last_layer = $mod if $is_layer;
+ my $tag = $mod->tag;
+ my $old = $mods{$tag} || [];
+ for (@$old) {
+ next MOD if $_->[0]->covers($mod);
+ }
+ push @{$mods{$tag}}, [ $mod, $last_mod++, $is_layer ];
+ push @mods, $mod;
+ }
+
+ if ($last_layer) {
+ # Clips and mods don't propagate through layers. Hence if a layer is set,
+ # force their reuse.
+ @mods = $last_layer;
+ push @mods, map $_->[0],
+ sort { $a->[1] <=> $b->[1] }
+ grep !$_->[2],
+ map @$_,
+ values %mods;
+ }
my $body = $set->$orig($tikz);
};
}
+=head2 C<layer $layer>
+
+Puts the current set in the corresponding layer.
+This is a shortcut for C<< $set->mod(Tikz->layer($layer)) >>.
+
+=cut
+
sub layer {
return $_[0] unless @_ > 1;
)
}
+=head2 C<clip $path>
+
+Clips the current set by the path given by C<$path>.
+This is a shortcut for C<< $set->mod(Tikz->clip($path)) >>.
+
+=cut
+
sub clip {
return $_[0] unless @_ > 1;
$_[0]->mod(
map {
- $ltmc_tc->check($_) ? $_ : LaTeX::TikZ::Mod::Clip->new($_)
+ $ltmc_tc->check($_) ? $_ : LaTeX::TikZ::Mod::Clip->new(clip => $_)
} @_[1 .. $#_]
)
}
+=head1 SEE ALSO
+
+L<LaTeX::TikZ>.
+
=head1 AUTHOR
Vincent Pit, C<< <perl at profvince.com> >>, L<http://www.profvince.com>.