Image
public struct Image : Encodable
Undocumented
-
Determines whether or not this image is visible.
Declaration
Swift
public var visible: Bool?
-
Specifies the URL of the image to be used.
The URL must be accessible from the domain where the plot code is run, and can be either relative or absolute.
Declaration
Swift
public var source: String?
-
Specifies whether images are drawn below or above traces.
When
xref
andyref
are both set topaper
, image is drawn below the entire plot area.Declaration
Swift
public var layer: ShapeLayer?
-
Sets the image container size horizontally.
The image will be sized based on the
position
value. Whenxref
is set topaper
, units are sized relative to the plot width. Whenxref
ends withdomain
, units are sized relative to the axis width.Declaration
Swift
public var xSize: Double?
-
Sets the image container size vertically.
The image will be sized based on the
position
value. Whenyref
is set topaper
, units are sized relative to the plot height. Whenyref
ends withdomain
, units are sized relative to the axis height.Declaration
Swift
public var ySize: Double?
-
Specifies which dimension of the image to constrain.
See moreDeclaration
Swift
public enum Sizing : String, Encodable
-
Specifies which dimension of the image to constrain.
Declaration
Swift
public var sizing: Sizing?
-
Sets the opacity of the image.
Declaration
Swift
public var opacity: Double?
-
Sets the image’s x position.
When
xref
is set topaper
, units are sized relative to the plot height. Seexref
for more infoDeclaration
Swift
public var x: Anything?
-
Sets the image’s y position.
When
yref
is set topaper
, units are sized relative to the plot height. Seeyref
for more infoDeclaration
Swift
public var y: Anything?
-
Sets the anchor for the x position
Declaration
Swift
public var xAnchor: XAnchor?
-
Sets the anchor for the y position.
Declaration
Swift
public var yAnchor: YAnchor?
-
Sets the images’s x coordinate axis.
If set to a x axis id (e.g. x or x2), the
x
position refers to a x coordinate. If set to paper, thex
position refers to the distance from the left of the plotting area in normalized coordinates where 0 (1) corresponds to the left (right). If set to a x axis ID followed by domain (separated by a space), the position behaves like for paper, but refers to the distance in fractions of the domain length from the left of the domain of that axis: e.g., x2 domain refers to the domain of the second x axis and a x position of 0.5 refers to the point between the left and the right of the domain of the second x axis.Declaration
Swift
public var xReference: XAxisReference?
-
Sets the images’s y coordinate axis.
If set to a y axis id (e.g. y or y2), the
y
position refers to a y coordinate. If set to paper, they
position refers to the distance from the bottom of the plotting area in normalized coordinates where 0 (1) corresponds to the bottom (top). If set to a y axis ID followed by domain (separated by a space), the position behaves like for paper, but refers to the distance in fractions of the domain length from the bottom of the domain of that axis: e.g., y2 domain refers to the domain of the second y axis and a y position of 0.5 refers to the point between the bottom and the top of the domain of the second y axis.Declaration
Swift
public var yReference: YAxisReference?
-
When used in a template, named items are created in the output figure in addition to any items the figure already has in this array.
You can modify these items in the output figure by making your own item with
templateitemname
matching thisname
alongside your modifications (includingvisible: false
orenabled: false
to hide it). Has no effect outside of a template.Declaration
Swift
public var name: String?
-
Used to refer to a named item in this array in the template.
Named items from the template will be created even without a matching item in the input figure, but you can modify one by making an item with
templateitemname
matching itsname
, alongside your modifications (includingvisible: false
orenabled: false
to hide it). If there is no template or no matching item, this item will be hidden unless you explicitly show it withvisible: true
.Declaration
Swift
public var templateItemName: String?
-
init(visible:
source: layer: xSize: ySize: sizing: opacity: x: y: xAnchor: yAnchor: xReference: yReference: name: templateItemName: ) Creates
Image
object with specified properties.Declaration
Swift
public init(visible: Bool? = nil, source: String? = nil, layer: ShapeLayer? = nil, xSize: Double? = nil, ySize: Double? = nil, sizing: Sizing? = nil, opacity: Double? = nil, x: Anything? = nil, y: Anything? = nil, xAnchor: XAnchor? = nil, yAnchor: YAnchor? = nil, xReference: XAxisReference? = nil, yReference: YAxisReference? = nil, name: String? = nil, templateItemName: String? = nil)
Parameters
visible
Determines whether or not this image is visible.
source
Specifies the URL of the image to be used.
layer
Specifies whether images are drawn below or above traces.
xSize
Sets the image container size horizontally.
ySize
Sets the image container size vertically.
sizing
Specifies which dimension of the image to constrain.
opacity
Sets the opacity of the image.
x
Sets the image’s x position.
y
Sets the image’s y position.
xAnchor
Sets the anchor for the x position
yAnchor
Sets the anchor for the y position.
xReference
Sets the images’s x coordinate axis.
yReference
Sets the images’s y coordinate axis.
name
When used in a template, named items are created in the output figure in addition to any items the figure already has in this array.
templateItemName
Used to refer to a named item in this array in the template.