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>