git.sesse.net Git - vlc/blob - activex/README.TXT

   1 == ACTIVEX Control for VLC ==
   2
   3 The VLC ActiveX Control has been primary designed to work with Internet Explorer.
   4 however it may also work with Visual Basic and/or .NET
   5 Please note, that this code does not rely upon Microsoft MFC/ATL code,
   6 hence good compatibility is not guaranteed.
   7
   8 == Compiling ==
   9
  10 The ActiveX Control should compile without any glitches as long as you have the latest
  11 version of mingw gcc and headers. However, In order to script the ActiveX Control
  12 on Internet Explorer, a type library is required.
  13
  14 This type library is usually generated from an IDL file using Microsoft MIDL compiler.
  15 Therefore, for convenience I have checked in the output of the MIDL compiler in the
  16 repository so that you will only need the MIDL compiler if you change axvlc.idl.
  17 the generated files are as follow:
  18
  19 axvlc_idl.c
  20 axvlc_idl.h
  21 axvlc.tlb
  22
  23 To use the MIDL compiler on cygwin, you will need to set some environment variables
  24 before configuring vlc. If you have a copy of 'Microsoft Visual C++ 6.0' installed,
  25 the following settings are correct:
  26
  27 export PATH=$PATH:"/cygdrive/c/Program Files/Microsoft Visual Studio/COMMON/MSDev98/Bin":"/cygdrive/c/Program Files/Microsoft Visual Studio/VC98/Bin"
  28 export INCLUDE='C:\Program Files\Microsoft Visual Studio\VC98\Include'
  29 export MIDL="midl"
  30
  31 if you are cross-compiling on Linux, you may be able to use 'widl' which is part of
  32 the WINE project (http://www.winehq.com), however I have not tested it.
  33
  34 == Debugging ==
  35
  36 the ActiveX control is compiled with verbose output by default. However you will
  37 need to launch Internet Explorer from a Cygwin shell to see the output.
  38
  39 Debugging the ActiveX control DLL with GNU GDB can be difficult. Fortunately,
  40 the ActiveX control can also be compiled as an executable rather than a DLL.
  41 In ActiveX terms, this is called a local server.
  42 The advantage of a local server is that it will never crash its client,
  43 i.e Internet Explorer, if itself is crashing.
  44 The build system does not currently allow to create an executable version of
  45 the ActiveX control, you will need to manually define the BUILD_LOCALSERVER
  46 pre-processor variable and modify the Makefile to exclude the '-shared' option
  47 at the linking stage. Once this is done, you just need to launch axvlc.exe to
  48 have a working Activex control. Please note, that executable version of the
  49 ActiveX control will override any settings required for the DLL version, which
  50 will no longer work until you (re)register it as shown in the following section
  51
  52 == Local Install ==
  53
  54 The VLC NSIS installer will install the ActiveX Control without requiring any
  55 further manual intervention, but for people who like to live on the edge, here
  56 are the steps you need to perform once you have built the ActiveX Control.
  57
  58 The ActiveX control DLL file may be copied anywhere on the target machine,
  59 but before you can use the control, you will need to register it with Windows
  60 by using the REGSVR32 command, as per following example:
  61
  62 REGSVR32 C:\WINDOWS\AXVLC.DLL
  63
  64 if the control needs to use external VLC plugins (i.e other than built-in ones),
  65 make sure that the plugin path is set in the registry as per following example:
  66
  67 [HKEY_LOCAL_MACHINE\Software\VideoLAN\VLC]
  68 InstallDir="C:\Program Files\VideoLAN\VLC"
  69
  70 The InstallDir must be the parent directory of the 'plugins' directory.
  71
  72 WARNING: Both control and plugins must come from the same build source tree.
  73 Otherwise, at best, the control will not play any content, at worse
  74 it may crash Internet Explorer while attempting to load incompatible plugins.
  75
  76 == Internet Install ==
  77
  78 The activex control may be installed from a remote through Internet Installer if
  79 it is packaged up in a CAB file. The following link explains how to achieve this
  80
  81 http://msdn.microsoft.com/workshop/components/activex/packaging.asp
  82
  83 For convenience, I have provided a sample axvlc.INF file, which assumes that the VLC
  84 NSIS Installer has been packaged up a CAB file called AXVLC.CAB.
  85
  86 The ActiveX Control DLL file can also be distributed by itself if it has been
  87 compiled with built-in VLC plugins; check developer information for more
  88 information on built-in plugins.
  89
  90 regards,
  91     Damien Fouilleul <Damien dot Fouilleul at laposte dot net>
  92