]>
iEval git - image-openalpr.git/blob - lib/Image/OpenALPR/PlateResult.pm
1 package Image
::OpenALPR
::PlateResult
;
7 use overload
'""' => sub { shift->plate }, fallback
=> 1;
8 use parent qw
/Class::Accessor::Fast/;
10 our $VERSION = '0.001001';
12 __PACKAGE__
->mk_ro_accessors(qw
/plate confidence matches_template/);
15 my $coords = shift->{coordinates
};
16 return unless $coords;
17 my @result = map { [$_->{x
}, $_->{y
}] } @
$coords;
18 wantarray ?
@result : \
@result
22 my $cands = shift->{candidates
};
24 my @result = map { __PACKAGE__
->new($_) } @
$cands;
25 wantarray ?
@result : \
@result
35 Image::OpenALPR::PlateResult - a license plate, as identified by OpenALPR
39 my $plate = $alpr->recognise('t/example.jpg');
41 say $plate->plate; # ZP36709
42 say $plate->confidence; # 92.373634
43 my @coords = $plate->coordinates; # [306, 351], [476, 351], [476, 384], [306, 384]
44 my @candidates = $plate->candidates;
45 say $candidates[1]->plate; # ZP367O9
46 say $candidates[1]->confidence; # 89.812302
50 Image::OpenALPR::PlateResult is a class representing a plate
51 identified by OpenALPR. It offers the following methods:
55 =item $plate->B<plate>
57 The plate number that has the highest confidence value (likelihood of
58 being correct). An object of this class will stringify to the return
61 =item $plate->B<confidence>
63 The confidence value of the plate number returned by B<plate>.
65 =item $plate->B<matches_template>
67 True if the plate matches the plate pattern chosen via the
68 B<set_default_region> in L<Image::OpenALPR>, false otherwise (or if no
71 =item $plate->B<coordinates>
73 In list context, returns a four element list representing the vertices
74 of the license plate, numbered clock-wise from top-left. Each element
75 is an arrayref with two elements: the X coordinate followed by the Y
78 In scalar context, returns an arrayref to an array containing the list
81 =item $plate->B<candidates>
83 In list context, returns a list of candidate license numbers, in
84 decreasing order of confidence. The first element coincides with the
85 plate/confidence pair returned by the B<plate> and B<confidence>
86 methods. Each element is a partial Image::OpenALPR::PlateResult object
87 -- only the B<plate>, B<confidence> and B<matches_template> methods
88 will return a meaningful value.
94 Marius Gavrilescu, E<lt>marius@ieval.roE<gt>
96 =head1 COPYRIGHT AND LICENSE
98 Copyright (C) 2016 by Marius Gavrilescu
100 This file is part of Image-OpenALPR.
102 Image-OpenALPR is free software: you can redistribute it and/or modify
103 it under the terms of the GNU Affero General Public License as published by
104 the Free Software Foundation, either version 3 of the License, or
105 (at your option) any later version.
107 Image-OpenALPR is distributed in the hope that it will be useful,
108 but WITHOUT ANY WARRANTY; without even the implied warranty of
109 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
110 GNU Affero General Public License for more details.
112 You should have received a copy of the GNU Affero General Public License
113 along with Image-OpenALPR. If not, see <http://www.gnu.org/licenses/>
This page took 0.052811 seconds and 4 git commands to generate.