ZoomLCD help - 9. Other ZoomPlayer Data

9.1 OSD Message

String containing the ZoomPlayer On Screen Display message.

CommandDescriptionPossible return values
$dll(zp,1,4,0)Shown OSD at present
$dll(zp,1,4,1)Last OSD, even if it is not shown now
$dll(zp,1,4,2)OSD is visible, binary0- OSD is NOT visible
1- OSD is visible
$dll(zp,1,4,3)OSD is visible, logicalFALSE- OSD is NOT visible
TRUE- OSD is visible


9.2 Audio Volume

The current Audio Volume 0-100 (whole numbers only).

CommandDescription
$dll(zp,1,9,0)The current Audio Volume 0-100


9.3 Playlist

Each file in the play list is numbered relatively, with line 0 being the file currently played. -1 the file that was just played, and +1 the next file that is going to be played (+2 the next file after that and so on).

CommandDescription
$dll(zp,2,FIRST,0)Relative number of the FIRST file in the playlist
$dll(zp,2,LAST,0)Relative number of the LAST file in the playlist
$dll(zp,2,0,line nr*)file name without extension and path
$dll(zp,2,1,line nr*)File type (extension)
$dll(zp,2,2,line nr*)Date (system default format)
$dll(zp,2,3,line nr*)File size in bytes
$dll(zp,2,4,line nr*)Path (excluding file name)
$dll(zp,2,5,line nr*)File duration as h:mm:ss
$dll(zp,2,10,line nr*)Filename with extension
$dll(zp,2,11,line nr*)Compleat filename with path and extension
$dll(zp,2,20,line nr*)File date (not time), short format
$dll(zp,2,21,line nr*)File date (not time), long format
$dll(zp,2,22,line nr*)Year four-digit number (0000-9999)
$dll(zp,2,23,line nr*)Year two-digit number (00-99)
$dll(zp,2,24,line nr*)Month number without a leading zero (1-12)
$dll(zp,2,25,line nr*)Month as a number with a leading zero (01-12)
$dll(zp,2,26,line nr*)Month as an abbreviation (Jan-Dec)
$dll(zp,2,27,line nr*)Month as a full name (January-December)
$dll(zp,2,28,line nr*)Day as a number without a leading zero (1-31)
$dll(zp,2,29,line nr*)Day as a number with a leading zero (01-31)
$dll(zp,2,30,line nr*)Day as an abbreviation (Sun-Sat)
$dll(zp,2,31,line nr*)Day as a full name (Sunday-Saturday)
$dll(zp,2,32,line nr*)Hour without a leading zero (0-23)
$dll(zp,2,33,line nr*)Hour with a leading zero (00-23)
$dll(zp,2,34,line nr*)Hour without a leading zero (0-12) pm/am
$dll(zp,2,35,line nr*)Hour with a leading zero (00-12) pm/am
$dll(zp,2,36,line nr*)Minute without a leading zero (0-59)
$dll(zp,2,37,line nr*)Minute with a leading zero (00-59)
$dll(zp,2,38,line nr*)Second without a leading zero (0-59)
$dll(zp,2,39,line nr*)Second with a leading zero (00-59)
$dll(zp,2,40,line nr*)File size in Kb without fractions
$dll(zp,2,41,line nr*)File size in Kb with fractions
$dll(zp,2,42,line nr*)File size in Mb without fractions
$dll(zp,2,43,line nr*)File size in Mb with fractions
$dll(zp,2,44,line nr*)File size in Gb without fractions
$dll(zp,2,45,line nr*)File size in Gb with fractions
$dll(zp,2,50,line nr*)Duration in seconds
$dll(zp,2,51,line nr*)Duration in minutes without fractions
$dll(zp,2,52,line nr*)Duration in minutes with fractions

*Line nr is the relative number of the entry or file in the play list. 0 is the file currently playing, and -1 the one before and 1 the one after (and 2 the one after that and so on).



9.4 IFs and String compare

Comparing two string values.

$dll(zp,3,[expression],[result1]|[result2])

Example:
$dll(zp,3,Hello,True|False)
...
True

If [expression]<>'' then Result:=[result1] else Result:=[result2]
if([expression]!='') Result=[result1] else Result=[result2]

If expression isn't empty: Return the string before "|" ([result1]), otherwise return the string after "|" ([result2]).



$dll(zp,3,[expression],[result])

Example:
$dll(zp,3,Hello,1)
...
1

If [expression]<>'' then Result:=[result] else Result:=''
if([expression]!='') Result=[result1] else Result=''

If expression isn't empty: Return the second string ([result]), otherwise return empty (""). An empty string.

$dll(zp,3,[expression1]=[expression2],[result1]|[result2])

Example:
$dll(zp,3,Hello=Bye,equal|not equal)
...
not equal

if [expression1]=[expression2] then Result:=[result1] else Result:=[result2]
if([expression1]==[expression2]) Result=[result1] else Result=[result2]

If [expression1] is the same as [expression2]: the output is [result1], otherwise the output is [result2].

$dll(zp,3,[expression1]=[expression2],[result])


if [expression1]=[expression2] then Result:=[result1] else Result:=''
if([expression1]==[expression2]) Result=[result1] else Result=''

Is the same as writing $dll(zp,3,[expression1]=[expression2],[result]|). If [expression1] is not the same as [expression2] the output is an empty string.



$dll(zp,3,[expression1]<>[expression2],[result1]|[result2])

Example:
$dll(zp,3,Hello<>Bye,not equal|equal)
...
not equal

if [expression1]<>[expression2] then Result:=[result1] else Result:=[result2]
if([expression1]!=[expression2]) Result=[result1] else Result=[result2]

If [expression1] is not the same as [expression2]: Return [result1], if they are the same return [result2].

$dll(zp,3,[expression1]<>[expression2],[result1])


if [expression1]<>[expression2] then Result:=[result1] else Result:=''
if([expression1]!=[expression2]) Result=[result1] else Result=''

Is the same as writing $dll(zp,3,[expression1]<>[expression2],[result]|). If [expression1] is the same as [expression2] the output is an empty string.



$dll(zp,3,[expression1]>[expression2],[result1]|[result2])

Example:
$dll(zp,3,9>1,greater than one|less than one)
...
greater than one

Compares the ASCII values of string [expression1] and [expression2]: if [expression1] has higher value return [result1], otherwise return [result2].
NOTE: if you are comparing numbers, it's safer to use the number comparing routines of the $dll(zp,4,... command set.

If [result2] is empty or a | character isn't used, see above, [result2] is assumed to be an empty string.

$dll(zp,3,[expression1]<[expression2],[result1]|[result2])

Example:
$dll(zp,3,9<1,greater than nine|less than nine)
...
less than nine

Compares the ASCII values of string [expression1] and [expression2]: If [expression1] has the lower value return [result1], otherwise return [result2].
NOTE: if you are comparing numbers, it's safer to use the number comparing routines of the $dll(zp,4,... command set.

If [result2] is empty or a | character isn't used, see above, [result2] is assumed to be an empty string.

9.5 IFs and Numeric compare

Comparing two numbers. Works just like command set $dll(zp,4,... but with numbers and numbers with fractions.

$dll(zp,4,[expression],[result1]|[result2])

Is expression a number?

Example:
$dll(zp,4,Hello,True|False)
...
False

$dll(zp,4,-0.45,True|False)
...
True

If isNumber([expression]) then Result:=[result1] else Result:=[result2]
if(isNumber([expression])) Result=[result1] else Result=[result2]

If expression isn't a number return the string before "|" ([result1]), otherwise return the string after "|" ([result2]).
NOTE: If [expression] is empty output is [result2].



$dll(zp,4,[expression],[result])

Is expression a number?

Example:
$dll(zp,4,-0.45,1)
...
1

If isNumber([expression]) then Result:=[result] else Result:=''
if(isNumber([expression])) Result=[result1] else Result=''

If expression is a number return the second string ([result]), otherwise return empty. An empty string.
NOTE: If [expression] is empty output an empty string ("").



$dll(zp,4,[expression1]=[expression2],[result1]|[result2])

Compare two numbers. Are the numbers equal?

Example:
$dll(zp,4,Hello=Hello,equal|not equal)
...
not equal

Example:
$dll(zp,4,0.55=0.55,equal|not equal)
...
equal

if isNumber([expression1]) AND isNumber([expression2]) AND ([expression1]=[expression2]) then Result:=[result1] else Result:=[result2]
if (isNumber([expression1]) && isNumber([expression2]) && ([expression1]==[expression2])) Result=[result1] else Result=[result2]

If [expression1] is the same as [expression2] and both are numbers the output is [result1], otherwise the output is [result2]



$dll(zp,4,[expression1]=[expression2],[result])

Compare two numbers. Are the numbers different?

if isNumber([expression1]) AND isNumber([expression2]) AND ([expression1]=[expression2]) then Result:=[result1] else Result:=''
if (isNumber([expression1]) && isNumber([expression2]) && ([expression1]==[expression2])) Result=[result1] else Result=''

Is the same as writing $dll(zp,4,[expression1]=[expression2],[result]|).
If [expression1] is not the same as [expression2] the output is an empty string.



$dll(zp,4,[expression1]<>[expression2],[result1]|[result2])

Compare two numbers. Are the numbers different?

Example:
$dll(zp,4,Hello<>Bye,Two different numbers|Not two different numbers)
...
Not two different numbers

$dll(zp,4,5<>4,Two different numbers|Not two different numbers)
...
Two different numbers

$dll(zp,4,5<>5,Two different numbers|Not two different numbers)
...
Not two different numbers

if isNumber([expression1]) AND isNumber([expression2]) AND ([expression1]<>[expression2]) then Result:=[result1] else Result:=[result2]
if(isNumber([expression1]) && isNumber([expression2]) && ([expression1]!=[expression2])) Result=[result1] else Result=[result2]

If [expression1] is not the same as [expression2] return [result1], if they are the same return [result2].
If [expression1] or [expression2] is not a number return [result2].



$dll(zp,4,[expression1]<>[expression2],[result1])

Compare two numbers. Are the numbers different?

if isNumber([expression1]) AND isNumber([expression2]) AND ([expression1]<>[expression2]) then Result:=[result1] else Result:=''
if(isNumber([expression1]) && isNumber([expression2]) && ([expression1]!=[expression2])) Result=[result1] else Result=''

Is the same as writing $dll(zp,4,[expression1]<>[expression2],[result]|). If [expression1] is the same as [expression2] the output is an empty string. If [expression1] or [expression2] is not a number the result is also an empty string.



$dll(zp,4,[expression1]>[expression2],[result1]|[result2])

Compare two numbers. Is number one greater than number two?

Example:
$dll(zp,4,9>1,greater than one|less than one or not a number)
...
greater than one

if isNumber([expression1]) AND isNumber([expression2]) AND ([expression1]>[expression2]) then Result:=[result1] else Result:=''
if (isNumber([expression1]) && isNumber([expression2]) && ([expression1]>[expression2])) Result=[result1] else Result=''

Compares the numeric values of [expression1] and [expression2]. if [expression1] has higher value return [result1] otherwise return [result2]. If [expression1] or [expression2] is not a number, the result is [result2].

If [result2] is empty or a "|" character isn't used, see above, [result2] is assumed to be an empty string.



$dll(zp,4,[expression1]<[expression2],[result1]|[result2])

Compare two numbers. Is number two greater than number one?

Example:
$dll(zp,4,9<1,greater than nine|less than nine or not a number)
...
less than nine or not a number

if isNumber([expression1]) AND isNumber([expression2]) AND ([expression1]<[expression2]) then Result:=[result1] else Result:=''
if (isNumber([expression1]) && isNumber([expression2]) && ([expression1]<[expression2])) Result=[result1] else Result=''

Compares the values of [expression1] and [expression2]. if [expression1] has lower value than [expression2] return [result1], otherwise return [result2].

If [expression1] or [expression2] is not a number the result is [result2].

If [result2] is empty or a "|" character isn't used, see above, [result2] is assumed to be an empty string.

Go back to Index