blib/lib/Roku/LCD.pm

filter: Statementstmt 11.3% 30 / 264 Branchbran 0.0% 0 / 72 Conditioncond 0.0% 0 / 46 MC/DCmcdc 0.0% 0 / 27 Subroutinesub 31.8% 7 / 22 Podpod 100% 6 / 6 totaltotal 9.8% 43 / 437 CC 59 SCAR 44.7
CC
59
Cov
8%
_ticker
182.0
new
156.0
_ttparagraph
156.0
CRAP 87.2
↑ Summary
1 package Roku::LCD;
2
3 2 ▶use v5.10.1;
Subroutine BEGIN: called CC=1 SCAR=0.0
4 2 ▶use strict;
Subroutine BEGIN: called CC=1 SCAR=0.0
5 2 ▶use warnings;
Subroutine BEGIN: called CC=1 SCAR=0.0
6 2 ▶use Time::HiRes qw(sleep);
Subroutine BEGIN: called CC=1 SCAR=0.0
7 2 ▶use Readonly;
Subroutine BEGIN: called CC=1 SCAR=0.0
8 2 ▶use Carp qw(croak);
Subroutine BEGIN: called CC=1 SCAR=0.0
9
10 # Constants
11 2 Readonly::Scalar our $EMPTY => q{};
12 2 Readonly::Scalar our $SPACE => q{ };
13 2 Readonly::Scalar our $M400 => 400; # Model type
14 2 Readonly::Scalar our $M500 => 500; # Model type
15 2 Readonly::Scalar our $M400WIDTH => 16; # M400 screen width
16 2 Readonly::Scalar our $M500WIDTH => 40; # M500 screen width
17 2 Readonly::Scalar our $LETTERPAUSE => 0.25; # Time to pause between printing characters
18
19 2 require Roku::RCP;
20
21 2 ▶use parent qw(Roku::RCP);
Subroutine BEGIN: called CC=1 SCAR=0.0
22
23 2 our $VERSION = '0.05';
24
25 =head1 NAME
26
27 Roku::LCD - M400 & M500 Display Functions made more accessible than via the Roku::RCP module
28
29 =head1 VERSION
30
31 =over
32
33 =item Version 0.05 May 27, 2014 - continuing to modernize the code
34
35 =back
36
37 =head1 SYNOPSIS
38
39
40 use Roku::LCD;
41 my $display = Roku::LCD->new($rokuIP);
42 if (! display) { die("Could not connect to Roku Soundbridge"); }
43
44 my($rv) = $display->marquee(text => "This allows easy access to the marquee function - timings for M400 only");
45
46 $display->ticker(text => "An alternative to the marquee function that can cope with large quantities of text", pause => 5);
47
48 open (INFILE, "a_text_file.txt");
49 @slurp_file = <INFILE>;
50 close(INFILE);
51
52 $display->teletype(text => "@slurp_file", pause => 2, linepause => 1);
53
54 $display->Quit;
55
56 =head1 DESCRIPTION
57
58 Roku::LCD was written because the RokuUI module appeared a bit too high level, so I put together some simplified display
59 routines into a single easy-to-use object.
60
61 It has now been moved to using the Roku::RCP module which is easily available from CPAN.
62
63 It inherits all the methods from the standard Roku::RCP module.
64
65 =head1 METHODS
66
67 =head2 new(host => I<host_address> [, port => I<port>] [, model => I<400 or 500>])
68
69 If not given, the port number is assumed to be 4444, and the model will be determined from the displaytype
70 command (if that fails, the model type will be set to M400).
71
72 =cut
73
74 0 ▶sub new {
Subroutine new: not called CC=12 SCAR=50.5
Pod documented
75 0 my ( $class, %args ) = @_;
76 0 ▶ if (! $args{Host}) { croak "No soundbridge host to control"; }
Branch: 1 branch
BranchTrueFalseTotal
unless ($args{"Host"}) 0 0 0
77
78 # Test model type before attempting to connect
79 0 ▶ if ( ( $args{model} ) && ( $args{model} != $M500 ) && ( $args{model} != $M400 ) ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($args{"model"} and $args{"model"} != $Roku::LCD::M500 and $args{"model"} != $Roku::LCD::M400) 0 0 0
Condition0%0/6
$args{"model"} and $args{"model"} != $Roku::LCD::M500 and $args{"model"} != $Roku::LCD::M400
!ll&&!rl&&r
000
$args{"model"} and $args{"model"} != $Roku::LCD::M500
!ll&&!rl&&r
000
MC/DC0%0/3
$args{"model"} and $args{"model"} != $Roku::LCD::M500 and $args{"model"} != $Roku::LCD::M400
$args{"model"} $args{"model"} != $Roku::LCD::M500 $args{"model"} != $Roku::LCD::M400
Truth table0%0/4
A and B and C
A= $args{"model"}B= $args{"model"} != $Roku::LCD::M500C= $args{"model"} != $Roku::LCD::M400
ABCresult
0XX0
10X0
1100
1111
80 0 croak 'Unrecognised model type, ', $args{model}, "\n";
81 }
82
83 # Roku::RCP really ought to take host within the %args list...
84 0 ▶ my $self = $class->SUPER::new( $args{Host}, Port => $args{Port} || '4444' );
Condition0%0/2
$args{'Port'} || '4444'
l!l
00
MC/DC0%0/1
$args{'Port'} || '4444'
$args{'Port'}
Truth table0%0/2
A
A= $args{'Port'}
Aresult
11
00
85
86 0 ▶ if (! defined $self) { return; }
Branch: 1 branch
BranchTrueFalseTotal
unless (defined $self) 0 0 0
87
88 0 ▶ if ( $args{model} ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($args{'model'}) { } 0 0 0
89 0 ▶ if ( $args{model} == $M500 ) {
Branch: 2 branches
BranchTrueFalseTotal
if ($args{'model'} == $Roku::LCD::M500) { } 0 0 0
elsif ($args{'model'} == $Roku::LCD::M400) { } 0 0 0
90 # prefer arrow notation to typeglobs used in Roku::RCP
91 # ${*$self}{display_length} = $M500WIDTH ;
92 0 ${$self}->{display_length} = $M500WIDTH ;
93 0 ${$self}->{model} = $args{model};
94 }
95 elsif ( $args{model} == $M400 ) {
96 0 ${$self}->{display_length} = $M400WIDTH ;
97 0 ${$self}->{model} = $args{model};
98 }
99 }
100 else {
101 0 my $result = $self->_determine_model;
102
103 0 ▶ if (! ${$self}->{model}) {
Branch: 1 branch
BranchTrueFalseTotal
unless (${$self;}->{"model"}) 0 0 0
104 0 croak "Unrecognised display type - unknown model type. Try setting manually.\n";
105 }
106 }
107
108 0 print " ref \$self = '", ref $self ,"'\n ref \*\$self = '", ref *$self ,"'\n ref \${\$self} = '", ref ${$self} , "'\n ref \${\*\$self} = '", ref ${*$self}, "'\n";
109
110 0 ▶ if ( ${$self}->{debug} ) {
Branch: 1 branch
BranchTrueFalseTotal
if (${$self;}->{"debug"}) 0 0 0
111 0 print "DEBUG display length = ${$self}->{display_length}; model = M${$self}->{model}\n";
112 }
113
114 0 return bless $self, $class;
115 } # end new
116
117 =head2 marquee(text => I<text to display> [, clear => I<0/1>])
118
119 This allows quick access to the standard sketch marquee function - timings are for text sized to
120 the M400 display as I do not have access to an M500.
121
122 If 1 is passed to clear, it forces the display to clear first (default 0)
123
124 =cut
125
126 0 ▶sub marquee {
Subroutine marquee: not called CC=6 SCAR=37.4
Pod documented
127 0 my ( $self, %args ) = @_;
128
129 # only take over if on standby
130 0 ▶ if (! $self->onstandby ) {
Branch: 1 branch
BranchTrueFalseTotal
unless ($self->onstandby) 0 0 0
131 0 return ("Soundbridge running");
132 }
133 0 ▶ my $text = $args{'text'} || $EMPTY;
Condition0%0/3
$args{'text'} || $Roku::LCD::EMPTY
l!l&&r!l&&!r
000
MC/DC0%0/2
$args{'text'} || $Roku::LCD::EMPTY
$args{'text'} $Roku::LCD::EMPTY
Truth table0%0/3
A || B
A= $args{'text'}B= $Roku::LCD::EMPTY
ABresult
1X1
011
000
134 0 ▶ my $clear = $args{'clear'} || 0;
Condition0%0/2
$args{'clear'} || 0
l!l
00
MC/DC0%0/1
$args{'clear'} || 0
$args{'clear'}
Truth table0%0/2
A
A= $args{'clear'}
Aresult
11
00
135
136 # duration is a magic number - time to wait before releasing display.
137 0 my $duration = ( int( ( ( length($text) ) + 24 ) / 25 ) ) * 5;
138
139 0 ▶ if ( ${$self}->{debug} ) {
Branch: 1 branch
BranchTrueFalseTotal
if (${$self;}->{"debug"}) 0 0 0
140 0 print "DEBUG text length = ", length($text),
141 " duration = $duration\n";
142 }
143
144 0 ▶ if ($clear) { $self->_clear; }
Branch: 1 branch
BranchTrueFalseTotal
if ($clear) 0 0 0
145 0 $self->command("sketch -c marquee -start \"$text\"");
146 0 sleep($duration);
147 0 $self->command('sketch -c quit');
148 0 $self->command('sketch -c exit');
149
150 0 return ($self->sb_response);
151 } # end marquee
152
153
154 0 ▶sub _blank_line {
Subroutine _blank_line: not called CC=1 SCAR=6.9
155 # clears a single line
156 0 my ( $self, $line ) = @_;
157 0 my $rc = $self->_text(
158 text => $self->_spacefill(text => $SPACE),
159 duration => 0,
160 y => $line
161 );
162 0 return $rc;
163 } # end _blank_line
164
165
166 0 ▶sub _clear {
Subroutine _clear: not called CC=1 SCAR=6.9
167 # clear the display
168 0 my $self = shift;
169 0 $self->command('sketch -c clear');
170 0 my $rc = $self->sb_response;
171 0 return ($rc);
172 }
173
174 0 ▶sub _determine_model {
Subroutine _determine_model: not called CC=5 SCAR=34.0
175 # determine the soundbridge model from the display size
176 # M400 returns "16x2 LCD" - I assume M500 returns "40x2 LCD"
177 0 my $self = shift;
178 0 $self->command("displaytype");
179
180 0 my @responses = $self->sb_response();
181 0 foreach my $response (@responses) {
182
183 0 ▶ if ( ${$self}->{debug} ) {
Branch: 1 branch
BranchTrueFalseTotal
if (${$self;}->{"debug"}) 0 0 0
184 0 print "DEBUG display type returned '$response'\n";
185 }
186 0 ▶ if ($response =~ /^(\d{2})x/) {
Branch: 1 branch
BranchTrueFalseTotal
if ($response =~ /^(\d{2})x/) 0 0 0
187 0 ${$self}->{display_length} = $1;
188 0 ▶ if (${$self}->{display_length} == $M500WIDTH) {
Branch: 1 branch
BranchTrueFalseTotal
if (${$self;}->{'display_length'} == $Roku::LCD::M500WIDTH) { } 0 0 0
189 0 ${$self}->{model} = $M500 ;
190 0 return "model $M500";
191 }
192 else { # assume it's 16
193 0 ${$self}->{model} = $M400 ;
194 0 return "model $M400";
195 }
196 }
197 }
198 0 return; # nothing appeared - return empty handed
199 } # end _determine_model
200
201
202 0 ▶sub _spacefill {
Subroutine _spacefill: not called CC=3 SCAR=24.8
203 # pad line with spaces - used to overwrite previous lines
204 # WARNING! This is an internal function, and likely to change
205 0 my ( $self, %args ) = @_;
206 0 ▶ my $text = $args{'text'} || $EMPTY;
Condition0%0/3
$args{'text'} || $Roku::LCD::EMPTY
l!l&&r!l&&!r
000
MC/DC0%0/2
$args{'text'} || $Roku::LCD::EMPTY
$args{'text'} $Roku::LCD::EMPTY
Truth table0%0/3
A || B
A= $args{'text'}B= $Roku::LCD::EMPTY
ABresult
1X1
011
000
207 0 my $tl = length($text);
208
209 # how many spaces do we need ?
210 0 my $spc = ${$self}->{display_length} - $tl;
211 0 ▶ if ($spc < 1) {
Branch: 1 branch
BranchTrueFalseTotal
if ($spc < 1) { } 0 0 0
212 # no padding required
213 0 return $text;
214 }
215 else {
216 0 my $pattern = "%${tl}s%${spc}s";
217 0 return sprintf $pattern, $text, $SPACE;
218 }
219 } # end _spacefill
220
221 0 ▶sub _text {
Subroutine _text: not called CC=4 SCAR=30.0
222 # internal function allowing easy access to the sketch "text" command
223 # usage:
224 # _text(text => I<text to display> , duration => I<length of time to display> [, clear => I<0/1>], x => I<c/0-screen width>, y => I<0/1>)
225 0 my ( $self, %args ) = @_;
226
227 0 ▶ my $text = $args{'text'} || $SPACE;
Condition0%0/3
$args{'text'} || $Roku::LCD::SPACE
l!l&&r!l&&!r
000
MC/DC0%0/2
$args{'text'} || $Roku::LCD::SPACE
$args{'text'} $Roku::LCD::SPACE
Truth table0%0/3
A || B
A= $args{'text'}B= $Roku::LCD::SPACE
ABresult
1X1
011
000
228 0 ▶ my $x = $args{'x'} || 0;
Condition0%0/2
$args{'x'} || 0
l!l
00
MC/DC0%0/1
$args{'x'} || 0
$args{'x'}
Truth table0%0/2
A
A= $args{'x'}
Aresult
11
00
229 0 ▶ my $y = $args{'y'} || 0;
Condition0%0/2
$args{'y'} || 0
l!l
00
MC/DC0%0/1
$args{'y'} || 0
$args{'y'}
Truth table0%0/2
A
A= $args{'y'}
Aresult
11
00
230 0 my $duration = $args{'duration'};
231
232 0 $self->command("text $x $y \"$text\"");
233 0 sleep($duration);
234 0 return 1;
235 } # end _text
236
237
238 0 ▶sub _print_current_line {
Subroutine _print_current_line: not called CC=1 SCAR=6.9
239 # An internal function for the teletype method
240 # clears, then prints the current line
241 0 my ( $self, $text, $y ) = @_;
242 0 my $rc = $self->_blank_line($y);
243 0 $rc = $self->_ticker(
244 text => $text,
245 y => $y,
246 pause => $LETTERPAUSE
247 );
248 0 return $rc;
249 } # end _print_current_line
250
251
252 0 ▶sub _print_last_line {
Subroutine _print_last_line: not called CC=1 SCAR=6.9
253 # An internal function for the teletype method
254 # prints the last line on the top line
255 0 my ( $self, $text ) = @_;
256 0 my $rc = $self->_text(
257 text => $text,
258 duration => 0,
259 y => 0
260 );
261 0 return $rc;
262 } # end _print_last_line
263
264
265 0 ▶sub _ttparagraph {
Subroutine _ttparagraph: not called CC=12 SCAR=50.5
266 # An internal method which processes individual paragraphs for the teletype method
267 0 my ( $self, $text, $last_line_ref, $y_ref ) = @_;
268 0 my $dlength = ${$self}->{display_length}; # width of display
269 0 my $current_line;
270 0 my $current_line_length = 0;
271 0 my $rc;
272
273 # is the paragraph small enough to be printed on one line?
274 0 ▶ if (length($text) <= $dlength) {
Branch: 1 branch
BranchTrueFalseTotal
if (length $text <= $dlength) { } 0 0 0
275 0 ▶ if (${$last_line_ref}) {
Branch: 1 branch
BranchTrueFalseTotal
if (${$last_line_ref;}) 0 0 0
276 0 $rc = $self->_print_last_line(${$last_line_ref});
277 }
278 0 $rc = $self->_print_current_line($text, ${$y_ref});
279 # start next line
280 0 ${$y_ref} = 1;
281 0 ${$last_line_ref} = $self->_spacefill(text => $text);
282 }
283 else {
284 # process the paragraph - break it into words (split on space)
285 0 my @string = split(/ /, $text);
286
287 # work through each word in the array (ary_inx holds the current word's position)
288 0 foreach my $word (@string) {
289
290 0 ▶ if ( ( length( $word ) + $current_line_length ) < $dlength ) {
Branch: 2 branches
BranchTrueFalseTotal
if (length($word) + $current_line_length < $dlength) { } 0 0 0
elsif ($word =~ /^(\S+\W)(\S+)$/ and length($1) + $current_line_length + 1 < $dlength) { } 0 0 0
291 # if the word will fit on the current line
292 # (note less than as a space needs to be accomodated too)
293 0 ▶ $current_line .= $SPACE if ($current_line);
Branch: 1 branch
BranchTrueFalseTotal
if $current_line 0 0 0
294 0 $current_line .= $word;
295 0 $current_line_length = length($current_line);
296 }
297 # elsif the word will not fit on the current line but contains a non-word character - split on that (add one to the length because there's a space)
298 ▶ elsif ( ( $word =~ /^(\S+\W)(\S+)$/ )
Condition0%0/3
$word =~ /^(\S+\W)(\S+)$/ and length($1) + $current_line_length + 1 < $dlength
!ll&&!rl&&r
000
MC/DC0%0/2
$word =~ /^(\S+\W)(\S+)$/ and length($1) + $current_line_length + 1 < $dlength
$word =~ /^(\S+\W)(\S+)$/ length($1) + $current_line_length + 1 < $dlength
Truth table0%0/3
A and B
A= $word =~ /^(\S+\W)(\S+)$/B= length($1) + $current_line_length + 1 < $dlength
ABresult
0X0
100
111
299 && ( ( length($1) + $current_line_length + 1 ) < $dlength ) )
300 {
301 0 ▶ if ($current_line) { $current_line .= $SPACE; }
Branch: 1 branch
BranchTrueFalseTotal
if ($current_line) 0 0 0
302 0 $current_line .= $1;
303 # print the line
304 0 ▶ if (${$last_line_ref}) {
Branch: 1 branch
BranchTrueFalseTotal
if (${$last_line_ref;}) 0 0 0
305 0 $rc = $self->_print_last_line(${$last_line_ref});
306 }
307 0 $rc = $self->_print_current_line($current_line, ${$y_ref});
308 # start next line
309 0 ${$y_ref} = 1;
310 0 ${$last_line_ref} = $self->_spacefill(text => $current_line);
311 0 $current_line = $2;
312 0 $current_line_length = length($current_line);
313 }
314 else {
315 # too big for line, so print the line
316 0 ▶ if (${$last_line_ref}) {
Branch: 1 branch
BranchTrueFalseTotal
if (${$last_line_ref;}) 0 0 0
317 0 $rc = $self->_print_last_line(${$last_line_ref});
318 }
319 0 $rc = $self->_print_current_line($current_line, ${$y_ref});
320 # start next line
321 0 ${$y_ref} = 1;
322 0 ${$last_line_ref} = $self->_spacefill(text => $current_line);
323 0 $current_line = $word;
324 0 $current_line_length = length($current_line);
325 }
326 } # end foreach @string loop
327 # we've run out of words, but we haven't printed the line yet!
328 0 ▶ if (${$last_line_ref}) {
Branch: 1 branch
BranchTrueFalseTotal
if (${$last_line_ref;}) 0 0 0
329 0 $rc = $self->_print_last_line(${$last_line_ref});
330 }
331 0 $rc = $self->_print_current_line($current_line, ${$y_ref});
332 # fill last line for next paragraph call
333 0 ${$y_ref} = 1;
334 0 ${$last_line_ref} = $self->_spacefill(text => $current_line);
335 } # end paragraph processing
336 0 return $rc;
337 } # end _ttparagraph
338
339
340 =head2 ticker(text => I<text to display> [, y => I<0/1>] [, pause => I<seconds>])
341
342 An alternative to the marquee that can be displayed on either the top or bottom line.
343
344 =cut
345
346 0 ▶sub ticker { # an alternative to marquee
Subroutine ticker: not called CC=2 SCAR=17.9
Pod documented
347 0 my ( $self, %args ) = @_;
348 # only take over if on standby
349 0 ▶ if (! $self->onstandby ) {
Branch: 1 branch
BranchTrueFalseTotal
unless ($self->onstandby) 0 0 0
350 0 return ('Soundbridge running');
351 }
352
353 0 $self->command('sketch');
354
355 0 $self->_ticker(%args);
356
357 0 $self->command('quit');
358 0 my $rc = $self->sb_response;
359 0 return ($rc);
360 } # end ticker
361
362
363 0 ▶sub _ticker { # the real function - also used by teletype
Subroutine _ticker: not called CC=13 SCAR=52.0
364 0 my ( $self, %args ) = @_;
365 0 ▶ my $text = $args{'text'} || $EMPTY;
Condition0%0/3
$args{'text'} || $Roku::LCD::EMPTY
l!l&&r!l&&!r
000
MC/DC0%0/2
$args{'text'} || $Roku::LCD::EMPTY
$args{'text'} $Roku::LCD::EMPTY
Truth table0%0/3
A || B
A= $args{'text'}B= $Roku::LCD::EMPTY
ABresult
1X1
011
000
366 0 ▶ my $pause = $args{'pause'} || 5;
Condition0%0/2
$args{'pause'} || 5
l!l
00
MC/DC0%0/1
$args{'pause'} || 5
$args{'pause'}
Truth table0%0/2
A
A= $args{'pause'}
Aresult
11
00
367 0 ▶ my $y = $args{'y'} || 0;
Condition0%0/2
$args{'y'} || 0
l!l
00
MC/DC0%0/1
$args{'y'} || 0
$args{'y'}
Truth table0%0/2
A
A= $args{'y'}
Aresult
11
00
368 0 my $dlength = ${$self}->{display_length};
369 0 my $offset = 0; # offset for taking a substring
370 0 my $dtext = '0'; # currently displayed text
371 0 my $tlength = 0; # length of currently displayed text
372 0 my $dur = 0;
373 0 my $spc = 0;
374
375 0 my $length = 0;
376 0 ▶ while(++$length < ( length($text) ) ) {
Branch: 1 branch
BranchTrueFalseTotal
if (++$length < length $text) 0 0 0
377 0 $spc++;
378 0 ▶ if ( $tlength != $dlength ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($tlength != $dlength) 0 0 0
379 # current text length != display width
380 0 $tlength++;
381 }
382
383 0 ▶ if ( length($dtext) == $dlength ) {
Branch: 1 branch
BranchTrueFalseTotal
if (length $dtext == $dlength) 0 0 0
384 # increase the offset if the displayed text is the same length as the screen width
385 0 $offset++;
386 }
387
388 0 $dtext = substr( $text, $offset, $tlength );
389 0 ▶ if ( substr( $dtext, -1, 1 ) eq $SPACE ) { $spc = 0; }
Branch: 1 branch
BranchTrueFalseTotal
if (substr($dtext, -1, 1) eq $Roku::LCD::SPACE) 0 0 0
390
391 0 ▶ if ( ( length($text) > $dlength ) && ( ++$dur == $dlength ) ) {
Branch: 1 branch
BranchTrueFalseTotal
if (length $text > $dlength and ++$dur == $dlength) { } 0 0 0
Condition0%0/3
length $text > $dlength and ++$dur == $dlength
!ll&&!rl&&r
000
MC/DC0%0/2
length $text > $dlength and ++$dur == $dlength
length $text > $dlength ++$dur == $dlength
Truth table0%0/3
A and B
A= length $text > $dlengthB= ++$dur == $dlength
ABresult
0X0
100
111
392 # print "length > dlength && dur == dlength\n";
393 0 $self->_text( text => $dtext, duration => $LETTERPAUSE, y => $y );
394 0 ▶ if ( ${$self}->{debug} ) {
Branch: 1 branch
BranchTrueFalseTotal
if (${$self;}->{"debug"}) 0 0 0
395 0 print "DEBUG dtext='$dtext' dur='$dur' spc='$spc'\n";
396 }
397 0 $dur = $spc;
398 0 ▶ if ( $dur > $dlength ) { $dur = 0; }
Branch: 1 branch
BranchTrueFalseTotal
if ($dur > $dlength) 0 0 0
399 }
400 else {
401 # print "length <= dlength || dur != dlength\n";
402 0 $self->_text( text => $dtext, duration => $LETTERPAUSE, y => $y );
403 0 ▶ if ( ${$self}->{debug} ) {
Branch: 1 branch
BranchTrueFalseTotal
if (${$self;}->{"debug"}) 0 0 0
404 0 print "DEBUG dtext='$dtext' dur='$dur' spc='$spc'\n";
405 }
406 }
407 }
408 0 $dtext = substr( $text, -$dlength, $dlength );
409 0 $self->_text( text => $dtext, duration => $pause, y => $y );
410 0 return 1;
411 } # end _ticker
412
413 =head2 teletype(text => I<text to display> [, pause => I<seconds>] [, [linepause => I<seconds>])
414
415 An alternative to using marquee to display large quantities of text, scrolling the display upwards rather than from
416 the right.
417
418 The length of time to pause after each line of text is given by I<linepause>, wheras I<pause> holds the
419 length of time to pause at the end of the text.
420
421 =cut
422
423 0 ▶sub teletype {
Subroutine teletype: not called CC=6 SCAR=37.4
Pod documented
424 0 my ( $self, %args ) = @_;
425 0 ▶ my $text = $args{'text'} || $EMPTY; # default text is blank
Condition0%0/3
$args{'text'} || $Roku::LCD::EMPTY
l!l&&r!l&&!r
000
MC/DC0%0/2
$args{'text'} || $Roku::LCD::EMPTY
$args{'text'} $Roku::LCD::EMPTY
Truth table0%0/3
A || B
A= $args{'text'}B= $Roku::LCD::EMPTY
ABresult
1X1
011
000
426 0 ▶ my $linepause = $args{'linepause'} || 1; # length of time to wait in seconds before next line
Condition0%0/2
$args{'linepause'} || 1
l!l
00
MC/DC0%0/1
$args{'linepause'} || 1
$args{'linepause'}
Truth table0%0/2
A
A= $args{'linepause'}
Aresult
11
00
427 0 ▶ my $pause = $args{'pause'} || 1; # length of additional time to wait in seconds after message
Condition0%0/2
$args{'pause'} || 1
l!l
00
MC/DC0%0/1
$args{'pause'} || 1
$args{'pause'}
Truth table0%0/2
A
A= $args{'pause'}
Aresult
11
00
428
429 # only take over if on standby
430 0 ▶ if (! $self->onstandby ) {
Branch: 1 branch
BranchTrueFalseTotal
unless ($self->onstandby) 0 0 0
431 0 return ("Soundbridge running");
432 }
433
434 0 $self->command('sketch'); # put the command session into sketch mode
435
436 # Clear display first
437 0 $self->_clear;
438
439 0 my @string;
440 my $rc; # message returned by method
441 0 my $dlength = ${$self}->{display_length}; # width of display
442 0 my $line_length = 0; # current length of line
443 0 my $y = 0; # start at the top
444 0 my $last_string = undef; # last string printed
445
446 0 my (@paras) = split( /\n/, $text ); # break the text into paragraphs
447 0 foreach my $paragraph (@paras) {
448 0 $self->_ttparagraph($paragraph, \$last_string, \$y)
449 }
450 0 $rc = $self->_print_last_line($last_string);
451 0 $rc = $self->_text(
452 text => $self->_spacefill( text => $SPACE ),
453 duration => 0,
454 y => 1
455 );
456 0 sleep($pause);
457 0 $self->command('quit');
458 0 $rc = $self->sb_response;
459 0 return ($rc);
460 } # end teletype
461
462 =head2 onstandby
463
464 Checks whether the Soundbridge is on standby (returns true) or in use (returns false)
465
466 =cut
467
468 0 ▶sub onstandby {
Subroutine onstandby: not called CC=3 SCAR=24.8
Pod documented
469
470 # an almost direct lift of RokuUI's ison function
471 # this is used to see whether the radio is in use
472 0 my $self = shift;
473 0 $self->command("ps");
474
475 0 for my $ps ( $self->sb_response ) {
476 0 ▶ return 1 if $ps =~ /StandbyApp/;
Branch: 1 branch
BranchTrueFalseTotal
if $ps =~ /StandbyApp/ 0 0 0
477 }
478 0 return 0;
479 } # end onstandby
480
481 =head2 sb_response
482
483 Used to return any command responses; filtering out prompts
484
485 =cut
486
487 0 ▶sub sb_response {
Subroutine sb_response: not called CC=3 SCAR=24.8
Pod documented
488
489 # this is used to return any command responses, but filter out prompts
490 0 my $self = shift;
491 return map {
492 0 ▶ if ( ( !/^SoundBridge\>/ ) && ( !/^Sketch>/ ) ) { $_; }
Branch: 1 branch
BranchTrueFalseTotal
if (not /^SoundBridge\>/ || /^Sketch>/) 0 0 0
Condition0%0/3
/^SoundBridge\>/ || /^Sketch>/
l!l&&r!l&&!r
000
MC/DC0%0/2
/^SoundBridge\>/ || /^Sketch>/
/^SoundBridge\>/ /^Sketch>/
Truth table0%0/3
A || B
A= /^SoundBridge\>/B= /^Sketch>/
ABresult
1X1
011
000
493 } $self->response();
494 } # end sb_response
495
496 2 1;
497
498 # end of module, additional documentation below
499
500 __END__
↑ Summary