MATLAB Function Reference (Volume 2: Graphics)

patchPurpose2patchCreate patch graphics objectSyntaxDescriptionpatch(X,Y,C)patch(X,Y,Z,C)patch(...'PropertyName',PropertyValue...)patch('PropertyName',PropertyValue...) PN/PV pairs onlyhandle = patch(...)patch is the low-level graphics function for creating patch graphics objects. Apatch object is one or more polygons defined by the coordinates of its vertices.You can specify the coloring and lighting of the patch. See the “3-D Modeling”topic in Using MATLAB Graphics for more information on patches.patch(X,Y,C) adds the filled two-dimensional patch to the current axes. Theelements of X and Y specify the vertices of a polygon. If X and Y are matrices,MATLAB draws one polygon per column. C determines the color of the patch.It can be a single ColorSpec, one color per face, or one color per vertex (see“Remarks”). If C is a 1-by-3 vector, it is assumed to be an RGB triplet,specifying a color directly.patch(X,Y,Z,C) creates a patch in three-dimensional coordinates.patch(...'PropertyName',PropertyValue...) follows the X, Y, (Z), and Carguments with property name/property value pairs to specify additional patchproperties.patch('PropertyName',PropertyValue,...) specifies all properties usingproperty name/property value pairs. This form enables you to omit the colorspecification because MATLAB uses the default face color and edge color,unless you explicitly assign a value to the FaceColor and EdgeColorproperties. This form also allows you to specify the patch using the Faces andVertices properties instead of x-, y-, and z-coordinates. See the “Examples”section for more information.handle = patch(...) returns the handle of the patch object it creates.RemarksUnlike high-level area creation functions, such as fill or area, patch does notcheck the settings of the figure and axes NextPlot properties. It simply adds thepatch object to the current axes.2-313