RVC Object Funcions


Functions
DEPRECATED void	FreeFNameInodeUCArray (FNAMEINODEUC *fnameinode, int numentries)
DEPRECATED void	FreeFNameInodeUCList (FNAMEINODEUC *fnameinodelist)
DEPRECATED int	MdlgGetObject (MDLGPARENT dlgparent, MIUNICODE filename, INT32 inode, const void prompt, int objtype, int hdrconv, void vinfo, int hdrsize, MfFiltFuncProto filter=0, void *filtuserdata=0, GETOBJFLAGS flags=GETOBJFLAG_None)
DEPRECATED int	MdlgGetObject (MDLGPARENT dlgparent, FILEPATH &filepath, INT32 inode, const void prompt, int objtype, int hdrconv, void vinfo, int hdrsize, MfFiltFuncProto filter=0, void filtuserdata=0, GETOBJFLAGS flags=GETOBJFLAG_None)
DEPRECATED int	MdlgGetObjects (MDLGPARENT dlgparent, MIUNICODE filename, INT32 parentinode, const void prompt, int objtype, int minobjs, int maxobjs, FNAMEINODEUC *fnameinoderet, MfFiltFuncProto filter=0, void filtuserdata=0, MfValidMultiProto validfunc=0, GETOBJFLAGS flags=GETOBJFLAG_None)
DEPRECATED int	MdlgGetObjects (MDLGPARENT dlgparent, FILEPATH &filepath, INT32 parentinode, const void prompt, int objtype, int minobjs, int maxobjs, RVC::OBJITEMLIST &ItemList, MfFiltFuncProto filter=0, void filtuserdata=0, MfValidListProto validfunc=0, GETOBJFLAGS flags=GETOBJFLAG_None)
DEPRECATED int	MdlgGetObjectSet (MDLGPARENT dlgparent, MIUNICODE filename, INT32 parentinode, const void prompt, int objtype, int hdrsize, int numobjs, FNAMEINODEUC fnameinode[], void objlabel[], MfFiltFuncProto filter=0, void filtuserdata=0, MfValidMultiProto validfunc=0, GETOBJFLAGS flags=GETOBJFLAG_None)
DEPRECATED int	MdlgGetObjectSet (MDLGPARENT dlgparent, FILEPATH &filepath, INT32 parentinode, const void prompt, int objtype, int numobjs, RVC::OBJITEMLIST &ItemList, void objlabel[], MfFiltFuncProto filter=0, void *filtuserdata=0, MfValidListProto validfunc=0, GETOBJFLAGS flags=GETOBJFLAG_None)
DEPRECATED RVCLOWLIBEXPORT int	MfChangeFileLock (int fhandle, UINT32 flags)
RVCLOWLIBEXPORT int	MfChangeTempFileMode (int findex, UINT32 flags)
DEPRECATED RVCLOWLIBEXPORT int	MfCloseFile (int fhandle)
RVCLOWLIBEXPORT int	MfCompareDateTime (const RVCDATETIME d1, const RVCDATETIME d2)
DEPRECATED int	MfComputeObjectScale (int fhandle, INT32 objinode, INT32 georefinode, double xscale, double yscale)
int	MfConvertRasterToTINIterative (int fhandle, INT32 inode, MIUNICODE Filename, RVCTININFO TINinfo, DOUBLE ZTolerance, INT32 MaxNodes, DOUBLE deltaz, DOUBLE shortedge, DOUBLE longedge, INT32 flags)
int	MfConvertTINtoRaster (int ifhandle, INT32 inode, int ofhandle, RVCRASTINFO Info, int Method, UINT32 flags, void sdwidget)
int	MfConvertTINtoRasterExt (int ifhandle, INT32 inode, int ofhandle, RVCRASTINFO Info, int Method, UINT32 flags, MIUNICODE SelectQuery, MIUNICODE ValueQuery, Mat3x3 tparam, void sdwidget)
int	MfConvertVectorToRaster (const RVC::OBJITEM &VecObjItem, const RVC::OBJITEM &DestObjItem, TRANSPARM *transvtor, int ElementType, int ElementNumber, double value, UINT32 flags)
DEPRECATED int	MfConvertVectorToRaster (int vhandle, int rhandle, TRANSPARM *transvtor, int ElementType, int ElementNumber, double value, UINT32 flags)
int	MfConvertVectorToRasterBigrid (int vfhandle, INT32 inode, int ofhandle, RVCRASTINFO RastInfo, MIUNICODE Query, DOUBLE Direction, int AlongLineMethod, int AcrossLineMethod, UINT32 flags)
DEPRECATED RVCAPPLIBEXPORT int	MfCopyObject (int sfhandle, INT32 sinode, int dfhandle, INT32 dpinode, INT32 *destinode, UINT32 flags)
DEPRECATED RVCAPPLIBEXPORT int	MfCopySubObjects (int sfhandle, INT32 spinode, int dfhandle, INT32 dpinode, MfFiltFuncProto FiltFunc, void *FiltData, UINT32 flags)
ERRVALUE	MfCrossSectionCreate (const POLYLINE &ProfileLine, const RVC::OBJITEM &SrcObjItem, const RVC::OBJITEM &SurfObjItem, RVC::OBJITEM &DestObjItem, double BaseValue, UINT32 flags)
DEPRECATED RVCLOWLIBEXPORT int	MfDeleteObject (int findex, INT32 inode)
DEPRECATED RVCLOWLIBEXPORT int	MfDeleteSubObjects (int findex, INT32 pinode, UINT32 objtype)
DEPRECATED int	MfEditName (Widget pwidget, const char formname, const char labelname, RVC::OBJECTNAME &name, int(NameInUse)(const RVC::OBJECTNAME &, void ), void *NameInUseData, UINT32 flags)
DEPRECATED int	MfEditNameDesc (Widget parent, int fhandle, RVCGENINFO objinfo, const char dialogname, int(validname)(const RVC::OBJECTNAME &, void ), void *validnamedata, UINT32 flags)
DEPRECATED RVCLOWLIBEXPORT int	MfFileIsWritable (int fhandle)
DEPRECATED RVCLOWLIBEXPORT int	MfFileOpen (const FILEPATH &filepath, UINT32 flags, void *dlgparent=0)
DEPRECATED RVCLOWLIBEXPORT int	MfFileOpen (void parent, const MIUNICODE filename, UINT32 flags)
DEPRECATED RVCLOWLIBEXPORT MIUNICODE *	MfFindLinkFileNameUC (const MIUNICODE sfilename, const MIUNICODE filename, UINT32 flags)
RVCLOWLIBEXPORT FILEPATH	MfFindLinkFilePath (const FILEPATH &SourceFile, const FILEPATH &Filename, UINT32 flags=FINDFILE_Default)
DEPRECATED RVCLOWLIBEXPORT INT32	MfFindObject (int file, INT32 pinode, UINT32 otype, const MIUNICODE name, MfFiltFuncProto filter=0, void filterdata=0)
RVCLOWLIBEXPORT ERRVALUE	MfGenerateLockNames (const FILEPATH &SourceFile, FILEPATH &lokfilepath, FILEPATH *kolfilepath=0)
RVCLOWLIBEXPORT void	MfGetAutoLinkPatternList (const RVC::OBJTYPESET &objtypeset, MISTRINGLIST &patternlist)
DEPRECATED RVCLOWLIBEXPORT const MIUNICODE *	MfGetFilenameUC (int id)
DEPRECATED RVCLOWLIBEXPORT const FILEPATH *	MfGetFilePath (int id)
DEPRECATED RVCLOWLIBEXPORT UINT32	MfGetFileStatus (int findex)
DEPRECATED RVCLOWLIBEXPORT INT32	MfGetLastUsed (int fhandle, INT32 parentinode, UINT32 objtype, MfFiltFuncProto filtfunc=0, void *filtdata=0)
RVC::LITEUSABILITY	MfGetLiteUsability (const RVC::OBJITEM &objitem)
RVCLOWLIBEXPORT ERRVALUE	MfGetLockInfoEx (const FILEPATH &filepath, RVCFILELOCK &lockinfo)
DEPRECATED RVCLOWLIBEXPORT INT32	MfGetObjCount (int fhandle, INT32 parent, UINT32 otype)
DEPRECATED RVCLOWLIBEXPORT int	MfGetObjectFile (int handle)
DEPRECATED RVCLOWLIBEXPORT INT32	MfGetObjectInode (int handle)
DEPRECATED RVCLOWLIBEXPORT MIUNICODE *	MfGetObjectName (int file, INT32 inode)
DEPRECATED RVCLOWLIBEXPORT UINT32	MfGetObjectStatus (int findex, INT32 inode)
RVCLOWLIBEXPORT const char *	MfGetObjectTagFromType (UINT32 otype)
RVCLOWLIBEXPORT INT32	MfGetObjectTypeFromTag (const char *tag)
DEPRECATED RVCLOWLIBEXPORT INT32	MfGetObjList (int fhandle, INT32 parent, UINT32 objtype, INT32 ilist, UINT32 tlist, INT32 max)
DEPRECATED RVCLOWLIBEXPORT INT32	MfGetObjListF (int fhandle, INT32 parent, UINT32 objtype, INT32 ilist, UINT32 tlist, INT32 max, MfFiltFuncProto filter, void *fdata)
DEPRECATED RVCLOWLIBEXPORT INT32	MfGetObjType (int id)
RVCLOWLIBEXPORT int	MfIsFileLockedEx (const FILEPATH &filepath)
DEPRECATED RVCLOWLIBEXPORT int	MfIsLinked (int findex, INT32 inode)
RVCLOWLIBEXPORT void	MfLinkFileClearMissingList ()
RVCLOWLIBEXPORT void	MfLinkFilePromptDisable ()
RVCLOWLIBEXPORT void	MfLinkFilePromptEnable ()
RVCLOWLIBEXPORT void	MfLinkFileSetHandler (int(FileFunc)(const FILEPATH &SourceFile, const FILEPATH &filepath, UINT32 flags, void udata), void *udata)
DEPRECATED RVCLOWLIBEXPORT int	MfMakeFileEx (const FILEPATH &, RVCBASICINFO &bdata)
DEPRECATED RVCLOWLIBEXPORT int	MfMakeFileUC (const MIUNICODE filename, RVCBASICINFO info)
DEPRECATED RVCLOWLIBEXPORT int	MfMakeTempFile (MIUNICODE *filename, UINT32 flags)
DEPRECATED RVCLOWLIBEXPORT int	MfMakeTempFileEx (FILEPATH *FilePath, UINT32 flags)
DEPRECATED RVCLOWLIBEXPORT int	MfMakeTempFileUC (MIUNICODE *filename, UINT32 flags)
RVCLOWLIBEXPORT const char *	MfObjectGetIconName (UINT32 otype)
RVCLOWLIBEXPORT int	MfOpenObjectIsWritable (int ohandle)
int	MfPackFile (const FILEPATH &)
DEPRECATED int	MfReadBasicInfo (int fhandle, RVCINODENUM inode, RVCBASICINFO *info)
DEPRECATED RVCLOWLIBEXPORT int	MfReadFileHeader (int fhandle, RVCBASICINFO *data)
DEPRECATED int	MfReadGenInfo (int fhandle, RVCINODENUM inode, RVCGENINFO *info)
RVCLOWLIBEXPORT int	MfReadLinkDataEx (int findex, INT32 inode, RVCGENINFO &ginfo, RVCLINKDATAEX &LinkData)
RVCLOWLIBEXPORT void	MfReadOnlyModeSet (bool SetReadOnly)
RVCLOWLIBEXPORT void	MfStop (void)
ERRVALUE	MfTestUsableInLite (const RVC::OBJITEM &objitem)
DEPRECATED RVCLOWLIBEXPORT int	MfTouchObject (int fhandle, INT32 inode)
ERRVALUE	MfTransferRasterAttrToVectorPoints (const RVC::OBJITEM &RastObjItem, const RVC::OBJITEM &VectObjItem)
DEPRECATED RVCLOWLIBEXPORT int	MfUpdateFile (int file)
DEPRECATED RVCLOWLIBEXPORT int	MfUpdateLastMod (int findex, INT32 inode)
DEPRECATED RVCLOWLIBEXPORT int	MfWriteHeaderNameDesc (int findex, INT32 inode, RVCBASICINFO *binfo)
void	MxMakeObjectList (Widget list, const RVC::OBJITEMLIST &items)

Function Documentation

DEPRECATED void FreeFNameInodeUCArray	(	FNAMEINODEUC *	fnameinode,
		int	numentries
	)

Free data allocated in FNAMEINODEUC array.

Note that this does not free the FNAMEINODEUC array itself (as it may not be allocated).

Deprecated:: Use RVC::OBJITEMLIST

Parameters:

fnameinode	Array to free
numentries	Number of entries to free

DEPRECATED void FreeFNameInodeUCList ( FNAMEINODEUC * fnameinodelist )

Free FNAMEINODEUC linked list.

Deprecated:: Use RVC::OBJITEMLIST

Parameters:

fnameinodelist

Linked list to be freed

DEPRECATED int MdlgGetObject	(	MDLGPARENT	dlgparent,
		MIUNICODE *	filename,
		INT32 *	inode,
		const void *	prompt,
		int	objtype,
		int	hdrconv,
		void *	vinfo,
		int	hdrsize,
		MfFiltFuncProto	filter = `0`,
		void *	filtuserdata = `0`,
		GETOBJFLAGS	flags = `GETOBJFLAG_None`
	)

Dialog allowing user to select an object of a specified type.

Deprecated:: Replaced by RVC::DlgGetObject().

Parameters:

dlgparent	Parent of dialog
filename	Default file name
inode	Object inode
prompt	Prompt label
objtype	Object type
hdrconv	Header conversion
vinfo	Object header passed/returned
hdrsize	Header size
filter	Filter function
filtuserdata	Filter function data
flags	Get object flags

DEPRECATED int MdlgGetObject	(	MDLGPARENT	dlgparent,
		FILEPATH &	filepath,
		INT32 *	inode,
		const void *	prompt,
		int	objtype,
		int	hdrconv,
		void *	vinfo,
		int	hdrsize,
		MfFiltFuncProto	filter = `0`,
		void *	filtuserdata = `0`,
		GETOBJFLAGS	flags = `GETOBJFLAG_None`
	)

Dialog allowing user to select an object of a specified type.

Deprecated:: Replaced by RVC::DlgGetObject().

Parameters:

dlgparent	Parent of dialog
filepath	Default file name
inode	Object inode
prompt	Prompt label
objtype	Object type
hdrconv	Header conversion
vinfo	Object header passed/returned
hdrsize	Header size
filter	Filter function
filtuserdata	Filter function data
flags	Get object flags

DEPRECATED int MdlgGetObjects	(	MDLGPARENT	dlgparent,
		MIUNICODE *	filename,
		INT32	parentinode,
		const void *	prompt,
		int	objtype,
		int	minobjs,
		int	maxobjs,
		FNAMEINODEUC **	fnameinoderet,
		MfFiltFuncProto	filter = `0`,
		void *	filtuserdata = `0`,
		MfValidMultiProto	validfunc = `0`,
		GETOBJFLAGS	flags = `GETOBJFLAG_None`
	)

Dialog allowing user to select multiple objects of a specified type.

Deprecated:: Replaced by RVC::DlgGetObjects().

Parameters:

dlgparent	Parent of dialog
filename	Default filename
parentinode	Parent inode
prompt	Prompt label
objtype	Object type
minobjs	Minimum number of objects required
maxobjs	Maximum allowed to be selected, 0 if no limit
fnameinoderet	Inode list returned
filter	Filter function
filtuserdata	Filter function data
validfunc	Validate function
flags	Get object flags

DEPRECATED int MdlgGetObjects	(	MDLGPARENT	dlgparent,
		FILEPATH &	filepath,
		INT32	parentinode,
		const void *	prompt,
		int	objtype,
		int	minobjs,
		int	maxobjs,
		RVC::OBJITEMLIST &	ItemList,
		MfFiltFuncProto	filter = `0`,
		void *	filtuserdata = `0`,
		MfValidListProto	validfunc = `0`,
		GETOBJFLAGS	flags = `GETOBJFLAG_None`
	)

Dialog allowing user to select multiple objects of a specified type.

Deprecated:: Replaced by RVC::DlgGetObjects().

Parameters:

dlgparent	Parent of dialog
filepath	Default filename
parentinode	Parent inode
prompt	Prompt label
objtype	Object type
minobjs	Minimum number of objects required
maxobjs	Maximum allowed to be selected, 0 if no limit
ItemList	Item list returned
filter	Filter function
filtuserdata	Filter function data
validfunc	Validate function
flags	Get object flags

DEPRECATED int MdlgGetObjectSet	(	MDLGPARENT	dlgparent,
		MIUNICODE *	filename,
		INT32	parentinode,
		const void *	prompt,
		int	objtype,
		int	hdrsize,
		int	numobjs,
		FNAMEINODEUC	fnameinode[],
		void *	objlabel[],
		MfFiltFuncProto	filter = `0`,
		void *	filtuserdata = `0`,
		MfValidMultiProto	validfunc = `0`,
		GETOBJFLAGS	flags = `GETOBJFLAG_None`
	)

Dialog to prompt user to select RVC object(s).

Deprecated:: Replaced by RVC::DlgGetObjectSet().

Parameters:

dlgparent	Parent of dialog
filename	Default filename
parentinode	Parent inode
prompt	Prompt label
objtype	Object type
hdrsize	Header size to allocate when creating new objects
numobjs	Number of objects to be selected
objlabel	Inode list returned
filter	Label names for each object Filter function
filtuserdata	Filter function data
validfunc	Validate function
flags	Get object flags

DEPRECATED int MdlgGetObjectSet	(	MDLGPARENT	dlgparent,
		FILEPATH &	filepath,
		INT32	parentinode,
		const void *	prompt,
		int	objtype,
		int	numobjs,
		RVC::OBJITEMLIST &	ItemList,
		void *	objlabel[],
		MfFiltFuncProto	filter = `0`,
		void *	filtuserdata = `0`,
		MfValidListProto	validfunc = `0`,
		GETOBJFLAGS	flags = `GETOBJFLAG_None`
	)

Dialog to prompt user to select RVC object(s).

Deprecated:: Replaced by RVC::DlgGetObjectSet().

Parameters:

dlgparent	Parent of dialog
filepath	Default filename
parentinode	Parent inode
prompt	Prompt label
objtype	Object type
numobjs	Number of objects to be selected
ItemList	Item list returned
filter	Label names for each object Filter function
filtuserdata	Filter function data
validfunc	Validate function
flags	Get object flags

DEPRECATED RVCLOWLIBEXPORT int MfChangeFileLock	(	int	fhandle,
		UINT32	flags
	)

Change the lock access of a file if possible.

Flag values:

RVCFILE_ReadLock Lock the file for reading
RVCFILE_WriteLock Lock the file for writing
RVCFILE_WriteLockAttempt Lock the file for write access if possible, otherwise lock for read
RVCFILE_SharedLock Lock the file for shared access, not implemented yet
Deprecated:
Use RVC::OBJECT or derived classes and open with RVC::OBJECT::OPENMODE_Write

Parameters:

fhandle	File handle returned by MfMakeFile or MfOpenFile
flags	Flags

RVCLOWLIBEXPORT int MfChangeTempFileMode	(	int	findex,
		UINT32	flags
	)

Change temp file mode.

If not a temp file but has '.tmp', make a temp file out of it anyway.

Parameters:

findex	Open file handle
flags	Flags

DEPRECATED RVCLOWLIBEXPORT int MfCloseFile ( int fhandle )

Close a previously opened RVC project file.

Closes an open file and all objects that had been opened in this file. If more that one call to MfOpenFile is made, then the call to this function does not actually close the file, it decrements the open counter and calls MfUpdateFile() to update information on the file.

Deprecated:: Use RVC::OBJECT or derived classes and let go out of scope or call RVC::OBJECT::Close()

Parameters:

fhandle

File handle returned by MfMakeFile or MfOpenFile

RVCLOWLIBEXPORT int MfCompareDateTime	(	const RVCDATETIME *	d1,
		const RVCDATETIME *	d2
	)

Compare two date/time stamps.

Returns:: 1 if d1 before d2: 0 if equal: -1 if d1 after d2.

Parameters:

d1	RVC date/time structure
d2	RVC date/time structure

DEPRECATED int MfComputeObjectScale	(	int	fhandle,
		INT32	objinode,
		INT32	georefinode,
		double *	xscale,
		double *	yscale
	)

Compute object scale or cell size.

Deprecated:: Use RVC::GEOSPATIAL::ComputeObjectScale

Returns:: 0 if used object header, 1 if used georef, -1 if no scale, < -1 error.

Parameters:

fhandle	Handle for open RVC file
objinode	Inode of object to compute scale for
georefinode	Georeference object to use (0 for "last used", -1 force to use header)
xscale	X scale or raster cell size returned
yscale	Y scale or raster cell size returned

int MfConvertRasterToTINIterative	(	int	fhandle,
		INT32	inode,
		MIUNICODE *	Filename,
		RVCTININFO *	TINinfo,
		DOUBLE	ZTolerance,
		INT32	MaxNodes,
		DOUBLE	deltaz,
		DOUBLE	shortedge,
		DOUBLE	longedge,
		INT32	flags
	)

Convert a raster object to a TIN object.

Flags: TIN_ComputeStatistics Compute standard statistics for triangles and edges TIN_Optimize flags Do TIN optimization

NOTE: If there are no nodes in output TIN because of the data or optimization settings, the return code will be EUserCancel.

Parameters:

fhandle	Input file handle
inode	Raster inode
Filename	Output filename
TINinfo	Output object header
ZTolerance	Approximation accuracy
MaxNodes	Maximum number of nodes allowed in output TIN
deltaz	TIN optimization: elevation tolerance
shortedge	TIN optimization: min. edge lenght between 2 nodes that have elevation difference less than deltaz tolerance
longedge	TIN optimization: maximim allowed edge length
flags	flags

int MfConvertTINtoRaster	(	int	ifhandle,
		INT32	inode,
		int	ofhandle,
		RVCRASTINFO *	Info,
		int	Method,
		UINT32	flags,
		void *	sdwidget
	)

Converts TIN object into raster object by surface fitting.

Flags: TINTORASTER_CopyGeoref Copy georeference information and compute default histogram TINTORASTER_AutoScale Perform scaling of output values into the data range of output raster

Parameters:

ifhandle	Input TIN object handle
inode	Input TIN object inode
ofhandle	Output file handle
Info	RVCRASTINFO structure for the output raster
Method	Method to use: TINTORASTER_Linear or TINTORASTER_Quintic
flags	Flags
sdwidget	Status dialog widget

int MfConvertTINtoRasterExt	(	int	ifhandle,
		INT32	inode,
		int	ofhandle,
		RVCRASTINFO *	Info,
		int	Method,
		UINT32	flags,
		MIUNICODE *	SelectQuery,
		MIUNICODE *	ValueQuery,
		Mat3x3	tparam,
		void *	sdwidget
	)

Converts TIN object into raster object by surface fitting.

Flags: TINTORASTER_CopyGeoref Copy georeference information and compute default histogram TINTORASTER_AutoScale Perform scaling of output values into the data range of output raster

Parameters:

ifhandle	Input TIN object handle
inode	Input TIN object inode
ofhandle	Output file handle
Info	Passed/returned RVCRASTINFO structure for the output raster
Method	Method to use: TINTORASTER_Linear or TINTORASTER_Quintic
flags	Flags
SelectQuery	Query string for selecting triangles for processing, set to NULL if not needed
ValueQuery	Query string for computing z-values of nodes, set to NULL if not needed
sdwidget	Status dialog widget, NULL if not needed

int MfConvertVectorToRaster	(	const RVC::OBJITEM &	VecObjItem,
		const RVC::OBJITEM &	DestObjItem,
		TRANSPARM *	transvtor,
		int	ElementType,
		int	ElementNumber,
		double	value,
		UINT32	flags
	)

Convert a vector element into a raster object.

Parameters:

VecObjItem	Source vector objitem
DestObjItem	Destination raster objitem (must exist)
transvtor	TRANSPARM from Vector to Raster
ElementType	ELEMENT_Point, ELEMENT_Line, ELEMENT_Poly
ElementNumber	The vector element to convert
value	The value to fill raster
flags	Flags

DEPRECATED int MfConvertVectorToRaster	(	int	vhandle,
		int	rhandle,
		TRANSPARM *	transvtor,
		int	ElementType,
		int	ElementNumber,
		double	value,
		UINT32	flags
	)

Convert a vector element into a raster object.

Deprecated:: Use the version that takes RVC::OBJITEMS

Parameters:

vhandle	Source vector object handle
rhandle	Destination raster object handle
transvtor	TRANSPARM from Vector to Raster
ElementType	ELEMENT_Point, ELEMENT_Line, ELEMENT_Poly
ElementNumber	The vector element to convert
value	The value to fill raster
flags	Flags

int MfConvertVectorToRasterBigrid	(	int	vfhandle,
		INT32	inode,
		int	ofhandle,
		RVCRASTINFO *	RastInfo,
		MIUNICODE *	Query,
		DOUBLE	Direction,
		int	AlongLineMethod,
		int	AcrossLineMethod,
		UINT32	flags
	)

INTERPOLATE_SplineCubic - uses cubic BSpline
INTERPOLATE_SplineQuad - uses quadratic BSpline
INTERPOLATE_SplineBezier - uses Bezier spline

Valid flags:

SURFACEFIT_AutoRescale - automatically rescale data to fit into output raster data type.
SURFACEFIT_UseDirection - use user supplied direction

Parameters:

vfhandle	Input vector file handle, returned by MfOpenFile()
inode	Input vector inode
ofhandle	Output file handle, returned by MfOpenFile()
RastInfo	Output raster header, fill out .name,.desc,.numbits,.datatype,.numlins,.numcols NOTE: Actual number if lines and columns in the output will be different and depends on data orientation
Query	NULL or standard TNTmips query string for selecting vector lines, use NULL to select all lines
Direction	If SURFACEFIT_UseDirection flag is set, this value is used as a primary direction of the surface fitting (radians)
AlongLineMethod	Surface fitting method to use along the lines
AcrossLineMethod	Surface fitting method to use across the lines
flags	Flags

DEPRECATED RVCAPPLIBEXPORT int MfCopyObject	(	int	sfhandle,
		INT32	sinode,
		int	dfhandle,
		INT32	dpinode,
		INT32 *	destinode,
		UINT32	flags
	)

Copy an object.

NOTE: This function will call MfUpdateFile() to update the file's contents.

Deprecated:: Replaced by RVC::OBJECT::CopyTo()

Parameters:

sfhandle	File handle for source file
sinode	Inode number for source object to copy
dfhandle	File handle for destination file
dpinode	Parent inode of resulting object
destinode	Destination object inode returned (NULL if not needed)
flags	COPYRVC_... flags

DEPRECATED RVCAPPLIBEXPORT int MfCopySubObjects	(	int	sfhandle,
		INT32	spinode,
		int	dfhandle,
		INT32	dpinode,
		MfFiltFuncProto	FiltFunc,
		void *	FiltData,
		UINT32	flags
	)

Copy subobjects selected by a filter from one parent to another.

Only the first level of subobjects (objects immediately under source parent) will be filtered. See MfCopyObject for description of MfFiltFuncProto.

Deprecated:: Replaced by RVC::OBJECT::CopyChildrenTo()

Parameters:

sfhandle	File handle for source file
spinode	Inode number for parent for subobjects to copy
dfhandle	File handle for destination file
dpinode	Parent inode of resulting object
FiltFunc	Pointer to filter function. Return !0 to copy object
FiltData	"Hook" data to pass to filter function
flags	COPYRVC_... flags

ERRVALUE MfCrossSectionCreate	(	const POLYLINE &	ProfileLine,
		const RVC::OBJITEM &	SrcObjItem,
		const RVC::OBJITEM &	SurfObjItem,
		RVC::OBJITEM &	DestObjItem,
		double	BaseValue,
		UINT32	flags
	)

Create polygon cross section based on surface and reference layer.

Parameters:

ProfileLine	Assumed to be in reference object coords, not surface
SrcObjItem	Source reference layer
SurfObjItem	Surface reference layer
DestObjItem	Destination vector object RETURNED
BaseValue	Base Z value to start cross section on
flags	Flags

DEPRECATED RVCLOWLIBEXPORT int MfDeleteObject	(	int	findex,
		INT32	inode
	)

This function will delete the object and ALL subobjects under it.

Use with caution.

Deprecated:: Use RVC::OBJECT::Delete

Parameters:

findex	File handle for RVC file
inode	Inode number for object to delete

DEPRECATED RVCLOWLIBEXPORT int MfDeleteSubObjects	(	int	findex,
		INT32	pinode,
		UINT32	objtype
	)

Delete a subobjects under the parent object of a specific type.

This function will delete the subobjects under the parent. Use with caution.

Deprecated:: Use RVC::OBJECT::Delete

Parameters:

findex	File handle for RVC file
pinode	Inode number for object to delete
objtype	Object type to delete, OTYPE_ALL for all subobjects

DEPRECATED int MfEditName	(	Widget	pwidget,
		const char *	formname,
		const char *	labelname,
		RVC::OBJECTNAME &	name,
		int()(const RVC::OBJECTNAME &, void )	NameInUse,
		void *	NameInUseData,
		UINT32	flags
	)

Pop-in dialog to allow user to edit object/item name.

Deprecated:: Replaced by RVC::DlgEditDescriptor()

Parameters:

pwidget	Parent widget
formname	Name for form dialog
labelname	Name for label
name	Name passed/returned
NameInUseData	Function to check if name is in use Data to pass to NameInUse function
flags	Flags

DEPRECATED int MfEditNameDesc	(	Widget	parent,
		int	fhandle,
		RVCGENINFO *	objinfo,
		const char *	dialogname,
		int()(const RVC::OBJECTNAME &, void )	validname,
		void *	validnamedata,
		UINT32	flags
	)

Pop-in dialog to allow user to edit object or file name and description.

Deprecated:: Replaced by RVC::DlgEditDescriptor()

Parameters:

parent	Parent widget
fhandle	Open file handle
objinfo	Object info to edit
dialogname	Name for dialog
validnamedata	Function to check for valid name Data to pass validnamedata function
flags	Flags

DEPRECATED RVCLOWLIBEXPORT int MfFileIsWritable ( int fhandle )

Returns whether or not the file is capable of being written to.

Returns:: 1 if writable, 0 if not, < 0 ERROR.

Deprecated:: Use RVC::OBJECT::Open() with the flag RVC::OBJECT::OPENMODE_WriteAttempt

Parameters:

fhandle

Open RVC file handle

DEPRECATED RVCLOWLIBEXPORT int MfFileOpen	(	const FILEPATH &	filepath,
		UINT32	flags,
		void *	dlgparent = `0`
	)

Open RVC file, showing Retry/Cancel if another process has lock.

Returns:: Handle to open RVC file or error if < 0.

Flag values:

RVCFILE_ReadLock Lock file for reading
RVCFILE_WriteLock Lock file for writing
RVCFILE_WriteLockAttempt Lock file for write access if possible, otherwise lock for read
RVCFILE_SharedLock Lock file for shared access, not implemented yet
RVCFILE_NoDialog Don't display dialog if locked, just return error

This function will try to open the file with the specified lock mode. If unable to obtain open the file because another process has a lock, a Retry/Cancel dialog will be Retry/Cancel dialog is presented showing the name of the process having the lock. The function will automatically retry at specific intervals until it succeeds or the user presses cancel or the attempt times out. In batch mode the dialog still appears anyway, but the retry interval is much longer.

Deprecated:: Replaced by RVC::OBJECT::Open()

Parameters:

filepath	File to open
flags	Flags
dlgparent	Parent for Retry/Cancel dialog, NULL for default (Must be void since shared between platforms, SBC 15 Jun 01)

DEPRECATED RVCLOWLIBEXPORT int MfFileOpen	(	void *	parent,
		const MIUNICODE *	filename,
		UINT32	flags
	)

Open RVC file, showing Retry/Cancel if another process has lock.

Returns:: Handle to open RVC file or error if < 0.

Flag values:

RVCFILE_ReadLock Lock file for reading
RVCFILE_WriteLock Lock file for writing
RVCFILE_WriteLockAttempt Lock file for write access if possible, otherwise lock for read
RVCFILE_SharedLock Lock file for shared access, not implemented yet

RVC Object Funcions

Functions

Function Documentation