awvPlacePointMarker

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

Places a point marker 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 point marker is to be placed.
n_yLoc	The y coordinate at which the point 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 position mode of the point marker. Valid values are: `x`: The point marker is placed at the specified xLoc value and the nearest yLoc value on the trace. This is the default value. `y`: The point marker is placed at the specified yLoc value and the nearest xLoc value on the trace. `xy`: The point marker is placed at the specified xLoc and yLoc values on the trace.

t_markerID	Returns the ID of the point marker after the marker is placed on the specified trace.
`nil`	The point 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 point marker at x=200n on the trace out in the subwindow 1 of the specified Waveform window:

awvPlacePointMarker(win 2 200n 2.5 ?subwindow 1 ?positionMode "x")

=> "pointMarker[50.99.6]"

Places a point marker at y=1.5 on the trace net10 in current subwindow of the specified Waveform window:

awvPlacePointMarker(win 1 50n 1.5 ?positionMode "y")

=> "pointMarker[50.99.7]"

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

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

=> "pointMarker[50.99.8]"