sketchup-api-stubs 0.1.0

data/SketchUp/Sketchup/Layers.rb

@@ -0,0 +1,235 @@
+# Copyright:: Copyright 2017 Trimble Inc.
+# License:: The MIT License (MIT)
+
+# The Layers collection allows you to see and manage all of the layers in a
+# model. You get a pointer to the Layers object from within the Model.
+#
+# @example
+#   model = Sketchup.active_model
+#   layers = model.layers
+#
+# @version SketchUp 6.0
+class Sketchup::Layers < Sketchup::Entity
+
+  # Includes
+
+  include Enumerable
+
+  # Instance Methods
+
+  # The [] method is used to retrieve a layer by index or name.
+  #
+  # The {#at} method is an alias for {#[]}.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   layers = model.layers
+  #   new_layer = layers.add "test layer"
+  #   layer_by_number = layers[1]
+  #   layer_by_name = layers["test layer"]
+  #
+  # @param index_or_name
+  #   A number representing the layer's index in an array of
+  #   Layer objects, or the name of the layer.
+  #
+  # @return layer - a Layer object
+  #
+  # @version SketchUp 6.0
+  def [](index_or_name)
+  end
+
+  # The add method is used to add a new layer.
+  #
+  # If you give the name of a Layer that is already defined, it will return the
+  # existing Layer rather than adding a new one.
+  #
+  # @example
+  #   layers = Sketchup.active_model.layers
+  #   layer = layers.add("Test Layer")
+  #
+  # @param layer_name
+  #   The name of the added layer.
+  #
+  # @return layer - the new Layer object
+  #
+  # @version SketchUp 6.0
+  def add(layer_name)
+  end
+
+  # The add_observer method is used to add an observer to the layers collection.
+  #
+  # @example
+  #   layers = Sketchup.active_model.layers
+  #   status = layers.add_observer observer
+  #
+  # @param observer
+  #   An observer.
+  #
+  # @return success - true if successful, false if unsuccessful.
+  #
+  # @version SketchUp 6.0
+  def add_observer(observer)
+  end
+
+  # The [] method is used to retrieve a layer by index or name.
+  #
+  # The {#at} method is an alias for {#[]}.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   layers = model.layers
+  #   new_layer = layers.add "test layer"
+  #   layer_by_number = layers[1]
+  #   layer_by_name = layers["test layer"]
+  #
+  # @param index_or_name
+  #   A number representing the layer's index in an array of
+  #   Layer objects, or the name of the layer.
+  #
+  # @return layer - a Layer object
+  #
+  # @version SketchUp 6.0
+  def at(index_or_name)
+  end
+
+  #
+  # @example
+  #   layers = Sketchup.active_model.layers
+  #   number = layers.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 - the number of layers in the collection
+  #
+  # @see #length
+  #
+  # @version SketchUp 6.0
+  def count
+  end
+
+  # The each method is used to iterate through all of the layers.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   layers = model.layers
+  #   layers.add("test layer")
+  #   layers.each { | layer | puts layer.name }
+  #
+  # @version SketchUp 6.0
+  #
+  # @yield [layer] - a variable that will hold each Layer object as they are found.
+  def each
+  end
+
+  # The {#length} method retrieves the number of layers.
+  #
+  # The {#size} method is an alias for {#length} added in SketchUp 2014.
+  #
+  # @example
+  #   layers = Sketchup.active_model.layers
+  #   number = layers.length
+  #
+  # @return integer - the number of layers in the collection
+  #
+  # @version SketchUp 6.0
+  def length
+  end
+
+  # The purged_unused method is used to remove unused layers.
+  #
+  # @example
+  #   layers = Sketchup.active_model.layers
+  #   status = layers.purge_unused
+  #
+  # @return success - true if successful, false if unsuccessful.
+  #
+  # @version SketchUp 6.0
+  def purge_unused
+  end
+
+  # Remove the given layer from the model, optionally removing the geometry.
+  #
+  # @example
+  #   # Remove layer by layer reference.
+  #   layer = Sketchup.active_model.layers.add("MyLayer")
+  #   Sketchup.active_model.layers.remove(layer)
+  #
+  #   # Remove layer by name.
+  #   Sketchup.active_model.layers.add("MyLayer")
+  #   Sketchup.active_model.layers.remove("MyLayer")
+  #
+  #   # Remove layer by index.
+  #   Sketchup.active_model.layers.remove(1)
+  #
+  #   # Remove layer and the entities on the layer.
+  #   edge = Sketchup.active_model.entities.add_line([0, 0, 0], [9, 9, 9])
+  #   edge.layer = Sketchup.active_model.layers.add("MyLayer")
+  #   Sketchup.active_model.layers.remove("MyLayer", true)
+  #
+  # @param layer
+  #   Integer index, String name or Layer
+  #
+  # @param remove_geometry
+  #   Boolean - If true, geometry in the removed layer will
+  #   be removed as well. If false (which is the default),
+  #   this geometry will be placed on Layer 0.
+  #
+  # @return boolean - true if successful, false if unsuccessful.
+  #
+  # @version SketchUp 2015
+  def remove(layer, remove_geometry = false)
+  end
+
+  # The remove_observer method is used to remove an observer from the current
+  # object.
+  #
+  # @example
+  #   layers = Sketchup.active_model.layers
+  #   status = layers.remove_observer observer
+  #
+  # @param observer
+  #   An observer.
+  #
+  # @return success - true if successful, false if unsuccessful.
+  #
+  # @version SketchUp 6.0
+  def remove_observer(observer)
+  end
+
+  # The {#length} method retrieves the number of layers.
+  #
+  # The {#size} method is an alias for {#length} added in SketchUp 2014.
+  #
+  # @example
+  #   layers = Sketchup.active_model.layers
+  #   number = layers.length
+  #
+  # @return integer - the number of layers in the collection
+  #
+  # @version SketchUp 6.0
+  def size
+  end
+
+  # The unique_name method can be used to get a string that will be a unique
+  # layer name inside this collection.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   layers = model.layers
+  #   # Will return "Joe" since there are probably no other layers named that.
+  #   # Or might return something like "Joe #2" if there is already a layer
+  #   # named Joe.
+  #   good_name = layers.unique_name "Joe"
+  #
+  # @param [optional] base_name
+  #   The base name to build the unique name from.
+  #
+  # @return name - the unique name
+  #
+  # @version SketchUp 6.0
+  def unique_name(base_name)
+  end
+
+end

data/SketchUp/Sketchup/LayersObserver.rb

@@ -0,0 +1,136 @@
+# Copyright:: Copyright 2017 Trimble Inc.
+# License:: The MIT License (MIT)
+
+# This observer interface is implemented to react to layers 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.
+#
+# @example
+#   class MyLayersObserver < Sketchup::LayersObserver
+#     def onLayerAdded(layers, layer)
+#       puts "onLayerAdded: #{layer.name}"
+#     end
+#   end
+#
+#   Sketchup.active_model.layers.add_observer(MyLayersObserver.new)
+#   Sketchup.active_model.layers.add("Hello World")
+#
+# @version SketchUp 6.0
+class Sketchup::LayersObserver
+
+  # Instance Methods
+
+  # The {#onCurrentLayerChanged} method is called when the user selects a
+  # different active layer.
+  #
+  # @example
+  #   class MyLayersObserver < Sketchup::LayersObserver
+  #     def onCurrentLayerChanged(layers, layer)
+  #       puts "onCurrentLayerChanged: #{layer.name}"
+  #     end
+  #   end
+  #
+  #   Sketchup.active_model.layers.add_observer(MyLayersObserver.new)
+  #   layer = Sketchup.active_model.layers.add("Hello World")
+  #   Sketchup.active_model.active_layer = layer
+  #
+  # @param [Sketchup::Layers] layers
+  #
+  # @param [Sketchup::Layer] layer
+  #
+  # @return [nil]
+  #
+  # @version SketchUp 6.0
+  def onCurrentLayerChanged(layers, layer)
+  end
+
+  # The {#onLayerAdded} method is called when a new layer is added to a model.
+  #
+  # @example
+  #   class MyLayersObserver < Sketchup::LayersObserver
+  #     def onLayerAdded(layers, layer)
+  #       puts "onLayerAdded: #{layer.name}"
+  #     end
+  #   end
+  #
+  #   Sketchup.active_model.layers.add_observer(MyLayersObserver.new)
+  #   Sketchup.active_model.layers.add("Hello World")
+  #
+  # @param [Sketchup::Layers] layers
+  #
+  # @param [Sketchup::Layer] layer
+  #
+  # @return [nil]
+  #
+  # @version SketchUp 6.0
+  def onLayerAdded(layers, layer)
+  end
+
+  # The {#onLayerChanged} method is called when a layer is changed.
+  #
+  # @example
+  #   def onLayerChanged(layers, layer)
+  #     puts "onLayerChanged: #{layer.name}"
+  #   end
+  #
+  #   Sketchup.active_model.layers.add_observer(MyLayersObserver.new)
+  #   layer = Sketchup.active_model.layers.add("Hello World")
+  #   layer.name = "Hello Universe"
+  #
+  # @param [Sketchup::Layers] layers
+  #
+  # @param [Sketchup::Layer] layer
+  #
+  # @return [nil]
+  #
+  # @version SketchUp 2014
+  def onLayerChanged(layers, layer)
+  end
+
+  # The {#onLayerRemoved} method is called when a layer is removed from a model.
+  #
+  # @example
+  #   class MyLayersObserver < Sketchup::LayersObserver
+  #     def onLayerRemoved(layers, layer)
+  #       puts "onLayerRemoved: #{layer.name}"
+  #     end
+  #   end
+  #
+  #   Sketchup.active_model.layers.add_observer(MyLayersObserver.new)
+  #   layer = Sketchup.active_model.layers.add("Hello World")
+  #   Sketchup.active_model.layers.remove(layer)
+  #
+  # @param [Sketchup::Layers] layers
+  #
+  # @param [Sketchup::Layer] layer
+  #
+  # @return [nil]
+  #
+  # @version SketchUp 6.0
+  def onLayerRemoved(layers, layer)
+  end
+
+  # The {#onRemoveAllLayers} method is called when all layer are removed from a
+  # model.
+  #
+  # @example
+  #   class MyLayersObserver < Sketchup::LayersObserver
+  #     def onRemoveAllLayers(layers)
+  #       puts "onRemoveAllLayers: #{layers}"
+  #     end
+  #   end
+  #
+  #   Sketchup.active_model.layers.add_observer(MyLayersObserver.new)
+  #   layer = Sketchup.active_model.layers.add("Hello World")
+  #   Sketchup.active_model.layers.remove(layer)
+  #
+  # @param [Sketchup::Layers] layers
+  #
+  # @return [nil]
+  #
+  # @version SketchUp 6.0
+  def onRemoveAllLayers(layers)
+  end
+
+end

data/SketchUp/Sketchup/Licensing.rb

@@ -0,0 +1,47 @@
+# Copyright:: Copyright 2017 Trimble Inc.
+# License:: The MIT License (MIT)
+
+# The Sketchup::Licensing module contains methods for extensions purchased
+# from Extension Warehouse to check their licensing status. It is advised
+# to place these calls inside encrypted Ruby (.rbe) files. This API is also
+# exposed via the SketchUp C API. Extensions that already use native code
+# should prefer using the native API, which should be more secure than their
+# Ruby API counterparts.
+#
+# See the {Licensing Tutorial}[../tutorial_licensing] for more details.
+#
+# @version SketchUp 2015
+module Sketchup::Licensing
+
+  # Constants
+
+  EXPIRED = nil # Stub value.
+  LICENSED = nil # Stub value.
+  NOT_LICENSED = nil # Stub value.
+  TRIAL = nil # Stub value.
+  TRIAL_EXPIRED = nil # Stub value.
+
+  # Class Methods
+
+  # Acquires a license for a given extension.
+  #
+  # @example
+  #   ext_id = "4e215280-dd23-40c4-babb-b8a8dd29d5ee"
+  #   ext_lic = Sketchup::Licensing.get_extension_license(ext_id)
+  #   if ext_lic.licensed?
+  #      puts "Extension is licensed."
+  #   end
+  #
+  # @param extension_id
+  #   String - The Extension Warehouse UUID for the extension.
+  #
+  # @return ExtensionLicense - an object representing licensing
+  #   state for the extension. Do not store this object,
+  #   retrieve it again when needed since licensing state may
+  #   have changed.
+  #
+  # @version SketchUp 2015
+  def self.get_extension_license(extension_id)
+  end
+
+end

data/SketchUp/Sketchup/Licensing/ExtensionLicense.rb

@@ -0,0 +1,88 @@
+# Copyright:: Copyright 2017 Trimble Inc.
+# License:: The MIT License (MIT)
+
+# The Sketchup::Licensing::ExtensionLicense class is used to store extension
+# license information. An instance of this class is returned by
+# Sketchup::Licensing.get_extension_license. Note that this is a temporary
+# object representing the extension licensing state for the moment it was
+# returned. It will not reflect any licensing state changes that may occur.
+#
+# @version SketchUp 2015
+class Sketchup::Licensing::ExtensionLicense
+
+  # Instance Methods
+
+  # The days_remaining method is used to get the number of days remaining until
+  # license expiration.
+  #
+  # @example
+  #   ext_id = "4e215280-dd23-40c4-babb-b8a8dd29d5ee"
+  #   ext_lic = Sketchup::Licensing.get_extension_license(ext_id)
+  #   if ext_lic.days_remaining != 0
+  #      puts "The license will expire in #{ext_lic.days_remaining} days."
+  #   end
+  #
+  # @return Integer - Number of days until license expiration. Zero
+  #   if a permanent license or not licensed.
+  #
+  # @version SketchUp 2015
+  def days_remaining
+  end
+
+  # The error_description method is used to obtain error information in case of
+  # failure to acquire a license. This is meant to aid in debugging only.
+  # Extensions should not rely on any exact error description.
+  #
+  # @example
+  #   ext_id = "4e215280-dd23-40c4-babb-b8a8dd29d5ee"
+  #   ext_lic = Sketchup::Licensing.get_extension_license(ext_id)
+  #   if !ext_lic.licensed?
+  #      puts ext_lic.error_description
+  #   end
+  #
+  # @return String - error description.
+  #
+  # @version SketchUp 2015
+  def error_description
+  end
+
+  # The licensed? method is used to decide whether the extension is licensed to
+  # run or not.
+  #
+  # @example
+  #   ext_id = "4e215280-dd23-40c4-babb-b8a8dd29d5ee"
+  #   ext_lic = Sketchup::Licensing.get_extension_license(ext_id)
+  #   if ext_lic.licensed?
+  #      puts "Extension is licensed."
+  #   end
+  #
+  # @return Boolean - true if the extension is allowed to run, false
+  #   if it is not licensed and should quit.
+  #
+  # @return [Boolean]
+  #
+  # @version SketchUp 2015
+  def licensed?
+  end
+
+  # The state method returns a constant indicating the specific licensing state.
+  # These should be used for informational purposes only and not to decide if
+  # the extension is licensed to run. For that, please use the licensed? method.
+  #
+  # @example
+  #   ext_id = "4e215280-dd23-40c4-babb-b8a8dd29d5ee"
+  #   ext_lic = Sketchup::Licensing.get_extension_license(ext_id)
+  #   if ext_lic.state == Sketchup::Licensing::TRIAL_EXPIRED
+  #      puts "Trial period has expired."
+  #   end
+  #
+  # @return Integer - One of Sketchup::Licensing::LICENSED,
+  #   Sketchup::Licensing::EXPIRED, Sketchup::Licensing::TRIAL,
+  #   Sketchup::Licensing::TRIAL_EXPIRED,
+  #   Sketchup::Licensing::NOT_LICENSED
+  #
+  # @version SketchUp 2015
+  def state
+  end
+
+end