octave_packages/geometry-1.5.0/polygons2d/supportFunction.m

   1 %% Copyright (C) 2003-2011 David Legland <david.legland@grignon.inra.fr>
   2 %% Copyright (C) 2012 Adapted to Octave by Juan Pablo Carbajal <carbajal@ifi.uzh.ch>
   3 %% All rights reserved.
   4 %%
   5 %% Redistribution and use in source and binary forms, with or without
   6 %% modification, are permitted provided that the following conditions are met:
   7 %%
   8 %%     1 Redistributions of source code must retain the above copyright notice,
   9 %%       this list of conditions and the following disclaimer.
  10 %%     2 Redistributions in binary form must reproduce the above copyright
  11 %%       notice, this list of conditions and the following disclaimer in the
  12 %%       documentation and/or other materials provided with the distribution.
  13 %%
  14 %% THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ''AS IS''
  15 %% AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  16 %% IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  17 %% ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR
  18 %% ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  19 %% DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
  20 %% SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
  21 %% CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  22 %% OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  23 %% OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  24 %%
  25 %% The views and conclusions contained in the software and documentation are
  26 %% those of the authors and should not be interpreted as representing official
  27 %% policies, either expressed or implied, of the copyright holders.
  28
  29 %% -*- texinfo -*-
  30 %% @deftypefn {Function File} {@var{h} = } suppportFunction (@var{polygon})
  31 %% @deftypefnx {Function File} {@var{h} = } suppportFunction (@var{polygon}, @var{n})
  32 %% @deftypefnx {Function File} {@var{h} = } suppportFunction (@var{polygon}, @var{v})
  33 %% Compute support function of a polygon
  34 %%
  35 %%   H = supportFunction(POLYGON, N)
  36 %%   uses N points for suport function approximation
  37 %%
  38 %%   H = supportFunction(POLYGON)
  39 %%   assume 24 points for approximation
  40 %%
  41 %%   H = supportFunction(POLYGON, V)
  42 %%   where V is a vector, uses vector V of angles to compute support
  43 %%   function.
  44 %%
  45 %% @seealso{convexification}
  46 %% @end deftypefn
  47
  48 function h = supportFunction(polygon, varargin)
  49   N = 24;
  50   u = (0:2*pi/N:2*pi*(1-1/N)).';
  51
  52   if length(varargin)==1
  53       var = varargin{1};
  54       if length(var)==1
  55           N = var;
  56           u = (0:2*pi/N:2*pi*(1-1/N)).';
  57       else
  58           u = var(:);
  59       end
  60   end
  61
  62
  63   h = zeros(size(u));
  64
  65   for i=1:length(u)
  66
  67       v = repmat([cos(u(i)) sin(u(i))], [size(polygon, 1), 1]);
  68
  69       h(i) = max(dot(polygon, v, 2));
  70   end
  71
  72 endfunction