Pular para o conteúdo principal

​
SetShapeEqCompCommand

Inicializa um comando EQ/Comp do SHAPE.

​
Sintaxe

​
Parâmetros

command   _Inout_
Tipo: SHAPE_FLOWGRAPH_COMMAND* O comando SHAPE_FLOWGRAPH_COMMAND a ser inicializado. contextId   
Tipo: UINT32 ID do contexto EQ/Comp (índice) que esse comando referenciará. inputMixBuffer   
Tipo: UINT32 ID do buffer de mixagem de entrada. sidechainMixBuffer   
Tipo: UINT32 Buffer de mixagem de sidechain. Esse parâmetro é usado apenas para sidechains externos e é ignorado para sidechains normais e internos. Para obter mais informações, confira SHAPE_EQCOMP_SIDECHAIN_MODE. outputMixBuffer   
Tipo: UINT32 ID do buffer de mixagem de saída.

​
Valor retornado

Tipo: HRESULT Se a função for bem-sucedida, ela retornará S_OK. Se um ou mais argumentos forem inválidos, a função retornará E_INVALIDARG.

​
Comentários

A finalidade do compressor é limitar a quantidade de faixa dinâmica no sinal. Ele faz isso monitorando o nível de entrada e criando um valor de ganho dinâmico. O valor de ganho é então usado como multiplicador do sinal e o dimensiona adequadamente, dependendo do nível atual do sinal de entrada. Em outras palavras, é um controle automático de volume, que monitora constantemente o sinal de entrada e se ajusta constantemente. O compressor atua apenas em sinais acima de um limite específico. Se o sinal for menor que o limite, ele passa inalterado. O limite é definido pelo aplicativo como parte dos dados de contexto EQComp. Há um controle programável no contexto para realizar compressão ou expansão. O compressor altera os dados de som de acordo com um parâmetro de proporção. Ele especifica quanta atenuação deve ser aplicada ao sinal de entrada se ele exceder o limite. A proporção é exatamente isso: a razão entre o nível de entrada e o nível de saída. Com uma proporção de 2:1, cada 2 dB de nível acima do limite resulta em 1 dB de saída do compressor acima do nível do limite. Com uma proporção de 1:1, o compressor fica essencialmente desligado. A proporção é definida pelo aplicativo como parte dos dados de contexto.

​
Requisitos

Cabeçalho: shapeflowgraph.h Plataformas com suporte: consoles da família XBOX One e consoles XBOX Series

​
Confira também

Visão geral do ACP Visão geral do SHAPE shapeflowgraph
Última modificação em 19 de outubro de 2026