81 lines
2.5 KiB
Markdown
81 lines
2.5 KiB
Markdown
|
|
# Documentation
|
|
- Class name: SaltAudioFade
|
|
- Category: SALT/Audio/Process
|
|
- Output node: False
|
|
|
|
SaltAudioFade节点用于对音频片段应用淡入或淡出效果，从而增强其听觉过渡。这个过程涉及从音频片段的指定点开始，在特定的持续时间内逐渐增加或减少音量。
|
|
|
|
# Input types
|
|
## Required
|
|
- audio
|
|
- 需要应用淡变效果的原始音频数据。这个参数对于定义将要进行淡变处理的音频片段至关重要。
|
|
- Comfy dtype: AUDIO
|
|
- Python dtype: bytes
|
|
- fade_type
|
|
- 指定要应用的淡变效果类型：'in'表示淡入效果（音量逐渐增加），'out'表示淡出效果（音量逐渐减小）。这个选择直接影响音频片段的听觉过渡。
|
|
- Comfy dtype: COMBO[STRING]
|
|
- Python dtype: str
|
|
- fade_duration
|
|
- 淡变效果发生的持续时间，以秒为单位。这决定了音量过渡完成所需的时间。
|
|
- Comfy dtype: FLOAT
|
|
- Python dtype: float
|
|
## Optional
|
|
- fade_start
|
|
- 淡变效果在音频片段中的起始点，以秒为单位。这个可选参数允许精确控制淡变开始的时间。
|
|
- Comfy dtype: FLOAT
|
|
- Python dtype: float
|
|
|
|
# Output types
|
|
- audio
|
|
- 应用了淡入或淡出效果的修改后的音频数据，增强了音频片段的听觉体验。
|
|
- Comfy dtype: AUDIO
|
|
- Python dtype: bytes
|
|
|
|
|
|
## Usage tips
|
|
- Infra type: `CPU`
|
|
- Common nodes: unknown
|
|
|
|
|
|
## Source code
|
|
```python
|
|
class SaltAudioFade:
|
|
@classmethod
|
|
def INPUT_TYPES(cls):
|
|
return {
|
|
"required": {
|
|
"audio": ("AUDIO", ),
|
|
"fade_type": (["in", "out"],),
|
|
"fade_duration": ("FLOAT", {"min": 0.01}),
|
|
},
|
|
"optional": {
|
|
"fade_start": ("FLOAT", {"default": 0, "min": 0}),
|
|
},
|
|
}
|
|
|
|
RETURN_TYPES = ("AUDIO", )
|
|
RETURN_NAMES = ("audio", )
|
|
FUNCTION = "apply_fade"
|
|
CATEGORY = "SALT/Audio/Process"
|
|
|
|
def apply_fade(self, audio, fade_type, fade_duration, fade_start=0):
|
|
audio_segment = AudioSegment.from_file(io.BytesIO(audio), format="wav")
|
|
|
|
start_ms = int(fade_start * 1000)
|
|
duration_ms = int(fade_duration * 1000)
|
|
|
|
before_fade = audio_segment[:start_ms]
|
|
during_and_after_fade = audio_segment[start_ms:]
|
|
|
|
if fade_type == "in":
|
|
faded_part = during_and_after_fade.fade_in(duration_ms)
|
|
else:
|
|
faded_part = during_and_after_fade.fade_out(duration_ms)
|
|
|
|
output = before_fade + faded_part
|
|
|
|
return(get_buffer(output), )
|
|
|
|
```
|