X-Git-Url: http://git.vpit.fr/?a=blobdiff_plain;f=lib%2FLaTeX%2FTikZ%2FTools.pm;h=d2d1131146a50bb85a1b0cb439852843a15de2cf;hb=5d8e597c1d1be20b1098403e6bbb80d70e7fe566;hp=9a33324ea1dce4eb933e5f40b62b54088b5a5724;hpb=e8f0879ade07eed4f58cd52c0771f4e1ecc90b09;p=perl%2Fmodules%2FLaTeX-TikZ.git
diff --git a/lib/LaTeX/TikZ/Tools.pm b/lib/LaTeX/TikZ/Tools.pm
index 9a33324..d2d1131 100644
--- a/lib/LaTeX/TikZ/Tools.pm
+++ b/lib/LaTeX/TikZ/Tools.pm
@@ -5,41 +5,86 @@ use warnings;
=head1 NAME
-LaTeX::TikZ::Tools - Miscellanous tools for LaTeX::TikZ classes.
+LaTeX::TikZ::Tools - Miscellaneous tools for LaTeX::TikZ classes.
=head1 VERSION
-Version 0.01
+Version 0.02
=cut
-our $VERSION = '0.01';
+our $VERSION = '0.02';
use Any::Moose 'Util::TypeConstraints' => [ 'find_type_constraint' ];
+=head1 CONSTANTS
+
+=head2 C
+
+The numerical accuracy enforced by L, L and L.
+It is currently set to C<1e-10>.
+
+=cut
+
use constant EPS => 1e-10;
+=head1 FUNCTIONS
+
+=head2 C
+
+Returns true if and only if C<$x> and C<$y> are equal up to L.
+
+=cut
+
sub numeq { abs($_[0] - $_[1]) < EPS }
+=head2 C
+
+Returns a negative number, zero, or a positive number when C<$x> is respectively smaller than, equal to, or greater than C<$y> up to L.
+
+=cut
+
sub numcmp { $_[0] < $_[1] - EPS ? -1 : $_[0] > $_[1] + EPS ? 1 : 0 }
+=head2 C
+
+Returns the closest integer from C<$x> up to L.
+
+=cut
+
sub numround {
my $x = $_[0];
my $i = int $x;
$x + EPS < $i + 0.5 ? $i : $i + 1;
}
+=head2 C
+
+Finds the type constraint for C<$class> by first trying to load the relevant F<.pm> file.
+
+=cut
+
sub type_constraint {
my ($class) = @_;
my $file = $class;
$file =~ s{::}{/}g;
$file .= '.pm';
- require $file;
+ unless ($INC{$file}) {
+ local $@;
+ eval {
+ local $SIG{__DIE__}; # See LaTeX::TikZ::Meta::TypeConstraint::Autocoerce
+ require $file;
+ }
+ }
find_type_constraint($class);
}
+=head1 SEE ALSO
+
+L.
+
=head1 AUTHOR
Vincent Pit, C<< >>, L.