X-Git-Url: http://git.vpit.fr/?a=blobdiff_plain;f=lib%2FLaTeX%2FTikZ%2FMod%2FLayer.pm;h=fda3d59559a0bd3623b9682655dadc58103eb4a7;hb=0f9d7c1a2d11bc7001fe450cb2086e67c13a39e9;hp=f8d57a2c04e0185ef7c6408573ab6ec541a7dd60;hpb=e8f0879ade07eed4f58cd52c0771f4e1ecc90b09;p=perl%2Fmodules%2FLaTeX-TikZ.git

diff --git a/lib/LaTeX/TikZ/Mod/Layer.pm b/lib/LaTeX/TikZ/Mod/Layer.pm
index f8d57a2..fda3d59 100644
--- a/lib/LaTeX/TikZ/Mod/Layer.pm
+++ b/lib/LaTeX/TikZ/Mod/Layer.pm
@@ -15,21 +15,40 @@ Version 0.01
 
 our $VERSION = '0.01';
 
-use List::Util ();
+use Scalar::Util ();
+use List::Util   ();
 
 use LaTeX::TikZ::Mod::Formatted;
 
+use LaTeX::TikZ::Interface;
+
 use Any::Moose;
 use Any::Moose 'Util::TypeConstraints';
 
+=head1 RELATIONSHIPS
+
+This class consumes the L<LaTeX::TikZ::Mod> role, and as such implements the L</tag>, L</cover>, L</declare> and L</apply> methods.
+
+=cut
+
 with 'LaTeX::TikZ::Mod';
 
+=head1 ATTRIBUTES
+
+=head2 C<name>
+
+=cut
+
 has 'name' => (
  is       => 'ro',
  isa      => 'Str',
  required => 1,
 );
 
+=head2 C<above>
+
+=cut
+
 subtype 'LaTeX::TikZ::Mod::LevelList'
      => as 'ArrayRef[LaTeX::TikZ::Mod::Layer]';
 
@@ -51,6 +70,10 @@ has '_above' => (
 
 sub above { @{$_[0]->_above} }
 
+=head2 C<below>
+
+=cut
+
 has '_below' => (
  is       => 'ro',
  isa      => 'LaTeX::TikZ::Mod::LevelList',
@@ -69,6 +92,10 @@ has '_score' => (
  builder  => '_build_score',
 );
 
+=head1 METHODS
+
+=cut
+
 my %layers;
 
 around 'new' => sub {
@@ -78,9 +105,11 @@ around 'new' => sub {
  if (defined $name) {
   $self->meta->find_attribute_by_name('name')
              ->type_constraint->assert_valid($name);
-  confess("Can't redefine layer '$name'") if keys(%args) > 1;
   my $layer = $layers{$name};
-  return $layer if defined $layer;
+  if (defined $layer) {
+   confess("Can't redefine layer '$name'") if keys(%args) > 1;
+   return $layer;
+  }
  }
 
  return $self->$orig(%args);
@@ -89,7 +118,9 @@ around 'new' => sub {
 sub BUILD {
  my ($self) = @_;
 
- $layers{$self->name} = $self;
+ my $name = $self->name;
+ $layers{$name} = $self;
+ Scalar::Util::weaken($layers{$name});
 }
 
 sub DEMOLISH {
@@ -98,14 +129,26 @@ sub DEMOLISH {
  delete $layers{$self->name};
 }
 
+=head2 C<tag>
+
+=cut
+
 sub tag {
  my ($self) = @_;
 
  ref($self) . '/' . $self->name;
 }
 
+=head2 C<cover>
+
+=cut
+
 sub cover { $_[0]->name eq $_[1]->name }
 
+=head2 C<score>
+
+=cut
+
 {
  our %score;
 
@@ -155,6 +198,10 @@ sub cover { $_[0]->name eq $_[1]->name }
   $score{$name}
  }
 
+=head2 C<declare>
+
+=cut
+
  sub declare {
   shift;
 
@@ -168,15 +215,21 @@ sub cover { $_[0]->name eq $_[1]->name }
                 map { ref() ? $_->name : $_ }
                  keys %score;
 
-  my $intro = join '',
-               map "\\pgfdeclarelayer{$_}\n",
-                grep $_ ne 'main',
-                 @layers;
+  my @intro = map "\\pgfdeclarelayer{$_}",
+               grep $_ ne 'main',
+                @layers;
 
-  $intro . "\\pgfsetlayers{" . join(',', @layers) . "}\n";
+  return (
+   @intro,
+   "\\pgfsetlayers{" . join(',', @layers) . "}",
+  );
  }
 }
 
+=head2 C<apply>
+
+=cut
+
 sub apply {
  my ($self) = @_;
 
@@ -186,16 +239,23 @@ sub apply {
  )
 }
 
-use LaTeX::TikZ::API layer => sub {
- shift;
+LaTeX::TikZ::Interface->register(
+ layer => sub {
+  shift;
 
- __PACKAGE__->new(name => $_[0]);
-};
+  my $name = shift;
+  __PACKAGE__->new(name => $name, @_);
+ },
+);
 
 __PACKAGE__->meta->make_immutable(
  inline_constructor => 0,
 );
 
+=head1 SEE ALSO
+
+L<LaTeX::TikZ>, L<LaTeX::TikZ::Mod>.
+
 =head1 AUTHOR
 
 Vincent Pit, C<< <perl at profvince.com> >>, L<http://www.profvince.com>.