1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116
|
## Copyright (C) 2024 David Legland
## All rights reserved.
##
## Redistribution and use in source and binary forms, with or without
## modification, are permitted provided that the following conditions are met:
##
## 1 Redistributions of source code must retain the above copyright notice,
## this list of conditions and the following disclaimer.
## 2 Redistributions in binary form must reproduce the above copyright
## notice, this list of conditions and the following disclaimer in the
## documentation and/or other materials provided with the distribution.
##
## THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ''AS IS''
## AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
## IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
## ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR
## ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
## DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
## SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
## CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
## OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
## OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
##
## The views and conclusions contained in the software and documentation are
## those of the authors and should not be interpreted as representing official
## policies, either expressed or implied, of the copyright holders.
function varargout = fillMeshFaces(varargin)
%FILLMESHFACES Fill the faces of a mesh with the specified colors.
%
% fillMeshFaces(V, F, VERTEXCOLORS)
% Colorizes a mesh by filling faces with an array of values. The colors
% can be a NV-by-1 array of values, or a NV-by-3 array of values.
% Face filling uses 'interp' coloring mode.
%
% fillMeshFaces(V, F, FACECOLORS)
% Colorizes the mesh by specifying the value or the color associated to
% each face. Face filling uses 'flat' coloring mode.
%
% fillMeshFaces(..., PNAME, PVALUE)
% Specifies additional parameters that will be passed to the 'patch'
% function.
%
% Example
% % Colorize mesh based on z-coordinate of vertices.
% [v, f] = createIcosahedron;
% values = v(:,3);
% figure; axis equal; view(3);
% fillMeshFaces(v, f, values);
%
% % Colorize mesh using specific color for each face
% [v, f] = createIcosahedron;
% colors = jet(20);
% figure; axis equal; view(3);
% fillMeshFaces(v, f, colors);
%
% See also
% drawMesh
% ------
% Author: David Legland
% E-mail: david.legland@inrae.fr
% Created: 2020-04-16, using Matlab 9.7.0.1247435 (R2019b) Update 2
% Copyright 2020-2023 INRAE - BIA Research Unit - BIBS Platform (Nantes)
%% Parse input arguments
% extract first argument
var1 = varargin{1};
varargin(1) = [];
% Check if first input argument is an axes handle
if isAxisHandle(var1)
ax = var1;
var1 = varargin{1};
varargin(1) = [];
else
ax = gca;
end
% Check if the input is a mesh structure
if isstruct(var1)
% extract data to display
vertices = var1.vertices;
faces = var1.faces;
else
% assumes input is given with vertices+faces arrays
vertices = var1;
faces = varargin{1};
varargin(1) = [];
end
% next argument is face color
colors = varargin{1};
varargin(1) = [];
% adapt the face color key value depending on the size of the "color" input
% argument
faceColorMode = 'interp';
if size(colors, 1) == size(faces, 1)
faceColorMode = 'flat';
end
% array FACES is a NF-by-NV indices array, with NV number of vertices of
% each face, and NF number of faces
h = patch('Parent', ax, ...
'vertices', vertices, 'faces', faces, 'FaceVertexCData', colors, ...
'FaceColor', faceColorMode, varargin{:});
%% Process output arguments
% format output parameters
if nargout > 0
varargout = {h};
end
|