Client/DIRECTX_SDK_DOWNLOAD_GUIDE.md

DirectX SDK 다운로드 및 설치 가이드

📦 필요한 SDK 목록

이 프로젝트는 다음 DirectX SDK가 필요합니다:

• DirectX 9 SDK (dx9 브랜치용)
• DirectX 12 (dx12 브랜치용 - Windows SDK에 포함)

---

1. DirectX 9 SDK (dx9 브랜치)

📥 다운로드

공식 Microsoft 다운로드

DirectX SDK (June 2010) - 마지막 독립 실행형 DirectX SDK

다운로드 링크:

• 🔗 공식: https://www.microsoft.com/en-us/download/details.aspx?id=6812
• 📦 파일명: DXSDK_Jun10.exe
• 💾 크기: 약 572 MB

대체 다운로드 소스

만약 위 링크가 작동하지 않는 경우:

1. Internet Archive (Wayback Machine)

   • https://archive.org/search.php?query=DirectX%20SDK%20June%202010

2. Softpedia

   • https://www.softpedia.com/get/Programming/SDK-DDK/Microsoft-DirectX-SDK.shtml

3. 국내 미러 사이트 (비공식)

   • 주의: 공식 소스 사용 권장

🔧 설치 방법

1. 설치 파일 실행

   DXSDK_Jun10.exe
   

2. 기본 설치 경로

   C:\Program Files (x86)\Microsoft DirectX SDK (June 2010)\
   

3. 설치 후 디렉토리 구조

   Microsoft DirectX SDK (June 2010)/
   ├── Include/          ← 헤더 파일 (d3d9.h, d3dx9.h 등)
   ├── Lib/
   │   ├── x86/         ← 32비트 라이브러리
   │   └── x64/         ← 64비트 라이브러리
   ├── Utilities/
   └── Documentation/
   

⚠️ 알려진 설치 문제

Error S1023 해결방법

DirectX SDK June 2010 설치 시 S1023 에러가 발생하는 경우:

원인: Visual C++ 2010 재배포 패키지 충돌

해결 방법:

1. 제어판 → 프로그램 제거
2. 다음 항목 제거:
   • Microsoft Visual C++ 2010 x86 Redistributable
   • Microsoft Visual C++ 2010 x64 Redistributable
3. DirectX SDK 재설치
4. Visual C++ 2010 재설치 (필요시)

PowerShell로 자동 해결 (관리자 권한):

# VC++ 2010 제거
wmic product where "name like 'Microsoft Visual C++ 2010%'" call uninstall

# DirectX SDK 설치
Start-Process "DXSDK_Jun10.exe" -Wait

# VC++ 2010 재설치
# https://www.microsoft.com/en-us/download/details.aspx?id=26999

🛠️ Visual Studio 프로젝트 설정

방법 1: 환경 변수 설정 (권장)

시스템 환경 변수 추가:

DXSDK_DIR = C:\Program Files (x86)\Microsoft DirectX SDK (June 2010)\

프로젝트 설정:

<!-- vcxproj 파일 -->
<AdditionalIncludeDirectories>$(DXSDK_DIR)Include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
<AdditionalLibraryDirectories>$(DXSDK_DIR)Lib\x86;%(AdditionalLibraryDirectories)</AdditionalLibraryDirectories>

방법 2: 직접 경로 지정

Visual Studio에서:

1. 프로젝트 속성 → C/C++ → 일반 → 추가 포함 디렉터리

   C:\Program Files (x86)\Microsoft DirectX SDK (June 2010)\Include
   

2. 링커 → 일반 → 추가 라이브러리 디렉터리

   C:\Program Files (x86)\Microsoft DirectX SDK (June 2010)\Lib\x86
   

3. 링커 → 입력 → 추가 종속성

   d3d9.lib
   d3dx9.lib
   dxerr.lib
   dxguid.lib
   

📚 포함된 주요 파일

헤더 파일:

• d3d9.h - Direct3D 9 코어
• d3dx9.h - D3DX 유틸리티 함수
• d3dx9math.h - 수학 함수
• d3dx9tex.h - 텍스처 함수
• d3dx9core.h - 코어 유틸리티

라이브러리:

• d3d9.lib - Direct3D 9 런타임
• d3dx9.lib - D3DX 유틸리티 (Release)
• d3dx9d.lib - D3DX 유틸리티 (Debug)
• dxerr.lib - 에러 메시지 헬퍼
• dxguid.lib - GUID 정의

DLL (재배포 필요):

• d3d9.dll - 시스템에 기본 포함
• d3dx9_43.dll - 별도 배포 필요 (June 2010 버전)

---

2. DirectX 12 (dx12 브랜치)

📥 다운로드

DirectX 12는 Windows 10 SDK에 포함되어 있습니다. 별도 SDK 불필요!

Windows 10/11 SDK 다운로드

최신 버전:

• 🔗 공식: https://developer.microsoft.com/en-us/windows/downloads/windows-sdk/
• 📦 온라인 설치: winsdksetup.exe
• 📦 오프라인 ISO: 사용 가능 (약 1-2 GB)

권장 버전:

• 최소: Windows 10 SDK (10.0.17763.0) - Version 1809
• 권장: Windows 11 SDK (10.0.22621.0) - 최신
• DX12 Ultimate: Windows 10 SDK (10.0.19041.0) - Version 2004+

특정 버전 다운로드

SDK Archive:

• https://developer.microsoft.com/en-us/windows/downloads/sdk-archive/

다운로드 예시:

Windows 10 SDK (10.0.19041.0)  ← 2020년 5월, DX12 Ultimate 지원
Windows 10 SDK (10.0.22000.0)  ← Windows 11 SDK
Windows 11 SDK (10.0.22621.0)  ← 최신

🔧 설치 방법

1. 설치 파일 실행

   winsdksetup.exe
   

2. 설치 옵션 선택

   필수 구성 요소만 선택하여 설치 시간 단축:

   ✅ Windows SDK Signing Tools for Desktop Apps
   ✅ Windows SDK for UWP C++ Apps
   ✅ Windows SDK for Desktop C++ x86 Apps
   ✅ Windows SDK for Desktop C++ x64 Apps
   ✅ Debugging Tools for Windows
   ❌ .NET Framework (불필요)
   ❌ Windows Performance Toolkit (선택)
   ❌ MSI Tools (불필요)
   

3. 기본 설치 경로

   C:\Program Files (x86)\Windows Kits\10\
   

4. 설치 후 디렉토리 구조

   Windows Kits\10\
   ├── Include\
   │   └── 10.0.xxxxx.0\
   │       ├── um\           ← d3d12.h, dxgi1_6.h
   │       └── shared\       ← 공유 헤더
   ├── Lib\
   │   └── 10.0.xxxxx.0\
   │       ├── um\x86\       ← 32비트 라이브러리
   │       └── um\x64\       ← 64비트 라이브러리
   └── Redist\
       └── D3D\              ← 재배포 DLL
   

🛠️ Visual Studio 프로젝트 설정

Windows SDK는 Visual Studio 2019/2022에 자동 통합됩니다!

프로젝트 설정 확인:

1. 프로젝트 속성 → 일반

   Windows SDK 버전: 10.0 (최신 설치된 버전)
   

2. 플랫폼 도구 집합

   Visual Studio 2019 (v142)  또는
   Visual Studio 2022 (v143)
   

수동 설정 (필요시)

vcxproj 파일:

<PropertyGroup>
  <WindowsTargetPlatformVersion>10.0.19041.0</WindowsTargetPlatformVersion>
</PropertyGroup>

<ItemDefinitionGroup>
  <Link>
    <AdditionalDependencies>
      d3d12.lib;
      dxgi.lib;
      dxguid.lib;
      d3dcompiler.lib;
      %(AdditionalDependencies)
    </AdditionalDependencies>
  </Link>
</ItemDefinitionGroup>

📚 포함된 주요 파일

헤더 파일:

• d3d12.h - Direct3D 12 코어
• dxgi1_6.h - DXGI 1.6 (스왑체인, 어댑터)
• d3d12sdklayers.h - 디버그 레이어
• d3dcompiler.h - 셰이더 컴파일러
• DirectXMath.h - 수학 라이브러리

라이브러리:

• d3d12.lib - Direct3D 12 런타임
• dxgi.lib - DXGI
• d3dcompiler.lib - 셰이더 컴파일러
• dxguid.lib - GUID 정의

DLL (시스템 포함):

• d3d12.dll - Windows 10에 기본 포함
• dxgi.dll - Windows 10에 기본 포함

🔨 추가 도구

d3dx12.h (헬퍼 헤더)

DX12는 d3dx12.h를 별도 제공하지 않습니다. Microsoft 샘플에서 가져와야 합니다.

다운로드:

https://github.com/microsoft/DirectX-Graphics-Samples/blob/master/Libraries/D3DX12/d3dx12.h

또는 프로젝트에 직접 추가:

// d3dx12.h - Helper structures and functions
// 프로젝트 Include 폴더에 복사

사용 예시:

#include <d3d12.h>
#include "d3dx12.h"  // 헬퍼 함수

CD3DX12_HEAP_PROPERTIES heapProps(D3D12_HEAP_TYPE_DEFAULT);
CD3DX12_RESOURCE_DESC texDesc = CD3DX12_RESOURCE_DESC::Tex2D(...);

DirectX Shader Compiler (DXC)

HLSL 6.0+ 셰이더 컴파일용 (선택사항, 고급 기능)

다운로드:

• 🔗 https://github.com/microsoft/DirectXShaderCompiler/releases
• 📦 dxc_<version>.zip

포함 파일:

• dxc.exe - 커맨드라인 컴파일러
• dxcompiler.dll - 런타임 컴파일러
• dxil.dll - DXIL 서명

---

3. 개발 도구

PIX for Windows (GPU 디버거)

다운로드:

• 🔗 https://devblogs.microsoft.com/pix/download/
• 📦 Windows Store에서도 다운로드 가능

기능:

• GPU 타이밍 분석
• 프레임 캡처
• 셰이더 디버깅
• 리소스 상태 추적

RenderDoc (대체 디버거)

다운로드:

• 🔗 https://renderdoc.org/builds
• 📦 크로스 플랫폼 (Windows, Linux)

기능:

• 프레임 캡처
• 텍스처 뷰어
• 파이프라인 상태 검사
• 무료 오픈소스

Visual Studio Graphics Debugger

설치:

• Visual Studio 설치 시 "게임 개발 (C++)" 워크로드 선택
• 자동으로 포함됨

사용법:

• 디버그 → 그래픽 → 진단 시작
• 프레임 캡처 (Print Screen)

---

4. 재배포 패키지

DirectX 9 재배포

최종 사용자를 위해 게임과 함께 배포해야 하는 파일:

DirectX End-User Runtime:

• 🔗 https://www.microsoft.com/en-us/download/details.aspx?id=35
• 📦 directx_Jun2010_redist.exe

포함 내용:

• d3dx9_43.dll
• D3DCompiler_43.dll
• XAudio2_7.dll
• 기타 D3DX 컴포넌트

설치 방법:

REM 게임 설치 스크립트
directx_redist\DXSETUP.exe /silent

DirectX 12 재배포

DirectX 12는 Windows 10에 기본 포함되므로 별도 재배포 불필요!

최소 OS 요구사항:

• Windows 10 (1809 이상) 또는
• Windows 11

확인 방법:

// 런타임에 DX12 지원 확인
if (FAILED(D3D12CreateDevice(nullptr, D3D_FEATURE_LEVEL_11_0, 
    __uuidof(ID3D12Device), nullptr)))
{
    MessageBox(NULL, L"DirectX 12를 지원하지 않는 시스템입니다.", 
        L"에러", MB_OK);
    return false;
}

---

5. 빠른 설정 체크리스트

✅ DX9 브랜치 (dx9)

• DirectX SDK June 2010 다운로드
• SDK 설치 (S1023 에러 해결)
• 환경 변수 DXSDK_DIR 설정
• Visual Studio 재시작
• 프로젝트 Include/Lib 경로 확인
• 빌드 테스트
• d3dx9_43.dll 실행 경로에 복사

✅ DX12 브랜치 (dx12)

• Windows 10 SDK 다운로드 (최신)
• SDK 설치 (C++/Desktop 옵션)
• Visual Studio 재시작
• Windows SDK 버전 확인
• d3dx12.h 다운로드 및 추가
• 빌드 테스트
• PIX for Windows 설치 (디버깅용)

---

6. 자주 묻는 질문 (FAQ)

Q1: DirectX SDK를 어디에 설치해야 하나요?

A: 기본 경로 사용 권장:

C:\Program Files (x86)\Microsoft DirectX SDK (June 2010)\
C:\Program Files (x86)\Windows Kits\10\

Q2: 여러 버전의 SDK를 동시에 설치할 수 있나요?

A: 가능합니다! DX9 SDK와 Windows SDK (DX12)는 충돌하지 않습니다.

Q3: Visual Studio 2022에서 DX9 SDK를 사용할 수 있나요?

A: 가능합니다. 단, 경로 충돌 방지를 위해:

Include 경로 순서:
1. $(DXSDK_DIR)Include
2. $(WindowsSDK_IncludePath)

Q4: 64비트 빌드 시 라이브러리 경로는?

DX9:

$(DXSDK_DIR)Lib\x64

DX12:

C:\Program Files (x86)\Windows Kits\10\Lib\10.0.xxxxx.0\um\x64\

Q5: d3dx9_43.dll이 없다는 오류가 발생합니다.

A: DirectX 재배포 패키지 설치 또는 DLL을 실행 파일과 같은 폴더에 복사:

Game.exe
d3dx9_43.dll
D3DCompiler_43.dll

Q6: Windows 7에서 DX12를 사용할 수 있나요?

A: 불가능합니다. DX12는 Windows 10 이상 전용입니다.

Q7: 오프라인 환경에서 설치하려면?

DX9: 전체 SDK 설치 파일 (572 MB) 다운로드 DX12: Windows SDK ISO 이미지 다운로드

---

7. 추가 리소스

공식 문서

DirectX 9:

• 📖 https://docs.microsoft.com/en-us/windows/win32/direct3d9/dx9-graphics
• 📖 MSDN DirectX 9 Reference (SDK 내 포함)

DirectX 12:

• 📖 https://docs.microsoft.com/en-us/windows/win32/direct3d12/directx-12-programming-guide
• 📖 https://github.com/microsoft/DirectX-Graphics-Samples

튜토리얼

DX9:

• http://www.directxtutorial.com/
• http://rastertek.com/tutdx9.html

DX12:

• https://www.3dgep.com/learning-directx-12-1/
• https://alain.xyz/blog/raw-directx12

커뮤니티

• GameDev.net: https://www.gamedev.net/forums/
• Discord: DirectX Community Server
• Stack Overflow: [directx] 태그

---

8. 문제 해결

빌드 오류: "d3d9.h를 찾을 수 없습니다"

해결:

1. SDK 설치 확인
2. Include 경로 확인
3. 프로젝트 다시 로드

링크 오류: "d3d9.lib를 열 수 없습니다"

해결:

1. Lib 경로 확인 (x86 vs x64)
2. 플랫폼 일치 확인
3. 환경 변수 재설정

런타임 오류: "DLL을 로드할 수 없습니다"

해결:

1. 재배포 패키지 설치
2. DLL을 실행 폴더에 복사
3. System32 확인 (비권장)

Windows SDK 설치 실패

해결:

1. 관리자 권한으로 실행
2. 기존 버전 제거 후 재설치
3. .NET Framework 업데이트
4. 디스크 공간 확인 (10GB 이상)

---

📞 도움이 필요하신가요?

이 가이드로 해결되지 않는 문제가 있다면:

1. GitHub Issues 생성
2. 프로젝트 문서 참조:
   • DX8_TO_DX9_MIGRATION_PLAN.md
   • DX9_TO_DX12_MIGRATION_PLAN.md
3. Microsoft Q&A 포럼 방문

---

작성일: 2025-12-01 작성자: Claude AI (Anthropic) 버전: 1.0 최종 업데이트: 2025-12-01

---

📋 요약

SDK	다운로드 링크	크기	플랫폼	비고
DX9 SDK	June 2010	572 MB	Win XP+	독립 설치
DX12 (Windows SDK)	최신 SDK	1-2 GB	Win 10+	VS 통합
DX9 재배포	End-User Runtime	95 MB	All	배포 필수

핵심 포인트:

• ✅ DX9: 별도 SDK 설치 필요
• ✅ DX12: Windows SDK에 포함 (VS와 자동 통합)
• ✅ 둘 다 동시 설치 가능
• ✅ DX9는 재배포 패키지 필요, DX12는 불필요

이제 개발 준비 완료! 🚀