This is really simple, so many people will use this functionality already, but I just thought I'd make it a bit easier for everyone (and include rigorous error checking while I'm at it)...
raiseFigure can be used to replace MATLAB's
fh = figure() and
figure(h)
commands where a user wishes to identify a figure by it's title name (and tag), rather than by it's handle.
This is useful in cases where the same figure needs to be accessed by multiple workspaces.
For example, a function (which is called multiple times) updates a figure each time (replotting some data, say). There are many ways to do this, but typically, the plot must be initialised before the first function call, then the figure handle passed during each function call.
Instead, raiseFigure('FigTitle') can be used within the function call (instead of figure() ). Each time that function is executed, it'll either create or make current the same figure (which has the title 'FigTitle')
The 'Tag' property of MATLAB figures is used, so you can change the displayed figure Name if you like.
Background:
I coded this because I had some functions with figure numbers hard-coded. So I'd call figure(801) (or whatever number) and each time the function was called, it'd plot into figure 801. Of course, sooner or later I used the same number twice and got into a massive mess!
|
