Struct PulseWidthEncoder

pub struct PulseWidthEncoder<H: Fn(u8) -> u8 + Send + Sync, F: Fn(&Device) -> H> { /* private fields */ }

Datagram to configure pulse width encoder table.

The pulse width encoder table is a table to determine the pulse width (or duty ratio) from the instensity. In the firmware, the intensity (0-255) is used as the index of the table to determine the pulse width (0-255). The period of the ultrasound is mapped to 256, and therefore, the ultrasound output is the ultrasound is maximum when the pulse width is 128 (50% in duty ratio).

The default table is set by the arcsin function so that EmitIntensity is linear; that is, table[i] = round(256*arcsin(i/255)/π).

Example

To set the pulse width encoder table, please specify a function that takes the index of the table as an argument and returns the pulse width for each device.

The following example sets the pulse width to be linearly proportional to the intensity for all devices.

PulseWidthEncoder::new(|_dev| |i| (i as f32 / 255. * 128.).round() as u8);

Implementations

impl<H: Fn(u8) -> u8 + Send + Sync, F: Fn(&Device) -> H> PulseWidthEncoder<H, F>

pub fn new(f: F) -> Self

Constructs a new PulseWidthEncoder.

Trait Implementations

impl<H: Clone + Fn(u8) -> u8 + Send + Sync, F: Clone + Fn(&Device) -> H> Clone for PulseWidthEncoder<H, F>

fn clone(&self) -> PulseWidthEncoder<H, F>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<H: Fn(u8) -> u8 + Send + Sync, F: Fn(&Device) -> H> Datagram for PulseWidthEncoder<H, F>

fn parallel_threshold(&self) -> Option<usize>

Returns the parallel threshold.

fn timeout(&self) -> Option<Duration>

Returns the timeout duration.

impl<H: Fn(u8) -> u8 + Send + Sync, F: Fn(&Device) -> H> Debug for PulseWidthEncoder<H, F>

fn fmt(&self, __derive_more_f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for PulseWidthEncoder<Box<dyn Fn(u8) -> u8 + Send + Sync>, Box<dyn Fn(&Device) -> Box<dyn Fn(u8) -> u8 + Send + Sync>>>

fn default() -> Self

Returns the “default value” for a type.