> ## 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. # Herramienta de codificación XMA2 > 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](#ID4E2DAC) de este tema. * [Uso de XMA2Encode](#ID4E1) * [Formato de XBOX One](#ID4E2DAC) * [Escritura de su propia herramienta de codificación XMA](#ID4EPEAC) ## 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. ```cpp theme={null} 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](/build/console-features/audio/tools/xma2encoder/methods/xaudio2xmaencoder-xmaencoder-xbox-microsoft-m). No use los métodos `XMA2InMemoryEncoder` y `XMAInMemoryEncoder` (heredados) que se definen en el encabezado. ## En esta sección [Referencia del codificador XMA2](/build/console-features/audio/tools/xma2encoder/atoc-xmaencoder) Describe las funciones que están disponibles en *xmaencoder.lib*. ## Consulte también [Información general de XMA2](/build/console-features/audio/overviews/xma2-overview) ## Related topics - [Información general de XMA2](/es/build/console-features/audio/overviews/xma2-overview.md) - [XAudio2XMAEncoder](/es/build/console-features/audio/tools/xma2encoder/methods/xaudio2xmaencoder-xmaencoder-xbox-microsoft-m.md) - [Biblioteca y herramienta de línea de comandos del codificador XMA2](/es/build/console-features/audio/tools/xma2encoder/index.md) - [Información de referencia del codificador XMA2](/es/build/console-features/audio/tools/xma2encoder/atoc-xmaencoder.md) - [Herramientas](/es/build/console-features/audio/tools/index.md)