flac

무료 무손실 오디오 코덱(FLAC)

FLAC는 정보를 제거할 필요 없이 디지털 오디오 신호를 저장하는 데 필요한 저장 공간의 양을 줄일 수 있는 오픈 소스 소프트웨어입니다.

이 소프트웨어로 읽고 생성한 파일을 FLAC 파일이라고 합니다. FLAC 형식을 따르는 이러한 파일은 다른 소프트웨어에서도 읽고 쓸 수 있으므로 이 소프트웨어를 FLAC 참조 구현이라고도 합니다.

FLAC은 자원봉사자들에 의해 개발되었습니다. 도움을 주고 싶다면 CONTRIBUTING.md에서 자세한 내용을 확인하세요.

구성요소

FLAC은 다음과 같이 구성되어 있습니다.

• libFLAC, 기본 FLAC 및 Ogg FLAC용 참조 인코더 및 디코더와 메타데이터 인터페이스를 구현하는 라이브러리
• libFLAC++, libFLAC 주변의 C++ 객체 래퍼 라이브러리
• flac - 파일 인코딩 및 디코딩을 위한 명령줄 프로그램
• FLAC 메타데이터를 보고 편집하기 위한 명령줄 프로그램 metaflac
• 사용자 및 API 문서

라이브러리(libFLAC, libFLAC++)는 Xiph.org의 BSD 유사 라이선스에 따라 라이선스가 부여됩니다(COPYING.Xiph 참조). 다른 모든 프로그램과 플러그인은 GNU General Public License(COPYING.GPL 참조)에 따라 라이센스가 부여됩니다. 문서는 GNU 무료 문서 라이센스(COPYING.FDL 참조)에 따라 라이센스가 부여됩니다.

선적 서류 비치

flac 및 metaflac 명령줄 도구에 대한 문서는 flac.md 및 Metaflac.md 파일이 포함된 man 디렉터리를 참조하세요.

API 문서는 HTML로 되어 있으며 Doxygen에 의해 생성됩니다. doc/html/api 디렉토리에서 찾을 수 있습니다. 이는 릴리스 tarball에 포함되어 있으며 소스를 git에서 직접 가져올 때 Doxygen으로 빌드해야 합니다.

디렉토리 예제에는 libFLAC 및 libFLAC++ 사용에 대한 예제 소스 코드가 포함되어 있습니다.

FLAC 형식 자체(libFLAC와 독립적으로 FLAC 소프트웨어를 읽고 쓰는 소프트웨어를 만드는 데 사용할 수 있음)에 관한 문서는 이전 릴리스에 포함되어 있었지만 이제 https://datatracker.ietf.org/doc/draft-ietf에서 찾을 수 있습니다. -cellar-flac/ 또한 FLAC 디코더 테스트벤치라고 하는 적합성 테스트용 파일 세트는 https://github.com/ietf-wg-cellar/flac-test-files에서 찾을 수 있습니다.

FLAC에 대해 이 문서에서 답변할 수 없는 질문이 있는 경우 이 문서를 개선할 수 있도록 다음 추적기에 제출하시기 바랍니다.

https://github.com/xiph/flac/issues

FLAC 구축

FLAC 프로젝트의 모든 구성 요소는 다양한 운영 체제를 위한 다양한 아키텍처(x86, x86_64, ARMv7, ARMv8 및 PowerPC 포함)에서 다양한 컴파일러(GCC, Clang, Visual Studio, Intel C++ 컴파일러 포함)를 사용하여 빌드할 수 있습니다.

이를 위해 FLAC는 두 가지 빌드 시스템을 제공합니다. 하나는 GNU의 자동 도구를 사용하고 다른 하나는 CMake를 사용합니다. 둘 다 구성 옵션이 약간 다르지만 대부분의 사용 사례에서는 동일한 것으로 간주되어야 합니다.

FLAC는 Visual Studio를 사용하여 빌드하기 위해 특별히 파일을 제공하는 데 사용되었지만 CMake를 사용하기 위해 이러한 파일은 제거되었습니다.

CMake로 빌드하기

CMake는 크로스 플랫폼 빌드 시스템입니다. FLAC은 CMake를 사용하여 Windows, Linux, Mac OS X에서 구축할 수 있습니다.

CMake의 CLI 또는 GUI를 사용할 수 있습니다. 생성된 파일로 인해 저장소가 손상되지 않도록 저장소 외부에 별도의 빌드 폴더를 갖는 것이 좋습니다. 그러나 소위 트리 내 빌드를 수행하는 것이 가능합니다. 이 경우 다음 예제의 /path/to/flac-build는 /path/to/flac-source와 같습니다.

CMake CLI

빌드 폴더로 이동하여 다음과 같이 실행하십시오.

 /path/to/flac-build$ cmake /path/to/flac-source

또는 예를 들어 Windows 셸에서

 C:pathtoflac-build> cmake pathtoflac-source

(cmake가 %PATH% 변수에 있는 경우)

그러면 기본 빌드 시스템(예: UNIX용 Makefile)에 대한 빌드 스크립트가 생성됩니다. 그런 다음 다음과 같은 명령으로 빌드를 시작합니다.

 /path/to/flac-build$ make

그런 다음 테스트를 실행하거나 빌드된 라이브러리 및 헤더를 설치할 수 있습니다.

 /path/to/flac-build$ make test
/path/to/flac-build$ make install

기본 이외의 빌드 시스템을 사용하려면 cmake에 -G 플래그를 추가하세요. 예:

 /path/to/flac-build$ cmake /path/to/flac-source -GNinja
/path/to/flac-build$ ninja

또는:

 /path/to/flac-build$ cmake /path/to/flac-source -GXcode

사용 가능한 생성기 목록을 보려면 cmake --help를 사용하세요.

기본적으로 CMake는 OGG를 검색합니다. CMake가 이를 찾지 못하면 정확한 경로를 지정하여 CMake를 도울 수 있습니다.

 /path/to/flac-build$ cmake /path/to/flac-source -DOGG_ROOT=/path/to/ogg

CMake가 FLAC와 함께 OGG를 빌드하도록 하려면 ogg 소스를 flac 소스 디렉터리에 ogg라는 이름의 하위 디렉터리로 직접 배치할 수 있습니다. 예를 들면 다음과 같습니다.

 /path/to/flac-source/ogg

OGG 지원으로 flac을 구축하고 싶지 않은 경우 CMake에 OGG를 찾지 않도록 지시할 수 있습니다.

 /path/to/flac-build$ cmake /path/to/flac-source -DWITH_OGG=OFF

다른 FLAC 옵션(예: C++ lib 또는 문서 작성)도 -D 플래그를 통해 cmake에 넣을 수 있습니다. 어떤 옵션을 사용할 수 있는지 알고 싶다면 -LH를 사용하세요.

 /path/to/flac-build$ cmake /path/to/flac-source -LH

CMake GUI(Visual Studio용)

Visual Studio를 사용하여 FLAC를 빌드하는 경우 CMake GUI를 사용하는 것을 선호할 가능성이 높습니다. 이는 본질적으로 CLI를 사용하여 구축하는 것과 동일한 프로세스입니다.

cmake-gui를 엽니다. 창에서 소스 디렉터리(저장소의 루트), 빌드 디렉터리(저장소 외부의 다른 디렉터리)를 선택합니다. 그런 다음 "구성" 버튼을 누르세요. CMake는 어떤 빌드 시스템을 선호하는지 묻습니다. 시스템에 있는 Visual Studio 버전을 선택하고 Win32 또는 x64용으로 빌드할지 여부를 선택하세요. 확인을 누르세요.

CMake가 완료된 후 구성을 원하는 대로 변경할 수 있으며, 변경한 내용이 있으면 구성을 다시 실행하세요. CMake는 "생성" 버튼을 사용하여 Visual Studio에서 열 수 있는 Visual Studio 파일을 생성합니다. "프로젝트 열기" 버튼을 사용하면 CMake가 Visual Studio를 시작하고 생성된 솔루션을 엽니다. 평소와 같이 프로젝트 파일을 사용할 수 있지만 CMake에서 생성되었다는 점을 기억하세요. 즉, 다음에 CMake를 실행할 때 변경 사항(예: 일부 추가 컴파일 플래그)이 손실된다는 의미입니다.

CMake는 기본적으로 시스템에서 OGG를 검색하고 찾을 수 없으면 오류를 반환합니다. FLAC와 함께 OGG를 빌드하려면 CMake를 실행하기 전에 OGG 소스를 다운로드하고 ogg라는 이름으로 FLAC 소스 디렉터리의 하위 디렉터리(예: /path/to/flac-source/ogg)에 추출할 수 있습니다. OGG 지원으로 FLAC를 빌드하지 않으려면 cmake-gui 창의 변수 목록에서 WITH_OGG 플래그 다음 상자를 선택 취소하고 "구성"을 다시 실행하세요.

CMake가 MSVC 컴파일러를 찾지 못한 경우 MS 개발자 명령 프롬프트에서 cmake-gui를 실행하면 도움이 될 것입니다.

GNU autotools로 빌드하기

FLAC는 구성 및 구축을 위해 autoconf 및 libtool을 사용합니다. 빌드를 구성하려면 명령줄/터미널을 열고 ./configure 를 실행합니다. ./configure --help 실행하여 나열되는 이 명령에 옵션을 제공할 수 있습니다.

구성 스크립트가 없는 경우(예: 릴리스 tarball이 아닌 git에서 빌드하는 경우) ./autogen.sh 실행하여 생성할 수 있습니다. 하지만 libtool 개발 패키지가 필요할 수도 있습니다.

구성 후 make 로 빌드하고 make check 로 빌드를 확인한 후 make install 로 설치합니다. 설치하려면 관리자 권한(예: sudo make install 이 필요할 수 있습니다.

'확인하기' 단계는 선택사항입니다. 모든 테스트를 건너뛰려면 이를 생략하세요. 완료하는 데 약 1시간이 걸릴 수 있습니다. 오류가 발생하면 명시적인 메시지와 함께 중지되지만 많은 내용을 인쇄하므로 문제가 있는 경우 출력을 파일로 캡처할 수 있습니다. 또한 일부 테스트를 혼란스럽게 하기 때문에 루트로 'make check'를 실행하지 마십시오.

요약:

 ./configure
make && make check
sudo make install

임베디드 개발자를 위한 참고 사항

libFLAC는 시간이 지남에 따라 더 많은 기능이 포함되면서 더 커졌지만 특정 임베디드 구현에는 그 중 대부분이 불필요할 수 있습니다. 사용하지 않는 부분은configure.ac 및 src/libFLAC/Makefile.am을 간단히 편집하여 정리할 수 있습니다. 다음 종속성 그래프는 상황을 더 자세히 분석하지 않고 정리할 수 있는 모듈을 보여줍니다.

 metadata.h
    stream_decoder.h
    format.h

stream_encoder.h
    stream_decoder.h
    format.h

stream_decoder.h
    format.h

즉, 순수 디코딩 애플리케이션의 경우 스트림 인코더와 메타데이터 편집 인터페이스를 모두 안전하게 제거할 수 있습니다. 이는 임베디드 사용을 위한 라이브러리 구축에만 해당됩니다. 명령줄 도구는 이러한 구획화를 제공하지 않으며 작동하려면 완전한 libFLAC 빌드가 필요합니다.

libFLAC API HTML 문서에는 임베디드 사용 전용 섹션이 있습니다(doc/html/api/index.html 참조).

또한 libFLAC 코드에는 "OPT:"로 표시된 주석이 있는 여러 위치가 있습니다. 여기서 #define을 변경하여 특정 플랫폼에서 더 빠를 수 있는 코드를 활성화할 수 있습니다. 이를 실험하면 더 빠른 바이너리를 얻을 수 있습니다.