===============================================================================
= Licensing
===============================================================================
Please see the corresponding license.txt file in the same
directory as this readme.txt file in the ffmpeg-wb.jar module.

===============================================================================
= How to update the FFmpeg libraries contained in this jar.
===============================================================================
In compliance with section 6a of the LGPL license, a
copy of which is contained in the same directory as
this readme.txt file, we would like to inform you that
the ffmpeg-wb.jar file itself serves as the object code for
the ffmpeg-wb module, which uses the FFmpeg library that is
covered under the LGPL license. Section 6a preserves the
end user's right to replace the version of the FFmpeg
library inside the work that uses the library (the
Niagara 4 ffmpeg-wb module).
 
Here are some instructions on how to replace the FFmpeg /
AVCodec library files contained in this jar file with
your own (should you wish to do so):

1.) Build your dll files.
    - Use the following tutorial. It is the same one that we
      followed to create the FFmpeg library files contained
      in this jar:
      
      https://trac.ffmpeg.org/wiki/CompilationGuide/MSVC
      
2.) Use your favorite zip utility such as WinZip or 7-Zip.
    - Open this ffmpeg-wb.jar file (it is also a zip file)
    - Replace the library files located in the 'nativeLib'
      folder with your own.
    - Extract the module.xml file in this jar file
      using your zip utility. Change the version to your
      own version number. For example, you can change it
      from 3.x.yyy to 1.0.0. Change the vendor from Tridium
      to your organization. Update the module.xml file in
      this jar using your zip utility.

===============================================================================
= What Source Did We Use To Compile The FFmpeg Libraries???
===============================================================================
The source code for FFmpeg is open and available to anybody!
http://ffmpeg.org/download.html#repositories

FFmpeg 7.1.1 was released on 2025-03-03. It is the latest stable FFmpeg release from the 7.1 release branch, which was cut from master on 2024-09-24.

It includes the following library versions:

libavutil      59. 39.100
libavcodec     61. 19.100
libavformat    61.  7.100
libavdevice    61.  3.100
libavfilter    10.  4.100
libswscale      8.  3.100
libswresample   5.  3.100
libpostproc    58.  3.100

A copy of the source code that we used to build the FFmpeg /
AVCodec libraries is included in this module (ffmpeg-wb.jar)
in the "ffmpeg-7.1.1.tar.xz" file in the "docs" directory.
You may use your favorite zip utility (such as WinZip or
7-Zip) to open the "ffmpeg-wb.jar" and extract
"ffmpeg-7.1.1.tar.xz" from "ffmpeg-wb.jar".

If your copy of "ffmpeg-wb.jar" does not include "ffmpeg-7.1.1.tar.xz"
then please use the "ffmpeg-wb.jar" directly from your Niagra 4
installation.

If you follow the instructions in the above-mentioned 
tutorial then it will show you how to acquire the
latest source code for the FFmpeg library as well as 
compile the source into dll files for use on a Windows OS.

We used the same options in the 'configure' script as those
provided in the above-mentioned tutorial for generating
FFmpeg / AVCodec using shared / dll libraries.

Here are the 'configure' script options from the tutorial.
These are the same as what we used to build the FFmpeg /
AVCodec dll files:

 ./configure --prefix=ffmpeg_64/ --enable-shared --yasmexe='C:/c99/yasm-1.3.0-win64.exe' --target-os=win64 --arch=x86_64 --toolchain=msvc

Once again, here is the URL of the tutorial:
 https://trac.ffmpeg.org/wiki/CompilationGuide/MSVC