guisaliency.m

显著区域检测。求的图像中感兴趣区域的位置

% guiSaliency - a graphical user interface (GUI) version of the saliency code.
%
% guiSaliency
%    Starts the GUI and lets you select an image via the controls.
%
% guiSaliency(inputImage)
%    Uses inputImage as the image.
%       inputImage: the file name of the image relative to IMG_DIR,
%                   or the image data themselves,
%                   or an initialized Image structure (see initializeImage).
%
% guiSaliency(...,saliencyParams)
%    Uses the parameters specified in saliencyParams instead of the default
%    parameters.
%
% See also runSaliency, batchSaliency, initializeImage, defaultSaliencyParams,
%          guiLevelParams, dataStructures.

% This file is part of the SaliencyToolbox - Copyright (C) 2006-2007
% by Dirk B. Walther and the California Institute of Technology.
% See the enclosed LICENSE.TXT document for the license agreement. 
% More information about this project is available at: 
% http://www.saliencytoolbox.net

function varargout = guiSaliency(varargin)
% GUI initialization code
gui_Singleton = 1;
gui_State = struct('gui_Name',       mfilename, ...
                   'gui_Singleton',  gui_Singleton, ...
                   'gui_OpeningFcn', @guiSaliency_OpeningFcn, ...
                   'gui_OutputFcn',  @guiSaliency_OutputFcn, ...
                   'gui_LayoutFcn',  [], ...
                   'gui_Callback',   []);
if nargin && ischar(varargin{1})
   gui_State.gui_Callback = str2func(varargin{1});
end

if nargout
    [varargout{1:nargout}] = gui_mainfcn(gui_State, varargin{:});
else
    gui_mainfcn(gui_State, varargin{:});
end


%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% opening code executes just before guiSaliency is made visible.
function guiSaliency_OpeningFcn(hObject, eventdata, handles, varargin)

handles.output = hObject;
guidata(hObject, handles);

% define the needed global variables
declareGlobal;
global globalVars;
globalVars = 'global img params state salMap salData wta lastWinner winner shapeData';
eval(globalVars);
state = 'NoImage';

% try to use user-given image
if (length(varargin) >= 1)
  switch class(varargin{1})
    case 'struct'
      newImg = varargin{1};
      err = '';
      state = 'ImageLoaded';
    case {'char','uint8','double'}
      [newImg,err] = initializeImage(varargin{1});
    otherwise
      err = 1;
  end
  if isempty(err)
    img = checkImageSize(newImg,'GUI');
    if isnan(img.filename)
      imgName = '(from input arguments)';
    else
      imgName = img.filename;
    end
    set(handles.ImageName,'String',imgName);
    state = 'ImageLoaded';
  else
    beep;
    if ischar(varargin{1})
      name = varargin{1};
    else
      name = 'This';
    end
    uiwait(warndlg([name ' is not a valid image!'],...
                   'Not a valid image','modal'));
  end
end

% use user-given parameters if given
if (length(varargin) >= 2)
  if isstruct(varargin{2})
    params = varargin{2};
  else
    params = defaultSaliencyParams(img.size);
  end
else
  if isempty(img);
    params = defaultSaliencyParams;
  else
    params = defaultSaliencyParams(img.size);
  end
end

% some more initializations
setState(handles);
checkColorParams(handles);
fillParams(handles);
initializeVisFigures(handles);
updateImg(handles);
updateLocImg(handles);
debugMsg(sprintf('%s initialized in state: %s.',mfilename,state));

% this waits until the "Quit" button is pressed
uiwait(handles.figure1);

% clean up
cleanupVisFigures(handles);
eval(['clear ' globalVars 'globalVars']);
debugMsg('Global variables cleared - bye.');

try
  delete(handles.figure1);
catch
  % nothing to do
end
% that's it, bye bye.
return;


%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% Outputs from this function are returned to the command line.
function varargout = guiSaliency_OutputFcn(hObject, eventdata, handles)
varargout{1} = hObject;


%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% update the GUI according to the current state
function setState(h,newState)
global state;
if (nargin >= 2)
  state = newState;
end

debugMsg(['Setting state: ' state]);
switch state
  case 'NoImage'
    set(h.figure1,'Pointer','arrow');
    setEnable(0,[h.Restart,h.NextLoc,h.SaveMaps]);
    set(h.NextLoc,'String','Start');
  case 'ImageLoaded'
    set(h.figure1,'Pointer','arrow');
    setEnable(0,[h.Restart,h.SaveMaps]);
    setEnable(1,h.NextLoc);
    set(h.NextLoc,'String','Start');
  case 'MapsComputed'
    set(h.figure1,'Pointer','arrow');
    setEnable(1,[h.Restart,h.NextLoc,h.SaveMaps]);
    set(h.NextLoc,'String','Next Location');
  case 'Busy'
    set(h.figure1,'Pointer','watch');
    setEnable(0,[h.Restart,h.NextLoc,h.SaveMaps]);
  otherwise
    debugMsg(['Unknown state:' state]);
end
drawnow;
return;


%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% set color features accoring to image type
function checkColorParams(handles)
global params img;
if ~isempty(img)
  switch img.dims
    case 2
      % gray-scale image: no color features
      params = removeColorFeatures(params,0);
      setEnable(0,[handles.Color,handles.WeightCol,...
                   handles.Skin,handles.WeightSkin]);
      debugMsg('Gray scale image - removed color features.');
    case 3
      % color image
      setEnable(1,[handles.Color,handles.Skin]);
      setFeature(handles.Color,handles.WeightCol);
      setFeature(handles.Skin,handles.WeightSkin);
    otherwise
      debugMsg(sprintf('Unknown image format with %d dimensions.',img.dims));
  end
end
return;

               
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% fill the GUI with the parameters from the global variable params
function fillParams(handles)
global params DEBUG_FID;
setFeature(handles.Color,handles.WeightCol);
setFeature(handles.Intensities,handles.WeightInt);
setFeature(handles.Orientations,handles.WeightOri);
setFeature(handles.Skin,handles.WeightSkin);
setEnable(get(handles.Orientations,'Value'),[handles.NumOriText,handles.NumOri]);
set(handles.NumOri,'String',num2str(numel(params.oriAngles)));
setNormType(handles);
setShapeMode(handles);
set(handles.ToggleDebug,'Value',DEBUG_FID);

styleStrings = {'Contour','ContrastModulate','None'};
style = strmatch(params.visualizationStyle,styleStrings);
if isempty(style)
  style = 3;
end
set(handles.VisStyle,'Value',style,'UserData',styleStrings);

return;


%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% check with user that parameters can be changed
function response = confirmParamsChange(handles)
global state;
switch state
  case {'NoImage','ImageLoaded'}
    response = 1;
  case 'MapsComputed'
    button = questdlg({'Changing the parameters now will reset the computation.',...
                       'Would you like to proceed anyway?'},...
                       'Change parameters?',...
                       'Yes','No','Yes');
    response = strcmp(button,'Yes');
    if response
      setState(handles,'ImageLoaded');
      fprintf('---------------------------\n');
    end
  otherwise
    debugMsg(['Unknown state: ' state]);
    response = 0;
end


%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% Loading an image
function NewImage_Callback(hObject, eventdata, handles)
declareGlobal;
global img params state;
prevState = state;
setState(handles,'Busy');

if isempty(img)
  defName = '';
else
  defName = img.filename;
end

err = 1;
while ~isempty(err)
  [newName,newPath] = uigetfile('*.*','Select an new image',defName);
  if (newName == 0)
    % User pressed 'cancel' - keep old file
    setState(handles,prevState);
    return;
  end
  
  [newImg,err] = initializeImage([newPath newName]);
  if ~isempty(err)
    beep;
    uiwait(warndlg(sprintf('%s is not a valid image!',newName),...
                   'Not a valid image','modal'));
    defName = '';
  end
end

% image is okay, set as img for analyses
img = checkImageSize(newImg,'GUI');
set(handles.ImageName,'String',newName);
if (params.foaSize < 0)
  p = defaultSaliencyParams(img.size);
  params.foaSize = p.foaSize;
  setShapeMode(handles);
end

% Replacing an old image? output separator
if strcmp(prevState,'MapsComputed')
  fprintf('---------------------------\n');
end

% some house keeping
state = 'ImageLoaded';
checkColorParams(handles);
updateImg(handles);
updateLocImg(handles);
setState(handles);
debugMsg(sprintf('Loaded image %s.\n',img.filename));
return;



%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% Feature selection and weights                                  %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% get the values for a particular feature from the GUI controls
function getFeature(hSelect,hWeight,handles)
global params;
if ~confirmParamsChange(handles)
  return;
end
name = get(hSelect,'Tag');
idx = strmatch(name,params.features);

if get(hSelect,'Value')
  set(hWeight,'Enable','on');

  % need to add this feature?
  if isempty(idx)
    params.features = {params.features{:},name};
    params.weights = [params.weights 1];
    idx = strmatch(name,params.features);
  end
  
  % get weight value from text box
  w = str2num(get(hWeight,'String'));
  if ~isempty(w)
    params.weights(idx(1)) = w(1);
  end
else
  set(hWeight,'Enable','off');
  
  % need to remove this feature?
  if ~isempty(idx)
    newIdx = setdiff([1:length(params.features)],idx);
    params.features = {params.features{newIdx}};
    parmas.weights = [params.weights(newIdx)];
  end
end
return;

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% set the GUI controls for a particular feature
function setFeature(hSelect,hWeight)
global params;
name = get(hSelect,'Tag');
idx = strmatch(name,params.features);

if isempty(idx)
  set(hSelect,'Value',0);
  set(hWeight,'Enable','off');
else
  set(hSelect,'Value',1);
  set(hWeight,'Enable','on','String',num2str(params.weights(idx(1))));
end
return;

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% enable/disable a vector of GUI elements
function setEnable(value,hs)
enableStrings = {'off','on'};
for h = 1:length(hs)
  set(hs(h),'Enable',enableStrings{value+1});
end
return;


%%%% Color %%%%

% Color checkbox
function Color_Callback(hObject, eventdata, handles)
getFeature(handles.Color,handles.WeightCol,handles);
setFeature(handles.Color,handles.WeightCol);

% Color weight textbox
function WeightCol_Callback(hObject, eventdata, handles)
getFeature(handles.Color,handles.WeightCol,handles);
setFeature(handles.Color,handles.WeightCol);

% Create color weight textbox
function WeightCol_CreateFcn(hObject, eventdata, handles)
if ispc && isequal(get(hObject,'BackgroundColor'), get(0,'defaultUicontrolBackgroundColor'))
    set(hObject,'BackgroundColor','white');
end


%%%% Intensities %%%%

% Intensities checkbox
function Intensities_Callback(hObject, eventdata, handles)
getFeature(handles.Intensities,handles.WeightInt,handles);
setFeature(handles.Intensities,handles.WeightInt);

% Intensities weight textbox
function WeightInt_Callback(hObject, eventdata, handles)
getFeature(handles.Intensities,handles.WeightInt,handles);
setFeature(handles.Intensities,handles.WeightInt);

% create Intensities weight textbox
function WeightInt_CreateFcn(hObject, eventdata, handles)
if ispc && isequal(get(hObject,'BackgroundColor'), get(0,'defaultUicontrolBackgroundColor'))
    set(hObject,'BackgroundColor','white');
end


%%%% Orientations %%%%

% Orientations checkbox
function Orientations_Callback(hObject, eventdata, handles)
getFeature(handles.Orientations,handles.WeightOri,handles);
setFeature(handles.Orientations,handles.WeightOri);
setEnable(get(hObject,'Value'),[handles.NumOriText,handles.NumOri]);

% Orientaions weight textbox
function WeightOri_Callback(hObject, eventdata, handles)
getFeature(handles.Orientations,handles.WeightOri,handles);
setFeature(handles.Orientations,handles.WeightOri);

% create Orientations weight textbox
function WeightOri_CreateFcn(hObject, eventdata, handles)
if ispc && isequal(get(hObject,'BackgroundColor'), get(0,'defaultUicontrolBackgroundColor'))
    set(hObject,'BackgroundColor','white');
end

% number of orientations textbox
function NumOri_Callback(hObject, eventdata, handles)
global params
if confirmParamsChange(handles)
  n = str2num(get(hObject,'String'));
  if ~isempty(n)
    n = max(round(n(1)),1);
    params.oriAngles = [0:(n-1)] * 180 / n;
  end
end
set(hObject,'String',num2str(numel(params.oriAngles)));

% create number of orientations textbox
function NumOri_CreateFcn(hObject, eventdata, handles)
if ispc && isequal(get(hObject,'BackgroundColor'), get(0,'defaultUicontrolBackgroundColor'))
    set(hObject,'BackgroundColor','white');
end


%%%% Skin hue %%%%

% skin hue checkbox
function Skin_Callback(hObject, eventdata, handles)
getFeature(handles.Skin,handles.WeightSkin,handles);
setFeature(handles.Skin,handles.WeightSkin);

% skin hue weight textbox
function WeightSkin_Callback(hObject, eventdata, handles)
getFeature(handles.Skin,handles.WeightSkin,handles);
setFeature(handles.Skin,handles.WeightSkin);

% create skin hue weight textbox
function WeightSkin_CreateFcn(hObject, eventdata, handles)
if ispc && isequal(get(hObject,'BackgroundColor'), get(0,'defaultUicontrolBackgroundColor'))
    set(hObject,'BackgroundColor','white');
end

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%                       Parameters                                         %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

% SetPyrLevels button
function SetPyrLevels_Callback(hObject, eventdata, handles)
global params
if confirmParamsChange(handles)
  params.levelParams = guiLevelParams(params.levelParams);
end

% set the GUI normtype controls to parameters
function setNormType(handles)
global params;
normTypes = get(handles.NormType,'String');
idx = strmatch(params.normtype,normTypes);
if isempty(idx)
  params.normtype = normTypes{get(handles.NormType,'Value')};
else
  set(handles.NormType,'Value',idx(1));
end
isIter = strcmp(params.normtype,'Iterative');
setEnable(isIter,[handles.NumIterText,handles.NumIter])
set(handles.NumIter,'String',num2str(params.numIter));

% get the normtype parameters from the GUI controls
function getNormType(handles)
global params;