psychtoolbox-3-common 3.0.11.20131230.dfsg1-1build1 / usr / share / psychtoolbox-3 / PsychOneliners / GetEchoNumber.m

function number = GetEchoNumber(window,msg,x,y,textColor,bgColor,varargin)
% number = GetEchoNumber(window, msg, x, y [, textColor][, bgColor][, deviceIndex][, untilTime=inf][, KbCheck args...])
%
% Get a number typed at the keyboard. Entry is terminated by <return> or
% <enter>. Typed characters are displayed on the screen. Useful for i/o in
% a Screen window. Equivalent to "number = str2num(GetEchoString(...))".
%
% Returns the empty matrix if no number is entered. Returns a column vector
% with multiple numbers if more than one number is entered.
%
% Typed characters are displayed in the window. The delete or backspace key
% is handled correctly, ie., it erases the last typed number.
%
% 'window' = Window to draw to. 'msg' = A message string displayed to
% prompt for input. 'x', 'y' = Start position of message prompt.
% 'textColor' = Color to use for drawing the text. 'bgColor' = Background
% color for text. By default, the background is transparent. If a non-empty
% 'bgColor' is specified it will be used. The current alpha blending
% setting will affect the appearance of the text if 'bgColor' is specified!
%
% See also: GetNumber, GetString, GetEchoString

%
% 2/4/97  dhb	Wrote it.
% 3/15/97 dgp   Replaced sscanf by str2num, which copes better with nonnumeric input,
%	            returning an empty matrix instead of a null string.
% 3/15/97 dgp   Call GetEchoString instead of doing the work here.
% 3/18/97 dhb   Got rid of obsolete 's' interface.
% 10/22/10  mk  Switch to use of KbGetChar for keyboard input.
% 09/06/13  mk  Fix/Imrove help text.

if nargin < 6
    bgColor = [];
end

if nargin < 5
    textColor = [];
end

string = GetEchoString(window,msg,x,y,textColor,bgColor,1,varargin{:});
number = str2num(string); %#ok<ST2NM>

return;