Home | History | Annotate | Download | only in cts
      1 page.title=Rotation Vector CV Crosscheck
      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 <div class="figure" style="width:214px">
     20   <img src="images/acircles_pattern_reduced.png" alt="Test pattern thumbnail" height="166" />
     21   <p class="img-caption">
     22     <strong>Figure 1.</strong> Thumbnail of test pattern. Download the
     23 full-resolution image linked above.
     24   </p>
     25 </div>
     26 <p>This page provides the steps to properly test the compatibility of your <a
     27 href="https://source.android.com/devices/sensors/sensor-types.html#rotation_vector">rotation
     28 vector sensor</a> implementation. This test should be run when the device declares
     29 the TYPE_ROTATION_VECTOR composite sensor feature.</p>
     30 
     31 <ol>
     32   <li>Install OpenCV Manager on the Android device being tested. You may choose one
     33 the following options:
     34     <ul>
     35     <li>Install from <a
     36 href="https://play.google.com/store/apps/details?id=org.opencv.engine">Google
     37 Play</a>; search for <em>OpenCV Manager</em> in Google Play if this link is
     38 outdated.
     39     <li>Install from OpenCV SDK from <a
     40 href="http://opencv.org/downloads.html">OpenCV.org</a>. Please choose
     41 <strong>OpenCV for Android</strong> with version 3.0.0. You will find the APK
     42 from the <code>apk</code> folder inside the downloaded archive. Please consult <a
     43 href="http://developer.android.com/tools/help/adb.html#move">installing an
     44 application</a> for the command to load APKs onto the Android device from
     45 computer.
     46   </ul>
     47   <li>Print out the linked <a href="images/acircles_pattern.png">test pattern</a>,
     48 disabling any scaling options when printing. The pattern should fit US
     49 Letter paper in landscape or anything bigger.
     50 <p class="note"><strong>Note:</strong> The inline picture above is low
     51 resolution and just for illustration. Please do not directly print it as your
     52 pattern.</p>
     53   <li>Place the pattern on a horizontal surface.
     54   <li>Start the <strong>Rotation Vector CV Crosscheck</strong> in the CTS Verifier
     55 app. Follow the guide to turn on airplane mode, turn off auto rotate, and
     56 adjust adaptive brightness and location if these changes have
     57 not been made.<br />
     58   <img src="images/RVCVXCheck_start.png" alt="Test initiation" height="533" id="test-start" />
     59   <p class="img-caption">
     60     <strong>Figure 2.</strong> Initiating the test.
     61   </p>
     62   <li>When the video preview appears, place the phone three feet (or one meter) over
     63 the pattern so the main camera is facing the pattern with yellow marker on the
     64 screen and yellow marker on the pattern aligned at the same corner.<br />
     65 <img src="images/RVCVXCheck_down.png" alt="Test pattern placement" height="207" id="test-pattern-placement" />
     66   <p class="img-caption">
     67     <strong>Figure 3.</strong> Placing the test pattern.
     68   </p>
     69   <li>While keeping the pattern entirely in the camera view, rotate the Android
     70 device under test (DUT) around the pattern in three different directions, one
     71 by one (1, 2 and then 3 illustrated in picture below) as prompted by the
     72 rotation range indicator. Keep movement smooth and steady for the best result.<br />
     73   <img src="images/RVCVXCheck_flow.png" alt="Device movement" height="426" id="device-movement" />
     74   <p class="img-caption">
     75     <strong>Figure 4.</strong> Manipulating the device under test.
     76   </p>
     77   <li>After the capture, the camera preview will disappear and the analysis process
     78 will start. Wait patiently for analysis to finish; it usually takes one to five
     79 minutes depending on the phone performance. The phone will sound and vibrate at
     80 analysis completion. A numerical result will be presented on screen if the
     81 analysis is successful.<br />
     82   <img src="images/RVCVXCheck_next.png" alt="Test completion" height="533" id="test-complete"/>
     83   <p class="img-caption">
     84     <strong>Figure 5.</strong> Finishing the test.
     85   </p>
     86   <li>Click <strong>next</strong> to proceed to the pass/fail screen and review the result.<br />
     87   <img src="images/RVCVXCheck_pass.png" alt="Test success" height="533" id="test-success" />
     88   <p class="img-caption">
     89     <strong>Figure 6.</strong> Passing the test.
     90   </p>
     91 <li>Follow these tips for best results:
     92   <ol>
     93     <li>Since this is a manual test with complexity, you may want to try it a few times
     94 for the best results.
     95     <li>Accelerometer, gyroscope, and magnetometer should be calibrated before testing
     96 for good results.
     97     <li>See this <a href="https://www.youtube.com/watch?v=MsDVmsH1PaI">video
     98 tutorial</a> for additional details.
     99   </ol>
    100 </ol>
    101