1- # Copyright:: Copyright 2021 Trimble Inc.
1+ # Copyright:: Copyright 2022 Trimble Inc.
22# License:: The MIT License (MIT)
33
44# The {#Geom::PolygonMesh} class contains methods to create polygon mesh
2222# group = entities.add_group
2323# group.entities.add_faces_from_mesh(mesh)
2424#
25+ # @note As of SketchUp 2022.0 the new {Sketchup::EntitiesBuilder} interface
26+ # can be used to generate bulk geometry. It has similar performance as
27+ # {Geom::PolygonMesh}, but with similar degree of per-entity control as
28+ # {Sketchup::Entities}.
29+ #
30+ # @see file:pages/generating_geometry.md
31+ # Guide on Generating Geometry
32+ #
2533# @version SketchUp 6.0
2634class Geom ::PolygonMesh
2735
@@ -42,13 +50,16 @@ class Geom::PolygonMesh
4250
4351 # The {#add_point} method is used to add a point to the mesh.
4452 #
45- # The index can be used for creating polygons.
53+ # The returned index can be used for creating polygons.
4654 #
4755 # @example
4856 # mesh = Geom::PolygonMesh.new
4957 # point = Geom::Point3d.new(0, 1, 2)
5058 # index = mesh.add_point(point)
5159 #
60+ # @note In SketchUp 2021.1 this method was improved to be faster.
61+ # See {#initialize} for details.
62+ #
5263 # @param [Geom::Point3d] point
5364 #
5465 # @return [Integer] the index in the mesh for the point
@@ -57,10 +68,13 @@ class Geom::PolygonMesh
5768 def add_point ( point )
5869 end
5970
60- # The + add_polygon+ method is used for adding a polygon to a
61- # PolygonMesh. All variations of this method require at least 3 elements
71+ # The {# add_polygon} method is used for adding a polygon to a
72+ # {Geom:: PolygonMesh} . All variations of this method require at least 3 elements
6273 # to define a polygon, although more may be given.
6374 #
75+ # @note In SketchUp 2021.1 this method was improved to be faster.
76+ # See {#initialize} for details.
77+ #
6478 # @overload add_polygon(index, index, index, ...)
6579 #
6680 # Adds a polygon from a list of the mesh's vertex indices.
0 commit comments