Skip to content

Commit

Permalink
Move to GitHub
Browse files Browse the repository at this point in the history
  • Loading branch information
@thrynae
thrynae committed Jul 6, 2020
0 parents commit 8c5681b
Show file tree
Hide file tree
Showing 2 changed files with 209 additions and 0 deletions.
11 changes: 11 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
This function tries multiple solutions for maximizing the figure window, so it should work on nearly all releases of Matlab and Octave on nearly all OSes (Windows/Mac/Unix). If you know more solutions, please contact me, so I can add it to the list.

1. attempt to set the WindowState property to maximized
2. use JavaFrame to maximize the figure
3. press alt-space followed by x (Windows/Linux hotkey)
4. ugly solution: set the position to the screen size minus a small margin (this includes an attempt to check for a multiple monitor set up, which has a flaky success-rate)

Licence: CC by-nc-sa 4.0

British English SEO:
maximise figure window
198 changes: 198 additions & 0 deletions maximize.m
Original file line number Diff line number Diff line change
@@ -0,0 +1,198 @@
function maximize(hFig)
% Maximize the figure window (multiple strategies implemented)
% If no figure number or handle is given, gcf will be used.
%
% The last option that will be tried is the ugly solution of changing the position to the
% screensize (but it does check for a multiple monitor set up, except on Octave) and adds a margin
% to avoid overlap with the taskbar (which is mainly an issue if you have your taskbar in a
% non-default place).
%
%partly adapted from:
%http://undocumentedmatlab.com/blog/minimize-maximize-figure-window
%http://www.mathworks.com/matlabcentral/fileexchange/25471-maximize
%
% _______________________________________________________________________
% | Compatibility | Windows 10 | Ubuntu 20.04 LTS | MacOS 10.15 Catalina |
% |---------------|-------------|------------------|----------------------|
% | ML R2020a | works | not tested | not tested |
% | ML R2018a | works | works | not tested |
% | ML R2015a | works | works | not tested |
% | ML R2011a | works | works | not tested |
% | ML 6.5 (R13) | works | not tested | not tested |
% | Octave 5.2.0 | works #1 | works #1 | not tested |
% | Octave 4.4.1 | works #1 | not tested | works #1 |
% """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
% note #1: real maximization may fail
%
% Version: 1.2.1
% Date: 2020-07-06
% Author: H.J. Wisselink
% Licence: CC by-nc-sa 4.0 ( http://creativecommons.org/licenses/by-nc-sa/4.0 )
% Email= 'h_j_wisselink*alumnus_utwente_nl';
% Real_email = regexprep(Email,{'*','_'},{'@','.'})

if nargin < 1
hFig = gcf;
end

%option 0: on newer Matlab releases you can set the WindowState property of
%figures to 'maximized'. This was introduced in R2018a.
try
set(hFig,'WindowState','maximized')
failed=false;
catch
failed=true;
end
if failed
try
%The JavaFrame solution may be removed at some point in the future, although Mathworks is
%telling us this for years. This should work regardless of OS.
maximize_option1(hFig)
failed=false;
catch
failed=true;
end
end
if failed
try
%Uses alt-space followed by X hotkeys, so this is OS-specific. It works on Windows and on
%Ubuntu (so I will assume it works on all Linux distributions), but apparently not on Mac.
%Note: on slower machines (like the VM Ubuntu), the key presses might not have enough time
%to be processed. To cover this, a check is run if the figure covers at least 70% of the
%screen.
if ~ismac
PercentOfScreenCoveredCritrerion=70;
maximize_option2(hFig,PercentOfScreenCoveredCritrerion)
failed=false;
else
error('trigger error if Mac')
end
catch
failed=true;
end
end
if failed
try
%'margins' is either in fractions or in pixels. If there is 1 fraction, all values are
%assumed to be fractions
%Syntax: margin=[left bottom right top]
%margins=[0.045 0.045 0.025 0.09];
margins=[60 45 10 90];
maximize_option_last(hFig,margins)
failed=false;
catch ME
failed=true;
end
end
% The 'option_last' script should always work, so rethrow the MessageException if it failed.
if failed
rethrow(ME)
end
end
function maximize_option1(hFig)
%Works on most Matlab releases
w=warning('off','all');
drawnow % Required to avoid Java errors
jFig = get(hFig,'JavaFrame'); %#ok<JAVFM>
jFig.setMaximized(true);
warning(w);
drawnow,pause(0.0001);%give Matlab time to refresh
end
function maximize_option2(hFig,PercentOfScreenCoveredCritrerion)
%Uses the alt-space followed by X to maximize
%This hotkey combination works on Windows (tested on W10, most Windows versions will have this). It
%also seems to work on Ubuntu, but not on Mac.
isOctave = exist('OCTAVE_VERSION', 'builtin') ~= 0;

if isOctave
%Octave has a different syntax for calling Java (and the key IDs need to be hard-coded, which
%they shouldn't be, as they may be different from keyboard to keyboard).
hardcoded.VK_ALT=18;
hardcoded.VK_SPACE=32;
hardcoded.VK_X=88;

figure(hFig),drawnow,pause(0.1)
old_setting=get(hFig,'Visible');%just in case it is set to off
set(hFig,'Visible','off');
drawnow,pause(0.1)
set(hFig,'Visible','on');
drawnow,pause(0.1)
robot = javaObject('java.awt.Robot');
javaMethod('keyPress',robot,hardcoded.VK_ALT); %// send ALT
javaMethod('keyPress',robot,hardcoded.VK_SPACE); %// send SPACE
javaMethod('keyRelease',robot,hardcoded.VK_SPACE); %// release SPACE
javaMethod('keyRelease',robot,hardcoded.VK_ALT); %// release ALT
drawnow,pause(0.5)
javaMethod('keyPress',robot,hardcoded.VK_X); %// send X
drawnow,pause(0.5)
javaMethod('keyRelease',robot,hardcoded.VK_X); %// release X
drawnow,pause(0.5)
if strcmpi(old_setting,'off')
set(hFig,'Visible',old_setting);%reset setting
end
else
figure(hFig) %// make it the current figure
robot = java.awt.Robot;
robot.keyPress(java.awt.event.KeyEvent.VK_ALT); %// send ALT
robot.keyPress(java.awt.event.KeyEvent.VK_SPACE); %// send SPACE
robot.keyRelease(java.awt.event.KeyEvent.VK_SPACE); %// release SPACE
robot.keyRelease(java.awt.event.KeyEvent.VK_ALT); %// release ALT
robot.keyPress(java.awt.event.KeyEvent.VK_X); %// send X
robot.keyRelease(java.awt.event.KeyEvent.VK_X); %// release X
end
%check if maximization failed
screen=get(0,'screensize');
unit_changed=false;
if ~strcmp(get(hFig,'Units'),get(0,'Units'))
old_units=get(hFig,'Units');
set(hFig,'Units',get(0,'Units'))
unit_changed=true;
end
drawnow,pause(0.5),figpos=get(hFig,'Position');
if unit_changed,set(hFig,'Units',old_units);end
covered=100*prod(figpos([3 4]))/prod(screen([3 4]));
if covered < PercentOfScreenCoveredCritrerion
%fprintf('%.0f%% of screen covered\n',covered)
error('failed')
end
end
function maximize_option_last(hFig,margins)
% Get the screen size and set the figure size to the screen size minus a small margin.
% Very ugly, but it should work on all releases of Matlab (and possibly also all releases of
% Octave)

%get the size of the screen(s)
dual=get(0,'MonitorPositions');%only returns main monitor in Octave
if size(dual,1)>1%multiple monitors
%Find out which monitor the figure is currently on and use that monitor
pos=get(hFig,'Position');
t=zeros(size(dual,1),1);
for monitor=1:size(dual,1)
current=dual(monitor,:);
if (pos(1)>=current(1)) && (pos(1)<(current(1)+current(3))) &&...
(pos(2)>=current(2)) && (pos(2)<(current(2)+current(4)))
t(monitor)=1;
end
end
% There should be only one, but just in case of a race condition, choose the first. In case of
% no results (shouldn't happen either), select the main monitor
t2=find(t,1,'first');if isempty(t2),t2=1;end
dual=dual(t2,:);
end
newpos=zeros(1,4);
if any(margins~=round(margins))
%fractions
newpos(1)=dual(1)+margins(1)*dual(3);%corner coordinate + margin
newpos(2)=dual(2)+margins(2)*dual(4);%corner coordinate + margin
newpos(3)=dual(3)*(1-(margins(1)+margins(3)));
newpos(4)=dual(4)*(1-(margins(2)+margins(4)));
else
%pixels
newpos(1)=dual(1)+margins(1);
newpos(2)=dual(2)+margins(2);
newpos(3)=dual(3)-(margins(1)+margins(3));
newpos(4)=dual(4)-(margins(2)+margins(4));
end
newpos=round(newpos);
set(hFig,'Position',newpos)
end

0 comments on commit 8c5681b

Please sign in to comment.