Home | History | Annotate | Download | only in video_GlitchDetection 
      1 # Copyright 2015 The Chromium OS Authors. All rights reserved.
      2 # Use of this source code is governed by a BSD-style license that can be
      3 # found in the LICENSE file.
      4 
      5 AUTHOR = "Mussa Kiroga"
      6 NAME = "video_GlitchDetection_collect_images_chameleon"
      7 PURPOSE = "Collect golden images to be used in video image comparison tests."
      8 CRITERIA = """ """
      9 TIME = "LONG"
     10 TEST_CATEGORY = "General"
     11 TEST_CLASS = "video"
     12 TEST_TYPE = "client"
     13 
     14 DOC = """
     15 To have a sense of the 'quality' of the video playing on a ChromeOS device,
     16 we use image comparison techniques. In it, we collect golden images ahead of
     17 time and during a test on a build we collect test images and compare them
     18 against the golden ones.
     19 
     20 What makes the golden images golden is the build they are collected on. Other
     21 the process of collecting these images is similar to what you would do to
     22 collect test images. So, we are resuing the same code but using this control
     23 file to only collect the images and perform no comparison.
     24 
     25 To collect golden images run a command in this format:
     26 
     27 test_that <ip> video_GlitchDetection_collect_images_chameleon --fast
     28 --args CHAMELEON_HOST=<chameleons_ip>,video_format=mp4,video_def=480p
     29 
     30 You need to supply Chameleon's IP address for the CHAMELEON_HOST argument. Also
     31 change the format and definition to your chosen values.
     32 
     33 After the test is completed, the images will be saved under
     34 /tmp/test/golden_images. Grab those using scp or otherwise.
     35 E.g scp root@DUT's_ip:/tmp/test/golden_images/* ~
     36 
     37 This will also grab the golden_checksum.txt file.
     38 
     39 You will need to upload this text file together with the images into google
     40 storage.
     41 
     42 The parent path to storage is:
     43 pantheon.corp.google.com/storage/browser/chromiumos-test-assets-public/
     44 video_tests/bigbuck/...
     45 
     46 When you get to the parent directory, navigate accordingly based on the format
     47 and the definition you selected.
     48 
     49 """
     50 host = next(iter(job.hosts))
     51 
     52 job.run_test('video_GlitchDetection',
     53               channel='dev',
     54               video_name='bigbuck',
     55               collect_only=True,
     56               use_chameleon=True,
     57               host=host,
     58               args=args)
     59