polyhedra

POLYHEDRA Index of classical polyhedral meshes.
   
   Polyhedra are specific meshes, with additional assumptions:
   * the set of faces is assumed to enclose a single 3D domain
   * each face has a neighbor face for each edge
   * some functions also assume that normals of all faces point outwards 

   Most polyhedron creation functions follow the patterns:
   * [V, F] = createXXX();     % returns vertex and face arrays
   * [V, E, F] = createXXX();  % returns also edge array
   * M = createXXX();          % return a data structure with 'vertices',
                               % 'edges' and 'faces' fields.

   Example
   % create a soccer ball mesh and display it
   [n, f] = createSoccerBall;
   drawMesh(n, f, 'faceColor', 'g', 'linewidth', 2);
   axis equal;

   See also
   meshes3d
   createCube, createCubeOctahedron, createIcosahedron, createOctahedron
   createRhombododecahedron, createTetrahedron, createTetrakaidecahedron
   createDodecahedron, createSoccerBall, createMengerSponge
   steinerPolytope, minConvexHull
   polyhedronNormalAngle, polyhedronMeanBreadth

0001 function polyhedra(varargin)
0002 %POLYHEDRA Index of classical polyhedral meshes.
0003 %
0004 %   Polyhedra are specific meshes, with additional assumptions:
0005 %   * the set of faces is assumed to enclose a single 3D domain
0006 %   * each face has a neighbor face for each edge
0007 %   * some functions also assume that normals of all faces point outwards
0008 %
0009 %   Most polyhedron creation functions follow the patterns:
0010 %   * [V, F] = createXXX();     % returns vertex and face arrays
0011 %   * [V, E, F] = createXXX();  % returns also edge array
0012 %   * M = createXXX();          % return a data structure with 'vertices',
0013 %                               % 'edges' and 'faces' fields.
0014 %
0015 %   Example
0016 %   % create a soccer ball mesh and display it
0017 %   [n, f] = createSoccerBall;
0018 %   drawMesh(n, f, 'faceColor', 'g', 'linewidth', 2);
0019 %   axis equal;
0020 %
0021 %   See also
0022 %   meshes3d
0023 %   createCube, createCubeOctahedron, createIcosahedron, createOctahedron
0024 %   createRhombododecahedron, createTetrahedron, createTetrakaidecahedron
0025 %   createDodecahedron, createSoccerBall, createMengerSponge
0026 %   steinerPolytope, minConvexHull
0027 %   polyhedronNormalAngle, polyhedronMeanBreadth
0028 %
0029 
0030 % ------
0031 % Author: David Legland
0032 % e-mail: david.legland@inra.fr
0033 % Created: 2008-10-13,    using Matlab 7.4.0.287 (R2007a)
0034 % Copyright 2008 INRA - BIA PV Nantes - MIAJ Jouy-en-Josas.
0035 
0036 % HISTORY