Struct Strobe 

pub struct Strobe {
    pub period: Time,
    pub duty: f64,
    pub phase: Time,
}

How a light is gated in time.

This is how machine vision freezes a moving part: fire the light for a small fraction of the frame and the object barely moves while it is lit. The trade is brightness — gating away nine tenths of the time delivers a tenth of the energy — and nothing here hides that. Watch out for auto-exposure, which will happily lengthen the integration to win the light back and undo the whole point; a strobed station wants a fixed exposure.

Fields

period: Time

Time between pulses. Match it to the frame period to fire once per frame.

duty: f64

Fraction of each period the light is on, 0..1.

phase: Time

Where the pulse sits inside the period.

Implementations

impl Strobe

pub fn new(period: Time, duty: f64) -> Strobe

A strobe of the given period, open for duty of each cycle.

duty is a fraction rather than a time, so changing the rate of a strobe leaves its exposure ratio alone — which is how a camera behaves and not how a shutter does.

pub fn is_on(&self, t: Time) -> bool

Whether the light is on at time t.

pub fn on_fraction(&self, start: Time, length: Time) -> f64

Fraction of a window of length opening at start for which the light is on. Exact, so it can be checked against the duty cycle — and it is what says how much of an exposure’s light a strobe actually delivers.

Trait Implementations

impl Clone for Strobe

fn clone(&self) -> Strobe

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Strobe

impl Debug for Strobe

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Strobe

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Strobe

fn eq(&self, other: &Strobe) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for Strobe

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Strobe