sketchup-api-stubs 0.1.0

data/SketchUp/Sketchup/InstanceObserver.rb

@@ -0,0 +1,82 @@
+# Copyright:: Copyright 2017 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

data/SketchUp/Sketchup/InstancePath.rb

@@ -0,0 +1,297 @@
+# Copyright:: Copyright 2017 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 [TypeError] if the instance path refer to deleted entities.
+  #
+  # @raise [TypeError] if the index is not of integer type
+  #
+  # @raise [IndexError] if the given index is out of bounds
+  #
+  # @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 and 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.size > 1
+  #     # do something
+  #   end
+  #
+  # @raise [TypeError] if the instance path refer to deleted entities.
+  #
+  # @return [Integer]
+  #
+  # @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
+
+  # {#length} is and 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.size > 1
+  #     # do something
+  #   end
+  #
+  # @raise [TypeError] if the instance path refer to deleted entities.
+  #
+  # @return [Integer]
+  #
+  # @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
+
+  # overload transformation
+  #   @return [Sketchup::Transformation] the combined transformation up to the
+  #     the leaf entity.
+  #
+  # @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
+  #
+  # @param [Integer] index
+  #
+  # @raise [TypeError] if the index is not of integer type
+  #
+  # @raise [IndexError] if the given index is out of bounds
+  #
+  # @raise [TypeError] if the instance path refer to deleted entities.
+  #
+  # @return [Sketchup::Transformation] the combined transformation up to the
+  #   the given index.
+  #
+  # @version SketchUp 2017
+  def transformation(index)
+  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

data/SketchUp/Sketchup/Layer.rb

@@ -0,0 +1,240 @@
+# Copyright:: Copyright 2017 Trimble Inc.
+# License:: The MIT License (MIT)
+
+# The Layer class contains methods modifying and extracting information for a
+# layer.
+#
+# By default, a SketchUp model has one layer, Layer 0 (zero), which is the base
+# layer. You can't delete or rename Layer 0. Unlike certain other CAD software
+# packages, entities associated with different layers in SketchUp still
+# intersect with each other. (If you want collections of entities to not
+# intersect, place them in Groups instead.)
+#
+# Layers are commonly used to organize your model and control the visibility
+# of related groups and components. For example, you could make all of your
+# wall and roof entities different groups, associate layers with those groups,
+# and then hide those layers so as to display just the floor plan in the model.
+#
+# You can programatically create a new layer by calling the Layers.add method.
+#
+# @example
+#   model = Sketchup.active_model
+#   layers = model.layers
+#   new_layer = layers.add "test layer"
+#
+# @version SketchUp 6.0
+class Sketchup::Layer < Sketchup::Entity
+
+  # Includes
+
+  include Comparable
+
+  # Instance Methods
+
+  # The <=> method is used to compare two layers based on their names. You could
+  # use this for sorting if you're building a list of layer names.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   layers = model.layers
+  #   new_layer = layers.add "test layer"
+  #   layer1 = layers[0]
+  #   layer2 = layers[1]
+  #   status = layer1 <=> layer2
+  #
+  # @param layer2
+  #   A Layer object.
+  #
+  # @return status - -1 if layer1 is less than layer2. 1 if layer2
+  #   is less than layer1. 0 if layer1 and layer2 are
+  #   equal.
+  #
+  # @version SketchUp 6.0
+  def <=>(layer2)
+  end
+
+  # The == method is used to determine if two layers are the same.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   layers = model.layers
+  #   layer1 = layers.add "test layer 1"
+  #   layer2 = layers.add "test layer 2"
+  #   status = layer1 == layer2
+  #
+  # @param layer2
+  #   A Layer object.
+  #
+  # @return status - true if layer1 and layer2 are equal. false if
+  #   layer1 and layer2 are not equal.
+  #
+  # @version SketchUp 6.0
+  def ==(layer2)
+  end
+
+  # The color method is used to retrieve the color of the layer.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   layers = model.layers
+  #   new_layer = layers.add('Test layer')
+  #   color = new_layer.color
+  #
+  # @return color - the color of the Layer object
+  #
+  # @version SketchUp 2014
+  def color
+  end
+
+  # The color= method is used to set the name of a layer.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   layers = model.layers
+  #   new_layer = layers.add('Test layer')
+  #   new_layer.color = Sketchup::Color.new(192, 0, 0)
+  #
+  # @param color
+  #   The new color for the Layer object.
+  #
+  # @return color
+  #
+  # @version SketchUp 2014
+  def color=(color)
+  end
+
+  # The name method is used to retrieve the name of the layer.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   layers = model.layers
+  #   new_layer = layers.add "test layer"
+  #   name = new_layer.name
+  #
+  # @return name - the name of the Layer object
+  #
+  # @version SketchUp 6.0
+  def name
+  end
+
+  # The name= method is used to set the name of a layer.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   layers = model.layers
+  #   new_layer = layers.add "test layer"
+  #   name = new_layer.name = "new test layer"
+  #
+  # @param name
+  #   The new name for the Layer object.
+  #
+  # @return name - the newly set name
+  #
+  # @version SketchUp 6.0
+  def name=(name)
+  end
+
+  # The page_behavior method is used to retrieve the visibility behavior of the
+  # layer for new pages and existing pages. For example, you may want your layer
+  # to be visible or hidden by default in any new pages (aka Scenes) created by
+  # the user.
+  #
+  # A page keeps a list of layers that do not have their default behavior.
+  # If a layer is not in that list, then it is set to its default visibility
+  # determined by one of these values:
+  #
+  # The behaviour is composed of a combination of these flags:
+  #   - LAYER_VISIBLE_BY_DEFAULT: 0x0000
+  #   - LAYER_HIDDEN_BY_DEFAULT: 0x0001
+  #   - LAYER_USES_DEFAULT_VISIBILITY_ON_NEW_PAGES: 0x0000
+  #   - LAYER_IS_VISIBLE_ON_NEW_PAGES: 0x0010
+  #   - LAYER_IS_HIDDEN_ON_NEW_PAGES: 0x0020
+  #
+  # The default visibility for a layer is set by either
+  # <code>LAYER_VISIBLE_BY_DEFAULT</code> or
+  # <code>LAYER_HIDDEN_BY_DEFAULT</code>. This is what will be used when a page
+  # does not contain the visibility state of a layer.
+  #
+  # The remaining flags control the visibility of the layer for new pages.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   layers = model.layers
+  #   layer = layers.add('Test Layer')
+  #   hidden_by_default = (layer.page_behavior & LAYER_HIDDEN_BY_DEFAULT) ==
+  #                       LAYER_HIDDEN_BY_DEFAULT
+  #
+  # @return pagebehavior - an integer representing the current
+  #   behavior of the layer.
+  #
+  # @version SketchUp 6.0
+  def page_behavior
+  end
+
+  # The page_behavior= method is used to control the layer's visibility behavior
+  # on existing and new pages.
+  #
+  # The behavior is composed of a combination of these flags:
+  #   - LAYER_VISIBLE_BY_DEFAULT: 0x0000
+  #   - LAYER_HIDDEN_BY_DEFAULT: 0x0001
+  #   - LAYER_USES_DEFAULT_VISIBILITY_ON_NEW_PAGES: 0x0000
+  #   - LAYER_IS_VISIBLE_ON_NEW_PAGES: 0x0010
+  #   - LAYER_IS_HIDDEN_ON_NEW_PAGES: 0x0020
+  #
+  # When you Update a page (as opposed to creating a new page) the current
+  # visibility of the layer is used.
+  #
+  # NOTE: Prior to SketchUp 2014 the <code>LAYER_HIDDEN_BY_DEFAULT</code> flag
+  # would trigger the validation check in SketchUp that would reset the
+  # <code>page_behavior</code> of the layer.
+  #
+  # @example
+  #   layers = Sketchup.active_model.layers
+  #   layer = layers.add('Test Layer')
+  #   behavior = LAYER_HIDDEN_BY_DEFAULT | LAYER_IS_HIDDEN_ON_NEW_PAGES
+  #   layer.page_behavior = behavior
+  #
+  # @param pagebehavior
+  #   Pagebehavior value.
+  #
+  # @return pagebehavior - an integer representing the default
+  #   visibility of the layer.
+  #
+  # @version SketchUp 6.0
+  def page_behavior=(pagebehavior)
+  end
+
+  # The visible= method is used to set if the layer is visible.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   layers = model.layers
+  #   new_layer = layers.add "test layer"
+  #
+  #   # Hide the layer.
+  #   new_layer.visible = false
+  #
+  # @param is_visible
+  #   The new visibility setting.
+  #
+  # @version SketchUp 6.0
+  def visible=(is_visible)
+  end
+
+  # The visible? method is used to determine if the layer is visible.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   layers = model.layers
+  #   new_layer = layers.add "test layer"
+  #   UI.messagebox(new_layer.visible?)
+  #
+  # @return true if the layer is visible
+  #
+  # @return [Boolean]
+  #
+  # @version SketchUp 6.0
+  def visible?
+  end
+
+end