Callback function for custom feedback drawing.
typedef void RubberLineInfoProc ( const API_RubberLineInfo* info );
- Information on the actual input state.
You should implement this function if you have to give graphical feedback for the input operation invoked from your API tool add-on. This callback routine should be passed as a parameter when calling the APIIo_GetPointID, APIIo_GetLineID and APIIo_GetArcID interface functions. During the input process your procedure is called repeatedly as the mouse moves. In the
info parameter you get the actual mouse coordinate and the current drawing phase. Call the APIIo_DrawRubberLineID interface function to draw your rubber lines. The lines are drawn in XOR mode, therefore you can use the same code for both the drawing and erasing phases when calling back.
From ARCHICAD 9 the z coordinates are retrieved even when the input plane has not been defined. The height value can be non-zero if the cursor is on one of the neigs of a three-dimensional element, or gravity method is switched on for the element type the cursor is currently cruising above.
See APIIo_DrawRubberLineID for example of using the rubber line drawing callback function.
- Version: API 2.1 or later
- Header: APIdefs_Callback.h