sketchup-api-stubs 0.7.9 → 0.7.11

data/lib/sketchup-api-stubs/stubs/SketchupExtension.rb

@@ -1,353 +1,353 @@
-# Copyright:: Copyright 2023 Trimble Inc.
-# License:: The MIT License (MIT)
-
-# The SketchupExtension class contains methods allowing you to create and
-# manipulate SketchUp extensions. Extensions are Ruby scripts that can be
-# loaded and unloaded using the Extension manager (Extensions panel of the
-# Preferences dialog box). Generally you should register your ruby scripts as
-# an extension to give SketchUp users the ability to disable it through the
-# user interface.
-#
-# The idea here is to take the ruby script that actually creates your
-# functionality and place it in a folder somewhere outside of the /Plugins
-# folder, most commonly a subdirectory like /Plugins/MyExtension. Then
-# you create a new ruby script inside the /Plugins directory that will
-# set up the extension entry and load your original script if the user
-# has your extension turned on.
-#
-# Here is an example extension loading script. For this example, the
-# following code would be saved in /Plugins/StairTools.rb, and the
-# actual plugin itself would live in /Plugins/StairTools/core.rb.
-#
-# You can find two example extensions that ship with SketchUp,
-# su_dynamiccomponents.rb and su_sandboxtools.rb, under the /Plugins/ folder.
-#
-# @example
-#   # Create an entry in the Extension list that loads a script called
-#   # core.rb.
-#   require 'sketchup.rb'
-#   require 'extensions.rb'
-#
-#   stair_extension = SketchupExtension.new('Stair Tools", "StairTools/core.rb')
-#   stair_extension.version = '1.0'
-#   stair_extension.description = 'Tools to draw stairs automatically.'
-#   Sketchup.register_extension(stair_extension, true)
-#
-# @version SketchUp 6.0
-class SketchupExtension
-
-  # Instance Methods
-
-  # Loads the extension, meaning the underlying ruby script is immediately
-  # interpreted. This is the equivalent of checking the extension's checkbox
-  # in the Preferences > Extensions list.
-  #
-  # @example
-  #   # This will register the extension, a necessary step for it to appear
-  #   # in SketchUp's Preferences > Extensions list
-  #   ext_c = SketchupExtension.new('Stair Tools C', 'StairTools/core.rb')
-  #   Sketchup.register_extension(ext_c, false)
-  #
-  #   # And this will load the extension.
-  #   ext_c.check
-  #
-  # @return [Boolean] whether the load succeeded
-  #
-  # @version SketchUp 8.0 M2
-  def check
-  end
-
-  # The copyright method returns the copyright string which appears beneath
-  # an extension inside the Extensions Manager dialog.
-  #
-  # @example
-  #   # Create an entry in the Extension list that loads a script called
-  #   # core.rb.
-  #   extension = SketchupExtension.new('Stair Tools', 'StairTools/core.rb')
-  #   extension.copyright = '2008'
-  #   copyright = extension.copyright
-  #
-  # @return [String] the Extension copyright
-  #
-  # @version SketchUp 6.0
-  def copyright
-  end
-
-  # The copyright= method sets the copyright string which appears beneath
-  # an extension inside the Extensions Manager dialog.
-  #
-  # @example
-  #   # Create an entry in the Extension list that loads a script called
-  #   # core.rb.
-  #   extension = SketchupExtension.new('Stair Tools', 'StairTools/core.rb')
-  #   extension.copyright = '2008'
-  #   copyright = extension.copyright
-  #
-  # @param [String] copyright
-  #   The copyright to set
-  #
-  # @return [String] the new copyright
-  #
-  # @version SketchUp 6.0
-  def copyright=(copyright)
-  end
-
-  # The creator method returns the creator string which appears beneath
-  # an extension inside the Extensions Manager dialog.
-  #
-  # @example
-  #   # Create an entry in the Extension list that loads a script called
-  #   # core.rb.
-  #   extension = SketchupExtension.new('Stair Tools', 'StairTools/core.rb')
-  #   extension.creator = 'Trimble Navigation, Inc.'
-  #   creator = extension.creator
-  #
-  # @return [String] the Extension creator
-  #
-  # @version SketchUp 6.0
-  def creator
-  end
-
-  # The creator= method sets the creator string which appears beneath
-  # an extension inside the Extensions Manager dialog.
-  #
-  # @example
-  #   # Create an entry in the Extension list that loads a script called
-  #   # core.rb.
-  #   extension = SketchupExtension.new('Stair Tools', 'StairTools/core.rb')
-  #   extension.creator = 'Trimble Navigation, Inc.'
-  #   creator = extension.creator
-  #
-  # @param [String] creator
-  #   The creator to set
-  #
-  # @return [String] the new creator
-  #
-  # @version SketchUp 6.0
-  def creator=(creator)
-  end
-
-  # The description method returns the long description which appears beneath
-  # an extension inside the Extensions Manager dialog.
-  #
-  # @example
-  #   # Create an entry in the Extension list that loads a script called
-  #   # core.rb.
-  #   extension = SketchupExtension.new('Stair Tools', 'StairTools/core.rb')
-  #   extension.description = 'My description.'
-  #   description = extension.description
-  #
-  # @return [String] the Extension description
-  #
-  # @version SketchUp 6.0
-  def description
-  end
-
-  # The description= method sets the long description which appears beneath
-  # an extension inside the Extensions Manager dialog.
-  #
-  # @example
-  #   # Create an entry in the Extension list that loads a script called
-  #   # core.rb.
-  #   extension = SketchupExtension.new('Stair Tools', 'StairTools/core.rb')
-  #   extension.description = 'My description.'
-  #   description = extension.description
-  #
-  # @param [String] description
-  #   The description string to set.
-  #
-  # @return [String] the Extension description
-  #
-  # @version SketchUp 6.0
-  def description=(description)
-  end
-
-  # The extension_path method returns the file system path to the extension's
-  # outer rb file.
-  #
-  # @return [String] the file system path to the extension
-  #
-  # @version SketchUp 2013
-  def extension_path
-  end
-
-  # The id method returns the Extension Warehouse ID string.
-  #
-  # @return [String] the Extension Warehouse ID
-  #
-  # @version SketchUp 2013
-  def id
-  end
-
-  # The new method is used to create a new SketchupExtension object. Note
-  # that once the extension object is created, it will not appear in the
-  # Extension Manager dialog until your register it with the
-  # Sketchup.register_extension method.
-  #
-  # @example
-  #   # Create an entry in the Extension list that loads a script called
-  #   # core.rb.
-  #   extension = SketchupExtension.new('Stair Tools', 'StairTools/core')
-  #
-  #   # Then be sure to register it. By passing a 2nd param of true, you're
-  #   # telling SketchUp to load the extension by default.
-  #   Sketchup.register_extension(extension, true)
-  #
-  # @note It is recommended to omit the file extension provided in the +path+
-  #   argument. SketchUp will resolve the file extension to +.rbe+, +.rbs+
-  #   or +.rb+.
-  #
-  # @param [String] title
-  #   The name of the extension
-  #
-  # @param [String] path
-  #   The relative path to the script that loads your
-  #   plugin.
-  #
-  # @return [SketchupExtension]
-  #
-  # @version SketchUp 6.0
-  def initialize(title, path)
-  end
-
-  # Returns whether the extension is set to load when SketchUp starts up.
-  #
-  # @example
-  #   ext = SketchupExtension.new('Stair Tools', 'StairTools/core.rb')
-  #   UI.messagebox("load_on_start? is false: #{ext.load_on_start?.to_s}")
-  #   Sketchup.register_extension(ext, true)
-  #   UI.messagebox("load_on_start? is now true: #{ext.load_on_start?.to_s}")
-  #
-  # @return [Boolean]
-  #
-  # @version SketchUp 8.0 M2
-  def load_on_start?
-  end
-
-  # Returns whether the extension is currently loaded, meaning the actual ruby
-  # script that implements the extension has been evaluated.
-  #
-  # @example
-  #   ext = SketchupExtension.new('Stair Tools', 'StairTools/core.rb')
-  #   UI.messagebox("loaded? is false: #{ext.loaded?.to_s}")
-  #   Sketchup.register_extension(ext, true)
-  #   UI.messagebox("loaded? is now true: #{ext.loaded?.to_s}")
-  #
-  # @return [Boolean]
-  #
-  # @version SketchUp 8.0 M2
-  def loaded?
-  end
-
-  # The name method returns the name which appears for
-  # an extension inside the Extensions Manager dialog.
-  #
-  # @example
-  #   # Create an entry in the Extension list that loads a script called
-  #   # core.rb.
-  #   extension = SketchupExtension.new('Stair Tools', 'StairTools/core.rb')
-  #   name = extension.name
-  #
-  # @return [String] the Extension name
-  #
-  # @version SketchUp 6.0
-  def name
-  end
-
-  # The name= method sets the name which appears for
-  # an extension inside the Extensions Manager dialog.
-  #
-  # @example
-  #   # Create an entry in the Extension list that loads a script called
-  #   # core.rb.
-  #   extension = SketchupExtension.new('Stair Tools', 'StairTools/core.rb')
-  #   extension.name = 'Renamed Stair Tools'
-  #
-  # @param [String] name
-  #   The new name
-  #
-  # @return [String] the Extension name
-  #
-  # @version SketchUp 6.0
-  def name=(name)
-  end
-
-  # Returns whether the extension has been registered via
-  # Sketchup.register_extension.
-  #
-  # @example
-  #   ext = SketchupExtension.new('Stair Tools', 'StairTools/core.rb')
-  #   UI.messagebox("My registered? is false: #{ext.registered?.to_s}")
-  #   Sketchup.register_extension(ext, true)
-  #   UI.messagebox("Now registered? is now true: #{ext.registered?.to_s}")
-  #
-  # @return [Boolean]
-  #
-  # @version SketchUp 8.0 M2
-  def registered?
-  end
-
-  # Unloads the extension. This is the equivalent of unchecking the extension's
-  # checkbox in the Preferences > Extensions list.
-  #
-  # Note that technically the extension is not "unloaded" in the sense that it
-  # stops running during the current SketchUp session, but the next time the
-  # user restarts SketchUp, the extension will not be active.
-  #
-  # @example
-  #   # This unloads all extensions. The next time SketchUp starts, none of
-  #   # the extensions will be active.
-  #   Sketchup.extensions.each { |extension|
-  #     extension.uncheck
-  #   }
-  #
-  # @return [Boolean] whether the unload succeeded
-  #
-  # @version SketchUp 8.0 M2
-  def uncheck
-  end
-
-  # The version method returns the version which appears beneath
-  # an extension inside the Extensions Manager dialog.
-  #
-  # @example
-  #   # Create an entry in the Extension list that loads a script called
-  #   # core.rb.
-  #   extension = SketchupExtension.new('Stair Tools', 'StairTools/core.rb')
-  #   extension.version = '5.0'
-  #   version = extension.version
-  #
-  # @return [String] the Extension version
-  #
-  # @version SketchUp 6.0
-  def version
-  end
-
-  # The version method sets the version which appears beneath
-  # an extension inside the Extensions Manager dialog.
-  #
-  # @example
-  #   # Create an entry in the Extension list that loads a script called
-  #   # core.rb.
-  #   extension = SketchupExtension.new('Stair Tools', 'StairTools/core.rb')
-  #   extension.version = '5.0'
-  #   version = extension.version
-  #
-  # @param [String] version
-  #   The version string to set.
-  #
-  # @return [String] the Extension version
-  #
-  # @version SketchUp 6.0
-  def version=(version)
-  end
-
-  # The version_id method returns the Extension Warehouse Version ID string.
-  #
-  # @return [String] the Extension Warehouse Version ID string
-  #
-  # @version SketchUp 2013
-  def version_id
-  end
-
-end
+# Copyright:: Copyright 2026 Trimble Inc.
+# License:: The MIT License (MIT)
+
+# The SketchupExtension class contains methods allowing you to create and
+# manipulate SketchUp extensions. Extensions are Ruby scripts that can be
+# loaded and unloaded using the Extension manager (Extensions panel of the
+# Extension Manager dialog box). Generally you should register your ruby scripts as
+# an extension to give SketchUp users the ability to disable it through the
+# user interface.
+#
+# The idea here is to take the ruby script that actually creates your
+# functionality and place it in a folder somewhere outside of the /Plugins
+# folder, most commonly a subdirectory like /Plugins/MyExtension. Then
+# you create a new ruby script inside the /Plugins directory that will
+# set up the extension entry and load your original script if the user
+# has your extension turned on.
+#
+# Here is an example extension loading script. For this example, the
+# following code would be saved in /Plugins/StairTools.rb, and the
+# actual plugin itself would live in /Plugins/StairTools/core.rb.
+#
+# You can find two example extensions that ship with SketchUp,
+# su_dynamiccomponents.rb and su_sandboxtools.rb, under the /Plugins/ folder.
+#
+# @example
+#   # Create an entry in the Extension list that loads a script called
+#   # core.rb.
+#   require 'sketchup.rb'
+#   require 'extensions.rb'
+#
+#   stair_extension = SketchupExtension.new('Stair Tools", "StairTools/core.rb')
+#   stair_extension.version = '1.0'
+#   stair_extension.description = 'Tools to draw stairs automatically.'
+#   Sketchup.register_extension(stair_extension, true)
+#
+# @version SketchUp 6.0
+class SketchupExtension
+
+  # Instance Methods
+
+  # Loads the extension, meaning the underlying ruby script is immediately
+  # interpreted. This is the equivalent of checking the extension's checkbox
+  # in the Extension Manager.
+  #
+  # @example
+  #   # This will register the extension, a necessary step for it to appear
+  #   # in SketchUp's Extension Manager > Extensions list
+  #   ext_c = SketchupExtension.new('Stair Tools C', 'StairTools/core.rb')
+  #   Sketchup.register_extension(ext_c, false)
+  #
+  #   # And this will load the extension.
+  #   ext_c.check
+  #
+  # @return [Boolean] whether the load succeeded
+  #
+  # @version SketchUp 8.0 M2
+  def check
+  end
+
+  # The copyright method returns the copyright string which appears beneath
+  # an extension inside the Extensions Manager dialog.
+  #
+  # @example
+  #   # Create an entry in the Extension list that loads a script called
+  #   # core.rb.
+  #   extension = SketchupExtension.new('Stair Tools', 'StairTools/core.rb')
+  #   extension.copyright = '2008'
+  #   copyright = extension.copyright
+  #
+  # @return [String] the Extension copyright
+  #
+  # @version SketchUp 6.0
+  def copyright
+  end
+
+  # The copyright= method sets the copyright string which appears beneath
+  # an extension inside the Extensions Manager dialog.
+  #
+  # @example
+  #   # Create an entry in the Extension list that loads a script called
+  #   # core.rb.
+  #   extension = SketchupExtension.new('Stair Tools', 'StairTools/core.rb')
+  #   extension.copyright = '2008'
+  #   copyright = extension.copyright
+  #
+  # @param [String] copyright
+  #   The copyright to set
+  #
+  # @return [String] the new copyright
+  #
+  # @version SketchUp 6.0
+  def copyright=(copyright)
+  end
+
+  # The creator method returns the creator string which appears beneath
+  # an extension inside the Extensions Manager dialog.
+  #
+  # @example
+  #   # Create an entry in the Extension list that loads a script called
+  #   # core.rb.
+  #   extension = SketchupExtension.new('Stair Tools', 'StairTools/core.rb')
+  #   extension.creator = 'Trimble Navigation, Inc.'
+  #   creator = extension.creator
+  #
+  # @return [String] the Extension creator
+  #
+  # @version SketchUp 6.0
+  def creator
+  end
+
+  # The creator= method sets the creator string which appears beneath
+  # an extension inside the Extensions Manager dialog.
+  #
+  # @example
+  #   # Create an entry in the Extension list that loads a script called
+  #   # core.rb.
+  #   extension = SketchupExtension.new('Stair Tools', 'StairTools/core.rb')
+  #   extension.creator = 'Trimble Navigation, Inc.'
+  #   creator = extension.creator
+  #
+  # @param [String] creator
+  #   The creator to set
+  #
+  # @return [String] the new creator
+  #
+  # @version SketchUp 6.0
+  def creator=(creator)
+  end
+
+  # The description method returns the long description which appears beneath
+  # an extension inside the Extensions Manager dialog.
+  #
+  # @example
+  #   # Create an entry in the Extension list that loads a script called
+  #   # core.rb.
+  #   extension = SketchupExtension.new('Stair Tools', 'StairTools/core.rb')
+  #   extension.description = 'My description.'
+  #   description = extension.description
+  #
+  # @return [String] the Extension description
+  #
+  # @version SketchUp 6.0
+  def description
+  end
+
+  # The description= method sets the long description which appears beneath
+  # an extension inside the Extensions Manager dialog.
+  #
+  # @example
+  #   # Create an entry in the Extension list that loads a script called
+  #   # core.rb.
+  #   extension = SketchupExtension.new('Stair Tools', 'StairTools/core.rb')
+  #   extension.description = 'My description.'
+  #   description = extension.description
+  #
+  # @param [String] description
+  #   The description string to set.
+  #
+  # @return [String] the Extension description
+  #
+  # @version SketchUp 6.0
+  def description=(description)
+  end
+
+  # The extension_path method returns the file system path to the extension's
+  # outer rb file.
+  #
+  # @return [String] the file system path to the extension
+  #
+  # @version SketchUp 2013
+  def extension_path
+  end
+
+  # The id method returns the Extension Warehouse ID string.
+  #
+  # @return [String] the Extension Warehouse ID
+  #
+  # @version SketchUp 2013
+  def id
+  end
+
+  # The new method is used to create a new SketchupExtension object. Note
+  # that once the extension object is created, it will not appear in the
+  # Extension Manager dialog until your register it with the
+  # Sketchup.register_extension method.
+  #
+  # @example
+  #   # Create an entry in the Extension list that loads a script called
+  #   # core.rb.
+  #   extension = SketchupExtension.new('Stair Tools', 'StairTools/core')
+  #
+  #   # Then be sure to register it. By passing a 2nd param of true, you're
+  #   # telling SketchUp to load the extension by default.
+  #   Sketchup.register_extension(extension, true)
+  #
+  # @note It is recommended to omit the file extension provided in the +path+
+  #   argument. SketchUp will resolve the file extension to +.rbe+, +.rbs+
+  #   or +.rb+.
+  #
+  # @param [String] title
+  #   The name of the extension
+  #
+  # @param [String] path
+  #   The relative path to the script that loads your
+  #   plugin.
+  #
+  # @return [SketchupExtension]
+  #
+  # @version SketchUp 6.0
+  def initialize(title, path)
+  end
+
+  # Returns whether the extension is set to load when SketchUp starts up.
+  #
+  # @example
+  #   ext = SketchupExtension.new('Stair Tools', 'StairTools/core.rb')
+  #   puts "load_on_start? is false: #{ext.load_on_start?.to_s}"
+  #   Sketchup.register_extension(ext, true)
+  #   puts "load_on_start? is now true: #{ext.load_on_start?.to_s}"
+  #
+  # @return [Boolean]
+  #
+  # @version SketchUp 8.0 M2
+  def load_on_start?
+  end
+
+  # Returns whether the extension is currently loaded, meaning the actual ruby
+  # script that implements the extension has been evaluated.
+  #
+  # @example
+  #   ext = SketchupExtension.new('Stair Tools', 'StairTools/core.rb')
+  #   puts "loaded? is false: #{ext.loaded?.to_s}"
+  #   Sketchup.register_extension(ext, true)
+  #   puts "loaded? is now true: #{ext.loaded?.to_s}"
+  #
+  # @return [Boolean]
+  #
+  # @version SketchUp 8.0 M2
+  def loaded?
+  end
+
+  # The name method returns the name which appears for
+  # an extension inside the Extensions Manager dialog.
+  #
+  # @example
+  #   # Create an entry in the Extension list that loads a script called
+  #   # core.rb.
+  #   extension = SketchupExtension.new('Stair Tools', 'StairTools/core.rb')
+  #   name = extension.name
+  #
+  # @return [String] the Extension name
+  #
+  # @version SketchUp 6.0
+  def name
+  end
+
+  # The name= method sets the name which appears for
+  # an extension inside the Extensions Manager dialog.
+  #
+  # @example
+  #   # Create an entry in the Extension list that loads a script called
+  #   # core.rb.
+  #   extension = SketchupExtension.new('Stair Tools', 'StairTools/core.rb')
+  #   extension.name = 'Renamed Stair Tools'
+  #
+  # @param [String] name
+  #   The new name
+  #
+  # @return [String] the Extension name
+  #
+  # @version SketchUp 6.0
+  def name=(name)
+  end
+
+  # Returns whether the extension has been registered via
+  # Sketchup.register_extension.
+  #
+  # @example
+  #   ext = SketchupExtension.new('Stair Tools', 'StairTools/core.rb')
+  #   puts "My registered? is false: #{ext.registered?.to_s}"
+  #   Sketchup.register_extension(ext, true)
+  #   puts "Now registered? is now true: #{ext.registered?.to_s}"
+  #
+  # @return [Boolean]
+  #
+  # @version SketchUp 8.0 M2
+  def registered?
+  end
+
+  # Unloads the extension. This is the equivalent of unchecking the extension's
+  # checkbox in the Extension Manager > Extensions list.
+  #
+  # Note that technically the extension is not "unloaded" in the sense that it
+  # stops running during the current SketchUp session, but the next time the
+  # user restarts SketchUp, the extension will not be active.
+  #
+  # @example
+  #   # This unloads all extensions. The next time SketchUp starts, none of
+  #   # the extensions will be active.
+  #   Sketchup.extensions.each { |extension|
+  #     extension.uncheck
+  #   }
+  #
+  # @return [Boolean] whether the unload succeeded
+  #
+  # @version SketchUp 8.0 M2
+  def uncheck
+  end
+
+  # The version method returns the version which appears beneath
+  # an extension inside the Extensions Manager dialog.
+  #
+  # @example
+  #   # Create an entry in the Extension list that loads a script called
+  #   # core.rb.
+  #   extension = SketchupExtension.new('Stair Tools', 'StairTools/core.rb')
+  #   extension.version = '5.0'
+  #   version = extension.version
+  #
+  # @return [String] the Extension version
+  #
+  # @version SketchUp 6.0
+  def version
+  end
+
+  # The version method sets the version which appears beneath
+  # an extension inside the Extensions Manager dialog.
+  #
+  # @example
+  #   # Create an entry in the Extension list that loads a script called
+  #   # core.rb.
+  #   extension = SketchupExtension.new('Stair Tools', 'StairTools/core.rb')
+  #   extension.version = '5.0'
+  #   version = extension.version
+  #
+  # @param [String] version
+  #   The version string to set.
+  #
+  # @return [String] the Extension version
+  #
+  # @version SketchUp 6.0
+  def version=(version)
+  end
+
+  # The version_id method returns the Extension Warehouse Version ID string.
+  #
+  # @return [String] the Extension Warehouse Version ID string
+  #
+  # @version SketchUp 2013
+  def version_id
+  end
+
+end