This is the main "local" renderer for Scenic applications.
If you are on a Mac/PC/Linux machine, or building under Nerves, then this is the driver to use to render on the screen connected to the computer Scenic is running on.
This driver replaces both
:scenic_driver_glfw
and
:scenic_driver_nerves_rpi
going forward for Scenic v0.11 and up.
If
available in Hex
, the package can be installed
by adding
scenic_driver_local
to your list of dependencies in
mix.exs
:
def deps do
{:scenic_driver_local, "~> 0.11.0"}
The configuration options for scenic_driver_local are slightly different from scenic_driver_glfw, so you may need to do a little work to bring over your options. Namely, options that pertain to the window under scenic_driver_glfw, aren't relevant to any Nerves build. So they are now under the :window option.
Example:
module: Scenic.Driver.Local,
window: [title: "Local Window", resizeable: true]
There are quite a few new options as well. It uses NimbleOptions to confirm them, so look at the Scenic.Driver.Local module for details.
This driver figures out what underlying graphics technology to use depending on what your MIX_TARGET is set to.
For example, for apps running on a Mac/PC/Linux, it is usually set to host, which causes the driver to use cairo-gtk as the underlying tech.
If you are building for Nerves, it will use cairo-fb
Previous versions of scenic_driver_local would use bcm (Broadcom Manager) for any of rpi, rpi0, rip2, rpi3, and rpi3a and drm for bbb and rpi4.
You can explicitly use these by setting SCENIC_LOCAL_TARGET=bcm or SCENIC_LOCAL_TARGET=drm, but these options are being deprecated.
Please try the default of SCENIC_LOCAL_TARGET=cairo-fb as this should work universally on any Nerves target.
cairo-fb will require that your nerves_system_* has the cairo library selected.
This driver requires Scenic v0.11 or up.
You will need to install XQuartz on macOS.
The easiest way to install needed build time dependencies on MacOS is to use Homebrew. Just run the following in a terminal:
brew update
brew install gtk+3 cairo pkg-config
Once these components have been installed, you should be able to build the scenic_driver_local driver.
The easiest way to install on Ubuntu is to use apt-get. Just run the following:
apt-get update
apt-get install pkgconf libgtk-3-0 libgtk-3-dev libsystemd-dev libwebp-dev libzstd-dev
Once these components have been installed, you should be able to build the scenic_driver_local driver.
The easiest way to install on Arch Linux is to use pacman. Just run the following:
pacman -Syu
sudo pacman -S cairo gtk3
This section needs help updating for cairo support
First, make sure to have installed Visual Studio with its "Desktop development with C++" package.
Next, you need to download the Windows binaries for GLFW and GLEW manually.
Locate your Visual Studio installation directory. Two folders will be required for the next steps:
{Visual Studio Path}\VC\Tools\MSVC\{version number}\include{Visual Studio Path}\VC\Tools\MSVC\{version number}\lib\x64Open the GLFW package you downloaded. Extract the contents of the packaged include folder to your Visual Studio Include folder. Next to the include folder, you'll also find several lib-vc20xx folders. Select the closest match to your Visual Studio version and extract the contents to your Lib folder.
Lastly, install the GLEW package. Find the packaged include folder and extract its contents to your Include folder as well. You should now have two new folders in your Include folder: GL and GLFW. Now navigate to lib\Release\x64 in the GLEW package. Copy all *.lib files to your Lib folder. Finally, navigate to bin\Release\x64 and copy glew32.dll to your Windows\system32 folder.
Once these components have been installed, you should be able to build the scenic_driver_local driver.
Documentation can be found at https://hexdocs.pm/scenic_driver_local.