dbGetMarkerName

dbGetMarkerName(
d_markerId 
)
=> t_markerName / nil

Description

Retrieves the name assigned to the marker associated with the given marker ID.

Arguments

d_markerId

Database ID of a marker.

Value Returned

t_markerName	Name assigned to the specified marker. Returns an empty string for unnamed markers.
nil	Marker name was not retrieved.

Examples

m1 = list( (-2.0:-2.0) (-2.0:2.0) (2.0:2.0) (2.0:-2.0) (-2.0:-2.0) )

marker1 = dbCreateMarker(cv "marker1 - annotation type marker" "layout" m1 nil t t "annotation" "annotation marker")

dbGetMarkerName(marker1)

=> ""

dbSetMarkerName(marker1 "foo")

dbGetMarkerName(marker1) 

=> "foo"

Creates a new marker with the specified list of points. Retrieving the name of the unnamed marker returns an empty string. You can assign a specific name to this marker, which can be then retrieved persistently.

Related Topics

Database Access Function Argument Types

Marker Functions

Return to top