Companion项目中的对数函数表达式功能增强

概述

Companion项目最新版本中新增了对数函数表达式支持，包括log(自然对数)和log10(常用对数)两个函数。这一功能增强使得用户在设备控制场景下能够更方便地进行数值转换和计算。

技术背景

在设备控制领域，特别是音频处理和MIDI控制中，经常需要在不同数值表示之间进行转换。线性值和对数值之间的转换是一个常见需求：

• 线性值：均匀分布，适用于直接控制参数
• 对数值：符合人类听觉感知特性，常用于音量控制(dB表示)

新增功能详解

log函数

log(x)函数计算x的自然对数(以e为底)，数学表达式为ln(x)。适用于需要自然对数计算的场景。

log10函数

log10(x)函数计算x的常用对数(以10为底)，数学表达式为lg(x)。特别适用于分贝(dB)计算等音频处理场景。

典型应用场景

1. MIDI设备控制：

   • 将0-16383的线性MIDI值转换为对数刻度
   • 实现更符合听觉特性的音量控制曲线

2. OSC协议通信：

   • 在Open Sound Control协议中处理对数刻度参数
   • 实现音频设备参数的精确控制

3. 通用设备控制：

   • 任何需要将线性控制值转换为对数表示的设备
   • 创建更符合人类感知的控制曲线

使用示例

假设需要将MIDI的线性值(0-16383)转换为分贝值(-∞到0dB)：

log10($(internal:custom_var)*0.00006103515625)*20

这个表达式首先将MIDI值归一化到0-1范围，然后计算其对数值并转换为分贝表示。

技术实现意义

1. 提升控制精度：对数转换使得在低值区域能够获得更精细的控制
2. 符合感知特性：音频相关控制更符合人类听觉的非线性特性
3. 简化工作流程：无需外部计算工具，直接在表达式中完成转换

最佳实践建议

1. 对于音频相关控制，优先使用log10函数
2. 注意处理零和负数的边界情况
3. 结合Companion的条件表达式实现自动范围限制
4. 考虑使用变量存储中间结果提高表达式可读性

这一功能增强使得Companion在专业音频设备控制和科学计算场景下的表现更加出色，为用户提供了更强大的数学处理能力。