std-inp-getvector


Synopsis

(std-inp-getvector <flag> <kwd> <msg> <def> <bpt>)

Description

Asks and returns a vector or displacement.

You can define this vector weither with one point and empty second point, or with two points.

With the bpt (basepoint) argument given, enter the 2.point (here the bpt is the default vector), without bpt enter 2 points or the 1.point is the vector.

Arguments

flag: integer, same as the INITGET flag or nil

kwd: a initget-like string or a list of strings or nil

msg: a string to be displayed as a prompt or nil. If nil "\nBasepoint or displacement: " is prompted.

def: a default value as point.

bpt: a point from which the initial rubberband is drawn or nil. If not nil only one point or a number is required. If nil a number or two points.

Return Value

A point, either the given vector or the default value.

Side Effects

Interrupts the program flow, prints the formatted message and waits for user input.

Module

(std-require 'STDINPUT)

Defined in STDINPUT