File: Windows_Custom_OpenGL.html

package info (click to toggle)
libjogl2-java 2.6.0%2Bdfsg-1
links: PTS, VCS
area: main
in suites: forky, sid
size: 57,484 kB
sloc: java: 257,713; ansic: 86,782; xml: 7,914; objc: 4,880; sh: 3,033; cpp: 139; makefile: 50; awk: 46; perl: 27
file content (495 lines) | stat: -rw-r--r-- 10,741 bytes
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" lang="" xml:lang="">
<head>
  <meta charset="utf-8" />
  <meta name="generator" content="pandoc" />
  <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
  <title>Windows_Custom_OpenGL.md</title>
  <style>
        div#header, header
            {

            border-bottom: 1px solid #aaa;
            margin-bottom: 0.5em;
            }

        .title
            {
            text-align: center;
            }

        .author, .date
            {
            text-align: center;
            }

        div#TOC, nav#TOC
            {

            border-bottom: 1px solid #aaa;
            margin-bottom: 0.5em;
            }

        nav#TOC {
          margin-bottom: var(--line-height);

          padding-bottom: 0.5rem;
        }

        nav#TOC input {
          display: none;
        }

        nav#TOC label {
          color: var(--color-link);
          cursor: pointer;
        }

        nav#TOC > ul {
          display: none;
        }

        nav#TOC > input:checked + ul {
          display: block;
        }

        @media print
            {
            div#TOC, nav#TOC
                {

                display: none;
                }
            }

        div.content
            {
                color: #111111;
                font-size: 14px;
                line-height: 1.6;
            }

        div#cgit a
            {
                color: #1212a0;
            }

        div#cgit a.sourceLine
            {
                color: #111111;
            }

        h1, h2, h3, h4, h5, h6
        {
            font-family: "Helvetica Neue", Helvetica, "Liberation Sans", Calibri, Arial, sans-serif;

            page-break-after: avoid;

            margin: 20px 0 10px;
            padding: 0;
        }

        h2 {
            border-bottom: 1px solid #ccc;
        }

        div div
            {

            }

        section section
            {
            margin-left: 2em;
            }

        p {}

        blockquote
            {
            font-style: italic;
            }

        li
            {
            }

        li > p
            {
            margin-top: 1em;
            }

        ul
            {
            }

        ul li
            {
            }

        ol
            {
            }

        ol li
            {
            }

        hr {}

        sub
            {
            }

        sup
            {
            }

        em
            {
            }

        em > em
            {
            font-style: normal;
            }

        strong
            {
            }

        a
            {

            text-decoration: none;
            }

        @media screen
            {
            a:hover
                {

                text-decoration: underline;
                }
            }

        @media print
            {
            a {

                color: black;
                background: transparent;
                }

            a[href^="http://"]:after, a[href^="https://"]:after
                {

                content: " (" attr(href) ") ";
                font-size: 90%;
                }
            }

        img
            {

            vertical-align: middle;
            }

        div.figure
            {

            margin-left: auto;
            margin-right: auto;
            text-align: center;
            font-style: italic;
            }

        p.caption
            {

            }

        pre, code
            {
            background-color: #f8f8f8;

            white-space: pre-wrap;
            white-space: -moz-pre-wrap !important;
            white-space: -pre-wrap;
            white-space: -o-pre-wrap;
            word-wrap: break-word;

            }

        pre
            {

            padding: 0.5em;
            border-radius: 5px;

            background-color: #f8f8f8;
            border: 1px solid #ccc;
            font-size: 13px;
            line-height: 19px;
            overflow: auto;
            padding: 6px 10px;

            margin-left: 0.5em;
            margin-right: 0.5em;
            }

        @media screen
            {
            pre
                {

                white-space: pre;
                overflow: auto;

                border: 1px dotted #777;
                }
            }

        code
            {
            }

        p > code, li > code
            {

            padding-left: 2px;
            padding-right: 2px;
            }

        li > p code
            {

            padding: 2px;
            }

        span.math
            {

            }

        div.math
            {
            }

        span.LaTeX
            {
            }

        eq
            {
            }

        table
            {
            border-collapse: collapse;
            border-spacing: 0;

            margin-left: auto;
            margin-right: auto;
            }

        thead
            {
            border-bottom: 1pt solid #000;
            background-color: #eee;
            }

        tr.header
            {
            }

        tbody
            {
            }

        tr {
            }
        tr.odd:hover, tr.even:hover
            {
            background-color: #eee;
            }

        tr.odd {}
        tr.even {}

        td, th
            {
            vertical-align: top;
            vertical-align: baseline;
            padding-left: 0.5em;
            padding-right: 0.5em;
            padding-top: 0.2em;
            padding-bottom: 0.2em;
            }
        th
            {
            font-weight: bold;
            }

        tfoot
            {
            }

        caption
            {
            caption-side: top;
            border: none;
            font-size: 0.9em;
            font-style: italic;
            text-align: center;
            margin-bottom: 0.3em;
            padding-bottom: 0.2em;
            }

        dl
            {
            border-top: 2pt solid black;
            padding-top: 0.5em;
            border-bottom: 2pt solid black;
            }

        dt
            {
            font-weight: bold;
            }

        dd+dt
            {
            border-top: 1pt solid black;
            padding-top: 0.5em;
            }

        dd
            {
            margin-bottom: 0.5em;
            }

        dd+dd
            {
            border-top: 1px solid black;
            }

        a.footnote, a.footnoteRef {
            font-size: small;
            vertical-align: text-top;
        }

        a[href^="#fnref"], a.reversefootnote
            {
            }

        @media print
            {
            a[href^="#fnref"], a.reversefootnote
                {

                display: none;
                }
            }

        div.footnotes
            {
            }

        div.footnotes li[id^="fn"]
            {
            }

        @media print
            {
            .noprint
                {
                display:none;
                }
            }
      </style>
</head>
<body>
<nav id="TOC" role="doc-toc">
    <strong>Contents</strong><label for="contents">⊕</label>
  <input type="checkbox" id="contents">
  <ul>
  <li><a href="#using-a-custom-opengl-library-under-windows">Using a
  custom OpenGL Library under Windows</a>
  <ul>
  <li><a href="#tested-opengl-libraries">Tested OpenGL
  Libraries</a></li>
  <li><a href="#common">Common</a></li>
  <li><a href="#awts-direct-draw-usage">AWT’s Direct Draw Usage</a></li>
  <li><a href="#awts-opengl-usage">AWT’s OpenGL Usage</a></li>
  <li><a href="#systemwide-deployment">Systemwide Deployment</a></li>
  <li><a href="#zero-deployment">Zero Deployment</a>
  <ul>
  <li><a href="#using-path-environment-variable">Using <code>PATH</code>
  environment variable</a></li>
  <li><a
  href="#using-jogamp.primary.library.path-property-at-runtime">Using
  <code>jogamp.primary.library.path</code> property at runtime</a></li>
  </ul></li>
  <li><a href="#per-application-deployment">Per Application
  Deployment</a></li>
  </ul></li>
  </ul>
</nav>
<h1 id="using-a-custom-opengl-library-under-windows">Using a custom
OpenGL Library under Windows</h1>
<h2 id="tested-opengl-libraries">Tested OpenGL Libraries</h2>
<ul>
<li><a href="https://github.com/pal1000/mesa-dist-win/releases">Mesa3D
by pal1000</a></li>
</ul>
<h2 id="common">Common</h2>
<p>To allow using software rendering (not D3D) w/ Mesa3D:</p>
<ul>
<li><code>set LIBGL_ALWAYS_SOFTWARE=true</code></li>
</ul>
<h2 id="awts-direct-draw-usage">AWT’s Direct Draw Usage</h2>
<p>To disable Direct Draw usage within AWT’s Java2D:</p>
<ul>
<li>pass JVM argument <code>"-Dsun.java2d.noddraw=true"</code></li>
</ul>
<h2 id="awts-opengl-usage">AWT’s OpenGL Usage</h2>
<p>To disable OpenGL usage within AWT’s Java2D:</p>
<ul>
<li>pass JVM argument <code>"-Dsun.java2d.opengl=false"</code></li>
</ul>
<p>This is required if using the zero deployment method, i.e. avoiding
having the JVM load a different OpenGL library.</p>
<h2 id="systemwide-deployment">Systemwide Deployment</h2>
<p>To using software rendering (not D3D) w/ Mesa3D and Java’s AWT:</p>
<ul>
<li><code>set LIBGL_ALWAYS_SOFTWARE=true</code></li>
<li>pass JVM argument <code>"-Dsun.java2d.noddraw=true"</code></li>
</ul>
<h2 id="zero-deployment">Zero Deployment</h2>
<h3 id="using-path-environment-variable">Using <code>PATH</code>
environment variable</h3>
<p>To pick up the custom library from its random path and using software
rendering (not D3D) w/ Mesa3D and Java’s AWT:</p>
<ul>
<li><code>set PATH=C:\Mesa3D\x64;%PATH%</code></li>
<li><code>set LIBGL_ALWAYS_SOFTWARE=true</code></li>
<li>pass JVM argument
<code>"-Dsun.java2d.noddraw=true" "-Dsun.java2d.opengl=false"</code></li>
</ul>
<p>See <code>AWT's OpenGL Usage</code> remarks above.</p>
<h3 id="using-jogamp.primary.library.path-property-at-runtime">Using
<code>jogamp.primary.library.path</code> property at runtime</h3>
<p>The OpenGL implementation can also be selected at runtime before the
OpenGL library has loaded, i.e. before JOGL’s initialization.</p>
<p>One can set the new property <code>jogamp.primary.library.path</code>
containing the usual OS path-separated paths to search for a custom
OpenGL library.</p>
<pre><code>  System.setProperty(&quot;jogamp.primary.library.path&quot;, &quot;C:\\Mesa3D\x64&quot;);</code></pre>
<p>In this case, the <code>PATH</code> can be left untouched.</p>
<p>See <code>AWT's OpenGL Usage</code> remarks above.</p>
<h2 id="per-application-deployment">Per Application Deployment</h2>
<p>Same as <code>Zero Deployment</code>, but <code>PATH</code> setting
can be skipped.</p>
</body>
</html>