awvPlaceXMarker

awvPlaceXMarker(
w_windowID
n_xLoc
[ ?label t_label ]
[ ?subwindow x_subwindow ]
)
=> t_markerID / nil

Description

Places a vertical marker at the specified x coordinate in the specified graph window.

Arguments

w_windowID	Waveform window ID
n_xLoc	The x coordinate at which the vertical marker is to be placed.
?label t_label	Label to be set on the vertical marker.
?subwindow x_subwindow
	Identification number of the subwindow, which is found in the top-right corner of the subwindow. If you do not specify this argument, the current subwindow is used.

Value Returned

t_markerID	ID of the vertical marker.
nil	The vertical marker cannot be placed on the trace because of an error.

Examples

The following example creates a Waveform window and returns its window ID.

awvCreatePlotWindow()

=> window:3

The following example opens simulation results stored in the specified directory.

openResults("/servers/user/design/ampsim.raw")

=> "/servers/user/design/ampsim.raw"

The following example plots signal out from the tran-tran result of the results directory ampsim.raw.

plot(v("out" ?result "tran-tran") ?expr "out")

=> t

The following examples apply vertical markers on trace out at x=50ns, x=200ns, and x=350ns with labels verticalMarker1, verticalMarker2, and verticalMarker3 in subwindow 1 of the Waveform window you created using awvCreatePlotWindow.

awvPlaceXMarker(window(3) 50ns ?label "verticalMarker1" ?subwindow 1)

=> "vertMarker[1.1.1]"

awvPlaceXMarker(window(3) 200ns ?label "verticalMarker2" ?subwindow 1)

=> "vertMarker[1.1.2]"

awvPlaceXMarker(window(3) 350ns ?label "verticalMarker3" ?subwindow 1)

=> "vertMarker[1.1.3]"

Return to top