Control Audio Gain with UXP Plugin

Question

Hey everyone,I'm currently working on a UXP plugin for Premiere Pro and I'm trying to read and write the native "Audio Gain" value of a clip (the one triggered by the 'G' hotkey).I've already looked into AudioClipTrackItem.getComponentChain(), but it only seems to expose the standard "Volume" and "Channel Volume" (Panner) effects. I also checked the ClipProjectItem to see if I can set the source clip gain, but couldn't find any audio-related properties there either.Is there any known way (maybe an undocumented method or a specific Action via the Transaction API) to get and set the actual Audio Gain? Or is this simply not exposed in UXP yet?Any hints or workarounds would be highly appreciated. Thanks!

PaulMurphy · Answer

The Gain value isn't part of the effects or component chain. It sits as a plain field on the clip object itself, alongside Source, InPoint, and OutPoint. It's reached through AudioClipTrackItem > SubClip > Clip, not through the AudioComponentChain that getComponentChain() reads. That's why the method only returns Volume and Channel Volume. It's looking in the wrong branch of the object graph.The value itself is stored as a linear amplitude multiplier, not decibels. Convert with linear = 10^(dB/20). A +3 dB gain is stored as roughly 1.4125.I checked classic ExtendScript and the QE DOM as well, and neither exposes this property. This looks like a genuine gap in the scripting API, not something you're missing. Worth filing as a UXP feature request.

Sign up

To post, reply, or follow discussions, please sign in with your Adobe ID.

Sign in to Adobe Community

To post, reply, or follow discussions, please sign in with your Adobe ID.