]> git.sesse.net Git - vlc/blobdiff - INSTALL-win32.txt
Fixed the color_space problem. Overlays now work.
[vlc] / INSTALL-win32.txt
index 698f64e1fb27b8388157287c512e157dee13f82a..3e2183ca40750f3f15dffc49f798a61cde0c989c 100644 (file)
@@ -17,7 +17,7 @@ To store a debug log of the current vlc session, you can use
 If you want to play a DVD, run vlc and click on the Disc option in the
 interface. You then have to type your drive letter in the 'Device name'
 box (eg. 'D:' if your dvdrom drive is assigned the letter 'D').
-(Warning: you have to be in administrator mode (for now) on Win2k)
+( !Warning: you have to be in administrator mode (for now) on Win2k )
 
 
 Building VideoLAN from source code
@@ -35,27 +35,48 @@ You can build the win32 vlc port in two ways:
 - natively on Windows
 - or on Linux, using cross-compiling
 
-All these tools can be found on the libSDL web page:
+All the necessary tools can be found on the libSDL web page:
 http://www.libsdl.org/Xmingw32/
 
-Configuring VideoLAN
-====================
+- cross-compiling with mingw32:
+You need to download the linux cross-compiler version of mingw32.
+(for Debian GNU/Linux users, there is a mingw32 package)
+You must also not forget to install some extra header files and libraries if
+you want to build some plugins like DirectX, GTK or SDL.
 
-A typical way to configure vlc is:
+- compiling natively on Windoze:
+[coming soon (investigating a combination of cygwin+mingw32)]
 
-   ./configure --disable-x11 --disable-xvideo --disable-dsp --without-sdl \
-      --with-directx=/usr/local/cross-compile/i386-mingw32msvc
+Configuring the build
+=====================
+
+A typical way to configure the build process of vlc is to use the
+`./configure' script.
 
 See `./configure --help' for more information.
 
-To cross-compile for the Win32 platform using mingw32:
+For example if you are cross-compiling from Debian, you can use something
+along those lines:
+
+ make distclean ; CC=i586-mingw32msvc-gcc \
+   ./configure --host=i586-mingw32msvc --target=i586-mingw32msvc \
+    --build=i386-linux --with-gtk-config-path=/usr/i586-mingw32msvc/bin \
+    --with-sdl-config-path=/usr/i586-mingw32msvc/bin
+
+./configure uses the 'gtk-config' and 'sdl-config' scripts and unfortunately,
+when cross-compiling you have to tell ./configure where to find them.
+You have two choices for this, you can either add the path to these files at
+the beginning of your PATH variable. Or you can use the
+'--with-gtk/sdl-config-path' option.
+(by the way, you may have to create a gtk-config script yourself or modify
+the one from your linux distro)
 
-   make distclean ; CC=i586-mingw32msvc-gcc CFLAGS=-I/usr/i586-mingw32msvc \
-     RANLIB=i586-mingw32msvc-ranlib WINDRES=i586-mingw32msvc-windres \
-     ./configure --host=i386-mingw32msvc \
-     --target=i386-mingw32msvc --build=i386-linux --disable-dsp \
-     --disable-x11 --disable-xvideo
+If you are cross-compiling using the package provided by
+http://www.libsdl.org/Xmingw32/, you can use something along those lines:
 
+ make distclean ; PATH=/usr/local/cross-tools/bin:/usr/local/cross-tools/i386-mingw32msvc/bin:$PATH \
+   ./configure --host=i386-mingw32msvc \
+   --target=i386-mingw32msvc --build=i386-linux
 
 Building VideoLAN
 =================
@@ -66,10 +87,36 @@ the core application. The configure script tries to guess for you.
 
 Once configured, run `make' to build vlc.
 
+If you are using the tools from http://www.libsdl.org/Xmingw32/ you can type something like:
+
+ PATH=/usr/local/cross-tools/bin:/usr/local/cross-tools/i386-mingw32msvc/bin:$PATH \
+   make
+
+Building Win32 interface with bcc32 (Borland's compiler)
+========================================================
+
+[Steps 2 and 3 are temporary]
 
+1) Compile vlc as usual.
+include\defs.h should be generated.
 
+2) Edit include\defs.h, and add the following lines if necessary:
+#define WIN32
+#define MODULE_NAME win32
+#define MODULE_NAME_IS win32
+#define PLUGIN
+#define HAVE_DYNAMIC_PLUGINS
 
+3) Still in defs.h, comment the following line to avoid compilation warnings:
+#define PACKAGE "vlc"
 
+4) From the plugin\win32 directory, use Borland C++ command-line tools
+as follows:
+bpr2mak intfwin.bpr    // Create a makefile from intfwin.bpr
+make -fintfwin                 // It's Borland's make utility !
 
+5) This should create a intfwin.so
+You can remove any other generated file.
 
 
+Well done, now you're ready to use vlc!