Warning, /system/qtcurve/README.md is written in an unsupported language. File is not indexed.
0001 # Installation
0002 ## Build and install
0003
0004 mkdir build
0005 cd build
0006 cmake .. -DCMAKE_INSTALL_PREFIX=/usr
0007 make
0008 make install
0009
0010 ## CMake configure arguments
0011 1. `ENABLE_QT4`:
0012
0013 Building QtCurve Qt4 theme.
0014
0015 (Default: `On`)
0016
0017 2. `ENABLE_QT5`:
0018
0019 Building QtCurve Qt5 theme.
0020
0021 (Default: `On`)
0022
0023 3. `ENABLE_GTK2`:
0024
0025 Building QtCurve Gtk2 theme.
0026
0027 (Default: `On`)
0028
0029 4. `QTC_ENABLE_X11`:
0030
0031 Enable X11 support. Require `xcb`, `xlib-xcb`. Will cause
0032 `libqtcurve-utils.so` to link to `libxcb`, `libX11-xcb` and `libX11`.
0033
0034 NOTE: this options will not affect any modules/libraries other than
0035 `libqtcurve-utils.so`. `libqtcurve-utils.so` with/without the option
0036 are API and ABI compatible although some functions will be NO-OP with
0037 X11 disabled.
0038
0039 (Default: `On`)
0040
0041 5. `QTC_INSTALL_PO`:
0042
0043 Install `*.po` translation files.
0044
0045 (Default: `On`)
0046
0047 6. `QTC_QT4_ENABLE_KDE`:
0048
0049 Compile QtCurve qt4 style with KDE support and dependencies.
0050
0051 (Default: `On`)
0052
0053 7. `QTC_QT4_ENABLE_KWIN`:
0054
0055 Compile QtCurve qt4 kwin style. This will only have effect when KDE support
0056 is turned on. Also require a X11 build of Qt4 and `libxcb` headers.
0057
0058 (Default: `On` if kwin header is found and KDE support is on,
0059 `Off` otherwise)
0060
0061 8. `QTC_KDE4_PREFIX`:
0062
0063 The install prefix of KDE4.
0064
0065 (Default: the value returned by `kde4-config` or `${CMAKE_INSTALL_PREFIX}`
0066 if `kde4-config` is not found.)
0067
0068 9. `QTC_KDE4_ICONS_PREFIX`:
0069
0070 The path of KDE4 icons.
0071
0072 (Default: `${QTC_KDE4_PREFIX}/share/icons`)
0073
0074 10. `QTC_QT5_ENABLE_KDE`:
0075
0076 Compile QtCurve qt5 style with KDE Frameworks support and dependencies.
0077
0078 (Default: `On`)
0079
0080 ## Deprecated and temporary options.
0081 These compile options were used to turn on/off some experimental features or
0082 work around for certain hardware/software/drivers. It is not guaranteed that
0083 any of the non-default value of these options can work and some of these
0084 options may crash certain applications. They may also be removed at any time
0085 (especially the ones to work around old hardware or driver bugs) and are not
0086 recommanded to turn on in distribution packages.
0087
0088 1. `QTC_QT4_STYLE_SUPPORT`:
0089
0090 Support QtCurve style files. These are stored as
0091 `<kde prefix>/share/apps/kstyle/themes/qtc_<stylename>.themerc`
0092 Note that this is not supported in Qt5.
0093
0094 (Default: `Off`)
0095
0096 # Additional Features
0097 ## XBar/MacMenu
0098 The XBar support was copied directly from Bespin. The relevant files are named
0099 `macmenu.*`. These were taken from revision 652.
0100
0101 **Deprecated** in favor of appmenu since KWin has builtin support for that
0102 after `4.10` and `appmenu-qt` does not depend on a certain theme.
0103
0104 ## Themes
0105 As of v0.55, you can create QtCurve based themes. These will appear with KDE's
0106 style control panel's combobox of styles. To create a new theme, select
0107 'QtCurve' from within KDE's style panel, then configure QtCurve as required.
0108 After this, in QtCurve's config dialog, select 'Export theme' from the options
0109 menu button. You will then be prompted to give your new 'theme' a name, and a
0110 comment. QtCurve will then create a file named `qtc_<name>.themerc`
0111 (e.g. `qtc_klearlooks.themerc`) - this will have the following format:
0112
0113 [Misc]
0114 Name=Klearlooks
0115 Comment=Clearlooks inspired style
0116 [KDE]
0117 WidgetStyle=qtc_klearlooks
0118 [Settings]
0119 animatedProgress=false
0120 appearance=gradient
0121 ....rest of qtcurve settings...
0122
0123 To use this theme, either copy `qtc_<name>.themerc` to
0124 `$KDEHOME/share/apps/kstyle/themes/`
0125 (usually `~/.kde/share/apps/kstyle/themes/`)
0126 or copy to `<kde install prefix>/share/apps/kstyle/themes/`
0127 (usually `/usr/share/apps/kstyle/themes/`)
0128
0129 When KDE's style panel is restarted, your new theme should appear in the list.
0130
0131 **NOTE**: As of QtCurve 1.0.0 style support has been disabled by default (enable
0132 via `QTC_QT4_STYLE_SUPPORT`) and this is not supported by Qt5.
0133
0134 ## Testing
0135 As of v1.2.1, QtCurve can be forced to read its settings from an alternate
0136 config file via the `QTCURVE_CONFIG_FILE` environment variable. This is only
0137 really useful for testing alternate config settings without changing the users
0138 current settings.
0139
0140 Usage:
0141
0142 QTCURVE_CONFIG_FILE=~/testfile kcalc
0143
0144 # Compiler versions requirement
0145 QtCurve requires the GNU dialect of ISO C99 and ISO C++11 (which means the
0146 compilers have to support `-std=gnu99` and `-std=c++0x` command line option).
0147 `g++>=4.7` and `clang++>=3.3` are fully supported. C compiler for any
0148 reasonable version of gcc and clang should all work well.
0149
0150 For g++ older than 4.7, you need `-Doverride=` in the `CXXFLAGS` since it
0151 does not support the override keyword in c++11. The trick should work down to
0152 g++ 4.4 for the Qt4 style and 4.6 for the Qt5 stle.
0153
0154 clang++ 3.3 is not compatible with the stdc++ header shipped with gcc 4.7 so
0155 libc++ is required when compiling with clang++ 3.3.
0156
0157 # License
0158 QtCurve `1.8.17` and earlier was licensed under GPLv2+. It was relicensed under
0159 LGPLv2.1+ on Nov. 14th 2013 in order to avoid confusion for moving into
0160 KDE-infrastructure. This relicensing have got permissions from all contributors
0161 of QtCurve (`git log --format='%aN <%aE>' | sort -u`):
0162
0163 Andrey Bondrov <andrey.bondrov@rosalab.ru>
0164 Boris Pek <tehnick-8@yandex.ru>
0165 Craig Drummond <craig.p.drummond@gmail.com>
0166 Sven-Hendrik Haase <sh@lutzhaase.com>
0167 Yichao Yu <yyc1992@gmail.com>