sketchup-api-stubs 0.6.1 → 0.7.4

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

@@ -1,92 +1,92 @@
-# Copyright:: Copyright 2019 Trimble Inc.
-# License:: The MIT License (MIT)
-
-# The LanguageHandler class contains methods used to help make SketchUp
-# extensions easier to localize across different languages. It looks for
-# translated resources within the Resources folder in the extension's directory
-# structure. All translated resources should be located within the appropriate
-# language folder and encoded in UTF-8. The strings file should include
-# "key"="value" string pairs in the following format:
-#
-# @example Example code that uses LanguageHandler:
-#   # Create a global language handler object
-#   swiveldriver_lang_handler = LanguageHandler.new('swiveldriver.strings')
-#
-#   # Get localized string
-#   localizedStr = swiveldriver_lang_handler.GetString('String 1')
-#
-# @example
-#   "String 1"="Localized String 1";
-#   "String 2"="Localized String 2";
-#
-# @example Here's an example extension directory structure:
-#   gocorp_swiveldriver.rb <- creates the SketchupExtension instance
-#   gocorp_swiveldriver/
-#   gocorp_swiveldriver/Resources/
-#   gocorp_swiveldriver/Resources/en/swiveldriver.strings <- OPTIONAL localization files by language code
-#   gocorp_swiveldriver/Resources/fr/swiveldriver.strings
-#   gocorp_swiveldriver/Resources/es/swiveldriver.strings
-#
-# @version SketchUp 2014
-class LanguageHandler
-
-  # Instance Methods
-
-  # Looks up and returns the localized version of a given string, based on the
-  # language SketchUp is currently running in, and the available translations
-  # in the Resources folder.
-  #
-  # @example
-  #   swiveldriver_lang_handler = LanguageHandler.new('swiveldriver.strings')
-  #   localized_string = swiveldriver_lang_handler['String 1']
-  #
-  # @param [String] key
-  #   The key for the string to be retrieved.
-  #
-  # @return [String] the localized string.
-  #
-  # @version SketchUp 2014
-  def [](key)
-  end
-
-  # The new method is used to create a new LanguageHandler object.
-  #
-  # @example
-  #   swiveldriver_lang_handler = LanguageHandler.new('swiveldriver.strings')
-  #
-  # @param [String] filename
-  #   The name of the file that contains the localized strings
-  #   with their keys in UTF-8 encoding.
-  #
-  # @return [LanguageHandler] the new LanguageHandler object
-  #
-  # @version SketchUp 2014
-  def initialize(filename)
-  end
-
-  # Returns a string containing the path to the given filename if it can be found
-  # in the Resources folder.
-  #
-  # @example
-  #   swiveldriver_lang_handler = LanguageHandler.new('swiveldriver.strings')
-  #   image = swiveldriver_lang_handler.resource_path('fancy_image.png')
-  #
-  # @return [String] the location of the file in the Resources folder.
-  #
-  # @version SketchUp 2014
-  def resource_path
-  end
-
-  # Returns a Hash object containing the localization dictionary.
-  #
-  # @example
-  #   swiveldriver_lang_handler = LanguageHandler.new('swiveldriver.strings')
-  #   hash = swiveldriver_lang_handler.strings
-  #
-  # @return [Hash] the localization dictionary.
-  #
-  # @version SketchUp 2014
-  def strings
-  end
-
-end
+# Copyright:: Copyright 2020 Trimble Inc.
+# License:: The MIT License (MIT)
+
+# The LanguageHandler class contains methods used to help make SketchUp
+# extensions easier to localize across different languages. It looks for
+# translated resources within the Resources folder in the extension's directory
+# structure. All translated resources should be located within the appropriate
+# language folder and encoded in UTF-8. The strings file should include
+# "key"="value" string pairs in the following format:
+#
+# @example Example code that uses LanguageHandler:
+#   # Create a global language handler object
+#   swiveldriver_lang_handler = LanguageHandler.new('swiveldriver.strings')
+#
+#   # Get localized string
+#   localizedStr = swiveldriver_lang_handler.GetString('String 1')
+#
+# @example
+#   "String 1"="Localized String 1";
+#   "String 2"="Localized String 2";
+#
+# @example Here's an example extension directory structure:
+#   gocorp_swiveldriver.rb <- creates the SketchupExtension instance
+#   gocorp_swiveldriver/
+#   gocorp_swiveldriver/Resources/
+#   gocorp_swiveldriver/Resources/en/swiveldriver.strings <- OPTIONAL localization files by language code
+#   gocorp_swiveldriver/Resources/fr/swiveldriver.strings
+#   gocorp_swiveldriver/Resources/es/swiveldriver.strings
+#
+# @version SketchUp 2014
+class LanguageHandler
+
+  # Instance Methods
+
+  # Looks up and returns the localized version of a given string, based on the
+  # language SketchUp is currently running in, and the available translations
+  # in the Resources folder.
+  #
+  # @example
+  #   swiveldriver_lang_handler = LanguageHandler.new('swiveldriver.strings')
+  #   localized_string = swiveldriver_lang_handler['String 1']
+  #
+  # @param [String] key
+  #   The key for the string to be retrieved.
+  #
+  # @return [String] the localized string.
+  #
+  # @version SketchUp 2014
+  def [](key)
+  end
+
+  # The new method is used to create a new LanguageHandler object.
+  #
+  # @example
+  #   swiveldriver_lang_handler = LanguageHandler.new('swiveldriver.strings')
+  #
+  # @param [String] filename
+  #   The name of the file that contains the localized strings
+  #   with their keys in UTF-8 encoding.
+  #
+  # @return [LanguageHandler] the new LanguageHandler object
+  #
+  # @version SketchUp 2014
+  def initialize(filename)
+  end
+
+  # Returns a string containing the path to the given filename if it can be found
+  # in the Resources folder.
+  #
+  # @example
+  #   swiveldriver_lang_handler = LanguageHandler.new('swiveldriver.strings')
+  #   image = swiveldriver_lang_handler.resource_path('fancy_image.png')
+  #
+  # @return [String] the location of the file in the Resources folder.
+  #
+  # @version SketchUp 2014
+  def resource_path
+  end
+
+  # Returns a Hash object containing the localization dictionary.
+  #
+  # @example
+  #   swiveldriver_lang_handler = LanguageHandler.new('swiveldriver.strings')
+  #   hash = swiveldriver_lang_handler.strings
+  #
+  # @return [Hash] the localization dictionary.
+  #
+  # @version SketchUp 2014
+  def strings
+  end
+
+end

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

@@ -1,262 +1,278 @@
-# Copyright:: Copyright 2019 Trimble Inc.
-# License:: The MIT License (MIT)
-
-# Because length units are used so often in SketchUp, a special class has been
-# added to make it easier to work with length values. You can use a Length
-# object any place that you would use a Float.
-#
-# Internally, all lengths in SketchUp are stored in inches. The Length class
-# stores values in inches as well. A number of methods have been added to the
-# Ruby Numeric class to do units conversions.
-#
-# The setting for the Length Format and Length Unit can be retrieved from the
-# {Sketchup::Model#options} by querying the +"UnitsOptions"+
-# {Sketchup::OptionsProvider} for +"LengthFormat"+ and +"LengthUnit"+
-# respectively.
-#
-# *Constants:*
-#
-# [Length Format]
-#   - +Length::Decimal+
-#   - +Length::Architectural+
-#   - +Length::Engineering+
-#   - +Length::Fractional+
-#
-# [Length Unit]
-#   - +Length::Inches+
-#   - +Length::Feet+
-#   - +Length::Millimeter+
-#   - +Length::Centimeter+
-#   - +Length::Meter+
-#
-# [Area Unit]
-#   (Added in SketchUp 2019.1)
-#   - +Length::SquareInches+
-#   - +Length::SquareFeet+
-#   - +Length::SquareMillimeter+
-#   - +Length::SquareCentimeter+
-#   - +Length::SquareMeter+
-#
-# [Volume Unit]
-#   (Added in SketchUp 2019.1)
-#   - +Length::CubicInches+
-#   - +Length::CubicFeet+
-#   - +Length::CubicMillimeter+
-#   - +Length::CubicCentimeter+
-#   - +Length::CubicMeter+
-#
-# @note Prior to SketchUp 2015, +Length+ used to be derived from +Float+. This
-#   is no longer the case.
-#
-# @version SketchUp 6.0
-class Length < Float
-
-  # Constants
-
-  Architectural = nil # Stub value.
-
-  Centimeter = nil # Stub value.
-
-  CubicCentimeter = nil # Stub value.
-  CubicFeet = nil # Stub value.
-  CubicInches = nil # Stub value.
-  CubicMeter = nil # Stub value.
-  CubicMillimeter = nil # Stub value.
-
-  Decimal = nil # Stub value.
-
-  Engineering = nil # Stub value.
-
-  Fractional = nil # Stub value.
-
-  Feet = nil # Stub value.
-
-  Inches = nil # Stub value.
-
-  Millimeter = nil # Stub value.
-
-  Meter = nil # Stub value.
-
-  SquareCentimeter = nil # Stub value.
-  SquareFeet = nil # Stub value.
-  SquareInches = nil # Stub value.
-  SquareMeter = nil # Stub value.
-  SquareMillimeter = nil # Stub value.
-
-  # Instance Methods
-
-  # The < method is used to see if one length is less than another length.
-  #
-  # For example, if l1 = 1.0.inch and l2 = 1.000001.inch then l1 == l2 so l1
-  # < l2 should return false.
-  #
-  # @example
-  #   length1 = 12.to_l
-  #   length2 = 11.to_l
-  #   if length1 < length2
-  #     puts "length1 is less than length2"
-  #   else
-  #     puts "length1 is not less than length2"
-  #   end
-  #
-  # @param [Length] length2
-  #   A length value.
-  #
-  # @return [Boolean] true if length1 is < length2; false if
-  #   length1 is not < length2
-  #
-  # @version SketchUp 6.0
-  def <(length2)
-  end
-
-  # The <= method is used to see if one length is less than or equal to
-  # another length.
-  #
-  # @example
-  #   length1 = 11.to_l
-  #   length2 = 12.to_l
-  #   if length1 <= length2
-  #     puts "length1 is less than or equal length2"
-  #   else
-  #     puts "length1 is greater than length2"
-  #   end
-  #
-  # @param [Length] length2
-  #   A length value.
-  #
-  # @return [Boolean] true if length1 is <= length2; false if
-  #   length1 is not <= length2
-  #
-  # @version SketchUp 6.0
-  def <=(length2)
-  end
-
-  # The <=> method is used to see if one length is less than equal or greater
-  # than another length. Because we change == for Length to do a test based on
-  # a tolerance, we also need to change <=> to also take tolerance into account.
-  #
-  # @example
-  #   length1 = 20.to_l
-  #   length2 = 30.to_l
-  #   result = length1 <=> length2
-  #
-  # @param [Length] length2
-  #   A length value.
-  #
-  # @return [Integer] the result of the comparison
-  #
-  # @version SketchUp 6.0
-  def <=>(length2)
-  end
-
-  # The == method is used to see if one length is equal to another length.
-  #
-  # The equality comparison on Length values uses the default tolerance that
-  # SketchUp uses for comparing lengths.
-  #
-  # @example
-  #   length1 = 20.to_l
-  #   length2 = 30.to_l
-  #   is_equal = length1 == length2
-  #
-  # @param [Length] length2
-  #   A length value.
-  #
-  # @return [Boolean] true if length1 is == length2; false if
-  #   length1 is not == length2
-  #
-  # @version SketchUp 6.0
-  def ==(length2)
-  end
-
-  # The > method is used to see if one length is greater than another length.
-  #
-  # For example, if l1 = 1.0.inch and l2 = 1.000001.inch then l1 == l2 so l1 >
-  # l2 should return false.
-  #
-  # @example
-  #   length1 = 11.to_l
-  #   length2 = 12.to_l
-  #   if length1 > length2
-  #     puts "length1 is greater than length2"
-  #   else
-  #     puts "length1 is not greater than length2"
-  #   end
-  #
-  # @param [Length] length2
-  #   A length value.
-  #
-  # @return [Boolean] true if length1 is > length2; false if length1
-  #   is not > length2
-  #
-  # @version SketchUp 6.0
-  def >(length2)
-  end
-
-  # The >= method is used to see if one length is greater than or equal to
-  # another length.
-  #
-  # For example, if l1 = 1.0.inch and l2 = 1.000001.inch then l1 == l2 so l1 >=
-  # l2 should return true. Also L1 <= l2 would return true.
-  #
-  # @example
-  #   length1 = 11.to_l
-  #   length2 = 12.to_l
-  #   if length1 >= length2
-  #     puts "length1 is greater than or equal length2"
-  #   else
-  #     puts "length1 is less than length2"
-  #   end
-  #
-  # @param [Length] length2
-  #   A length value.
-  #
-  # @return [Boolean] true if length1 is >= length2; false if
-  #   length1 is not >= length2
-  #
-  # @version SketchUp 6.0
-  def >=(length2)
-  end
-
-  # The inspect method is used to retrieve an unformatted string for the length,
-  # which is the length in inches, regardless of the user's model unit settings.
-  # See Length.to_s for a way automatically format your Length to the user's
-  # model units.
-  #
-  # @example
-  #   length = 55.to_l
-  #   str = length.inspect
-  #
-  # @return [String] an unformatted length string
-  #
-  # @version SketchUp 6.0
-  def inspect
-  end
-
-  # The to_f method is used to convert a length to a normal float.
-  #
-  # @example
-  #   length = 45.to_l
-  #   f = length.to_f
-  #
-  # @return [Float] the float length value
-  #
-  # @version SketchUp 6.0
-  def to_f
-  end
-
-  # Format a length as a String using the current units formatting settings
-  # for the model. (So if the user's model is set to feet, this method will
-  # return a nicely formatted length in feet.)
-  #
-  # @example
-  #   length = 55.to_l
-  #   str = length.to_s
-  #
-  # @return [String] the float length value
-  #
-  # @version SketchUp 6.0
-  def to_s
-  end
-
-end
+# Copyright:: Copyright 2020 Trimble Inc.
+# License:: The MIT License (MIT)
+
+# Because length units are used so often in SketchUp, a special class has been
+# added to make it easier to work with length values. You can use a Length
+# object any place that you would use a Float.
+#
+# Internally, all lengths in SketchUp are stored in inches. The Length class
+# stores values in inches as well. A number of methods have been added to the
+# Ruby Numeric class to do units conversions.
+#
+# The setting for the Length Format and Length Unit can be retrieved from the
+# {Sketchup::Model#options} by querying the +"UnitsOptions"+
+# {Sketchup::OptionsProvider} for +"LengthFormat"+ and +"LengthUnit"+
+# respectively.
+#
+# *Constants:*
+#
+# [Length Format]
+#   - +Length::Decimal+
+#   - +Length::Architectural+
+#   - +Length::Engineering+
+#   - +Length::Fractional+
+#
+# [Length Unit]
+#   - +Length::Inches+
+#   - +Length::Feet+
+#   - +Length::Millimeter+
+#   - +Length::Centimeter+
+#   - +Length::Meter+
+#   (Added in SketchUp 2020.0)
+#   - +Length::Yard+
+#
+# [Area Unit]
+#   (Added in SketchUp 2019.2)
+#   - +Length::SquareInches+
+#   - +Length::SquareFeet+
+#   - +Length::SquareMillimeter+
+#   - +Length::SquareCentimeter+
+#   - +Length::SquareMeter+
+#   (Added in SketchUp 2020.0)
+#   - +Length::SquareYard+
+#
+# [Volume Unit]
+#   (Added in SketchUp 2019.2)
+#   - +Length::CubicInches+
+#   - +Length::CubicFeet+
+#   - +Length::CubicMillimeter+
+#   - +Length::CubicCentimeter+
+#   - +Length::CubicMeter+
+#   (Added in SketchUp 2020.0)
+#   - +Length::CubicYard+
+#   - +Length::Liter+
+#   - +Length::USGallon+
+#
+# @note Prior to SketchUp 2015, +Length+ used to be derived from +Float+. This
+#   is no longer the case.
+#
+# @version SketchUp 6.0
+class Length < Float
+
+  # Constants
+
+  Architectural = nil # Stub value.
+
+  Centimeter = nil # Stub value.
+
+  CubicCentimeter = nil # Stub value.
+  CubicFeet = nil # Stub value.
+  CubicInches = nil # Stub value.
+  CubicMeter = nil # Stub value.
+  CubicMillimeter = nil # Stub value.
+  CubicYard = nil # Stub value.
+
+  Decimal = nil # Stub value.
+
+  Engineering = nil # Stub value.
+
+  Fractional = nil # Stub value.
+
+  Feet = nil # Stub value.
+
+  Inches = nil # Stub value.
+
+  Liter = nil # Stub value.
+
+  Millimeter = nil # Stub value.
+
+  Meter = nil # Stub value.
+
+  SquareCentimeter = nil # Stub value.
+  SquareFeet = nil # Stub value.
+  SquareInches = nil # Stub value.
+  SquareMeter = nil # Stub value.
+  SquareMillimeter = nil # Stub value.
+  SquareYard = nil # Stub value.
+
+  USGallon = nil # Stub value.
+
+  Yard = nil # Stub value.
+
+  # Instance Methods
+
+  # The < method is used to see if one length is less than another length.
+  #
+  # For example, if l1 = 1.0.inch and l2 = 1.000001.inch then l1 == l2 so l1
+  # < l2 should return false.
+  #
+  # @example
+  #   length1 = 12.to_l
+  #   length2 = 11.to_l
+  #   if length1 < length2
+  #     puts "length1 is less than length2"
+  #   else
+  #     puts "length1 is not less than length2"
+  #   end
+  #
+  # @param [Length] length2
+  #   A length value.
+  #
+  # @return [Boolean] true if length1 is < length2; false if
+  #   length1 is not < length2
+  #
+  # @version SketchUp 6.0
+  def <(length2)
+  end
+
+  # The <= method is used to see if one length is less than or equal to
+  # another length.
+  #
+  # @example
+  #   length1 = 11.to_l
+  #   length2 = 12.to_l
+  #   if length1 <= length2
+  #     puts "length1 is less than or equal length2"
+  #   else
+  #     puts "length1 is greater than length2"
+  #   end
+  #
+  # @param [Length] length2
+  #   A length value.
+  #
+  # @return [Boolean] true if length1 is <= length2; false if
+  #   length1 is not <= length2
+  #
+  # @version SketchUp 6.0
+  def <=(length2)
+  end
+
+  # The <=> method is used to see if one length is less than equal or greater
+  # than another length. Because we change == for Length to do a test based on
+  # a tolerance, we also need to change <=> to also take tolerance into account.
+  #
+  # @example
+  #   length1 = 20.to_l
+  #   length2 = 30.to_l
+  #   result = length1 <=> length2
+  #
+  # @param [Length] length2
+  #   A length value.
+  #
+  # @return [Integer] the result of the comparison
+  #
+  # @version SketchUp 6.0
+  def <=>(length2)
+  end
+
+  # The == method is used to see if one length is equal to another length.
+  #
+  # The equality comparison on Length values uses the default tolerance that
+  # SketchUp uses for comparing lengths.
+  #
+  # @example
+  #   length1 = 20.to_l
+  #   length2 = 30.to_l
+  #   is_equal = length1 == length2
+  #
+  # @param [Length] length2
+  #   A length value.
+  #
+  # @return [Boolean] true if length1 is == length2; false if
+  #   length1 is not == length2
+  #
+  # @version SketchUp 6.0
+  def ==(length2)
+  end
+
+  # The > method is used to see if one length is greater than another length.
+  #
+  # For example, if l1 = 1.0.inch and l2 = 1.000001.inch then l1 == l2 so l1 >
+  # l2 should return false.
+  #
+  # @example
+  #   length1 = 11.to_l
+  #   length2 = 12.to_l
+  #   if length1 > length2
+  #     puts "length1 is greater than length2"
+  #   else
+  #     puts "length1 is not greater than length2"
+  #   end
+  #
+  # @param [Length] length2
+  #   A length value.
+  #
+  # @return [Boolean] true if length1 is > length2; false if length1
+  #   is not > length2
+  #
+  # @version SketchUp 6.0
+  def >(length2)
+  end
+
+  # The >= method is used to see if one length is greater than or equal to
+  # another length.
+  #
+  # For example, if l1 = 1.0.inch and l2 = 1.000001.inch then l1 == l2 so l1 >=
+  # l2 should return true. Also L1 <= l2 would return true.
+  #
+  # @example
+  #   length1 = 11.to_l
+  #   length2 = 12.to_l
+  #   if length1 >= length2
+  #     puts "length1 is greater than or equal length2"
+  #   else
+  #     puts "length1 is less than length2"
+  #   end
+  #
+  # @param [Length] length2
+  #   A length value.
+  #
+  # @return [Boolean] true if length1 is >= length2; false if
+  #   length1 is not >= length2
+  #
+  # @version SketchUp 6.0
+  def >=(length2)
+  end
+
+  # The inspect method is used to retrieve an unformatted string for the length,
+  # which is the length in inches, regardless of the user's model unit settings.
+  # See Length.to_s for a way automatically format your Length to the user's
+  # model units.
+  #
+  # @example
+  #   length = 55.to_l
+  #   str = length.inspect
+  #
+  # @return [String] an unformatted length string
+  #
+  # @version SketchUp 6.0
+  def inspect
+  end
+
+  # The to_f method is used to convert a length to a normal float.
+  #
+  # @example
+  #   length = 45.to_l
+  #   f = length.to_f
+  #
+  # @return [Float] the float length value
+  #
+  # @version SketchUp 6.0
+  def to_f
+  end
+
+  # Format a length as a String using the current units formatting settings
+  # for the model. (So if the user's model is set to feet, this method will
+  # return a nicely formatted length in feet.)
+  #
+  # @example
+  #   length = 55.to_l
+  #   str = length.to_s
+  #
+  # @return [String] the float length value
+  #
+  # @version SketchUp 6.0
+  def to_s
+  end
+
+end