Gu's Blog

<변경 내역>
1. 2005/09/10 오전 12:03 문서 작성
2. 2006/08/23 오후 5:00 bcb용 dll 설치 추가, delphi 소스 포함된 프로젝트를 위한 환경 설정 추가.
- - - - - - - - - - -
M$의 VC++를 사용하는 개발자들은 DirectX SDK를 M$사이트에서 다운 받아서 그냥 사용을 하면 되지만... 빌더(파워빌더 아님..)나 델파이에서는 바로 사용을 못하고 이것 저것 손을 봐야 한다. 빌더나 델파이로 계속 다이렉트엑스 개발을 한 사람은 이런 환경 설정하는 작업이 별로 어렵지 않겠지만 간혹 사용하는 사람들한테는 그리 간단한 일이 아니다.

델파이는 directX 헤더를 파스칼로 변환한 유닛과 관련된 DLL만으로 환경을 구성하면 되는데 빌더는 directX SDK의 헤더, 파스칼로 변환된 유닛, 유닛에서 생성된 hpp 등을 모두 사용해야 됨으로 환경 설정하다가 문제가 생겨도 뭐가 문제인지 모르는 경우가 많은 것 같다.

DirectShow기능을 손쉽게 사용할 수 있게 해주는 DSPack 컴포넌트는 여러가지 좋은 셈픔을 제공해주며, 프리(free)이다. 이 문서에서는 DSPack 컴포넌트를 설치하고 샘플을 컴파일 하는 과정을 정리하고자 한다.

[여기 부터 설치 과정 시작~~~]

(1). 설치에 필요한 프로그램을 다운 받는다.
1. DirectX 9.0 SDK Update - (February 2005) 을 다운 받는다. 여기에는 DirectShow가 포함이 안되어 있음으로 DirectX 9.0 SDK Update (February 2005) Extras를 다운받아 설치해야 한다.

2. DSPACK234.zip를 다운 받는다.

3. 빌더에서는 VC와 다른 형태의 lib와 dll을 사용함으로 변환된 것을 다운 받거나 직접 변환해야 한다. CBuilder_DX92_libs.zip를 다운 받는게 편하다.

(2). 프로그램 설치
1. DirectX를 설치한다. 다운 받은 dxsdk_feb2005.exe을 실행해서 압축을 푼다. 압축을 푼 디렉토리에 있는 Setup.exe를 실행해 설치한다.

2. DirectShow 사용을 위해서 dxsdk_feb2005_extras.exe 를 실행해서 압축을 풀고 ${DXSDK_Extra}\Extras 디렉토리를 ${DXSDK}\에 복사를 한다.

3. DSPACK234.zip 파일의 압축을 푼다.

4. DSPACK가 설치된 디렉토리는 이 문서에서는 ${DSPACK}로 표시한다.
DirectX가 설치된 디렉토리는 ${DXSDK}로 표시한다.

5. bcb용 DirectX DLL을 System32 디렉토리에 복사한다.

(4). 컴포넌트 설치
1. Library에 ${DSPACK}\src\DSPack와 ${DSPACK}\src\DirectX9를 추가한다.
Tools -> Environment Optoins -> Library 탭의 Library Path에 추가하면 된다.

2. DirectX9_BCB6.bpk 를 컴파일 한다.

3. DSPack_BCB6.bpk를 컴파일 한다.
컴파일 하기 전에 DsUtil.pas의 Unit과 Interface 사이에 {$HPPEMIT '#include "DxDiag.h"'} 추가를 해야 한다. 만약 추가를 하지 않으면 나중에 DsUtil.hpp에 #include "DxDiag.h"를 추가해야 한다.

4. DSPackDesign_BCB6.bpk를 인스톨한다.

5. ${DSPACK}\src\DirectX9와 ${DSPACK}\src\DSPack에 bcb라는 디렉토리를 만들고 DirectX9와 DSPack의 *.hpp, *.inc를 복사한다. <(4).6 관련>
위 처럼 하는 이유는 DSPack을 사용하는 Delphi 소스를 BCB 프로젝트에 포함시켜서 컴파일 하는 경우 Library Path에 DSPack과 DricetX의 dcu를 필요로 한다. 이때, ${DSPACK}\src\DSPack와 ${DSPACK}\src\DirectX9를 추가하면 컴파일 할 때마다 매번 pas를 컴파일하게 되서 컴파일 시간이 오래 걸리고 에러 나는 DSUtil.hpp를 수정을 해서 사용하게 되는데 컴파일 할 때마다 DSUtils.hpp가 수정 전으로 돌아가게 됨으로 따로 복사를 하는 것이다.

6. 모든 열려있는 프로젝트를 닫고 프로젝트 디폴트 옵션을 변경한다.
ㄱ. Project -> Options -> Directories/Conditionals -> Include Path에 다음 처럼 추가를 하며 인클루드 패스 순서는 아래와 같아야 하며 기본 인클루드 경로 보다 위에 있어야 한다.

${DSPACK}\include
${DSPACK}\src\DSPack\BCB
${DSPACK}\src\DirectX9\BCB
${DXSDK}\Include
${DXSDK}\Extras\DirectShow\Include

ㄴ. Library Path에 아래 경로를 기본 라이브러리 패스보다 상위에 있도록 추가한다.

${DSPACK}\lib
${DSPACK}\src\DSPack
${DSPACK}\src\DirectX9

ㄷ. (옵션) runtime package를 rtl, vlc만 놔두고 모두 지워버리고 런타임 패키지를 사용하지 않도록 체크를 해제한다. <(5).4 관련>

(5). 컴포넌트 테스트
1. DSPack 컴포넌트 탭에서 FilterGraph, Filter, VideoWindow 를 선택해서 폼에 놓는다.

2. 각 컴포넌트의 프로퍼티를 연결시켜주고 컴파일을 하면 다음처럼 에러가 난다.
[C++ Error] DSUtil.hpp(498): E2040 Declaration terminated incorrectly
[C++ Error] DSUtil.hpp(499): E2293 ) expected
[C++ Error] DSUtil.hpp(506): E2040 Declaration terminated incorrectly
[C++ Error] DSUtil.hpp(558): E2189 extern variable cannot be initialized
[C++ Error] DSUtil.hpp(558): E2108 Improper use of typedef 'LONG'
[C++ Error] DSUtil.hpp(558): E2188 Expression syntax
[C++ Error] DSUtil.hpp(558): E2293 ) expected
[C++ Error] DSUtil.hpp(560): E2189 extern variable cannot be initialized
[C++ Error] DSUtil.hpp(560): E2238 Multiple declaration for 'ULONGLONG'
[C++ Error] DSUtil.hpp(454): E2344 Earlier declaration of 'ULONGLONG'
[C++ Error] DSUtil.hpp(560): E2356 Type mismatch in redeclaration of 'ULONGLONG'
[C++ Error] DSUtil.hpp(454): E2344 Earlier declaration of 'ULONGLONG'
[C++ Error] DSUtil.hpp(560): E2188 Expression syntax
[C++ Error] DSUtil.hpp(560): E2293 ) expected

3. 에러나는 부분을 주석 처리한다. 아래에 나온 항목이 아닌데 에러나는 경우에도 주석 처리를 한다.
498행 : //static const Shortint DXDIAG_DX9_SDK_VERSION = 0x6f;
499행 : //static const HRESULT DXDIAG_E_INSUFFICIENT_BUFFER = 0x8007007a;
506행 : //static const __int64 NANOSECONDS = 0x3b9aca00;
558행 : //extern PACKAGE __int64 __fastcall Int32x32To64(int a, int b);
560행 : //extern PACKAGE __int64 __fastcall UInt32x32To64(unsigned a, unsigned b);
454행 : //typedef __int64 ULONGLONG;

4. 다시 빌드하고 실행한다.

5. 기타 에러 참고
ㄱ. 항목 (4). 설치에서 런타임 패키지 사용 안함으로 설정을 한 경우에는 함수를 찾을 수 없다고 링크에러가 발생한다. 그럴 경우에는 프로젝트에 ${DSPACK}\lib에 있는 d3d9.lib, quartz.lib, wmvcore.lib 를 추가하면 된다. 런타임 패키지 사용을 해제 하지 않은 경우에는 런타임 패키지 창에 DirectX9_BCB6;DSPack_BCB6를 추가한다.

ㄴ. TCustomOutline 관련한 링크 에러가 발생하는 경우에는 bpr파일을 문서 편집기로 열어서 bcbsmp.lib 항목을 삭제한 후에 다시 빌드 한다.

(6). 기타
처음에 DirectX를 August 2005 버전으로 받았는데 여기에는 DirectShow가 포함이 안되어 있어서 PlatformSDK Window 2003 SP1을 받아서 DirectShow, WIndows Core를 설치해서 사용을 하려고 했는데 문제점가 발생했다.

PlatformSDK에서 Windows Core를 설치하면 WIN32 API관련된 winnt.h, winuser.h 등의 기본 헤더 파일도 새로 설치되는데 DirectShow 사용을 위해 빌더 기본 include 경로보다 상위에 두면 새로 설치된 winnt.h, winuser.h 등의 헤더 파일 때문에 컴파일 에러가 발생한다. (M$에서 빌더도 생각을 하고 배포를 했으면 좋을텐데 그렇지 않으니....) 그렇다고 빌더 기본 경로보다 아래에 두면 갱신되어야 할 strmif.h, ksmedia.h 등이 빌더에 설치되어 있는 옛날 것을 인클루드해서 컴파일 하기 애문에 DirectShow 관련된 부분 컴파일에서 에러가 난다. 이렇게도 할 수 없고 저렇게도 할 수 없어서 DirectX SDK 다른 버전을 찾다가 DirectX Extra(February 2005)를 받아서 보니 DirectShow 관련된 헤더만 제공을 함으로 PlatformSDK에 있는 DirectShow를 설치할 때 갱신되지 않아도 될 헤더 파일까지 새로운 것을 사용해야 되는 문제를 피할 수 있다.

Delphi에는 다른건 신경 쓸 필요 없이 런타임 패키지 2개 컴파일 하고 디자인 패키지는 인스톨 하고 라이브러리 패스에 ${DSPACK}\src\DSPack, ${DSPACK}\src\directx 만 추가해주고 개발하면 된다.

[여기서 설치 과정 끝]

그저께는 두 시간 정도 헤매고 어제와 오늘은 새벽 4시까지 잠 못자고 설치하고 삭제하고 하는 작업을 반복했는데 막상 정리를 해보니 크게 복잡한 것은 없다.

빌더에서 DSPACK(DiretShow,DirectX)를 처음 사용하는 분들은 저처럼 해매지 않기 바랍니다.