JKQtPlotter/sharedlib/README.md

# JKQTPlotter: Build as a SHARED library

This directory contains Projects that can be used to build a shared library of JKQTPlotter (i.e. the contents of the directory [`../lib`](../lib)

## QMake

### Build shared libraries
There are several `.PRO`-files, that can be used to build the full library, or a limited subsets. They will produce a dynamic link library that you can include into your projects, e.g. with the following QMake-snippet:

```.qmake
# include JKQTPlotter library
DEPENDPATH += <PATHTOJKQTPLOTTERDIR>/lib <PATHTOJKQTPLOTTERDIR>/sharedlib
INCLUDEPATH += <PATHTOJKQTPLOTTERDIR>/lib
CONFIG (debug, debug|release) {
    # ensure that DLLs are copied to the output directory
    install_jkqtplotter_dll.files = <PATHTOJKQTPLOTTERDIR>/sharedlib/debu/jkqtplotterlib_debug.*
    install_jkqtplotter_dll.path = $$OUT_PWD
    INSTALLS += install_jkqtplotter_dll
    # link agains DLLs
    LIBS += -L<PATHTOJKQTPLOTTERDIR>/sharedlib/debug -ljkqtplotterlib_debug
} else {
    # ensure that DLLs are copied to the output directory
    install_jkqtplotter_dll.files = <PATHTOJKQTPLOTTERDIR>/sharedlib/release/jkqtplotterlib.*
    install_jkqtplotter_dll.path = $$OUT_PWD
    INSTALLS += install_jkqtplotter_dll
    # link agains DLLs
    LIBS += -L<PATHTOJKQTPLOTTERDIR>/sharedlib/release -ljkqtplotterlib
}
```

This snippet assumes that you built the libraries with the provided `.PRO`-files.

*Note* that you will have to run a deployment step `make install` before running your executable, so the shared libararies are actually copied to the output directory (see `INSTALLS + ...` above).
- added new graph: JKQTPSingleColumnSymbolsGraph - fixed additional renames JKQTPLotter->JKQTPlotter - improved documentation (boxplots, JKQTMathText) - added several examples 2019-01-20 23:15:10 +08:00			`# JKQTPlotter: Build as a SHARED library`
reorganized folder structure in root directory (there are now distinct folders for INCLUDE, STATIC, DYNAMIC libs and examples moved to the folder examples) 2018-12-29 00:46:47 +08:00
- added new graph: JKQTPSingleColumnSymbolsGraph - fixed additional renames JKQTPLotter->JKQTPlotter - improved documentation (boxplots, JKQTMathText) - added several examples 2019-01-20 23:15:10 +08:00			This directory contains Projects that can be used to build a shared library of JKQTPlotter (i.e. the contents of the directory [`../lib`](../lib)
reorganized folder structure in root directory (there are now distinct folders for INCLUDE, STATIC, DYNAMIC libs and examples moved to the folder examples) 2018-12-29 00:46:47 +08:00
improved code and files for doxygen documentation 2019-01-13 01:53:16 +08:00			`## QMake`
reorganized folder structure in root directory (there are now distinct folders for INCLUDE, STATIC, DYNAMIC libs and examples moved to the folder examples) 2018-12-29 00:46:47 +08:00
improved code and files for doxygen documentation 2019-01-13 01:53:16 +08:00			`### Build shared libraries`
reorganized folder structure in root directory (there are now distinct folders for INCLUDE, STATIC, DYNAMIC libs and examples moved to the folder examples) 2018-12-29 00:46:47 +08:00			There are several `.PRO`-files, that can be used to build the full library, or a limited subsets. They will produce a dynamic link library that you can include into your projects, e.g. with the following QMake-snippet:

cleaned/improved doc further 2019-01-19 16:40:52 +08:00			```.qmake
- added new graph: JKQTPSingleColumnSymbolsGraph - fixed additional renames JKQTPLotter->JKQTPlotter - improved documentation (boxplots, JKQTMathText) - added several examples 2019-01-20 23:15:10 +08:00			`# include JKQTPlotter library`
- added styling system for JKQTPlotter (+example app) - improved documentation - changed: using static const variables instead of \c #define for fixed default values (e.g. JKQTPImageTools::LUTSIZE, JKQTPImageTools::PALETTE_ICON_WIDTH, JKQTPlotterDrawinTools::ABS_MIN_LINEWIDTH, JKQTMathText::ABS_MIN_LINEWIDTH ...) - new: added debugging option, which surrounds different regions with visible rectangles (JKQTBasePlotter::enableDebugShowRegionBoxes() ) - fixed: colorbars at top were positioned over the plot label - new: frames (plot viewport, key/legend ...) may be rounded off at the corners - new: diverse new styling options (default font name/size ...) - speed improvements to JKQTMathText::useSTIX() 2019-02-08 00:24:46 +08:00			`DEPENDPATH += <PATHTOJKQTPLOTTERDIR>/lib <PATHTOJKQTPLOTTERDIR>/sharedlib`
reorganized folder structure in root directory (there are now distinct folders for INCLUDE, STATIC, DYNAMIC libs and examples moved to the folder examples) 2018-12-29 00:46:47 +08:00			`INCLUDEPATH += <PATHTOJKQTPLOTTERDIR>/lib`
			`CONFIG (debug, debug\|release) {`
finished mouse interaction example + improved documentation 2019-02-04 04:00:15 +08:00			`# ensure that DLLs are copied to the output directory`
			`install_jkqtplotter_dll.files = <PATHTOJKQTPLOTTERDIR>/sharedlib/debu/jkqtplotterlib_debug.*`
			`install_jkqtplotter_dll.path = $$OUT_PWD`
			`INSTALLS += install_jkqtplotter_dll`
			`# link agains DLLs`
bugfix: staticlib also built a shared lib 2018-12-29 01:34:12 +08:00			`LIBS += -L<PATHTOJKQTPLOTTERDIR>/sharedlib/debug -ljkqtplotterlib_debug`
reorganized folder structure in root directory (there are now distinct folders for INCLUDE, STATIC, DYNAMIC libs and examples moved to the folder examples) 2018-12-29 00:46:47 +08:00			`} else {`
finished mouse interaction example + improved documentation 2019-02-04 04:00:15 +08:00			`# ensure that DLLs are copied to the output directory`
			`install_jkqtplotter_dll.files = <PATHTOJKQTPLOTTERDIR>/sharedlib/release/jkqtplotterlib.*`
			`install_jkqtplotter_dll.path = $$OUT_PWD`
			`INSTALLS += install_jkqtplotter_dll`
			`# link agains DLLs`
bugfix: staticlib also built a shared lib 2018-12-29 01:34:12 +08:00			`LIBS += -L<PATHTOJKQTPLOTTERDIR>/sharedlib/release -ljkqtplotterlib`
reorganized folder structure in root directory (there are now distinct folders for INCLUDE, STATIC, DYNAMIC libs and examples moved to the folder examples) 2018-12-29 00:46:47 +08:00			`}`
			```

improved readme-structure 2019-01-12 20:43:12 +08:00			This snippet assumes that you built the libraries with the provided `.PRO`-files.

finished mouse interaction example + improved documentation 2019-02-04 04:00:15 +08:00			Note that you will have to run a deployment step `make install` before running your executable, so the shared libararies are actually copied to the output directory (see `INSTALLS + ...` above).

improved code and files for doxygen documentation 2019-01-13 01:53:16 +08:00
improved readme-structure 2019-01-12 20:43:12 +08:00