View source for Using Phonebot display properties

Scripts can access display properties for modules and controls.

Methods

{|class="wikitable sortable"
|-
!Syntax
!Description
|-
|<code>value = get_display(group, property)</code>
|
|-
|<code>set_display(group, property, value)</code>
|
|}

The following groups and properties are valid:

{|class="wikitable sortable"
|-
!Group
!Property
!Description
|-
|<code>background</code>
|<code>color</code>
|An ARGB value, see [http://developer.android.com/reference/android/graphics/Color.html Color]
|-
|<code>font</code>
|<code>bold</code>
|boolean
|-
|
|<code>color</code>
|An ARGB value, see [http://developer.android.com/reference/android/graphics/Color.html Color]
|-
|
|<code>italic</code>
|boolean
|-
|
|<code>name</code>
|monospace, normal (default), sans, serif
|-
|
|<code>size</code>
|
|-
|<code>image</code>
|<code>scale</code>
|see below
|-
|
|<code>source</code>
|URL or path to image
|-
|
|<code>storage</code>
|see below
|-
|<code>padding</code>
|<code>bottom</code>
|
|-
|
|<code>left</code>
|
|-
|
|<code>right</code>
|
|-
|
|<code>top</code>
|
|}

Image properties are available for the [[Phonebot_developer%27s_reference/Object_reference#Image|image control]]. This control can display an image either from a URL or from the local file system.

The image can be stored in the following ways:

{|class="wikitable sortable"
|-
!Name
!Value
!Description
|-
|Link
|link
|Always display the image located at the URL or directory.
|-
|Link with copy
|link_copy
|Display the linked image and store a local copy If the image is no longer available, the copy will be displayed.
|-
|Copy
|copy
|Always use a local copy.
|}

The image can be scaled with the following methods:

{|class="wikitable sortable"
|-
!Name
!Value
!Description
|-
|Center
|center
|Center the image in the view, but perform no scaling. 
|-
|Center crop
|center_crop
|Scale the image uniformly (maintain the image's aspect ratio) so that both dimensions (width and height) of the image will be equal to or larger than the corresponding dimension of the view (minus padding). 
|-
|Center inside
|center_inside
|Scale the image uniformly (maintain the image's aspect ratio) so that both dimensions (width and height) of the image will be equal to or less than the corresponding dimension of the view (minus padding). 
|-
|Fit center
|fit_center
|Compute a scale that will maintain the original src aspect ratio, but will also ensure that src fits entirely inside dst. At least one axis (X or Y) will fit exactly. The result is centered inside dst.
|-
|Fit end
|fit_end
|Compute a scale that will maintain the original src aspect ratio, but will also ensure that src fits entirely inside dst. At least one axis (X or Y) will fit exactly. END aligns the result to the right and bottom edges of dst.
|-
|Fit start
|fit_start
|Compute a scale that will maintain the original src aspect ratio, but will also ensure that src fits entirely inside dst. At least one axis (X or Y) will fit exactly. START aligns the result to the left and top edges of dst.
|-
|Fit XY
|fit_xy
|Scale in X and Y independently, so that src matches dst exactly. This may change the aspect ratio of the src.
|}

--[http://developer.android.com/reference/android/widget/ImageView.ScaleType.html ImageView.ScaleType]

--[http://developer.android.com/reference/android/graphics/Matrix.ScaleToFit.html Matrix.ScaleToFit]

[[Category:Phonebot]]