sketchup-api-stubs 0.7.9 → 0.7.11

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

@@ -1,306 +1,306 @@
-# Copyright:: Copyright 2023 Trimble Inc.
-# License:: The MIT License (MIT)
-
-# The DimensionLinear class represents linear dimensions.
-#
-# @version SketchUp 2014
-class Sketchup::DimensionLinear < Sketchup::Dimension
-
-  # Constants
-
-  ALIGNED_TEXT_ABOVE = nil # Stub value.
-  ALIGNED_TEXT_CENTER = nil # Stub value.
-  ALIGNED_TEXT_OUTSIDE = nil # Stub value.
-
-  TEXT_CENTERED = nil # Stub value.
-  TEXT_OUTSIDE_END = nil # Stub value.
-  TEXT_OUTSIDE_START = nil # Stub value.
-
-  # Instance Methods
-
-  # The aligned_text_position method returns the text position for dimensions
-  # with aligned text (i.e. has_aligned_text? returns true).
-  # Valid values are class constants:
-  # - DimensionLinear::ALIGNED_TEXT_ABOVE
-  # - DimensionLinear::ALIGNED_TEXT_CENTER
-  # - DimensionLinear::ALIGNED_TEXT_OUTSIDE
-  #
-  # @example
-  #   pos = dim.aligned_text_position
-  #   if pos == Sketchup::DimensionLinear::ALIGNED_TEXT_ABOVE
-  #     puts 'Text is above'
-  #   elsif pos == Sketchup::DimensionLinear::ALIGNED_TEXT_CENTER
-  #     puts 'Text is centered'
-  #   elsif pos == Sketchup::DimensionLinear::ALIGNED_TEXT_OUTSIDE
-  #     puts 'Text is outside'
-  #   end
-  #
-  # @return an integer specifying the text position
-  #
-  # @version SketchUp 2014
-  def aligned_text_position
-  end
-
-  # The aligned_text_position= method is used to set the text position for
-  # dimensions with aligned text (i.e. has_aligned_text? returns true).
-  # Valid values are class constants:
-  # - DimensionLinear::ALIGNED_TEXT_ABOVE
-  # - DimensionLinear::ALIGNED_TEXT_CENTER
-  # - DimensionLinear::ALIGNED_TEXT_OUTSIDE
-  #
-  # @example
-  #   dim.aligned_text_position = Sketchup::DimensionLinear::ALIGNED_TEXT_CENTER
-  #
-  # @param pos
-  #   an integer specifying the text position
-  #
-  # @return the text position that was set.
-  #
-  # @version SketchUp 2014
-  def aligned_text_position=(pos)
-  end
-
-  # The end method returns the point or entity the dimension is referencing at
-  # its end.
-  #
-  # @example
-  #   arr = dim.end
-  #   if arr[0].nil?
-  #     puts "No attached entity. Point is #{arr[1]}"
-  #   else
-  #     puts "Attached entity: #{arr[0]}, at point #{arr[1]}"
-  #   end
-  #
-  # @return Array - An array of size 2:
-  #   - Entity being referenced or nil if not associated.
-  #   - Point3d that contains the referenced location.
-  #
-  # @version SketchUp 2014
-  def end
-  end
-
-  # The end= method is used to set the end point of the dimension and/or the
-  # entity it is referencing.
-  #
-  # @example
-  #   # Reference a point
-  #   dim.end = [50, 10, 0]
-  #   # Reference end vertex of an edge
-  #   dim.end = edge.end
-  #   # Attach to an edge's midpoint
-  #   p0 = edge.start.position
-  #   p1 = edge.end.position
-  #   mp = Geom::Point3d.new((p0.x+p1.x)/2.0, (p0.y+p1.y)/2.0, (p0.z+p1.z)/2.0)
-  #   dim.end = [edge, mp]
-  #
-  # @param pt_or_entity
-  #   This parameter can take several forms:
-  #   - an InputPoint
-  #   - a Point3d
-  #   - a Vertex
-  #   - a ConstructionPoint
-  #   - an array of size 2: [Edge, Point3d along the edge]
-  #   - an array of size 2: [ConstructionLine, Point3d along the line]
-  #
-  # @return self
-  #
-  # @version SketchUp 2014
-  def end=(pt_or_entity)
-  end
-
-  # The {#end_attached_to} method will return the attached end point via an array
-  # containing the {Sketchup::InstancePath} and {Geom::Point3d}.
-  #
-  # @example
-  #   # Assuming you have a valid dimension selected that is attached to a
-  #   # component instance
-  #   dim = Sketchup.active_model.selection[0]
-  #   dim.end_attached_to
-  #
-  # @return [Array(Sketchup::InstancePath, Geom::Point3d), nil]
-  #
-  # @version SketchUp 2019
-  def end_attached_to
-  end
-
-  # The {#end_attached_to=} method will attach the ending point to the
-  # {Sketchup::InstancePath} and {Geom::Point3d}.
-  #
-  # @example
-  #   # Assuming you have a valid dimension selected that is attached to a
-  #   # component instance
-  #   dim = Sketchup.active_model.selection[0]
-  #   # get the path (instance_path, point)
-  #   path = dim.end_attached_to
-  #   instance_path = path[0]
-  #   instance = instance_path.to_a[0]
-  #   point1 = Geom::Point3d.new(0, 0, 0)
-  #   point2 = Geom::Point3d.new(20, 20, 20)
-  #   instance.definition.entities.add_edges(point1, point2)
-  #   edge = instance.definition.entities.grep(Sketchup::Edge).first
-  #   new_instance_path = Sketchup::InstancePath.new([instance, edge])
-  #   point2 = point2.transform(new_instance_path.transformation.inverse)
-  #   dim.end_attached_to = [new_instance_path, point2]
-  #
-  # @param [Array(Sketchup::InstancePath, Geom::Point3d)] path
-  #
-  # @version SketchUp 2019
-  def end_attached_to=(path)
-  end
-
-  # The offset_vector method returns the parallel offset vector from the
-  # reference line to the dimension line measured from the 'start' reference
-  # point.
-  #
-  # @example
-  #   vec = dim.offset_vector
-  #   puts "Offset vector is #{vec.to_s}"
-  #
-  # @return offset vector as a Vector3d
-  #
-  # @version SketchUp 2014
-  def offset_vector
-  end
-
-  # The offset_vector= method is used to set the parallel offset vector from the
-  # reference line to the dimension line measured from the 'start' reference
-  # point.
-  #
-  # @example
-  #   dim.offset_vector = Geom::Vector3d.new(0, 0, 10)
-  #
-  # @param [Geom::Vector3d] offset_vector
-  #
-  # @version SketchUp 2014
-  def offset_vector=(offset_vector)
-  end
-
-  # The start method returns the point or entity the dimension is referencing at
-  # its start.
-  #
-  # @example
-  #   arr = dim.start
-  #   if arr[0].nil?
-  #     puts "No attached entity. Point is #{arr[1]}"
-  #   else
-  #     puts "Attached entity: #{arr[0]}, at point #{arr[1]}"
-  #   end
-  #
-  # @return Array - An array of size 2:
-  #   - Entity being referenced or nil if not associated.
-  #   - Point3d that contains the referenced location.
-  #
-  # @version SketchUp 2014
-  def start
-  end
-
-  # The start= method is used to set the start point of the dimension and/or
-  # the entity it is referencing.
-  #
-  # @example
-  #   # Reference a point
-  #   dim.start = [50, 10, 0]
-  #   # Reference end vertex of an edge
-  #   dim.start = edge.end
-  #   # Attach to an edge's midpoint
-  #   p0 = edge.start.position
-  #   p1 = edge.end.position
-  #   mp = Geom::Point3d.new((p0.x+p1.x)/2.0, (p0.y+p1.y)/2.0, (p0.z+p1.z)/2.0)
-  #   dim.start = [edge, mp]
-  #
-  # @param pt_or_entity
-  #   This parameter can take several forms:
-  #   - an InputPoint
-  #   - a Point3d
-  #   - a Vertex
-  #   - a ConstructionPoint
-  #   - an array of size 2: [Edge, Point3d along the edge]
-  #   - an array of size 2: [ConstructionLine, Point3d along the line]
-  #
-  # @return self
-  #
-  # @version SketchUp 2014
-  def start=(pt_or_entity)
-  end
-
-  # The {#start_attached_to} method will return the attached start point via an
-  # array containing the {Sketchup::InstancePath} and {Geom::Point3d}.
-  #
-  # @example
-  #   # Assuming you have a valid dimension selected that is attached to a
-  #   # component instance
-  #   dim = Sketchup.active_model.selection[0]
-  #   dim.start_attached_to
-  #
-  # @return [Array(Sketchup::InstancePath, Geom::Point3d), nil]
-  #
-  # @version SketchUp 2019
-  def start_attached_to
-  end
-
-  # The {#start_attached_to=} method will attach the starting point to the
-  # {Sketchup::InstancePath} and {Geom::Point3d}.
-  #
-  # @example
-  #   # Assuming you have a valid dimension selected that is attached to a
-  #   # component instance
-  #   dim = Sketchup.active_model.selection[0]
-  #   # get the path (instance_path, point)
-  #   path = dim.start_attached_to
-  #   instance_path = path[0]
-  #   instance = instance_path.to_a[0]
-  #   point1 = Geom::Point3d.new(0, 0, 0)
-  #   point2 = Geom::Point3d.new(20, 20, 20)
-  #   instance.definition.entities.add_edges(point1, point2)
-  #   edge = instance.definition.entities.grep(Sketchup::Edge).first
-  #   new_instance_path = Sketchup::InstancePath.new([instance, edge])
-  #   point2 = point2.transform(new_instance_path.transformation.inverse)
-  #   dim.start_attached_to = [new_instance_path, point2]
-  #
-  # @param [Array(Sketchup::InstancePath, Geom::Point3d)] path
-  #
-  # @version SketchUp 2019
-  def start_attached_to=(path)
-  end
-
-  # The text_position method returns the position of the text along the dimension
-  # line. Valid values are class constants:
-  # - DimensionLinear::TEXT_OUTSIDE_START
-  # - DimensionLinear::TEXT_CENTERED
-  # - DimensionLinear::TEXT_OUTSIDE_END
-  #
-  # @example
-  #   pos = dim.text_position
-  #   if pos == Sketchup::DimensionLinear::TEXT_OUTSIDE_START
-  #     puts 'Text position is Outside start'
-  #   elsif pos == Sketchup::DimensionLinear::TEXT_CENTERED
-  #     puts 'Text position is Centered'
-  #   elsif pos == Sketchup::DimensionLinear::TEXT_OUTSIDE_END
-  #     puts 'Text position is Outside end'
-  #   end
-  #
-  # @return an integer specifying the text position
-  #
-  # @version SketchUp 2014
-  def text_position
-  end
-
-  # The text_position= method is used to set the position of the text along the
-  # dimension line. Valid values are class constants:
-  # - DimensionLinear::TEXT_OUTSIDE_START
-  # - DimensionLinear::TEXT_CENTERED
-  # - DimensionLinear::TEXT_OUTSIDE_END
-  #
-  # @example
-  #   dim.text_position = Sketchup::DimensionLinear::TEXT_CENTERED
-  #
-  # @param pos
-  #   an integer specifying the text position
-  #
-  # @return the text position that was set.
-  #
-  # @version SketchUp 2014
-  def text_position=(pos)
-  end
-
-end
+# Copyright:: Copyright 2026 Trimble Inc.
+# License:: The MIT License (MIT)
+
+# The DimensionLinear class represents linear dimensions.
+#
+# @version SketchUp 2014
+class Sketchup::DimensionLinear < Sketchup::Dimension
+
+  # Constants
+
+  ALIGNED_TEXT_ABOVE = nil # Stub value.
+  ALIGNED_TEXT_CENTER = nil # Stub value.
+  ALIGNED_TEXT_OUTSIDE = nil # Stub value.
+
+  TEXT_CENTERED = nil # Stub value.
+  TEXT_OUTSIDE_END = nil # Stub value.
+  TEXT_OUTSIDE_START = nil # Stub value.
+
+  # Instance Methods
+
+  # The {#aligned_text_position} method returns the text position for dimensions
+  # with aligned text (i.e. has_aligned_text? returns true).
+  # Valid values are class constants:
+  # - {Sketchup::DimensionLinear::ALIGNED_TEXT_ABOVE}
+  # - {Sketchup::DimensionLinear::ALIGNED_TEXT_CENTER}
+  # - {Sketchup::DimensionLinear::ALIGNED_TEXT_OUTSIDE}
+  #
+  # @example
+  #   pos = dim.aligned_text_position
+  #   if pos == Sketchup::DimensionLinear::ALIGNED_TEXT_ABOVE
+  #     puts 'Text is above'
+  #   elsif pos == Sketchup::DimensionLinear::ALIGNED_TEXT_CENTER
+  #     puts 'Text is centered'
+  #   elsif pos == Sketchup::DimensionLinear::ALIGNED_TEXT_OUTSIDE
+  #     puts 'Text is outside'
+  #   end
+  #
+  # @return an integer specifying the text position
+  #
+  # @version SketchUp 2014
+  def aligned_text_position
+  end
+
+  # The {#aligned_text_position=} method is used to set the text position for
+  # dimensions with aligned text (i.e. has_aligned_text? returns true).
+  # Valid values are class constants:
+  # - {Sketchup::DimensionLinear::ALIGNED_TEXT_ABOVE}
+  # - {Sketchup::DimensionLinear::ALIGNED_TEXT_CENTER}
+  # - {Sketchup::DimensionLinear::ALIGNED_TEXT_OUTSIDE}
+  #
+  # @example
+  #   dim.aligned_text_position = Sketchup::DimensionLinear::ALIGNED_TEXT_CENTER
+  #
+  # @param pos
+  #   an integer specifying the text position
+  #
+  # @return the text position that was set.
+  #
+  # @version SketchUp 2014
+  def aligned_text_position=(pos)
+  end
+
+  # The end method returns the point or entity the dimension is referencing at
+  # its end.
+  #
+  # @example
+  #   arr = dim.end
+  #   if arr[0].nil?
+  #     puts "No attached entity. Point is #{arr[1]}"
+  #   else
+  #     puts "Attached entity: #{arr[0]}, at point #{arr[1]}"
+  #   end
+  #
+  # @return Array - An array of size 2:
+  #   - Entity being referenced or nil if not associated.
+  #   - Point3d that contains the referenced location.
+  #
+  # @version SketchUp 2014
+  def end
+  end
+
+  # The end= method is used to set the end point of the dimension and/or the
+  # entity it is referencing.
+  #
+  # @example
+  #   # Reference a point
+  #   dim.end = [50, 10, 0]
+  #   # Reference end vertex of an edge
+  #   dim.end = edge.end
+  #   # Attach to an edge's midpoint
+  #   p0 = edge.start.position
+  #   p1 = edge.end.position
+  #   mp = Geom::Point3d.new((p0.x+p1.x)/2.0, (p0.y+p1.y)/2.0, (p0.z+p1.z)/2.0)
+  #   dim.end = [edge, mp]
+  #
+  # @param pt_or_entity
+  #   This parameter can take several forms:
+  #   - an InputPoint
+  #   - a Point3d
+  #   - a Vertex
+  #   - a ConstructionPoint
+  #   - an array of size 2: [Edge, Point3d along the edge]
+  #   - an array of size 2: [ConstructionLine, Point3d along the line]
+  #
+  # @return self
+  #
+  # @version SketchUp 2014
+  def end=(pt_or_entity)
+  end
+
+  # The {#end_attached_to} method will return the attached end point via an array
+  # containing the {Sketchup::InstancePath} and {Geom::Point3d}.
+  #
+  # @example
+  #   # Assuming you have a valid dimension selected that is attached to a
+  #   # component instance
+  #   dim = Sketchup.active_model.selection[0]
+  #   dim.end_attached_to
+  #
+  # @return [Array(Sketchup::InstancePath, Geom::Point3d), nil]
+  #
+  # @version SketchUp 2019
+  def end_attached_to
+  end
+
+  # The {#end_attached_to=} method will attach the ending point to the
+  # {Sketchup::InstancePath} and {Geom::Point3d}.
+  #
+  # @example
+  #   # Assuming you have a valid dimension selected that is attached to a
+  #   # component instance
+  #   dim = Sketchup.active_model.selection[0]
+  #   # get the path (instance_path, point)
+  #   path = dim.end_attached_to
+  #   instance_path = path[0]
+  #   instance = instance_path.to_a[0]
+  #   point1 = Geom::Point3d.new(0, 0, 0)
+  #   point2 = Geom::Point3d.new(20, 20, 20)
+  #   instance.definition.entities.add_edges(point1, point2)
+  #   edge = instance.definition.entities.grep(Sketchup::Edge).first
+  #   new_instance_path = Sketchup::InstancePath.new([instance, edge])
+  #   point2 = point2.transform(new_instance_path.transformation.inverse)
+  #   dim.end_attached_to = [new_instance_path, point2]
+  #
+  # @param [Array(Sketchup::InstancePath, Geom::Point3d)] path
+  #
+  # @version SketchUp 2019
+  def end_attached_to=(path)
+  end
+
+  # The offset_vector method returns the parallel offset vector from the
+  # reference line to the dimension line measured from the 'start' reference
+  # point.
+  #
+  # @example
+  #   vec = dim.offset_vector
+  #   puts "Offset vector is #{vec.to_s}"
+  #
+  # @return offset vector as a Vector3d
+  #
+  # @version SketchUp 2014
+  def offset_vector
+  end
+
+  # The offset_vector= method is used to set the parallel offset vector from the
+  # reference line to the dimension line measured from the 'start' reference
+  # point.
+  #
+  # @example
+  #   dim.offset_vector = Geom::Vector3d.new(0, 0, 10)
+  #
+  # @param [Geom::Vector3d] offset_vector
+  #
+  # @version SketchUp 2014
+  def offset_vector=(offset_vector)
+  end
+
+  # The start method returns the point or entity the dimension is referencing at
+  # its start.
+  #
+  # @example
+  #   arr = dim.start
+  #   if arr[0].nil?
+  #     puts "No attached entity. Point is #{arr[1]}"
+  #   else
+  #     puts "Attached entity: #{arr[0]}, at point #{arr[1]}"
+  #   end
+  #
+  # @return Array - An array of size 2:
+  #   - Entity being referenced or nil if not associated.
+  #   - Point3d that contains the referenced location.
+  #
+  # @version SketchUp 2014
+  def start
+  end
+
+  # The start= method is used to set the start point of the dimension and/or
+  # the entity it is referencing.
+  #
+  # @example
+  #   # Reference a point
+  #   dim.start = [50, 10, 0]
+  #   # Reference end vertex of an edge
+  #   dim.start = edge.end
+  #   # Attach to an edge's midpoint
+  #   p0 = edge.start.position
+  #   p1 = edge.end.position
+  #   mp = Geom::Point3d.new((p0.x+p1.x)/2.0, (p0.y+p1.y)/2.0, (p0.z+p1.z)/2.0)
+  #   dim.start = [edge, mp]
+  #
+  # @param pt_or_entity
+  #   This parameter can take several forms:
+  #   - an InputPoint
+  #   - a Point3d
+  #   - a Vertex
+  #   - a ConstructionPoint
+  #   - an array of size 2: [Edge, Point3d along the edge]
+  #   - an array of size 2: [ConstructionLine, Point3d along the line]
+  #
+  # @return self
+  #
+  # @version SketchUp 2014
+  def start=(pt_or_entity)
+  end
+
+  # The {#start_attached_to} method will return the attached start point via an
+  # array containing the {Sketchup::InstancePath} and {Geom::Point3d}.
+  #
+  # @example
+  #   # Assuming you have a valid dimension selected that is attached to a
+  #   # component instance
+  #   dim = Sketchup.active_model.selection[0]
+  #   dim.start_attached_to
+  #
+  # @return [Array(Sketchup::InstancePath, Geom::Point3d), nil]
+  #
+  # @version SketchUp 2019
+  def start_attached_to
+  end
+
+  # The {#start_attached_to=} method will attach the starting point to the
+  # {Sketchup::InstancePath} and {Geom::Point3d}.
+  #
+  # @example
+  #   # Assuming you have a valid dimension selected that is attached to a
+  #   # component instance
+  #   dim = Sketchup.active_model.selection[0]
+  #   # get the path (instance_path, point)
+  #   path = dim.start_attached_to
+  #   instance_path = path[0]
+  #   instance = instance_path.to_a[0]
+  #   point1 = Geom::Point3d.new(0, 0, 0)
+  #   point2 = Geom::Point3d.new(20, 20, 20)
+  #   instance.definition.entities.add_edges(point1, point2)
+  #   edge = instance.definition.entities.grep(Sketchup::Edge).first
+  #   new_instance_path = Sketchup::InstancePath.new([instance, edge])
+  #   point2 = point2.transform(new_instance_path.transformation.inverse)
+  #   dim.start_attached_to = [new_instance_path, point2]
+  #
+  # @param [Array(Sketchup::InstancePath, Geom::Point3d)] path
+  #
+  # @version SketchUp 2019
+  def start_attached_to=(path)
+  end
+
+  # The {#text_position} method returns the position of the text along the dimension
+  # line. Valid values are class constants:
+  # - {Sketchup::DimensionLinear::TEXT_OUTSIDE_START}
+  # - {Sketchup::DimensionLinear::TEXT_CENTERED}
+  # - {Sketchup::DimensionLinear::TEXT_OUTSIDE_END}
+  #
+  # @example
+  #   pos = dim.text_position
+  #   if pos == Sketchup::DimensionLinear::TEXT_OUTSIDE_START
+  #     puts 'Text position is Outside start'
+  #   elsif pos == Sketchup::DimensionLinear::TEXT_CENTERED
+  #     puts 'Text position is Centered'
+  #   elsif pos == Sketchup::DimensionLinear::TEXT_OUTSIDE_END
+  #     puts 'Text position is Outside end'
+  #   end
+  #
+  # @return an integer specifying the text position
+  #
+  # @version SketchUp 2014
+  def text_position
+  end
+
+  # The {#text_position=} method is used to set the position of the text along the
+  # dimension line. Valid values are class constants:
+  # - {Sketchup::DimensionLinear::TEXT_OUTSIDE_START}
+  # - {Sketchup::DimensionLinear::TEXT_CENTERED}
+  # - {Sketchup::DimensionLinear::TEXT_OUTSIDE_END}
+  #
+  # @example
+  #   dim.text_position = Sketchup::DimensionLinear::TEXT_CENTERED
+  #
+  # @param pos
+  #   an integer specifying the text position
+  #
+  # @return the text position that was set.
+  #
+  # @version SketchUp 2014
+  def text_position=(pos)
+  end
+
+end