Leica TPS1200 Series Reference Manual page 123

GeoCOM Reference Manual
13.3.5 FTR_Download – Download file
AUT_ReadTol ............................................... ............................................................................................................................................................................................................................. ........................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................ 9008
9013................................................................................................................................................. AUT_ReadTol
C-Declaration
FTR_Download(unsigned short unBlockNumber, FTR_BLOCK &rBlock)
VB-Declaration
VB_FTR_Download(BlockNumber As Integer, Block As FTR_BLOCK)
Request
%R1Q,23304:unBlockNumber
ASCII-Response
%R1P,0,0:RC,FTR_BLOCK_val,FTR_BLOCK_len
Remarks
This command gets one single block of data. The command FTR_SetupDownload has to be called first.
Note: The maximum block number in C/VB is 65535/32767 therefore the file size is limited to 28MB/14MB.
Visual Basic does not know data type unsigned integer.
Parameters
unBlockNumber
rBlock
Return-Codes
GRC_OK
GRC_FTR_MISSINGSETUP
GRC_FTR_INVALIDINPUT
GRC_FTR_FILEACCESS
See Also
FTR_SetupDownload
FTR_AbortDownload
Example
GRC_TYPE
FTR_DEVICETYPE
FTR_FILETYPE
FTR_BLOCK
char
unsigned short
unsigned short
unsigned short
FILE
unsigned short
eDeviceType = FTR_DEVICE_PCPARD;
eFileType = FTR_FILE_IMAGES;
strcpy(szFileNameSrc, "image000.jpg");
unBlockSize = FTR_MAX_BLOCKSIZE;
rc = FTR_SetupDownload(eDeviceType, eFileType, szFileNameSrc,
if(rc == GRC_OK)
{
// open the file
pFile = fopen(szFileNameSrc, "wb");
if(pFile == NULL)
{
// error
return;
}
for(unBlockNumber = 1; unBlockNumber <= unNumOfBlocks; unBlockNumber++)
{
rc = FTR_Download(unBlockNumber, Block);
if(rc != GRC_OK)
Leica TPS1200 – Version 1.50
in
out
0
13060
13059
13056
rc;
eDeviceType;
eFileType;
Block;
szFileNameSrc[128];
unBlockNumber;
unBlockSize;
unNumOfBlocks;
*pFile;
unWritten;
unBlockSize, unNumOfBlocks);
Blocknumber. The block number starts with 1. If block
number is 0 then the download process is aborted
Block of data.
Execution successful.
Missing setup.
First block is missing.
File access error.
File Transfer - FTR
123