sketchup-api-stubs 0.7.9 → 0.7.11

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

@@ -1,255 +1,259 @@
-# Copyright:: Copyright 2023 Trimble Inc.
-# License:: The MIT License (MIT)
-
-# The {Sketchup::ShadowInfo} class contains method to extract the shadow
-# information for a model. The majority of the shadow information returned
-# exists in the Model Info > Location and Model Info > Shadows dialogs inside
-# SketchUp.
-#
-# The following shadow information keys are maintained in SketchUp:
-#
-# - +City+ (in Model Info > Geo-location > Set Manual Location...) Note that
-#   'City' is called 'Location' in the UI
-# - +Country+ (in Model Info > Geo-location > Set Manual Location...)
-# - +Dark+ (in Window > Shadows)
-# - +DayOfYear+
-# - +DaylightSavings+
-# - +DisplayNorth+
-# - +DisplayOnAllFaces+ (in Window > Shadows)
-# - +DisplayOnGroundPlane+ (in Window > Shadows)
-# - +DisplayShadows+ (in Window > Shadows)
-# - +EdgesCastShadows+ (in Window > Shadows)
-# - +Latitude+ (in Model Info > Geo-location > Set Manual Location...)
-# - +Light+ (in Window > Shadows)
-# - +Longitude+ (in Model Info > Geo-location > Set Manual Location...)
-# - +NorthAngle+
-# - +ShadowTime+ (in Window > Shadows)
-# - +ShadowTime_time_t+ (ShadowTime in Epoch time)
-# - +SunDirection+ (Generated based on ShadowTime)
-# - +SunRise+ (Generated based on ShadowTime)
-# - +SunRise_time_t+ (SunRise in Epoch time)
-# - +SunSet+ (Generated based on ShadowTime)
-# - +SunSet_time_t+ (SunSet in Epoch time)
-# - +TZOffset+ (in Window > Shadows)
-# - +UseSunForAllShading+ (in Window > Shadows)
-#
-# You access the {Sketchup::ShadowInfo} object by calling {Sketchup::Model#shadow_info}:
-#
-# @example
-#   model = Sketchup.active_model
-#   shadowinfo = model.shadow_info
-#   puts "My city is: #{shadowinfo["City"]}"
-#
-# @version SketchUp 6.0
-class Sketchup::ShadowInfo < Sketchup::Entity
-
-  # Includes
-
-  include Enumerable
-
-  # Class Methods
-
-  # The {#each_key} method iterates through all of the shadow information keys.
-  #
-  # @example
-  #   shadowinfo.each_key { |key| puts key }
-  #
-  # @return [nil]
-  #
-  # @version SketchUp 6.0
-  #
-  # @yieldparam [String] key
-  def self.each_key
-  end
-
-  # The keys method is a class method that returns an array with all of the
-  # attribute keys
-  #
-  # @example
-  #   keys = Sketchup::ShadowInfo.keys
-  #
-  # @return [Array<String>] an array of keys
-  #
-  # @version SketchUp 6.0
-  def self.keys
-  end
-
-  # Instance Methods
-
-  # The [] method retrieves a value from the array of keys
-  #
-  # @example
-  #   value = shadowinfo["key"]
-  #
-  # @param [String] key
-  #   The key of the shadowinfo value to retrieve.
-  #
-  # @return [Object, nil] the value that is retrieved.
-  #
-  # @version SketchUp 6.0
-  def [](key)
-  end
-
-  # The set value []= method is used to set the value in the array of shadow
-  # info options.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   shadowinfo = model.shadow_info
-  #   value = shadowinfo["City"]
-  #   UI.messagebox value
-  #   value = shadowinfo["City"]="Denver, CO"
-  #   UI.messagebox value
-  #
-  # @param [String] key
-  #   The key of the shadowinfo value to set.
-  #
-  # @param [Object] value
-  #   The value to be set.
-  #
-  # @return [Object] the value that was set if successful, or false
-  #   if unsuccessful.
-  #
-  # @version SketchUp 6.0
-  def []=(key, value)
-  end
-
-  # The add_observer method is used to add an observer to the current object.
-  #
-  # @example
-  #   status = object.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 count method is inherited from the Enumerable mix-in module.
-  #
-  # @example
-  #   shadow_info = Sketchup.active_model.shadow_info
-  #   number = shadow_info.count
-  #
-  # @return [Integer]
-  #
-  # @version SketchUp 2014
-  def count
-  end
-
-  # The {#each} method iterates through all of the shadow information key/value
-  # pairs.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   shadow_info = model.shadow_info
-  #   shadow_info.each { |key, value|
-  #     puts "#{key} : #{value}"
-  #   }
-  #
-  # @return [nil]
-  #
-  # @see #each_pair
-  #
-  # @version SketchUp 6.0
-  #
-  # @yieldparam [String] key
-  #
-  # @yieldparam [Object] value
-  def each
-  end
-
-  # The {#each_key} method iterates through all of the shadow information keys.
-  #
-  # @example
-  #   shadowinfo.each_key { |key| puts key }
-  #
-  # @return [nil]
-  #
-  # @version SketchUp 6.0
-  #
-  # @yieldparam [String] key
-  def each_key
-  end
-
-  # The {#each_pair} method is an alias for {#each}.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   shadow_info = model.shadow_info
-  #   shadow_info.each_pair { |key, value|
-  #     puts "#{key} : #{value}"
-  #   }
-  #
-  # @return [nil]
-  #
-  # @see #each
-  #
-  # @version SketchUp 6.0
-  #
-  # @yieldparam [String] key
-  #
-  # @yieldparam [Object] value
-  def each_pair
-  end
-
-  # The keys method is a class method that returns an array with all of the
-  # attribute keys
-  #
-  # @example
-  #   keys = Sketchup::ShadowInfo.keys
-  #
-  # @return [Array<String>] an array of keys
-  #
-  # @version SketchUp 6.0
-  def keys
-  end
-
-  # The {#length} method returns the number of options in the shadow options
-  # collection
-  #
-  # @example
-  #   shadow_info = Sketchup.active_model.shadow_info
-  #   number = shadow_info.length
-  #
-  # @return [Integer]
-  #
-  # @see #size
-  #
-  # @version SketchUp 2014
-  def length
-  end
-
-  # The remove_observer method is used to remove an observer from the current
-  # object.
-  #
-  # @example
-  #   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 {#size} method is an alias for {#length}.
-  #
-  # @example
-  #   shadow_info = Sketchup.active_model.shadow_info
-  #   number = shadow_info.size
-  #
-  # @return [Integer]
-  #
-  # @see #length
-  #
-  # @version SketchUp 2014
-  def size
-  end
-
-end
+# Copyright:: Copyright 2026 Trimble Inc.
+# License:: The MIT License (MIT)
+
+# The {Sketchup::ShadowInfo} class contains method to extract the shadow
+# information for a model. The majority of the shadow information returned
+# exists in the Model Info > Location and Model Info > Shadows dialogs inside
+# SketchUp.
+#
+# The following shadow information keys are maintained in SketchUp:
+#
+# - +City+ (in Model Info > Geo-location > Set Manual Location...) Note that
+#   'City' is called 'Location' in the UI
+# - +Country+ (in Model Info > Geo-location > Set Manual Location...)
+# - +Dark+ (in Window > Shadows)
+# - +DayOfYear+
+# - +DaylightSavings+
+# - +DisplayNorth+
+# - +DisplayOnAllFaces+ (in Window > Shadows)
+# - +DisplayOnGroundPlane+ (in Window > Shadows)
+# - +DisplayShadows+ (in Window > Shadows)
+# - +EdgesCastShadows+ (in Window > Shadows)
+# - +Latitude+ (in Model Info > Geo-location > Set Manual Location...)
+# - +Light+ (in Window > Shadows)
+# - +Longitude+ (in Model Info > Geo-location > Set Manual Location...)
+# - +NorthAngle+
+# - +ShadowTime+ (in Window > Shadows)
+# - +ShadowTime_time_t+ (ShadowTime in Epoch time)
+# - +SunDirection+ (Generated based on ShadowTime)
+# - +SunRise+ (Generated based on ShadowTime)
+# - +SunRise_time_t+ (SunRise in Epoch time)
+# - +SunSet+ (Generated based on ShadowTime)
+# - +SunSet_time_t+ (SunSet in Epoch time)
+# - +TZOffset+ (in Window > Shadows)
+# - +UseSunForAllShading+ (in Window > Shadows)
+#
+# You access the {Sketchup::ShadowInfo} object by calling {Sketchup::Model#shadow_info}:
+#
+# @example
+#   model = Sketchup.active_model
+#   shadowinfo = model.shadow_info
+#   puts "My city is: #{shadowinfo["City"]}"
+#
+# @version SketchUp 6.0
+class Sketchup::ShadowInfo < Sketchup::Entity
+
+  # Includes
+
+  include Enumerable
+
+  # Class Methods
+
+  # The {#each_key} method iterates through all of the shadow information keys.
+  #
+  # @example
+  #   shadowinfo.each_key { |key| puts key }
+  #
+  # @return [nil]
+  #
+  # @version SketchUp 6.0
+  #
+  # @yieldparam [String] key
+  def self.each_key
+  end
+
+  # The keys method is a class method that returns an array with all of the
+  # attribute keys
+  #
+  # @example
+  #   keys = Sketchup::ShadowInfo.keys
+  #
+  # @return [Array<String>] an array of keys
+  #
+  # @version SketchUp 6.0
+  def self.keys
+  end
+
+  # Instance Methods
+
+  # The [] method retrieves a value from the array of keys
+  #
+  # @example
+  #   value = shadowinfo["key"]
+  #
+  # @param [String] key
+  #   The key of the shadowinfo value to retrieve.
+  #
+  # @return [Object, nil] the value that is retrieved.
+  #
+  # @version SketchUp 6.0
+  def [](key)
+  end
+
+  # The set value []= method is used to set the value in the array of shadow
+  # info options.
+  #
+  # For numeric properties like "Dark", "Light", "Latitude", and "Longitude",
+  # this method is flexible and accepts any +Numeric+ value (+Integer+ or +Float+).
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   shadowinfo = model.shadow_info
+  #   shadowinfo["City"]="Denver, CO"
+  #
+  # @param [String] key
+  #   The key of the shadowinfo value to set.
+  #
+  # @param [Object] value
+  #   The value to be set.
+  #
+  # @raise A KeyError is raised if the key is invalid or read-only.
+  #
+  # @raise [TypeError] if the value is not the correct type for the key.
+  #
+  # @return [Object] the value that was set if successful, or false
+  #   if unsuccessful.
+  #
+  # @version SketchUp 6.0
+  def []=(key, value)
+  end
+
+  # The add_observer method is used to add an observer to the current object.
+  #
+  # @example
+  #   status = object.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 count method is inherited from the Enumerable mix-in module.
+  #
+  # @example
+  #   shadow_info = Sketchup.active_model.shadow_info
+  #   number = shadow_info.count
+  #
+  # @return [Integer]
+  #
+  # @version SketchUp 2014
+  def count
+  end
+
+  # The {#each} method iterates through all of the shadow information key/value
+  # pairs.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   shadow_info = model.shadow_info
+  #   shadow_info.each { |key, value|
+  #     puts "#{key} : #{value}"
+  #   }
+  #
+  # @return [nil]
+  #
+  # @see #each_pair
+  #
+  # @version SketchUp 6.0
+  #
+  # @yieldparam [String] key
+  #
+  # @yieldparam [Object] value
+  def each
+  end
+
+  # The {#each_key} method iterates through all of the shadow information keys.
+  #
+  # @example
+  #   shadowinfo.each_key { |key| puts key }
+  #
+  # @return [nil]
+  #
+  # @version SketchUp 6.0
+  #
+  # @yieldparam [String] key
+  def each_key
+  end
+
+  # The {#each_pair} method is an alias for {#each}.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   shadow_info = model.shadow_info
+  #   shadow_info.each_pair { |key, value|
+  #     puts "#{key} : #{value}"
+  #   }
+  #
+  # @return [nil]
+  #
+  # @see #each
+  #
+  # @version SketchUp 6.0
+  #
+  # @yieldparam [String] key
+  #
+  # @yieldparam [Object] value
+  def each_pair
+  end
+
+  # The keys method is a class method that returns an array with all of the
+  # attribute keys
+  #
+  # @example
+  #   keys = Sketchup::ShadowInfo.keys
+  #
+  # @return [Array<String>] an array of keys
+  #
+  # @version SketchUp 6.0
+  def keys
+  end
+
+  # The {#length} method returns the number of options in the shadow options
+  # collection
+  #
+  # @example
+  #   shadow_info = Sketchup.active_model.shadow_info
+  #   number = shadow_info.length
+  #
+  # @return [Integer]
+  #
+  # @see #size
+  #
+  # @version SketchUp 2014
+  def length
+  end
+
+  # The remove_observer method is used to remove an observer from the current
+  # object.
+  #
+  # @example
+  #   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 {#size} method is an alias for {#length}.
+  #
+  # @example
+  #   shadow_info = Sketchup.active_model.shadow_info
+  #   number = shadow_info.size
+  #
+  # @return [Integer]
+  #
+  # @see #length
+  #
+  # @version SketchUp 2014
+  def size
+  end
+
+end

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

@@ -1,59 +1,59 @@
-# Copyright:: Copyright 2023 Trimble Inc.
-# License:: The MIT License (MIT)
-
-# This observer interface is implemented to react to changes to the shadow
-# settings.
-#
-# @abstract To implement this observer, create a Ruby class of this type,
-#   override the desired methods, and add an instance of the observer to the
-#   {Sketchup::ShadowInfo} object.
-#
-# @example
-#   # This is an example of an observer that watches the selection for
-#   # changes.
-#   class MyShadowInfoObserver < Sketchup::ShadowInfoObserver
-#     def onShadowInfoChanged(shadow_info, type)
-#       puts "onShadowInfoChanged: #{type}"
-#     end
-#   end
-#
-#   # Attach the observer.
-#   Sketchup.active_model.shadow_info.add_observer(MyShadowInfoObserver.new)
-#
-# @version SketchUp 6.0
-class Sketchup::ShadowInfoObserver
-
-  # Instance Methods
-
-  # The {#onShadowInfoChanged} method is invoked whenever the user alters a
-  # setting inside the Shadows and Model Info dialogs. The type parameter
-  # contains a number identifying which option was altered. Here are the types to
-  # expect:
-  #
-  # - 0 = Time/Date sliders
-  # - 1 = Display Shadows checkbox
-  # - 2 = Light/Dark sliders
-  # - 3 = Geographic Location (in Model Info > Location)
-  # - 4 = Solar Orientation (in Model Info > Location)
-  # - 7 = Use Sun for Shading checkbox
-  # - 8 = Display from Edges checkbox
-  # - 9 = Display on Ground checkbox
-  # - 10 = Display on Faces checkbox
-  #
-  # @example
-  #   def onShadowInfoChanged(shadow_info, type)
-  #     puts "onShadowInfoChanged: #{type}"
-  #   end
-  #
-  # @param [Sketchup::ShadowInfo] shadow_info
-  #
-  # @param [Integer] type
-  #   A number identifying which setting was changed.
-  #
-  # @return [nil]
-  #
-  # @version SketchUp 6.0
-  def onShadowInfoChanged(shadow_info, type)
-  end
-
-end
+# Copyright:: Copyright 2026 Trimble Inc.
+# License:: The MIT License (MIT)
+
+# This observer interface is implemented to react to changes to the shadow
+# settings.
+#
+# @abstract To implement this observer, create a Ruby class of this type,
+#   override the desired methods, and add an instance of the observer to the
+#   {Sketchup::ShadowInfo} object.
+#
+# @example
+#   # This is an example of an observer that watches the selection for
+#   # changes.
+#   class MyShadowInfoObserver < Sketchup::ShadowInfoObserver
+#     def onShadowInfoChanged(shadow_info, type)
+#       puts "onShadowInfoChanged: #{type}"
+#     end
+#   end
+#
+#   # Attach the observer.
+#   Sketchup.active_model.shadow_info.add_observer(MyShadowInfoObserver.new)
+#
+# @version SketchUp 6.0
+class Sketchup::ShadowInfoObserver
+
+  # Instance Methods
+
+  # The {#onShadowInfoChanged} method is invoked whenever the user alters a
+  # setting inside the Shadows and Model Info dialogs. The type parameter
+  # contains a number identifying which option was altered. Here are the types to
+  # expect:
+  #
+  # - 0 = Time/Date sliders
+  # - 1 = Display Shadows checkbox
+  # - 2 = Light/Dark sliders
+  # - 3 = Geographic Location (in Model Info > Location)
+  # - 4 = Solar Orientation (in Model Info > Location)
+  # - 7 = Use Sun for Shading checkbox
+  # - 8 = Display from Edges checkbox
+  # - 9 = Display on Ground checkbox
+  # - 10 = Display on Faces checkbox
+  #
+  # @example
+  #   def onShadowInfoChanged(shadow_info, type)
+  #     puts "onShadowInfoChanged: #{type}"
+  #   end
+  #
+  # @param [Sketchup::ShadowInfo] shadow_info
+  #
+  # @param [Integer] type
+  #   A number identifying which setting was changed.
+  #
+  # @return [nil]
+  #
+  # @version SketchUp 6.0
+  def onShadowInfoChanged(shadow_info, type)
+  end
+
+end