Previous Chapter Back to content   Next Chapter

VISION Documentation (VAPI)

Last update: 08/04/18


PROGRESS INTERFACE

  

Summary
Interface prefix Pr
Number of functions 4
Description Set of functions allowing an action on VISION's progress windows, to inform user about work in progress.

 

Prototype void cdecl PrSetProg(long pc)
Parameters [IN] pc: percentage of work done (0...100)
Return None
Description Updates the percentage indicator in the progress window
Comments If the pc paramteter is out of limits, it will be shifted to the nearest limit. The type long is used to ensure compatibility between compilers.
VAPI version 1.00 or greater

 

Prototype void cdecl PrOptimize(long mask)
Parameters [IN] cpu030: 68030 instructions will be used when running
[IN] mask: bit mask having the following meaning:
Bit 0: 68003 instructios will be used
Bit 1: DSP will be used
Return None
Description Indicates to the user that 68030 and/or DSP optimisations will be used when running. This will display a "030!" or "DSP!" in the progress window
Comments The type long is used to ensure compatibility between compilers
VAPI version 1.00 or greater

 

Prototype void cdecl PrSetText(long no_line, char *text)
Parameters [IN] no_line : text area index (0, 1, or 2)
[IN] text : pointer to string to be displayed
Return None
Description Displays in the defined text area of the progress window, the specified text
Comments The type long is used to ensure compatibility between compilers. If no_line is not valid, nothing happens.
VAPI Version 1.02 or greater

 

Prototype long cdecl PrSetProgEx(long pc)
Parameters [IN] pc : percentage of work done (0...100)
Return 0 : User did not request cancel of current operation (Run)
!= 0 : User requested to cancel the current operation
Description Update current progress and retuns a non zero value if user wants to cancel the operation.
Comments If the pc paramteter is out of limits, it will be shifted to the nearest limit. The type long is used to ensure compatibility between compilers.
Used together with LDVF_SUPPORTCANCEL flag, this function enables managing cancel from a LDVRun call.
VAPI Version 1.02 or greater


Previous chapter Back to content   Next Chapter

VISION Documentation (VAPI)

Last update: 08/04/18


PROGRESS INTERFACE