|
1 | | -
|
2 | | -This is a small list of steps in order to build FFmpeg into a msvc DLL and lib file. |
3 | | -
|
4 | | -The projects contain Release and Debug builds for static lib files (Debug/Release) |
5 | | - as well as dynamic shared dll files (DebugDLL/ReleaseDLL). |
6 | | -Choose whichever project configuration meets your requirements. |
7 | | -
|
8 | | -Note: FFmpeg requires C99 support in order to compile. Only Visual Studio 2013 or newer supports required C99 functionality and so any |
9 | | -older version is not supported. Visual Studio 2013 or newer is required. If using an older unsupported version of Visual Studio the |
10 | | -Intel compiler can be used to add in the required C99 capability. |
11 | | -
|
12 | | -
|
13 | | -*** Using the Default Supplied Projects *** |
14 | | -
|
15 | | -The supplied project files are created using default configuration options as used by the ShiftMediaProject. |
16 | | -These projects use Visual Studio 2013/2015 and require certain additional dependencies to be built and available at compile time. |
17 | | -Required project dependencies include: |
18 | | - bzlib |
19 | | - iconv |
20 | | - zlib |
21 | | - lzma |
22 | | - libxml2 |
23 | | - sdl2 |
24 | | - libmp3lame |
25 | | - libvorbis |
26 | | - libspeex |
27 | | - libopus |
28 | | - libilbc |
29 | | - libtheora |
30 | | - libx264 |
31 | | - libx265 |
32 | | - libxvid |
33 | | - libvpx |
34 | | - libgme |
35 | | - libmodplug |
36 | | - libsoxr |
37 | | - libfreetype |
38 | | - fontconfig |
39 | | - libfribidi |
40 | | - libass |
41 | | - gnutls |
42 | | - libgcrypt |
43 | | - libssh |
44 | | - libcdio |
45 | | - libcdio_paranoia |
46 | | - libbluray |
47 | | - opengl |
48 | | - ffnvcodec |
49 | | - libmfx |
50 | | -
|
51 | | -Most of the above dependencies are supplied as part of the ShiftMediaProject repositories. |
52 | | -These repositories can be manually downloaded or automatically cloned using the supplied |
53 | | - project_get_dependencies.bat file. This file can also be used to check for and download |
54 | | - any dependency updates at any point after the first clone of the library. |
55 | | - |
56 | | -Some of these dependency projects have additional requirements to those listed here. See the corresponding readme for each of the projects for further details. |
57 | | -
|
58 | | -Many of the possible FFmpeg dependencies (and there dependencies) are available in the ShiftMediaProject repositories. |
59 | | -However the following is a list of extra dependency options that require external downloads: |
60 | | - 1) opengl (requires glext) |
61 | | - a) Download glext.h and wglext.h from opengl.org. |
62 | | - b) Save the header files into "OutputDir/include/gl/*". |
63 | | - c) Download khrplatform.h from khronos.org |
64 | | - d) Save the header file into "OutputDir/include/KHR/*". |
65 | | - 2) ffnvcodec (requires nv-codec-headers) |
66 | | - a) Download the nv-codec-headers repository from https://github.com/FFmpeg/nv-codec-headers |
67 | | - b) Save the contents of the nv-codec-headers repositories "include" folder into "OutputDir/include/*". |
68 | | - 3) AMF (requires Advanced Media Framework (AMF) SDK headers) |
69 | | - a) Download the AMF repository from https://github.com/GPUOpen-LibrariesAndSDKs/AMF |
70 | | - b) Save the contents of the AMF repositories "amf/public/include" into "OutputDir/include/AMF/*". |
71 | | - |
72 | | -*OutputDir is the "Output Directory" specified in the project properties. |
73 | | -The default value of OutputDir is "..\..\msvc" relative to the FFmpeg source directory. An example of the expected |
74 | | -directory structure is: |
75 | | - - msvc (OutputDir) |
76 | | - -> source |
77 | | - - FFmpeg |
78 | | - - ..Any other libraries source code.. |
79 | | - |
80 | | -Any dependencies supplied by ShiftMediaProject should be downloaded next to the FFmpeg folder as they will use the same OutputDir |
81 | | -location. Projects to build each dependency can be found in the respective repository ./SMP directories or all together using |
82 | | -the all inclusive ffmpeg_deps.sln. |
83 | | -
|
84 | | -Only dependencies built from supplied ShiftMediaProject repositories are tested and supported. Using compiled dependencies from |
85 | | -other sources may result in version mismatch or other issues. Although these external sources generally work fine any problems associated |
86 | | -with them are not covered by ShiftMediaProject and so they should be used with discretion. |
87 | | - |
88 | | -
|
89 | | -*** Building with ASM *** |
90 | | -
|
91 | | -In order to build FFmpeg using msvc you must first download and install NASM. |
92 | | -NASM is required to compile all assembly files. |
93 | | -
|
94 | | -1) Visual Studio NASM integration can be downloaded from https://github.com/ShiftMediaProject/VSNASM/releases/latest |
95 | | -
|
96 | | -2) Once downloaded simply follow the install instructions included in the download. |
| 1 | + |
| 2 | +This is a small list of steps in order to build FFmpeg into a msvc DLL and lib file. |
| 3 | + |
| 4 | +The projects contain Release and Debug builds for static lib files (Debug/Release) |
| 5 | + as well as dynamic shared dll files (DebugDLL/ReleaseDLL). |
| 6 | +Choose whichever project configuration meets your requirements. |
| 7 | + |
| 8 | +Note: FFmpeg requires C99 support in order to compile. Only Visual Studio 2013 or newer supports required C99 functionality and so any |
| 9 | +older version is not supported. Visual Studio 2013 or newer is required. If using an older unsupported version of Visual Studio the |
| 10 | +Intel compiler can be used to add in the required C99 capability. |
| 11 | + |
| 12 | + |
| 13 | +*** Using the Default Supplied Projects *** |
| 14 | + |
| 15 | +The supplied project files are created using default configuration options as used by the ShiftMediaProject. |
| 16 | +These projects use Visual Studio and require certain additional dependencies to be built and available at compile time. |
| 17 | +Required project dependencies include: |
| 18 | + bzlib |
| 19 | + iconv |
| 20 | + zlib |
| 21 | + lzma |
| 22 | + libxml2 |
| 23 | + sdl2 |
| 24 | + libmp3lame |
| 25 | + libvorbis |
| 26 | + libspeex |
| 27 | + libopus |
| 28 | + libilbc |
| 29 | + libtheora |
| 30 | + libx264 |
| 31 | + libx265 |
| 32 | + libxvid |
| 33 | + libvpx |
| 34 | + libgme |
| 35 | + libmodplug |
| 36 | + libsoxr |
| 37 | + libfreetype |
| 38 | + fontconfig |
| 39 | + libfribidi |
| 40 | + libass |
| 41 | + gnutls |
| 42 | + libgcrypt |
| 43 | + libssh |
| 44 | + libcdio |
| 45 | + libcdio_paranoia |
| 46 | + libbluray |
| 47 | + opengl |
| 48 | + ffnvcodec |
| 49 | + libmfx |
| 50 | + |
| 51 | +Most of the above dependencies are supplied as part of the ShiftMediaProject repositories. |
| 52 | +These repositories can be manually downloaded or automatically cloned using the supplied |
| 53 | + project_get_dependencies.bat file. This file can also be used to check for and download |
| 54 | + any dependency updates at any point after the first clone of the library. |
| 55 | + |
| 56 | +Some of these dependency projects have additional requirements to those listed here. See the corresponding readme for each of the projects for further details. |
| 57 | + |
| 58 | +Many of the possible FFmpeg dependencies (and there dependencies) are available in the ShiftMediaProject repositories. |
| 59 | +However the following is a list of extra dependency options that require external downloads: |
| 60 | + 1) opengl (requires glext) |
| 61 | + a) Download glext.h and wglext.h from opengl.org. |
| 62 | + b) Save the header files into "OutputDir/include/gl/*". |
| 63 | + c) Download khrplatform.h from khronos.org |
| 64 | + d) Save the header file into "OutputDir/include/KHR/*". |
| 65 | + 2) ffnvcodec (requires nv-codec-headers) |
| 66 | + a) Download the nv-codec-headers repository from https://github.com/FFmpeg/nv-codec-headers |
| 67 | + b) Save the contents of the nv-codec-headers repositories "include" folder into "OutputDir/include/*". |
| 68 | + 3) AMF (requires Advanced Media Framework (AMF) SDK headers) |
| 69 | + a) Download the AMF repository from https://github.com/GPUOpen-LibrariesAndSDKs/AMF |
| 70 | + b) Save the contents of the AMF repositories "amf/public/include" into "OutputDir/include/AMF/*". |
| 71 | + |
| 72 | +*OutputDir is the "Output Directory" specified in the project properties. |
| 73 | +The default value of OutputDir is "..\..\msvc" relative to the FFmpeg source directory. An example of the expected |
| 74 | +directory structure is: |
| 75 | + - msvc (OutputDir) |
| 76 | + -> source |
| 77 | + - FFmpeg |
| 78 | + - ..Any other libraries source code.. |
| 79 | + |
| 80 | +Any dependencies supplied by ShiftMediaProject should be downloaded next to the FFmpeg folder as they will use the same OutputDir |
| 81 | +location. Projects to build each dependency can be found in the respective repository ./SMP directories or all together using |
| 82 | +the all inclusive ffmpeg_deps.sln. |
| 83 | + |
| 84 | +Only dependencies built from supplied ShiftMediaProject repositories are tested and supported. Using compiled dependencies from |
| 85 | +other sources may result in version mismatch or other issues. Although these external sources generally work fine any problems associated |
| 86 | +with them are not covered by ShiftMediaProject and so they should be used with discretion. |
| 87 | + |
| 88 | + |
| 89 | +*** Building with ASM *** |
| 90 | + |
| 91 | +In order to build FFmpeg using msvc you must first download and install NASM. |
| 92 | +NASM is required to compile all assembly files. |
| 93 | + |
| 94 | +1) Visual Studio NASM integration can be downloaded from https://github.com/ShiftMediaProject/VSNASM/releases/latest |
| 95 | + |
| 96 | +2) Once downloaded simply follow the install instructions included in the download. |
0 commit comments