From 7d904af92287a175d47618f8fad95c1bfa7e9eb9 Mon Sep 17 00:00:00 2001 From: Markus Bertling Date: Mon, 20 Nov 2017 23:07:57 +0100 Subject: [PATCH] docs: add getting started guide refs https://github.com/ml4a/ml4a-ofx/issues/14 --- README.md | 41 ++++++++++++++++++++++++++++++++++++++++- 1 file changed, 40 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index db7bd46..49b17e9 100644 --- a/README.md +++ b/README.md @@ -47,4 +47,43 @@ The addons also make use of ofxGui, ofxOsc, and ofxOpenCv, which are included in These addons are not currently used in ml4a-ofx, but are also relevant and may be wrapped into examples in the future: - [ofxMSATensorflow](https://github.com/memo/ofxMSATensorFlow) - [ofxDlib](https://github.com/bakercp/ofxDlib) -- [ofxCaffe](https://github.com/Geekrick88/ofxCaffe) \ No newline at end of file +- [ofxCaffe](https://github.com/Geekrick88/ofxCaffe) + +## Getting started + +These are some steps to get you up and running with ml4a-ofx: + +### Prepare your project + +0. Make sure you've read and followed the [openFrameworks setup guides](http://openframeworks.cc/download/) relevant for your system. Going through them makes sure the foundation for all ml4a-ofx apps is working correctly. +1. This guide assumes that you have: + - One folder with the `openFrameworks` setup in it. This is the folder in which you would test your `openFrameworks` setup as described above. + - One different folder in which you have the `ml4a-ofx` content. This folder does *not* have to be within the `openFrameworks` folder. +1. For your project, you most certainly want to use an existing `ml4a-ofx` app as a starting point. So simply duplicate any of the folders within `ml4a-ofx/apps` and give the folder a custom name. Or work in the folder of the example project if you do not plan to re-use it anyways. +1. Check the `readme.md` file of your project. It always contains the required addons you need to get your app running. Follow the links of each addon, check the installation guide and follow each one. + - Some of the apps need example data to work correctly. As you probably have enough space on your computer anyways, open a terminal window, go into the `ml4a-ofx` folder and run `sh setup.sh`. This will download the necessary data and place it in the `data` folder. + - All addons currently used across the examples are mentioned in the [Addons list](#addons). + - Be careful: Put the required addons into the `addons` subfolder of your `openFrameworks` folder to work correctly. + +### Setup your project + +#### On a Mac + +You can use the `projectGenerator` app that is included in `openFrameworks`. + +- Set the base path to your `openFrameworks` folder as described in the app. This has to be done on the first time only. +- Click on the `create/update` tab +- Import your project by clicking the `import` button, selecting your project's folder. This should be located in your `ml4a-ofx` folder. Your project name, project path and the addons list should update accordingly. If any of the addons is missing, the interface will notify you of that. Since you prepared your project in the above described steps, all should be good here. Otherwise, check the "Prepare your project" part again. +- Click "Update" to get the project setup running. The interface doesn't show it explicitly, but this gets the project generator running. It should™ result in a success message. You can then click "Open in IDE" to directly open the project in XCode. Also, feel free to close the `projectGenerator` again since you don't need it anymore for now. +- Within XCode, wait a few moments to index and process the files of the project. You can then compile the project by pressing the "Play" button or `CMD + R`. +- Cross your fingers :fingers_crossed: and hope your project compiles :wink: + +If you run into any errors: The `openFrameworks setup guides` might have some explanations or possible steps. Otherwise, it always helps to google the error (seriously!) and try to figure out what's going on. In case you get completely stuck, you might find help here by [opening an issue](https://github.com/ml4a/ml4a-ofx/issues/new). Include any error message you find and try to explain the problem as good as possible. This will help resolve any issue a lot. + +#### On Windows + +[Feel free to add documentation here] + +#### On Linux + +[Feel free to add documentation here] \ No newline at end of file