Struct Map 

pub struct Map { /* private fields */ }

A directional connection between multiple signals. Changes to input signals will affect output signals.

Examples

Create a map between two signals:

use std::thread;
use std::time::Duration;
use libmapper_rs::graph::Map;
use libmapper_rs::signal::Signal;
fn create_map(sig_a: &Signal, sig_b: &Signal) -> Map {
  let map = Map::create(sig_a, sig_b);
  loop {
    if map.is_ready() {
     break;
    }
   thread::sleep(Duration::from_millis(10));
  }
  map
}

Implementations

impl Map

pub fn create(src: &Signal, dst: &Signal) -> Map

Create a new map between two signals. This does not actually create the map in the graph, push must be called to let the rest of the graph know about the map.

pub fn push(&self)

Publish this map to the distributed graph. After calling this function and once is_ready returns true, the map is active.

pub fn is_ready(&self) -> bool

Returns true once the map has been published and is active. Otherwise, returns false.

pub fn release(self)

Destroy the map, severing the connection between the signals.

pub fn set_expr(&self, expression: &str)

Set the expression used to map the values from the source(s) to the destination.

This is a helper function wrapping MapperObject::set_property_str

Trait Implementations

impl AsMprObject for Map

fn as_mpr_object(&self) -> *mut c_void