Multiline

Home

A multiline is a graphic object similar to a polyline but drawn with parallel lines, called elements, defined by multiline style.
Multilines are composed of 2 to 16 parallel lines. When you draw a multiline, you can use the STANDARD style, which has two elements, or specify a style that you created previously. You can also change the justification and scale of the multiline before you draw it.
Multiline justification determines which side of the vertex that the multiline is drawn, or whether it is centered on the vertex.
Multiline scale controls the overall width of the multiline using the current units. Multiline scale does not affect linetype scale. If you change the multiline scale, you might need to make equivalent changes to the linetype scale to prevent dots or dashes from being disproportionately sized.

To add multiline into a drawing use following functions:

Function	Meaning
lcBlockAddMline	Adds a multiline
lcMlineAddVer	Adds a multiline vertex
lcMlineAddVerDir	Adds a multiline vertex by direction from the previous vertex

A multiline has properties and functions derived from base class and the following specific properties:

Property	Type	Access	Meaning
LC_PROP_MLINE_STYLE	handle string	RW	Handle to multiline style Name of multiline style
LC_PROP_MLINE_JUST	int	RW	Justification (LC_MLINE_TOP, LC_MLINE_MIDDLE, LC_MLINE_BOTTOM)
LC_PROP_MLINE_SCALE	float	RW	Multiline scale
LC_PROP_MLINE_FIT	int	RW	Fit type
LC_PROP_MLINE_NVERS	int	R	Number of vertices
LC_PROP_MLINE_CLOSED	bool	RW	Closed multiline
LC_PROP_MLINE_LEN	float	R	Length
LC_PROP_MLINE_AREA	float	R	Area

Multiline vertex properties (use vertex handle to access it):

Property	Type	Access	Meaning
LC_PROP_VER_X	float	RW	Coordinate X
LC_PROP_VER_Y	float	RW	Coordinate Y
LC_PROP_VER_Z	float	RW	Coordinate Z
LC_PROP_VER_RADIUS	float	RW	Radius of vertex arc (for LC_PLFIT_ROUND).
LC_PROP_VER_INDEX	int	R	Vertex index (from 0 to LC_PROP_MLINE_NVERS-1).
For the segment from current vertex to the next vertex
LC_PROP_VER_SEGDX	float	RW	Delta X to the next vertex
LC_PROP_VER_SEGDY	float	RW	Delta Y to the next vertex
LC_PROP_VER_SEGANG	float	RW	Direction angle to the next vertex
LC_PROP_VER_SEGLEN	float	RW	Distance to the next vertex
LC_PROP_VER_BULGE	float	RW	Bulge value (for LC_PLFIT_BULGE).

Multiline specific functions:

Function	Meaning
lcMlineAddVer	Adds a multiline vertex
lcMlineAddVerDir	Adds a multiline vertex by direction from the previous vertex
lcMlineDeleteVer	Deletes a vertex from a multiline
lcMlineGetFirstVer lcMlineGetNextVer lcMlineGetLastVer lcMlineGetPrevVer	Used to sequentially retrieve all vertices from a multiline
lcMlineGetVer	Gets a multiline vertex by its index
lcMlineGetVerPt	Gets a multiline vertex by point
lcMlineReverse	Reverse order of multiline vertices

See also

  Retrieve objects