pymel.core.animation.sound¶

sound(*args, **kwargs)¶

Creates an audio node which can be used with UI commands such as soundControl or timeControl which support sound scrubbing and sound during playback.

Flags:

Long Name / Short Name		Argument Types	Properties
endTime / et		time
	Time at which to end the sound.
file / f		unicode
	Name of sound file.
length / l		bool
	Query the length (in the current time unit) of the sound.
mute / m		bool
	Mute the audio clip.
name / n		unicode
	Name to give the resulting audio node.
offset / o		time
	Time at which to start the sound.
sourceEnd / se		time
	Time offset from the start of the sound file at which to end the sound.
sourceStart / ss		time
	Time offset from the start of the sound file at which to start the sound. Flag can have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.sound

Example:

import pymel.core as pm

# Create an audio node for a sound file, and have it
# start at time 10.  This command will return the name
# of the created node, something like "audio1".
#
pm.sound( offset=10, file='ohNo.aiff' )

# In order to have this sound displayed in a
# timeControl widget (like the timeSlider) use a
# command like this one, where the global MEL variable
# $gPlayBackSlider is the name of the widget to display
# the sound in.
#
import maya.mel
gPlayBackSlider = maya.mel.eval( '$tmpVar=$gPlayBackSlider' )
pm.timeControl( gPlayBackSlider, edit=True, sound='audio1' )