blurFigure - blurs and prevents interaction on figure window

blurs a specified figure window and prevents interaction with it until the figure is un-blurred
1.4K Downloads
Updated 3 May 2019

View License

Syntax:
hFigBlur = blurFigure(hFig, state)

Description:
blurFigure(hFig) blurs figure hFig and prevents interaction with it. The only interaction possible is with user-created controls on the blurring panel (see below).

hFigBlur = blurFigure(hFig) returns the overlaid blurred figure pane. This is useful to present a progress bar or other GUI controls, for user interaction during the blur phase.

blurFigure(hFig,STATE) sets the blur status of figure hFig to STATE, where state is 'on','off',true or false (default='on'/true).

blurFigure(hFig,'on') or blurFigure(hFig,true) is the same as: blurFigure(hFig).

blurFigure(hFig,'off') or blurFigure(hFig,false) is the same as: close(hFigBlur).

blurFigure('demo') displays a simple demo of the blurring (see attached screenshot).

Input parameters: (all parameters are optional)

hFig - (default=gcf) Handle(s) of the modified figure(s). If component handle(s) is/are specified, then the containing figure(s) will be inferred and used.

state - (default='on'/true) blurring flag: 'on','off',true or false

Examples:
hFigBlur = blurFigure(hFig); % blur hFig (alternative #1)
hFigBlur = blurFigure(hFig,true); % blur hFig (alternative #2)

hFigBlur = blurFigure(hFig,false); % un-blur hFig (alternative #1)
hFigBlur = blurFigure(hFig,'off'); % un-blur hFig (alternative #2)
close(hFigBlur); % un-blur hFig (alternative #3)
delete(hFigBlur); % un-blur hFig (alternative #4)

blurFigure('demo'); % blur demo with progress bar etc.

Technical Description:
http://UndocumentedMatlab.com/blog/blurred-matlab-figure-window

Bugs and suggestions:
Please send to Yair Altman (altmany at gmail dot com)

Warning:
This code heavily relies on undocumented and unsupported Matlab functionality. It works on Matlab 7.9 (R2009b) and higher (up to R2013a), but use at your own risk!

Cite As

Yair Altman (2024). blurFigure - blurs and prevents interaction on figure window (https://www.mathworks.com/matlabcentral/fileexchange/30666-blurfigure-blurs-and-prevents-interaction-on-figure-window), MATLAB Central File Exchange. Retrieved .

MATLAB Release Compatibility
Created with R2010b
Compatible with R2009b to R2013a
Platform Compatibility
Windows macOS Linux
Categories
Find more on Interactive Control and Callbacks in Help Center and MATLAB Answers

Community Treasure Hunt

Find the treasures in MATLAB Central and discover how the community can help you!

Start Hunting!
Version Published Release Notes
1.2.0.1

Updated the release compatibility limitations (no code changes)

1.2.0.0

Fix for R2011a; fixed description;

1.1.0.0

Fixed the demo code

1.0.0.0