Outil d'encodage XMA2

L’outil d’encodage XMA2 en ligne de commande (XMA2Encode) convertit un ensemble de fichiers PCM (Pulse Code Modulation) au format XMA2 ou un fichier XMA2 au format PCM. Cet outil peut être utilisé pour la XBOX 360 et la XBOX One. Pour la XBOX 360, vous pouvez utiliser la sortie de l’outil sans aucune modification. Pour la XBOX One, la table seek pourrait nécessiter une permutation d’octets. Le code permettant de le faire se trouve dans la section Format XBOX One de cette rubrique.

Utilisation de XMA2Encode
Format XBOX One
Écriture de votre propre outil d’encodage XMA

Utilisation de XMA2Encode

Le code et le tableau suivants décrivent comment utiliser XMA2Encode.

Colonne 1
`XMA2Encode file [/TargetFile xmafile][/PCMOutputFile pcmfile][/DecodeToPCM pcmfile][/BlockSize][/Quality value][/FilterHighFrequencies][/LoopWholeFile][/UseLoopPoints][/Speaker pos][/MeasureTime][/Verbose][/Help]`

Option	Description
`file`	Spécifie le nom du fichier à convertir. Vous pouvez spécifier plusieurs paires fichier/position de haut-parleur : `XMA2ENCODE pcmfile [/Speaker pos ...] [pcmfile [/Speaker pos ...] ...] [options]`. Lorsque vous encodez plusieurs fichiers, XMA2Encode exige que les fichiers d’entrée soient soit tous à canal unique, soit tous stéréo, le dernier flux étant mono ou stéréo selon le nombre de canaux encodés. Remarque : XMA2Encode prend en charge uniquement les fichiers audio au format PCM ou au format XMA2 (avec `/DecodeToPCM`).
`/TargetFile xmafile`	Encode vers `xmafile` (un seul fichier cible est autorisé).
`/PCMOutputFile pcmfile`	Décode le fichier XMA2 généré vers `pcmfile`. Lorsque vous utilisez cette option, l’outil génère deux fichiers de sortie : un fichier audio encodé en XMA2 et un fichier PCM, qui est le résultat du décodage du fichier XMA2 qui vient d’être créé. Le fichier PCM obtenu a la même qualité audio que le nouveau fichier XMA2. Vous pouvez avoir un aperçu de la qualité du fichier XMA2 sur Windows.
`/DecodeToPCM pcmfile`	Décode un fichier XMA2 existant vers `pcmfile`.
`/BlockSize`	Spécifie la taille de bloc de compression XMA2 à utiliser (de 2 Ko à 8 190 Ko). La taille de bloc par défaut est de 64 Ko.
`/Quality value`	Spécifie le niveau de qualité de compression XMA2 à utiliser (de 1 à 100). La valeur de qualité par défaut est 60.
`/FilterHighFrequencies`	Filtre les hautes fréquences du fichier source.
`/LoopWholeFile`	Met en boucle le fichier entier, même si des points de boucle sont déjà présents. `LoopWholeFile` et `UseLoopPoints` s’excluent mutuellement. Si ni l’argument `LoopWholeFile` ni l’argument `UseLoopPoints` n’est spécifié, le fichier n’est pas mis en boucle, même si des points de boucle sont présents.
`/UseLoopPoints`	Utilise les points de boucle existants, s’ils sont présents; sinon, le fichier n’est pas mis en boucle. `LoopWholeFile` et `UseLoopPoints` s’excluent mutuellement. Si ni l’argument `LoopWholeFile` ni l’argument `UseLoopPoints` n’est spécifié, le fichier n’est pas mis en boucle, même si des points de boucle sont présents.
`/Speaker pos`	Spécifie l’affectation de haut-parleur pour un canal du fichier source. Cette option doit suivre immédiatement le nom du fichier. `pos` peut être `L`, `R`, `C`, `LFE`, `LS`, `RS`, `LB` ou `RB`, où `L` = avant gauche, `R` = avant droit, `C` = avant central, `LFE` = basse fréquence, `LS` = ambiophonique gauche, `RS` = ambiophonique droit, `LB` = arrière gauche et `RB` = arrière droit. Remarque : Si un fichier d’entrée n’a pas de masque de canaux, ou s’il a un masque de canaux dont le nombre de bits définis ne correspond pas au nombre de canaux du fichier et qu’aucune affectation de haut-parleur n’est spécifiée avec l’option `Speaker`, le fichier XMA obtenu a un masque de canaux de 0.
`/MeasureTime`	Affiche le temps consacré à l’encodage.
`/Verbose`	Active la sortie détaillée.
`/Help`	Affiche ces renseignements d’utilisation.

Remarques

Toutes les options peuvent être abrégées à leurs premières lettres. Le tableau suivant répertorie les codes d’erreur que XMA2Encode peut afficher pour signaler des problèmes d’encodage.

Code d’erreur	Description
0x88890001	Les points de boucle spécifiés ne sont pas valides.
0x88890002	Le format spécifié n’est pas valide.
0x88890003	Un paramètre est hors de la plage.
0x88890004	Une opération de lecture a échoué.
0x88890005	Une trame XMA n’était pas valide.
0x88890006	Une trame XMA était incomplète.
0x88890007	Le bit de bourrage était zéro.
0x88890008	Une récupération de données a échoué.

Format XBOX One

La sortie de XMA2Encode doit faire l’objet d’une permutation d’octets ULONG pour la XBOX One. Si l’entrée est un fichier .wav, la sortie peut être utilisée sans modification. Pour permuter les octets de la table seek, utilisez les lignes de code suivantes.

for(UINT32 i = 0;(i < xmaformat->BlockCount);i++)
    {
       rgpXMASeekTable[i] = _byteswap_ulong(rgpXMASeekTable[i]);
    }  

Envisagez d’ajouter ces lignes de code à votre application pour tester la fonctionnalité, puis d’écrire éventuellement un outil distinct pour effectuer la permutation afin qu’aucun prétraitement ne soit requis de votre application.

Écriture de votre propre outil d’encodage XMA

Il est possible d’écrire votre propre outil d’encodage à l’aide des méthodes définies dans xmaencoder.h et implémentées dans xmaencoder.lib. Par défaut, le fichier xmaencoder.h se trouve dans le dossier C:\Program Files (x86)\Microsoft GDK\191100\GXDK\toolKit\include. Par défaut, le fichier xmaencoder.lib se trouve dans le dossier C:\Program Files (x86)\Microsoft GDK\191100\GXDK\toolKit\lib\amd64. La seule méthode disponible dans l’en-tête et la bibliothèque est XAudio2XMAEncoder. N’utilisez pas les méthodes XMA2InMemoryEncoder et XMAInMemoryEncoder (héritées) définies dans l’en-tête.

Dans cette section

Référence de l’encodeur XMA2 Décrit les fonctions disponibles dans xmaencoder.lib.

Voir aussi

Vue d’ensemble de XMA2

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

Utilisation de XMA2Encode

Remarques

Format XBOX One

Écriture de votre propre outil d’encodage XMA

Dans cette section

Voir aussi

​Utilisation de XMA2Encode

​Remarques

​Format XBOX One

​Écriture de votre propre outil d’encodage XMA

​Dans cette section

​Voir aussi

Utilisation de XMA2Encode

Remarques

Format XBOX One

Écriture de votre propre outil d’encodage XMA

Dans cette section

Voir aussi