From: Gildas Bazin Date: Mon, 1 Apr 2002 09:59:41 +0000 (+0000) Subject: * updated INSTALL.win32 X-Git-Tag: 0.3.0~42 X-Git-Url: https://git.sesse.net/?a=commitdiff_plain;h=43138273465f5a51f1b4c65fad6ad6d694ed6584;p=vlc * updated INSTALL.win32 --- diff --git a/INSTALL-win32.txt b/INSTALL-win32.txt deleted file mode 100644 index 3e2183ca40..0000000000 --- a/INSTALL-win32.txt +++ /dev/null @@ -1,122 +0,0 @@ -INSTALL file for the Windows9x/2k version of vlc, the VideoLAN Client - -Running VideoLAN -================ - -If you have already built vlc (see below) or are using a binary release, -just run 'vlc.exe'. - -You can also run vlc from a dos command box, in which case you'll be able -to use the command line arguments. You can obtain a list of these command -line arguments by typing 'vlc --help'. -It is also sometimes useful to display vlc's debug console. You can do so -by running 'vlc -v'. -To store a debug log of the current vlc session, you can use -'vlc -vvv --stdout=debug.txt'. - -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 ) - - -Building VideoLAN from source code -================================== - -If you want to do the tricky job of building vlc from source, follow -these instructions: -( WARNING: the win32 build process is not yet really stable, so you may have - to hack manually the MAKEFILES ) - -Getting the right tools -======================= - -You can build the win32 vlc port in two ways: -- natively on Windows -- or on Linux, using cross-compiling - -All the necessary tools can be found on the libSDL web page: -http://www.libsdl.org/Xmingw32/ - -- 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. - -- compiling natively on Windoze: -[coming soon (investigating a combination of cygwin+mingw32)] - -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. - -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) - -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 -================= - -Have a look at the generated Makefile.opts file, you may want to choose -which modules will be compiled as plugins, and which ones will remain in -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! diff --git a/INSTALL.win32 b/INSTALL.win32 new file mode 100644 index 0000000000..506c62d09b --- /dev/null +++ b/INSTALL.win32 @@ -0,0 +1,149 @@ +INSTALL file for the Windows9x/2k/XP version of vlc, the VideoLAN Client + +Running VideoLAN Client +======================= + +If you have already built vlc (see below) or are using a binary release, +just run 'vlc.exe'. + +You can also run vlc from a dos command box, in which case you'll be able +to use the command line arguments. You can obtain a list of these command +line arguments by typing 'vlc --help'. +To store a debug log of the current vlc session, you can use +'vlc -vvvvv --intf=logger nameofyourvideofile', but this will unfortunatly +disable the GUI. You will end-up with a vlc.log file in your current directory. + +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/XP or the + DVD won't play. ) + +Building VideoLAN Client from the source code +============================================= + +If you want to do the tricky job of building vlc from sources, you can do it +in two ways: + +- natively on Windows, using MSYS+MINGW (www.mingw.org) + (MSYS is a minimal build environnement to compile unixish projects under + windoze. It provides all the common unix tools like sh, gmake...) + +- or on Linux, using the mingw32 cross-compiler + +Getting the right tools +======================= + +- cross-compiling with mingw32: +All the necessary tools you need can be found on the videolan web site: +http://www.videolan.org/vlc/windows.html + +You first need to download a linux cross-compiler version of mingw32. +(for Debian GNU/Linux users, there is a mingw32 package) + +You must also not forget to install the extra development packages if you want +to build the DirectX, GTK and SDL plugins. + +- compiling natively on Windoze: +You first need to download and install MSYS-1.0.5 (version 1.0.6 doesn't seem +to work as well) and MINGW. +http://prdownloads.sourceforge.net/mingw/msys-1.0.5-i686-bin.tar.gz +http://prdownloads.sourceforge.net/mingw/MinGW-1.1.tar.gz + +You must also not forget to install the extra development packages if you want +to build the DirectX, GTK and SDL plugins. +(http://www.videolan.org/vlc/windows.html) + + +NOTE: by default, the GTK package is configured to be installed in +/usr/local/gtk-win32, if you want to change this path, then you need to edit +the gtk-win32/bin/gtk-config file and change "gtk_dir=" accordingly. +The same is true for the SDL package, it is installed in +/usr/local/SDL-1.2.3-win32 by default and you need to change "prefix=" in +SDL-1.2.3-win32/i386-mingw32msvc/bin/sdl-config if you plan to extract the +archive in a different directory. + +Configuring the build +===================== + +The best way to configure the build process of vlc is to use the +`./configure' script. + +See `./configure --help' for more information. + +If you are cross-compiling from Debian, you can use something +along those lines: + + make distclean ; \ + ./configure --host=i586-mingw32msvc --target=i586-mingw32msvc \ + --with-gtk-config-path=/usr/local/gtk-win32/bin \ + --with-sdl-config-path=/usr/local/SDL-1.2.3-win32/i386-mingw32msvc/bin \ + --with-directx=/usr/local/dxheaders + +If you are cross-compiling using the mingw32 package provided by +www.videolan.org, you have to use something along those lines: + + CC=/usr/local/cross-tools/bin/i586-mingw32msvc-gcc \ + PATH=/usr/local/cross-tools/bin:$PATH \ + ./configure --host=i586-mingw32msvc --target=i586-mingw32msvc \ + --with-gtk-config-path=/usr/local/gtk-win32/bin \ + --with-sdl-config-path=/usr/local/SDL-1.2.3-win32/i386-mingw32msvc/bin \ + --with-directx=/usr/local/dxheaders + +If you are compiling natively on Windoze, then you can use something +along those lines: + MAKE=gmake ./configure \ + --with-gtk-config-path=/c/dev/gtk-win32/bin \ + --with-sdl-config-path=/c/dev/SDL-1.2.3-win32/i386-mingw32msvc/bin \ + --with-directx=/c/dev/dxheaders + +Building VideoLAN Client +======================== + +Have a look at the generated Makefile.opts file, you may want to choose +which modules will be compiled as plugins, and which ones will remain in +the core application. The configure script tries to guess for you. + +Once configured, to build vlc you have to: + +If you are cross-compiling from Debian, then just run `make'. + +If you are cross-compiling using the mingw32 package provided by +www.videolan.org, run `PATH=/usr/local/cross-tools/bin:$PATH make'. + +If you are compiling natively on Windoze, run `MAKE=gmake gmake'. +(note that msys sometimes stops in the middle of the build process and +complains about not being able to create .dep files. If this happens, just +re-run the above command another time and it should work) + +Building Win32 interface with bcc32 (Borland's compiler) +======================================================== +(This stage is only necessary if you want to use the Win32 native interface. + If you are happy with the GTK interface, then you can skip this section) + +[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! +======================================= \ No newline at end of file