Home | History | Annotate | Download | only in graphics 
      1 page.title=OpenGL ES testing
      2 @jd:body
      3 
      4 <!--
      5     Copyright 2015 The Android Open Source Project
      6 
      7     Licensed under the Apache License, Version 2.0 (the "License");
      8     you may not use this file except in compliance with the License.
      9     You may obtain a copy of the License at
     10 
     11         http://www.apache.org/licenses/LICENSE-2.0
     12 
     13     Unless required by applicable law or agreed to in writing, software
     14     distributed under the License is distributed on an "AS IS" BASIS,
     15     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     16     See the License for the specific language governing permissions and
     17     limitations under the License.
     18 -->
     19 
     20 <div id="qv-wrapper">
     21   <div id="qv">
     22     <h2>In this document</h2>
     23     <ol id="auto-toc">
     24     </ol>
     25   </div>
     26 </div>
     27 
     28 
     29 <p>This page provides an overview of the GPU testing suite
     30 called deqp (drawElements Quality Program).</p>
     31 
     32 <p>You can access the code for deqp in AOSP at the following location: <a href="https://android.googlesource.com/platform/external/deqp">https://android.googlesource.com/platform/external/deqp</a></p>
     33 
     34 <p>To work with the latest submitted code, use the <code>deqp-dev</code> branch. If you want the code that matches the Android 5.0 CTS release, use the <code>lollipop-release</code> branch. </p>
     35 
     36 <h2 id=deploying_deqp>Deploying deqp</h2>
     37 
     38 <p>To deploy the deqp test suite to a new environment, please review the deqp information regarding the following: </p>
     39    
     40 <ul>
     41   <li>Building test programs
     42   <li>Porting the test framework (optional, depending on the target platform)
     43   <li>Running the tests 
     44   <li>Automating the tests 
     45   <li>Using special test groups 
     46   <li>Integrating with Android CTS
     47 </ul>
     48 
     49 <h2 id=source_layout>Source layout</h2>
     50 
     51 <p>The source code layout for the deqp test modules and supporting libraries is shown in the table below. The listing is not complete but highlights the most important directories.</p>
     52 
     53 <table>
     54  <tr>
     55    <th>Directory</th>
     56    <th>Description</th>
     57  </tr>
     58  <tr>
     59     <td><code>android</code></td>
     60     <td><p>Android tester sources and build scripts</p></td>
     61  </tr>
     62  <tr>
     63     <td><code>data</code></td>
     64 <td><p>Test data files</p>
     65 </td>
     66  </tr>
     67  <tr>
     68     <td><code>modules</code></td>
     69 <td><p>Test module sources</p>
     70 </td>
     71  </tr>
     72  <tr>
     73     <td><code>
     74         modules/egl</code></td>
     75 <td><p>EGL module</p>
     76 </td>
     77  </tr>
     78  <tr>
     79     <td><code>
     80         modules/gles2</code></td>
     81 <td><p>GLES2 module</p>
     82 </td>
     83  </tr>
     84  <tr>
     85     <td><code>
     86         modules/gles3</code></td>
     87 <td><p>GLES3 module</p>
     88 </td>
     89  </tr>
     90  <tr>
     91     <td><code>
     92         modules/gles31</code></td>
     93 <td><p>GLES3.1 module</p>
     94 </td>
     95  </tr>
     96  <tr>
     97     <td><code>targets</code></td>
     98 <td><p>Target-specific build configuration files</p>
     99 </td>
    100  </tr>
    101  <tr>
    102     <td><code>framework</code></td>
    103 <td><p>deqp test module framework and utilities</p>
    104 </td>
    105  </tr>
    106  <tr>
    107     <td><code>
    108         framework/delibs</code></td>
    109 <td><p>Base portability and build libraries</p>
    110 </td>
    111  </tr>
    112  <tr>
    113     <td><code>
    114         framework/platform</code></td>
    115 <td><p>Platform ports</p>
    116 </td>
    117  </tr>
    118  <tr>
    119     <td><code>
    120         framework/qphelper</code></td>
    121 <td><p>Test program integration library (C)</p>
    122 </td>
    123  </tr>
    124  <tr>
    125     <td><code>
    126         framework/common</code></td>
    127 <td><p>Deqp framework (C++)</p>
    128 </td>
    129  </tr>
    130  <tr>
    131     <td><code>
    132         framework/opengl, framework/egl</code></td>
    133 <td><p>API-specific utilities</p>
    134 </td>
    135  </tr>
    136  <tr>
    137     <td><code>
    138 execserver</code></td>
    139 <td><p>Device-side ExecServer source</p>
    140 </td>
    141  </tr>
    142  <tr>
    143     <td><code>
    144 executor</code></td>
    145 <td><p>Host-side test executor shell tool and utilities</p>
    146 </td>
    147  </tr>
    148  <tr>
    149     <td><code>
    150 external</code></td>
    151 <td><p>Build stub directory for external libs libpng and zlib</p>
    152 </td>
    153  </tr>
    154 </table>
    155 
    156 <h3 id=open-source_components>Open Source components</h3>
    157 
    158 <p>The deqp uses <code>libpng</code> and <code>zlib</code>. They can be fetched from the web with the script <code>external/fetch_sources.py </code>or with git pulls from git repositories <code>platform/external/[libpng,zlib]</code>.</p>
    159