RVC Object Funcions


Functions

RVCLOWLIBEXPORT int _MfOpenFile (const MIUNICODE *filename, UINT32 flags)
DEPRECATED void FreeFNameInodeUCArray (FNAMEINODEUC *fnameinode, int numentries)
DEPRECATED void FreeFNameInodeUCList (FNAMEINODEUC *fnameinodelist)
DEPRECATED RVCLOWLIBEXPORT int GetUniqueName (MIUNICODE *name, int(*)(MIUNICODE *, void *), void *udata)
DEPRECATED RVCLOWLIBEXPORT
void 
MakeValidName (MIUNICODE *name)
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)
RVCLOWLIBEXPORT ERRVALUE MfCallbackAdd (int fhandle, MfCallbackFunc func, void *data, UINT32 reason)
RVCLOWLIBEXPORT ERRVALUE MfCallbackRemove (int fhandle, MfCallbackFunc func, void *data, UINT32 reason)
RVCLOWLIBEXPORT int MfChangeFileLock (int fhandle, UINT32 flags)
RVCLOWLIBEXPORT int MfChangeTempFileMode (int findex, UINT32 flags)
RVCLOWLIBEXPORT int MfCloseFile (int fhandle)
RVCLOWLIBEXPORT int MfCloseGen (int handle, RVCGENINFO *info, int hdrsize, int convtype)
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)
RVCAPPLIBEXPORT int MfCopyObject (int sfhandle, INT32 sinode, int dfhandle, INT32 dpinode, INT32 *destinode, MfFiltFuncProto filt, void *filtdata, UINT32 flags)
RVCAPPLIBEXPORT int MfCopyObject (int sfhandle, INT32 sinode, int dfhandle, INT32 dpinode, INT32 *destinode, UINT32 flags)
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)
RVCLOWLIBEXPORT int MfDeleteObject (int findex, INT32 inode)
RVCLOWLIBEXPORT int MfDeleteSubObjects (int findex, INT32 pinode, UINT32 objtype)
int MfEditName (Widget pwidget, const char *formname, const char *labelname, RVC::OBJECTNAME &name, int(*NameInUse)(const RVC::OBJECTNAME &, void *), void *NameInUseData, UINT32 flags)
int MfEditNameDesc (Widget parent, int fhandle, RVCGENINFO *objinfo, const char *dialogname, int(*validname)(const RVC::OBJECTNAME &, void *), void *validnamedata, UINT32 flags)
int MfEditNewNameDesc (Widget pwidget, int fhandle, INT32 parentinode, const char *prompt, int objtype, void *vinfo, UINT32 flags)
RVCLOWLIBEXPORT bool MfFileIsReadAbsolute (int findex)
RVCLOWLIBEXPORT int MfFileIsWritable (int fhandle)
RVCLOWLIBEXPORT int MfFileOpen (const FILEPATH &filepath, UINT32 flags, void *dlgparent=0)
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)
RVCLOWLIBEXPORT FILEPATH MfFindLinkPath (int findex, const FILEPATH &filepath, UINT32 flags=FINDFILE_Default)
RVCLOWLIBEXPORT INT32 MfFindObject (int file, INT32 pinode, UINT32 otype, const MIUNICODE *name, MfFiltFuncProto filter=0, void *filterdata=0)
RVCLOWLIBEXPORT INT32 MfFindObjectDesc (int file, INT32 pinode, UINT32 otype, MIUNICODE *desc, 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)
RVCLOWLIBEXPORT ERRVALUE MfGetFileHeaderEx (const FILEPATH &filepath, RVCBASICINFO &BasicInfo)
DEPRECATED RVCLOWLIBEXPORT
const MIUNICODE
MfGetFilenameUC (int id)
RVCLOWLIBEXPORT const FILEPATHMfGetFilePath (int id)
RVCLOWLIBEXPORT const FILEPATHMfGetFilePathLink (int fhandle)
RVCLOWLIBEXPORT UINT32 MfGetFileStatus (int findex)
RVCLOWLIBEXPORT INT64 MfGetFreeSpaceSize64 (int findex)
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)
RVCLOWLIBEXPORT INT32 MfGetObjCount (int fhandle, INT32 parent, UINT32 otype)
RVCLOWLIBEXPORT int MfGetObjectFile (int handle)
RVCLOWLIBEXPORT INT32 MfGetObjectInode (int handle)
RVCLOWLIBEXPORT MIUNICODEMfGetObjectName (int file, INT32 inode)
RVCLOWLIBEXPORT ERRVALUE MfGetObjectSizeBytes64 (int findex, INT32 inode, UINT64 *retsize)
RVCLOWLIBEXPORT UINT32 MfGetObjectStatus (int findex, INT32 inode)
RVCLOWLIBEXPORT const char * MfGetObjectTagFromType (UINT32 otype)
RVCLOWLIBEXPORT INT32 MfGetObjectTypeFromTag (const char *tag)
RVCLOWLIBEXPORT INT32 MfGetObjList (int fhandle, INT32 parent, UINT32 objtype, INT32 *ilist, UINT32 *tlist, INT32 max)
RVCLOWLIBEXPORT INT32 MfGetObjListF (int fhandle, INT32 parent, UINT32 objtype, INT32 *ilist, UINT32 *tlist, INT32 max, MfFiltFuncProto filter, void *fdata)
RVCLOWLIBEXPORT INT32 MfGetObjListFA (int findex, INT32 parent, UINT32 otype, INT32 **pilist, UINT32 **ptlist, MfFiltFuncProto filter, void *filtdata)
RVCLOWLIBEXPORT INT32 MfGetObjType (int id)
RVCLOWLIBEXPORT bool MfIsFileLinked (int fhandle)
RVCLOWLIBEXPORT int MfIsFileLockedEx (const FILEPATH &filepath)
RVCLOWLIBEXPORT int MfIsLinked (int findex, INT32 inode)
RVCLOWLIBEXPORT bool MfIsObjectCopyable (RVC::OBJTYPE ObjType)
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)
RVCLOWLIBEXPORT int MfMakeFileEx (const FILEPATH &, RVCBASICINFO &bdata)
DEPRECATED RVCLOWLIBEXPORT int MfMakeFileUC (const MIUNICODE *filename, RVCBASICINFO *info)
RVCLOWLIBEXPORT int MfMakeFolder (int findex, RVCGENINFO *hdr)
RVCLOWLIBEXPORT int MfMakeGen (int fhandle, RVCGENINFO *info, int hdrsize, int convtype)
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 MfObjectIsWritable (int findex, INT32 inode)
RVCLOWLIBEXPORT int MfOpenGen (int fhandle, INT32 inode, RVCGENINFO *info, int hdrsize, int convtype, UINT32 flags)
RVCLOWLIBEXPORT int MfOpenObjectIsWritable (int ohandle)
int MfPackFile (const FILEPATH &)
DEPRECATED int MfReadBasicInfo (int fhandle, RVCINODENUM inode, RVCBASICINFO *info)
RVCLOWLIBEXPORT int MfReadFileHeader (int fhandle, RVCBASICINFO *data)
RVCLOWLIBEXPORT INT32 MfReadGen (int handle, void *ptr, INT32 len)
int MfReadGenInfo (int fhandle, RVCINODENUM inode, RVCGENINFO *info)
RVCLOWLIBEXPORT int MfReadLinkDataEx (int findex, INT32 inode, RVCGENINFO &ginfo, RVCLINKDATAEX &LinkData)
RVCLOWLIBEXPORT void MfReadOnlyModeSet (bool SetReadOnly)
int MfReadSmall (int findex, INT32 inode, void *thdr, int hdrsize, int hdrtype, void **data)
RVCLOWLIBEXPORT int MfResizeGen (int handle, UINT32 size)
RVCLOWLIBEXPORT INT32 MfSeekGen (int handle, INT32 pos, int rel)
RVCLOWLIBEXPORT void MfStop (void)
ERRVALUE MfTestUsableInLite (const RVC::OBJITEM &objitem)
RVCLOWLIBEXPORT int MfTouchObject (int fhandle, INT32 inode)
ERRVALUE MfTransferRasterAttrToVectorPoints (const RVC::OBJITEM &RastObjItem, const RVC::OBJITEM &VectObjItem)
RVCLOWLIBEXPORT int MfUpdateFile (int file)
RVCLOWLIBEXPORT int MfUpdateLastMod (int findex, INT32 inode)
RVCLOWLIBEXPORT int MfValidName (const MIUNICODE *name)
DEPRECATED int MfWriteBasicInfo (int fhandle, RVCINODENUM inode, RVCBASICINFO *info)
RVCLOWLIBEXPORT INT32 MfWriteGen (int handle, const void *ptr, INT32 len)
RVCLOWLIBEXPORT int MfWriteHeaderNameDesc (int findex, INT32 inode, RVCBASICINFO *binfo)
RVCLOWLIBEXPORT int MfWriteSmall (int findex, INT32 inode, void *thdr, int hdrsize, int hdrtype, void *data)
void MxMakeObjectList (Widget list, const RVC::OBJITEMLIST &items)

Function Documentation

RVCLOWLIBEXPORT int _MfOpenFile const MIUNICODE filename,
UINT32  flags
 

GENERATING_DOXYGEN_OUTPUT.

Returns:
RVC file handle for use with all RVC object functions.
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
Parameters:
filename  Name of file to open
flags  Flags

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 RVCLOWLIBEXPORT int GetUniqueName MIUNICODE name,
int(*  )(MIUNICODE *, void *),
void *  udata
 

Generate a valid 'unique' name for an RVC object.

Deprecated:
Replaced by RVC::OBJECTNAME::GenerateUniqueName() [i.e. FIXEDSTRING<16>::GenerateUniqueName()]
Parameters:
name  Name to mangle
udata  Function to call to test new mangled name User data passed to TestFunc()

DEPRECATED RVCLOWLIBEXPORT void MakeValidName MIUNICODE name  ) 
 

Correct an invalid name to a valid name under RVC.

Deprecated:
Replaced by RVC::OBJECT::ValidateName()
Parameters:
name  MIUNICODE name to change

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

RVCLOWLIBEXPORT ERRVALUE MfCallbackAdd int  fhandle,
MfCallbackFunc  func,
void *  data,
UINT32  reason
 

Add a callback.

Parameters:
fhandle  Open file handle
func  Callback function
data  Callback data
reason  Callback reason

RVCLOWLIBEXPORT ERRVALUE MfCallbackRemove int  fhandle,
MfCallbackFunc  func,
void *  data,
UINT32  reason
 

REmove a callback.

Parameters:
fhandle  Open file handle
func  Callback function
data  Callback data
reason  Callback reason

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
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

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.

Parameters:
fhandle  File handle returned by MfMakeFile or MfOpenFile

RVCLOWLIBEXPORT int MfCloseGen int  handle,
RVCGENINFO info,
int  hdrsize,
int  convtype
 

Close a previously opened "generic data" object.

Generic object functions are not generally used by application programmers, but rather are used by RVC programmers in creating object type-specific functions.

Parameters:
handle  Handle returned by MfMakeGen or MfOpenGen
info  Any header containing RVCGENINFO
hdrsize  Size of object header structure
convtype  Conversion type: RVCCONV_????

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
 

Surface fit line vector data using Bidirectional method.

NOTE: This algrorithm is designed for geophysical line survey data. This algorithm makes sense for a vector object that contains a set of near parallel 3D lines. Do not use this algorithm unless you know why you are doing that!

How it works: 1. Algorithm estimates a dominant direction of the lines in the input vector object or uses a user supplied direction (set SURFACEFIT_UseDirection flag). 2. The output raster will be oriented in such way that input vector lines will run approx. vertically. 3. Algortihm does surface fitting along lines using AlongLineMethod. All pixels that are covered by input lines will have an output value assigned after this step is complete. 4. Algorithm does surface fitting accross input lines (along output raster lines) using AcrossLineMethod.

AlongLineMethod:

  • INTERPOLATE_SplineLinear - linear interpolation
  • INTERPOLATE_SplineCubic - uses cubic BSpline
  • INTERPOLATE_SplineQuad - uses quadratic BSpline
  • INTERPOLATE_SplineBezier - uses Bezier spline
AcrossLineMethod:
  • INTERPOLATE_SplineLinear - linear interpolation
  • 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

RVCAPPLIBEXPORT int MfCopyObject int  sfhandle,
INT32  sinode,
int  dfhandle,
INT32  dpinode,
INT32 destinode,
MfFiltFuncProto  filt,
void *  filtdata,
UINT32  flags
 

Copy an object and possibly subobjects, filter.

Flags:

  • COPYRVC_SubObjects Copy subobjects under object
  • COPYRVC_RasterLinks Transfer raster links instead of copying the raster
  • COPYRVC_DBaseLinks Transfer dbase links instead of copying the dbase
  • COPYRVC_RVCLinks Copy RVC object links instead of the objects themselves
  • COPYRVC_ObjectLinks (COPYRVC_RasterLinks | COPYRVC_DBaseLinks)
  • COPYRVC_AllLinks (COPYRVC_ObjectLinks | COPYRVC_RVCLinks)
NOTE: This function will call MfUpdateFile() to update the file's contents.
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)
filt  Filter function to designate what to copy (NULL if not needed)
filtdata  User data passed to the filter function (NULL if not needed)
flags  COPYRVC_... flags

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.

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

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.

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