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