% -*- texinfo -*-
% @deftypefn {Function File} {[@var{vals}] = } qtgetblk (@var{I},@var{S},@var{dim})
% @deftypefnx {Function File} {[@var{vals},@var{idx}] = } qtgetblk (@var{I},@var{S},@var{dim})
% @deftypefnx {Function File} {[@var{vals},@var{r},@var{c}] = } qtgetblk (@var{I},@var{S},@var{dim})
% Obtain block values from a quadtree decomposition.
%
% [vals]=qtgetblk(I,S,dim) returns a dim-by-dim-by-k array in
% @var{vals} which contains the dim-by-dim blocks in the quadtree
% decomposition (@var{S}, which is returned by qtdecomp) of @var{I}. If
% there are no blocks, an empty matrix is returned.
%
% [vals,idx]=qtgetblk(I,S,dim) returns @var{vals} as described above.
% In addition, it returns @var{idx}, a vector which contains the linear
% indices of the upper left corner of each block returned (the same
% result as find(full(S)==dim)).
%
% [vals,r,c]=qtgetblk(I,S,dim) returns @var{vals} as described, and two
% vectors, @var{r} and @var{c}, which contain the row and column
% coordinates of the blocks returned.
%
% @seealso{qtdecomp, qtsetblk}
% @end deftypefn