Getting Started

Installation

The recommended way to install compas_view2 is with conda.

conda create -n view2 -c conda-forge compas compas_view2 --yes
conda activate view2

First Steps

Have a look at the examples for basic usage scenarios.

Dev Install

To get the latest unreleased version, you can install with pip in a conda environment directly from the github repo.

Windows

conda create -n view2 python=3.8 git cython freeglut --yes
conda activate view2
pip install git+https://github.com/compas-dev/compas_view2.git#egg=compas_view2

Mac

conda create -n view2 python=3.8 cython python.app --yes
conda activate view2
pip install git+https://github.com/compas-dev/compas_view2.git#egg=compas_view2

By installing python.app you can use pythonw to run the viewers instead of python. This ensures that all components work as expected.

To configure VS Code to use pythonw, change the python path in the settings of the workspace. In .vscode/settings.json

{
    ...

    "python.pythonPath": "/Users/xxx/anaconda3/envs/view2/bin/pythonw"

    ...
}

Linux

conda create -n view2 python=3.8 cython freetype-py --yes
conda activate view2
pip install git+https://github.com/compas-dev/compas_view2.git#egg=compas_view2