1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
|
# Using a custom OpenGL Library under Windows
## Tested OpenGL Libraries
- [Mesa3D by pal1000](https://github.com/pal1000/mesa-dist-win/releases)
## Common
To allow using software rendering (not D3D) w/ Mesa3D:
- `set LIBGL_ALWAYS_SOFTWARE=true`
## AWT's Direct Draw Usage
To disable Direct Draw usage within AWT's Java2D:
- pass JVM argument `"-Dsun.java2d.noddraw=true"`
## AWT's OpenGL Usage
To disable OpenGL usage within AWT's Java2D:
- pass JVM argument `"-Dsun.java2d.opengl=false"`
This is required if using the zero deployment method,
i.e. avoiding having the JVM load a different OpenGL library.
## Systemwide Deployment
To using software rendering (not D3D) w/ Mesa3D and Java's AWT:
- `set LIBGL_ALWAYS_SOFTWARE=true`
- pass JVM argument `"-Dsun.java2d.noddraw=true"`
## Zero Deployment
### Using `PATH` environment variable
To pick up the custom library from its random path and
using software rendering (not D3D) w/ Mesa3D and Java's AWT:
- `set PATH=C:\Mesa3D\x64;%PATH%`
- `set LIBGL_ALWAYS_SOFTWARE=true`
- pass JVM argument `"-Dsun.java2d.noddraw=true" "-Dsun.java2d.opengl=false"`
See `AWT's OpenGL Usage` remarks above.
### Using `jogamp.primary.library.path` property at runtime
The OpenGL implementation can also be selected at runtime
before the OpenGL library has loaded, i.e. before JOGL's initialization.
One can set the new property `jogamp.primary.library.path` containing
the usual OS path-separated paths to search for a custom OpenGL library.
```
System.setProperty("jogamp.primary.library.path", "C:\\Mesa3D\x64");
```
In this case, the `PATH` can be left untouched.
See `AWT's OpenGL Usage` remarks above.
## Per Application Deployment
Same as `Zero Deployment`, but `PATH` setting can be skipped.
|
