sine

sine は正弦波の振幅変調を生成する.

freq = 200 Hz (clamp = true)

API

Rust

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

Python

sine(freq, option, dst)

C#

Modulation.Sine(freq, option, dst);

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

各サンプル の値は, 振幅 （amplitude）, オフセット （offset）, 位相 （phase）に対して次式で与えられる.

freq は Freq<u32>（150 * Hz）や Freq<f32>（150.0 * Hz）で指定する.

SineOption

Rust

SineOption {
    amplitude,
    offset,
    phase,
    clamp,
    sampling_config,
    ..Default::default()
}

Python

SineOption(
    amplitude,
    offset,
    phase,
    clamp,
    sampling_config,
)

C#

new SineOption
{
    Amplitude = amplitude,
    Offset = offset,
    Phase = phase,
    Clamp = clamp,
    SamplingConfig = samplingConfig,
}

フィールド	型	デフォルト	説明
amplitude	u8	0xFF	正弦波の振幅
offset	u8	0x80	直流オフセット
phase	Angle	Angle::ZERO	位相
clamp	bool	false	範囲外の値を [0, 255] clampするか
sampling_config	SamplingConfig	SamplingConfig::FREQ_4K	サンプリング設定

amplitude と offset の組み合わせで波形が [0, 255] の範囲を外れる場合, clamp が false だとエラーになる. 範囲内に収まるよう値を選ぶか, clamp を true にする.

制約

SamplingConfigの制約により, 指定した周波数が表現可能な周波数でない場合がある. その場合はNearest(freq) を渡すと最も近い表現可能な周波数に丸める.

Rust

sine(Nearest(150.5 * Hz), &option, &mut dst)?;

Python

sine(Nearest(150.5 * Hz), option, dst)

C#

Modulation.Sine(Nearest(150.5f * Hz), option, dst);

Example

Rust

use autd3_rs::units::{Hz, rad};
use autd3_rs::value::SamplingConfig;
use autd3_rs_modulation::{SineOption, sine};

let mut dst = Vec::new();

sine(
    150 * Hz,
    &SineOption {
        amplitude: 0xFF,
        offset: 0x80,
        phase: 0.0 * rad,
        clamp: false,
        sampling_config: SamplingConfig::FREQ_4K,
        ..Default::default()
    },
    &mut dst,
)?;

Python

from autd3.units import Hz, rad
from autd3.value import SamplingConfig
from autd3_modulation import SineOption, modulation_buffer, sine

dst = modulation_buffer()

sine(
    150 * Hz,
    SineOption(
        amplitude=0xFF,
        offset=0x80,
        phase=0.0 * rad,
        clamp=False,
        sampling_config=SamplingConfig.FREQ_4K,
    ),
    dst,
)

C#

using AUTD3;
using static AUTD3.Units;

var dst = Modulation.ModulationBuffer();

Modulation.Sine(
    150 * Hz,
    new SineOption
    {
        Amplitude = 0xFF,
        Offset = 0x80,
        Phase = 0.0f * rad,
        Clamp = false,
        SamplingConfig = SamplingConfig.Freq4k,
    },
    dst
);