Git commit 5e5770bdbe87d8edbc414a8355621ec57b0d9cfd by Kai-Uwe Behrmann. Committed on 30/11/2016 at 17:05. Pushed by behrmann into branch 'master'. convert to github friendly markdown format D +0 -101 README A +95 -0 README.md https://commits.kde.org/kolor-manager/5e5770bdbe87d8edbc414a8355621ec57b0d9= cfd diff --git a/README b/README deleted file mode 100644 index 906e161..0000000 --- a/README +++ /dev/null @@ -1,101 +0,0 @@ -******************************* -* KDE Kolor Manager README * -******************************* - -started by Joe Simon in summer 2008-2009 -KolorManager maintained by Kai-Uwe Behrmann 2010-2015 -KolorServer maintained by Casian Andrei 2012 - -*kmdevices (Kolor Management Devices - Monitor/Printer/etc. profile setup) -*kminfo (Kolor Management Information - Displays specific profile informat= ion) -*kmsettings (Kolor Management Settings - Change behavior and policy settin= gs) - ------REQUIRED LIBRARIES--------------------------------------------- - -- The v1.1.0 tagged release builds fine using Oyranos-0.9.6 . -- Actual git should the latest Oyranos from it's git repository. KolorMana= ger gets updated pretty quick to Oyranos changes. -- Synnefo's libsynnefo is used for the program logic - - ------INSTALLATION---------------------------------------------------- - -Enter the following commands in the "build" directory: - -cmake .. -make -make install - - ------RUNNING------------------------------------------------------- - --This build should install a "Kolor Management" icon in the KF5 settings w= indow, under "Computer Administration". An alternative method for running = the individual modules would be to type this in a terminal: - -kcmshell5 [KMMODULE] (Where KMMODULE is "kmdevices", "kminfo", or "kms= ettings") = - -This is handy for displaying debug information through the console. - - ------BUILD NOTES----------------------------------------------- - -The following files are installed under each module directory. They are s= hown here for reference: - -MODULE.cpp (source code) -MODULE.h (header) -MODULE.ui (Qt Designer file) -icons.qrc (resource file for icons in 'kmdevices' and 'kminfo') -ui_MODULE.h (Qt designer header file - for hand coding purposes) -CMakeLists.txt (build instructions for each module) - - ------LINKS----------------------------------------------------------------= ----- - -http://www.oyranos.org/kolormanager -ColourWiki: http://www.oyranos.org/wiki/index.php?title=3DKolor-manager - ------DEVELOPMENT----------------------------------------------------------= ----- - -# local debug build -mkdir build -cd build -cmake -DCMAKE_INSTALL_PREFIX=3D~/.local -DCMAKE_BUILD_TYPE=3Ddebugfull -DC= MAKE_CXX_FLAGS=3D"-g -Wall" ../kolor-manager -#Possibly prepend the PKG_CONFIG_PATH variable to reflect Oyranos... -kbuildsycoca5 # update KDEs internal icon and module cachings -kcmshell5 kminfo & # start - -# Debug -echo $! # obtain process id from bashs most recent process - kcmshell5 -KDE_DEBUG=3D1 gdb kcmshell5 # the variable avoid KDE's crash handler -gdb > attach to process id -gdb > breakpoint kminfo.cpp:line_number -gdb > continue - -# create tar ball from git -sha=3D`cat .git/refs/heads/master | head -c 8` -git archive --format=3Dtar --prefix=3Dkolor-manager-$sha/ HEAD | bzip2 > k= olor-manager-$sha.tar.bz2 - -# list modules -qdbus org.kde.kded5 /kded org.kde.kded5.loadedModules -# restart kded (omit kdeinit5_wrapper to see LD_LIBRARY_PATH) -kquitapp kded5; sleep 1s; kdeinit5_wrapper kded5 -# kdebugdialog --fullmode might be useful -# unload kolorserver -qdbus org.kde.kded /kded unloadModule kolorserver - ------MAJOR CHANGES FROM LAST TEST BUILDS----------------------------------= ----- - -GENERAL - - ------CURRENT ISSUES (FIXME)-----------------------------------------------= ----- - -The following issues, shall be forwarded as "FIXMEs" from here on: - -KMSETTINGS --The configuration has to be ported to a Oyranos configure object to manip= ulate -settings and then apply at once. This is currently not possible, as each s= etting -is imediately applied to the Oyranos settings DB. = - -KMDEVICES --Camera support needs to be outlined first - -KMINFO diff --git a/README.md b/README.md new file mode 100644 index 0000000..18be1b4 --- /dev/null +++ b/README.md @@ -0,0 +1,95 @@ +# KDE KolorManager README + +![](http://www.oyranos.org/images/oyranos_logo.svg) + +The Color Management System (CMS) Oyranos allows the coordination of +device specific Informations (ICC profiles) und system wide settings. +KolorManager is a KDE Systemssettings component for Oyranos. + +## Modules +* kmdevices (Kolor Management Devices - Monitor/Printer/etc. profile setup) +* kminfo (Kolor Management Information - Displays specific profile informa= tion) +* kmsettings (Kolor Management Settings - Change behavior and policy setti= ngs) + +## Dependencies +* The v1.1.0 tagged release builds fine using Oyranos-0.9.6 . +* Actual git should the latest Oyranos from it's git repository. KolorMana= ger gets updated pretty quick to Oyranos changes. +* [Synnefo](http://www.oyranos.org/synnefo/)'s libOyranosSynnefo is used f= or the program logic + + +## Installation +Enter the following commands: + + mkdir build && cd build/ + cmake .. + make + make install + + +## Run +This build should install a "Kolor Management" icon in the KF5 settings wi= ndow, under "Computer Administration". An alternative method for running t= he individual modules would be to type this in a terminal: + + kcmshell5 [KMMODULE] (Where KMMODULE is "kcm_kmdevices", "kcm_kmin= fo", or "kcm_kmsettings") = + +This is handy for displaying debug information through the console. + + +## Build Notes + +The following files are installed under each module directory. They are s= hown here for reference: + +MODULE.cpp (source code) +MODULE.h (header) +MODULE.ui (Qt Designer file) +icons.qrc (resource file for icons in 'kmdevices' and 'kminfo') +ui_MODULE.h (Qt designer header file - for hand coding purposes) +CMakeLists.txt (build instructions for each module) + + +## References + +* [Home Page@www.oyranos.org](http://www.oyranos.org/kolormanager) +* [@ColourWiki](http://www.oyranos.org/wiki/index.php?title=3DKolor-manage= r) + +## Development + + # local debug build + mkdir build && cd build + cmake -DCMAKE_INSTALL_PREFIX=3D~/.local -DCMAKE_BUILD_TYPE=3Ddebugfull= -DCMAKE_CXX_FLAGS=3D"-g -Wall" ../kolor-manager + #Possibly prepend the PKG_CONFIG_PATH variable to reflect Oyranos... + kbuildsycoca5 # update KDEs internal icon and module cachings + kcmshell5 kminfo & # start + +### Debugging + echo $! # obtain process id from bashs most recent process - kcmshell5 + KDE_DEBUG=3D1 gdb kcmshell5 # the variable avoid KDE's crash handler + gdb > attach to process id + gdb > breakpoint kminfo.cpp:line_number + gdb > continue + +### create tar ball from git + sha=3D`cat .git/refs/heads/master | head -c 8` + git archive --format=3Dtar --prefix=3Dkolor-manager-$sha/ HEAD | bzip2= > kolor-manager-$sha.tar.bz2 + +### list modules + qdbus org.kde.kded5 /kded org.kde.kded5.loadedModules +### restart kded (omit kdeinit5_wrapper to see LD_LIBRARY_PATH) + kquitapp kded5; sleep 1s; kdeinit5_wrapper kded5 + # kdebugdialog --fullmode might be useful +### unload kolorserver + qdbus org.kde.kded /kded unloadModule kolorserver + +## History +* started by Joe Simon in summer 2008-2009 +* KolorManager maintained by Kai-Uwe Behrmann 2010-2016 +* KolorServer was maintained by Casian Andrei 2012 (It is now a separate p= roject.) + +## Known Issues + +### KMSettings +- The configuration has to be ported to a Oyranos configure object to mani= pulate +settings and then apply at once. This is currently not possible, as each s= etting +is imediately applied to the Oyranos settings DB. = + +### KMDevices +- Camera support needs to be outlined first