Skip to content

Commit a3d7f93

Browse files
docs: Tune image injection docs
1 parent 77c9e59 commit a3d7f93

File tree

1 file changed

+4
-1
lines changed

1 file changed

+4
-1
lines changed

README.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -127,7 +127,7 @@ appium:avdEnv | Mapping of emulator [environment variables](https://developer.an
127127
appium:networkSpeed | Sets the desired network speed limit for the emulator. It is only applied if the emulator is not running before the test starts. See emulator [command line arguments](https://developer.android.com/studio/run/emulator-commandline) description for more details.
128128
appium:gpsEnabled | Sets whether to enable (`true`) or disable (`false`) GPS service in the Emulator. Unset by default, which means to not change the current value
129129
appium:isHeadless | If set to `true` then emulator starts in headless mode (e.g. no UI is shown). It is only applied if the emulator is not running before the test starts. `false` by default.
130-
appium:injectedImageProperties | Allows adjusting of injected image properties, like size, position or rotation. The image itself is expected to be injected by [mobile: injectEmulatorCameraImage](#mobile-injectemulatorcameraimage) extension. It is also mandatory to provide this capability if you are going to use the injection feature on a newly created/resetted emulator as it __enforces emulator restart__, so it could properly reload the modified image properties. The value itself is a map, where possible keys are `size`, `position` and `rotation`. All of them are optional. If any of values is not provided then the following defaults are used: `{size: {scaleX: 1, scaleY: 1}, position: {0, 0, -1.5}, rotation: {0, 0, 0}}`. The `size` value contains scale multipliers for X and Y axes. The `position` contains normalized coefficients for X/Y/Z axes, where `0` means it should be centered in the viewport. Values in the `rotation` are measured in degrees respectively for X, Y and Z axis. The capability is available since the driver version 3.6.0.
130+
appium:injectedImageProperties | Allows adjusting of injected image properties, like size, position or rotation. The image itself is expected to be injected by [mobile: injectEmulatorCameraImage](#mobile-injectemulatorcameraimage) extension. It is also mandatory to provide this capability if you are going to use the injection feature on a newly created/resetted emulator as it __enforces emulator restart__, so it could properly reload the modified image properties. The value itself is a map, where possible keys are `size`, `position` and `rotation`. All of them are optional. If any of values is not provided then the following defaults are used: `{size: {scaleX: 1, scaleY: 1}, position: {x: 0, y: 0, z: -1.5}, rotation: {x: 0, y: 0, z: 0}}`. The `size` value contains scale multipliers for X and Y axes. The `position` contains normalized coefficients for X/Y/Z axes, where `0` means it should be centered in the viewport. Values in the `rotation` are measured in degrees respectively for X, Y and Z axis. The capability is available since the driver version 3.6.0.
131131

132132
### App Signing
133133

@@ -1509,10 +1509,12 @@ It is mandatory to provide a value (it could also be an empty map to use default
15091509
the [appium:injectedImageProperties capability](#emulator-android-virtual-device)
15101510
in order to prepare the emulator for image injection if this extension is used
15111511
on a newly created or resetted device.
1512+
15121513
There is also a possiblity to perform a manual configuration of the necessary preconditions
15131514
if you don't want to restart the emulator on session startup. For that replace the content
15141515
of the `Toren1BD.posters` file located in `$ANDROID_HOME/emulator/resources` folder with the
15151516
following text:
1517+
15161518
```
15171519
poster wall
15181520
size 2 2
@@ -1525,6 +1527,7 @@ size 1 1
15251527
position 0 0 -1.5
15261528
rotation 0 0 0
15271529
```
1530+
15281531
Save the changed file and re(start) the emulator to pick up the changes.
15291532
You may also customize values for different image properties under `poster table` in the above
15301533
text snippet.

0 commit comments

Comments
 (0)