SHAPE_EQCOMP_CONTEXT

イコライザーおよびコンプレッサー (EQComp) コンテキスト。

Syntax

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  

Members

timestamp
Type: UINT32 Read: コンテキスト処理の完了時のタイムスタンプ。 Reserved0
Type: UINT32 予約済み。 internalSaturate
Type: UINT32 Read: EQ/Comp が飽和している場合は 1、そうでない場合は 0。 mixBufPeakMag
Type: UINT32 Read: 出力ミックスバッファーのピーク振幅。 peakMag
Type: UINT32 Read: 出力のピーク振幅。 eqAB0
Type: UINT32 Read/Write: イコライザーフィルター A の係数 b0。 eqAB1_L
Type: UINT32 Read/Write: イコライザーフィルター A の係数 b1、下位 8 ビット。 eqAB1_H
Type: UINT32 Read/Write: イコライザーフィルター A の係数 b1、上位 16 ビット。 eqAB2_L
Type: UINT32 Read/Write: イコライザーフィルター A の係数 b2、下位 16 ビット。 eqAB2_H
Type: UINT32 Read/Write: イコライザーフィルター A の係数 b2、上位 8 ビット。 eqAA1
Type: UINT32 Read/Write: イコライザーフィルター A の係数 a1。 eqAA2
Type: UINT32 Read/Write: イコライザーフィルター A の係数 a2。 eqBB0_L
Type: UINT32 Read/Write: イコライザーフィルター B の係数 b0、下位 8 ビット。 eqBB0_H
Type: UINT32 Read/Write: イコライザーフィルター B の係数 b0、上位 16 ビット。 eqBB1_L
Type: UINT32 Read/Write: イコライザーフィルター B の係数 b1、下位 16 ビット。 eqBB1_H
Type: UINT32 Read/Write: イコライザーフィルター B の係数 b1、上位 8 ビット。 eqBB2
Type: UINT32 Read/Write: イコライザーフィルター B の係数 b2。 eqBA1
Type: UINT32 Read/Write: イコライザーフィルター B の係数 a1。 eqBA2_L
Type: UINT32 Read/Write: イコライザーフィルター B の係数 a2、下位 8 ビット。 eqBA2_H
Type: UINT32 Read/Write: イコライザーフィルター B の係数 a2、上位 16 ビット。 eqCB0_L
Type: UINT32 Read/Write: イコライザーフィルター C の係数 b0、下位 16 ビット。 eqCB0_H
Type: UINT32 Read/Write: イコライザーフィルター C の係数 b0、上位 8 ビット。 eqCB1
Type: UINT32 Read/Write: イコライザーフィルター C の係数 b1。 eqCB2
Type: UINT32 Read/Write: イコライザーフィルター C の係数 b2。 eqCA1_L
Type: UINT32 Read/Write: イコライザーフィルター C の係数 a1、下位 8 ビット。 eqCA1_H
Type: UINT32 Read/Write: イコライザーフィルター C の係数 a1、上位 16 ビット。 eqCA2_L
Type: UINT32 Read/Write: イコライザーフィルター C の係数 a2、下位 16 ビット。 eqCA2_H
Type: UINT32 Read/Write: イコライザーフィルター C の係数 a2、上位 8 ビット。 Reserved1
Type: UINT32 予約済み。 eqAInputDelay0
Type: UINT32 Read: 左チャンネルの入力遅延。 Reserved2
Type: UINT32 予約済み。 eqAInputDelay1
Type: UINT32 Read: 右チャンネルの入力遅延。 Reserved
Type: UINT32 予約済み。 eqDelayElements2
Type: UINT32 Read: 遅延要素。 eqDelayElements3
Type: UINT32 Read: 遅延要素。 eqDelayElements4
Type: UINT32 Read: 遅延要素。 eqDelayElements5
Type: UINT32 Read: 遅延要素。 eqDelayElements6
Type: UINT32 Read: 遅延要素。 eqDelayElements7
Type: UINT32 Read: 遅延要素。 compInputLevel
Type: UINT32 Read: コンプレッサーへの入力に対して計算された InputLevel。u8.23 形式 (-0x0000_0000 ～ 0x7FFF_FFFF)。8 つの整数ビットにより、コンプレッサーの前段でクリッピングせずに最大 48 dB のゲインを持つイコライザーセクションが可能になります。 compGainReduction
Type: UINT32 Read: コンプレッサーの計算済み減衰。u1.23 形式 (-0x00_0000 ～ 0x80_0000)。これは線形の乗数であり、0.5 に相当する値 0x40_0000 は -6 dB のゲイン、または 6 dB のゲインリダクションを意味します。 Reserved4
Type: UINT32 予約済み。 compGain
Type: UINT32 Read/Write: 現在の出力 (メイクアップ) ゲイン値。u3.13 形式 (-0x0000 ～ 0xFFFF)。 Reserved5
Type: UINT32 予約済み。 eqAB0Target
Type: UINT32 Read/Write: イコライザーフィルター A の係数ターゲット b0。 eqAB1Target_L
Type: UINT32 Read/Write: イコライザーフィルター A の係数ターゲット b1、下位 8 ビット。 eqAB1Target_H
Type: UINT32 Read/Write: イコライザーフィルター A の係数ターゲット b1、上位 16 ビット。 eqAB2Target_L
Type: UINT32 Read/Write: イコライザーフィルター A の係数ターゲット b2、下位 16 ビット。 eqAB2Target_H
Type: UINT32 Read/Write: イコライザーフィルター A の係数ターゲット b2、上位 8 ビット。 eqAA1Target
Type: UINT32 Read/Write: イコライザーフィルター A の係数ターゲット a1。 eqAA2Target
Type: UINT32 Read/Write: イコライザーフィルター A の係数ターゲット a2。 eqBB0Target_L
Type: UINT32 Read/Write: イコライザーフィルター B の係数ターゲット b0、下位 8 ビット。 eqBB0Target_H
Type: UINT32 Read/Write: イコライザーフィルター B の係数ターゲット b0、上位 16 ビット。 eqBB1Target_L
Type: UINT32 Read/Write: イコライザーフィルター B の係数ターゲット b1、下位 16 ビット。 eqBB1Target_H
Type: UINT32 Read/Write: イコライザーフィルター B の係数ターゲット b1、上位 8 ビット。 eqBB2Target
Type: UINT32 Read/Write: イコライザーフィルター B の係数ターゲット b2。 eqBA1Target
Type: UINT32 Read/Write: イコライザーフィルター B の係数ターゲット a1。 eqBA2Target_L
Type: UINT32 Read/Write: イコライザーフィルター B の係数ターゲット a2、下位 8 ビット。 eqBA2Target_H
Type: UINT32 Read/Write: イコライザーフィルター B の係数ターゲット a2、上位 16 ビット。 eqCB0Target_L
Type: UINT32 Read/Write: イコライザーフィルター C の係数ターゲット b0、下位 16 ビット。 eqCB0Target_H
Type: UINT32 Read/Write: イコライザーフィルター C の EQ 係数ターゲット b0、上位 8 ビット。 eqCB1Target
Type: UINT32 Read/Write: イコライザーフィルター C の係数ターゲット b1。 eqCB2Target
Type: UINT32 Read/Write: イコライザーフィルター C の係数ターゲット b2。 eqCA1Target_L
Type: UINT32 Read/Write: イコライザーフィルター C の係数ターゲット a1、下位 8 ビット。 eqCA1Target_H
Type: UINT32 Read/Write: イコライザーフィルター C の係数ターゲット a1、上位 16 ビット。 eqCA2Target_L
Type: UINT32 Read/Write: イコライザーフィルター C の係数ターゲット a2、下位 16 ビット。 eqCA2Target_H
Type: UINT32 Read/Write: イコライザーフィルター C の係数ターゲット a2、上位 8 ビット。 Reserved6
Type: UINT32 予約済み。 compRelease
Type: UINT32 Write: コンプレッサーのリリースレート。u1.23 形式 (-0x00_0001 ～ 0x80_0000)。コンプレッサー/エキスパンダーがリリースフェーズにあるときに、サンプル期間ごとに compGainReduction に加算される値です。compLogGain が設定されている場合、compRelease はビット 23 が compGainReduction の現在値の最上位ビットに揃うように右シフトされ、加算量が指数関数的になります。値 0 はこのメンバーに対して有効ではなく、正しく動作しなくなります。 Reserved7
Type: UINT32 予約済み。 compExpand
Type: UINT32 Write: SHAPE_EQCOMP_EXPAND_MODE を参照してください。 compLogGain
Type: UINT32 Write: SHAPE_EQCOMP_LOG_GAIN を参照してください。これにより、アタックフェーズおよびリリースフェーズでゲインリダクションが指数関数的に減増され、対数空間での線形性 (すなわち dB 単位での線形性) が得られます。 compSidechainMode
Type: UINT32 Write: SHAPE_EQCOMP_SIDECHAIN_MODE を参照してください。 compMode
Type: UINT32 Write: SHAPE_EQCOMP_COMPRESSOR_MODE を参照してください。 compEnable
Type: UINT32 Write: 1 == 有効、0 == 無効。 compThreshold
Type: UINT32 Write: しきい値。u1.23 形式 (-0x00_0000 ～ 0x80_0000)。 Reserved8
Type: UINT32 予約済み。 compAttack
Type: UINT32 Write: コンプレッサーのアタックレート。u1.23 形式 (-0x00_0001 ～ 0x80_0000)。コンプレッサー/エキスパンダーがアタックフェーズにあるときに、サンプル期間ごとに compGainReduction から減算される値です。compLogGain が設定されている場合、compAttack はビット 23 が compGainReduction の現在値の最上位ビットに揃うように右シフトされ、加算量が指数関数的になります。値 0 はこのメンバーに対して有効ではなく、正しく動作しなくなります。 Reserved9
Type: UINT32 予約済み。 compOneOverRatio
Type: UINT32 Write: コンプレッサーのスロープ。u1.15 形式 (-0x0000 ～ 0x8000)。これは、従来のコンプレッサーにおける比率コントロールの逆数です。比率 1:1 の場合、compOneOverRatio を 0x8000 に設定します。比率 4:1 の場合、compOneOverRatio を 0x2000 に設定します。値 0x0000 は無限大:1 の比率です。 compGainTarget
Type: UINT32 Write: 出力 (メイクアップ) ゲインに対するユーザー設定可能なターゲット。1 オーディオフレームの間に、ゲインは現在の値から compGainTarget までランプします。u3.13 形式 (-0x0000 ～ 0xFFFF)。

Remarks

この構造体は、イコライザー (EQ) およびコンプレッサーのコンテキストを保持します。Scalable Hardware Audio Processing Engine (SHAPE) は、1 オーディオフレームあたり最大 512 個の EQComp コンテキストを処理できます。詳細については、SHAPE の概要のイコライゼーションと圧縮を参照してください。

Requirements

Header: shapeeqcompcontext.h Supported platforms: XBOX One ファミリー本体および XBOX Series 本体

Conceptual documentation

ACP の概要

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

SHAPE_EQCOMP_CONTEXT

SHAPE_EQCOMP_CONTEXT

Syntax

Members

Remarks

Requirements

Conceptual documentation

See also

​SHAPE_EQCOMP_CONTEXT

​Syntax

​Members

​Remarks

​Requirements

​Conceptual documentation

​See also

SHAPE_EQCOMP_CONTEXT

Syntax

Members

Remarks

Requirements

Conceptual documentation

See also