From b94c341e309e7aed326703fa0bc3d3a79e9ac374 Mon Sep 17 00:00:00 2001 From: Chih-Hsuan Yen Date: Fri, 29 Jan 2021 11:38:30 +0800 Subject: [PATCH] Update docs * Minimal Qt version is bumped in https://github.com/lxqt/lxqt/issues/1844 * Minimal CMake version is bumped in https://github.com/lxqt/qtermwidget/pull/230 * Closes #402 - confusion around lxqt-build-tools version and PyQt builds --- CHANGELOG | 5 +++++ README.md | 10 ++++++---- docs/configuration.md | 15 +++++++++++++++ 3 files changed, 26 insertions(+), 4 deletions(-) create mode 100644 docs/configuration.md diff --git a/CHANGELOG b/CHANGELOG index 1f88da1f..368abf63 100644 --- a/CHANGELOG +++ b/CHANGELOG @@ -1,3 +1,8 @@ +qtermwidget-0.17.0 / unreleased +=============================== + * Drop support for KDE3 color scheme formats. (#367) + * Added modes for background image. How background images are drawn is changed and manual reconfiguration is needed. See docs/configuration.md for more details. (#385) + qtermwidget-0.16.1 / 2020-11-14 =============================== * Bumped version to 0.16.1, for a point release of qterminal. diff --git a/README.md b/README.md index 90746a3d..d09e9779 100644 --- a/README.md +++ b/README.md @@ -52,16 +52,18 @@ License: public-domain ### Compiling sources -The only runtime dependency is qtbase ≥ 5.7.1. +The only runtime dependency is qtbase ≥ 5.12.0. Build dependencies are as follows: -- CMake ≥ 3.0.2 serves as the build system and therefore needs to be present to compile. -- [lxqt-build-tools](https://github.com/lxqt/lxqt-build-tools/) >= 0.4.0 is also needed for compilation. -- Git is needed to pull translations and optionally pull latest VCS checkouts. +- CMake ≥ 3.1.0 serves as the build system and therefore needs to be present to compile. +- The latest [lxqt-build-tools](https://github.com/lxqt/lxqt-build-tools/) is also needed for compilation. +- Git is needed to optionally pull latest VCS checkouts. Code configuration is handled by CMake. CMake variable `CMAKE_INSTALL_PREFIX` will normally have to be set to `/usr`, depending on the way library paths are dealt with on 64bit systems. Variables like `CMAKE_INSTALL_LIBDIR` may have to be set as well. To build, run `make`. To install, run `make install` which accepts variable `DESTDIR` as usual. +To build PyQt bindings, specify an additional CMake option `QTERMWIDGET_BUILD_PYTHON_BINDING=ON` when building this library. + ### Binary packages The library is provided by all major Linux distributions. This includes Arch Linux, Debian, Fedora, openSUSE and all of their children, given they use the same package repositories. diff --git a/docs/configuration.md b/docs/configuration.md new file mode 100644 index 00000000..cf5d404c --- /dev/null +++ b/docs/configuration.md @@ -0,0 +1,15 @@ +# Migration for background images + +How the background image is drawn has been changed since version 0.17. +Intuitively, the background image is now drawn above the background color instead of below it. +Technically, the background image is no longer blended with the background color. + +Before migrating the settings, the background image should be converted to a translucent one with the transparency level matching the original terminal transparency. +For example, if the original terminal transparency of qtermwidget was 25%, the converted image should have transparency 25%. +The conversion can be done via ImageMagick, GraphicsMagick, GIMP or Krita. +Here is an example command using ImageMagick: + + $ convert original_image.jpg -matte -channel A +level 0,25% +channel translucent_image.png + +The converted image can be specified as the terminal background image to achieve a similar effect to previous versions. +Note that you also need to change the terminal transparency to 0% if you do not want to see another window or the desktop below the terminal.