electrosoup.com

git clone git://git.electrosoup.com/electrosoup.com
Log | Files | Refs

index.html (13149B)


      1 <!DOCTYPE html>
      2 <html lang="en-US">
      3 
      4 <head>
      5   <meta http-equiv="X-Clacks-Overhead" content="GNU Terry Pratchett" />
      6   <meta charset="utf-8">
      7   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
      8 <link rel="shortcut icon" href="https://electrosoup.com/favicon.png" />
      9 <title>Unbind Your Vertex Array Objects. | Electrosoup</title>
     10 <meta name="title" content="Unbind Your Vertex Array Objects." />
     11 <meta name="description" content="When I first started learning about OpenGL, I always made sure to unbind each resource as soon as I was done using it. Over time I became more lenient with unbinding, as in many cases leaving resources bound is okay and leads to fewer API calls." />
     12 <meta name="author" content="" />
     13 <meta name="keywords" content="OpenGL,C," />
     14 
     15 
     16 
     17 
     18 
     19 
     20   
     21   <meta property="og:url" content="https://electrosoup.com/posts/unbind/">
     22   <meta property="og:site_name" content="Electrosoup">
     23   <meta property="og:title" content="Unbind Your Vertex Array Objects.">
     24   <meta property="og:description" content="When I first started learning about OpenGL, I always made sure to unbind each resource as soon as I was done using it. Over time I became more lenient with unbinding, as in many cases leaving resources bound is okay and leads to fewer API calls.">
     25   <meta property="og:locale" content="en_US">
     26   <meta property="og:type" content="article">
     27     <meta property="article:section" content="posts">
     28     <meta property="article:published_time" content="2021-08-25T14:33:02-05:00">
     29     <meta property="article:modified_time" content="2021-08-25T14:33:02-05:00">
     30     <meta property="article:tag" content="OpenGL">
     31     <meta property="article:tag" content="C">
     32 
     33 
     34   
     35   
     36   <meta name="twitter:card" content="summary">
     37   <meta name="twitter:title" content="Unbind Your Vertex Array Objects.">
     38   <meta name="twitter:description" content="When I first started learning about OpenGL, I always made sure to unbind each resource as soon as I was done using it. Over time I became more lenient with unbinding, as in many cases leaving resources bound is okay and leads to fewer API calls.">
     39 
     40 
     41   
     42   
     43   <meta itemprop="name" content="Unbind Your Vertex Array Objects.">
     44   <meta itemprop="description" content="When I first started learning about OpenGL, I always made sure to unbind each resource as soon as I was done using it. Over time I became more lenient with unbinding, as in many cases leaving resources bound is okay and leads to fewer API calls.">
     45   <meta itemprop="datePublished" content="2021-08-25T14:33:02-05:00">
     46   <meta itemprop="dateModified" content="2021-08-25T14:33:02-05:00">
     47   <meta itemprop="wordCount" content="397">
     48   <meta itemprop="keywords" content="OpenGL,C">
     49 
     50 
     51   <link href="/herman.min.css" rel="stylesheet">
     52 
     53   
     54     
     55     <link href="/syntax.min.css" rel="stylesheet">
     56   
     57 
     58   
     59 
     60   
     61 </head>
     62 
     63 <body>
     64   <header><a class="skip-link" href="#main-content">Skip to main content</a>
     65 
     66 <nav>
     67   <a href="/">Main</a>
     68 
     69   <a href="/posts/">Posts</a>
     70 
     71   <a href="https://git.electrosoup.com">Code</a>
     72 
     73   <a href="https://christianermann.dev">Resume</a>
     74 
     75 
     76 
     77 
     78 
     79 
     80 
     81 
     82 
     83 </nav>
     84 </header>
     85   <main id="main-content">
     86 
     87 <h1>Unbind Your Vertex Array Objects.</h1>
     88 <p class="byline">
     89   
     90   <time datetime='2021-08-25' pubdate>
     91     2021-08-25
     92   </time>
     93   
     94 </p>
     95 
     96 <content>
     97   <p>When I first started learning about OpenGL, I always made sure to unbind each resource as soon as I was done using it. Over time I became more lenient with unbinding, as in many cases leaving resources bound is okay and leads to fewer API calls.</p>
     98 <p>In addition, when I&rsquo;m developing on my PC I have access to the newer Direct State Access (DSA) functions, so binding resources isn&rsquo;t something I have to worry about as much. However, I do a fair amount of programming on my macbook which means I don&rsquo;t always have access to the DSA functions.</p>
     99 <p>I was working on a project recently that involved the vertex and index data for a mesh frequently changing. The actual mesh struct has a bit more going on, but we can think of it like this for now:</p>
    100 
    101 
    102 
    103 
    104 <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-c" data-lang="c"><span class="line"><span class="ln">1</span><span class="cl"><span class="k">typedef</span> <span class="k">struct</span> <span class="p">{</span>
    105 </span></span><span class="line"><span class="ln">2</span><span class="cl">    <span class="n">Vec3</span> <span class="o">*</span><span class="n">vertices</span><span class="p">;</span>
    106 </span></span><span class="line"><span class="ln">3</span><span class="cl">    <span class="n">GLuint</span> <span class="o">*</span><span class="n">indices</span><span class="p">;</span>
    107 </span></span><span class="line"><span class="ln">4</span><span class="cl">    <span class="n">GLuint</span> <span class="n">vao</span><span class="p">;</span>
    108 </span></span><span class="line"><span class="ln">5</span><span class="cl">    <span class="n">GLuint</span> <span class="n">vbo</span><span class="p">;</span>
    109 </span></span><span class="line"><span class="ln">6</span><span class="cl">    <span class="n">GLuint</span> <span class="n">ebo</span><span class="p">;</span>
    110 </span></span><span class="line"><span class="ln">7</span><span class="cl"><span class="p">}</span> <span class="n">Mesh</span><span class="p">;</span></span></span></code></pre></div>
    111 <p>So when it comes time to update the vertex or index data, we map the vertex buffer object to the vertices pointer and the element buffer object to the indices pointer. Then we can write all of our vertex and index data directly to the buffers, and then unmap them when we&rsquo;re all done and need to draw.</p>
    112 
    113 
    114 
    115 
    116 <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-c" data-lang="c"><span class="line"><span class="ln"> 1</span><span class="cl"><span class="p">...</span>
    117 </span></span><span class="line"><span class="ln"> 2</span><span class="cl">
    118 </span></span><span class="line"><span class="ln"> 3</span><span class="cl"><span class="nf">glBindBuffer</span><span class="p">(</span><span class="n">GL_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">mesh</span><span class="o">-&gt;</span><span class="n">vbo</span><span class="p">);</span>
    119 </span></span><span class="line"><span class="ln"> 4</span><span class="cl"><span class="n">mesh</span><span class="o">-&gt;</span><span class="n">vertices</span> <span class="o">=</span> <span class="nf">glMapBuffer</span><span class="p">(</span><span class="n">GL_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">GL_WRITE_ONLY</span><span class="p">);</span>
    120 </span></span><span class="line"><span class="ln"> 5</span><span class="cl">
    121 </span></span><span class="line"><span class="ln"> 6</span><span class="cl"><span class="nf">glBindBuffer</span><span class="p">(</span><span class="n">GL_ELEMENT_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">mesh</span><span class="o">-&gt;</span><span class="n">ebo</span><span class="p">);</span>
    122 </span></span><span class="line"><span class="ln"> 7</span><span class="cl"><span class="n">mesh</span><span class="o">-&gt;</span><span class="n">indices</span> <span class="o">=</span> <span class="nf">glMapBuffer</span><span class="p">(</span><span class="n">GL_ELEMENT_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">GL_WRITE_ONLY</span><span class="p">);</span>
    123 </span></span><span class="line"><span class="ln"> 8</span><span class="cl">
    124 </span></span><span class="line"><span class="ln"> 9</span><span class="cl"><span class="c1">// While we have the buffers mapped, we can write data directly to
    125 </span></span></span><span class="line"><span class="ln">10</span><span class="cl"><span class="c1">// mesh-&gt;vertices and mesh-&gt;indices.
    126 </span></span></span><span class="line"><span class="ln">11</span><span class="cl"><span class="c1"></span>
    127 </span></span><span class="line"><span class="ln">12</span><span class="cl"><span class="nf">glBindBuffer</span><span class="p">(</span><span class="n">GL_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">mesh</span><span class="o">-&gt;</span><span class="n">vbo</span><span class="p">);</span>
    128 </span></span><span class="line"><span class="ln">13</span><span class="cl"><span class="nf">glUnmapBuffer</span><span class="p">(</span><span class="n">GL_ARRAY_BUFFER</span><span class="p">);</span>
    129 </span></span><span class="line"><span class="ln">14</span><span class="cl"><span class="n">mesh</span><span class="o">-&gt;</span><span class="n">vertices</span> <span class="o">=</span> <span class="nb">NULL</span>
    130 </span></span><span class="line"><span class="ln">15</span><span class="cl">
    131 </span></span><span class="line"><span class="ln">16</span><span class="cl"><span class="nf">glBindBuffer</span><span class="p">(</span><span class="n">GL_ELEMENT_ARRAY_BUFFER</span><span class="p">,</span> <span class="n">mesh</span><span class="o">-&gt;</span><span class="n">ebo</span><span class="p">);</span>
    132 </span></span><span class="line"><span class="ln">17</span><span class="cl"><span class="nf">glUnmapBuffer</span><span class="p">(</span><span class="n">GL_ELEMENT_ARRAY_BUFFER</span><span class="p">);</span>
    133 </span></span><span class="line"><span class="ln">18</span><span class="cl"><span class="n">mesh</span><span class="o">-&gt;</span><span class="n">indices</span> <span class="o">=</span> <span class="nb">NULL</span>
    134 </span></span><span class="line"><span class="ln">19</span><span class="cl">
    135 </span></span><span class="line"><span class="ln">20</span><span class="cl"><span class="c1">// Now that the buffers are unmapped, we can draw the mesh again.
    136 </span></span></span><span class="line"><span class="ln">21</span><span class="cl"><span class="c1"></span>
    137 </span></span><span class="line"><span class="ln">22</span><span class="cl"><span class="p">...</span></span></span></code></pre></div>
    138 <p>Leaving the buffers bound in the above snippet didn&rsquo;t cause problems and seemed a reasonable thing to do to reduce unnecessary OpenGL calls.
    139 The issues I was running into were actually caused by how I was drawing each mesh:</p>
    140 
    141 
    142 
    143 
    144 <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-c" data-lang="c"><span class="line"><span class="ln">1</span><span class="cl"><span class="p">...</span>
    145 </span></span><span class="line"><span class="ln">2</span><span class="cl">
    146 </span></span><span class="line"><span class="ln">3</span><span class="cl"><span class="nf">glBindVertexArray</span><span class="p">(</span><span class="n">mesh</span><span class="o">-&gt;</span><span class="n">vao</span><span class="p">);</span>
    147 </span></span><span class="line"><span class="ln">4</span><span class="cl"><span class="nf">glDrawElements</span><span class="p">(...);</span>
    148 </span></span><span class="line"><span class="ln">5</span><span class="cl">
    149 </span></span><span class="line"><span class="ln">6</span><span class="cl"><span class="p">...</span></span></span></code></pre></div>
    150 <p>Since I wasn&rsquo;t unbinding the mesh&rsquo;s vertex array object when I finished drawing it, when I updated another mesh&rsquo;s vertex or index data and bound that mesh&rsquo;s buffer objects, the vertex array object I forgot to unbind would now be using the incorrect buffers to draw with.</p>
    151 <p>Luckily, there was a simple fix, and now I know to be more careful with unbinding vertex array objects:</p>
    152 
    153 
    154 
    155 
    156 <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-c" data-lang="c"><span class="line"><span class="ln">1</span><span class="cl"><span class="p">...</span>
    157 </span></span><span class="line"><span class="ln">2</span><span class="cl">
    158 </span></span><span class="line"><span class="ln">3</span><span class="cl"><span class="nf">glBindVertexArray</span><span class="p">(</span><span class="n">mesh</span><span class="o">-&gt;</span><span class="n">vao</span><span class="p">);</span>
    159 </span></span><span class="line"><span class="ln">4</span><span class="cl"><span class="nf">glDrawElements</span><span class="p">(...);</span>
    160 </span></span><span class="line"><span class="ln">5</span><span class="cl"><span class="nf">glBindVertexArray</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span>
    161 </span></span><span class="line"><span class="ln">6</span><span class="cl">
    162 </span></span><span class="line"><span class="ln">7</span><span class="cl"><span class="p">...</span></span></span></code></pre></div>
    163 
    164 </content>
    165 <p>
    166   
    167     <a class="blog-tags" href="/tags/opengl/">#opengl</a>
    168   
    169     <a class="blog-tags" href="/tags/c/">#c</a>
    170   
    171 </p>
    172 
    173 
    174   <p>
    175     <a href='mailto:christianermann@gmail.com?subject=Reply%20to%20"Unbind%20Your%20Vertex%20Array%20Objects."'>
    176       Reply to this post by email ↪
    177     </a>
    178   </p>
    179 
    180 
    181 
    182   </main>
    183   <footer><footer>
    184     
    185         <a href="https://git.electrosoup.com">Code</a>.
    186     
    187         <a href="https://christianermann.dev">Resume</a>.
    188     
    189     <a href='https://electrosoup.com/index.xml'>RSS</a>.
    190     <p>Copyright &copy; 2026 Christian Ermann. | Made with <a href="https://github.com/clente/hugo-bearcub">Bear Cub</a></p>
    191 </footer>
    192 </footer>
    193 
    194     
    195 </body>
    196 
    197 </html>