> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ShapePeakMagnitudeToDecibel

> ShapePeakMagnitudeToDecibel

# ShapePeakMagnitudeToDecibel

Convertit une valeur de magnitude de crête en valeur en décibels.

## Syntaxe

```cpp theme={null}
float ShapePeakMagnitudeToDecibel(  
         UINT32 peakMagnitude  
)  
```

### Paramètres

*peakMagnitude*   \
Type : UINT32

Valeur de magnitude de crête à convertir.

### Valeur de retour

Type : float

Valeur en décibels obtenue.

## Remarques

Dans le moteur audio d'un titre, la gestion de la marge dynamique peut être très difficile. C'est pourquoi chaque bloc [SHAPE](/fr-CA/build/console-features/audio/overviews/shape-overview) maintient un état associé à la marge du signal et au gain. Chaque bloc (sauf les blocs SRC) indique si une saturation interne s'est produite pendant le traitement.

En plus de l'indicateur de saturation interne, chaque bloc matériel maintient également deux nombres de 4 bits représentant la magnitude de la sortie du bloc matériel. La magnitude est calculée en déterminant la sortie de crête pendant la trame audio et en comptant les zéros de tête de la valeur absolue de la crête. Un nombre de 4 bits est maintenu avec la magnitude de crête persistante; l'autre est réinitialisé par le matériel à chaque trame audio.

En plus de la surveillance de la magnitude de crête de chaque bloc matériel, la magnitude de crête des mémoires tampons de mixage est également maintenue. Lorsque la sortie d'un bloc matériel est ajoutée à une mémoire tampon de mixage, la magnitude de crête est calculée de la même manière (en comptant les zéros de tête). L'état de chaque bloc matériel maintient une paire supplémentaire de valeurs de magnitude de crête de 4 bits. Ces valeurs représentent la magnitude de crête de la mémoire tampon de mixage après que la sortie du bloc matériel y a été accumulée. Un nombre de 4 bits représente la magnitude de crête persistante et continue; l'autre est mis à jour à chaque trame audio. Les valeurs de magnitude de crête sont enregistrées dans le contexte des blocs SHAPE, même si c'est en fait l'état de la mémoire tampon de mixage qui est représenté.

La magnitude de crête est encodée selon le tableau suivant.

| Valeur binaire | Description |
| - | - |
| 0B0000 | Saturation : une valeur issue d'un calcul visant à produire une sortie a dépassé la plage signée de 24 bits et a été remplacée par l'extrême le plus proche. Plus précisément, une valeur supérieure à 8 388 607 (0x7F\_FFFF) a été remplacée par 8 388 607, ou une valeur inférieure à -8 388 608 (0x80\_0000) a été remplacée par -8 388 608. |
| 0B0001 | La valeur absolue de la crête était supérieure à MAX >> 1 (0x3F\_FFFF). |
| 0B0010 | La valeur absolue de la crête était supérieure à MAX >> 2 (0x1F\_FFFF). |
| 0B0011 | La valeur absolue de la crête était supérieure à MAX >> 3. |
| 0B0100 | La valeur absolue de la crête était supérieure à MAX >> 4. |
| 0B0101 | La valeur absolue de la crête était supérieure à MAX >> 5. |
| 0B0110 à 0B1101 | La valeur absolue de la crête était supérieure à MAX >> 6 à 13, respectivement. |
| 0B1110 | La valeur absolue de la crête était supérieure à MAX >> 14. |
| 0B1111 | La valeur absolue de la crête était inférieure ou égale à MAX >> 14. |

Pour aider à gérer la marge et à éviter le dépassement et la saturation, en plus des réglages de gain précis, un décalage vers la droite de 0 à 7 bits peut être effectué sur la sortie d'un bloc matériel avant son accumulation dans la mémoire tampon de mixage de sortie. Ce décalage est désigné dans le contexte de chaque bloc matériel SHAPE.

## Configuration requise

**En-tête :** shapecontexts.h

**Plateformes prises en charge :** consoles de la famille XBOX One et consoles XBOX Series

## Voir aussi

[Vue d'ensemble de SHAPE](/fr-CA/build/console-features/audio/overviews/shape-overview)\
[ShapeContexts](/fr-CA/reference/audio/shapecontexts/shapecontexts_members)


## Related topics

- [ShapePeakMagnitudeToDecibel](/reference/audio/shapecontexts/functions/shapepeakmagnitudetodecibel.md)
- [ShapeContexts](/reference/audio/shapecontexts/shapecontexts_members.md)