sketchup-api-stubs 0.7.10 → 0.7.11

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The +Sketchup::Licensing+ module contains methods for
@@ -25,7 +25,14 @@ module Sketchup::Licensing
 
   # Class Methods
 
-  # Acquires a license for a given extension.
+  # Gets a license for a given extension.
+  #
+  # Starting in SketchUp 2025.0, this method automatically tries to fetch a license from Extension
+  # Warehouse if the extension doesn't have a license on the current device. This only works if the
+  # user is signed in. In earlier SketchUp versions, the user has to go to Extension Manager, expand
+  # the extension in question and press Update License if the license is missing.
+  # (For performance reasons this automatic fetching is skipped during SU startup. Make sure to do a
+  # license check when the user interacts with the extension).
   #
   # @example
   #   ext_id = "4e215280-dd23-40c4-babb-b8a8dd29d5ee"
@@ -38,7 +45,7 @@ module Sketchup::Licensing
   #   The Extension Warehouse UUID for the desired extension.
   #
   # @return [Sketchup::Licensing::ExtensionLicense] An object representing
-  #   licensing state for the extension. Do not store this object, retrieve
+  #   licensing state for the extension. Do not store this object; retrieve
   #   it again when needed since licensing state may have changed.
   #
   # @version SketchUp 2015

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # This provides a way for SketchUp to customize a line style and be set on a

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # Provides access to the different line style objects in the model.

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

@@ -0,0 +1,70 @@
+# Copyright:: Copyright 2026 Trimble Inc.
+# License:: The MIT License (MIT)
+
+# The main purpose of the +LoadHandler+ interface is to be used as an optional second parameter of
+# the {Sketchup::DefinitionList#load_from_url} method.
+#
+# Its methods that require implementation handle the process of downloading and managing the
+# state of the load operation, including progress updates and error handling.
+#
+# @abstract Implement the methods described in this class to create a tool.
+#   You can not sub-class this class because it is not defined by the API.
+#
+# @version SketchUp 6.0
+class Sketchup::LoadHandler
+
+  # Instance Methods
+
+  # This method is called when the download is canceled by the user.
+  #
+  # @example
+  #   def cancelled?
+  #     # You could, for example, show a messagebox after X seconds asking if the
+  #     # user wants to cancel the download. If this method returns true, then
+  #     # the download cancels.
+  #     return false
+  #   end
+  #
+  # @return [Boolean]
+  def cancelled?
+  end
+
+  # This method is called when the download unsuccessfully completes
+  #
+  # @example
+  #   def onFailure(message)
+  #     self.error = message
+  #     Sketchup::set_status_text('')
+  #   end
+  #
+  # @param [String] message
+  #
+  # @return [Boolean]
+  def onFailure(message)
+  end
+
+  # This method is triggered whenever the percent value updates.
+  #
+  # @example
+  #   def onPercentChange(percent)
+  #     Sketchup::set_status_text("loading: #{percent.round}%")
+  #   end
+  #
+  # @param [Float] percent
+  #
+  # @return [nil]
+  def onPercentChange(percent)
+  end
+
+  # This method is called when the download successfully completes
+  #
+  # @example
+  #   def onSuccess
+  #     Sketchup::set_status_text('')
+  #   end
+  #
+  # @return [nil]
+  def onSuccess
+  end
+
+end

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2024 Trimble Inc.
+# Copyright:: Copyright 2026 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # Loop is a low level topology class that will not need to be used often. A