******************************************************************************
***            Cross-compiling Avidemux on Linux for Windows               ***
***                                                                        ***
***          Description of the default build environment setup            ***
******************************************************************************


1. Install MXE (M cross environment) build dependencies as described in

    http://mxe.cc/#requirements

for your respective Linux distribution. For Fedora, at the time of writing,
this list doesn't mention the developer package for pcre (pcre-devel), needed
for a successful build of glib in MXE, see https://github.com/mxe/mxe/issues/2875
for the same omission fixed for Debian and its derivatives.

Once dependencies have been installed, run the script mxe-setup.sh from
a directory *outside of Avidemux top source directory*. This script will

  a) clone MXE git repository;

  b) create a source tarball of the latest x264 off the stable branch from
  the videolan.org x264 git mirror, generate and apply a patch for MXE;

  c) patch MXE to use v3.5 of x265 instead of v2.4 and v1.13.1 of libvpx
  instead of v1.8.2;

  d) build the 64-bit MXE target (the 32-bit target is currently untested);

  e) clone libaom git repository from googlesource.com, build and install
  the library in both MXE targets;

  d) install the sdk/11.1 branch of nv-codec-headers from the mirror at GitHub
  in the 64-bit MXE target only.

The absolute path to the "mxe" directory created during this step is referenced
below as ${MXE_ROOT}.

An example for the case that Avidemux source was cloned as ~/avidemux2:

    cd ~ && mkdir cross-build && cd cross-build && bash ../avidemux2/mxe/mxe-setup.sh

##############################################################################

2. Enter the Avidemux top source directory and run

    bash bootStrapCrossMingwQt5_mxe.sh --mxe-root=${MXE_ROOT}

to cross-compile a 64-bit Avidemux version. If 32-bit MXE target has been
built, run

    bash bootStrapCrossMingwQt5_mxe.sh --mxe-root=${MXE_ROOT} --32

to cross-compile a 32-bit version. Run

    bash bootStrapCrossMingwQt5_mxe.sh -h

to see the list of all available options. It is assumed that 'zip' utility is
installed and in $PATH. Copy the 'avidemux_rYYMMDD-hhmmss_win{32,64}Qt5.zip'
file from the 'packaged_mingw_build_YYMMDD-hhmmss' directory to a Windows
partition, extract it on Windows and run 'avidemux.exe' from there.

##############################################################################

3. Issues:

Build of the mesa package in MXE fails with python3 >= 3.8. If the Linux
distribution used to host MXE ships with Python at version 3.8 or later,
make sure that python2 is installed and unversioned python command points
to python2. See https://bugs.python.org/issue40350

As of this writing, twolame, aften, vapoursynth and avsproxy are not available.

2023-10-28