square

square は矩形波の振幅変調を生成する. 指定周波数 freq で high と low の 2 値を切り替える.

freq = 200 Hz

API

Rust

square(freq, &option, &mut dst)?;

Python

square(freq, option, dst)

C#

Modulation.Square(freq, option, dst);

引数	型	説明
freq	Freq<u32> 等	変調周波数
option	&SquareOption	追加オプション (下記参照)
dst	&mut Vec<u8>	出力バッファ

freq の指定方法は sine と同じ.

SquareOption

Rust

SquareOption {
    low,
    high,
    duty,
    sampling_config,
}

Python

SquareOption(
    low,
    high,
    duty,
    sampling_config,
)

C#

new SquareOption(
    low,
    high,
    duty,
    samplingConfig
)

フィールド	型	デフォルト	説明
low	u8	u8::MIN	低レベルの振幅
high	u8	u8::MAX	高レベルの振幅
duty	f32	0.5	1 周期に占める high の割合
sampling_config	SamplingConfig	SamplingConfig::FREQ_4K	サンプリング設定

1 周期のうち duty の割合が high, 残りが low になる.

duty が の範囲外だとエラーになる. duty を にすると常に low, にすると常に high になる.

Example

Rust

use autd3_rs::units::Hz;
use autd3_rs::value::SamplingConfig;
use autd3_rs_modulation::{SquareOption, square};

let mut dst = Vec::new();

square(
    150 * Hz,
    &SquareOption {
        low: u8::MIN,
        high: u8::MAX,
        duty: 0.5,
        sampling_config: SamplingConfig::FREQ_4K,
    },
    &mut dst,
)?;

Python

from autd3.units import Hz
from autd3.value import SamplingConfig
from autd3_modulation import SquareOption, modulation_buffer, square

dst = modulation_buffer()

square(
    150 * Hz,
    SquareOption(
        low=0x00,
        high=0xFF,
        duty=0.5,
        sampling_config=SamplingConfig.FREQ_4K,
    ),
    dst,
)

C#

using AUTD3;
using static AUTD3.Units;

var dst = Modulation.ModulationBuffer();

Modulation.Square(
    150 * Hz,
    new SquareOption(
        low: byte.MinValue,
        high: byte.MaxValue,
        duty: 0.5f,
        samplingConfig: SamplingConfig.Freq4k
    ),
    dst
);