Warning, /graphics/kolor-manager/README.md is written in an unsupported language. File is not indexed.

0001 # KDE KolorManager README
0002 
0003 ![](http://www.oyranos.org/images/oyranos_logo.svg)
0004 
0005 The Color Management System (CMS) Oyranos allows the coordination of
0006 device specific Informations (ICC profiles) und system wide settings.
0007 KolorManager is a KDE Systemssettings component for Oyranos.
0008 
0009 ## Modules
0010 * kmdevices (Kolor Management Devices - Monitor/Printer/etc. profile setup)
0011 * kminfo (Kolor Management Information - Displays specific profile information)
0012 * kmsettings (Kolor Management Settings - Change behavior and policy settings)
0013 
0014 ## Dependencies
0015 * The v1.1.0 tagged release builds fine using Oyranos-0.9.6 .
0016 * Actual git should the latest Oyranos from it's git repository. KolorManager gets updated pretty quick to Oyranos changes.
0017 * [Synnefo](http://www.oyranos.org/synnefo/)'s libOyranosSynnefo is used for the program logic
0018 
0019 
0020 ## Installation
0021 Enter the following commands:
0022 
0023     mkdir build && cd build/
0024     cmake ..
0025     make
0026     make install
0027 
0028 
0029 ## Run
0030 This build should install a "Kolor Management" icon in the KF5 settings window, under "Computer Administration".  An alternative method for running the individual modules would be to type this in a terminal:
0031 
0032     kcmshell5 [KMMODULE]     (Where KMMODULE is "kcm_kmdevices", "kcm_kminfo", or "kcm_kmsettings")  
0033 
0034 This is handy for displaying debug information through the console.
0035 
0036 
0037 ## Build Notes
0038 
0039 The following files are installed under each module directory.  They are shown here for reference:
0040 
0041 MODULE.cpp (source code)
0042 MODULE.h (header)
0043 MODULE.ui (Qt Designer file)
0044 ui_MODULE.h (Qt designer header file - for hand coding purposes)
0045 CMakeLists.txt (build instructions for each module)
0046 
0047 
0048 ## References
0049 
0050 * [Home Page@www.oyranos.org](http://www.oyranos.org/kolormanager)
0051 * [@ColourWiki](http://www.oyranos.org/wiki/index.php?title=Kolor-manager)
0052 
0053 ## Development
0054 
0055     # local debug build
0056     mkdir build && cd build
0057     cmake -DCMAKE_INSTALL_PREFIX=~/.local -DCMAKE_BUILD_TYPE=debugfull -DCMAKE_CXX_FLAGS="-g -Wall" ../kolor-manager
0058     #Possibly prepend the PKG_CONFIG_PATH variable to reflect Oyranos...
0059     kbuildsycoca5 # update KDEs internal icon and module cachings
0060     kcmshell5 kminfo & # start
0061 
0062 ### Debugging
0063     echo $!  # obtain process id from bashs most recent process - kcmshell5
0064     KDE_DEBUG=1 gdb kcmshell5  # the variable avoid KDE's crash handler
0065     gdb > attach to process id
0066     gdb > breakpoint kminfo.cpp:line_number
0067     gdb > continue
0068 
0069 ### create tar ball from git
0070     sha=`cat .git/refs/heads/master | head -c 8`
0071     git archive --format=tar --prefix=kolor-manager-$sha/ HEAD | bzip2 > kolor-manager-$sha.tar.bz2
0072 
0073 ### list modules
0074     qdbus org.kde.kded5 /kded org.kde.kded5.loadedModules
0075 ### restart kded (omit kdeinit5_wrapper to see LD_LIBRARY_PATH)
0076     kquitapp kded; QT_LOGGING_RULES="kolorserver.debug=true" kded5
0077     # kdebugdialog --fullmode   might be useful
0078 ### unload kolorserver
0079     qdbus org.kde.kded /kded unloadModule kolorserver
0080 ### debug KWin X11
0081     QT_LOGGING_RULES="libkwinglutils.debug=true;kwin_scene_opengl.debug=true" kwin_x11 --replace
0082 
0083 ## History
0084 * started by [Joe Simon](http://jsimon3.wordpress.com/category/synnefo/) in summer 2008-2009
0085 * KolorManager maintained by [Kai-Uwe Behrmann](http://www.behrmann.name) 2010-2016
0086 * KolorServer was maintained by Casian Andrei 2012 (It is now a separate project.)
0087 
0088 ## Known Issues
0089 
0090 ### KMSettings
0091 - The configuration has to be ported to a Oyranos configure object to manipulate
0092 settings and then apply at once. This is currently not possible, as each setting
0093 is imediately applied to the Oyranos settings DB.  
0094 
0095 ### KMDevices
0096 - Camera support needs to be outlined first