sketchup-api-stubs 0.7.7 → 0.7.8

data/lib/sketchup-api-stubs/stubs/Sketchup/Entities.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The {Sketchup::Entities} class is a collection of Entity objects, either in a
@@ -69,51 +69,53 @@ class Sketchup::Entities
   # The add_3d_text is used to create 3D text. It will be added as edges and
   # faces drawn at the origin.
   #
-  # @example
-  #   # Draw the word "test" at the origin of the model, aligned left, in
-  #   # Arial Bold, not italics, 1" in size, best tolerance quality, filled,
-  #   # with an extrusion size of 5".
-  #   entities = Sketchup.active_model.entities
-  #   success = entities.add_3d_text('test', TextAlignLeft, "Arial",
-  #     true, false, 1.0, 0.0, 0.5, true, 5.0)
+  # = 1.0, tolerance = 0.0, z = 0.0, is_filled = true, extrusion = 0.0)
   #
-  # @param [String] string
-  #   The text to create.
+  #   @param [String] string
+  #     The text to create.
   #
-  # @param [Integer] alignment
-  #   Number that defines the alignment. There are constants
-  #   called TextAlignLeft, TextAlignRight, and
-  #   TextAlignCenter that can be passed.
+  #   @param [Integer] alignment
+  #     Number that defines the alignment. There are constants
+  #     called TextAlignLeft, TextAlignRight, and
+  #     TextAlignCenter that can be passed.
   #
-  # @param [String] font
-  #   font name.
+  #   @param [String] font
+  #     font name.
   #
-  # @param [Boolean] is_bold
-  #   true for bold.
+  #   @param [Boolean] is_bold
+  #     true for bold.
   #
-  # @param [Boolean] is_italic
-  #   true for italic.
+  #   @param [Boolean] is_italic
+  #     true for italic.
   #
-  # @param [Numeric] letter_height
-  #   Height of the text in inches.
+  #   @param [Numeric] letter_height
+  #     Height of the text in inches.
   #
-  # @param [Numeric] tolerance
-  #   Tolerance of the curve creation. Defaults to
-  #   0.0, which creates the highest possible curve quality.
+  #   @param [Numeric] tolerance
+  #     Tolerance of the curve creation. Defaults to
+  #     0.0, which creates the highest possible curve quality.
   #
-  # @param [Numeric] z
-  #   z position in inches.
+  #   @param [Numeric] z
+  #     z position in inches.
   #
-  # @param [Boolean] is_filled
-  #   true for filled, which will put a face between the edges of the letters.
+  #   @param [Boolean] is_filled
+  #     true for filled, which will put a face between the edges of the letters.
   #
-  # @param [Numeric] extrusion
-  #   Extrusion depth in inches.
+  #   @param [Numeric] extrusion
+  #     Extrusion depth in inches.
+  #
+  # @example
+  #   # Draw the word "test" at the origin of the model, aligned left, in
+  #   # Arial Bold, not italics, 1" in size, best tolerance quality, filled,
+  #   # with an extrusion size of 5".
+  #   entities = Sketchup.active_model.entities
+  #   success = entities.add_3d_text('test', TextAlignLeft, "Arial",
+  #     true, false, 1.0, 0.0, 0.5, true, 5.0)
   #
   # @return [Boolean] true if successful
   #
   # @version SketchUp 6.0
-  def add_3d_text(string, alignment, font, is_bold = false, is_italic = false, letter_height = 1.0, tolerance = 0.0, z = 0.0, is_filled = true, extrusion = 0.0)
+  def add_3d_text(string, alignment, font, is_bold = false, is_italic = false, letter_height)
   end
 
   # The add_arc method is used to create an arc curve segment.
@@ -263,6 +265,10 @@ class Sketchup::Entities
 
   # The {#add_dimension_linear} method adds a linear dimension to the entities.
   #
+  # [instance_path, end_point], vector)
+  #
+  # vector)
+  #
   # @example
   #   entities = Sketchup.active_model.entities
   #   # From point to point
@@ -288,7 +294,7 @@ class Sketchup::Entities
   #   start_point = edge.start.position
   #   end_point = edge.end.position
   #   vector = Geom::Vector3d.new(30, 30, 0)
-  #   Sketchup.active_model.entities.add_dimension_linear([instance_path, start_point], [instance_path, end_point], vector)
+  #   Sketchup.active_model.entities.add_dimension_linear([instance_path, start_point],
   #
   # @example Instance path as an array
   #   instance = Sketchup.active_model.active_entities.grep(Sketchup::ComponentInstance).first
@@ -297,7 +303,7 @@ class Sketchup::Entities
   #   start_point = edge.start.position
   #   end_point = edge.end.position
   #   vector = Geom::Vector3d.new(30, 30, 0)
-  #   Sketchup.active_model.entities.add_dimension_linear([path, start_point], [path, end_point], vector)
+  #   Sketchup.active_model.entities.add_dimension_linear([path, start_point], [path, end_point],
   #
   # @overload add_dimension_linear(start_pt_or_entity, end_pt_or_entity, offset_vector)
   #
@@ -400,6 +406,10 @@ class Sketchup::Entities
   #
   # @return [Array<Sketchup::Edge>] an array of Edge objects if successful
   #
+  # @see Sketchup::EntitiesBuilder#add_edges
+  #   EntitiesBuilder#add_edges, alternative
+  #   for generating bulk geometry with performance in mind.
+  #
   # @version SketchUp 6.0
   def add_edges(*args)
   end
@@ -416,9 +426,6 @@ class Sketchup::Entities
   # For the last form that takes a Curve, the curve must be closed - like a
   # circle.
   #
-  # Note that a special case exists for any face created on the ground plane, in
-  # which case the vertex order is ignored and the face is always facing down.
-  #
   # @example
   #   depth = 100
   #   width = 100
@@ -432,6 +439,9 @@ class Sketchup::Entities
   #   # Add the face to the entities in the model
   #   face = entities.add_face(pts)
   #
+  # @note A special case exists for any face created on the ground plane, in
+  #   which case the vertex order is ignored and the face is always facing down.
+  #
   # @overload add_face(entities)
   #
   #   @param [Array<Sketchup::Edge>, Array<Geom::Point3d>, Sketchup::Curve] entities
@@ -442,12 +452,19 @@ class Sketchup::Entities
   #
   # @return [Sketchup::Face, nil]
   #
+  # @see Sketchup::EntitiesBuilder#add_face
+  #   EntitiesBuilder#add_face, alternative
+  #   for generating bulk geometry with performance in mind.
+  #
+  # @see file:pages/generating_geometry.md
+  #   Guide on Generating Geometry
+  #
   # @version SketchUp 6.0
   def add_face(*args)
   end
 
-  # The {#add_faces_from_mesh} method is used to add Face objects to the
-  # collection of entities from a PolygonMesh.
+  # The {#add_faces_from_mesh} method is used to add {Sketchup::Face} entities to the
+  # collection of entities from a {Geom::PolygonMesh}.
   #
   # The +smooth_flags+ parameter can contain any of the following values if
   # passed. The constants were added in SketchUp 2014. For previous versions,
@@ -459,7 +476,7 @@ class Sketchup::Entities
   # - 4: {Geom::PolygonMesh::AUTO_SOFTEN} (Interior edges are softened.)
   # - 8: {Geom::PolygonMesh::SMOOTH_SOFT_EDGES} (All soft edges will also be smooth.)
   #
-  # The 3rd and 4th parameters will accept a {sketchup::Material} object or a
+  # The 3rd and 4th parameters will accept a {Sketchup::Material} object or a
   # string name of a material currently in the model.
   #
   # @example
@@ -492,6 +509,13 @@ class Sketchup::Entities
   #
   # @return [Integer] Number of faces created
   #
+  # @see Sketchup::EntitiesBuilder
+  #   EntitiesBuilder, alternative interface
+  #   for generating bulk geometry with performance in mind.
+  #
+  # @see file:pages/generating_geometry.md
+  #   Guide on Generating Geometry
+  #
   # @version SketchUp 6.0
   def add_faces_from_mesh(polygon_mesh, smooth_flags = Geom::PolygonMesh::AUTO_SOFTEN|Geom::PolygonMesh::SMOOTH_SOFT_EDGES, f_material = nil, b_material = nil)
   end
@@ -621,6 +645,13 @@ class Sketchup::Entities
   #
   # @return [Sketchup::Edge] a Edge object if successful
   #
+  # @see Sketchup::EntitiesBuilder#add_edge
+  #   EntitiesBuilder#add_edge, alternative
+  #   for generating bulk geometry with performance in mind.
+  #
+  # @see file:pages/generating_geometry.md
+  #   Guide on Generating Geometry
+  #
   # @version SketchUp 6.0
   def add_line(point1, point2)
   end
@@ -770,6 +801,47 @@ class Sketchup::Entities
   def at(entity_index)
   end
 
+  # Creates an {Sketchup::EntitiesBuilder} that can be used to generate bulk
+  # geometry with performance in mind. This is particularly useful for importers
+  # where the geometry is already well defined and one wants to recreate it
+  # without further processing.
+  #
+  # The call to {#build} starts an implicit operation, even if no other model
+  # changes are made within the block. This is not the same as
+  # {Sketchup::Model#start_operation}, so it's still recommended to wrap all
+  # model changes, including {#build} with {Sketchup::Model#start_operation} and
+  # {Sketchup::Model#commit_operation}.
+  #
+  # Refer to the documentation of {Sketchup::EntitiesBuilder} for more details.
+  #
+  # @api EntitiesBuilder
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   model.entities.build { |builder|
+  #     edge = builder.add_edge([0, 0, 0], [9, 0, 0])
+  #     edge.material = 'red'
+  #     face = builder.add_face([[0, 0, 0], [9, 0, 0], [9, 9, 0], [0, 9, 0]])
+  #     face.material = 'maroon'
+  #   }
+  #
+  # @note While using {Sketchup::Entities#build} it is important to not
+  #   add or remove vertices by other means of the builder. Also don't modify the
+  #   position of the vertices in the {Sketchup::Entities} container geometry is
+  #   added to. Doing so can break the vertex-cache that de-duplicates the vertices.
+  #
+  # @return [nil]
+  #
+  # @see Sketchup::EntitiesBuilder
+  #
+  # @version SketchUp 2022.0
+  #
+  # @yield [builder]
+  #
+  # @yieldparam [Sketchup::EntitiesBuilder] builder
+  def build
+  end
+
   # The clear! method is used to remove all entities from the collection of
   # entities.
   #
@@ -796,7 +868,7 @@ class Sketchup::Entities
   #   number = entities.count
   #
   # @note Since SketchUp 2014 the count method is inherited from Ruby's
-  #   +Enumable+ mix-in module. Prior to that the {#count} method is an alias
+  #   +Enumerable+ mix-in module. Prior to that the {#count} method is an alias
   #   for {#length}.
   #
   # @return [Integer]
@@ -922,6 +994,13 @@ class Sketchup::Entities
   #
   # @return [Boolean]
   #
+  # @see Sketchup::EntitiesBuilder
+  #   EntitiesBuilder, alternative interface
+  #   for generating bulk geometry with performance in mind.
+  #
+  # @see file:pages/generating_geometry.md
+  #   Guide on Generating Geometry
+  #
   # @version SketchUp 6.0
   def fill_from_mesh(polygon_mesh, weld_vertices = true, smooth_flags = Geom::PolygonMesh::AUTO_SOFTEN|Geom::PolygonMesh::SMOOTH_SOFT_EDGES, f_material = nil, b_material = nil)
   end

data/lib/sketchup-api-stubs/stubs/Sketchup/EntitiesBuilder.rb

@@ -0,0 +1,272 @@
+# Copyright:: Copyright 2022 Trimble Inc.
+# License:: The MIT License (MIT)
+
+# The {Sketchup::EntitiesBuilder} is an interface to generate bulk geometry
+# with performance in mind.
+#
+# This is particularly useful for importers where the geometry is already well
+# defined and one wants to recreate it without further processing.
+#
+# Before the Entities Builder was introduced there were two ways of adding
+# geometry; the +add_*+ methods of {Sketchup::Entities} and {Geom::PolygonMesh}.
+#
+# The former is slow as the methods perform intersection, splitting and merging
+# of overlapping geometry. This is useful when creating tools similar to the
+# Line and Rectangle tool.
+#
+# {Geom::PolygonMesh} is fast, but it doesn't provide granular control per
+# face or edge added.
+#
+# Entities Builder is similar to {Geom::PolygonMesh} in speed, but with the
+# flexibility of {Sketchup::Entities}'s +add_*+ methods.
+#
+# <i>(See "Creating a triangulated grid" example)</i>
+#
+# rdoc-image:../images/entities-builder-grid-example.png
+#
+# @api EntitiesBuilder
+#
+# @example Creating a triangulated grid
+#   model = Sketchup.active_model
+#   model.start_operation('Create Grid', true)
+#   model.entities.build { |builder|
+#     # Creates a grid similar to Sandbox Tools, with each square
+#     # triangulated with a soft+smooth edge.
+#     10.times { |x|
+#       10.times { |y|
+#         # 4 +--+ 3
+#         #   |\ |
+#         #   | \|
+#         # 1 +--+ 2
+#         pt1 = Geom::Point3d.new(x, y, 0)
+#         pt2 = Geom::Point3d.new(x + 1, y, 0)
+#         pt3 = Geom::Point3d.new(x + 1, y + 1, 0)
+#         pt4 = Geom::Point3d.new(x, y + 1, 0)
+#         face1 = builder.add_face([pt1, pt2, pt4])
+#         face2 = builder.add_face([pt2, pt3, pt4])
+#         material = (x + y).odd? ? 'red' : 'maroon'
+#         face1.material = material
+#         face2.material = material
+#         edge = builder.add_edge(pt2, pt4)
+#         edge.soft = true
+#         edge.smooth = true
+#       }
+#     }
+#   }
+#   model.commit_operation
+#
+# @note Like {Geom::PolygonMesh} there is minimal validation checks made on
+#   the input to the creation of the geometry. Vertices are de-duplicated and
+#   edges sharing the same vertices will be de-duplicated. But no intersection
+#   of overlapping entities is made. It leaves a higher responsibility on the
+#   API user to produce valid geometry.
+#
+# @note While using {Sketchup::Entities#build} it is important to not
+#   add or remove vertices by other means of the builder. Also don't modify the
+#   position of the vertices in the {Sketchup::Entities} container geometry is
+#   added to. Doing so can break the vertex-cache that de-duplicates the vertices.
+#
+# @see file:pages/generating_geometry.md
+#   Guide on Generating Geometry
+#
+# @see Sketchup::Entities#build
+#
+# @see Sketchup::Entities
+#
+# @see Geom::PolygonMesh
+#
+# @version SketchUp 2022.0
+class Sketchup::EntitiesBuilder
+
+  # Instance Methods
+
+  # Adds a {Sketchup::Edge} to the {#entities} collection.
+  #
+  # @api EntitiesBuilder
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   model.entities.build { |builder|
+  #     edge = builder.add_edge([0, 0, 0], [9, 0, 0])
+  #     edge.material = 'red'
+  #   }
+  #
+  # @note Does not split intersecting faces or edges.
+  #
+  # @overload add_edge(point1, point2)
+  #
+  #   @param [Geom::Point3d] point1
+  #   @param [Geom::Point3d] point2
+  #
+  # @overload add_edge(points)
+  #
+  #   @param [Array(Geom::Point3d, Geom::Point3d)] points
+  #
+  # @raise [ArgumentError] If the points are considered equal.
+  #
+  # @raise [RuntimeError] If the builder is not valid.
+  #
+  # @return [Sketchup::Edge]
+  #
+  # @see Sketchup::Entities#add_line
+  #
+  # @version SketchUp 2022.0
+  def add_edge(*args)
+  end
+  alias_method :add_line, :add_edge
+
+  # Adds a continuous set of {Sketchup::Edge}'s to the {#entities} collection.
+  #
+  # @api EntitiesBuilder
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   model.entities.build { |builder|
+  #     edges = builder.add_edges([0, 0, 0], [6, 0, 0], [9, 0, 8]) # => 2 edges
+  #     edges.each { |edge|
+  #       edge.material = 'red'
+  #     }
+  #   }
+  #
+  # @note Does not split intersecting faces or edges.
+  #
+  # @overload add_edges(points)
+  #
+  #   @param [Array<Geom::Point3d>] points
+  #
+  # @overload add_edges(*points)
+  #
+  #   @param [Array<Geom::Point3d>] points
+  #
+  # @raise [RuntimeError] If the builder is not valid.
+  #
+  # @return [Array<Sketchup::Edge, nil>] In the array, for each pair in +points+ an edge is returned.
+  #   If two point are so close they are considered identical then +nil+ is returned.
+  #
+  # @see Sketchup::Entities#add_edges
+  #
+  # @version SketchUp 2022.0
+  def add_edges(*args)
+  end
+
+  # Adds a {Sketchup::Face} to the {#entities} collection.
+  #
+  # @api EntitiesBuilder
+  #
+  # @example Adding a simple face
+  #   model = Sketchup.active_model
+  #   model.entities.build { |builder|
+  #     face = builder.add_face([[0, 0, 0], [6, 0, 0], [6, 8, 0], [0, 8, 0]])
+  #     face.material = 'red'
+  #   }
+  #
+  # @example Adding an edge with two holes
+  #   model = Sketchup.active_model
+  #   model.entities.build { |builder|
+  #     outer_loop = [[0, 0, 0], [8, 0, 0], [8, 9, 0], [0, 9, 0]]
+  #     hole1 = [[1, 1, 0], [3, 1, 0], [3, 8, 0], [1, 8, 0]]
+  #     hole2 = [[4, 1, 0], [7, 1, 0], [7, 8, 0], [4, 8, 0]]
+  #     face = builder.add_face(outer_loop, holes: [hole1, hole2])
+  #   }
+  #
+  # @note Does not split intersecting faces or edges.
+  #
+  # @overload add_face(outer_loop)
+  #
+  #   @param [Array<Geom::Point3d>] outer_loop
+  #
+  # @overload add_face(*outer_loop)
+  #
+  #   @param [Array<Geom::Point3d>] outer_loop
+  #
+  # @overload add_face(outer_loop, holes: inner_loops)
+  #
+  #   Adds a face with holes.
+  #   @note The inner loops are not validated to be within the bounds of the outer loop.
+  #   @param [Array<Geom::Point3d>] outer_loop
+  #   @param [Array<Array<Geom::Point3d>>] inner_loops
+  #
+  # @overload add_face(*outer_loop, holes: inner_loops)
+  #
+  #   Adds a face with holes.
+  #   @note The inner loops are not validated to be within the bounds of the outer loop.
+  #   @param [Array<Geom::Point3d>] outer_loop
+  #   @param [Array<Array<Geom::Point3d>>] inner_loops
+  #
+  # @raise [ArgumentError] If points are not planar.
+  #
+  # @raise [ArgumentError] If any of the loops doesn't have at least 3 points.
+  #
+  # @raise [RuntimeError] If the builder is not valid.
+  #
+  # @return [Sketchup::Face]
+  #
+  # @see Sketchup::Entities#add_face
+  #
+  # @version SketchUp 2022.0
+  def add_face(*args)
+  end
+
+  # The {Sketchup::Entities} collection the {Sketchup::EntitiesBuilder} will add
+  # the geometry to.
+  #
+  # @api EntitiesBuilder
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   model.entities.build { |builder|
+  #     p builder.entities == model.entities # => true
+  #   }
+  #
+  # @raise [RuntimeError] If the builder is not valid.
+  #
+  # @return [Sketchup::Entities]
+  #
+  # @version SketchUp 2022.0
+  def entities
+  end
+
+  # Indicates whether the builder object is valid and can be used.
+  #
+  # A builder object is only valid within the scope of the block given to
+  # {Sketchup::Entities#build}.
+  #
+  # When this return +false+, calling any other method on the builder will raise
+  # an error.
+  #
+  # @api EntitiesBuilder
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   cached_builder = nil
+  #   model.entities.build { |builder|
+  #     p builder.valid? # => true
+  #     cached_builder = builder # Don't hold on to builder objects.
+  #   }
+  #   p cached_builder.valid? # => false
+  #
+  # @return [Boolean]
+  #
+  # @version SketchUp 2022.0
+  def valid?
+  end
+
+  # Finds an existing {Sketchup::Vertex} for the given position, otherwise returns +nil+.
+  #
+  # @api EntitiesBuilder
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   model.entities.build { |builder|
+  #     edge = builder.add_edge([1, 0, 0], [9, 0, 0])
+  #     builder.vertex_at([0, 0, 0]) => nil
+  #     builder.vertex_at([9, 0, 0]) => #<Sketchup::Vertex>
+  #   }
+  #
+  # @return [Sketchup::Vertex, nil]
+  #
+  # @version SketchUp 2022.0
+  def vertex_at(position)
+  end
+
+end

data/lib/sketchup-api-stubs/stubs/Sketchup/EntitiesObserver.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # This observer interface is implemented to react to {Sketchup::Entities}

data/lib/sketchup-api-stubs/stubs/Sketchup/Entity.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # This is the base class for all SketchUp entities. Entities are basically

data/lib/sketchup-api-stubs/stubs/Sketchup/EntityObserver.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # This observer interface is implemented to react to entity events.

data/lib/sketchup-api-stubs/stubs/Sketchup/ExtensionsManager.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The ExtensionsManager class provides a way of accessing the
@@ -51,7 +51,7 @@ class Sketchup::ExtensionsManager
   #   number = manager.count
   #
   # @note Since SketchUp 2014 the count method is inherited from Ruby's
-  #   +Enumable+ mix-in module. Prior to that the {#count} method is an alias
+  #   +Enumerable+ mix-in module. Prior to that the {#count} method is an alias
   #   for {#length}.
   #
   # @return [Integer]

data/lib/sketchup-api-stubs/stubs/Sketchup/Face.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # Faces in SketchUp are flat, 2-sided polygons with 3 or more sides.
@@ -200,6 +200,18 @@ class Sketchup::Face < Sketchup::Drawingelement
   def classify_point(point)
   end
 
+  # The {#clear_texture_position} method is used to remove any explicit
+  # texture positioning for a face and have SketchUp display it with the
+  # default texture positioning.
+  #
+  # @param [Boolean] front
+  #   +true+ Clears on the front side of the face, +false+
+  #   the back side.
+  #
+  # @version SketchUp 2022.0
+  def clear_texture_position(front)
+  end
+
   # The {#clear_texture_projection} method is used to clear the texture
   # projection. This is similar to toggling off Projection from the Position
   # Texture tool in the UI.
@@ -325,6 +337,8 @@ class Sketchup::Face < Sketchup::Drawingelement
   # The get_glued_instances method returns an Array any ComponentInstances
   # that are glued to the face.
   #
+  # ComponentInstance objects that are currently glued to the face.
+  #
   # @example
   #   # Create a series of points that define a new face.
   #   model = Sketchup.active_model
@@ -339,8 +353,7 @@ class Sketchup::Face < Sketchup::Drawingelement
   #   face = entities.add_face(pts)
   #   glued_array = face.get_glued_instances
   #
-  # @return [Array<Sketchup::ComponentInstance, Sketchup::Group, Sketchup::Image>] An array of ComponentInstance objects that
-  #   are currently glued to the face.
+  # @return [Array<Sketchup::ComponentInstance, Sketchup::Group, Sketchup::Image>] An array of
   #
   # @version SketchUp 7.0 M1
   def get_glued_instances
@@ -645,6 +658,8 @@ class Sketchup::Face < Sketchup::Drawingelement
   #
   # @overload position_material(material, points, on_front, projection)
   #
+  #   @version SketchUp 2021.1
+  #
   #   This variant positions a material on the face's plane with projection.
   #
   #   @param [Sketchup::Material] material
@@ -742,7 +757,7 @@ class Sketchup::Face < Sketchup::Drawingelement
   #
   # @deprecated This function never worked correctly. It's not capable of
   #   controlling the position and orientation of the texture. In some cases it
-  #   produced an invalid model. After SketchUp 2021.1 the method will raise
+  #   produced an invalid model. As of SketchUp 2021.1 the method simply raises
   #   +NotImplementedError+.
   #
   # @param [Geom::Vector3d] vector
@@ -784,7 +799,7 @@ class Sketchup::Face < Sketchup::Drawingelement
   #   }
   #
   # @param [Boolean] front
-  #   +true+ Checks the front side of the face, +face+
+  #   +true+ Checks the front side of the face, +false+
   #   the back side.
   #
   # @return [Boolean]
@@ -809,7 +824,7 @@ class Sketchup::Face < Sketchup::Drawingelement
   # {#position_material}.
   #
   # @param [Boolean] front
-  #   +true+ Checks the front side of the face, +face+
+  #   +true+ Checks the front side of the face, +false+
   #   the back side.
   #
   # @return [Boolean]
@@ -842,6 +857,11 @@ class Sketchup::Face < Sketchup::Drawingelement
   #
   # rdoc-image:../images/face-uv-tile-at.png
   #
+  # @bug Fixed in SketchUp 2022.0: If the +position+ argument should line up exact
+  #   U or V axes of the UV coordinate system the returned set of points won't
+  #   be correct. A workaround for older SketchUp versions would be to slightly
+  #   offset the +position+ argument.
+  #
   # @example Copy material from front to back
   #   model = Sketchup.active_model
   #   model.active_entities.grep(Sketchup::Face) { |face|
@@ -876,7 +896,7 @@ class Sketchup::Face < Sketchup::Drawingelement
   #   bounded by the UV tile.
   #
   # @param [Boolean] front
-  #   +true+ Checks the front side of the face, +face+
+  #   +true+ Checks the front side of the face, +false+
   #   the back side.
   #
   # @return [Array<Geom::Point3d>, nil] A set of 8 points. Each stride of two is

data/lib/sketchup-api-stubs/stubs/Sketchup/FrameChangeObserver.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # This observer interface is implemented to react to changes in camera

data/lib/sketchup-api-stubs/stubs/Sketchup/Group.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2021 Trimble Inc.
+# Copyright:: Copyright 2022 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # A Group class contains methods for manipulating groups of entities.