ConfigModulation

ConfigModulation は, Modulation バンクの再生パラメータを設定する低レベルコマンド. 設定は書き込まれるだけで, 有効化するには ActivateModulationBank を送る.

API

Rust

ConfigModulation {
    bank,
    config,
    size,
    loop_behavior,
};

Python

ConfigModulation(
    bank=bank,
    config=config,
    size=size,
    loop_behavior=loop_behavior,
)

C#

new ConfigModulation(
    bank: bank,
    config: config,
    size: size,
    loopBehavior: loopBehavior
);

フィールド	型	説明
bank	ModulationBank	対象バンク
config	SamplingConfig	再生サンプリング周波数
size	usize	サンプル数
loop_behavior	LoopBehavior	再生ループ回数 (Infinite / Finite)

size の下限は 2.

Example

Rust

use autd3_rs::commands::{
    ActivateModulationBank, Clear, ConfigModulation, Synchronize, WriteModulationBuffer,
};
use autd3_rs::geometry::{Autd3, Geometry};
use autd3_rs::units::Hz;
use autd3_rs::value::{LoopBehavior, ModulationBank, SamplingConfig, TransitionMode};
use autd3_rs::Client;
use autd3_rs::udp::TransportOption;
use autd3_rs_modulation::{SineOption, modulation_buffer, sine};

let geometry = Geometry::new(vec![Autd3::default()]);
let option = TransportOption::default();
let mut client = Client::open(&geometry, &option).await?;
client.send(Clear).await?;
client.send(Synchronize).await?;

let mut data = modulation_buffer();
sine(150 * Hz, &SineOption::default(), SamplingConfig::FREQ_4K, &mut data)?;

let bank = ModulationBank::B0;

client.send(WriteModulationBuffer {
    bank,
    offset: 0,
    data: &data,
}).await?;
client.send(ConfigModulation {
    bank,
    config: SamplingConfig::FREQ_4K,
    size: data.len(),
    loop_behavior: LoopBehavior::Infinite,
}).await?;
client.send(ActivateModulationBank {
    bank,
    transition_mode: TransitionMode::Immediate,
}).await?;

Python

import asyncio

from autd3 import Client, TransportOption
from autd3.commands import ActivateModulationBank, Clear, ConfigModulation, Synchronize, WriteModulationBuffer
from autd3.geometry import Autd3, Geometry
from autd3.units import Hz
from autd3.value import LoopBehavior, ModulationBank, SamplingConfig, TransitionMode
from autd3_modulation import SineOption, modulation_buffer, sine


async def main() -> None:
    geometry = Geometry([Autd3()])
    with await Client.open(geometry, TransportOption()) as client:
        await client.send(Clear())
        await client.send(Synchronize())

        data = modulation_buffer()
        sine(150 * Hz, SineOption(), SamplingConfig.FREQ_4K, data)

        bank = ModulationBank.B0

        await client.send(
            WriteModulationBuffer(
                bank=bank,
                offset=0,
                data=data,
            )
        )
        await client.send(
            ConfigModulation(
                bank=bank,
                config=SamplingConfig.FREQ_4K,
                size=len(data),
                loop_behavior=LoopBehavior.Infinite,
            )
        )
        await client.send(
            ActivateModulationBank(
                bank=bank,
                transition_mode=TransitionMode.Immediate,
            )
        )


asyncio.run(main())

C#

using System.Threading.Tasks;
using AUTD3;
using static AUTD3.Units;

var geometry = new Geometry(new[] { new Autd3() });
using var client = await Client.OpenAsync(geometry, new TransportOption());
await client.SendAsync(new Clear());
await client.SendAsync(new Synchronize());

var data = Modulation.ModulationBuffer();
Modulation.Sine(150 * Hz, new SineOption(), SamplingConfig.Freq4k, data);

var bank = ModulationBank.B0;

await client.SendAsync(new WriteModulationBuffer(
    bank: bank,
    offset: 0,
    data: data
));
await client.SendAsync(new ConfigModulation(
    bank: bank,
    config: SamplingConfig.Freq4k,
    size: (uint)data.Length,
    loopBehavior: LoopBehavior.Infinite
));
await client.SendAsync(new ActivateModulationBank(
    bank: bank,
    transitionMode: TransitionMode.Immediate
));