sketchup-api-stubs 0.7.4 → 0.7.5

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

@@ -1,82 +1,84 @@
-# Copyright:: Copyright 2020 Trimble Inc.
-# License:: The MIT License (MIT)
-
-# This observer interface is implemented to react to component instance
-# events. To implement this observer, create a Ruby class of this type,
-# override the desired methods, and add an instance of the observer to the
-# objects of interests.
-#
-# Note that you may also attach {Sketchup::InstanceObserver}s to
-# {Sketchup::Group}s.
-#
-# @example
-#   # This is an example of an observer that watches a specific instance
-#   # for open edit actions and shows a messagebox.
-#   class MyInstanceObserver < Sketchup::InstanceObserver
-#     def onOpen(instance)
-#       puts "onOpen: #{instance}"
-#     end
-#
-#     def onClose(instance)
-#       puts "onClose: #{instance}"
-#     end
-#   end
-#
-#   # Attach the observer. (This example assumes that your first definition
-#   # in the model contains an instance to attach the observer to. This
-#   # example should work with a model where Sang or Bryce are present in
-#   # the template.)
-#   model = Sketchup.active_model
-#   model.definitions[0].instances[0].add_observer(MyInstanceObserver.new)
-#
-# @version SketchUp 6.0
-class Sketchup::InstanceObserver < Sketchup::EntityObserver
-
-  # Instance Methods
-
-  # The {#onClose} method is called when an instance is "closed," meaning an end
-  # user was editing a component's geometry and then exited back into the
-  # parent's editing space.
-  #
-  # @example
-  #   def onClose(instance)
-  #     puts "onClose: #{instance}"
-  #   end
-  #
-  # @param [Sketchup::ComponentInstance] instance
-  #   The instance that was just
-  #   closed
-  #
-  # @return [nil]
-  #
-  # @version SketchUp 6.0
-  def onClose(instance)
-  end
-
-  # The {#onOpen} method is called when an instance is "opened," meaning an end
-  # user has double clicked on it to edit its geometry. This is particularly
-  # useful if your plugin is dynamically drawing geometry or performing
-  # transformations in global space, since when in "edit component" mode all
-  # transformations and positions are returned in relation to the current
-  # component's origin.
-  #
-  # This method will tell you when a user has entered edit mode, and you can
-  # then use {Sketchup::Model#active_path} and {Sketchup::Model#edit_transform}
-  # methods to determine any corrections you need to make to your
-  # transformations.
-  #
-  # @example
-  #   def onOpen(instance)
-  #     puts "onOpen: #{instance}"
-  #   end
-  #
-  # @param [Sketchup::ComponentInstance] instance
-  #   The instance that was opened
-  #
-  # @return [nil]
-  #
-  # @version SketchUp 6.0
-  def onOpen(instance)
-  end
-
-end
+# Copyright:: Copyright 2020 Trimble Inc.
+# License:: The MIT License (MIT)
+
+# This observer interface is implemented to react to component instance
+# events.
+#
+# Note that you may also attach {Sketchup::InstanceObserver}s to
+# {Sketchup::Group}s.
+#
+# @abstract To implement this observer, create a Ruby class of this type,
+#   override the desired methods, and add an instance of the observer to the
+#   objects of interests.
+#
+# @example
+#   # This is an example of an observer that watches a specific instance
+#   # for open edit actions and shows a messagebox.
+#   class MyInstanceObserver < Sketchup::InstanceObserver
+#     def onOpen(instance)
+#       puts "onOpen: #{instance}"
+#     end
+#
+#     def onClose(instance)
+#       puts "onClose: #{instance}"
+#     end
+#   end
+#
+#   # Attach the observer. (This example assumes that your first definition
+#   # in the model contains an instance to attach the observer to. This
+#   # example should work with a model where Sang or Bryce are present in
+#   # the template.)
+#   model = Sketchup.active_model
+#   model.definitions[0].instances[0].add_observer(MyInstanceObserver.new)
+#
+# @version SketchUp 6.0
+class Sketchup::InstanceObserver < Sketchup::EntityObserver
+
+  # Instance Methods
+
+  # The {#onClose} method is called when an instance is "closed," meaning an end
+  # user was editing a component's geometry and then exited back into the
+  # parent's editing space.
+  #
+  # @example
+  #   def onClose(instance)
+  #     puts "onClose: #{instance}"
+  #   end
+  #
+  # @param [Sketchup::ComponentInstance] instance
+  #   The instance that was just
+  #   closed
+  #
+  # @return [nil]
+  #
+  # @version SketchUp 6.0
+  def onClose(instance)
+  end
+
+  # The {#onOpen} method is called when an instance is "opened," meaning an end
+  # user has double clicked on it to edit its geometry. This is particularly
+  # useful if your plugin is dynamically drawing geometry or performing
+  # transformations in global space, since when in "edit component" mode all
+  # transformations and positions are returned in relation to the current
+  # component's origin.
+  #
+  # This method will tell you when a user has entered edit mode, and you can
+  # then use {Sketchup::Model#active_path} and {Sketchup::Model#edit_transform}
+  # methods to determine any corrections you need to make to your
+  # transformations.
+  #
+  # @example
+  #   def onOpen(instance)
+  #     puts "onOpen: #{instance}"
+  #   end
+  #
+  # @param [Sketchup::ComponentInstance] instance
+  #   The instance that was opened
+  #
+  # @return [nil]
+  #
+  # @version SketchUp 6.0
+  def onOpen(instance)
+  end
+
+end

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

@@ -1,303 +1,306 @@
-# Copyright:: Copyright 2020 Trimble Inc.
-# License:: The MIT License (MIT)
-
-# The {Sketchup::InstancePath} class represent the instance path to a given
-# entity within the model hierarchy.
-#
-# @version SketchUp 2017
-class Sketchup::InstancePath
-
-  # Includes
-
-  include Enumerable
-
-  # Instance Methods
-
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   group = model.entities.add_group
-  #   edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
-  #   path = Sketchup::InstancePath.new([group, edge])
-  #   if path.size > 1
-  #     # do something
-  #   end
-  #
-  # @return [Boolean] `true` if the instances paths represent the same set of
-  #   entities.
-  #
-  # @version SketchUp 2017
-  def ==(other)
-  end
-
-  # The elements of an instance path can be accessed like an array.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   group = model.entities.add_group
-  #   edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
-  #   path = Sketchup::InstancePath.new([group, edge])
-  #   path[0] == group # returns true
-  #   path[1] == edge # returns true
-  #
-  # @param [Integer] index
-  #
-  # @raise [IndexError] if the given index is out of bounds
-  #
-  # @raise [TypeError] if the index is not of integer type
-  #
-  # @raise [TypeError] if the instance path refer to deleted entities.
-  #
-  # @return [Sketchup::Entity]
-  #
-  # @version SketchUp 2017
-  def [](index)
-  end
-
-  # The yielded entities will start with the root and end with the leaf.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   group = model.entities.add_group
-  #   edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
-  #   path = Sketchup::InstancePath.new([group, edge])
-  #   path.each { |entity|
-  #     # do something
-  #   }
-  #
-  # @raise [TypeError] if the instance path refer to deleted entities.
-  #
-  # @return [nil]
-  #
-  # @version SketchUp 2017
-  #
-  # @yield [Sketchup::Entity] entity
-  def each
-  end
-
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   group = model.entities.add_group
-  #   edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
-  #   path = Sketchup::InstancePath.new([group, edge])
-  #   if path.empty?
-  #     # do something...
-  #   end
-  #
-  # @raise [TypeError] if the instance path refer to deleted entities.
-  #
-  # @return [Boolean]
-  #
-  # @version SketchUp 2017
-  def empty?
-  end
-
-  # Returns `true` if the instance path contain the given object.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   group = model.entities.add_group
-  #   edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
-  #   path = Sketchup::InstancePath.new([group, edge])
-  #   if path.include?(edge)
-  #     # do something...
-  #   end
-  #
-  # @param [Object] object
-  #
-  # @raise [TypeError] if the instance path refer to deleted entities.
-  #
-  # @return [Boolean]
-  #
-  # @version SketchUp 2017
-  def include?(object)
-  end
-
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   group = model.entities.add_group
-  #   edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
-  #   path = Sketchup::InstancePath.new([group, edge])
-  #
-  # @param [Array<Sketchup::Entity>] path
-  #   The leaf can be any entity, but the
-  #   rest must be a group or component instance.
-  #
-  # @raise [ArgumentError] if the instance path isn't composed of instances and
-  #   an optional leaf entity.
-  #
-  # @return [Sketchup::InstancePath]
-  #
-  # @version SketchUp 2017
-  def initialize(path)
-  end
-
-  # The leaf of an instance path is the last element which can be any entity
-  # that can be represented in the model. This is normally a
-  # {Sketchup::Drawingelement}, but could be a {Sketchup::Vertex}.
-  #
-  # An instance can also be a leaf.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   group = model.entities.add_group
-  #   edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
-  #   path = Sketchup::InstancePath.new([group, edge])
-  #   path.leaf == edge # returns true
-  #
-  # @raise [TypeError] if the instance path refer to deleted entities.
-  #
-  # @return [Sketchup::Entity]
-  #
-  # @version SketchUp 2017
-  def leaf
-  end
-
-  # {#length} is an alias of {#size}.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   group = model.entities.add_group
-  #   edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
-  #   path = Sketchup::InstancePath.new([group, edge])
-  #   if path.length > 1
-  #     # do something
-  #   end
-  #
-  # @raise [TypeError] if the instance path refer to deleted entities.
-  #
-  # @return [Integer]
-  #
-  # @see #size
-  #
-  # @version SketchUp 2017
-  def length
-  end
-
-  # The serialized version of an instance path is the persistent ids of its
-  # entities concatenated with a period.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   group = model.entities.add_group
-  #   edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
-  #   path = Sketchup::InstancePath.new([group, edge])
-  #   pid_path = path.persistent_id_path # something like "342.345"
-  #
-  # @raise [TypeError] if the instance path refer to deleted entities.
-  #
-  # @return [String]
-  #
-  # @see Sketchup::Model#instance_path_from_pid_path
-  #
-  # @version SketchUp 2017
-  def persistent_id_path
-  end
-
-  # The root of an instance path is the element located closest to the model
-  # root. This will be a group or component instance. If you have a non-instance
-  # as a leaf with no other parent component this will return `nil`.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   group = model.entities.add_group
-  #   edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
-  #   path = Sketchup::InstancePath.new([group, edge])
-  #   path.root == group # returns true
-  #
-  # @raise [TypeError] if the instance path refer to deleted entities.
-  #
-  # @return [Sketchup::Group, Sketchup::ComponentInstance, nil]
-  #
-  # @version SketchUp 2017
-  def root
-  end
-
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   group = model.entities.add_group
-  #   edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
-  #   path = Sketchup::InstancePath.new([group, edge])
-  #   if path.size > 1
-  #     # do something
-  #   end
-  #
-  # @raise [TypeError] if the instance path refer to deleted entities.
-  #
-  # @return [Integer]
-  #
-  # @see #length
-  #
-  # @version SketchUp 2017
-  def size
-  end
-
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   group = model.entities.add_group
-  #   edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
-  #   path = Sketchup::InstancePath.new([group, edge])
-  #   pid_string = path.to_a.join('.')
-  #
-  # @raise [TypeError] if the instance path refer to deleted entities.
-  #
-  # @return [Array] an array representing the instance path.
-  #
-  # @version SketchUp 2017
-  def to_a
-  end
-
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   group = model.entities.add_group
-  #   edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
-  #   path = Sketchup::InstancePath.new([group, edge])
-  #   tr = path.transformation
-  #
-  # @overload transformation
-  #
-  #   @return [Geom::Transformation] the combined transformation up to the
-  #     the leaf entity.
-  #
-  # @overload transformation(index)
-  #
-  #   @param [Integer] index
-  #   @return [Geom::Transformation]  the combined transformation up to the
-  #     the given index.
-  #
-  # @raise [IndexError] if the given index is out of bounds
-  #
-  # @raise [TypeError] if the index is not of integer type
-  #
-  # @raise [TypeError] if the instance path refer to deleted entities.
-  #
-  # @version SketchUp 2017
-  def transformation(*args)
-  end
-
-  # An instance path is valid if it has at least one element and consist of
-  # groups and instances with exception of the leaf which can be any entity.
-  #
-  # This method doesn't check if the path can actually be looked up in the model.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   group = model.entities.add_group
-  #   edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
-  #   path = Sketchup::InstancePath.new([group, edge])
-  #   if path.valid?
-  #     # do something...
-  #   end
-  #
-  # @return [Boolean]
-  #
-  # @version SketchUp 2017
-  def valid?
-  end
-
-end
+# Copyright:: Copyright 2020 Trimble Inc.
+# License:: The MIT License (MIT)
+
+# The {Sketchup::InstancePath} class represent the instance path to a given
+# entity within the model hierarchy.
+#
+# @version SketchUp 2017
+class Sketchup::InstancePath
+
+  # Includes
+
+  include Enumerable
+
+  # Instance Methods
+
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   group = model.entities.add_group
+  #   edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
+  #   path = Sketchup::InstancePath.new([group, edge])
+  #   if path.size > 1
+  #     # do something
+  #   end
+  #
+  # @return [Boolean] `true` if the instances paths represent the same set of
+  #   entities.
+  #
+  # @version SketchUp 2017
+  def ==(other)
+  end
+
+  # The elements of an instance path can be accessed similarly to an array.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   group = model.entities.add_group
+  #   edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
+  #   path = Sketchup::InstancePath.new([group, edge])
+  #   path[0] == group # returns true
+  #   path[1] == edge # returns true
+  #
+  # @note This method does not accept negative indices. For the exact behavior
+  #   of an array, use +{#to_a}+.
+  #
+  # @param [Integer] index
+  #
+  # @raise [IndexError] if the given index is out of bounds
+  #
+  # @raise [TypeError] if the index is not of integer type
+  #
+  # @raise [TypeError] if the instance path refer to deleted entities.
+  #
+  # @return [Sketchup::Entity]
+  #
+  # @version SketchUp 2017
+  def [](index)
+  end
+
+  # The yielded entities will start with the root and end with the leaf.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   group = model.entities.add_group
+  #   edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
+  #   path = Sketchup::InstancePath.new([group, edge])
+  #   path.each { |entity|
+  #     # do something
+  #   }
+  #
+  # @raise [TypeError] if the instance path refer to deleted entities.
+  #
+  # @return [nil]
+  #
+  # @version SketchUp 2017
+  #
+  # @yield [Sketchup::Entity] entity
+  def each
+  end
+
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   group = model.entities.add_group
+  #   edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
+  #   path = Sketchup::InstancePath.new([group, edge])
+  #   if path.empty?
+  #     # do something...
+  #   end
+  #
+  # @raise [TypeError] if the instance path refer to deleted entities.
+  #
+  # @return [Boolean]
+  #
+  # @version SketchUp 2017
+  def empty?
+  end
+
+  # Returns `true` if the instance path contain the given object.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   group = model.entities.add_group
+  #   edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
+  #   path = Sketchup::InstancePath.new([group, edge])
+  #   if path.include?(edge)
+  #     # do something...
+  #   end
+  #
+  # @param [Object] object
+  #
+  # @raise [TypeError] if the instance path refer to deleted entities.
+  #
+  # @return [Boolean]
+  #
+  # @version SketchUp 2017
+  def include?(object)
+  end
+
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   group = model.entities.add_group
+  #   edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
+  #   path = Sketchup::InstancePath.new([group, edge])
+  #
+  # @param [Array<Sketchup::Entity>] path
+  #   The leaf can be any entity, but the
+  #   rest must be a group or component instance.
+  #
+  # @raise [ArgumentError] if the instance path isn't composed of instances and
+  #   an optional leaf entity.
+  #
+  # @return [Sketchup::InstancePath]
+  #
+  # @version SketchUp 2017
+  def initialize(path)
+  end
+
+  # The leaf of an instance path is the last element which can be any entity
+  # that can be represented in the model. This is normally a
+  # {Sketchup::Drawingelement}, but could be a {Sketchup::Vertex}.
+  #
+  # An instance can also be a leaf.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   group = model.entities.add_group
+  #   edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
+  #   path = Sketchup::InstancePath.new([group, edge])
+  #   path.leaf == edge # returns true
+  #
+  # @raise [TypeError] if the instance path refer to deleted entities.
+  #
+  # @return [Sketchup::Entity]
+  #
+  # @version SketchUp 2017
+  def leaf
+  end
+
+  # {#length} is an alias of {#size}.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   group = model.entities.add_group
+  #   edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
+  #   path = Sketchup::InstancePath.new([group, edge])
+  #   if path.length > 1
+  #     # do something
+  #   end
+  #
+  # @raise [TypeError] if the instance path refer to deleted entities.
+  #
+  # @return [Integer]
+  #
+  # @see #size
+  #
+  # @version SketchUp 2017
+  def length
+  end
+
+  # The serialized version of an instance path is the persistent ids of its
+  # entities concatenated with a period.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   group = model.entities.add_group
+  #   edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
+  #   path = Sketchup::InstancePath.new([group, edge])
+  #   pid_path = path.persistent_id_path # something like "342.345"
+  #
+  # @raise [TypeError] if the instance path refer to deleted entities.
+  #
+  # @return [String]
+  #
+  # @see Sketchup::Model#instance_path_from_pid_path
+  #
+  # @version SketchUp 2017
+  def persistent_id_path
+  end
+
+  # The root of an instance path is the element located closest to the model
+  # root. This will be a group or component instance. If you have a non-instance
+  # as a leaf with no other parent component this will return `nil`.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   group = model.entities.add_group
+  #   edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
+  #   path = Sketchup::InstancePath.new([group, edge])
+  #   path.root == group # returns true
+  #
+  # @raise [TypeError] if the instance path refer to deleted entities.
+  #
+  # @return [Sketchup::Group, Sketchup::ComponentInstance, nil]
+  #
+  # @version SketchUp 2017
+  def root
+  end
+
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   group = model.entities.add_group
+  #   edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
+  #   path = Sketchup::InstancePath.new([group, edge])
+  #   if path.size > 1
+  #     # do something
+  #   end
+  #
+  # @raise [TypeError] if the instance path refer to deleted entities.
+  #
+  # @return [Integer]
+  #
+  # @see #length
+  #
+  # @version SketchUp 2017
+  def size
+  end
+
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   group = model.entities.add_group
+  #   edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
+  #   path = Sketchup::InstancePath.new([group, edge])
+  #   pid_string = path.to_a.join('.')
+  #
+  # @raise [TypeError] if the instance path refer to deleted entities.
+  #
+  # @return [Array] an array representing the instance path.
+  #
+  # @version SketchUp 2017
+  def to_a
+  end
+
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   group = model.entities.add_group
+  #   edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
+  #   path = Sketchup::InstancePath.new([group, edge])
+  #   tr = path.transformation
+  #
+  # @overload transformation
+  #
+  #   @return [Geom::Transformation] the combined transformation up to the
+  #     the leaf entity.
+  #
+  # @overload transformation(index)
+  #
+  #   @param [Integer] index
+  #   @return [Geom::Transformation]  the combined transformation up to the
+  #     the given index.
+  #
+  # @raise [IndexError] if the given index is out of bounds
+  #
+  # @raise [TypeError] if the index is not of integer type
+  #
+  # @raise [TypeError] if the instance path refer to deleted entities.
+  #
+  # @version SketchUp 2017
+  def transformation(*args)
+  end
+
+  # An instance path is valid if it has at least one element and consist of
+  # groups and instances with exception of the leaf which can be any entity.
+  #
+  # This method doesn't check if the path can actually be looked up in the model.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   group = model.entities.add_group
+  #   edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
+  #   path = Sketchup::InstancePath.new([group, edge])
+  #   if path.valid?
+  #     # do something...
+  #   end
+  #
+  # @return [Boolean]
+  #
+  # @version SketchUp 2017
+  def valid?
+  end
+
+end