出力マスク

NOTE: firmware v12.1.0以降で使用可能

OutputMaskを送信することで, Gain, FociSTM, GainSTMのIntensity値にかかわらず, 振動子毎に出力を止めることができる.

use autd3::prelude::*;
fn main() {
let _ =
OutputMask::new(|_dev| |_tr| false);
}
#include<autd3.hpp>
int main() {
using namespace autd3;
OutputMask([](const auto&) { return [](const auto&) { return false; }; });
return 0; }

using AUTD3Sharp;
new OutputMask(_dev => _tr => false);

from pyautd3 import OutputMask
OutputMask(lambda _dev: lambda _tr: False)

OutputMaskコンストラクタの引数はFn(&Device) -> Fn(&Transducer) -> boolで, falseに設定した振動子の出力は無効化される.

なお, OutputMaskはGain, FociSTM, GainSTMの各Segment別に作用する.

特に指定しない限りは, Segment::S0が使用される.

マスクをかけるSegmentを変更する場合は, WithSegmentを使用する (transition_modeは影響しない).