102 lines
3.6 KiB
Markdown
102 lines
3.6 KiB
Markdown
# Mosaicode
|
|
|
|
A Visual Programming Environment and source code generator for specific domains, focusing on Digital Art.
|
|
|
|
## Getting Started
|
|
|
|
Getting a copy of the project up and running on your local machine. Supported Platform: GNU/Linux.
|
|
|
|
|
|
### Prerequisites
|
|
|
|
Open the terminal (Ctrl+Alt+T) and run the following command to install the software dependencies:
|
|
|
|
```
|
|
sudo apt install python3 python3-gi python3-cairo python3-gi-cairo gir1.2-gtk-3.0 libgirepository1.0-dev python3-dev build-essential pkg-config python3-pip python3-venv
|
|
```
|
|
|
|
**Alternative**: Use the Makefile for automatic installation:
|
|
|
|
```
|
|
make install_full
|
|
```
|
|
|
|
### Installation
|
|
|
|
Steps to install the Mosaicode in a virtual environment or in the operational system directory.
|
|
|
|
|
|
#### Virtual Environment / Isolated from system directories
|
|
|
|
Installing python virtual environment via terminal:
|
|
|
|
```
|
|
sudo apt install python3.8-venv
|
|
```
|
|
|
|
Setting the virtual environment:
|
|
|
|
1. Create the environment: `python3 -m venv <virtual environment name>`
|
|
1. Active the environment: `source <virtual environment path>/<virtual environment name>/bin/activate`
|
|
1. Install prerequisites: `sudo apt install libgirepository1.0-dev gcc libcairo2-dev pkg-config python3-dev`
|
|
1. Install PyGObject: `python -m pip install PyGObject`
|
|
1. Install Mosaicode: `python setup.py install`
|
|
|
|
**Alternative**: Use the Makefile for automatic virtual environment setup:
|
|
|
|
```
|
|
make install_venv
|
|
```
|
|
|
|
More details in the Python 3 *Virtual Environments and Packages* documentation: https://docs.python.org/3/tutorial/venv.html
|
|
|
|
#### Operational System Directories
|
|
|
|
Run via terminal:
|
|
|
|
```
|
|
sudo python setup.py install
|
|
```
|
|
|
|
**Alternative**: Use the Makefile for system installation:
|
|
|
|
```
|
|
make install_full
|
|
```
|
|
|
|
### Useful Makefile Commands
|
|
|
|
- `make help` - Show all available commands
|
|
- `make check_deps` - Check if dependencies are properly installed
|
|
- `make run` - Run Mosaicode in development mode
|
|
- `make run_installed` - Run installed Mosaicode
|
|
- `make test_normal` - Run tests
|
|
- `make clean` - Clean build files
|
|
|
|
## Mosaicode Extensions
|
|
|
|
Some extensions that you can install to add visual programming languages with resources from areas of computing which allow the development of tools to support Digital Art in a simple and practical way: dragging and connecting blocks:
|
|
|
|
|
|
| Technology | Domain | Extension repository | Operating |
|
|
| --- | --- | --- | --- |
|
|
| Javascript / Web Audio API | Computer Music | https://github.com/Alice-ArtsLab/mosaicode-javascript-webaudio | Yes |
|
|
| C / OpenCV | Computer vision | https://github.com/Alice-ArtsLab/mosaicode-c-opencv | No |
|
|
| C / Opengl | Computer graphics | https://github.com/Alice-ArtsLab/mosaicode-c-opengl | No |
|
|
| Javascript / Canvas | Graphics on a web | https://github.com/Alice-ArtsLab/mosaicode-javascript-canvas | No |
|
|
| C / Linux-Joystick | USB Controller | https://github.com/Alice-ArtsLab/mosaicode-c-joystick | No |
|
|
| C / Gtk | GUI | https://github.com/Alice-ArtsLab/mosaicode-c-gtk | No |
|
|
| C / Portaudio | Computer Music | https://github.com/Alice-ArtsLab/mosaicode-c-sound | No |
|
|
|
|
|
|
|
|
## Related pages
|
|
|
|
ALICE. Lab: [https://alice.dcomp.ufsj.edu.br/](https://alice.dcomp.ufsj.edu.br/)
|
|
|
|
## Contact
|
|
|
|
Asking to:
|
|
|
|
* mosaicode-dev@googlegroups.com
|