Color.pm

filter: Statementstmt 88.8% 271 / 305 Branchbran 76.8% 169 / 220 Conditioncond 67.2% 80 / 119 MC/DCmcdc 43.2% 29 / 67 Subroutinesub 81.0% 30 / 37 Podpod 80.7% 21 / 26 totaltotal 77.5% 600 / 774 CC 157 SCAR 25.0
CC
157
Cov
81%
_split_named_args
33.2
mix
16.0
gradient
12.5
CRAP 12.2
« Color/Space/Shape.pm ↑ Summary Color/Calculator.pm »
1  
2 # public user level API: doc summary, help msg and arg cleaning
3  
4 package Graphics::Toolkit::Color;
5 5 our $VERSION = '2.22';
6 5 ▶use v5.12;
Subroutine BEGIN: called CC=1 SCAR=0.0
7 5 ▶use warnings;
Subroutine BEGIN: called CC=1 SCAR=0.0
8 5 ▶use Graphics::Toolkit::Color::Error qw/error/;
Subroutine BEGIN: called CC=1 SCAR=0.0
9 5 ▶use Graphics::Toolkit::Color::Space::Util qw/is_nr/;
Subroutine BEGIN: called CC=1 SCAR=0.0
10 5 ▶use Graphics::Toolkit::Color::SetCalculator;
Subroutine BEGIN: called CC=1 SCAR=0.0
11  
12 ## import export, error handling #######################################
13 5 ▶use Exporter;
Subroutine BEGIN: called CC=1 SCAR=0.0
14 5 our @ISA = qw(Exporter);
15 5 our @EXPORT_OK = qw/color is_in_gamut/;
16  
17 10 ▶sub import {
Subroutine import: called CC=3 SCAR=11.0
18 10 my ($class, @args) = @_;
19 10 my @export_symbols;
20 10 ▶ push @export_symbols, shift @args while @args and lc $args[0] ne 'error';
Branch: 1 branch
BranchTrueFalseTotal
@args and lc $args[0] ne "error" and do { push @export_symbols, shift @args } 6 10 16
Condition100%3/3
@args and lc $args[0] ne "error"
!ll&&!rl&&r
556
MC/DC100%2/2
@args and lc $args[0] ne "error"
@args lc $args[0] ne "error"
Truth table100%3/3
A and B
A= @argsB= lc $args[0] ne "error"
ABresult
0X0
100
111
21 10 Graphics::Toolkit::Color::Error::change_mode( $args[1] );
22 10 $class->Exporter::export_to_level(1, $class, @export_symbols);
23 }
24  
25 ## constructor #########################################################
26 5 my $POD_link = ' Type "perldoc Graphics::Toolkit::Color" for more help.';
27 75 ▶sub new {
Subroutine new: called CC=8 SCAR=20.8
Pod undocumented
28 75 my ($pkg, @args) = @_;
29 75 my $help = 'method "new" accepts the arguments: "color" (color definition), "raw", '.
30 '"range" and "in" (space name). "color" is the required and default argument.'.$POD_link;
31 75 my ($color_def, $space_name, $range_def, $is_raw);
32 75 ▶ if (@args > 0 and not @args % 2){
Branch: 1 branch
BranchTrueFalseTotal
if (@args > 0 and not @args % 2) 32 43 75
Condition100%3/3
@args > 0 and not @args % 2
!ll&&!rl&&r
14232
MC/DC100%2/2
@args > 0 and not @args % 2
@args > 0 not @args % 2
Truth table100%3/3
A and not(B)
A= @args > 0B= not @args % 2
ABresult
0X0
100
111
33 32 my %h = @args;
34 32 ▶ return error('got an argument twice') if keys(%h) * 2 < int(@args);
Branch: 1 branch
BranchTrueFalseTotal
if keys(%h) * 2 < int @args 1 31 32
35 31 ▶ ($color_def, $space_name, $range_def, $is_raw) = ($h{'color'}, $h{'in'}, $h{'range'}, $h{'raw'} // 0);
Condition100%2/2
$h{"raw"} // 0
l!l
427
MC/DC100%1/1
$h{"raw"} // 0
$h{"raw"}
Truth table100%2/2
A
A= $h{"raw"}
Aresult
11
00
36 }
37 74 ▶ $color_def = _color_def_into_scalar( @args ) unless defined $color_def;
Branch: 1 branch
BranchTrueFalseTotal
unless defined $color_def 67 7 74
38 74 ▶ return error($help) unless defined $color_def;
Branch: 1 branch
BranchTrueFalseTotal
unless defined $color_def 1 73 74
39 73 my $self = _new_from_scalar_def( $color_def, $space_name, $range_def, $is_raw );
40 73 ▶ return (ref $self) ? $self : error($self);
Branch: 1 branch
BranchTrueFalseTotal
ref $self ? : 41 32 73
41 }
42 25 ▶sub color {
Subroutine color: called CC=2 SCAR=6.9
Pod undocumented
43 25 my $self = _new_from_scalar_def( _color_def_into_scalar( @_ ) );
44 25 ▶ return (ref $self) ? $self : error($self);
Branch: 1 branch
BranchTrueFalseTotal
ref $self ? : 22 3 25
45 }
46 100 ▶sub _color_def_into_scalar {
Subroutine _color_def_into_scalar: called CC=6 SCAR=18.0
47 100 my (@args) = @_;
48 100 ▶ return if @args < 1 or @args > 8 or @args == 7;
Branch: 1 branch
BranchTrueFalseTotal
if @args < 1 or @args > 8 or @args == 7 3 97 100
Condition66%4/6
@args < 1 or @args > 8 or @args == 7
l!l&&r!l&&!r
3097
@args < 1 or @args > 8
l!l&&r!l&&!r
3097
MC/DC33%1/3
@args < 1 or @args > 8 or @args == 7
@args < 1 @args > 8 @args == 7
Truth table50%2/4
A or B or C
A= @args < 1B= @args > 8C= @args == 7
ABCresult
1XX1
01X1
0011
0000
49 97 ▶ return $args[0] if @args == 1; # pass names
Branch: 1 branch
BranchTrueFalseTotal
if @args == 1 58 39 97
50 39 ▶ return [@args] if @args <= 5; # lists and named lists --> array and named array
Branch: 1 branch
BranchTrueFalseTotal
if @args <= 5 22 17 39
51 17 return {@args}; # hashes without curly braces --> hash
52 }
53 148 ▶sub _new_from_scalar_def {
Subroutine _new_from_scalar_def: called CC=2 SCAR=6.9
54 148 my ($color_def, $space_name, $range_def, $is_raw) = @_;
55 148 ▶ return $color_def if ref $color_def eq __PACKAGE__;
Branch: 1 branch
BranchTrueFalseTotal
if ref $color_def eq __PACKAGE__ 11 137 148
56 137 return _new_from_value_obj( Graphics::Toolkit::Color::Values->new_from_any_input( $color_def, $space_name, $range_def, $is_raw ) );
57 }
58 315 ▶sub _new_from_value_obj {
Subroutine _new_from_value_obj: called CC=2 SCAR=6.9
59 315 my ($value_obj) = @_;
60 315 ▶ return $value_obj unless ref $value_obj eq 'Graphics::Toolkit::Color::Values';
Branch: 1 branch
BranchTrueFalseTotal
unless ref $value_obj eq "Graphics::Toolkit::Color::Values" 50 265 315
61 265 return bless {values => $value_obj};
62 }
63 254 ▶sub values_object { $_[0]->{'values'} if ref $_[0] eq __PACKAGE__}
Subroutine values_object: called CC=2 SCAR=7.6
Pod undocumented
Branch: 1 branch
BranchTrueFalseTotal
if ref $_[0] eq __PACKAGE__ 254 0 254
64  
65 13 ▶sub is_in_gamut {
Subroutine is_in_gamut: called CC=8 SCAR=20.9
Pod documented
66 13 my ($self, $space_name, $named_arg) = @_;
67 13 ▶ return is_in_gamut_sub (@_) if ref $self ne __PACKAGE__;
Branch: 1 branch
BranchTrueFalseTotal
if ref $self ne __PACKAGE__ 8 5 13
68 5 my $help = 'The method "is_in_gamut" accepts one optional, positional argument, a color space name, '.
69 'which defaults to the space the color was defined in'.$POD_link;
70 5 ▶ $space_name = $named_arg if defined $space_name and $space_name eq 'in' and defined $named_arg;
Branch: 1 branch
BranchTrueFalseTotal
if defined $space_name and $space_name eq "in" and defined $named_arg 1 4 5
Condition83%5/6
defined $space_name and $space_name eq "in" and defined $named_arg
!ll&&!rl&&r
401
defined $space_name and $space_name eq "in"
!ll&&!rl&&r
221
MC/DC66%2/3
defined $space_name and $space_name eq "in" and defined $named_arg
defined $space_name $space_name eq "in" defined $named_arg
Truth table75%3/4
A and B and C
A= defined $space_nameB= $space_name eq "in"C= defined $named_arg
ABCresult
0XX0
10X0
1100
1111
71 5 my $space = Graphics::Toolkit::Color::Space::Hub::get_space( $space_name );
72 5 ▶ return error($help) if defined $space_name and not ref $space;
Branch: 1 branch
BranchTrueFalseTotal
if defined $space_name and not ref $space 0 5 5
Condition66%2/3
defined $space_name and not ref $space
!ll&&!rl&&r
230
MC/DC0%0/2
defined $space_name and not ref $space
defined $space_name not ref $space
Truth table66%2/3
A and not(B)
A= defined $space_nameB= not ref $space
ABresult
0X0
100
111
73 5 ▶ $self->values_object->is_in_gamut( (ref $space) ? $space->name : undef );
Branch: 1 branch
BranchTrueFalseTotal
ref $space ? : 3 2 5
74 }
75 8 ▶sub is_in_gamut_sub {
Subroutine is_in_gamut_sub: called CC=2 SCAR=6.9
Pod undocumented
76 8 my (@color) = @_;
77 8 my $values = Graphics::Toolkit::Color::Values->new_from_any_input(
78 _color_def_into_scalar( @_ ), undef, undef, 1
79 );
80 8 ▶ return error($values.$POD_link) unless ref $values;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $values 1 7 8
81 7 $values->is_in_gamut( );
82 }
83  
84 ########################################################################
85 191 ▶sub _split_named_args {
Subroutine _split_named_args: called CC=26 SCAR=35.0
86 191 my ($raw_args, $only_parameter, $required_parameter, $optional_parameter, $parameter_alias) = @_;
87 0 ▶ @$raw_args = %{$raw_args->[0]} if @$raw_args == 1 and ref $raw_args->[0] eq 'HASH' and not
Branch: 1 branch
BranchTrueFalseTotal
if @$raw_args == 1 and ref $raw_args->[0] eq "HASH" and not defined $only_parameter && $only_parameter eq "to" && ref _new_from_scalar_def($raw_args) 0 191 191
Condition25%3/12
@$raw_args == 1 and ref $raw_args->[0] eq "HASH" and not defined $only_parameter && $only_parameter eq "to" && ref _new_from_scalar_def($raw_args)
!ll&&!rl&&r
19100
@$raw_args == 1 and ref $raw_args->[0] eq "HASH"
!ll&&!rl&&r
155360
defined $only_parameter && $only_parameter eq 'to' && ref _new_from_scalar_def($raw_args)
!ll&&!rl&&r
000
defined $only_parameter and $only_parameter eq "to"
!ll&&!rl&&r
000
MC/DC0%0/5
@$raw_args == 1 and ref $raw_args->[0] eq "HASH" and not defined $only_parameter && $only_parameter eq "to" && ref _new_from_scalar_def($raw_args)
@$raw_args == 1 ref $raw_args->[0] eq "HASH" defined $only_parameter $only_parameter eq "to" ref _new_from_scalar_def($raw_args)
Truth table33%2/6
A and B and not(C and D && E)
A= @$raw_args == 1B= ref $raw_args->[0] eq "HASH"C= defined $only_parameterD= $only_parameter eq "to"E= ref _new_from_scalar_def($raw_args)
ABCDEresult
0XXXX0
10XXX0
111110
110XX1
1110X1
111101
88 (defined $only_parameter and $only_parameter eq 'to' and ref _new_from_scalar_def( $raw_args ) );
89  
90 191 ▶ if (@$raw_args == 1 and defined $only_parameter and $only_parameter){
Branch: 1 branch
BranchTrueFalseTotal
if (@$raw_args == 1 and defined $only_parameter and $only_parameter) 35 156 191
Condition83%5/6
@$raw_args == 1 and defined $only_parameter and $only_parameter
!ll&&!rl&&r
156035
@$raw_args == 1 and defined $only_parameter
!ll&&!rl&&r
155135
MC/DC66%2/3
@$raw_args == 1 and defined $only_parameter and $only_parameter
@$raw_args == 1 defined $only_parameter $only_parameter
Truth table75%3/4
A and B and C
A= @$raw_args == 1B= defined $only_parameterC= $only_parameter
ABCresult
0XX0
10X0
1100
1111
91 35 ▶ return "The one default argument can not cover multiple, required parameter !" if @$required_parameter > 1;
Branch: 1 branch
BranchTrueFalseTotal
if @$required_parameter > 1 0 35 35
92 35 ▶ return "The default argument does not cover the required argument!"
Branch: 1 branch
BranchTrueFalseTotal
if @$required_parameter and $required_parameter->[0] ne $only_parameter 0 35 35
Condition66%2/3
@$required_parameter and $required_parameter->[0] ne $only_parameter
!ll&&!rl&&r
25100
MC/DC0%0/2
@$required_parameter and $required_parameter->[0] ne $only_parameter
@$required_parameter $required_parameter->[0] ne $only_parameter
Truth table66%2/3
A and B
A= @$required_parameterB= $required_parameter->[0] ne $only_parameter
ABresult
0X0
100
111
93 if @$required_parameter and $required_parameter->[0] ne $only_parameter;
94  
95 35 my %defaults = %$optional_parameter;
96 35 delete $defaults{$only_parameter};
97 35 return {$only_parameter => $raw_args->[0], %defaults};
98 }
99 156 my %clean_arg;
100 156 ▶ if (@$raw_args % 2) {
Branch: 1 branch
BranchTrueFalseTotal
if (@$raw_args % 2) 2 154 156
101 2 ▶ return (defined $only_parameter and $only_parameter)
Branch: 1 branch
BranchTrueFalseTotal
defined $only_parameter && $only_parameter ? : 0 2 2
Condition33%1/3
defined $only_parameter and $only_parameter
!ll&&!rl&&r
200
MC/DC0%0/2
defined $only_parameter and $only_parameter
defined $only_parameter $only_parameter
Truth table33%1/3
A and B
A= defined $only_parameterB= $only_parameter
ABresult
0X0
100
111
102 ? "Got odd number of arguments, please use key value pairs as arguments or one default argument !\n"
103 : "Got odd number of values, please use key value pairs as arguments !\n"
104 }
105 154 my %arg_hash = @$raw_args;
106 154 for my $parameter_name (@$required_parameter){
107 83 ▶ if (ref $parameter_alias eq 'HASH' and exists $parameter_alias->{ $parameter_name }
Branch: 1 branch
BranchTrueFalseTotal
if (ref $parameter_alias eq "HASH" and exists $parameter_alias->{$parameter_name} and exists $arg_hash{$parameter_alias->{$parameter_name}}) 25 58 83
Condition100%6/6
ref $parameter_alias eq "HASH" and exists $parameter_alias->{$parameter_name} and exists $arg_hash{$parameter_alias->{$parameter_name}}
!ll&&!rl&&r
49925
ref $parameter_alias eq "HASH" and exists $parameter_alias->{$parameter_name}
!ll&&!rl&&r
212834
MC/DC100%3/3
ref $parameter_alias eq "HASH" and exists $parameter_alias->{$parameter_name} and exists $arg_hash{$parameter_alias->{$parameter_name}}
ref $parameter_alias eq "HASH" exists $parameter_alias->{$parameter_name} exists $arg_hash{$parameter_alias->{$parameter_name}}
Truth table100%4/4
A and B and C
A= ref $parameter_alias eq "HASH"B= exists $parameter_alias->{$parameter_name}C= exists $arg_hash{$parameter_alias->{$parameter_name}}
ABCresult
0XX0
10X0
1100
1111
108 and exists $arg_hash{ $parameter_alias->{$parameter_name} }){
109 25 $arg_hash{ $parameter_name } = delete $arg_hash{ $parameter_alias->{$parameter_name} };
110 }
111 83 ▶ return "Argument '$parameter_name' is missing!\n" unless exists $arg_hash{$parameter_name};
Branch: 1 branch
BranchTrueFalseTotal
unless exists $arg_hash{$parameter_name} 8 75 83
112 75 $clean_arg{ $parameter_name } = delete $arg_hash{ $parameter_name };
113 }
114 146 for my $parameter_name (keys %$optional_parameter){
115 538 ▶ if (ref $parameter_alias eq 'HASH' and exists $parameter_alias->{ $parameter_name }
Branch: 1 branch
BranchTrueFalseTotal
if (ref $parameter_alias eq "HASH" and exists $parameter_alias->{$parameter_name} and exists $arg_hash{$parameter_alias->{$parameter_name}}) 10 528 538
Condition100%6/6
ref $parameter_alias eq "HASH" and exists $parameter_alias->{$parameter_name} and exists $arg_hash{$parameter_alias->{$parameter_name}}
!ll&&!rl&&r
5111710
ref $parameter_alias eq "HASH" and exists $parameter_alias->{$parameter_name}
!ll&&!rl&&r
4585327
MC/DC100%3/3
ref $parameter_alias eq "HASH" and exists $parameter_alias->{$parameter_name} and exists $arg_hash{$parameter_alias->{$parameter_name}}
ref $parameter_alias eq "HASH" exists $parameter_alias->{$parameter_name} exists $arg_hash{$parameter_alias->{$parameter_name}}
Truth table100%4/4
A and B and C
A= ref $parameter_alias eq "HASH"B= exists $parameter_alias->{$parameter_name}C= exists $arg_hash{$parameter_alias->{$parameter_name}}
ABCresult
0XX0
10X0
1100
1111
116 and exists $arg_hash{ $parameter_alias->{$parameter_name} }){
117 10 $arg_hash{ $parameter_name } = delete $arg_hash{ $parameter_alias->{$parameter_name} };
118 }
119 $clean_arg{ $parameter_name } = exists $arg_hash{$parameter_name}
120 ? delete $arg_hash{ $parameter_name }
121 538 ▶ : $optional_parameter->{ $parameter_name };
Branch: 1 branch
BranchTrueFalseTotal
exists $arg_hash{$parameter_name} ? : 142 396 538
122 }
123 146 ▶ return "Inserted unknown argument(s): ".(join ',', keys %arg_hash)."\n" if %arg_hash;
Branch: 1 branch
BranchTrueFalseTotal
if %arg_hash 7 139 146
124 139 return \%clean_arg;
125 }
126  
127 ### getter #############################################################
128 5 my $default_space_name = Graphics::Toolkit::Color::Space::Hub::default_space_name();
129 70 ▶sub values {
Subroutine values: called CC=4 SCAR=14.2
Pod documented
130 70 my ($self, @args) = @_;
131 70 my $arg = _split_named_args( \@args, 'in', [],
132 { in => $default_space_name, as => 'list', raw => 0,
133 precision => undef, range => undef, suffix => undef } );
134 70 my $help = 'The method "values" returns numeric color values and accepts six named, optional arguments: '.
135 '"in" (color space name - default arg), "as" (color definition format), "raw", "range", "precision" and "suffix"!';
136 70 ▶ return error($arg.$help.$POD_link) unless ref $arg;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $arg 0 70 70
137 70 my @result = $self->values_object->formatted( @$arg{qw/in as suffix range precision raw/} );
138 0 ▶ return error(${$result[0]}.$help.$POD_link) if ref $result[0] eq 'SCALAR';
Branch: 1 branch
BranchTrueFalseTotal
if ref $result[0] eq "SCALAR" 0 70 70
139 70 ▶ return wantarray ? @result : $result[0];
Branch: 1 branch
BranchTrueFalseTotal
wantarray ? : 48 22 70
140 }
141  
142 37 ▶sub name {
Subroutine name: called CC=3 SCAR=11.0
Pod documented
143 37 my ($self, @args) = @_;
144 37 ▶ return $self->values_object->name unless @args;
Branch: 1 branch
BranchTrueFalseTotal
unless @args 35 2 37
145 2 my $arg = _split_named_args( \@args, 'from', [], {from => 'default', all => 0, full => 0, distance => 0}, {distance => 'd'});
146 2 my $help = 'The method "name" returns one, several or no (empty) color name strings and accepts four named, optional arguments: '.
147 '"from" (scheme name - default arg), "all" (color names), "full" (name) and "distance" (or "d")!';
148 2 ▶ return error($arg.$help.$POD_link) unless ref $arg;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $arg 0 2 2
149 2 Graphics::Toolkit::Color::Name::from_values( $self->values_object->shaped, @$arg{qw/from all full distance/});
150 }
151  
152 11 ▶sub closest_name {
Subroutine closest_name: called CC=3 SCAR=11.0
Pod documented
153 11 my ($self, @args) = @_;
154 11 my $arg = _split_named_args( \@args, 'from', [], {from => 'default', all => 0, full => 0});
155 11 my $help = 'The method "closest_name" returns one or several (in an ARRAY) color name strings and in list context also '.
156 'the numeric distance and accepts three named, optional arguments: '.
157 '"from" (scheme name - default arg), "all" (color names) and "full" (name)!';
158 11 ▶ return error($arg.$help.$POD_link) unless ref $arg;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $arg 0 11 11
159 my ($name, $distance) = Graphics::Toolkit::Color::Name::closest_from_values(
160 11 $self->values_object->shaped, @$arg{qw/from all full/});
161 11 ▶ return wantarray ? ($name, $distance) : $name;
Branch: 1 branch
BranchTrueFalseTotal
wantarray ? : 6 5 11
162 }
163  
164 10 ▶sub distance {
Subroutine distance: called CC=11 SCAR=24.8
Pod documented
165 10 my ($self, @args) = @_;
166 10 my $arg = _split_named_args( \@args, 'to', ['to'], {in => $default_space_name, only => undef, range => undef}, {only => 'select'});
167 10 my $help = 'The method "distance" returns one numeric distance value and accepts four named arguments, the first being default '.
168 'and required: "to" (definition of second color), "in" (color space name), "only" (axis selection) and "range"!';
169 10 ▶ return error($arg.$help.$POD_link) unless ref $arg;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $arg 3 7 10
170 7 my $target_color = _new_from_scalar_def( $arg->{'to'} );
171 7 ▶ return error("target color definition: $arg->{to} is ill formed".$help.$POD_link) unless ref $target_color;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $target_color 0 7 7
172 7 my $color_space = Graphics::Toolkit::Color::Space::Hub::try_get_space( $arg->{'in'} );
173 7 ▶ return error($color_space.$help.$POD_link) unless ref $color_space;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $color_space 0 7 7
174 7 ▶ if (defined $arg->{'only'}){
Branch: 1 branch
BranchTrueFalseTotal
if (defined $arg->{"only"}) 3 4 7
175 3 ▶ if (not ref $arg->{'only'}){
Branch: 2 branches
BranchTrueFalseTotal
if (not ref $arg->{'only'}) { } 2 1 3
elsif (ref $arg->{'only'} eq 'ARRAY') { } 1 0 1
176 return error($arg->{'only'}." is not an axis name or role in color space: ".$color_space->name.$help.$POD_link)
177 2 ▶ unless $color_space->is_axis_role( $arg->{'only'} );
Branch: 1 branch
BranchTrueFalseTotal
unless $color_space->is_axis_role($arg->{"only"}) 0 2 2
178 } elsif (ref $arg->{'only'} eq 'ARRAY'){
179 1 for my $axis_name (@{$arg->{'only'}}) {
180 2 ▶ return error( $axis_name." is not an axis name or role in color space: ".$color_space->name.$help.$POD_link)
Branch: 1 branch
BranchTrueFalseTotal
unless $color_space->is_axis_role($axis_name) 0 2 2
181 unless $color_space->is_axis_role( $axis_name );
182 }
183 0 } else { return error('The "only" argument needs one axis name or an ARRAY with several axis names from '.
184 'the same color space!'.$help.$POD_link) }
185 }
186 7 my $range_def = $color_space->shape->try_check_range_definition( $arg->{'range'} );
187 7 ▶ return error($range_def.$help.$POD_link) unless ref $range_def;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $range_def 0 7 7
188 Graphics::Toolkit::Color::Space::Hub::distance(
189 7 $self->values_object->normalized, $target_color->values_object->normalized, $color_space->name, $arg->{'only'}, $range_def );
190 }
191  
192 ## single color creation methods #######################################
193 # --- lightweight designer API ---
194 5 my $design_default = 'OKHSL';
195 0 ▶sub lighten {
Subroutine lighten: not called CC=2 SCAR=17.9
Pod documented
196 0 my ($self, @args) = @_;
197 0 my $arg = _split_named_args( \@args, 'by', ['by'], {in => $design_default});
198 0 ▶ return "The only argument or named argument 'by' has to be a number between 0 and 1!" unless ref $arg;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $arg 0 0 0
199 0 _new_from_value_obj( Graphics::Toolkit::Color::Calculator::lighten( $self->values_object, $arg->{'by'}, $arg->{'in'} ) );
200 }
201 0 ▶sub darken {
Subroutine darken: not called CC=2 SCAR=17.9
Pod documented
202 0 my ($self, @args) = @_;
203 0 my $arg = _split_named_args( \@args, 'by', ['by'], {in => $design_default});
204 0 ▶ return "The only argument or named argument 'by' has to be a number between 0 and 1!" unless ref $arg;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $arg 0 0 0
205 0 _new_from_value_obj( Graphics::Toolkit::Color::Calculator::darken( $self->values_object, $arg->{'by'}, $arg->{'in'} ) );
206 }
207 0 ▶sub saturate {
Subroutine saturate: not called CC=2 SCAR=17.9
Pod documented
208 0 my ($self, @args) = @_;
209 0 my $arg = _split_named_args( \@args, 'by', ['by'], {in => $design_default});
210 0 ▶ return "The only argument or named argument 'by' has to be a number between 0 and 1!" unless ref $arg;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $arg 0 0 0
211 0 _new_from_value_obj( Graphics::Toolkit::Color::Calculator::saturate( $self->values_object, $arg->{'by'}, $arg->{'in'} ) );
212 }
213 0 ▶sub desaturate {
Subroutine desaturate: not called CC=2 SCAR=17.9
Pod documented
214 0 my ($self, @args) = @_;
215 0 my $arg = _split_named_args( \@args, 'by', ['by'], {in => $design_default});
216 0 ▶ return "The only argument or named argument 'by' has to be a number between 0 and 1!" unless ref $arg;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $arg 0 0 0
217 0 _new_from_value_obj( Graphics::Toolkit::Color::Calculator::desaturate( $self->values_object, $arg->{'by'}, $arg->{'in'} ) );
218 }
219 0 ▶sub tint {
Subroutine tint: not called CC=2 SCAR=17.9
Pod documented
220 0 my ($self, @args) = @_;
221 0 my $arg = _split_named_args( \@args, 'by', ['by'], {in => $design_default});
222 0 ▶ return "The only argument or named argument 'by' has to be a number between 0 and 1!" unless ref $arg;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $arg 0 0 0
223 0 _new_from_value_obj( Graphics::Toolkit::Color::Calculator::tint( $self->values_object, $arg->{'by'}, $arg->{'in'} ) );
224 }
225 0 ▶sub tone {
Subroutine tone: not called CC=2 SCAR=17.9
Pod documented
226 0 my ($self, @args) = @_;
227 0 my $arg = _split_named_args( \@args, 'by', ['by'], {in => $design_default});
228 0 ▶ return "The only argument or named argument 'by' has to be a number between 0 and 1!" unless ref $arg;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $arg 0 0 0
229 0 _new_from_value_obj( Graphics::Toolkit::Color::Calculator::tone( $self->values_object, $arg->{'by'}, $arg->{'in'} ) );
230 }
231 0 ▶sub shade {
Subroutine shade: not called CC=2 SCAR=17.9
Pod documented
232 0 my ($self, @args) = @_;
233 0 my $arg = _split_named_args( \@args, 'by', ['by'], {in => $design_default});
234 0 ▶ return "The only argument or named argument 'by' has to be a number between 0 and 1!" unless ref $arg;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $arg 0 0 0
235 0 _new_from_value_obj( Graphics::Toolkit::Color::Calculator::shade( $self->values_object, $arg->{'by'}, $arg->{'in'} ) );
236 }
237  
238 # --- low level complex API ---
239  
240 4 ▶sub apply { tone_curve(@_) }
Subroutine apply: called CC=1 SCAR=0.0
Pod undocumented
241 4 ▶sub tone_curve {
Subroutine tone_curve: called CC=4 SCAR=14.2
Pod documented
242 4 my ($self, @args) = @_;
243 4 my $arg = _split_named_args( \@args, undef, ['gamma'], {in => 'LinearRGB'} );
244 4 my $help = 'The method "tone_curve" returns a GTC object with gamma corrected values and accepts two named arguments, '.
245 'the first being required: "gamma", "in" (color space name - default LinearRGB)!';
246 4 ▶ return error($arg.$help.$POD_link) unless ref $arg;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $arg 0 4 4
247 4 my $color_space = Graphics::Toolkit::Color::Space::Hub::try_get_space( $arg->{'in'} );
248 4 ▶ return error($color_space.$help.$POD_link) unless ref $color_space;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $color_space 0 4 4
249 4 my $result = Graphics::Toolkit::Color::Calculator::apply_gamma( $self->values_object, $arg->{'gamma'}, $color_space );
250 4 ▶ return error($result.$help.$POD_link) unless ref $result;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $result 0 4 4
251 4 return _new_from_value_obj( $result );
252 }
253  
254 10 ▶sub set_value {
Subroutine set_value: called CC=9 SCAR=23.8
Pod documented
255 10 my ($self, @args) = @_;
256 0 ▶ @args = %{$args[0]} if @args == 1 and ref $args[0] eq 'HASH';
Branch: 1 branch
BranchTrueFalseTotal
if @args == 1 and ref $args[0] eq "HASH" 0 10 10
Condition33%1/3
@args == 1 and ref $args[0] eq "HASH"
!ll&&!rl&&r
1000
MC/DC0%0/2
@args == 1 and ref $args[0] eq "HASH"
@args == 1 ref $args[0] eq "HASH"
Truth table33%1/3
A and B
A= @args == 1B= ref $args[0] eq "HASH"
ABresult
0X0
100
111
257 10 my $help = 'The method "set_value" returns a GTC object with some values replaced. Arguments are selected axis '.
258 'names of target space and optionally "in" for color space disambiguation!';
259 10 ▶ return error($help.$POD_link) if @args % 2 or not @args or @args > 10;
Branch: 1 branch
BranchTrueFalseTotal
if @args % 2 or not @args or @args > 10 1 9 10
Condition66%4/6
@args % 2 or not @args or @args > 10
l!l&&r!l&&!r
109
@args % 2 or not @args
l!l&&r!l&&!r
019
MC/DC33%1/3
@args % 2 or not @args or @args > 10
@args % 2 not @args @args > 10
Truth table50%2/4
A or not(B) or C
A= @args % 2B= not @argsC= @args > 10
ABCresult
1XX1
01X1
0011
0000
260 9 my $partial_color = { @args };
261 9 my $space_name = delete $partial_color->{'in'};
262 9 my $color_space = Graphics::Toolkit::Color::Space::Hub::try_get_space( $space_name );
263 9 ▶ return error($color_space.$help.$POD_link) if defined $color_space and not ref $color_space;
Branch: 1 branch
BranchTrueFalseTotal
if defined $color_space and not ref $color_space 0 9 9
Condition33%1/3
defined $color_space and not ref $color_space
!ll&&!rl&&r
090
MC/DC0%0/2
defined $color_space and not ref $color_space
defined $color_space not ref $color_space
Truth table33%1/3
A and not(B)
A= defined $color_spaceB= not ref $color_space
ABresult
0X0
100
111
264 9 my $result = Graphics::Toolkit::Color::Calculator::set_value( $self->values_object, $partial_color, $space_name );
265 9 ▶ return error($result.' '.$help.$POD_link) unless ref $result;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $result 2 7 9
266 7 return _new_from_value_obj( $result );
267 }
268 10 ▶sub add_value {
Subroutine add_value: called CC=9 SCAR=23.8
Pod documented
269 10 my ($self, @args) = @_;
270 0 ▶ @args = %{$args[0]} if @args == 1 and ref $args[0] eq 'HASH';
Branch: 1 branch
BranchTrueFalseTotal
if @args == 1 and ref $args[0] eq "HASH" 0 10 10
Condition33%1/3
@args == 1 and ref $args[0] eq "HASH"
!ll&&!rl&&r
1000
MC/DC0%0/2
@args == 1 and ref $args[0] eq "HASH"
@args == 1 ref $args[0] eq "HASH"
Truth table33%1/3
A and B
A= @args == 1B= ref $args[0] eq "HASH"
ABresult
0X0
100
111
271 10 my $help = 'The method "add_value" returns a GTC object with some values different. Arguments are selected axis '.
272 'names of target space and optionally "in" for color space disambiguation!';
273 10 ▶ return error($help.$POD_link) if @args % 2 or not @args or @args > 10;
Branch: 1 branch
BranchTrueFalseTotal
if @args % 2 or not @args or @args > 10 1 9 10
Condition66%4/6
@args % 2 or not @args or @args > 10
l!l&&r!l&&!r
109
@args % 2 or not @args
l!l&&r!l&&!r
019
MC/DC33%1/3
@args % 2 or not @args or @args > 10
@args % 2 not @args @args > 10
Truth table50%2/4
A or not(B) or C
A= @args % 2B= not @argsC= @args > 10
ABCresult
1XX1
01X1
0011
0000
274 9 my $partial_color = { @args };
275 9 my $space_name = delete $partial_color->{'in'};
276 9 my $color_space = Graphics::Toolkit::Color::Space::Hub::try_get_space( $space_name );
277 9 ▶ return error($color_space.$help.$POD_link) if defined $color_space and not ref $color_space;
Branch: 1 branch
BranchTrueFalseTotal
if defined $color_space and not ref $color_space 0 9 9
Condition33%1/3
defined $color_space and not ref $color_space
!ll&&!rl&&r
090
MC/DC0%0/2
defined $color_space and not ref $color_space
defined $color_space not ref $color_space
Truth table33%1/3
A and not(B)
A= defined $color_spaceB= not ref $color_space
ABresult
0X0
100
111
278 9 my $result = Graphics::Toolkit::Color::Calculator::add_value( $self->values_object, $partial_color, $space_name );
279 9 ▶ return error($result.' '.$help.$POD_link) unless ref $result;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $result 3 6 9
280 6 return _new_from_value_obj( $result );
281 }
282  
283 24 ▶sub mix {
Subroutine mix: called CC=16 SCAR=27.7
Pod documented
284 24 my ($self, @args) = @_;
285 24 my $arg = _split_named_args( \@args, 'to', ['to'], {in => 'OKLAB', by => undef}, {by => 'amount'});
286 24 my $help = 'The method "mix" returns a GTC object, which is a blend between given colors. Arguments are: '.
287 '"to" (other color[s]-required and default), "by" (mix amounts) and "in"(color space name, default OKLAB)!';
288 24 ▶ return error($arg.' '.$help.$POD_link) unless ref $arg;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $arg 2 22 24
289 22 my $color_space = Graphics::Toolkit::Color::Space::Hub::try_get_space( delete $arg->{'in'} );
290 22 ▶ return error($color_space.' '.$help.$POD_link) unless ref $color_space;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $color_space 1 21 22
291 21 my $second_color = _new_from_scalar_def($arg->{'to'});
292 21 ▶ if (ref $second_color){ $arg->{'to'} = [$second_color->values_object] }
Branch: 1 branch
BranchTrueFalseTotal
if (ref $second_color) { } 10 11 21
293 else {
294 11 ▶ if (ref $arg->{'to'} ne 'ARRAY'){
Branch: 1 branch
BranchTrueFalseTotal
if (ref $arg->{'to'} ne 'ARRAY') { } 2 9 11
295 2 return error("Target color definition (argument 'to'): '$arg->{to}' is ill formed. $second_color. ".$POD_link);
296 } else {
297 9 my @to = ();
298 9 for my $color_def (@{$arg->{'to'}}){
299 15 ▶ if (ref $color_def eq __PACKAGE__) { push @to, $color_def->values_object }
Branch: 1 branch
BranchTrueFalseTotal
if (ref $color_def eq __PACKAGE__) { } 9 6 15
300 else {
301 6 $second_color = Graphics::Toolkit::Color::Values->new_from_any_input( $color_def );
302 6 ▶ return error("target color definition (argument 'to'). '$color_def' is ill formed: $second_color. ".$POD_link)
Branch: 1 branch
BranchTrueFalseTotal
unless ref $second_color 0 6 6
303 unless ref $second_color;
304 6 push @to, $second_color;
305 }
306 }
307 9 $arg->{'to'} = \@to;
308 }
309 }
310 # backward compatibility: 'by' > 1 is read as percent (0 .. 100) and mapped to 0 .. 1
311 19 ▶ if (defined $arg->{'by'}){
Branch: 1 branch
BranchTrueFalseTotal
if (defined $arg->{"by"}) 9 10 19
312 9 ▶ if (ref $arg->{'by'} eq 'ARRAY') {
Branch: 2 branches
BranchTrueFalseTotal
if (ref $arg->{'by'} eq 'ARRAY') { } 5 4 9
elsif (is_nr($arg->{'by'}) and $arg->{'by'} > 1) { } 2 2 4
313 5 ▶ for (@{$arg->{'by'}}) { $_ /= 100 if is_nr($_) and $_ > 1 }
Branch: 1 branch
BranchTrueFalseTotal
if is_nr($_) and $_ > 1 7 1 8
Condition66%2/3
is_nr($_) and $_ > 1
!ll&&!rl&&r
017
MC/DC50%1/2
is_nr($_) and $_ > 1
is_nr($_) $_ > 1
Truth table66%2/3
A and B
A= is_nr($_)B= $_ > 1
ABresult
0X0
100
111
314 2 ▶ } elsif (is_nr($arg->{'by'}) and $arg->{'by'} > 1) { $arg->{'by'} /= 100 }
Condition66%2/3
is_nr($arg->{"by"}) and $arg->{"by"} > 1
!ll&&!rl&&r
022
MC/DC50%1/2
is_nr($arg->{"by"}) and $arg->{"by"} > 1
is_nr($arg->{"by"}) $arg->{"by"} > 1
Truth table66%2/3
A and B
A= is_nr($arg->{"by"})B= $arg->{"by"} > 1
ABresult
0X0
100
111
315 }
316 19 my $result = Graphics::Toolkit::Color::Calculator::mix( $self->values_object, $arg->{'to'}, $arg->{'by'}, $color_space );
317 19 ▶ return error($result.' '.$help.$POD_link) unless ref $result;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $result 2 17 19
318 17 return _new_from_value_obj( $result );
319 }
320  
321 16 ▶sub invert {
Subroutine invert: called CC=8 SCAR=21.0
Pod documented
322 16 my ($self, @args) = @_;
323 16 my $arg = _split_named_args( \@args, 'only', [], {in => undef, only => undef});
324 16 my $help = 'The method "invert" returns a GTC object with inverted ($max - $_) values. Optional arguments are: '.
325 '"only" (axis selection, default is all) and "in" (color space name)!';
326 16 ▶ return error($arg.$help.$POD_link) unless ref $arg and (not ref $arg->{'only'} or ref $arg->{'only'} eq 'ARRAY');
Branch: 1 branch
BranchTrueFalseTotal
unless ref $arg and !ref($arg->{"only"}) || ref $arg->{"only"} eq "ARRAY" 1 15 16
Condition66%4/6
ref $arg and !ref($arg->{"only"}) || ref $arg->{"only"} eq "ARRAY"
!ll&&!rl&&r
1015
not ref $arg->{"only"} or ref $arg->{"only"} eq "ARRAY"
l!l&&r!l&&!r
1320
MC/DC33%1/3
ref $arg and !ref($arg->{"only"}) || ref $arg->{"only"} eq "ARRAY"
ref $arg not ref $arg->{"only"} ref $arg->{"only"} eq "ARRAY"
Truth table75%3/4
A and not(B) or C
A= ref $argB= not ref $arg->{"only"}C= ref $arg->{"only"} eq "ARRAY"
ABCresult
0XX0
1000
11X1
1011
327 15 my $color_space = Graphics::Toolkit::Color::Space::Hub::try_get_space( $arg->{'in'} );
328 15 ▶ return error($color_space.$help.$POD_link) if defined $arg->{'in'} and not ref $color_space;
Branch: 1 branch
BranchTrueFalseTotal
if defined $arg->{"in"} and not ref $color_space 0 15 15
Condition66%2/3
defined $arg->{"in"} and not ref $color_space
!ll&&!rl&&r
5100
MC/DC0%0/2
defined $arg->{"in"} and not ref $color_space
defined $arg->{"in"} not ref $color_space
Truth table66%2/3
A and not(B)
A= defined $arg->{"in"}B= not ref $color_space
ABresult
0X0
100
111
329 15 ▶ $arg->{'in'} = $color_space if defined $arg->{'in'};
Branch: 1 branch
BranchTrueFalseTotal
if defined $arg->{"in"} 10 5 15
330 15 my $default_space = Graphics::Toolkit::Color::Space::Hub::get_space( 'OKHSL' );
331 15 my $result = Graphics::Toolkit::Color::Calculator::invert( $self->values_object, $arg->{'only'}, $arg->{'in'}, $default_space );
332 15 ▶ return error($result.$help.$POD_link) unless ref $result;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $result 1 14 15
333 14 return _new_from_value_obj( $result );
334 }
335  
336 ## color set creation methods ##########################################
337 13 ▶sub complement {
Subroutine complement: called CC=12 SCAR=24.9
Pod documented
338 13 my ($self, @args) = @_;
339 13 my $arg = _split_named_args( \@args, 'steps', [], {steps => 1, tilt => 0, skew => 0, target => {}, in => $design_default});
340 13 my $help = 'The method "complement" returns a list of GTC objects with complementary colors. Optional arguments are: '.
341 '"steps" (color count, default 1 - default argument), "in" (color space name, default "OKHSL", "tilt", "skew" and "target")!';
342 13 ▶ return error($arg.$help.$POD_link) unless ref $arg;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $arg 1 12 13
343 12 ▶ return error('Optional argument "steps" has to be a number ! '.$help.$POD_link) unless is_nr($arg->{'steps'});
Branch: 1 branch
BranchTrueFalseTotal
unless is_nr($arg->{"steps"}) 2 10 12
344 10 ▶ return error('Optional argument "steps" is zero or negative, no complement colors will be computed! '.$help.$POD_link) if $arg->{'steps'} < 1;
Branch: 1 branch
BranchTrueFalseTotal
if $arg->{"steps"} < 1 0 10 10
345 10 ▶ return error('Optional argument "tilt" has to be a number! '.$help.$POD_link) unless is_nr($arg->{'tilt'});
Branch: 1 branch
BranchTrueFalseTotal
unless is_nr($arg->{"tilt"}) 1 9 10
346 9 ▶ return error('Optional argument "skew" has to be a number! '.$help.$POD_link) unless is_nr($arg->{'skew'});
Branch: 1 branch
BranchTrueFalseTotal
unless is_nr($arg->{"skew"}) 1 8 9
347 8 ▶ return error('Optional argument "target" has to be a HASH ref! '.$help.$POD_link) if ref $arg->{'target'} ne 'HASH';
Branch: 1 branch
BranchTrueFalseTotal
if ref $arg->{"target"} ne "HASH" 1 7 8
348 7 my ($target_delta, $space_name);
349 7 ▶ if (keys %{$arg->{'target'}}){
Branch: 1 branch
BranchTrueFalseTotal
if (keys %{$$arg{'target'};}) { } 2 5 7
350 2 ($target_delta, $space_name) = Graphics::Toolkit::Color::Space::Hub::deformat_search_partial_hash( $arg->{'target'}, 'HSL' );
351 2 ▶ return error('Optional argument "target" got HASH keys that do not fit HSL roles ("h","s","l")! '.$help.$POD_link) unless ref $target_delta;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $target_delta 1 1 2
352 5 } else { $target_delta = [] }
353 6 my $color_space = Graphics::Toolkit::Color::Space::Hub::try_get_space( $arg->{'in'} );
354 6 ▶ return error($color_space.$help.$POD_link) unless ref $color_space;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $color_space 0 6 6
355 6 ▶ return error("Need a cylindrical space from the HSL family! ".$help.$POD_link) unless $color_space->family eq 'HSL';
Branch: 1 branch
BranchTrueFalseTotal
unless $color_space->family eq "HSL" 0 6 6
356  
357 6 my @result = Graphics::Toolkit::Color::SetCalculator::complement( $self->values_object, $target_delta, @$arg{qw/steps tilt skew/}, $color_space );
358 6 ▶ return error($result[0].$help.$POD_link) unless ref $result[0];
Branch: 1 branch
BranchTrueFalseTotal
unless ref $result[0] 0 6 6
359 6 map {_new_from_value_obj( $_ )} @result;
360 }
361  
362 11 ▶sub analogous {
Subroutine analogous: called CC=9 SCAR=22.5
Pod documented
363 11 my ($self, @args) = @_;
364 11 my $arg = _split_named_args( \@args, 'to', ['to'], {steps => 4, tilt => 0, in => $design_default});
365 11 my $help = 'The method "analogous" returns a list of GTC objects with analogous colors. Arguments are: "to" (next color - default arg. and required), '.
366 '"steps" (max. color count, default 4), "in" (color space name, default "OKHSL" and "tilt"!';
367 11 ▶ return error($arg.$help.$POD_link) unless ref $arg;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $arg 3 8 11
368 8 my $next_color = _new_from_scalar_def( $arg->{'to'} );
369 8 ▶ if (ref $next_color) { $arg->{'to'} = $next_color->values_object }
Branch: 1 branch
BranchTrueFalseTotal
if (ref $next_color) { } 8 0 8
370 0 else { return error('Argument "to" contains malformed color definition! '.$next_color.$POD_link) }
371 8 ▶ return error('Optional argument "steps" has to be a number ! '.$help.$POD_link) unless is_nr($arg->{'steps'});
Branch: 1 branch
BranchTrueFalseTotal
unless is_nr($arg->{"steps"}) 2 6 8
372 6 ▶ return error('Optional argument "steps" has to be a number greater equal two! '.$help.$POD_link) unless is_nr($arg->{'steps'}) and $arg->{'steps'} >= 2;
Branch: 1 branch
BranchTrueFalseTotal
unless is_nr($arg->{"steps"}) and $arg->{"steps"} >= 2 0 6 6
Condition33%1/3
is_nr($arg->{"steps"}) and $arg->{"steps"} >= 2
!ll&&!rl&&r
006
MC/DC0%0/2
is_nr($arg->{"steps"}) and $arg->{"steps"} >= 2
is_nr($arg->{"steps"}) $arg->{"steps"} >= 2
Truth table33%1/3
A and B
A= is_nr($arg->{"steps"})B= $arg->{"steps"} >= 2
ABresult
0X0
100
111
373 6 ▶ return error('Optional argument "tilt" has to be a number! '.$help.$POD_link) unless is_nr($arg->{'tilt'});
Branch: 1 branch
BranchTrueFalseTotal
unless is_nr($arg->{"tilt"}) 2 4 6
374 4 my $color_space = Graphics::Toolkit::Color::Space::Hub::try_get_space( $arg->{'in'} );
375 4 ▶ return error($color_space.$help.$POD_link) unless ref $color_space;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $color_space 1 3 4
376
377 3 my @result = Graphics::Toolkit::Color::SetCalculator::analogous( $self->values_object, $arg->{'to'}, @$arg{qw/steps tilt/}, $color_space);
378 3 ▶ return error($result[0].$help.$POD_link) unless ref $result[0];
Branch: 1 branch
BranchTrueFalseTotal
unless ref $result[0] 0 3 3
379 3 map {_new_from_value_obj( $_ )} @result;
380 }
381  
382 10 ▶sub gradient {
Subroutine gradient: called CC=12 SCAR=25.3
Pod documented
383 10 my ($self, @args) = @_;
384 10 my $arg = _split_named_args( \@args, 'to', ['to'], {steps => 10, tilt => 0, in => 'OKLAB'});
385 10 my $help = 'The method "gradient" returns a list of GTC objects with a gradual transition between colors. Arguments are: '.
386 '"to" (next color - default arg. and required), "steps" (color count, default 10), "in" (color space name, default "OKLAB" and "tilt")!';
387 10 ▶ return error($arg.$help.$POD_link) unless ref $arg;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $arg 1 9 10
388 9 my @colors = ($self->values_object);
389 9 my $target_color = _new_from_scalar_def( $arg->{'to'} );
390 9 ▶ if (ref $target_color) {
Branch: 1 branch
BranchTrueFalseTotal
if (ref $target_color) { } 6 3 9
391 6 push @colors, $target_color->values_object }
392 else {
393 3 ▶ return error('Argument "to" contains malformed color definition! '.$help.$POD_link) if ref $arg->{'to'} ne 'ARRAY' or not @{$arg->{'to'}};
Branch: 1 branch
BranchTrueFalseTotal
if ref $arg->{"to"} ne "ARRAY" or not @{$arg->{"to"};} 1 2 3
Condition66%2/3
ref $arg->{"to"} ne "ARRAY" or not @{$arg->{"to"};}
l!l&&r!l&&!r
102
MC/DC50%1/2
ref $arg->{"to"} ne "ARRAY" or not @{$arg->{"to"};}
ref $arg->{"to"} ne "ARRAY" not @{$arg->{"to"};}
Truth table66%2/3
A or not(B)
A= ref $arg->{"to"} ne "ARRAY"B= not @{$arg->{"to"};}
ABresult
1X1
011
000
394 2 for my $color_def (@{$arg->{'to'}}){
395 5 my $target_color = _new_from_scalar_def( $color_def );
396 5 ▶ return error('Argument "to" contains malformed color definition: '.$color_def.'! '.$help.$POD_link) unless ref $target_color;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $target_color 1 4 5
397 4 push @colors, $target_color->values_object;
398 }
399 }
400 7 ▶ return error('Argument "steps" has to be a number greater equel two! '.$help.$POD_link) unless is_nr($arg->{'steps'}) and $arg->{'steps'} >= 2;
Branch: 1 branch
BranchTrueFalseTotal
unless is_nr($arg->{"steps"}) and $arg->{"steps"} >= 2 0 7 7
Condition33%1/3
is_nr($arg->{"steps"}) and $arg->{"steps"} >= 2
!ll&&!rl&&r
007
MC/DC0%0/2
is_nr($arg->{"steps"}) and $arg->{"steps"} >= 2
is_nr($arg->{"steps"}) $arg->{"steps"} >= 2
Truth table33%1/3
A and B
A= is_nr($arg->{"steps"})B= $arg->{"steps"} >= 2
ABresult
0X0
100
111
401 7 $arg->{'steps'} = int $arg->{'steps'};
402 7 ▶ return error('Argument "tilt" has to be a number! '.$help.$POD_link) unless is_nr($arg->{'tilt'});
Branch: 1 branch
BranchTrueFalseTotal
unless is_nr($arg->{"tilt"}) 0 7 7
403 7 my $color_space = Graphics::Toolkit::Color::Space::Hub::try_get_space( $arg->{'in'} );
404 7 ▶ return error($color_space.$help.$POD_link) unless ref $color_space;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $color_space 0 7 7
405
406 7 my @result = Graphics::Toolkit::Color::SetCalculator::gradient( \@colors, @$arg{qw/steps tilt/}, $color_space);
407 7 ▶ return error($result[0].$help.$POD_link) unless ref $result[0];
Branch: 1 branch
BranchTrueFalseTotal
unless ref $result[0] 0 7 7
408 7 map {_new_from_value_obj( $_ )} @result;
409 }
410  
411 20 ▶sub cluster {
Subroutine cluster: called CC=11 SCAR=24.0
Pod documented
412 20 my ($self, @args) = @_;
413 20 my $arg = _split_named_args( \@args, undef, ['radius', 'minimal_distance'], {in => 'OKLAB'}, {radius => 'r', minimal_distance => 'min_d'});
414 20 my $help = 'The method "cluster" returns a list of GTC objects with similar but distinct colors. The arguments are: '.
415 '"radius" (max. distance from center, alias "r", required), "minimal_distance" (between colors, required) and "in" (color space name, default "OKLAB")!';
416 20 ▶ return error($arg.$help.$POD_link) unless ref $arg;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $arg 6 14 20
417 14 my $color_space = Graphics::Toolkit::Color::Space::Hub::try_get_space( $arg->{'in'} );
418 14 ▶ return error($color_space.$help.$POD_link) unless ref $color_space;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $color_space 1 13 14
419 return error('Argument "radius" has to be a non-negative number or an ARRAY of numbers that holds for each space axis a radius value. '.$help.$POD_link)
420 13 ▶ unless (is_nr($arg->{'radius'}) and $arg->{'radius'} >= 0) or $color_space->is_number_tuple( $arg->{'radius'} );
Branch: 1 branch
BranchTrueFalseTotal
unless is_nr($arg->{"radius"}) and $arg->{"radius"} >= 0 or $color_space->is_number_tuple($arg->{"radius"}) 4 9 13
Condition100%6/6
is_nr($arg->{"radius"}) and $arg->{"radius"} >= 0 or $color_space->is_number_tuple($arg->{"radius"})
l!l&&r!l&&!r
634
is_nr($arg->{"radius"}) and $arg->{"radius"} >= 0
!ll&&!rl&&r
616
MC/DC100%3/3
is_nr($arg->{"radius"}) and $arg->{"radius"} >= 0 or $color_space->is_number_tuple($arg->{"radius"})
is_nr($arg->{"radius"}) $arg->{"radius"} >= 0 $color_space->is_number_tuple($arg->{"radius"})
Truth table80%4/5
A and B or C
A= is_nr($arg->{"radius"})B= $arg->{"radius"} >= 0C= $color_space->is_number_tuple($arg->{"radius"})
ABCresult
11X1
0X11
1011
0X00
1000
421 return error('Argument "minimal_distance" (or "min_d") has to be a number greater zero! '.$help.$POD_link)
422 9 ▶ unless is_nr($arg->{'minimal_distance'}) and $arg->{'minimal_distance'} > 0;
Branch: 1 branch
BranchTrueFalseTotal
unless is_nr($arg->{"minimal_distance"}) and $arg->{"minimal_distance"} > 0 2 7 9
Condition100%3/3
is_nr($arg->{"minimal_distance"}) and $arg->{"minimal_distance"} > 0
!ll&&!rl&&r
117
MC/DC100%2/2
is_nr($arg->{"minimal_distance"}) and $arg->{"minimal_distance"} > 0
is_nr($arg->{"minimal_distance"}) $arg->{"minimal_distance"} > 0
Truth table100%3/3
A and B
A= is_nr($arg->{"minimal_distance"})B= $arg->{"minimal_distance"} > 0
ABresult
0X0
100
111
423 return error('Ball shaped cluster works only in spaces with three dimensions! '.$help.$POD_link)
424 7 ▶ if $color_space->axis_count > 3 and not ref $arg->{'radius'};
Branch: 1 branch
BranchTrueFalseTotal
if $color_space->axis_count > 3 and not ref $arg->{"radius"} 1 6 7
Condition100%3/3
$color_space->axis_count > 3 and not ref $arg->{"radius"}
!ll&&!rl&&r
511
MC/DC100%2/2
$color_space->axis_count > 3 and not ref $arg->{"radius"}
$color_space->axis_count > 3 not ref $arg->{"radius"}
Truth table100%3/3
A and not(B)
A= $color_space->axis_count > 3B= not ref $arg->{"radius"}
ABresult
0X0
100
111
425  
426 6 my @result = Graphics::Toolkit::Color::SetCalculator::cluster( $self->values_object, @$arg{qw/radius minimal_distance/}, $color_space);
427 6 ▶ return error($result[0].$help.$POD_link) unless ref $result[0];
Branch: 1 branch
BranchTrueFalseTotal
unless ref $result[0] 0 6 6
428 6 map {_new_from_value_obj( $_ )} @result;
429 }
430  
431 5 1;
432  
433 __END__
« Color/Space/Shape.pm ↑ Summary Color/Calculator.pm »