主要内容

LOSVisual

R2026b

Line-of-sight visual

Since R2026b

    Description

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

    An LOSVisual object controls the appearance of an LOSAnalysis object in a scenario viewer.

    Creation

    When you add a line-of-sight (LOS) analysis to a scenario with open viewers, the scenario automatically creates an LOSVisual object and stores the object in the Visual property of the corresponding LOSAnalysis object.

    You can access an LOSVisual object by using the getvisual function or by querying the Visual property of the LOSAnalysis object.

    Properties

    expand all

    Color of the source point and the visible portion of the line, specified as an RGB triplet, a hexadecimal color code, or a color name. The default is a green color.

    Color of the obstruction point, the obstructed line, and the destination point, specified as an RGB triplet, a hexadecimal color code, or a color name. The default is a red color.

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

    Line style when the LOS is obstructed, specified as one of these options:

    • "--" — Use a dashed line.

    • "-" — Use a solid line.

    Radius of the source and destination points, in pixels, specified as a positive scalar.

    Line transparency, specified as a scalar in the range [0, 1]. A value of 1 is opaque and a value of 0 is completely transparent.

    Option to show the line, specified as "on" or "off", or as numeric or logical 1 (true) or 0 (false). A value of "on" is equivalent to true, and "off" is equivalent to false. Thus, you can use the value of this property as a logical value. The value is stored as an on/off logical value of type matlab.lang.OnOffSwitchState.

    • "on" — Show the line.

    • "off" — Do not show the line.

    Option to show the source and destination points, specified as "on" or "off", or as numeric or logical 1 (true) or 0 (false). A value of "on" is equivalent to true, and "off" is equivalent to false. Thus, you can use the value of this property as a logical value. The value is stored as an on/off logical value of type matlab.lang.OnOffSwitchState.

    • "off" — Do not show the source and destination points.

    • "on" — Show the source and destination points.

    Option to show the obstruction point, specified as "on" or "off", or as numeric or logical 1 (true) or 0 (false). A value of "on" is equivalent to true, and "off" is equivalent to false. Thus, you can use the value of this property as a logical value. The value is stored as an on/off logical value of type matlab.lang.OnOffSwitchState.

    • "off" — Do not show the obstruction point.

    • "on" — Show the obstruction point.

    State of visibility, specified as "on" or "off", or as numeric or logical 1 (true) or 0 (false). A value of "on" is equivalent to true, and "off" is equivalent to false. Thus, you can use the value of this property as a logical value. The value is stored as an on/off logical value of type matlab.lang.OnOffSwitchState.

    • "on" — Show the visual object in the viewer.

    • "off" — Do not show the visual object in the viewer.

    Version History

    Introduced in R2026b