pub struct Image<'a> { /* private fields */ }
Expand description
Display an image, i.e. data on a 2D regular raster. By default, when an image is displayed in a subplot, its y axis will be reversed (ie. autorange: 'reversed'
), constrained to the domain (ie. constrain: 'domain'
) and it will have the same scale as its x axis (ie. scaleanchor: 'x,
) in order for pixels to be rendered as squares.
Implementations§
Source§impl<'a> Image<'a>
impl<'a> Image<'a>
Sourcepub fn visible(&mut self, visible: Visible) -> &mut Self
pub fn visible(&mut self, visible: Visible) -> &mut Self
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
default: true
Sourcepub fn name(&mut self, name: &'a str) -> &mut Self
pub fn name(&mut self, name: &'a str) -> &mut Self
Sets the trace name. The trace name appear as the legend item and on hover.
Sourcepub fn uid(&mut self, uid: &'a str) -> &mut Self
pub fn uid(&mut self, uid: &'a str) -> &mut Self
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Sourcepub fn ids(&mut self, ids: &'a [&'a str]) -> &mut Self
pub fn ids(&mut self, ids: &'a [&'a str]) -> &mut Self
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sourcepub fn meta(&mut self, meta: Any) -> &mut Self
pub fn meta(&mut self, meta: Any) -> &mut Self
Assigns extra meta information associated with this trace that can be used in various text attributes. Attributes such as trace name
, graph, axis and colorbar title.text
, annotation text
rangeselector
, updatemenues
and sliders
label
text all support meta
. To access the trace meta
values in an attribute in the same trace, simply use %{meta[i]}
where i
is the index or key of the meta
item in question. To access trace meta
in layout attributes, use %{data[n[.meta[i]}
where i
is the index or key of the meta
and n
is the trace index.
pub fn hoverlabel(&mut self) -> &mut Hoverlabel<'a>
pub fn stream(&mut self) -> &mut Stream<'a>
Sourcepub fn uirevision(&mut self, uirevision: Any) -> &mut Self
pub fn uirevision(&mut self, uirevision: Any) -> &mut Self
Controls persistence of some user-driven changes to the trace: constraintrange
in parcoords
traces, as well as some editable: true
modifications such as name
and colorbar.title
. Defaults to layout.uirevision
. Note that other user-driven trace attribute changes are controlled by layout
attributes: trace.visible
is controlled by layout.legend.uirevision
, selectedpoints
is controlled by layout.selectionrevision
, and colorbar.(x|y)
(accessible with config: {editable: true}
) is controlled by layout.editrevision
. Trace changes are tracked by uid
, which only falls back on trace index if no uid
is provided. So if your app can add/remove traces before the end of the data
array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid
that stays with it as it moves.
Sourcepub fn z(&mut self, z: &'a [f64]) -> &mut Self
pub fn z(&mut self, z: &'a [f64]) -> &mut Self
A 2-dimensional array in which each element is an array of 3 or 4 numbers representing a color.
Sourcepub fn colormodel(&mut self, colormodel: Colormodel) -> &mut Self
pub fn colormodel(&mut self, colormodel: Colormodel) -> &mut Self
Color model used to map the numerical color components described in z
into colors.
default: rgb
Sourcepub fn zmin(&mut self, zmin: &'a InfoArray) -> &mut Self
pub fn zmin(&mut self, zmin: &'a InfoArray) -> &mut Self
Array defining the lower bound for each color component. Note that the default value will depend on the colormodel. For the rgb
colormodel, it is [0, 0, 0]. For the rgba
colormodel, it is [0, 0, 0, 0]. For the hsl
colormodel, it is [0, 0, 0]. For the hsla
colormodel, it is [0, 0, 0, 0].
Sourcepub fn zmax(&mut self, zmax: &'a InfoArray) -> &mut Self
pub fn zmax(&mut self, zmax: &'a InfoArray) -> &mut Self
Array defining the higher bound for each color component. Note that the default value will depend on the colormodel. For the rgb
colormodel, it is [255, 255, 255]. For the rgba
colormodel, it is [255, 255, 255, 1]. For the hsl
colormodel, it is [360, 100, 100]. For the hsla
colormodel, it is [360, 100, 100, 1].
Sourcepub fn text(&mut self, text: &'a [f64]) -> &mut Self
pub fn text(&mut self, text: &'a [f64]) -> &mut Self
Sets the text elements associated with each z value.
Sourcepub fn hoverinfo(&mut self) -> &mut Hoverinfo
pub fn hoverinfo(&mut self) -> &mut Hoverinfo
Determines which trace information appear on hover. If none
or skip
are set, no information is displayed upon hovering. But, if none
is set, click and hover events are still fired.
default: x+y+z+text+name
Sourcepub fn hovertemplate(&mut self, hovertemplate: &'a str) -> &mut Self
pub fn hovertemplate(&mut self, hovertemplate: &'a str) -> &mut Self
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo
. Variables are inserted using %{variable}, for example “y: %{y}”. Numbers are formatted using d3-format’s syntax %{variable:d3-format}, for example “Price: %{y:$.2f}”. https://github.com/d3/d3-3.x-api-reference/blob/master/Formatting.md#d3_format for details on the formatting syntax. Dates are formatted using d3-time-format’s syntax %{variable|d3-time-format}, for example “Day: %{2019-01-01|%A}”. https://github.com/d3/d3-3.x-api-reference/blob/master/Time-Formatting.md#format for details on the date formatting syntax. The variables available in hovertemplate
are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true
) are available. variables z
, color
and colormodel
. Anything contained in tag <extra>
is displayed in the secondary box, for example “<extra></extra>
.
default: ``
Sourcepub fn xaxis(&mut self, xaxis: &'a str) -> &mut Self
pub fn xaxis(&mut self, xaxis: &'a str) -> &mut Self
Sets a reference between this trace’s x coordinates and a 2D cartesian x axis. If x (the default value), the x coordinates refer to layout.xaxis
. If x2, the x coordinates refer to layout.xaxis2
, and so on.
default: x
Sourcepub fn yaxis(&mut self, yaxis: &'a str) -> &mut Self
pub fn yaxis(&mut self, yaxis: &'a str) -> &mut Self
Sets a reference between this trace’s y coordinates and a 2D cartesian y axis. If y (the default value), the y coordinates refer to layout.yaxis
. If y2, the y coordinates refer to layout.yaxis2
, and so on.
default: y
Sourcepub fn idssrc(&mut self, idssrc: &'a str) -> &mut Self
pub fn idssrc(&mut self, idssrc: &'a str) -> &mut Self
Sets the source reference on Chart Studio Cloud for ids .
Sourcepub fn customdatasrc(&mut self, customdatasrc: &'a str) -> &mut Self
pub fn customdatasrc(&mut self, customdatasrc: &'a str) -> &mut Self
Sets the source reference on Chart Studio Cloud for customdata .
Sourcepub fn metasrc(&mut self, metasrc: &'a str) -> &mut Self
pub fn metasrc(&mut self, metasrc: &'a str) -> &mut Self
Sets the source reference on Chart Studio Cloud for meta .
Sourcepub fn zsrc(&mut self, zsrc: &'a str) -> &mut Self
pub fn zsrc(&mut self, zsrc: &'a str) -> &mut Self
Sets the source reference on Chart Studio Cloud for z .
Sourcepub fn textsrc(&mut self, textsrc: &'a str) -> &mut Self
pub fn textsrc(&mut self, textsrc: &'a str) -> &mut Self
Sets the source reference on Chart Studio Cloud for text .
Sourcepub fn hovertextsrc(&mut self, hovertextsrc: &'a str) -> &mut Self
pub fn hovertextsrc(&mut self, hovertextsrc: &'a str) -> &mut Self
Sets the source reference on Chart Studio Cloud for hovertext .
Sourcepub fn hoverinfosrc(&mut self, hoverinfosrc: &'a str) -> &mut Self
pub fn hoverinfosrc(&mut self, hoverinfosrc: &'a str) -> &mut Self
Sets the source reference on Chart Studio Cloud for hoverinfo .
Sourcepub fn hovertemplatesrc(&mut self, hovertemplatesrc: &'a str) -> &mut Self
pub fn hovertemplatesrc(&mut self, hovertemplatesrc: &'a str) -> &mut Self
Sets the source reference on Chart Studio Cloud for hovertemplate .