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/jkqtplotterlib
INCLUDEPATH += <PATHTOJKQTPLOTTERDIR>/lib
CONFIG (debug, debug|release) {
    # ensure that DLLs are copied to the output directory
    install_jkqtplotter_dll.files = <PATHTOJKQTPLOTTERDIR>/sharedlib/jkqtplotterlib/debug/jkqtplotterlib_debug.*
    install_jkqtplotter_dll.path = $$OUT_PWD
    INSTALLS += install_jkqtplotter_dll
    # link agains DLLs
    DEPENDPATH += <PATHTOJKQTPLOTTERDIR>/sharedlib/jkqtplotterlib/debug
    LIBS += -L<PATHTOJKQTPLOTTERDIR>/sharedlib/jkqtplotterlib/debug -ljkqtplotterlib_debug
} else {
    # ensure that DLLs are copied to the output directory
    install_jkqtplotter_dll.files = <PATHTOJKQTPLOTTERDIR>/sharedlib/jkqtplotterlib/release/jkqtplotterlib.*
    install_jkqtplotter_dll.path = $$OUT_PWD
    INSTALLS += install_jkqtplotter_dll
    DEPENDPATH += <PATHTOJKQTPLOTTERDIR>/sharedlib/jkqtplotterlib/release
    # link agains DLLs
    LIBS += -L<PATHTOJKQTPLOTTERDIR>/sharedlib/jkqtplotterlib/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`
moved build-projects for libs into their own subdirectories (works better with QMake, when building different libs) + necessary docu updates 2019-02-09 22:25:16 +08:00			`DEPENDPATH += <PATHTOJKQTPLOTTERDIR>/lib <PATHTOJKQTPLOTTERDIR>/sharedlib/jkqtplotterlib`
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`
moved build-projects for libs into their own subdirectories (works better with QMake, when building different libs) + necessary docu updates 2019-02-09 22:25:16 +08:00			`install_jkqtplotter_dll.files = <PATHTOJKQTPLOTTERDIR>/sharedlib/jkqtplotterlib/debug/jkqtplotterlib_debug.*`
finished mouse interaction example + improved documentation 2019-02-04 04:00:15 +08:00			`install_jkqtplotter_dll.path = $$OUT_PWD`
			`INSTALLS += install_jkqtplotter_dll`
			`# link agains DLLs`
moved build-projects for libs into their own subdirectories (works better with QMake, when building different libs) + necessary docu updates 2019-02-09 22:25:16 +08:00			`DEPENDPATH += <PATHTOJKQTPLOTTERDIR>/sharedlib/jkqtplotterlib/debug`
			`LIBS += -L<PATHTOJKQTPLOTTERDIR>/sharedlib/jkqtplotterlib/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`
moved build-projects for libs into their own subdirectories (works better with QMake, when building different libs) + necessary docu updates 2019-02-09 22:25:16 +08:00			`install_jkqtplotter_dll.files = <PATHTOJKQTPLOTTERDIR>/sharedlib/jkqtplotterlib/release/jkqtplotterlib.*`
finished mouse interaction example + improved documentation 2019-02-04 04:00:15 +08:00			`install_jkqtplotter_dll.path = $$OUT_PWD`
			`INSTALLS += install_jkqtplotter_dll`
moved build-projects for libs into their own subdirectories (works better with QMake, when building different libs) + necessary docu updates 2019-02-09 22:25:16 +08:00			`DEPENDPATH += <PATHTOJKQTPLOTTERDIR>/sharedlib/jkqtplotterlib/release`
finished mouse interaction example + improved documentation 2019-02-04 04:00:15 +08:00			`# link agains DLLs`
moved build-projects for libs into their own subdirectories (works better with QMake, when building different libs) + necessary docu updates 2019-02-09 22:25:16 +08:00			`LIBS += -L<PATHTOJKQTPLOTTERDIR>/sharedlib/jkqtplotterlib/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