Custom Progress-Indicator

Specifies a custom progress indicator. More...

Typedefs

typedef A3DVoid(* A3DCallbackProgressEnd) ()
 
typedef A3DVoid(* A3DCallbackProgressIncrement) (A3DInt32)
 
typedef A3DVoid(* A3DCallbackProgressSize) (A3DInt32)
 
typedef A3DVoid(* A3DCallbackProgressStart) (A3DInt32)
 
typedef A3DVoid(* A3DCallbackProgressTitle) (A3DUTF8Char *msg)
 

Functions

A3DStatus A3DDllSetCallbacksProgress (A3DCallbackProgressStart, A3DCallbackProgressSize, A3DCallbackProgressIncrement, A3DCallbackProgressEnd, A3DCallbackProgressTitle, A3DInt32 *)
 Sets callbacks for progress bar facility. More...
 

Detailed Description

Specifies a custom progress indicator.

This section describes the function and types that enable you to specify a custom progress indicator, such as a status bar.

Typedef Documentation

◆ A3DCallbackProgressStart

typedef A3DVoid(* A3DCallbackProgressStart) (A3DInt32)

A callback function the library invokes as it prepares to perform a potentially time-consuming process. The argument identifies the processing phase, as follows:

Processing phaseDescription
0Undefined.
1Parsing the file
2Writing file
3Reading or building the model, which follows parsing the file (processing phase 1)
Version
2.0

◆ A3DCallbackProgressSize

typedef A3DVoid(* A3DCallbackProgressSize) (A3DInt32)

A callback function the library invokes to report an approximate size of the PRC stream being processed. The size is independent of units and is bounded only by the limit of the A3DInt32 type.

Version
2.0

◆ A3DCallbackProgressIncrement

typedef A3DVoid(* A3DCallbackProgressIncrement) (A3DInt32)

A callback function the library intermittently invokes while processing the PRC stream. As processing proceeds, the argument increments from 0 to a maximum of Size, where Size is the argument provided in A3DCallbackProgressSize.

Version
2.0

◆ A3DCallbackProgressEnd

typedef A3DVoid(* A3DCallbackProgressEnd) ()

A callback function the library invokes when it finishes the process.

Version
2.0

◆ A3DCallbackProgressTitle

typedef A3DVoid(* A3DCallbackProgressTitle) (A3DUTF8Char *msg)

A callback function the library invokes to provide a text string relevant to the processing phase. In the case of reading PRC data from a file, the argument provides the name of the file containing the PRC stream.

Version
2.0

Function Documentation

◆ A3DDllSetCallbacksProgress()

A3DStatus A3DDllSetCallbacksProgress ( A3DCallbackProgressStart  fnPrgStart,
A3DCallbackProgressSize  fnPrgSize,
A3DCallbackProgressIncrement  fnPrgIncrement,
A3DCallbackProgressEnd  fnPrgEnd,
A3DCallbackProgressTitle  fnPrgTitle,
A3DInt32 piBreak 
)

Sets callbacks for progress bar facility.

This function configures the library with the callback functions that implement a custom progress indicator, such as a status bar.

The last argument passed to this function sets a break. The library checks this variable at every significant step in processing the PRC. If the value is non-zero, the library stops processing the PRC data.

Version
2.0
Attention
The library stops processing the PRC data if the last argument passed to this function is non-zero.
Sample code
Return values
A3D_INITIALIZE_NOT_CALLED
Returns
A3D_SUCCESS in case of success or an error code
Return values
A3D_CALLBACK_INVALID_BREAK_VALUE
A3D_SUCCESS