SHAPE_EQCOMP_CONTEXT

Le contexte de l’égaliseur et du compresseur (EQComp).

Syntaxe

typedef struct SHAPE_EQCOMP_CONTEXT {  
    UINT32 timestamp : 21;  
    UINT32 reserved0 : 2;  
    UINT32 internalSaturate : 1;  
    UINT32 mixBufPeakMag : 4;  
    UINT32 peakMag : 4;  
    UINT32 eqAB0 : 24;  
    UINT32 eqAB1_L : 8;  
    UINT32 eqAB1_H : 16;  
    UINT32 eqAB2_L : 16;  
    UINT32 eqAB2_H : 8;  
    UINT32 eqAA1 : 24;  
    UINT32 eqAA2 : 24;  
    UINT32 eqBB0_L : 8;  
    UINT32 eqBB0_H : 16;  
    UINT32 eqBB1_L : 16;  
    UINT32 eqBB1_H : 8;  
    UINT32 eqBB2 : 24;  
    UINT32 eqBA1 : 24;  
    UINT32 eqBA2_L : 8;  
    UINT32 eqBA2_H : 16;  
    UINT32 eqCB0_L : 16;  
    UINT32 eqCB0_H : 8;  
    UINT32 eqCB1 : 24;  
    UINT32 eqCB2 : 24;  
    UINT32 eqCA1_L : 8;  
    UINT32 eqCA1_H : 16;  
    UINT32 eqCA2_L : 16;  
    UINT32 eqCA2_H : 8;  
    UINT32 reserved1 : 24;  
    UINT32 eqAInputDelay0 : 24;  
    UINT32 reserved2 : 8;  
    UINT32 eqAInputDelay1 : 24;  
    UINT32 reserved3 : 8;  
    UINT32 eqDelayElements2;  
    UINT32 eqDelayElements3;  
    UINT32 eqDelayElements4;  
    UINT32 eqDelayElements5;  
    UINT32 eqDelayElements6;  
    UINT32 eqDelayElements7;  
    UINT32 compInputLevel;  
    UINT32 compGainReduction : 24;  
    UINT32 reserved4 : 8;  
    UINT32 compGain : 16;  
    UINT32 reserved5 : 16;  
    UINT32 eqAB0Target : 24;  
    UINT32 eqAB1Target_L : 8;  
    UINT32 eqAB1Target_H : 16;  
    UINT32 eqAB2Target_L : 16;  
    UINT32 eqAB2Target_H : 8;  
    UINT32 eqAA1Target : 24;  
    UINT32 eqAA2Target : 24;  
    UINT32 eqBB0Target_L : 8;  
    UINT32 eqBB0Target_H : 16;  
    UINT32 eqBB1Target_L : 16;  
    UINT32 eqBB1Target_H : 8;  
    UINT32 eqBB2Target : 24;  
    UINT32 eqBA1Target : 24;  
    UINT32 eqBA2Target_L : 8;  
    UINT32 eqBA2Target_H : 16;  
    UINT32 eqCB0Target_L : 16;  
    UINT32 eqCB0Target_H : 8;  
    UINT32 eqCB1Target : 24;  
    UINT32 eqCB2Target : 24;  
    UINT32 eqCA1Target_L : 8;  
    UINT32 eqCA1Target_H : 16;  
    UINT32 eqCA2Target_L : 16;  
    UINT32 eqCA2Target_H : 8;  
    UINT32 reserved6 : 24;  
    UINT32 compRelease : 24;  
    UINT32 reserved7 : 2;  
    UINT32 compExpand : 1;  
    UINT32 compLogGain : 1;  
    UINT32 compSidechainMode : 2;  
    UINT32 compMode : 1;  
    UINT32 compEnable : 1;  
    UINT32 compThreshold : 24;  
    UINT32 reserved8 : 8;  
    UINT32 compAttack : 24;  
    UINT32 reserved9 : 8;  
    UINT32 compOneOverRatio : 16;  
    UINT32 compGainTarget : 16;  
} SHAPE_EQCOMP_CONTEXT  

Membres

timestamp
Type : UINT32 Lecture : Horodatage de la fin du traitement du contexte. Reserved0
Type : UINT32 Réservé. internalSaturate
Type : UINT32 Lecture : 1 si EQ/Comp est saturé; 0 sinon. mixBufPeakMag
Type : UINT32 Lecture : Amplitude de crête de la mémoire tampon de mixage de sortie. peakMag
Type : UINT32 Lecture : Amplitude de crête de la sortie. eqAB0
Type : UINT32 Lecture/Écriture : Coefficient b0 du filtre d’égaliseur A. eqAB1_L
Type : UINT32 Lecture/Écriture : Coefficient b1 du filtre d’égaliseur A, 8 bits de poids faible. eqAB1_H
Type : UINT32 Lecture/Écriture : Coefficient b1 du filtre d’égaliseur A, 16 bits de poids fort. eqAB2_L
Type : UINT32 Lecture/Écriture : Coefficient b2 du filtre d’égaliseur A, 16 bits de poids faible. eqAB2_H
Type : UINT32 Lecture/Écriture : Coefficient b2 du filtre d’égaliseur A, 8 bits de poids fort. eqAA1
Type : UINT32 Lecture/Écriture : Coefficient a1 du filtre d’égaliseur A. eqAA2
Type : UINT32 Lecture/Écriture : Coefficient a2 du filtre d’égaliseur A. eqBB0_L
Type : UINT32 Lecture/Écriture : Coefficient b0 du filtre d’égaliseur B, 8 bits de poids faible. eqBB0_H
Type : UINT32 Lecture/Écriture : Coefficient b0 du filtre d’égaliseur B, 16 bits de poids fort. eqBB1_L
Type : UINT32 Lecture/Écriture : Coefficient b1 du filtre d’égaliseur B, 16 bits de poids faible. eqBB1_H
Type : UINT32 Lecture/Écriture : Coefficient b1 du filtre d’égaliseur B, 8 bits de poids fort. eqBB2
Type : UINT32 Lecture/Écriture : Coefficient b2 du filtre d’égaliseur B. eqBA1
Type : UINT32 Lecture/Écriture : Coefficient a1 du filtre d’égaliseur B. eqBA2_L
Type : UINT32 Lecture/Écriture : Coefficient a2 du filtre d’égaliseur B, 8 bits de poids faible. eqBA2_H
Type : UINT32 Lecture/Écriture : Coefficient a2 du filtre d’égaliseur B, 16 bits de poids fort. eqCB0_L
Type : UINT32 Lecture/Écriture : Coefficient b0 du filtre d’égaliseur C, 16 bits de poids faible. eqCB0_H
Type : UINT32 Lecture/Écriture : Coefficient b0 du filtre d’égaliseur C, 8 bits de poids fort. eqCB1
Type : UINT32 Lecture/Écriture : Coefficient b1 du filtre d’égaliseur C. eqCB2
Type : UINT32 Lecture/Écriture : Coefficient b2 du filtre d’égaliseur C. eqCA1_L
Type : UINT32 Lecture/Écriture : Coefficient a1 du filtre d’égaliseur C, 8 bits de poids faible. eqCA1_H
Type : UINT32 Lecture/Écriture : Coefficient a1 du filtre d’égaliseur C, 16 bits de poids fort. eqCA2_L
Type : UINT32 Lecture/Écriture : Coefficient a2 du filtre d’égaliseur C, 16 bits de poids faible. eqCA2_H
Type : UINT32 Lecture/Écriture : Coefficient a2 du filtre d’égaliseur C, 8 bits de poids fort. Reserved1
Type : UINT32 Réservé. eqAInputDelay0
Type : UINT32 Lecture : Délai d’entrée du canal gauche. Reserved2
Type : UINT32 Réservé. eqAInputDelay1
Type : UINT32 Lecture : Délai d’entrée du canal droit. Reserved
Type : UINT32 Réservé. eqDelayElements2
Type : UINT32 Lecture : Élément de délai. eqDelayElements3
Type : UINT32 Lecture : Élément de délai. eqDelayElements4
Type : UINT32 Lecture : Élément de délai. eqDelayElements5
Type : UINT32 Lecture : Élément de délai. eqDelayElements6
Type : UINT32 Lecture : Élément de délai. eqDelayElements7
Type : UINT32 Lecture : Élément de délai. compInputLevel
Type : UINT32 Lecture : InputLevel calculé pour l’entrée du compresseur, au format u8.23 (-0x0000_0000 à 0x7FFF_FFFF). Les huit bits entiers permettent à la section d’égaliseur d’avoir un gain allant jusqu’à 48 dB avant le compresseur, sans écrêtage. compGainReduction
Type : UINT32 Lecture : Atténuation calculée pour le compresseur, au format u1.23 (-0x00_0000 à 0x80_0000). Il s’agit d’un multiplicateur linéaire; une valeur de 0x40_0000, qui correspond à 0,5, représente un gain de -6 dB ou une réduction de gain de 6 dB. Reserved4
Type : UINT32 Réservé. compGain
Type : UINT32 Lecture/Écriture : Valeur actuelle du gain de sortie (de compensation), au format u3.13 (-0x0000 à 0xFFFF). Reserved5
Type : UINT32 Réservé. eqAB0Target
Type : UINT32 Lecture/Écriture : Cible du coefficient b0 du filtre d’égaliseur A. eqAB1Target_L
Type : UINT32 Lecture/Écriture : Cible du coefficient b1 du filtre d’égaliseur A, 8 bits de poids faible. eqAB1Target_H
Type : UINT32 Lecture/Écriture : Cible du coefficient b1 du filtre d’égaliseur A, 16 bits de poids fort. eqAB2Target_L
Type : UINT32 Lecture/Écriture : Cible du coefficient b2 du filtre d’égaliseur A, 16 bits de poids faible. eqAB2Target_H
Type : UINT32 Lecture/Écriture : Cible du coefficient b2 du filtre d’égaliseur A, 8 bits de poids fort. eqAA1Target
Type : UINT32 Lecture/Écriture : Cible du coefficient a1 du filtre d’égaliseur A. eqAA2Target
Type : UINT32 Lecture/Écriture : Cible du coefficient a2 du filtre d’égaliseur A. eqBB0Target_L
Type : UINT32 Lecture/Écriture : Cible du coefficient b0 du filtre d’égaliseur B, 8 bits de poids faible. eqBB0Target_H
Type : UINT32 Lecture/Écriture : Cible du coefficient b0 du filtre d’égaliseur B, 16 bits de poids fort. eqBB1Target_L
Type : UINT32 Lecture/Écriture : Cible du coefficient b1 du filtre d’égaliseur B, 16 bits de poids faible. eqBB1Target_H
Type : UINT32 Lecture/Écriture : Cible du coefficient b1 du filtre d’égaliseur B, 8 bits de poids fort. eqBB2Target
Type : UINT32 Lecture/Écriture : Cible du coefficient b2 du filtre d’égaliseur B. eqBA1Target
Type : UINT32 Lecture/Écriture : Cible du coefficient a1 du filtre d’égaliseur B. eqBA2Target_L
Type : UINT32 Lecture/Écriture : Cible du coefficient a2 du filtre d’égaliseur B, 8 bits de poids faible. eqBA2Target_H
Type : UINT32 Lecture/Écriture : Cible du coefficient a2 du filtre d’égaliseur B, 16 bits de poids fort. eqCB0Target_L
Type : UINT32 Lecture/Écriture : Cible du coefficient b0 du filtre d’égaliseur C, 16 bits de poids faible. eqCB0Target_H
Type : UINT32 Lecture/Écriture : Cible du coefficient b0 du filtre d’égaliseur C, 8 bits de poids fort. eqCB1Target
Type : UINT32 Lecture/Écriture : Cible du coefficient b1 du filtre d’égaliseur C. eqCB2Target
Type : UINT32 Lecture/Écriture : Cible du coefficient b2 du filtre d’égaliseur C. eqCA1Target_L
Type : UINT32 Lecture/Écriture : Cible du coefficient a1 du filtre d’égaliseur C, 8 bits de poids faible. eqCA1Target_H
Type : UINT32 Lecture/Écriture : Cible du coefficient a1 du filtre d’égaliseur C, 16 bits de poids fort. eqCA2Target_L
Type : UINT32 Lecture/Écriture : Cible du coefficient a2 du filtre d’égaliseur C, 16 bits de poids faible. eqCA2Target_H
Type : UINT32 Lecture/Écriture : Cible du coefficient a2 du filtre d’égaliseur C, 8 bits de poids fort. Reserved6
Type : UINT32 Réservé. compRelease
Type : UINT32 Écriture : Taux de relâchement du compresseur, au format u1.23 (-0x00_0001 à 0x80_0000). Il s’agit de la quantité dont compGainReduction est incrémenté à chaque période d’échantillonnage lorsque le compresseur/expanseur est en phase de relâchement. Si compLogGain est défini, compRelease est décalé vers la droite afin d’aligner le bit 23 sur le bit le plus significatif de la valeur actuelle de compGainReduction; l’incrément devient ainsi exponentiel. La valeur 0 n’est pas valide pour ce membre et entraînera un fonctionnement incorrect. Reserved7
Type : UINT32 Réservé. compExpand
Type : UINT32 Écriture : Consultez SHAPE_EQCOMP_EXPAND_MODE. compLogGain
Type : UINT32 Écriture : Consultez SHAPE_EQCOMP_LOG_GAIN. Les phases d’attaque et de relâchement décrémentent et incrémentent alors la réduction de gain de façon exponentielle, afin de la rendre linéaire dans l’espace logarithmique, c’est-à-dire linéaire en dB. compSidechainMode
Type : UINT32 Écriture : Consultez SHAPE_EQCOMP_SIDECHAIN_MODE. compMode
Type : UINT32 Écriture : Consultez SHAPE_EQCOMP_COMPRESSOR_MODE. compEnable
Type : UINT32 Écriture : 1 == activé, 0 == désactivé. compThreshold
Type : UINT32 Écriture : Valeur du seuil, au format u1.23 (-0x00_0000 à 0x80_0000). Reserved8
Type : UINT32 Réservé. compAttack
Type : UINT32 Écriture : Taux d’attaque du compresseur, au format u1.23 (-0x00_0001 à 0x80_0000). Il s’agit de la quantité dont compGainReduction est décrémenté à chaque période d’échantillonnage lorsque le compresseur/expanseur est en phase d’attaque. Si compLogGain est défini, compAttack est décalé vers la droite afin d’aligner le bit 23 sur le bit le plus significatif de la valeur actuelle de compGainReduction; l’incrément devient ainsi exponentiel. La valeur 0 n’est pas valide pour ce membre et entraînera un fonctionnement incorrect. Reserved9
Type : UINT32 Réservé. compOneOverRatio
Type : UINT32 Écriture : Pente du compresseur, au format u1.15 (-0x0000 à 0x8000). Il s’agit de l’inverse du contrôle de taux traditionnel des compresseurs. Pour un taux de 1:1, définissez compOneOverRatio sur 0x8000. Pour un taux de 4:1, définissez compOneOverRatio sur 0x2000. La valeur 0x0000 correspond à un taux de infini:1. compGainTarget
Type : UINT32 Écriture : Cible définissable par l’utilisateur pour le gain de sortie (de compensation). Pendant une trame audio, le gain passe progressivement de la valeur actuelle à compGainTarget, au format u3.13 (-0x0000 à 0xFFFF).

Remarques

Cette structure contient le contexte de l’égaliseur (EQ) et du compresseur. Le moteur SHAPE (Scalable Hardware Audio Processing Engine) peut traiter jusqu’à 512 contextes EQComp par trame audio. Pour plus d’informations, consultez Égalisation et compression dans Vue d’ensemble de SHAPE.

Configuration requise

En-tête : shapeeqcompcontext.h Plateformes prises en charge : Consoles de la famille XBOX One et consoles XBOX Series

Documentation conceptuelle

Vue d’ensemble de l’ACP

Voir aussi

ShapeEqCompContext

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

SHAPE_EQCOMP_CONTEXT

SHAPE_EQCOMP_CONTEXT

Syntaxe

Membres

Remarques

Configuration requise

Documentation conceptuelle

Voir aussi

​SHAPE_EQCOMP_CONTEXT

​Syntaxe

​Membres

​Remarques

​Configuration requise

​Documentation conceptuelle

​Voir aussi

SHAPE_EQCOMP_CONTEXT

Syntaxe

Membres

Remarques

Configuration requise

Documentation conceptuelle

Voir aussi