Update README.md

- Make dependency info more actual
- Add project integrations samples
- Deprecate Meson until maintainer lookup

Author: h4tr3d

README.md

@@ -4,29 +4,38 @@ Wrapper for the FFmpeg that simplify usage it from C++ projects.
 
 Currently covered next functionality:
 
-- Core helper & utility classes (AVFrame -> av::AudioSample & av::VideoFrame, AVRational -> av::Rational and so on)
+- Core helper & utility classes (`AVFrame` → `av::AudioSample` & `av::VideoFrame`, `AVRational` → `av::Rational` and so on)
 - Container formats & contexts muxing and demuxing
 - Codecs & codecs contexts: encoding and decoding
-- Streams (AVStream -> av::Stream)
+- Streams (`AVStream` → `av::Stream`)
 - Filters (audio & video): parsing from string, manual adding filters to the graph & other
 - SW Video & Audio resamplers
 
 You can read the full documentation [here](https://h4tr3d.github.io/avcpp/).
 
 ## Requirements
 
-- FFmpeg >= 2.0
-  - libavformat >= 54.x.x
-  - libavcodec >= 54.x.x
-  - libavfilter >= 3.x.x
-  - libavutil >= 51.x.x
-  - libswscale >= 2.x.x
-  - libswresample >= 0.x.x
-  - libpostproc >= 52.x.x
-- GCC >= 5.0 (C++11 is required)
-- CMake (> 3.19) or Meson(> 50.0)
+- FFmpeg >= 4.0
+  - libavformat >= 58.x.x
+  - libavcodec >= 58.x.x
+  - libavdevice >= 58.x.x
+  - libavfilter >= 7.x.x
+  - libavutil >= 56.x.x
+  - libswscale >= 5.x.x
+  - libswresample >= 3.x.x
+  - libpostproc >= 55.x.x
+- GCC >= 9.0 (C++17 is required. [See](https://gcc.gnu.org/projects/cxx-status.html#cxx17), GCC from 6.0 may built code, but unchecked)
+- CMake (> 3.19)
 
-### Debian, Ubuntu 19.10 and Linux Mint 20.x or newer
+>
+> [!NOTE]
+> Oldest versions of the FFmpeg (at least >=2.0) may be successfully built and work but is it not checked for now. Same notes valid for the GCC version from 6.0.
+
+### Debian, Ubuntu 19.10+ and Linux Mint 20.x or newer
+
+> [!NOTE] 
+>
+> Build verification done only for oldest Ubuntu version provided by the GitHub Flow. You can look it [here](https://github.com/h4tr3d/avcpp/blob/master/.github/workflows/cmake-ci.yml#L25). For now, it is 22.04.
 
 You should install FFmpeg packages from the deb-multimedia.org site:
 
@@ -41,9 +50,13 @@ sudo apt-get install libavformat-dev \
                      libavdevice-dev
 ```
 
-Note 1: I did not test building on Debian.
+> [!NOTE]
+>
+> **Note 1**: I did not test building on Debian.
 
-Note 2: Debian Wheezy repo contains only FFmpeg 1.0.8. I tested building only with 2.x. So it is strongly recoment use Wheezy back-ports repo.
+>  [!NOTE]
+>
+> **Note 2**: Debian Wheezy repo contains only FFmpeg 1.0.8. I tested building only with ~2.x~ 4.0. So it is strongly recommended use Wheezy back-ports repo.
 
 ### Ubuntu 18.04 and Linux Mint 19.x
 
@@ -58,10 +71,7 @@ After that  just install the same packages as above.
 
 ------
 
-## Build
-
-There are two ways to compile either with CMake or with meson.
-By default meson is faster, but if your project uses CMake, those instructions might be better for integration.
+## Build & Usage
 
 ### Building with CMake
 
@@ -103,7 +113,119 @@ sudo make DESTDIR=<some_prefix> install
 
 Refer to CMake documentation for more details that can cover some special cases.
 
-### Building with meson
+#### Useful configure directives
+
+- `AV_ENABLE_STATIC` - Bool, enable static library build, On by default.
+- `AV_ENABLE_SHARED` - Bool, enable shared library build, On by default.
+- `AV_BUILD_EXAMPLES` - Bool, enable examples build, On by default.
+- C++ related
+  - `CMAKE_CXX_STANDARD` - Can be defined globally to override default C++ version. C++17 required at least.
+- FFmpeg related:
+  - `FFMPEG_PKG_CONFIG_SUFFIX` - String, TBD
+  - `PC_<component>_LIBRARY_DIRS` - Path, hint where FFmpeg component library looking
+  - `PC_FFMPEG_LIBRARY_DIRS` - Path, hint where a whole FFmpeg libraries looking
+  - `PC_<component>_INCLUDE_DIRS` - Path, hint where a FFmpeg component includes looking
+  - `PC_FFMPEG_INCLUDE_DIRS` - Path, hint where a whole FFmpeg includes looking
+  - `<component>` are:
+    - `AVCODEC`
+    - `AVDEVICE`
+    - `AVFORMAT`
+    - `AVFILTER`
+    - `AVUTIL`
+    - `POSTPROC`
+    - `SWSCALE`
+    - `SWRESAMPLE`
+
+### Integrate to the CMake project as Git Submodule
+
+AvCpp can be simple integrated into CMake-based project as Git submodule.
+
+Just do something like:
+
+```sh
+git submodule add https://github.com/h4tr3d/avcpp.git 3rdparty/avcpp
+```
+
+And in the your CMakeLists.txt:
+
+```cmake
+add_subdirectory(3rdparty/avcpp)
+```
+
+AvCpp detects that it included as non-root projects and skips some steps, like installation.
+
+CMake parameters pointed above may be sets before `add_subdirectory()`.
+
+Than use via `target_link_libraries`:
+
+```cmake
+target_link_libraries(prog PRIVATE avcpp::avcpp)
+```
+
+### Integrate to the CMake project via FetchContent
+
+Just do in your CMakeLists.txt:
+
+```cmake
+include(FetchContent)
+FetchContent_Declare(
+    avcpp
+    GIT_REPOSITORY https://github.com/h4tr3d/avcpp.git
+    GIT_TAG        v2.8.0
+)
+FetchContent_MakeAvailable(avcpp)
+```
+
+Than use via `target_link_libraries`:
+
+```cmake
+target_link_libraries(prog PRIVATE avcpp::avcpp)
+```
+
+CMake arguments can be set before `FetchContent_MakeAvailable` call:
+
+```cmake
+FetchContent_Declare(
+    avcpp
+    ...
+)
+set(AV_ENABLE_STATIC On)
+set(AV_ENABLE_SHARED Off)
+FetchContent_MakeAvailable(avcpp)
+```
+
+### Use via Vcpkg
+
+Just put into vcpkg.json:
+
+```json
+{
+    "$schema": "https://raw.githubusercontent.com/microsoft/vcpkg-tool/main/docs/vcpkg.schema.json",
+    "dependencies": [
+        ...
+        "avcpp",
+        ...
+    ],
+    "name": "your-app-name",
+    "version-string": "0.0.1"
+}
+```
+
+Than in the your CMakeLists.txt:
+
+```cmake
+find_package(avcpp CONFIG REQUIRED)
+target_link_libraries(prog PRIVATE avcpp::avcpp)
+```
+
+
+
+### Building with Meson
+
+> [!CAUTION]
+>
+> CMake usage strongly recommended.
+> Meson build has no maintainer and broken for the last code. It is excluded from the CI builds.
 
 Before you can begin with the building you have to clone the repository like this:
 

cmake/FindFFmpeg.cmake

@@ -34,6 +34,7 @@
 #   AVUTIL
 #   POSTPROC
 #   SWSCALE
+#   SWRESAMPLE
 #
 # the following variables will be defined
 #