Algorithm (Workflow)

This function, CPLplotregions, is designed to plot regions of a closed polygon list (CPL) using different colors. It is part of the SolidGeometry library and was introduced in version 4.3.

Input Parameters

• CPL: This is the closed polygon that you want to plot. It is the primary input to the function.
• ind: This is an optional parameter that specifies the indices of the regions to be plotted. If not provided, the default is to plot all regions.

Output

• h: This is the handle to the graphics objects created by the plot. It allows for further manipulation or querying of the plot after it is created.

Algorithm Steps

1. The function begins by calling getfuncparams to determine the simplification parameter for the polygon. This function checks the input arguments and returns a boolean indicating whether to simplify the polygon.
2. A polyshape object is created from the CPL using the simplification parameter. This object represents the geometric shape of the polygon.
3. The regions function is called on the polyshape object to obtain the individual regions of the polygon.
4. The getfuncparams function is called again to determine the indices of the regions to be plotted. If no specific indices are provided, it defaults to all regions.
5. An empty array h is initialized to store the handles to the graphics objects.
6. The function separateNaN is called on the CPL, which likely separates the polygon into distinct parts if there are NaN values indicating breaks.
7. A loop iterates over the specified indices of the regions. For each region, the CPLplot function is called with the vertices of the region and a color determined by colofn. The color is selected from a predefined set ('rbgkcym') and a default ('r-').
8. The handle returned by CPLplot is appended to the array h.

The function concludes by returning the array h, which contains the handles to the plotted regions.