sketchup-api-stubs 0.7.4 → 0.7.5

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

@@ -1,44 +1,45 @@
-# Copyright:: Copyright 2020 Trimble Inc.
-# License:: The MIT License (MIT)
-
-# This observer interface is implemented to react to rendering options events.
-# To implement this observer, create a Ruby class of this type, implement 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 the rendering options
-#   # for changes.
-#   class MyRenderingOptionsObserver < Sketchup::RenderingOptionsObserver
-#     def onRenderingOptionsChanged(rendering_options, type)
-#       puts "onRenderingOptionsChanged(#{rendering_options}, #{type})"
-#     end
-#   end
-#
-#   # Attach the observer.
-#   rendering_options = Sketchup.active_model.rendering_options
-#   rendering_options.add_observer(MyRenderingOptionsObserver.new)
-class Sketchup::RenderingOptionsObserver
-
-  # Instance Methods
-
-  # The onRenderingOptionsChanged method is invoked whenever the user changes
-  # their rendering options.
-  #
-  # @example
-  #   def onRenderingOptionsChanged(rendering_options, type)
-  #     puts "onRenderingOptionsChanged(#{rendering_options}, #{type})"
-  #   end
-  #
-  # @param [Sketchup::RenderingOptions] rendering_options
-  #
-  # @param [Integer] type
-  #   A number indicating which option was changed
-  #   represented by one of the constants defined in
-  #   {Sketchup::RenderingOptions}.
-  #
-  # @version SketchUp 6.0
-  def onRenderingOptionsChanged(rendering_options, type)
-  end
-
-end
+# Copyright:: Copyright 2020 Trimble Inc.
+# License:: The MIT License (MIT)
+
+# This observer interface is implemented to react to rendering options events.
+#
+# @abstract To implement this observer, create a Ruby class of this type, implement 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 the rendering options
+#   # for changes.
+#   class MyRenderingOptionsObserver < Sketchup::RenderingOptionsObserver
+#     def onRenderingOptionsChanged(rendering_options, type)
+#       puts "onRenderingOptionsChanged(#{rendering_options}, #{type})"
+#     end
+#   end
+#
+#   # Attach the observer.
+#   rendering_options = Sketchup.active_model.rendering_options
+#   rendering_options.add_observer(MyRenderingOptionsObserver.new)
+class Sketchup::RenderingOptionsObserver
+
+  # Instance Methods
+
+  # The onRenderingOptionsChanged method is invoked whenever the user changes
+  # their rendering options.
+  #
+  # @example
+  #   def onRenderingOptionsChanged(rendering_options, type)
+  #     puts "onRenderingOptionsChanged(#{rendering_options}, #{type})"
+  #   end
+  #
+  # @param [Sketchup::RenderingOptions] rendering_options
+  #
+  # @param [Integer] type
+  #   A number indicating which option was changed
+  #   represented by one of the constants defined in
+  #   {Sketchup::RenderingOptions}.
+  #
+  # @version SketchUp 6.0
+  def onRenderingOptionsChanged(rendering_options, type)
+  end
+
+end

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

@@ -1,150 +1,150 @@
-# Copyright:: Copyright 2020 Trimble Inc.
-# License:: The MIT License (MIT)
-
-# The SectionPlane class represents a section plane in a SketchUp model. Note
-# that prior to SketchUp 2014 there was no way to create a SectionPlane object
-# using Ruby. For older versions of SketchUp, you must manually create a
-# section plane with the Section Plane Tool in SketchUp and then query the
-# entities array to find the SectionPlane object.
-#
-# @version SketchUp 6.0
-class Sketchup::SectionPlane < Sketchup::Drawingelement
-
-  # Instance Methods
-
-  # The activate method is used to make the section plane the active one of its
-  # parent component/group.
-  #
-  # @example
-  #   entities = Sketchup.active_model.entities
-  #   sp = entities.add_section_plane([50, 50, 0], [1.0, 1.0, 0])
-  #   sp.activate
-  #
-  # @return self if successful
-  #
-  # @version SketchUp 2014
-  def activate
-  end
-
-  # The active? method indicates whether the section plane is active or not.
-  #
-  # @example
-  #   entities = Sketchup.active_model.entities
-  #   sp = entities.add_section_plane([50, 50, 0], [1.0, 1.0, 0])
-  #   sp.activate
-  #   if sp.active?
-  #      puts "Yes, it is active"
-  #   end
-  #
-  # @return [Boolean] boolean - true if active
-  #
-  # @version SketchUp 2014
-  def active?
-  end
-
-  # The get_plane method is used to retrieve the plane that the section plane is
-  # on.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   entities = model.active_entities
-  #   # Grab the first section plane from the model.
-  #   sp = entities.grep(Sketchup::SectionPlane).first
-  #   plane = sp.get_plane
-  #   if (plane)
-  #     puts plane.to_s
-  #   else
-  #     puts 'Failure'
-  #   end
-  #
-  # @return plane - a plane. See the Geom module and Array class
-  #   for further information on planes.
-  #
-  # @version SketchUp 6.0
-  def get_plane
-  end
-
-  # The {#name} method is used to retrieve the name of the section plane.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   entities = model.active_entities
-  #   # Grab the first section plane from the model.
-  #   section_plane = entities.grep(Sketchup::SectionPlane).first
-  #   name = section_plane.name
-  #
-  # @return [String]
-  #
-  # @version SketchUp 2018
-  def name
-  end
-
-  # The {#name=} method is used to set the name of a section plane.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   entities = Sketchup.active_model.entities
-  #   # Grab the first section plane from the model.
-  #   section_plane = entities.grep(Sketchup::SectionPlane).first
-  #   section_plane.name = "my section plane"
-  #
-  # @param [String] name
-  #   The new name for the section plane object.
-  #
-  # @version SketchUp 2018
-  def name=(name)
-  end
-
-  # The set_plane method is used to set the plane that the section plane is
-  # on.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   entities = model.active_entities
-  #   # Grab the first section plane from the model.
-  #   sp = entities.grep(Sketchup::SectionPlane).first
-  #   sp = sp.set_plane my_plane_array
-  #
-  # @param plane
-  #   An array representing the new plane,
-  #
-  # @return section_plane - the updated SectionPlane.
-  #
-  # @version SketchUp 6.0
-  def set_plane(plane)
-  end
-
-  # The {#symbol} method is used to retrieve the symbol of the section plane.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   entities = model.active_entities
-  #   # Grab the first section plane from the model.
-  #   section_plane = entities.grep(Sketchup::SectionPlane).first
-  #   symbol = section_plane.symbol
-  #
-  # @return [String]
-  #
-  # @version SketchUp 2018
-  def symbol
-  end
-
-  # The {#symbol=} method is used to set the symbol of a section plane.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   entities = Sketchup.active_model.entities
-  #   # Grab the first section plane from the model.
-  #   section_plane = entities.grep(Sketchup::SectionPlane).first
-  #   section_plane.symbol = "AB1"
-  #
-  # @note The symbol must be three characters or less.
-  #
-  # @param [String] symbol
-  #   The new symbol for the section plane object.
-  #
-  # @version SketchUp 2018
-  def symbol=(symbol)
-  end
-
-end
+# Copyright:: Copyright 2020 Trimble Inc.
+# License:: The MIT License (MIT)
+
+# The SectionPlane class represents a section plane in a SketchUp model. Note
+# that prior to SketchUp 2014 there was no way to create a SectionPlane object
+# using Ruby. For older versions of SketchUp, you must manually create a
+# section plane with the Section Plane Tool in SketchUp and then query the
+# entities array to find the SectionPlane object.
+#
+# @version SketchUp 6.0
+class Sketchup::SectionPlane < Sketchup::Drawingelement
+
+  # Instance Methods
+
+  # The activate method is used to make the section plane the active one of its
+  # parent component/group.
+  #
+  # @example
+  #   entities = Sketchup.active_model.entities
+  #   sp = entities.add_section_plane([50, 50, 0], [1.0, 1.0, 0])
+  #   sp.activate
+  #
+  # @return self if successful
+  #
+  # @version SketchUp 2014
+  def activate
+  end
+
+  # The active? method indicates whether the section plane is active or not.
+  #
+  # @example
+  #   entities = Sketchup.active_model.entities
+  #   sp = entities.add_section_plane([50, 50, 0], [1.0, 1.0, 0])
+  #   sp.activate
+  #   if sp.active?
+  #      puts "Yes, it is active"
+  #   end
+  #
+  # @return [Boolean] boolean - true if active
+  #
+  # @version SketchUp 2014
+  def active?
+  end
+
+  # The get_plane method is used to retrieve the plane that the section plane is
+  # on.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   entities = model.active_entities
+  #   # Grab the first section plane from the model.
+  #   sp = entities.grep(Sketchup::SectionPlane).first
+  #   plane = sp.get_plane
+  #   if (plane)
+  #     puts plane.to_s
+  #   else
+  #     puts 'Failure'
+  #   end
+  #
+  # @return plane - a plane. See the Geom module and Array class
+  #   for further information on planes.
+  #
+  # @version SketchUp 6.0
+  def get_plane
+  end
+
+  # The {#name} method is used to retrieve the name of the section plane.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   entities = model.active_entities
+  #   # Grab the first section plane from the model.
+  #   section_plane = entities.grep(Sketchup::SectionPlane).first
+  #   name = section_plane.name
+  #
+  # @return [String]
+  #
+  # @version SketchUp 2018
+  def name
+  end
+
+  # The {#name=} method is used to set the name of a section plane.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   entities = Sketchup.active_model.entities
+  #   # Grab the first section plane from the model.
+  #   section_plane = entities.grep(Sketchup::SectionPlane).first
+  #   section_plane.name = "my section plane"
+  #
+  # @param [String] name
+  #   The new name for the section plane object.
+  #
+  # @version SketchUp 2018
+  def name=(name)
+  end
+
+  # The set_plane method is used to set the plane that the section plane is
+  # on.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   entities = model.active_entities
+  #   # Grab the first section plane from the model.
+  #   sp = entities.grep(Sketchup::SectionPlane).first
+  #   sp = sp.set_plane my_plane_array
+  #
+  # @param plane
+  #   An array representing the new plane,
+  #
+  # @return section_plane - the updated SectionPlane.
+  #
+  # @version SketchUp 6.0
+  def set_plane(plane)
+  end
+
+  # The {#symbol} method is used to retrieve the symbol of the section plane.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   entities = model.active_entities
+  #   # Grab the first section plane from the model.
+  #   section_plane = entities.grep(Sketchup::SectionPlane).first
+  #   symbol = section_plane.symbol
+  #
+  # @return [String]
+  #
+  # @version SketchUp 2018
+  def symbol
+  end
+
+  # The {#symbol=} method is used to set the symbol of a section plane.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   entities = Sketchup.active_model.entities
+  #   # Grab the first section plane from the model.
+  #   section_plane = entities.grep(Sketchup::SectionPlane).first
+  #   section_plane.symbol = "AB1"
+  #
+  # @note The symbol must be three characters or less.
+  #
+  # @param [String] symbol
+  #   The new symbol for the section plane object.
+  #
+  # @version SketchUp 2018
+  def symbol=(symbol)
+  end
+
+end

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

@@ -1,454 +1,459 @@
-# Copyright:: Copyright 2020 Trimble Inc.
-# License:: The MIT License (MIT)
-
-# A set of the currently selected entities. Use the Model.selection method
-# to get a Selection object.  Note that the order of entities
-# (<code>selection[0]</code>, <code>selection[1]</code> and so on) in the set
-# is in no particular order and should not be assumed to be in the same order
-# as the user selected the entities.
-#
-# @example
-#   # Get a handle to the selection set.
-#   model = Sketchup.active_model
-#   selection = model.selection
-#
-# @version SketchUp 6.0
-class Sketchup::Selection
-
-  # Includes
-
-  include Enumerable
-
-  # Instance Methods
-
-  # The {#[]} method is used to retrieve an {Sketchup::Entity} from the selection
-  # by index. Index 0 is the first entity in the selection.
-  #
-  # This method is not very efficient. If you need to look at every entity in
-  # the selection, consider using {#each} instead of using this method
-  # to manually grab each one.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   entities = model.active_entities
-  #   selection = model.selection
-  #   selection.add(entities.to_a)
-  #   p selection[0]
-  #
-  # @param [Integer] index
-  #   The index of the Entity object to retrieve.
-  #
-  # @return [Sketchup::Entitiy, nil]
-  #
-  # @see #at
-  #
-  # @version SketchUp 6.0
-  def [](index)
-  end
-
-  # The add method is used to add entities to the selection.  Entities that are
-  # added to the Selection are visually indicated by the selection bounding box.
-  #
-  # You can pass it individual Entities or an Array of Entities:
-  # Note that the add, remove, and toggle methods are all aliases for one
-  # another. So if you call remove on an entity that is not selected, it will
-  # be toggled to be selected, not removed! Be cautious when writing your code to
-  # not make the assumption about the currently selected state of a given entity.
-  #
-  # @example
-  #   # Add by listing the entities...
-  #   ss.add(e1, e2, e3)
-  #
-  #   # ...or add by passing an Array of entities.
-  #   ss.add([e1, e2, e3])
-  #
-  # @example
-  #   entities = model.active_entities
-  #   entity = entities[0]
-  #   status = selection.add entity
-  #
-  # @overload add(entities)
-  #
-  #   @param [Array<Sketchup::Entity>] entities
-  #
-  # @overload add(*entities)
-  #
-  #   @param [Array<Sketchup::Entity>] entities
-  #
-  # @return [Integer] the number of Entity objects added
-  #
-  # @version SketchUp 6.0
-  def add(*args)
-  end
-
-  # The add_observer method is used to add an observer to the selection object.
-  #
-  # @example
-  #   selection = Sketchup.active_model.selection
-  #   status = selection.add_observer observer
-  #
-  # @param [Object] observer
-  #   An observer.
-  #
-  # @return [Boolean] true if successful, false if unsuccessful.
-  #
-  # @version SketchUp 6.0
-  def add_observer(observer)
-  end
-
-  # The {#at} method is an alias for {#[]}.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   entities = model.active_entities
-  #   selection = model.selection
-  #   selection.add(entities.to_a)
-  #   p selection.at(0)
-  #
-  # @param [Integer] index
-  #   The index of the Entity object to retrieve.
-  #
-  # @return [Sketchup::Entitiy, nil]
-  #
-  # @see #[]
-  #
-  # @version SketchUp 6.0
-  def at(index)
-  end
-
-  # The clear method is used to clear the selection.
-  #
-  # @example
-  #   entity = entities[0]
-  #   selection.add entity
-  #   UI.messagebox "Ready to Clear"
-  #   selection.clear
-  #
-  # @return [nil]
-  #
-  # @version SketchUp 6.0
-  def clear
-  end
-
-  # The {contains?} method is and alias of {#include?}.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   entity = model.active_entities.first
-  #   selection = model.selection
-  #   selection.add(entity)
-  #   p selection.contains?(entity)
-  #
-  # @param [Sketchup::Entity] entity
-  #
-  # @return [Boolean]
-  #
-  # @see #include?
-  #
-  # @version SketchUp 6.0
-  def contains?(entity)
-  end
-
-  #
-  # @example
-  #   selection = Sketchup.active_model.selection
-  #   number = selection.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
-  #   for {#length}.
-  #
-  # @return [Integer]
-  #
-  # @see #length
-  #
-  # @version SketchUp 6.0
-  def count
-  end
-
-  # The each method is used to iterate through all of the selected entities.
-  #
-  # If you want to do something with all of the selected Entities, this is more
-  # efficient than using [].
-  #
-  # @example
-  #   selection.each { |entity| UI.messagebox(entity) }
-  #
-  # @return [nil]
-  #
-  # @version SketchUp 6.0
-  #
-  # @yield [Sketchup::Entity] A variable that will hold each Entity object as they
-  #   are found.
-  def each
-  end
-
-  # The empty? method is used to determine if there are entities in the
-  # selection.
-  #
-  # @example
-  #   status = selection.add entity
-  #   status = selection.empty
-  #
-  # @return [Boolean]
-  #
-  # @version SketchUp 6.0
-  def empty?
-  end
-
-  # The first method is used to retrieve the first selected entity
-  #
-  # Returns nil if nothing is selected. This method is useful when you know that
-  # only a single entity is selected, or you are only interested in the first
-  # selected entity.
-  #
-  # @example
-  #   status = selection.add entity
-  #   entity = selection.first
-  #
-  # @return [Sketchup::Entity] the first selected Entity object if successful
-  #
-  # @version SketchUp 6.0
-  def first
-  end
-
-  # The {include?} method is used to determine if a given {Sketchup::Entity} is
-  # in the selection.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   entity = model.active_entities.first
-  #   selection = model.selection
-  #   selection.add(entity)
-  #   p selection.include?(entity)
-  #
-  # @param [Sketchup::Entity] entity
-  #
-  # @return [Boolean]
-  #
-  # @see #contains?
-  #
-  # @version SketchUp 6.0
-  def include?(entity)
-  end
-
-  # The #{invert} method is used to invert the selection.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   entities = model.active_entities
-  #   selection = model.selection
-  #   # Create a cube
-  #   face = entities.add_face([0, 0, 0], [9, 0, 0], [9, 9, 0], [0, 9, 0])
-  #   face.pushpull(-9)
-  #   # Add the first two faces to the selection
-  #   faces = entities.grep(Sketchup::Face).take(2)
-  #   selection.add(faces)
-  #   # Invert selection
-  #   selection.invert
-  #
-  # @return [nil]
-  #
-  # @version SketchUp 2019.2
-  def invert
-  end
-
-  # The is_curve? method is used to determine if the selection contains all
-  # edges that belong to a single curve.
-  #
-  # @example
-  #   selection.add entity
-  #   status = selection.is_curve?
-  #
-  # @return [Boolean]
-  #
-  # @version SketchUp 6.0
-  def is_curve?
-  end
-
-  # The is_surface? method is used to determine if the selection contains only
-  # all of the faces that are part of a single curved surface.
-  #
-  # @example
-  #   selection.add entity
-  #   status = selection.is_surface
-  #
-  # @return [Boolean]
-  #
-  # @version SketchUp 6.0
-  def is_surface?
-  end
-
-  # The {#length} method is used to retrieve the number of selected entities.
-  #
-  # @example
-  #   selection = Sketchup.active_model.selection
-  #   number = selection.length
-  #
-  # @return [Integer]
-  #
-  # @see #size
-  #
-  # @see #nitems
-  #
-  # @version SketchUp 6.0
-  def length
-  end
-
-  # The model method retrieves the model for the selection.
-  #
-  # @example
-  #   model = selection.model
-  #
-  # @return [Sketchup::Model] the model that includes the selection if
-  #   successful
-  #
-  # @version SketchUp 6.0
-  def model
-  end
-
-  # The {#nitems} method is an alias for {#length}.
-  #
-  # @example
-  #   selection = Sketchup.active_model.selection
-  #   number = selection.nitems
-  #
-  # @return [Integer]
-  #
-  # @see #length
-  #
-  # @version SketchUp 6.0
-  def nitems
-  end
-
-  # The remove method is used to remove entities from the selection.
-  #
-  # You can pass it individual Entities or an Array of Entities:
-  # Note that the add, remove, and toggle methods are all aliases for one
-  # another. So if you call remove on an entity that is not selected, it will
-  # be toggled to be selected, not removed! Be cautious when writing your code to
-  # not make the assumption about the currently selected state of a given entity.
-  #
-  # @example
-  #   # Remove by listing the entities...
-  #   ss.remove(e1, e2, e3)
-  #
-  #   # ...or remove by passing an Array of entities.
-  #   ss.remove([e1, e2, e3])
-  #
-  # @example
-  #   entities = model.active_entities
-  #   entity = entities[0]
-  #   status = selection.add entity
-  #
-  # @overload remove(entities)
-  #
-  #   @param [Array<Sketchup::Entity>] entities
-  #
-  # @overload remove(*entities)
-  #
-  #   @param [Array<Sketchup::Entity>] entities
-  #
-  # @return [Integer] the number of Entity objects removed
-  #
-  # @version SketchUp 6.0
-  def remove(*args)
-  end
-
-  # The remove_observer method is used to remove an observer from the selection
-  # object.
-  #
-  # @example
-  #   selection = Sketchup.active_model.selection
-  #   status = object.remove_observer observer
-  #
-  # @param [Object] observer
-  #   An observer.
-  #
-  # @return [Boolean] true if successful, false if unsuccessful.
-  #
-  # @version SketchUp 6.0
-  def remove_observer(observer)
-  end
-
-  # The shift method is used to remove the first entity from the selection and
-  # returns it.
-  #
-  # @example
-  #   status = selection.add entity
-  #   UI.messagebox "Ready to remove item from selection set"
-  #   entity = selection.shift
-  #
-  # @return [Sketchup::Entity] the first Entity object in the selection set
-  #   if successful
-  #
-  # @version SketchUp 6.0
-  def shift
-  end
-
-  # The single_object? method is used to determine if the selection contains a
-  # single object.
-  #
-  # It can either be a single Entity or a group of Entities for which is_curve?
-  # or is_surface? will return true.
-  #
-  # @example
-  #   status = selection.single_object
-  #
-  # @return [Boolean]
-  #
-  # @version SketchUp 6.0
-  def single_object?
-  end
-
-  # The {#size} method is an alias for {#length}.
-  #
-  # @example
-  #   selection = Sketchup.active_model.selection
-  #   number = selection.size
-  #
-  # @return [Integer]
-  #
-  # @see #length
-  #
-  # @version SketchUp 2014
-  def size
-  end
-
-  # The toggle method is used to change whether an entity is part of the
-  # selection. Entities that are not already selected
-  # are added. Entities that are already selected are removed.
-  #
-  # You can pass it individual Entities or an Array of Entities:
-  # Note that the add, remove, and toggle methods are all aliases for one
-  # another. So if you call remove on an entity that is not selected, it will
-  # be toggled to be selected, not removed! Be cautious when writing your code to
-  # not make the assumption about the currently selected state of a given entity.
-  #
-  # @example
-  #   # Toggle by listing the entities...
-  #   ss.toggle(e1, e2, e3)
-  #
-  #   # ...or toggle by passing an Array of entities.
-  #   ss.toggle([e1, e2, e3])
-  #
-  # @example
-  #   entities = model.active_entities
-  #   entity = entities[0]
-  #   status = selection.add entity
-  #
-  # @overload toggle(entities)
-  #
-  #   @param [Array<Sketchup::Entity>] entities
-  #
-  # @overload toggle(*entities)
-  #
-  #   @param [Array<Sketchup::Entity>] entities
-  #
-  # @return [Integer] the number of Entity objects changed
-  #
-  # @version SketchUp 6.0
-  def toggle(*args)
-  end
-
-end
+# Copyright:: Copyright 2020 Trimble Inc.
+# License:: The MIT License (MIT)
+
+# A set of the currently selected entities. Use the Model.selection method
+# to get a Selection object.  Note that the order of entities
+# (<code>selection[0]</code>, <code>selection[1]</code> and so on) in the set
+# is in no particular order and should not be assumed to be in the same order
+# as the user selected the entities.
+#
+# @example
+#   # Get a handle to the selection set.
+#   model = Sketchup.active_model
+#   selection = model.selection
+#
+# @version SketchUp 6.0
+class Sketchup::Selection
+
+  # Includes
+
+  include Enumerable
+
+  # Instance Methods
+
+  # The {#[]} method is used to retrieve an {Sketchup::Entity} from the selection
+  # by index. Index 0 is the first entity in the selection.
+  #
+  # This method is not very efficient. If you need to look at every entity in
+  # the selection, consider using {#each} instead of using this method
+  # to manually grab each one.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   entities = model.active_entities
+  #   selection = model.selection
+  #   selection.add(entities.to_a)
+  #   p selection[0]
+  #
+  # @param [Integer] index
+  #   The index of the Entity object to retrieve.
+  #
+  # @return [Sketchup::Entity, nil]
+  #
+  # @see #at
+  #
+  # @version SketchUp 6.0
+  def [](index)
+  end
+
+  # The add method is used to add entities to the selection.  Entities that are
+  # added to the Selection are visually indicated by the selection bounding box.
+  #
+  # You can pass it individual Entities or an Array of Entities:
+  # Note that the add, remove, and toggle methods are all aliases for one
+  # another. So if you call remove on an entity that is not selected, it will
+  # be toggled to be selected, not removed! Be cautious when writing your code to
+  # not make the assumption about the currently selected state of a given entity.
+  #
+  # @example
+  #   # Add by listing the entities...
+  #   ss.add(e1, e2, e3)
+  #
+  #   # ...or add by passing an Array of entities.
+  #   ss.add([e1, e2, e3])
+  #
+  # @example
+  #   entities = model.active_entities
+  #   entity = entities[0]
+  #   status = selection.add entity
+  #
+  # @overload add(entities)
+  #
+  #   @param [Array<Sketchup::Entity>] entities
+  #
+  # @overload add(*entities)
+  #
+  #   @param [Array<Sketchup::Entity>] entities
+  #
+  # @return [Integer] the number of Entity objects added
+  #
+  # @version SketchUp 6.0
+  def add(*args)
+  end
+
+  # The add_observer method is used to add an observer to the selection object.
+  #
+  # @example
+  #   selection = Sketchup.active_model.selection
+  #   status = selection.add_observer observer
+  #
+  # @param [Object] observer
+  #   An observer.
+  #
+  # @return [Boolean] true if successful, false if unsuccessful.
+  #
+  # @version SketchUp 6.0
+  def add_observer(observer)
+  end
+
+  # The {#at} method is an alias for {#[]}.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   entities = model.active_entities
+  #   selection = model.selection
+  #   selection.add(entities.to_a)
+  #   p selection.at(0)
+  #
+  # @param [Integer] index
+  #   The index of the Entity object to retrieve.
+  #
+  # @return [Sketchup::Entity, nil]
+  #
+  # @see #[]
+  #
+  # @version SketchUp 6.0
+  def at(index)
+  end
+
+  # The clear method is used to clear the selection.
+  #
+  # @example
+  #   entity = entities[0]
+  #   selection.add entity
+  #   UI.messagebox "Ready to Clear"
+  #   selection.clear
+  #
+  # @return [nil]
+  #
+  # @version SketchUp 6.0
+  def clear
+  end
+
+  # The {contains?} method is and alias of {#include?}.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   entity = model.active_entities.first
+  #   selection = model.selection
+  #   selection.add(entity)
+  #   p selection.contains?(entity)
+  #
+  # @param [Sketchup::Entity] entity
+  #
+  # @return [Boolean]
+  #
+  # @see #include?
+  #
+  # @version SketchUp 6.0
+  def contains?(entity)
+  end
+
+  #
+  # @example
+  #   selection = Sketchup.active_model.selection
+  #   number = selection.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
+  #   for {#length}.
+  #
+  # @return [Integer]
+  #
+  # @see #length
+  #
+  # @version SketchUp 6.0
+  def count
+  end
+
+  # The each method is used to iterate through all of the selected entities.
+  #
+  # If you want to do something with all of the selected Entities, this is more
+  # efficient than using [].
+  #
+  # @example
+  #   selection.each { |entity| puts entity }
+  #
+  # @note Don't remove content from this collection while iterating over it with
+  #   {#each}. This would change the size of the collection and cause elemnts to
+  #   be skipped as the indices change. Instead copy the current collection to an
+  #   array using +to_a+ and then use +each+ on the array, when removing content.
+  #
+  # @return [nil]
+  #
+  # @version SketchUp 6.0
+  #
+  # @yield [Sketchup::Entity] A variable that will hold each Entity object as they
+  #   are found.
+  def each
+  end
+
+  # The empty? method is used to determine if there are entities in the
+  # selection.
+  #
+  # @example
+  #   status = selection.add entity
+  #   status = selection.empty
+  #
+  # @return [Boolean]
+  #
+  # @version SketchUp 6.0
+  def empty?
+  end
+
+  # The first method is used to retrieve the first selected entity
+  #
+  # Returns nil if nothing is selected. This method is useful when you know that
+  # only a single entity is selected, or you are only interested in the first
+  # selected entity.
+  #
+  # @example
+  #   status = selection.add entity
+  #   entity = selection.first
+  #
+  # @return [Sketchup::Entity] the first selected Entity object if successful
+  #
+  # @version SketchUp 6.0
+  def first
+  end
+
+  # The {include?} method is used to determine if a given {Sketchup::Entity} is
+  # in the selection.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   entity = model.active_entities.first
+  #   selection = model.selection
+  #   selection.add(entity)
+  #   p selection.include?(entity)
+  #
+  # @param [Sketchup::Entity] entity
+  #
+  # @return [Boolean]
+  #
+  # @see #contains?
+  #
+  # @version SketchUp 6.0
+  def include?(entity)
+  end
+
+  # The {#invert} method is used to invert the selection.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   entities = model.active_entities
+  #   selection = model.selection
+  #   # Create a cube
+  #   face = entities.add_face([0, 0, 0], [9, 0, 0], [9, 9, 0], [0, 9, 0])
+  #   face.pushpull(-9)
+  #   # Add the first two faces to the selection
+  #   faces = entities.grep(Sketchup::Face).take(2)
+  #   selection.add(faces)
+  #   # Invert selection
+  #   selection.invert
+  #
+  # @return [nil]
+  #
+  # @version SketchUp 2019.2
+  def invert
+  end
+
+  # The is_curve? method is used to determine if the selection contains all
+  # edges that belong to a single curve.
+  #
+  # @example
+  #   selection.add entity
+  #   status = selection.is_curve?
+  #
+  # @return [Boolean]
+  #
+  # @version SketchUp 6.0
+  def is_curve?
+  end
+
+  # The is_surface? method is used to determine if the selection contains only
+  # all of the faces that are part of a single curved surface.
+  #
+  # @example
+  #   selection.add entity
+  #   status = selection.is_surface
+  #
+  # @return [Boolean]
+  #
+  # @version SketchUp 6.0
+  def is_surface?
+  end
+
+  # The {#length} method is used to retrieve the number of selected entities.
+  #
+  # @example
+  #   selection = Sketchup.active_model.selection
+  #   number = selection.length
+  #
+  # @return [Integer]
+  #
+  # @see #size
+  #
+  # @see #nitems
+  #
+  # @version SketchUp 6.0
+  def length
+  end
+
+  # The model method retrieves the model for the selection.
+  #
+  # @example
+  #   model = selection.model
+  #
+  # @return [Sketchup::Model] the model that includes the selection if
+  #   successful
+  #
+  # @version SketchUp 6.0
+  def model
+  end
+
+  # The {#nitems} method is an alias for {#length}.
+  #
+  # @example
+  #   selection = Sketchup.active_model.selection
+  #   number = selection.nitems
+  #
+  # @return [Integer]
+  #
+  # @see #length
+  #
+  # @version SketchUp 6.0
+  def nitems
+  end
+
+  # The remove method is used to remove entities from the selection.
+  #
+  # You can pass it individual Entities or an Array of Entities:
+  # Note that the add, remove, and toggle methods are all aliases for one
+  # another. So if you call remove on an entity that is not selected, it will
+  # be toggled to be selected, not removed! Be cautious when writing your code to
+  # not make the assumption about the currently selected state of a given entity.
+  #
+  # @example
+  #   # Remove by listing the entities...
+  #   ss.remove(e1, e2, e3)
+  #
+  #   # ...or remove by passing an Array of entities.
+  #   ss.remove([e1, e2, e3])
+  #
+  # @example
+  #   entities = model.active_entities
+  #   entity = entities[0]
+  #   status = selection.add entity
+  #
+  # @overload remove(entities)
+  #
+  #   @param [Array<Sketchup::Entity>] entities
+  #
+  # @overload remove(*entities)
+  #
+  #   @param [Array<Sketchup::Entity>] entities
+  #
+  # @return [Integer] the number of Entity objects removed
+  #
+  # @version SketchUp 6.0
+  def remove(*args)
+  end
+
+  # The remove_observer method is used to remove an observer from the selection
+  # object.
+  #
+  # @example
+  #   selection = Sketchup.active_model.selection
+  #   status = object.remove_observer observer
+  #
+  # @param [Object] observer
+  #   An observer.
+  #
+  # @return [Boolean] true if successful, false if unsuccessful.
+  #
+  # @version SketchUp 6.0
+  def remove_observer(observer)
+  end
+
+  # The shift method is used to remove the first entity from the selection and
+  # returns it.
+  #
+  # @example
+  #   status = selection.add entity
+  #   UI.messagebox "Ready to remove item from selection set"
+  #   entity = selection.shift
+  #
+  # @return [Sketchup::Entity] the first Entity object in the selection set
+  #   if successful
+  #
+  # @version SketchUp 6.0
+  def shift
+  end
+
+  # The single_object? method is used to determine if the selection contains a
+  # single object.
+  #
+  # It can either be a single Entity or a group of Entities for which is_curve?
+  # or is_surface? will return true.
+  #
+  # @example
+  #   status = selection.single_object
+  #
+  # @return [Boolean]
+  #
+  # @version SketchUp 6.0
+  def single_object?
+  end
+
+  # The {#size} method is an alias for {#length}.
+  #
+  # @example
+  #   selection = Sketchup.active_model.selection
+  #   number = selection.size
+  #
+  # @return [Integer]
+  #
+  # @see #length
+  #
+  # @version SketchUp 2014
+  def size
+  end
+
+  # The toggle method is used to change whether an entity is part of the
+  # selection. Entities that are not already selected
+  # are added. Entities that are already selected are removed.
+  #
+  # You can pass it individual Entities or an Array of Entities:
+  # Note that the add, remove, and toggle methods are all aliases for one
+  # another. So if you call remove on an entity that is not selected, it will
+  # be toggled to be selected, not removed! Be cautious when writing your code to
+  # not make the assumption about the currently selected state of a given entity.
+  #
+  # @example
+  #   # Toggle by listing the entities...
+  #   ss.toggle(e1, e2, e3)
+  #
+  #   # ...or toggle by passing an Array of entities.
+  #   ss.toggle([e1, e2, e3])
+  #
+  # @example
+  #   entities = model.active_entities
+  #   entity = entities[0]
+  #   status = selection.add entity
+  #
+  # @overload toggle(entities)
+  #
+  #   @param [Array<Sketchup::Entity>] entities
+  #
+  # @overload toggle(*entities)
+  #
+  #   @param [Array<Sketchup::Entity>] entities
+  #
+  # @return [Integer] the number of Entity objects changed
+  #
+  # @version SketchUp 6.0
+  def toggle(*args)
+  end
+
+end