awvPlaceAMarker

awvPlaceAMarker(
w_windowID
x_traceIndex
n_xLoc
n_yLoc
[ ?subwindow x_subwindow ]
[ ?positionMode t_positionMode ]
)
=> t_markerID / nil

Places a marker of type A at the specified location on the specified trace.

w_windowID	Waveform window ID
x_traceIndex	Index number that identifies the trace. This is an integer value.
n_xLoc	The x coordinate at which the marker is to be placed.
n_yLoc	The y coordinate at which the marker is to be placed.
`?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.
`?positionMode` t_positionMode
	Specifies the position mode of the marker. Valid values are: `x`: Marker is placed at the specified xLoc value and the nearest yLoc value on the trace. This is the default value. `y`: Marker is placed at the specified yLoc value and the nearest xLoc value on the trace. `xy`: Marker is placed at the specified xLoc and yLoc values on the trace.

t_markerID	Returns the ID of the marker after the marker is placed on the specified trace.
`nil`	The marker cannot be placed on the trace because of an error.

The following example creates a Waveform window.

win=awvCreatePlotWindow()

=> window:10

Opens simulation results stored in the specified directory:

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

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

Plots the waveforms of net10 and out signals from the simulation results:

awvPlotWaveform(

win

    list(v("net10" ?result "tran-tran") v("out" ?result "tran-tran"))

=> t

Returns the index numbers and the signal names plotted in the Waveform window:

awvGetWaveNameList(win)

=>

((1 2)

    ("net10" "out")

Places a marker at x=100n on the trace out in the subwindow 1 of the specified waveform window win= window:10.

awvPlaceAMarker(win 2 100n 0 ?subwindow 1)

=> "refPointMarker[50.99.2]"

Places a marker at x=200n on the trace out in the current subwindow of the specified Waveform window:

awvPlaceAMarker(win 2 200n 0 ?positionMode "x")

=> "refPointMarker[50.99.2]"

Places a marker at y=3 on the trace net10in the current subwindow of the specified Waveform window:

awvPlaceAMarker(win 1 200n 3 ?positionMode "y")

=> "refPointMarker[50.99.2]"

Places a marker at x=50n and y=2.5 on the trace out in the subwindow 1 of the specified Waveform window:

awvPlaceAMarker(win 2 50n 2.5 ?subwindow 1 ?positionMode "xy")

=> "refPointMarker[50.99.2]"