sketchup-api-stubs 0.7.8 → 0.7.10

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2022 Trimble Inc.
+# Copyright:: Copyright 2024 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # A Vertex. A Vertex represents the end of an Edge or a point inside a Face.

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2022 Trimble Inc.
+# Copyright:: Copyright 2024 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # This class contains methods to manipulate the current point of view of the
@@ -31,24 +31,16 @@ class Sketchup::View
   def add_observer(observer)
   end
 
-  # The animation= method is used to set an animation that is displayed for a
-  # view. See Animation for details on how to create an animation object.
+  # The {#animation=} method is used to set an animation that is displayed for a
+  # view. See {Sketchup::Animation} for details on how to create an animation object.
   #
   # @example
   #   animation = ViewSpinner.new
   #   model = Sketchup.active_model
   #   view = model.active_view
-  #   anim = view.animation=animation
-  #   if (anim)
-  #     UI.messagebox anim
-  #   else
-  #     UI.messagebox "Failure"
-  #   end
+  #   anim = view.animation = animation
   #
   # @param [#nextFrame] animation
-  #   An Animation object.
-  #
-  # @return [#nextFrame] the newly set Animation object
   #
   # @version SketchUp 6.0
   def animation=(animation)
@@ -635,6 +627,24 @@ class Sketchup::View
   def field_of_view=(fov)
   end
 
+  # The {#graphics_engine} method is used query the type of the graphics engine that's currently
+  # used by this view.
+  #
+  # @example
+  #   engine = Sketchup.active_model.active_view.graphics_engine
+  #   if engine == :graphics_engine_classic
+  #     puts 'Classic graphics engine'
+  #   elsif engine == :graphics_engine_2024
+  #     puts 'New graphics engine'
+  #   end
+  #
+  # @return [Symbol] Type of the graphics engine.
+  #   +:graphics_engine_classic+ or +:graphics_engine_2024+
+  #
+  # @version SketchUp 2024.0
+  def graphics_engine
+  end
+
   # The guess_target method is used to guess at what the user is looking at when
   # you have a perspective view.
   #
@@ -787,20 +797,22 @@ class Sketchup::View
   #   end
   #   Sketchup.active_model.select_tool(Example::MyTool.new)
   #
-  # @note To conserve resources on the user's machine, textures can be loaded
-  #   only when there is a Ruby tool on the tool stack. Make sure to release the
-  #   texture when it's no longer needed. Any textures not already released
-  #   when the last Ruby tool on the tool stack is removed will be automatically
-  #   released by SketchUp.
-  #
   # @note Avoid loading and releasing textures within the {Sketchup::Tool#draw}
   #   event as that is not efficient.
   #
+  # @note SketchUp 2020.0-2022.0: To conserve resources on the user's machine,
+  #   textures can be loaded only when there is a Ruby tool on the tool stack.
+  #   Make sure to release the texture when it's no longer needed. Any textures
+  #   not already released when the last Ruby tool on the tool stack is removed
+  #   will be automatically released by SketchUp. As of SketchUp 2023.0 this
+  #   automatic cleanup was removed to allow Overlays to draw textures.
+  #
   # @param [Sketchup::ImageRep] image_rep
   #
   # @raise [ArgumentError] if the provided {Sketchup::ImageRep} is not valid.
   #
   # @raise [RuntimeError] if a Ruby tool was not on the tool stack.
+  #   (Applies to SketchUp 2020.0-2022.0).
   #
   # @return [Integer] A resource ID referring to the image loaded.
   #

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2022 Trimble Inc.
+# Copyright:: Copyright 2024 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # This observer interface is implemented to react to view events.

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2022 Trimble Inc.
+# Copyright:: Copyright 2024 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Sketchup module contains a number of important utility methods for use in
@@ -651,8 +651,9 @@ module Sketchup
   #
   #   @version SketchUp 2021.0
   #   @param [String] filename  The model file to open.
-  #   @return [Integer, false]  status code if opening the file succeeded,
-  #     +false+ otherwise.
+  #   @param [Boolean] with_status
+  #   @return [Integer, false]  status code if opening with +with_status+ set to +true+,
+  #     otherwise +true+ or +false+.
   #
   # @version SketchUp 6.0
   def self.open_file(*args)
@@ -885,6 +886,49 @@ module Sketchup
   def self.require(path)
   end
 
+  # The {.resize_viewport} method changes the pixel size of the viewport and SketchUp window.
+  # This can be useful for producing a consistent behavior in automatic testing,
+  # regardless of the display resolution.
+  #
+  # @bug In SketchUp 2023.1 this method didn't behave correctly on Windows. No known workarounds.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   Sketchup.resize_viewport(model, 800, 600)
+  #
+  # @note In SketchUp 2024.0 and later this method doesn't behave correctly in all cases on Windows.
+  #   The passed values are internally converted to logical pixels, rounded and converted back to
+  #   physical pixels. This means certain sizes, such as 1000 px at 150% scaling, cannot be
+  #   accurately set.
+  #
+  #   As a workaround in you can use sizes that are evenly divisible with common scale factors,
+  #   if you depend on pixel perfect sizes.
+  #
+  #     # Changes by 1 px  :(
+  #     ((1000/1.5).round * 1.5).round # => 1001
+  #     # Survives the round-trip :)
+  #     ((1500/1.5).round * 1.5).round # => 1500
+  #     ((1500/1.25).round * 1.25).round # => 1500
+  #
+  # @param [Sketchup::Model] model
+  #
+  # @param [Integer] width
+  #   Width in physical pixels
+  #
+  # @param [Integer] height
+  #   Height in physical pixels
+  #
+  # @return [Boolean] +true+ on success. +false+ if the window couldn't reach the desired size,
+  #   e.g. because it wouldn't fit the screen.
+  #
+  # @see Sketchup::View#vpwidth
+  #
+  # @see Sketchup::View#vpheight
+  #
+  # @version SketchUp 2023.0
+  def self.resize_viewport(model, width, height)
+  end
+
   # The save_thumbnail method is used to generate a thumbnail for any SKP file -
   # not necessarily the loaded model.
   #
@@ -1011,20 +1055,10 @@ module Sketchup
   # - 10533: display the Shadows Settings dialog box
   # - 10537: toggle the Views toolbar
   # - 10538: display the System Preferences dialog box (Display tab)
-  # - 10545: toggle Color ByLayer
+  # - 10545: toggle Shadows
   # - 10546: toggle Shadows toolbar
   # - 10551: toogle Large icons
   # - 10576: toggle Render Mode toolbar
-  # - 10596: set Render Mode to No Transparency (Preferences)
-  # - 10597: set Render Mode to Wire (Preferences)
-  # - 10598: set Render Mode to Transparency (Preferences)
-  # - 10599: set Render Mode to Surfaces Shading (Preferences)
-  # - 10600: set Render Mode to Texture (Preferences)
-  # - 10601: set Render Mode to No Texture (Preferences)
-  # - 10602: toggle Shadows
-  # - 10603: toggle Profiles
-  # - 10604: toggle Extension Lines
-  # - 10605: toggle Jitter edges
   # - 21019: hide Status bar and VCB
   # - 21020: show Status bar and VCB
   # - 21022: hide Status bar and VCB

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2022 Trimble Inc.
+# Copyright:: Copyright 2024 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The SketchupExtension class contains methods allowing you to create and
@@ -204,7 +204,7 @@ class SketchupExtension
   #   The relative path to the script that loads your
   #   plugin.
   #
-  # @return [Sketchup::Extension] the new Extension object
+  # @return [SketchupExtension]
   #
   # @version SketchUp 6.0
   def initialize(title, path)

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2022 Trimble Inc.
+# Copyright:: Copyright 2024 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The String class contains a method used to parse a string as a length value.

data/lib/sketchup-api-stubs/stubs/UI/Command.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2022 Trimble Inc.
+# Copyright:: Copyright 2024 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Command class is the preferred class for adding tools to the menus and
@@ -35,36 +35,6 @@
 # @version SketchUp 6.0
 class UI::Command
 
-  # Class Methods
-
-  # The new method is used to create a new command.
-  #
-  # @example
-  #   UI.menu("Draw").add_separator
-  #
-  #   # Adds a Test submenu to the Draw menu where the Tester menu item appears
-  #   testmenu = UI.menu("Draw").add_submenu("Test")
-  #
-  #   # This menu item simply displays Hello World on the screen when clicked.
-  #   cmd = UI::Command.new("Tester") { UI.messagebox("Hello World") }
-  #   testmenu.add_item cmd
-  #
-  # @note Prior to SketchUp 2019 it was not possible to sub-class {UI::Command}
-  #   due to a bug in how SketchUp initialized the class.
-  #
-  # @param [String] menutext
-  #   The text that will appear for this command's menu item
-  #   if it appears on a menu.
-  #
-  # @return [UI::Command] the new Command object
-  #
-  # @version SketchUp 6.0
-  #
-  # @yield Code that executes the command when the menu item or
-  #   toolbar item is selected.
-  def self.new(menutext)
-  end
-
   # Instance Methods
 
   # The {#extension} method returns the command's associated extension.
@@ -119,6 +89,34 @@ class UI::Command
   def get_validation_proc
   end
 
+  # The new method is used to create a new command.
+  #
+  # @example
+  #   UI.menu("Draw").add_separator
+  #
+  #   # Adds a Test submenu to the Draw menu where the Tester menu item appears
+  #   testmenu = UI.menu("Draw").add_submenu("Test")
+  #
+  #   # This menu item simply displays Hello World on the screen when clicked.
+  #   cmd = UI::Command.new("Tester") { UI.messagebox("Hello World") }
+  #   testmenu.add_item cmd
+  #
+  # @note Prior to SketchUp 2019 it was not possible to sub-class {UI::Command}
+  #   due to a bug in how SketchUp initialized the class.
+  #
+  # @param [String] menutext
+  #   The text that will appear for this command's menu item
+  #   if it appears on a menu.
+  #
+  # @return [UI::Command] the new Command object
+  #
+  # @version SketchUp 6.0
+  #
+  # @yield Code that executes the command when the menu item or
+  #   toolbar item is selected.
+  def initialize(menutext)
+  end
+
   # The large_icon method returns the icon file for the command's
   # large icon.
   #

data/lib/sketchup-api-stubs/stubs/UI/HtmlDialog.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2022 Trimble Inc.
+# Copyright:: Copyright 2024 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Ruby HtmlDialog class allows you to create and interact with HTML dialog
@@ -21,6 +21,8 @@
 #
 # HtmlDialog uses the following versions of CEF (Chromium Embedded Framework):
 #
+# [SketchUp 2024.0]
+#   CEF 112
 # [SketchUp 2021.1]
 #   CEF 88
 # [SketchUp 2019.0]
@@ -30,6 +32,10 @@
 # [SketchUp 2017.0]
 #   CEF 52
 #
+# @note The window size is not guaranteed to be pixel perfect in all SketchUp
+#   versions and operating systems. Prefer responsive designs that can take
+#   up some fluctuations in size.
+#
 # @version SketchUp 2017
 class UI::HtmlDialog
 
@@ -77,20 +83,18 @@ class UI::HtmlDialog
   #   cleared. Re-attach them if you need to open the dialog again.
   #
   # @param [String] callback_name
-  #   The name of the callback method to be
-  #   invoked from the html dialog.
+  #   The name of the callback method to be invoked from the html dialog.
   #
-  # @return [Boolean] true if action added successfully, false
-  #   otherwise.
+  # @return [Boolean] +true+ if action added successfully, +false+ otherwise.
   #
   # @version SketchUp 2017
   #
-  # @yield [action_context, ...]
+  # @yield [action_context, *args]
   #
   # @yieldparam [Object] action_context
-  #   action_context  Currently unused.
+  #   Currently unused.
   #
-  # @yieldparam [Object] ...
+  # @yieldparam [Array<Object>] args
   #   The parameters sent from JavaScript.
   def add_action_callback(callback_name)
   end
@@ -231,6 +235,11 @@ class UI::HtmlDialog
   #   HtmlDialog were not persisted when SketchUp was closed without first
   #   closing the HtmlDialog window.
   #
+  # @bug SketchUp 2023.0 introduced a bug where the position given in {#initialize}
+  #   is set relative to the SketchUp main window. If you rely on the position to be
+  #   absolute to the screen then you can use {#set_position} after creating the
+  #   dialog.
+  #
   # @example With options Hash
   #   dialog = UI::HtmlDialog.new(
   #   {
@@ -311,7 +320,7 @@ class UI::HtmlDialog
   #   A hash containing the initial properties of
   #   the newly created dialog.
   #
-  # @return [HtmlDialog]
+  # @return [UI::HtmlDialog]
   #
   # @version SketchUp 2017
   def initialize(properties)

data/lib/sketchup-api-stubs/stubs/UI/Notification.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2022 Trimble Inc.
+# Copyright:: Copyright 2024 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # {UI::Notification} objects allows you to show native notifications in the
@@ -176,7 +176,7 @@ class UI::Notification
   # @param [String] title
   #   Sets the title of the button.
   #
-  # @param [Block] block
+  # @param [Proc] block
   #   Sets the action callback, this will be called when
   #   the user clicks on the dismiss button.
   #
@@ -222,7 +222,7 @@ class UI::Notification
   # @param [String] title
   #   Sets the title of the button.
   #
-  # @param [Block] block
+  # @param [Proc] block
   #   Sets the action callback, this will be called when
   #   the user clicks on the dismiss button.
   #

data/lib/sketchup-api-stubs/stubs/UI/Toolbar.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2022 Trimble Inc.
+# Copyright:: Copyright 2024 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Toolbar class contains methods to create and manipulate SketchUp
@@ -84,7 +84,7 @@ class UI::Toolbar
   def count
   end
 
-  # The each method is used to iterate through all of the commands
+  # The {#each} method is used to iterate through all of the commands
   # attached to a toolbar.
   #
   # @example
@@ -104,8 +104,9 @@ class UI::Toolbar
   #
   # @version SketchUp 8.0 M1
   #
-  # @yield [key, value] Variables that will hold each key and value as they are
-  #   found.
+  # @yieldparam [UI::Command, String] command
+  #   For separators a string +"|"+ is
+  #   yielded.
   def each
   end
 

data/lib/sketchup-api-stubs/stubs/UI/WebDialog.rb

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2022 Trimble Inc.
+# Copyright:: Copyright 2024 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Ruby WebDialog class allows you to create and interact with DHTML dialog
@@ -177,22 +177,6 @@ class UI::WebDialog
 
   # The +new+ method is used to create a new webdialog.
   #
-  # 250, left = 0, top = 0, resizable = true)
-  #   @param [String] dialog_title   The title to be displayed in the webdialog.
-  #   @param [Boolean] scrollable    true if you want to allow scrollbars, false
-  #                                  if you do not want to allow scrollbars.
-  #   @param [String, nil] pref_key  The registry entry where the location and
-  #                                  size of the dialog will be saved.
-  #                                  If preferences_key is not included, the
-  #                                  location and size will not be stored.
-  #   @param [Integer] width         The width of the webdialog.
-  #   @param [Integer] height        The height of the webdialog.
-  #   @param [Integer] left          The number of pixels from the left.
-  #   @param [Integer] top           The number of pixels from the top.
-  #   @param [Integer] resizable     true if you want the webdialog to be resizable,
-  #                                  false if not.
-  #   @return [UI::WebDialog]
-  #
   # @example
   #   dlg = UI::WebDialog.new("Show sketchup.com", true,
   #     "ShowSketchupDotCom", 739, 641, 150, 150, true);
@@ -207,8 +191,22 @@ class UI::WebDialog
   #   user's OS. On Mac, Safari is embedded, while on the PC whatever version of
   #   Internet Explorer is installed will be embedded.
   #
-  # @overload initialize(dialog_title = "", scrollable = true, pref_key = nil, width = 250, height =
+  # @overload initialize(dialog_title = "", scrollable = true, pref_key = nil, width = 250, height = 250, left = 0, top = 0, resizable = true)
   #
+  #   @param [String] dialog_title   The title to be displayed in the webdialog.
+  #   @param [Boolean] scrollable    true if you want to allow scrollbars, false
+  #                                  if you do not want to allow scrollbars.
+  #   @param [String, nil] pref_key  The registry entry where the location and
+  #                                  size of the dialog will be saved.
+  #                                  If preferences_key is not included, the
+  #                                  location and size will not be stored.
+  #   @param [Integer] width         The width of the webdialog.
+  #   @param [Integer] height        The height of the webdialog.
+  #   @param [Integer] left          The number of pixels from the left.
+  #   @param [Integer] top           The number of pixels from the top.
+  #   @param [Integer] resizable     true if you want the webdialog to be resizable,
+  #                                  false if not.
+  #   @return [UI::WebDialog]
   #
   # @overload initialize(properties)
   #

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2022 Trimble Inc.
+# Copyright:: Copyright 2024 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The UI module contains a number of methods for creating simple UI elements
@@ -52,23 +52,43 @@ module UI
   def self.beep
   end
 
-  # The create_cursor method is used to create a cursor from an image file at
+  # The {.create_cursor} method is used to create a cursor from an image file at
   # the specified location. This must be called from within a custom
-  # Tool. See the Tool class for a complete example.
+  # tool. See the {Sketchup::Tool} documentation for a complete example.
   #
-  # Since SketchUp 2016 it is possible to provide vector images for the cursors.
-  # SVG format for Windows and PDF format for OS X.
+  # The size of the cursor images should be 32x32 pixels.
+  #
+  # The coordinates for the cursor's hotspot is based from it's top left corner.
+  # For example, a value of (hot_x, hot_y) = (5, 10) would identify the hotpoint
+  # of the cursor at 6 pixels from the left edge of your cursor image and 11
+  # pixels from the top edge of your cursor image.
+  #
+  # @bug On macOS raster cursors are always displayed at 24x24.
+  #
+  # @bug In SketchUp 2023.1 on Mac provided an incorrect hotspot location. The hotspot was scaled by
+  #   a factor of 32.0/24.0. If a hotspot position was greater than 24, the cursor would not display.
   #
   # @example
-  #   cursor_id = nil
-  #   cursor_path = Sketchup.find_support_file("Pointer.png", "Plugins/")
-  #   if cursor_path
-  #     cursor_id = UI.create_cursor(cursor_path, 0, 0)
+  #   class ExampleTool
+  #     def initialize
+  #       @cursor_id = nil
+  #       # Load vector cursor format depending on platform.
+  #       ext = Sketchup.platform == :platform_win ? 'svg' : 'pdf'
+  #       cursor_path = File.join(__dir__, "cursor.#{ext}")
+  #       @cursor_id = UI.create_cursor(cursor_path, 4, 6)
+  #     end
+  #
+  #     def onSetCursor
+  #       UI.set_cursor(@cursor_id)
+  #     end
   #   end
   #
-  #   def onSetCursor
-  #     UI.set_cursor(cursor_id)
-  #   end
+  # @note Since SketchUp 2016 it is possible to provide vector images for the cursors.
+  #   SVG format for Windows and PDF format for macOS. This is the recommended format
+  #   to use since it will scale well with different DPI scaling.
+  #
+  # @note Because the image is never released, avoid creating new cursors for the same image for any
+  #   given tool. Cache it and reuse it.
   #
   # @param [String] path
   #   File path to an image.
@@ -80,17 +100,29 @@ module UI
   # @param [Integer] hot_y
   #   A y coordinate that is the "hotpoint" for the cursor
   #   computed from the top edge of the of your cursor image.
-  #   For example, a value of (hot_x, hot_y) = (5,10) would
-  #   identify the hotpoint of the cursor at 5 pixels from
-  #   the left edge of your cursor image and 10 pixels from
-  #   the top edge of your cursor image.
   #
-  # @return [Integer] ID associated with the cursor
+  # @return [Integer] Id associated with the cursor.
+  #   Use this with {UI.set_cursor} in {Sketchup::Tool#onSetCursor}.
+  #
+  # @see UI.set_cursor
+  #
+  # @see Sketchup::Tool#onSetCursor
   #
   # @version SketchUp 6.0
   def self.create_cursor(path, hot_x, hot_y)
   end
 
+  # Returns the plain text available on the clipboard, if there is any.
+  #
+  # @example
+  #   text = UI.get_clipboard_data
+  #
+  # @return [String, nil]
+  #
+  # @version SketchUp 2023.1
+  def self.get_clipboard_data
+  end
+
   # Creates a dialog box for inputting user information. The dialog box contains
   # input fields with static text prompts, optional default values, optional
   # drop down selections, and optional title.
@@ -166,8 +198,11 @@ module UI
   # is the first step toward adding your own custom items to the bottom
   # of SketchUp's menus.
   #
-  # Valid menu names are: "File", "Edit", "View", "Camera", "Draw", "Tools",
-  # "Window", "Extensions", "Help" and "Developer".
+  # Valid menu names are: +'File'+, +'Edit'+, +'View'+, +'Camera'+, +'Draw'+,
+  # +'Tools'+, +'Window'+, +'Extensions'+, +'Help'+ and +'Developer'+.
+  #
+  # @bug In versions prior to SketchUp 2018 this would crash if you passed an
+  #   empty string.
   #
   # @example
   #   tool_menu = UI.menu("Tools")
@@ -175,19 +210,18 @@ module UI
   #     UI.messagebox("Cheese activated.")
   #   }
   #
-  # @note The "Extensions" menu was named "Plugins" prior to SketchUp 2015.
-  #   For backward compatibility "Plugins" still works.
+  # @note The +'Extensions'+ menu was named +'Plugins'+ prior to SketchUp 2015.
+  #   For backward compatibility +'Plugins'+ still works.
   #
-  # @note In versions prior to SketchUp 2018 this would crash if you passed an
-  #   empty string.
+  # @note +'Developer'+ menu was added with SketchUp 2021.1.
   #
-  # @param menu_name
-  #   The name of an existing top level menu.
+  # @param [String] menu_name
+  #   The name of a supported menu.
   #
   # @return [Sketchup::Menu]
   #
   # @version SketchUp 6.0
-  def self.menu(menu_name = "Plugins")
+  def self.menu(menu_name = "Extensions")
   end
 
   # Creates a dialog box containing static text with a series of buttons for
@@ -480,6 +514,17 @@ module UI
   def self.select_directory(options = {})
   end
 
+  # Copies plain text to the clipboard.
+  #
+  # @example
+  #   UI.set_clipboard_data('Hello World')
+  #
+  # @return [Boolean]
+  #
+  # @version SketchUp 2023.1
+  def self.set_clipboard_data(data)
+  end
+
   # The {.set_cursor} method is used to change the cursor to a new cursor with a
   # given cursor id. See UI.create_cursor and the Tool class for details
   # on creating your own tools with arbitrary cursors.

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2022 Trimble Inc.
+# Copyright:: Copyright 2024 Trimble Inc.
 # License:: The MIT License (MIT)
 
 
@@ -205,14 +205,6 @@
 
   # Instance Methods
 
-  # This function will add a separator to a given menu the first
-  # time it is called.  It is useful for adding a separator before
-  # the first plugin that is added to a given menu.
-  #
-  # @deprecated Avoid adding separators to top level menus. If you require
-  #   grouping use a sub-menu instead.
-  #
-  # @param [String] menu_name
   #
   # @version SketchUp 6.0
   def add_separator_to_menu(menu_name)