plotline

R2026b

Plot line in 3D scenario viewer

Since R2026b

collapse all in page

    Syntax

    linevis = plotline(v,data)
    linevis = plotline(v,data,Name=Value)

    Description

    Add-On Required: This feature requires the 3D Scenarios add-on.

    linevis = plotline(v,data) displays a 2D or 3D line in the specified viewer and returns a line visual object. Specify the vertices of the line using data.

    linevis = plotline(v,data,Name=Value) specifies options for the line using one or more name-value arguments.

    Input Arguments

    collapse all

    Viewer, specified as a GlobeViewer object.

    Line vertices, specified as a geospatial table containing geopointshape objects. The number of table rows indicates the number of vertices in the line.

    You can create a geospatial table from latitude, longitude, and height coordinates by using the pointtable function.

    This argument sets the Data property of the LineVisual object linevis

    Name-Value Arguments

    collapse all

    Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

    Example: plotline(v,data,Color="m",LineWidth=2) displays a magenta line with a width of 2 pixels.

    Note

    Use name-value arguments to specify values for the properties of the LineVisual object created by this function. The properties listed here are only a subset. For a full list, see LineVisual.

    Line color, specified as an RGB triplet, a hexadecimal color code, or a color name. The default is a blue color.

    Line style, specified as one of these values:

    • "-" — Use a solid line.

    • "--" — Use a dashed line.

    • "none" — Hide the line.

    Line width, in pixels, specified as a positive scalar.

    Marker symbol, specified as one of these values:

    • "o" — Use circle markers.

    • "none" — Hide the markers.

    Radius of the circle markers, in pixels, specified as a positive scalar.

    Marker outline color, specified as "auto", an RGB triplet, a hexadecimal color code, a color name, or "none". The value "auto" uses the same color as the Color property.

    Marker fill color, specified as "none", an RGB triplet, a hexadecimal color code, or a color name.

    Output Arguments

    collapse all

    Line visual, returned as a LineVisual object.

    Version History

    Introduced in R2026b

    See Also

    Objects

    Functions