Custom Movement Panel
The ARC software uses controls that register themselves as a movement panel. This allows your plugin to listen to movement requests from other controls. When any control or ez-script calls for a movement direction (i.e., Forward, Left, Stop, etc.), your plugin can be responsible for moving the robot. There can only be one movement panel per robot project. This is because there is only one method of locomotion for a robot, which this movement panel would be responsible for.To understand more about how Movement Panels work in ARC, read this tutorial.
What's In A Movement Panel?
A movement panel will have buttons that let the user specify directions that the robot should move. Your movement panel will be responsible for the robot moving. This means that anywhere a direction is specified, your control will be responsible for moving the robot. Generally, a movement panel has speed controls in the form of trackbars of some sort.
Code Example
Want to make your movement panel? Here is an example of how to implement code that will respond to movement requests:
Code:
public FormMain()
: base() {
InitializeComponent();
// Assign this control as a movement panel so the software knows who owns the movements
EZ_Builder.FormMain.MovementPanel = this;
// Assign the movement locomotion style for this control.
// There are different kind of locomotion for your robot, and this helps other
// controls know what to expect when a movement is happening.
// Check out the ENUM to see what other locomotion styles there are that
// fits your movement panel type.
EZBManager.MovementManager.LocomotionStyle = LocomotionStyleEnum.GAIT;
// assign the movement event
// this event is raised when another ARC control requests movement
EZBManager.MovementManager.OnMovement2 += Movement_OnMovement2;
// assign the speed change event
// this event is raised when another control or user changes the speed
EZBManager.MovementManager.OnSpeedChanged += Movement_OnSpeedChanged;
}
private void FormModifiedServoMovementPanel_FormClosing(object sender, FormClosingEventArgs e) {
// Remove this control as a movement panel
EZ_Builder.FormMain.MovementPanel = null;
EZBManager.MovementManager.OnSpeedChanged -= Movement_OnSpeedChanged;
EZBManager.MovementManager.OnMovement2 -= Movement_OnMovement2;
}
private void Movement_OnSpeedChanged(int speedLeft, int speedRight) {
// do something with the speed change
}
private void Movement_OnMovement2(MovementManager.MovementDirectionEnum direction, byte speedLeft, byte speedRight) {
// **
// do something based on the speed
// handle speed change here
// **
// Now do something based on the new movement direction
if (direction == MovementManager.MovementDirectionEnum.Forward) {
// handle custom Forward movement
} else if (direction == MovementManager.MovementDirectionEnum.Reverse) {
// handle custom Reverse movement
} else if (direction == MovementManager.MovementDirectionEnum.Right) {
// handle custom Right movement
} else if (direction == MovementManager.MovementDirectionEnum.Left) {
// handle custom Left movement
} else if (direction == MovementManager.MovementDirectionEnum.Stop) {
// handle custom Stop movement
}
}