Recent changes to develop

develop modified by Pedro Lopez-Cabanillas

Pedro Lopez-Cabanillas — Sun, 10 Sep 2023 08:03:58 -0000

--- v7
+++ v8
@@ -27,7 +27,7 @@
 ~~~
 DRUMSTICKINCLUDES=${HOME}/Projects/drumstick/library/include
 DRUMSTICKLIBS=${HOME}/Projects/build-drumstick-Desktop_Qt_5_9_7_GCC_64bit2-Debug/build/lib/
-DRUMSTICKRT=${DRUMSTICKLIBS}/drumstick
+DRUMSTICKRT=${DRUMSTICKLIBS}/drumstick2
 LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${DRUMSTICKLIBS}
 ~~~

develop modified by Pedro Lopez-Cabanillas

Pedro Lopez-Cabanillas — Sun, 16 Jul 2023 18:57:09 -0000

--- v6
+++ v7
@@ -11,11 +11,11 @@

 You will need C++ compilers and 3rd party libraries as well. For Linux, you should install a compiler available in your distro (GCC or Clang). For macOS, you need to install Xcode command line tools, in addition to the Xcode application. For Windows, you may use MinGW (included with Qt5) or Visual Studio and debugger, that is available from Microsoft. You should read all about the [supported platforms](http://doc.qt.io/qt-5/supported-platforms.html).

-Once you installed the development environment, you should download the sources from the SVN repository. You need Drumstick and VMPK.
+Once you installed the development environment, you should download the sources from the Git  repository. You need Drumstick and VMPK.

 ~~~
-$ svn checkout https://svn.code.sf.net/p/drumstick/code/trunk drumstick
-$ svn checkout https://svn.code.sf.net/p/vmpk/code/trunk/desktop vmpk
+$ git clone git://git.code.sf.net/p/drumstick/git drumstick
+$ git clone git://git.code.sf.net/p/vmpk/git vmpk
 ~~~

 You may open both projects, Drumstick and VMPK, at once with QtCreator, This is very comfortable if you need to make changes on both projects at the same time.

develop modified by Pedro Lopez-Cabanillas

Pedro Lopez-Cabanillas — Tue, 17 Dec 2019 11:19:47 -0000

--- v5
+++ v6
@@ -25,6 +25,7 @@
 You will need some environment variables for building VMPK. On Linux, they would be (for instance):

 ~~~
+DRUMSTICKINCLUDES=${HOME}/Projects/drumstick/library/include
 DRUMSTICKLIBS=${HOME}/Projects/build-drumstick-Desktop_Qt_5_9_7_GCC_64bit2-Debug/build/lib/
 DRUMSTICKRT=${DRUMSTICKLIBS}/drumstick
 LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${DRUMSTICKLIBS}

develop modified by Pedro Lopez-Cabanillas

Pedro Lopez-Cabanillas — Tue, 17 Dec 2019 11:16:13 -0000

--- v4
+++ v5
@@ -1,7 +1,7 @@
 #Developing VMPK with QtCreator (Qt5)
 VMPK may be compiled using two build systems:

-* CMake: it is the "official" build system for Linux/Unix packagers and users. Project files: "CMakeLists.txt"
+* CMake: it is the "official" build system for Linux/Unix packagers and users. Project files: "CMakeLists.txt". See: [Developing VMPK with CMake](develop-cmake).

 * Qmake: it is the Qt's original build system. Ideal for developers. Project files: "*. pro"

@@ -15,23 +15,16 @@

 ~~~
 $ svn checkout https://svn.code.sf.net/p/drumstick/code/trunk drumstick
-$ svn checkout https://svn.code.sf.net/p/vmpk/code/trunk vmpk
+$ svn checkout https://svn.code.sf.net/p/vmpk/code/trunk/desktop vmpk
 ~~~

 You may open both projects, Drumstick and VMPK, at once with QtCreator, This is very comfortable if you need to make changes on both projects at the same time.

 [[img src=qtcreator-edit.png alt="QtCreator Editor"]]

-You need to prepare an "includes" folder for Drumstick headers, if you are on Linux or Windows. For instance, symlink the headers you need from the Drumstick sources into the structure that will be used by VMPK. For instance:
+You will need some environment variables for building VMPK. On Linux, they would be (for instance):

 ~~~
-~/Projects> ln -s drumstick/library/include/ drumstick-includes
-~~~
-
-You will also need some other environment variables for building VMPK. On Linux, they would be (for instance):
-
-~~~
-DRUMSTICKINCLUDES=${HOME}/Projects/drumstick-includes
 DRUMSTICKLIBS=${HOME}/Projects/build-drumstick-Desktop_Qt_5_9_7_GCC_64bit2-Debug/build/lib/
 DRUMSTICKRT=${DRUMSTICKLIBS}/drumstick
 LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${DRUMSTICKLIBS}

develop modified by Pedro Lopez-Cabanillas

Pedro Lopez-Cabanillas — Tue, 29 Jan 2019 21:55:31 -0000

--- v3
+++ v4
@@ -11,34 +11,21 @@

 You will need C++ compilers and 3rd party libraries as well. For Linux, you should install a compiler available in your distro (GCC or Clang). For macOS, you need to install Xcode command line tools, in addition to the Xcode application. For Windows, you may use MinGW (included with Qt5) or Visual Studio and debugger, that is available from Microsoft. You should read all about the [supported platforms](http://doc.qt.io/qt-5/supported-platforms.html).

-Once you installed the development environment, you need to download the sources from the SVN repository. You need Drumstick and VMPK.
+Once you installed the development environment, you should download the sources from the SVN repository. You need Drumstick and VMPK.
+
+~~~
+$ svn checkout https://svn.code.sf.net/p/drumstick/code/trunk drumstick
+$ svn checkout https://svn.code.sf.net/p/vmpk/code/trunk vmpk
+~~~

 You may open both projects, Drumstick and VMPK, at once with QtCreator, This is very comfortable if you need to make changes on both projects at the same time.

 [[img src=qtcreator-edit.png alt="QtCreator Editor"]]

-You need to prepare an "includes" folder for Drumstick headers, if you are on Linux or Windows. My suggestion is to symlink the headers you need from the Drumstick sources into the structure that will be used by VMPK. For instance:
+You need to prepare an "includes" folder for Drumstick headers, if you are on Linux or Windows. For instance, symlink the headers you need from the Drumstick sources into the structure that will be used by VMPK. For instance:

 ~~~
-> tree ~/Projects/drumstick-includes
-.
-├── drumstick
-│   ├── alsaclient.h -> ../../drumstick/library/include/alsaclient.h
-│   ├── alsaevent.h -> ../../drumstick/library/include/alsaevent.h
-│   ├── alsaport.h -> ../../drumstick/library/include/alsaport.h
-│   ├── alsaqueue.h -> ../../drumstick/library/include/alsaqueue.h
-│   ├── alsatimer.h -> ../../drumstick/library/include/alsatimer.h
-│   ├── backendmanager.h -> ../../drumstick/library/include/backendmanager.h
-│   ├── drumstickcommon.h -> ../../drumstick/library/include/drumstickcommon.h
-│   ├── macros.h -> ../../drumstick/library/include/macros.h
-│   ├── playthread.h -> ../../drumstick/library/include/playthread.h
-│   ├── qove.h -> ../../drumstick/library/include/qove.h
-│   ├── qsmf.h -> ../../drumstick/library/include/qsmf.h
-│   ├── qwrk.h -> ../../drumstick/library/include/qwrk.h
-│   ├── rtmidiinput.h -> ../../drumstick/library/include/rtmidiinput.h
-│   ├── rtmidioutput.h -> ../../drumstick/library/include/rtmidioutput.h
-│   └── subscription.h -> ../../drumstick/library/include/subscription.h
-└── drumstick.h -> ../drumstick/library/include/drumstick.h
+~/Projects> ln -s drumstick/library/include/ drumstick-includes
 ~~~

 You will also need some other environment variables for building VMPK. On Linux, they would be (for instance):

develop modified by Pedro Lopez-Cabanillas

Pedro Lopez-Cabanillas — Thu, 24 Jan 2019 22:53:02 -0000

--- v2
+++ v3
@@ -1,11 +1,59 @@
-# Developing VMPK with QtCreator (Qt5)
+#Developing VMPK with QtCreator (Qt5)
+VMPK may be compiled using two build systems:

+* CMake: it is the "official" build system for Linux/Unix packagers and users. Project files: "CMakeLists.txt"

-![QtCreator: Editing](http://vmpk.sourceforge.net/images/qtcreator-edit.png)
+* Qmake: it is the Qt's original build system. Ideal for developers. Project files: "*. pro"

+Both types of project files can be opened with QtCreator, but only the qmake projects are explained in this page.

+Qt5 libraries and QtCreator can be installed using the [online installers.](https://www.qt.io/download-qt-installer) available in the Qt project site. They work and look the same for Linux, Windows, and macOS. On Linux and macOS, this method will install everything in $HOME/Qt by default (in C:\Qt\ on Windows). You can choose several Qt5 library versions to be installed at once, using them with a single copy of QtCreator which will be updated when a new version is available, without having to wait for the distribution maintainers to package and publish their packages for you. There are also larger [offline installers](https://www.qt.io/offline-installers) if you prefer this method (for instance, to install several machines on a classroom with the same single version downloaded only once).

+You will need C++ compilers and 3rd party libraries as well. For Linux, you should install a compiler available in your distro (GCC or Clang). For macOS, you need to install Xcode command line tools, in addition to the Xcode application. For Windows, you may use MinGW (included with Qt5) or Visual Studio and debugger, that is available from Microsoft. You should read all about the [supported platforms](http://doc.qt.io/qt-5/supported-platforms.html).

+Once you installed the development environment, you need to download the sources from the SVN repository. You need Drumstick and VMPK.

+You may open both projects, Drumstick and VMPK, at once with QtCreator, This is very comfortable if you need to make changes on both projects at the same time.

-![QtCreator: VMPK Project Settings](http://vmpk.sourceforge.net/images/project-settings.png)
+[[img src=qtcreator-edit.png alt="QtCreator Editor"]]
+
+You need to prepare an "includes" folder for Drumstick headers, if you are on Linux or Windows. My suggestion is to symlink the headers you need from the Drumstick sources into the structure that will be used by VMPK. For instance:
+
+~~~
+> tree ~/Projects/drumstick-includes
+.
+├── drumstick
+│   ├── alsaclient.h -> ../../drumstick/library/include/alsaclient.h
+│   ├── alsaevent.h -> ../../drumstick/library/include/alsaevent.h
+│   ├── alsaport.h -> ../../drumstick/library/include/alsaport.h
+│   ├── alsaqueue.h -> ../../drumstick/library/include/alsaqueue.h
+│   ├── alsatimer.h -> ../../drumstick/library/include/alsatimer.h
+│   ├── backendmanager.h -> ../../drumstick/library/include/backendmanager.h
+│   ├── drumstickcommon.h -> ../../drumstick/library/include/drumstickcommon.h
+│   ├── macros.h -> ../../drumstick/library/include/macros.h
+│   ├── playthread.h -> ../../drumstick/library/include/playthread.h
+│   ├── qove.h -> ../../drumstick/library/include/qove.h
+│   ├── qsmf.h -> ../../drumstick/library/include/qsmf.h
+│   ├── qwrk.h -> ../../drumstick/library/include/qwrk.h
+│   ├── rtmidiinput.h -> ../../drumstick/library/include/rtmidiinput.h
+│   ├── rtmidioutput.h -> ../../drumstick/library/include/rtmidioutput.h
+│   └── subscription.h -> ../../drumstick/library/include/subscription.h
+└── drumstick.h -> ../drumstick/library/include/drumstick.h
+~~~
+
+You will also need some other environment variables for building VMPK. On Linux, they would be (for instance):
+
+~~~
+DRUMSTICKINCLUDES=${HOME}/Projects/drumstick-includes
+DRUMSTICKLIBS=${HOME}/Projects/build-drumstick-Desktop_Qt_5_9_7_GCC_64bit2-Debug/build/lib/
+DRUMSTICKRT=${DRUMSTICKLIBS}/drumstick
+LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${DRUMSTICKLIBS}
+~~~
+
+Here are the VMPK project settings form, showing the results. There is a practical "Batch edit" button to easily edit the environment variables.
+
+[[img src=project-settings.png alt="QtCreator Project Settings"]]
+
+The last variable is LD_LIBRARY_PATH for Linux, DYLD_FRAMEWORK_PATH for macOS, and PATH for Windows. It is not absolutely necessary, if you check the option "Add build library search path to LD_LIBRARY_PATH" in the Run Settings of the project.
+
+Final warning: you should use the same Qt5 version for both projects Drumstick and VMPK, with the same Debug or Release configuration! And please read the [fine manual](http://doc.qt.io/qtcreator/index.html)!

develop modified by Pedro Lopez-Cabanillas

Pedro Lopez-Cabanillas — Thu, 24 Jan 2019 21:21:15 -0000

--- v1
+++ v2
@@ -0,0 +1,11 @@
+# Developing VMPK with QtCreator (Qt5)
+
+
+![QtCreator: Editing](http://vmpk.sourceforge.net/images/qtcreator-edit.png)
+
+
+
+
+
+
+![QtCreator: VMPK Project Settings](http://vmpk.sourceforge.net/images/project-settings.png)

Discussion for develop page

Pedro Lopez-Cabanillas — Thu, 24 Jan 2019 06:57:10 -0000

illustrations

develop modified by Pedro Lopez-Cabanillas

Pedro Lopez-Cabanillas — Thu, 24 Jan 2019 06:56:17 -0000