Herramienta de codificación XMA2

La herramienta de codificación de línea de comandos XMA2 (XMA2Encode) convierte un conjunto de archivos de modulación por impulsos codificados (PCM) al formato XMA2 o un archivo XMA2 al formato PCM. Esta herramienta se puede usar tanto para XBOX 360 como para XBOX One. Para XBOX 360, puede usar la salida de la herramienta sin ningún cambio. Para XBOX One, es posible que sea necesario intercambiar los bytes de la tabla seek. El código para hacerlo se encuentra en la sección Formato de XBOX One de este tema.

Uso de XMA2Encode
Formato de XBOX One
Escritura de su propia herramienta de codificación XMA

Uso de XMA2Encode

El código y la tabla siguientes describen cómo usar XMA2Encode.

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

Opción	Descripción
`file`	Especifica el nombre del archivo que se va a convertir. Puede especificar varios pares de archivo/posición de altavoz: `XMA2ENCODE pcmfile [/Speaker pos ...] [pcmfile [/Speaker pos ...] ...] [options]`. Cuando codifica varios archivos, XMA2Encode requiere que los archivos de entrada sean todos de un solo canal o todos estéreo, con la última secuencia en mono o estéreo, según el número de canales que se codifiquen. Nota: XMA2Encode solo admite archivos de audio en formato PCM o en formato XMA2 (con `/DecodeToPCM`).
`/TargetFile xmafile`	Codifica en `xmafile` (solo se permite un archivo de destino).
`/PCMOutputFile pcmfile`	Descodifica el archivo XMA2 generado de nuevo en `pcmfile`. Cuando usa esta opción, la herramienta genera dos archivos de salida: un archivo de audio codificado en XMA2 y un archivo PCM, que es el resultado de descodificar el archivo XMA2 que se acaba de crear. El archivo PCM resultante tiene la misma calidad de audio que el nuevo archivo XMA2. Puede obtener una vista previa de la calidad del archivo XMA2 en Windows.
`/DecodeToPCM pcmfile`	Descodifica un archivo XMA2 existente en `pcmfile`.
`/BlockSize`	Especifica el tamaño de bloque de compresión XMA2 que se va a usar (de 2 KB a 8190 KB). El tamaño de bloque predeterminado es 64 KB.
`/Quality value`	Especifica el nivel de calidad de compresión XMA2 que se va a usar (de 1 a 100). El valor predeterminado de calidad es 60.
`/FilterHighFrequencies`	Filtra las frecuencias altas del archivo de origen.
`/LoopWholeFile`	Reproduce en bucle todo el archivo, aunque ya haya puntos de bucle presentes. `LoopWholeFile` y `UseLoopPoints` son mutuamente excluyentes. Si no se especifica el argumento `LoopWholeFile` ni el argumento `UseLoopPoints`, el archivo no se reproduce en bucle, aunque haya puntos de bucle presentes.
`/UseLoopPoints`	Usa los puntos de bucle existentes, si están presentes; de lo contrario, no reproduce en bucle. `LoopWholeFile` y `UseLoopPoints` son mutuamente excluyentes. Si no se especifica el argumento `LoopWholeFile` ni el argumento `UseLoopPoints`, el archivo no se reproduce en bucle, aunque haya puntos de bucle presentes.
`/Speaker pos`	Especifica la asignación de altavoz para un canal del archivo de origen. Esta opción debe seguir inmediatamente al nombre del archivo. `pos` puede ser `L`, `R`, `C`, `LFE`, `LS`, `RS`, `LB` o `RB`, donde `L` = frontal izquierdo, `R` = frontal derecho, `C` = frontal central, `LFE` = baja frecuencia, `LS` = envolvente izquierdo, `RS` = envolvente derecho, `LB` = trasero izquierdo y `RB` = trasero derecho. Nota: Si un archivo de entrada no tiene una máscara de canales, o si tiene una máscara de canales con un número de bits establecidos que no coincide con el número de canales del archivo y no se especifican asignaciones de altavoz con la opción `Speaker`, el archivo XMA resultante tiene una máscara de canales de 0.
`/MeasureTime`	Muestra el tiempo empleado en la codificación.
`/Verbose`	Habilita la salida detallada.
`/Help`	Muestra esta información de uso.

Comentarios

Todas las opciones se pueden abreviar con sus primeras letras. La tabla siguiente enumera los códigos de error que XMA2Encode puede imprimir para indicar problemas con la codificación.

Código de error	Descripción
0x88890001	Los puntos de bucle especificados no son válidos.
0x88890002	El formato especificado no es válido.
0x88890003	Un parámetro está fuera del intervalo.
0x88890004	Error en una operación de lectura.
0x88890005	Había una trama XMA no válida.
0x88890006	Había una trama XMA incompleta.
0x88890007	El bit de relleno era cero.
0x88890008	Error en una captura de datos.

Formato de XBOX One

Los bytes de la salida de XMA2Encode deben intercambiarse por ULONG para XBOX One. Si la entrada es un archivo .wav, la salida se puede usar sin modificaciones. Para intercambiar los bytes de la tabla seek, use las siguientes líneas de código.

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

Considere agregar las líneas de código a su aplicación para probar la funcionalidad y, quizás, escribir después una herramienta independiente que realice el intercambio, de modo que su aplicación no necesite ningún preprocesamiento.

Escritura de su propia herramienta de codificación XMA

Es posible escribir su propia herramienta de codificación con los métodos definidos en xmaencoder.h e implementados en xmaencoder.lib. El archivo xmaencoder.h se encuentra de forma predeterminada en la carpeta C:\Program Files (x86)\Microsoft GDK\191100\GXDK\toolKit\include. El archivo xmaencoder.lib se encuentra de forma predeterminada en la carpeta C:\Program Files (x86)\Microsoft GDK\191100\GXDK\toolKit\lib\amd64. El único método que está disponible en el encabezado y la biblioteca es XAudio2XMAEncoder. No use los métodos XMA2InMemoryEncoder y XMAInMemoryEncoder (heredados) que se definen en el encabezado.

En esta sección

Referencia del codificador XMA2 Describe las funciones que están disponibles en xmaencoder.lib.

Consulte también

Información general de XMA2

GDK and Game Engines Integration

Steam porting guide

Game Principles

Core Features

Console Features

Uso de XMA2Encode

Comentarios

Formato de XBOX One

Escritura de su propia herramienta de codificación XMA

En esta sección

Consulte también

​Uso de XMA2Encode

​Comentarios

​Formato de XBOX One

​Escritura de su propia herramienta de codificación XMA

​En esta sección

​Consulte también

Uso de XMA2Encode

Comentarios

Formato de XBOX One

Escritura de su propia herramienta de codificación XMA

En esta sección

Consulte también