sketchup-api-stubs 0.7.10 → 0.7.11

data/lib/sketchup-api-stubs/stubs/Geom/PolygonMesh.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The {#Geom::PolygonMesh} class contains methods to create polygon mesh
@@ -15,7 +15,7 @@
 #
 # @example
 #   entities = Sketchup.active_model.active_entities
-#   face = entities.grep(Sketchup::Face).first
+#   face = entities.add_face([1, 1, 1], [1, 2, 1], [2, 2, 1])
 #
 #   mesh = face.mesh
 #
@@ -80,7 +80,6 @@ class Geom::PolygonMesh
   #   Adds a polygon from a list of the mesh's vertex indices.
   #   @example
   #     mesh = Geom::PolygonMesh.new
-  #     # add points to mesh...
   #     mesh.add_point(Geom::Point3d.new(0, 0, 0))
   #     mesh.add_point(Geom::Point3d.new(1, 0, 0))
   #     mesh.add_point(Geom::Point3d.new(1, 1, 0))
@@ -95,7 +94,6 @@ class Geom::PolygonMesh
   #   Adds a polygon from an Array of the mesh's vertex indices.
   #   @example
   #     mesh = Geom::PolygonMesh.new
-  #     # add points to mesh...
   #     mesh.add_point(Geom::Point3d.new(0, 0, 0))
   #     mesh.add_point(Geom::Point3d.new(1, 0, 0))
   #     mesh.add_point(Geom::Point3d.new(1, 1, 0))
@@ -143,7 +141,7 @@ class Geom::PolygonMesh
   #   mesh = Geom::PolygonMesh.new
   #   point = Geom::Point3d.new(0, 1, 2)
   #   mesh.add_point(point)
-  #   num = mesh.count_points
+  #   number_points = mesh.count_points
   #
   # @return [Integer] the number of points in a mesh
   #
@@ -159,7 +157,7 @@ class Geom::PolygonMesh
   #   point2 = Geom::Point3d.new(1, 0, 2)
   #   point3 = Geom::Point3d.new(2, 0, 1)
   #   mesh.add_polygon(point1, point2, point3)
-  #   nump = mesh.count_polygons
+  #   number_polygons = mesh.count_polygons
   #
   # @return [Integer] the number of polygons in the mesh
   #
@@ -188,15 +186,15 @@ class Geom::PolygonMesh
   #
   #   @return [Geom::PolygonMesh]
   #
-  # @overload initialize(numpts)
+  # @overload initialize(number_points)
   #
-  #   @param [Integer] numpts    How many points will be in the mesh.
+  #   @param [Integer] number_points    How many points will be in the mesh.
   #   @return [Geom::PolygonMesh]
   #
-  # @overload initialize(numpts, numpolys)
+  # @overload initialize(number_points, number_polygons)
   #
-  #   @param [Integer] numpts    How many points will be in the mesh.
-  #   @param [Integer] numpolys  How many polygons will be in the mesh.
+  #   @param [Integer] number_points    How many points will be in the mesh.
+  #   @param [Integer] number_polygons  How many polygons will be in the mesh.
   #   @return [Geom::PolygonMesh]
   #
   # @raise [RangeError] If number of points or polygons are negative numbers.
@@ -210,8 +208,13 @@ class Geom::PolygonMesh
   # {Sketchup::Face#mesh} with the +PolygonMeshNormals+ flag.
   #
   # @example
+  #   model = Sketchup.active_model
+  #   entity = model.active_entities
+  #   face = entity.add_face([1, 1, 1], [2, 2, 1], [2, 1, 1])
+  #
   #   flags = 4 # PolygonMeshNormals
   #   mesh = face.mesh(flags)
+  #   # The result is a Vector3d(0, 0, -1)
   #   normal = mesh.normal_at(1)
   #
   # @note Index starts at 1.
@@ -310,7 +313,7 @@ class Geom::PolygonMesh
   # @param [Integer] index
   #   The index of the desired polygon.
   #
-  # @return [Array<Geom::Point3d>, nil]
+  # @return [Array<Integer>, nil]
   #
   # @version SketchUp 6.0
   def polygon_at(index)
@@ -346,7 +349,14 @@ class Geom::PolygonMesh
   # indicates that the edge from +1+ to +2+ is hidden.
   #
   # @example
-  #   polygons = polygonmesh.polygons
+  #   mesh = Geom::PolygonMesh.new
+  #   mesh.add_point([0, 0, 0])
+  #   mesh.add_point([1, 0, 0])
+  #   mesh.add_point([1, 1, 0])
+  #
+  #   mesh.add_polygon(1, 2, 3)
+  #   mesh.add_polygon(-1, 3, 2)
+  #   polygons = mesh.polygons
   #
   # @return [Array<Array<Integer>>]
   #
@@ -395,26 +405,25 @@ class Geom::PolygonMesh
   #
   # @example
   #   mesh = Geom::PolygonMesh.new(4)
-  #   # Create points for a triangle.
   #   point1 = Geom::Point3d.new(0, 0, 0)
   #   point2 = Geom::Point3d.new(9, 0, 0)
   #   point3 = Geom::Point3d.new(9, 9, 0)
   #   point4 = Geom::Point3d.new(0, 9, 0)
-  #   # Create UV mapping to tile 2x cross triangle.
-  #   uv1 = Geom::Point3d.new(0, 0, 0)
-  #   uv2 = Geom::Point3d.new(2, 0, 0)
-  #   uv3 = Geom::Point3d.new(2, 2, 0)
-  #   uv4 = Geom::Point3d.new(0, 2, 0)
-  #   # Add points and UV data to mesh.
+  #
+  #   uv_point1 = Geom::Point3d.new(0, 0, 0)
+  #   uv_point2 = Geom::Point3d.new(2, 0, 0)
+  #   uv_point3 = Geom::Point3d.new(2, 2, 0)
+  #   uv_point4 = Geom::Point3d.new(0, 2, 0)
+  #
   #   index1 = mesh.add_point(point1)
   #   index2 = mesh.add_point(point2)
   #   index3 = mesh.add_point(point3)
   #   index4 = mesh.add_point(point4)
-  #   mesh.set_uv(index1, uv1, true)
-  #   mesh.set_uv(index2, uv2, true)
-  #   mesh.set_uv(index3, uv3, true)
-  #   mesh.set_uv(index4, uv4, true)
-  #   # Add polygons.
+  #   mesh.set_uv(index1, uv_point1, true)
+  #   mesh.set_uv(index2, uv_point2, true)
+  #   mesh.set_uv(index3, uv_point3, true)
+  #   mesh.set_uv(index4, uv_point4, true)
+  #
   #   mesh.add_polygon(index1, index2, index3)
   #   mesh.add_polygon(index1, index3, index4)
   #
@@ -442,11 +451,12 @@ class Geom::PolygonMesh
   #
   # @example
   #   point1 = Geom::Point3d.new(100, 200, 300)
-  #   tr = Geom::Transformation.new(point1)
+  #   transformation = Geom::Transformation.new(point1)
   #   mesh = Geom::PolygonMesh.new
   #   point2 = Geom::Point3d.new(0, 1, 2)
   #   mesh.add_point(point2)
-  #   mesh.transform!(tr)
+  #   # The PolygonMesh contains a Point3d(100, 201, 302)
+  #   mesh.transform!(transformation)
   #
   # @param [Geom::Transformation] transformation
   #
@@ -471,7 +481,12 @@ class Geom::PolygonMesh
   # referred to as UV mapping.
   #
   # @example
-  #   point = mesh.uv_at(1, true)
+  #   mesh = Geom::PolygonMesh.new
+  #   index = mesh.add_point([2, 2, 2])
+  #   uv_point = Geom::Point3d.new(1, 1, 0)
+  #
+  #   mesh.set_uv(index, uv_point, true)
+  #   point = mesh.uv_at(index, true)
   #
   # @note Index starts at 1.
   #
@@ -494,9 +509,20 @@ class Geom::PolygonMesh
   # mesh.
   #
   # @example
-  #   # Get a mesh with front and back UVs.
+  #   model = Sketchup.active_model
+  #   entity = model.active_entities
+  #
+  #   face = entity.add_face([1, 1, 1], [1, 3, 1], [3, 3, 1])
   #   mesh = face.mesh(1 | 2)
-  #   uvs = mesh.uvs(true)
+  #
+  #   uv_point1 = Geom::Point3d.new(0, 0, 0)
+  #   uv_point2 = Geom::Point3d.new(1, 0, 0)
+  #   uv_point3 = Geom::Point3d.new(1, 1, 0)
+  #   mesh.set_uv(1, uv_point1, true)
+  #   mesh.set_uv(2, uv_point2, true)
+  #   mesh.set_uv(3, uv_point3, true)
+  #
+  #   uv_points = mesh.uvs(true)
   #
   # @param [Boolean] front
   #

data/lib/sketchup-api-stubs/stubs/Geom/Transformation.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # Transformations are a standard construct in the 3D world for representing
@@ -24,7 +24,7 @@ class Geom::Transformation
   #   # Creates a transformation that "flips" the axes from XYZ to XZY. Something
   #   # one often need for importers/exporters when dealing with applications
   #   # that threat Y as "up".
-  #   tr = Geom::Transformation.axes(ORIGIN, X_AXIS, Z_AXIS, Y_AXIS.reverse)
+  #   transformation = Geom::Transformation.axes(ORIGIN, X_AXIS, Z_AXIS, Y_AXIS.reverse)
   #
   # @overload axes(origin, xaxis, yaxis, zaxis)
   #
@@ -52,31 +52,31 @@ class Geom::Transformation
   # The {.interpolate} method is used to create a new transformation that is the
   # result of interpolating between two other transformations.
   #
-  # Parameter is a weight (between `0.0` and `1.0`) that identifies whether to favor
-  # `transformation1` or `transformation2`.
+  # Parameter weight is a value (between 0.0 and 1.0) that represents the percentage given to
+  # `transformation1` and `transformation2`.
   #
   # @example
   #   origin = Geom::Point3d.new(0, 0, 0)
-  #   x = Geom::Vector3d.new(0, 1, 0)
-  #   y = Geom::Vector3d.new(1, 0, 0)
-  #   z = Geom::Vector3d.new(0, 0, 1)
+  #   xaxis = Geom::Vector3d.new(0, 1, 0)
+  #   yaxis = Geom::Vector3d.new(1, 0, 0)
+  #   zaxis = Geom::Vector3d.new(0, 0, 1)
   #   point = Geom::Point3d.new(10, 20, 30)
-  #   t1 = Geom::Transformation.new(point)
-  #   t2 = Geom::Transformation.axes(origin, x, y, z)
-  #   # This produce a transformation that is a mix of 75% t1 and 25% t2.
-  #   t3 = Geom::Transformation.interpolate(t1, t2, 0.25)
+  #   transformation1 = Geom::Transformation.new(point)
+  #   transformation2 = Geom::Transformation.axes(origin, xaxis, yaxis, zaxis)
+  #   # This produce a transformation that is a mix of 75% transformation1 and 25% transformation2.
+  #   new_transformation = Geom::Transformation.interpolate(transformation1, transformation2, 0.25)
   #
-  # @param [Geom::Transformation] transform1
+  # @param [Geom::Transformation] transformation1
   #
-  # @param [Geom::Transformation] transform2
+  # @param [Geom::Transformation] transformation2
   #
   # @param [Float] weight
-  #   A value between 0.0 and 1.0 (see comments).
+  #   A value between 0.0 and 1.0.
   #
   # @return [Geom::Transformation]
   #
   # @version SketchUp 6.0
-  def self.interpolate(transform1, transform2, weight)
+  def self.interpolate(transformation1, transformation2, weight)
   end
 
   # The {.rotation} method is used to create a transformation that does rotation
@@ -108,7 +108,7 @@ class Geom::Transformation
   # @example
   #   point = Geom::Point3d.new(20, 30, 0)
   #   scale = 10
-  #   tr = Geom::Transformation.scaling(point, scale)
+  #   transformation = Geom::Transformation.scaling(point, scale)
   #
   # @overload scaling(scale)
   #
@@ -154,7 +154,7 @@ class Geom::Transformation
   #
   # @example
   #   vector = Geom::Vector3d.new(0, 1, 0)
-  #   tr = Geom::Transformation.translation(vector)
+  #   transformation = Geom::Transformation.translation(vector)
   #
   # @overload translation(vector)
   #
@@ -177,9 +177,9 @@ class Geom::Transformation
   # @example
   #   point1 = Geom::Point3d.new(10, 20, 30)
   #   point2 = Geom::Point3d.new(2, 2, 2)
-  #   tr = Geom::Transformation.new(point1)
-  #   # Returns Point3d(12, 22, 32)
-  #   point3 = tr * point2
+  #   transformation = Geom::Transformation.new(point1)
+  #   # The result is a Point3d(12, 22, 32)
+  #   new_point = transformation * point2
   #
   # @overload *(point)
   #
@@ -219,8 +219,8 @@ class Geom::Transformation
   #
   # @example
   #   point = Geom::Point3d.new(10, 20, 30)
-  #   tr1 = Geom::Transformation.new(point)
-  #   tr2 = tr1.clone
+  #   transformation = Geom::Transformation.new(point)
+  #   new_transformation = transformation.clone
   #
   # @return [Geom::Transformation]
   #
@@ -233,22 +233,22 @@ class Geom::Transformation
   #
   # @example
   #   point = Geom::Point3d.new(10, 20, 30)
-  #   tr = Geom::Transformation.new(point)
-  #   # Returns false.
-  #   status = tr.identity?
+  #   transformation = Geom::Transformation.new(point)
+  #   # Returns false
+  #   status = transformation.identity?
   #
   # @example
-  #   tr = Geom::Transformation.new(ORIGIN)
-  #   # Returns false.
-  #   status = tr.identity?
+  #   transformation = Geom::Transformation.new(ORIGIN)
+  #   # Returns true
+  #   status = transformation.identity?
   #
   # @example
-  #   tr = Geom::Transformation.new
-  #   # Returns true.
-  #   status = tr.identity?
+  #   transformation = Geom::Transformation.new
+  #   # Returns true
+  #   status = transformation.identity?
   #
   # @example
-  #   # Returns true.
+  #   # Returns true
   #   status = IDENTITY.identity?
   #
   # @note As of SketchUp 2018, this now looks at the data to determine if the
@@ -267,7 +267,18 @@ class Geom::Transformation
   #
   # @example
   #   point = Geom::Point3d.new(10, 20, 30)
-  #   tr = Geom::Transformation.new(point)
+  #   transformation = Geom::Transformation.new(point)
+  #
+  # @example
+  #   origin = Geom::Point3d.new(10, 10, 10)
+  #   zaxis = Geom::Vector3d.new(1, 2, 3)
+  #   transformation = Geom::Transformation.new(origin, zaxis)
+  #
+  # @example
+  #   origin = Geom::Point3d.new(1, 1, 1)
+  #   axis = Geom::Vector3d.new(1, 0, 0)
+  #   angle = 45.degrees # Return 45 degrees in radians.
+  #   transformation = Geom::Transformation.new(origin, axis, angle)
   #
   # @overload initialize
   #
@@ -306,8 +317,8 @@ class Geom::Transformation
   #
   # @overload initialize(origin, zaxis)
   #
-  #   Creates a Transformation where origin is the new origin, and zaxis is the
-  #   z axis. The x and y axes are determined using an arbitrary axis rule.
+  #   Creates a Transformation where origin is the new origin, and z axis is the
+  #   new z axis. The x and y axes are determined using an arbitrary axis rule.
   #   @param [Geom::Point3d] origin
   #   @param [Geom::Vector3d] zaxis
   #   @return [Geom::Transformation]
@@ -345,8 +356,14 @@ class Geom::Transformation
   #
   # @example
   #   point = Geom::Point3d.new(10, 20, 30)
-  #   tr1 = Geom::Transformation.new(point)
-  #   tr2 = tr1.inverse
+  #   transformation = Geom::Transformation.new(point)
+  #   new_transformation = transformation.inverse
+  #
+  # @note As of SketchUp 2026, this will raise an error if the
+  #   {Geom::Transformation} is not invertible. Prior to 2026 this would silently attempt
+  #   to invert the transformation possibly returning in an invalid transformation.
+  #
+  # @raise ArgumentError if the {Geom::Transformation} is not invertible (as of Sketchup 2026)
   #
   # @return [Geom::Transformation]
   #
@@ -358,8 +375,14 @@ class Geom::Transformation
   #
   # @example
   #   point = Geom::Point3d.new(10, 20, 30)
-  #   tr = Geom::Transformation.new(point)
-  #   tr.invert!
+  #   transformation = Geom::Transformation.new(point)
+  #   new_transformation = transformation.invert!
+  #
+  # @note As of SketchUp 2026, this will raise an error if the
+  #   {Geom::Transformation} is not invertible. Prior to 2026 this would silently attempt
+  #   to invert the transformation possibly creating in an invalid transformation.
+  #
+  # @raise ArgumentError if the {Geom::Transformation} is not invertible (as of Sketchup 2026)
   #
   # @return [Geom::Transformation]
   #
@@ -370,9 +393,9 @@ class Geom::Transformation
   # The {#origin} method retrieves the origin of a rigid transformation.
   #
   # @example
-  #   point1 = Geom::Point3d.new(10, 20, 30)
-  #   tr = Geom::Transformation.new(point1)
-  #   point2 = tr.origin
+  #   point = Geom::Point3d.new(10, 20, 30)
+  #   transformation = Geom::Transformation.new(point)
+  #   new_point = transformation.origin
   #
   # @return [Geom::Point3d] the origin of the transformation.
   #
@@ -386,9 +409,9 @@ class Geom::Transformation
   #
   # @example
   #   point1 = Geom::Point3d.new(10, 20, 30)
-  #   tr1 = Geom::Transformation.new(point)
+  #   transformation = Geom::Transformation.new(point1)
   #   point2 = Geom::Point3d.new(60, 40, 70)
-  #   tr1.set!(point2)
+  #   transformation.set!(point2)
   #
   # @overload set!(transformation)
   #
@@ -424,9 +447,10 @@ class Geom::Transformation
   #
   # @example
   #   point = Geom::Point3d.new(10, 20, 30)
-  #   tr = Geom::Transformation.new(point)
+  #   transformation = Geom::Transformation.new(point)
   #   # This splits the 16 items into a string of 4x4 elements for easier reading.
-  #   str4x4 = tr.to_a.each_slice(4).inject { |str, row| "#{str}\r\n#{row}" }
+  #   matrix = transformation.to_a.each_slice(4).inject { |str, row|"#{str}\r\n#{row}"}
+  #   puts matrix
   #
   # @return [Array<Float>]
   #
@@ -438,8 +462,8 @@ class Geom::Transformation
   #
   # @example
   #   point = Geom::Point3d.new(10, 20, 30)
-  #   tr = Geom::Transformation.new(point)
-  #   x = tr.xaxis
+  #   transformation = Geom::Transformation.new(point)
+  #   x = transformation.xaxis
   #
   # @return [Geom::Vector3d]
   #
@@ -451,8 +475,8 @@ class Geom::Transformation
   #
   # @example
   #   point = Geom::Point3d.new(10, 20, 30)
-  #   tr = Geom::Transformation.new(point)
-  #   x = tr.yaxis
+  #   transformation = Geom::Transformation.new(point)
+  #   y = transformation.yaxis
   #
   # @return [Geom::Vector3d]
   #
@@ -464,8 +488,8 @@ class Geom::Transformation
   #
   # @example
   #   point = Geom::Point3d.new(10, 20, 30)
-  #   tr = Geom::Transformation.new(point)
-  #   x = tr.zaxis
+  #   transformation = Geom::Transformation.new(point)
+  #   z = transformation.zaxis
   #
   # @return [Geom::Vector3d]
   #

data/lib/sketchup-api-stubs/stubs/Geom/Transformation2d.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 #
@@ -29,9 +29,9 @@ class Geom::Transformation2d
   # The {.scaling} method is used to create a transformation that does scaling.
   #
   # @example
-  #   point = Geom::Point3d.new(20, 30, 0)
+  #   point = Geom::Point2d.new(20, 30)
   #   scale = 10
-  #   tr = Geom::Transformation2d.scaling(point, scale)
+  #   transformation = Geom::Transformation2d.scaling(point, scale)
   #
   # @overload scaling(scale)
   #
@@ -70,7 +70,7 @@ class Geom::Transformation2d
   #
   # @example
   #   vector = Geom::Vector2d.new(0, 1)
-  #   tr = Geom::Transformation2d.translation(vector)
+  #   transformation = Geom::Transformation2d.translation(vector)
   #
   # @overload translation(vector)
   #
@@ -93,9 +93,9 @@ class Geom::Transformation2d
   # @example
   #   point1 = Geom::Point2d.new(5, 10)
   #   point2 = Geom::Point2d.new(2, 2)
-  #   tr = Geom::Transformation2d.new(point1)
-  #   # Returns Point2d(7, 12)
-  #   point3 = tr * point2
+  #   transformation = Geom::Transformation2d.translation(point1)
+  #   # The result is a Point2d(7, 12)
+  #   new_point = transformation * point2
   #
   # @overload *(point)
   #
@@ -114,8 +114,8 @@ class Geom::Transformation2d
   #
   # @overload *(point)
   #
-  #   @param [Array<Float, Float>] point
-  #   @return [Array<Float, Float>]
+  #   @param [Array(Float, Float)] point
+  #   @return [Array(Float, Float)]
   #
   # @version LayOut 2019
   def *(arg)
@@ -125,8 +125,10 @@ class Geom::Transformation2d
   # This checks whether the values of the transformations are the same.
   #
   # @example
-  #   tr = Geom::Transformation2d.new({1.0, 0.0, 0.0, 1.0, 1.0, 1.0})
-  #   tr == tr.clone
+  #   transformation1 = Geom::Transformation2d.new([1.0, 0.0, 0.0, 1.0, 1.0, 1.0])
+  #   transformation2 = Geom::Transformation2d.translation([1, 1])
+  #   # Returns true
+  #   transformation1 == transformation2
   #
   # @param [Geom::Transformation2d] other
   #
@@ -139,8 +141,8 @@ class Geom::Transformation2d
   # The {#clone} method creates a copy of the {Geom::Transformation2d}.
   #
   # @example
-  #   tr1 = Geom::Transformation2d.new
-  #   tr2 = tr1.clone
+  #   transformation = Geom::Transformation2d.new
+  #   new_transformation = transformation.clone
   #
   # @return [Geom::Transformation2d]
   #
@@ -152,18 +154,18 @@ class Geom::Transformation2d
   # {IDENTITY_2D} transform.
   #
   # @example
-  #   array = {1.0, 0.0, 0.0, 1.0, 1.0, 0.0}
-  #   tr = Geom::Transformation2d.new(array)
-  #   # Returns false.
-  #   status = tr.identity?
+  #   array = [1.0, 0.0, 0.0, 1.0, 1.0, 0.0]
+  #   transformation = Geom::Transformation2d.new(array)
+  #   # Returns false
+  #   status = transformation.identity?
   #
   # @example
-  #   tr = Geom::Transformation2d.new
-  #   # Returns true.
-  #   status = tr.identity?
+  #   transformation = Geom::Transformation2d.new
+  #   # Returns true
+  #   status = transformation.identity?
   #
   # @example
-  #   # Returns true.
+  #   # Returns true
   #   status = IDENTITY_2D.identity?
   #
   # @return [Boolean] +true+ if the transform is the identity
@@ -177,7 +179,9 @@ class Geom::Transformation2d
   # of {Geom::Transformation2d}.
   #
   # @example
-  #   tr = Geom::Transformation2d.new({1.0, 0.0, 0.0, 1.0, 1.0, 1.0})
+  #   transformation1 = Geom::Transformation2d.new
+  #
+  #   transformation2 = Geom::Transformation2d.new([1.0, 0.0, 0.0, 1.0, 1.0, 1.0])
   #
   # @overload initialize
   #
@@ -203,8 +207,8 @@ class Geom::Transformation2d
   #
   # @example
   #   point = Geom::Point2d.new(5, 10)
-  #   tr1 = Geom::Transformation2d.new(point)
-  #   tr2 = tr1.inverse
+  #   transformation = Geom::Transformation2d.translation(point)
+  #   new_transformation = transformation.inverse
   #
   # @return [Geom::Transformation2d]
   #
@@ -216,8 +220,8 @@ class Geom::Transformation2d
   #
   # @example
   #   point = Geom::Point2d.new(5, 10)
-  #   tr = Geom::Transformation2d.new(point)
-  #   tr.invert!
+  #   transformation = Geom::Transformation2d.translation(point)
+  #   transformation.invert!
   #
   # @return [Geom::Transformation2d]
   #
@@ -229,9 +233,9 @@ class Geom::Transformation2d
   # The argument is anything that can be converted into a {Geom::Transformation2d}.
   #
   # @example
-  #   tr1 = Geom::Transformation2d.new
-  #   array = {2.0, 0.0, 0.0, 2.0, 0.0, 0.0}
-  #   tr1.set!(array)
+  #   transformation = Geom::Transformation2d.new
+  #   matrix = [2.0, 0.0, 0.0, 2.0, 0.0, 0.0]
+  #   transformation.set!(matrix)
   #
   # @overload set!(transformation)
   #
@@ -251,8 +255,8 @@ class Geom::Transformation2d
   # define the Transformation2d.
   #
   # @example
-  #   tr = Geom::Transformation2d.new
-  #   tr.to_a.each_slice(2) {|a| p a}
+  #   transformation = Geom::Transformation2d.new
+  #   transformation.to_a.each_slice(2) {|a| p a}
   #
   # @return [Array<Float>] an array of 6 elements
   #