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 MFC/ATL, hence good compatibility
   6 is not guaranteed.
   7
   8 == Compiling ==
   9
  10 The Active 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 == Local Install ==
  35
  36 The ActiveX control is built as a DLL file, which is the only file that needs be
  37 distributed and it may be installed anywhere on the target machine as long as
  38 its path is specified within your PATH environment variable. Typically, you would
  39 install it into your WINDOWS directory.
  40
  41 if the control needs other VLC plugins, you will need to have VLC installed
  42 on your system, otherwise make sure that the plugin path is set in the registry
  43 as indicated below
  44
  45 [HKEY_LOCAL_MACHINE\Software\VideoLAN\VLC]
  46 InstallDir="path\\dir\\"
  47
  48 WARNING: The plugins version must also match the ActiveX control version,
  49 otherwise it may crash while attempting to load incompatible plugins
  50
  51 == Internet Install ==
  52
  53 The activex control may be installed from a remote through Internet Installer if
  54 it is packaged up in a CAB file. The following link explains how to achieve this
  55
  56 http://msdn.microsoft.com/workshop/components/activex/packaging.asp
  57
  58 For convenience, I have provide a sample axvlc.INF file, which installs the ActiveX Control
  59 into the WINDOWS directory, feel free to adapt it to your need.
  60
  61 WARNING: For remote install, the ActiveX Control should be built with all required VLC
  62 plugins built-in.
  63
  64 regards,
  65     Damien Fouilleul <Damien dot Fouilleul at laposte dot net>
  66