int prompt_distance ( char *message, double *distance )

char   *message;      // prompt message string

double *distance;     // address of double to receive distance

Synopsis

#include "silver.h"

The prompt_distance function prompts the user for a distance from the current cursor location (the point specified by worldx , worldy and worldz). The prompt specified by message is displayed at bottom of the screen. The user is then allowed to move the cursor from the cursor location to another point in world coordinates, generating a distance value, which is stores in distance .

Parameters

message is a null-terminated string containing a prompt message. distance is the address of a double that is to receive the distance value

Return Value

prompt_distance stores the distance value into distance and returns 1 if the distance is successfully selected; otherwise (the user hits Esc) prompt_distance returns 0, and the double at distance is not modified.