Android DDDriverCommands::TakeScreenShot
DRD:DEV TID

Take screenshot and save it to a file on test machine.

Take screenshot and save it to a file on test machine.

Fields: [ ]=Optional with Default Value
  1. FileName
    The file to store the screeshot. (For Android Engine, the screenshot is device/emulator's)

    The file to store the screeshot. (For Android Engine, the screenshot is device/emulator's) It can be a full path name; If it is only a filename, the image will be stored to sub directory "test" of your project; If it is a filename including path-separator, it will be concatanated to the "datapool" of your project to create a fullpath file.

  2. [ Rotatable = ]
    For other Engine, this parameter will be ignored. For Android Engine, if the android application is rotatable, you set this parameter to True. The default is True.

    For other Engine, this parameter will be ignored. For Android Engine, if the android application is rotatable, that is to say the application will adjust its direction and keep upstraight when you rotate your device. If the android application is rotatable and this parameter is set to False, the screenshot maybe upside down.

  3. [ SubArea = ]
    Optional sbuarea indicating partial image of the screen to capture.

    Optional sbuarea indicating partial image of the screen to capture. The value must be in the format of a top-left and bottom-right pair, and can be either absolute coordinates or percentages ("x1,y1,x2,y2" or "x1%,y1%,x2%,y2%"). Coordinates are relative to the screen, i.e. (0,0) and (0%,0%) are the minimum, and (SCREEN_WIDTH, SCREEN_HEIGHT) and (100%,100%) are the maximum. Values exceeding the minimun/ maximum are forced to the nearest limiting value. Absolute and percent values can be mixed, so "0,0,50%,50%" is valid. If this parameter is omitted, full image of the screen is captured (equivalent to "0,0,100%,100%").

Examples:
[How To Read This Reference]