Name:	Medialon Variables Management
Version:	6.7.2
Available for:	Manager V7 and Manager V6 (Lite & Pro), Showmaster (Mini, ST, Pro, LE, XS & iPro)
Limitation In:
Device Brand:	Medialon
Positrack Compatible:	Yes
Resources type:	None

Overview

This mxm provides commands that act on variables, and these commands are positracked when they are used into a Medialon Manager timeline.

The first five commands, “Set Integer”, “Set String”, “Set Time”, “Set Enum” and “Set Date” are simple positracked assigments.

The commands “Start Timer”/“Stop timer” manage accurate timers on Time variables.

The commands “Start Counter”/“Stop Counter” manage accurate counters on Integer variables.

MxM Installation

No specific installation required.

Device Setup

No device creation window.

Device Commands

Set integer

to set the value of an integer variable.

• Integer variable: [Integer] Variable to set
• Value: [Integer] New value.

Set string

to set the value of a string variable.

• String variable: [String] Variable to set
• Value: [String] New value.

Set time

to set the value of a time variable.

• Time variable: [Time] Variable to set
• Value: [Time] New value.

Set enum

to set the value of an enum variable.

• Integer variable: [Enum] Variable to set
• Index: [Integer] New current index.

Set date

to set the value of an date variable.

• Date variable: [Date] Variable to set
• Value: [Date] New value.

Set real

to set the value of a real variable.

• Real variable: [Real] Variable to set
• Value: [Real] New value.

Swap

to swap the values of two variables.

• Variable 1: [any kind] Variable 1
• Varaible 2: [any kind] Variable 2.

Start timer

to start a timer on a Time variable.

• Time variable: [Time] Variable to set.
• Initial Value: [Time] Initial value of the variable.
• Final Value: [Time] Value to reach.
• Start from: [Enum] Defines the value to start from.
  • “Initial value”: The variable is first filled with the initial value passed as 2nd parameter before the timer runs.
  • “Current value”: The initial value passed as 2nd parameter is ignored.

Stop timer

to stop a timer on a Time variable.

• Time variable: [Time] Variable for which stop the timer.

Start counter

to start a counter on an Integer variable.

• Integer variable: [Integer] Variable to set.
• Initial Value: [Integer] Initial value of the variable.
• Final Value: [Integer] Value to reach.
• Incremental Value: [Integer] Value to add to the current value (can be negative).
• Time Interval/Duration: [Time] Time between each incrementation (period of the counter) if “Time mode” is on “Use interval”, total duration if “Time mode” is on “Use duration”.
• Start from: [Enum] Defines the value to start from.
  • “Initial value”: The variable is first filled with the initial value passed as 2nd parameter before the timer runs.
  • “Current value”: The initial value passed as 2nd parameter isignored.
• Time mode: [Enum] Defines time parameter.
• “Use interval”: The parameter “Time Interval/Duration” is an interval (period of the counter).
• “Use duration”: The parameter “Time Interval/Duration” is a duration (total time).

Usage: the parameters of the counters can also be variables affected by other commands. It is so possible to create sophisticated periodic changes, like special curves or accelerations, for example.

Stop counter

to stop a counter on an Integer variable.

• Integer variable: [Integer] Variable for which stop the counter.

Real to ASCII

Convert a real value into an ASCII string (IEEE–754 standard is used). Returned String is compliant with Low Level Communicator MXM byte format.

• String variable: [String] String variable which returns the ASCII value.
• Real Value: [Real] Real value to convert.
• Hex Coded ASCII: [Enum] Defines the form of the returned ASCII value.
  • “No”: The returned ASCII value is in Hex format not converted into ASCII value. An hex value of 3C will be returned as !3C.
  • “Yes”: The returned ASCII value is in Hex format converted into ASCII value. An hex value of 3C will be returned as !33 !3C.

Usage: Using this command doesn’t cause the String variable to be positracked. In such cases, Set String command must be used.

ASCII to Real

Convert an ASCII string value into a real value(IEEE–754 standard is used). Passed string must be compliant with Low Level Communicator MXM byte format (‘!XX’ is used to express XX hex value).

• Real variable: [Real] Real variable which returns the real value.
• ASCII Value: [String] String value to convert.

Usage: The command will automatically detect if the ASCII string is “Hex Coded ASCII” formatted (i.e a value of 4C is expressed as !34!3C) or not (i.e a value of 4C is expressed as !4C).

Using this command doesn’t cause the Real variable to be positracked. In such cases, Set Real command must be used.

Start Record

Starts to record the given variable into a file.

• Variable Name: [String] Name of the variable to record. The name must match an existing variable name.
• File Name: [String] File name to record into.

Usage: Note: Any class of variable can be recorded. The record continue until a Stop Record command is issued for the variable.

Stop Record

Stops the record for the given variable.

• Variable Name: [String] Name of the variable for which the record has to be stopped. The name must match an existing variable name.

Start Playback

Starts to playback the given variable from a file.

• Variable Name: [String] Name of the variable to playback. The name must match an existing variable name.
• File Name: [String] File name to playback.

Usage: Note: Only User and Screen class of variable can be playback. The playback ends when there is no more data to playback into the file or when a Stop Playback command is issued.

Stop Playback

Stops the playback for the given variable.

• Variable Name: [String] Name of the variable for which the playback has to be stopped. The name must match an existing variable name.

Device Variables

Status

[Enum] Current device status.

• “Iddle”: The device is stopped
• “Ready”: The device is ready.

Error

[Enum] Current error status.

• “No Error”: There is no error
• “No Variable”: The variable name passed to the command doesn’t match an existing variable
• “Invalid Param”: One of the parameter is invalid
• “File Access Error”: Recording or Playback cannot access the data file
• “Invalid File”: The data file is invalid, playback is not possible.

Revisions

V 1.0.1

• Added: Support for Showmaster.

V 1.0.2

• Internal Changes.
• Fixed: “Start Timer” and “Stop Timer” crash if parameter “Time” is not a time variable.

V 1.0.3

• Fixed: “Start Timer” is not correctly positracked.

V 1.0.4

• Added: Support for Showmaster Pro.

V 1.1.0

• Added: Support for Variable record feature.
• Added: “Start Record”, “Stop Record”, “Start Playback”, “Stop Playback” commands.

V 1.1.1

• Added: Support for Showmaster iPro.

V 1.1.2

• Removed: Device count to 16 limitation.

V 1.1.3

• Added: Support for Manager Kiosk.
• Fixed: Counter positrack doesn’t work properly when a timeline restarts after a pause.

V 6.0.0

• Modified: Support of Manager V6/Showmaster V2.

V 6.0.1

• Fixed: Device variables are not reset after a project load (Requires Manager 6.0.3+).

V 6.1.0

• Added: Support for Showmaster LE & Showmaster XS platforms.

V 6.1.1

• Modified: Internal Changes.

V 6.1.2

• Added: ‘Swap’ command has been added in order to swap the values of two variables.

V 6.1.3

• Fixed: Record variable feature doesn’t work anymore when processed from the timeline record panel.
• Modified: Internal Changes.

V 6.2.0

• Added: Compatibility for Overture CS.

V 6.2.1

• Fixed: If the duration of the SartCounter command is longer than 00:00:32/80, the integer that is counting up flips to a negative value and continues counting toward zero, after it reaches a value near 35000 for a counter up to 65000. This issue may occur at different duration values for different counter values.

V 6.2.2

• Fixed: Positrack functionality doesn’t work properly with Enum variables.
• Fixed: After a ‘Pause Task’ cue, a positracked Time variable is reseted when the task goes back to run.
• Fixed: A ‘Pause Task’ cue modifies a positracked Time variable value which has been started and then paused by another task.

V 6.7.0

• Improved: Support for High DPI displays (require Manager 6.7.0+ or Showmaster Editor 2.7.0+)
• Changed: Compatibility for Manager 6.7.0 and Showmaster Editor 2.7.0