XMA2 인코더 도구

XMA2 명령줄 인코더 도구(XMA2Encode)는 Pulse Code Modulation(PCM) 파일 세트를 XMA2 형식으로 또는 XMA2 파일을 PCM 형식으로 변환합니다. 이 도구는 XBOX 360과 XBOX One 모두에 사용될 수 있습니다. XBOX 360의 경우 변경 없이 도구의 출력을 사용할 수 있습니다. XBOX One의 경우 seek 테이블이 바이트 스왑되어야 할 수 있습니다. 이를 수행하는 코드는 이 항목의 XBOX One 형식 섹션에 있습니다.

XMA2Encode 사용하기
XBOX One 형식
자체 XMA 인코더 도구 작성

XMA2Encode 사용하기

다음 코드와 표는 XMA2Encode 사용법을 설명합니다.

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

옵션	설명
`file`	변환할 파일의 파일 이름을 지정합니다. 여러 파일/스피커 위치 쌍을 지정할 수 있습니다: `XMA2ENCODE pcmfile [/Speaker pos ...] [pcmfile [/Speaker pos ...] ...] [options]`. 여러 파일을 인코딩할 때 XMA2Encode는 입력 파일이 모두 단일 채널이거나 모두 스테레오여야 하며, 마지막 스트림은 인코딩되는 채널 수에 따라 모노 또는 스테레오여야 합니다. 참고: XMA2Encode는 PCM 형식 또는 XMA2 형식(`/DecodeToPCM`과 함께)의 오디오 파일만 지원합니다.
`/TargetFile xmafile`	`xmafile`로 인코딩합니다(단 하나의 대상 파일만 허용됨).
`/PCMOutputFile pcmfile`	생성된 XMA2 파일을 다시 `pcmfile`로 디코딩합니다. 이 옵션을 사용할 때 도구는 두 개의 출력 파일을 생성합니다: XMA2 인코딩된 오디오 파일과 방금 생성된 XMA2 파일을 디코딩한 결과인 PCM 파일. 결과 PCM 파일은 새 XMA2 파일과 동일한 오디오 품질을 가집니다. Windows에서 XMA2 파일의 품질을 미리 볼 수 있습니다.
`/DecodeToPCM pcmfile`	기존 XMA2 파일을 `pcmfile`로 디코딩합니다.
`/BlockSize`	사용할 XMA2 압축 블록 크기를 지정합니다(2KB에서 8,190KB). 기본 블록 크기는 64KB입니다.
`/Quality value`	사용할 XMA2 압축 품질 수준을 지정합니다(1에서 100). 품질의 기본값은 60입니다.
`/FilterHighFrequencies`	소스 파일의 고주파를 필터링합니다.
`/LoopWholeFile`	루프 포인트가 이미 존재하더라도 전체 파일을 루프합니다. `LoopWholeFile`과 `UseLoopPoints`는 상호 배타적입니다. `LoopWholeFile`이나 `UseLoopPoints` 인수 중 어느 것도 지정되지 않으면, 루프 포인트가 존재하더라도 파일은 루프되지 않습니다.
`/UseLoopPoints`	존재하는 경우 기존 루프 포인트를 사용합니다. 그렇지 않으면 루프하지 않습니다. `LoopWholeFile`과 `UseLoopPoints`는 상호 배타적입니다. `LoopWholeFile`이나 `UseLoopPoints` 인수 중 어느 것도 지정되지 않으면, 루프 포인트가 존재하더라도 파일은 루프되지 않습니다.
`/Speaker pos`	소스 파일의 채널에 대한 스피커 할당을 지정합니다. 이 옵션은 파일 이름 바로 뒤에 와야 합니다. `pos`는 `L`, `R`, `C`, `LFE`, `LS`, `RS`, `LB`, `RB`가 될 수 있으며, `L` = Front left, `R` = Front right, `C` = Front center, `LFE` = 저주파, `LS` = Left surround, `RS` = Right surround, `LB` = Left back, `RB` = Right back입니다. 참고: 입력 파일에 채널 마스크가 없거나, 파일의 채널 수와 일치하지 않는 비트 세트가 있는 채널 마스크가 있고 `Speaker` 옵션으로 스피커 할당이 지정되지 않은 경우, 결과 XMA 파일은 채널 마스크가 0이 됩니다.
`/MeasureTime`	인코딩에 소요된 시간을 표시합니다.
`/Verbose`	상세한 출력을 활성화합니다.
`/Help`	이 사용법 정보를 표시합니다.

비고

모든 옵션은 첫 글자로 축약될 수 있습니다. 다음 표는 XMA2Encode가 인코딩 문제를 나타내기 위해 인쇄할 수 있는 오류 코드를 나열합니다.

오류 코드	설명
0x88890001	지정된 루프 포인트가 유효하지 않습니다.
0x88890002	지정된 형식이 유효하지 않습니다.
0x88890003	매개변수가 범위를 벗어났습니다.
0x88890004	읽기 작업이 실패했습니다.
0x88890005	유효하지 않은 XMA 프레임이 있습니다.
0x88890006	불완전한 XMA 프레임이 있습니다.
0x88890007	Stuffing 비트가 0이었습니다.
0x88890008	데이터 가져오기가 실패했습니다.

XBOX One 형식

XMA2Encode의 출력은 XBOX One의 경우 ULONG 바이트 스왑되어야 합니다. 입력이 .wav 파일이라면 출력은 변경 없이 사용할 수 있습니다. seek 테이블을 바이트 스왑하려면 다음 코드 줄을 사용하십시오.

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

이 코드 줄을 앱에 추가하여 기능을 테스트한 다음, 앱에서 사전 처리가 필요하지 않도록 스왑을 수행하는 별도의 도구를 작성하는 것을 고려하십시오.

자체 XMA 인코더 도구 작성

xmaencoder.h 에 정의되고 xmaencoder.lib 에 구현된 메서드를 사용하여 자체 인코더 도구를 작성할 수 있습니다. xmaencoder.h 파일은 기본적으로 C:\Program Files (x86)\Microsoft GDK\191100\GXDK\toolKit\include 폴더에 있습니다. xmaencoder.lib 파일은 기본적으로 C:\Program Files (x86)\Microsoft GDK\191100\GXDK\toolKit\lib\amd64 폴더에 있습니다. 헤더와 라이브러리에서 사용 가능한 단일 메서드는 XAudio2XMAEncoder입니다. 헤더에 정의된 XMA2InMemoryEncoder와 XMAInMemoryEncoder 메서드(레거시)는 사용하지 마십시오.

이 섹션의 내용

XMA2 인코더 참조 xmaencoder.lib 에서 사용 가능한 함수를 설명합니다.

함께 보기

XMA2 개요

GDK and Game Engines Integration

Steam porting guide

Game Principles

Core Features

Console Features

XMA2Encode 사용하기

비고

XBOX One 형식

자체 XMA 인코더 도구 작성

이 섹션의 내용

함께 보기

​XMA2Encode 사용하기

​비고

​XBOX One 형식

​자체 XMA 인코더 도구 작성

​이 섹션의 내용

​함께 보기

XMA2Encode 사용하기

비고

XBOX One 형식

자체 XMA 인코더 도구 작성

이 섹션의 내용

함께 보기