=head1 VERSION
-Version 0.01
+Version 0.02
=cut
-our $VERSION = '0.01';
+our $VERSION = '0.02';
-use LaTeX::TikZ::Set::Mod;
+use LaTeX::TikZ::Context;
+use LaTeX::TikZ::Scope;
use LaTeX::TikZ::Tools;
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',
+ isa => 'Maybe[ArrayRef[LaTeX::TikZ::Mod]]',
+ init_arg => 'mods',
+ default => sub { [ ] },
+ lazy => 1,
);
-sub mod {
- my $set = $_[0];
+sub mods { @{$_[0]->_mods} }
- return $set unless @_ > 1;
+=head1 METHODS
- # If $set is already a Tikz::Set::Mod object, the overridden method is
- # called instead. This ensures that you can't have two T::S::M objects in a
- # row.
+This method is required by the interface :
- # Prepend a new set with the mods
- my $new = LaTeX::TikZ::Set::Mod->new(
- set => $set,
- mods => [ @_[1 .. $#_] ],
- );
+=over 4
- $_[0] = $new unless defined wantarray;
+=item *
- $new;
-}
+C<draw $formatter, $context>
+
+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>.
+The current evaluation context is passed as the L<LaTeX::TikZ::Context> object C<$context>.
+
+=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;
+
+ my @mods = map $ltm_tc->coerce($_), @_;
+ $ltm_tc->assert_valid($_) for @mods;
+
+ push @{$set->_mods}, @mods;
+
+ $set;
+}
+
+around 'draw' => sub {
+ my ($orig, $set, $tikz, $pcxt) = @_;
+
+ my $cxt = LaTeX::TikZ::Context->new(
+ parent => $pcxt,
+ mods => [ $set->mods ],
+ );
+
+ my $body = $set->$orig($tikz, $cxt);
+
+ my @mods = $cxt->effective_mods;
+ if (@mods) {
+ $body = LaTeX::TikZ::Scope->new(
+ mods => [ map $_->apply($tikz), @mods ],
+ body => $body,
+ );
+ }
+
+ $body;
+};
+
+=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;
+ my $set = shift;
- my $layer = $_[1];
+ return $set unless @_;
- $_[0]->mod(
+ my $layer = $_[0];
+ $set->mod(
$ltml_tc->check($layer) ? $layer
: LaTeX::TikZ::Mod::Layer->new(name => $layer)
)
}
+=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;
+ my $set = shift;
+
+ return $set unless @_;
- $_[0]->mod(
+ $set->mod(
map {
- $ltmc_tc->check($_) ? $_ : LaTeX::TikZ::Mod::Clip->new($_)
- } @_[1 .. $#_]
+ $ltmc_tc->check($_) ? $_ : LaTeX::TikZ::Mod::Clip->new(clip => $_)
+ } @_
)
}
+=head1 SEE ALSO
+
+L<LaTeX::TikZ>.
+
=head1 AUTHOR
Vincent Pit, C<< <perl at profvince.com> >>, L<http://www.profvince.com>.