Triangulated Irregular Network

OBSOLETE Triangulated Irregular Network (TIN)

The TIN model represents a surface as a set of contiguous, non-overlapping triangles. Within each triangle the surface is represented by a plane. The triangles are made from a set of points called mass points.

These are TIN functions:

Function	Meaning
lcTIN_Clear	Deletes all points and triangles
lcTIN_FileLoad	Loads TIN object from a file
lcTIN_FileSave	Saves TIN object into a file
lcTIN_Update	Updates TIN object
TIN points
lcTIN_AddPoint lcTIN_AddPoint2	Adds a point
lcTIN_LoadPoints	Loads points from a file
lcTIN_DelDupPoints	Deletes duplicate points
lcTIN_DelPoint	Deletes specific point
lcTIN_GetFirstPoint lcTIN_GetNextPoint	Used to sequentially retrieve all points
lcTIN_GetPointI	Retrieves a point by its index
TIN triangles
lcTIN_AddTrian lcTIN_AddTrianI	Adds a triangle
lcTIN_DelTrian	Deletes specific triangle
lcTIN_DelTriansByPline	Deletes triangles which cross a polyline
lcTIN_GetFirstTrian lcTIN_GetNextTrian	Used to sequentially retrieve all triangles
lcTIN_NormTrians	Normalize all triangles
Boundary
lcTIN_Triangulate	Triangulate points within the boundary
lcTIN_BndClear	Deletes a boundary
lcTIN_BndAuto	Automatically creates a boundary
lcTIN_BndAddPoint	Adds boundary point
lcTIN_BndUpdate	Updates a boundary
lcTIN_BndGetPoint	Retrieves a boundary point
lcTIN_BndFileSave	Saves a part of TIN object, which is inside of a boundary
lcTIN_BndOffset	Move points which is inside of a boundary
Isolines
lcTIN_GenIsolines	Creates isolines
lcTIN_GetFirstIso lcTIN_GetNextIso	Used to sequentially retrieve all isolines
lcTIN_IsoGetHeight	Returns isoline's height (Z-coordinate)
lcTIN_IsoGetNumVers	Returns a number of vertices of specified isoline
lcTIN_IsoIsClosed	Returns value of "Closed" flag of isoline
lcTIN_IsoMakeLabels lcTIN_GetIsoLabel	Used to retrieve isoline labels parameters
lcTIN_IsoGetFirstVer lcTIN_IsoGetNextVer	Used to sequentially retrieve all vertices of current isoline
lcTIN_IsoGetVerXY	Retrieves X,Y coordinates of current vertex
lcTIN_GenFill	Creates color filling, according to Z-value
Utility functions
lcTIN_GetZ	Gets Z coordinate by X,Y position
lcTIN_InterLine	Defines intersection line
lcTIN_InterGetPoint	Retrieves intersection points between the line and TIN triangles edges
lcTIN_GetNearPoint	Retrieves TIN point which is nearest to specified position

There are special commands to work with TIN object:

Value	Meaning
LC_CMD_TIN_CLEAR	Delete all points and triangles
LC_CMD_TIN_LOAD	Load TIN object from a file (*.tin)
LC_CMD_TIN_SAVE	Save TIN object in a file (*.tin)
LC_CMD_TIN_PROPS	Edit TIN properties by dialog
LC_CMD_TIN_GENISO	Call dialog "Generate TIN isolines"
LC_CMD_TIN_GENFILL	Call dialog "Generate TIN filling"
LC_CMD_TIN_ADDPT	Add points
LC_CMD_TIN_LOADPT	Load points from a file
LC_CMD_TIN_EDITPT	Edit points
LC_CMD_TIN_DELPT	Delete points
LC_CMD_TIN_DELPTDUP	Delete duplicate points (within specified Delta)
LC_CMD_TIN_DELTR	Delete triangles
LC_CMD_TIN_DELTRALL	Delete all triangles. CmdParam: 1-no messages
LC_CMD_TIN_SWAPTR	Swap adjoining triangles
LC_CMD_TIN_ZOOM	Zoom on extents of TIN object
LC_CMD_TIN_BND	Create a boundary by picking points
LC_CMD_TIN_BNDEDIT	Edit exist boundary
LC_CMD_TIN_BNDAUTO	Create a boundary by edge distance
LC_CMD_TIN_BNDTRANG	Triangulate points within a boundary
LC_CMD_TIN_BNDDELTR	Delete all triangles within a boundary
LC_CMD_TIN_BNDDELPT	Delete all points within a boundary
LC_CMD_TIN_BNDCLEAR	Delete a boundary
LC_CMD_TIN_BNDSAVE	Save a bounded part of TIN object in a file (*.tin)
LC_CMD_TIN_Z	Display TIN Z-coordinate of cursor position (displayed near cursor)

TIN object has the following properties:

Property	Type	Access	Meaning
LC_PROP_TIN_FILENAME	string	R	Filename of loaded TIN data
LC_PROP_TIN_XMIN	float	R	Mininal X extents
LC_PROP_TIN_XMAX	float	R	Maximal X extents
LC_PROP_TIN_YMIN	float	R	Mininal Y extents
LC_PROP_TIN_YMAX	float	R	Maximal Y extents
LC_PROP_TIN_ZMIN	float	R	Mininal Z extents
LC_PROP_TIN_ZMAX	float	R	Maximal Z extents
LC_PROP_TIN_DX	float	R	Delta of X coordinates
LC_PROP_TIN_DY	float	R	Delta of Y coordinates
LC_PROP_TIN_DZ	float	R	Delta of Z coordinates
LC_PROP_TIN_NPOINTS	int	R	Number of points
LC_PROP_TIN_NTRIANS	int	R	Number of triangles
LC_PROP_TIN_NBNDPTS	int	R	Number of boundary points
LC_PROP_TIN_ISOSTEP	float	RW	Z step of isolines
LC_PROP_TIN_ISOBOLD	int	RW	Interval for bold isolines
LC_PROP_TIN_ISOBASE	float	RW	Start Z for isoline step
LC_PROP_TIN_ISOZMIN	float	RW	Zmin for isolines generation
LC_PROP_TIN_ISOZMAX	float	RW	Zmax for isolines generation
LC_PROP_TIN_ISOSMOOTH	bool	RW	Smooth isolines
LC_PROP_TIN_IMGDIR	string	RW	Directory of points images
Information to write in LandXML file
LC_PROP_TIN_LX_PRJNAME	string	RW	Project name
LC_PROP_TIN_LX_APPNAME	string	RW	Application name
LC_PROP_TIN_LX_DESCR	string	RW	Description
LC_PROP_TIN_LX_MANUF	string	RW	Manufacturer
LC_PROP_TIN_LX_VER	string	RW	Version
LC_PROP_TIN_LX_URL	string	RW	URL
LC_PROP_TIN_LX_TIME	string	RW	Time
Elements visibility
LC_PROP_TIN_VIEWPT	bool	RW	View points
LC_PROP_TIN_VIEWPTN	bool	RW	View points names
LC_PROP_TIN_VIEWPTI	bool	RW	View points indices
LC_PROP_TIN_VIEWPTZ	bool	RW	View points Z-coordinates
LC_PROP_TIN_VIEWTR	bool	RW	View triangles
LC_PROP_TIN_VIEWTRF	bool	RW	View filling of triangles
LC_PROP_TIN_VIEWTRI	bool	RW	View triangles indices
LC_PROP_TIN_VIEWTRV	bool	RW	View triangle's waterflow vector
LC_PROP_TIN_VIEWBND	bool	RW	View boundary
LC_PROP_TIN_VIEWBNDI	bool	RW	View indices of boundary vertices
LC_PROP_TIN_VIEWISO	bool	RW	View isolines
LC_PROP_TIN_VIEWISOH	bool	RW	View heights of isolines
LC_PROP_TIN_FILLMODE	int	RW	Fill mode: 0-gray; 1-color; 2-dark color
LC_PROP_TIN_FILLDZ	bool float	RW	Range fill colors by Z step Value of Z step
Colors
LC_PROP_TIN_NCOLPNT	int	RW	Number of colors for TIN points (max 30)
LC_PROP_TIN_ICOLPNT	int	RW	Current index of point color (0...LC_PROP_TIN_NCOLPNT-1)
LC_PROP_TIN_COLPNT	int	RW	Color for points (COLORREF) at current index
LC_PROP_TIN_COLTR	int	RW	Color of triangle edge (COLORREF)
LC_PROP_TIN_COLTRI	int	RW	Color of triangle index (COLORREF)
LC_PROP_TIN_COLTRV	int	RW	Color of triangle waterflow vector (COLORREF)
LC_PROP_TIN_COLISO	int	RW	Color of isolines (COLORREF)
LC_PROP_TIN_COLISOB	int	RW	Color of bold isolines (COLORREF)

TIN point properties (require point handle):

Property	Type	Access	Meaning
LC_PROP_TIN_PNT_I	int	R	Index
LC_PROP_TIN_PNT_X	float	RW	Point X coordinate
LC_PROP_TIN_PNT_Y	float	RW	Point Y coordinate
LC_PROP_TIN_PNT_Z	float	RW	Point Z coordinate
LC_PROP_TIN_PNT_NAME	string	RW	Point name
LC_PROP_TIN_PNT_DESCR	string	RW	Point description
LC_PROP_TIN_PNT_ICOLOR	int	RW	Index of Point color (0...LC_PROP_TIN_NCOLPNT-1)
LC_PROP_TIN_PNT_IMGFILE	string	RW	Image filename (without path)
LC_PROP_TIN_PNT_IMGFILE2	string	R	Image full filename (with path)
LC_PROP_TIN_PNT_ATTR	string	RW	Attributes, 10 fields

TIN triangle properties (require triangle handle):

Property	Type	Access	Meaning
LC_PROP_TIN_TR_I	int	R	Index
LC_PROP_TIN_TR_PT0	handle	R	Handle to 1st point
LC_PROP_TIN_TR_PT1	handle	R	Handle to 2nd point
LC_PROP_TIN_TR_PT2	handle	R	Handle to 3rd point
LC_PROP_TIN_TR_PT0X	float	R	X coordinate of 1st point
LC_PROP_TIN_TR_PT0Y	float	R	Y coordinate of 1st point
LC_PROP_TIN_TR_PT0Z	float	R	Z coordinate of 1st point
LC_PROP_TIN_TR_PT1X	float	R	X coordinate of 2nd point
LC_PROP_TIN_TR_PT1Y	float	R	Y coordinate of 2nd point
LC_PROP_TIN_TR_PT1Z	float	R	Z coordinate of 2nd point
LC_PROP_TIN_TR_PT2X	float	R	X coordinate of 3rd point
LC_PROP_TIN_TR_PT2Y	float	R	Y coordinate of 3rd point
LC_PROP_TIN_TR_PT2Z	float	R	Z coordinate of 3rd point
LC_PROP_TIN_TR_XC	float	R	X coordinate of triange center point
LC_PROP_TIN_TR_YC	float	R	Y coordinate of triange center point
LC_PROP_TIN_TR_ZC	float	R	Z coordinate of triange center point
LC_PROP_TIN_TR_NVX	float	R	X value of triange normal vector
LC_PROP_TIN_TR_NVY	float	R	Y value of triange normal vector
LC_PROP_TIN_TR_NVZ	float	R	Z value of triange normal vector
LC_PROP_TIN_TR_NANG	float	R	Normal vector angle at XY plane
LC_PROP_TIN_TR_XMIN	float	R	X min of triange extents
LC_PROP_TIN_TR_YMIN	float	R	Y min of triange extents
LC_PROP_TIN_TR_ZMIN	float	R	Z min of triange extents
LC_PROP_TIN_TR_XMAX	float	R	X max of triange extents
LC_PROP_TIN_TR_YMAX	float	R	Y max of triange extents
LC_PROP_TIN_TR_ZMAX	float	R	Z max of triange extents
LC_PROP_TIN_TR_DX	float	R	Delta X of triange extents
LC_PROP_TIN_TR_DY	float	R	Delta Y of triange extents
LC_PROP_TIN_TR_DZ	float	R	Delta Z of triange extents
LC_PROP_TIN_TR_FLAGS	int	RW	Triangle flags (0-255)
LC_PROP_TIN_TR_MARK	bool	RW	"Marked triangle" flag

See also

Code sample: Create TIN object
Code sample: Create TIN object with color filling