Skip to main content

​
SetShapeEqCompCommand

Inicializa un comando EQ/Comp de SHAPE.

​
Sintaxis

​
Parámetros

command   _Inout_
Tipo: SHAPE_FLOWGRAPH_COMMAND* Comando SHAPE_FLOWGRAPH_COMMAND que se va a inicializar. contextId   
Tipo: UINT32 Identificador (índice) del contexto EQ/Comp al que hará referencia este comando. inputMixBuffer   
Tipo: UINT32 Identificador del búfer de mezcla de entrada. sidechainMixBuffer   
Tipo: UINT32 Búfer de mezcla de sidechain. Este parámetro se usa solo para sidechains externos y se omite para sidechains normales e internos. Para obtener más información, consulte SHAPE_EQCOMP_SIDECHAIN_MODE. outputMixBuffer   
Tipo: UINT32 Identificador del búfer de mezcla de salida.

​
Valor devuelto

Tipo: HRESULT Si la función se ejecuta correctamente, devuelve S_OK. Si uno o varios argumentos no son válidos, la función devuelve E_INVALIDARG.

​
Comentarios

El propósito del compresor es limitar la cantidad de intervalo dinámico de la señal. Para ello, supervisa el nivel de entrada y crea un valor de ganancia dinámico. El valor de ganancia se usa entonces como multiplicador de la señal y la escala apropiadamente en función del nivel actual de la señal de entrada. En otras palabras, es un control de volumen automático, que supervisa constantemente la señal de entrada y se ajusta constantemente. El compresor actúa solo sobre señales por encima de un umbral específico. Si la señal es menor que el umbral, la señal pasa sin alteraciones. El umbral lo establece la aplicación como parte de los datos de contexto de EQComp. En el contexto hay un control programable para realizar compresión o expansión. El compresor altera los datos de sonido según un parámetro de relación. Este especifica cuánta atenuación se debe aplicar a la señal entrante si supera el umbral. La relación es exactamente eso: la relación entre el nivel entrante y el nivel saliente. Con una relación de 2:1, cada 2 dB de nivel por encima del umbral producen 1 dB de salida del compresor por encima del nivel de umbral. Con una relación de 1:1, el compresor está esencialmente desactivado. La relación la establece la aplicación como parte de los datos de contexto.

​
Requisitos

Encabezado: shapeflowgraph.h Plataformas compatibles: consolas de la familia XBOX One y consolas XBOX Series

​
Consulte también

Información general sobre ACP Información general de SHAPE shapeflowgraph
Última modificación el 28 de agosto de 2026

Temas relacionados

ShapeFlowGraphSetShapeEqCompThresholdSetShapeEqCompAttackSetShapeEqCompGainSetShapeEqCompRatio