sketchup-api-stubs 0.6.1 → 0.7.0

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The ClassificationSchema class represent schemas loaded in the model.

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Classifications class is a container/manager for all classifications in

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Color class is used to create and manipulate colors within SketchUp

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The {Sketchup::ComponentDefinition} class is used to define the contents for
@@ -293,6 +293,10 @@ class Sketchup::ComponentDefinition < Sketchup::Drawingelement
   # The insertion_point method is used to retrieve the Point3d object where the
   # component was inserted.
   #
+  # @deprecated SketchUp 2020.0 removed the insertion point feature.
+  #   The getter will always return the origin point and the
+  #   setter becomes a no-op.
+  #
   # @example
   #   point = Geom::Point3d.new 10,20,30
   #   transform = Geom::Transformation.new point
@@ -314,6 +318,10 @@ class Sketchup::ComponentDefinition < Sketchup::Drawingelement
 
   # Sets the insertion point of your definition.
   #
+  # @deprecated SketchUp 2020.0 removed the insertion point feature.
+  #   The getter will always return the origin point and the
+  #   setter becomes a no-op.
+  #
   # @example
   #   point = Geom::Point3d.new(10, 20, 0)
   #   componentdefinition = Sketchup.active_model.definitions[0]

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The {Sketchup::ComponentInstance} class is used to represent component

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Console class is used by SketchUp to direct $stdout and $stderr to the

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The ConstructionLine class contains methods for modifying construction

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # A construction point represents a point in the model that can be used to aid

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Curve class is used by SketchUp to unite a series of Edge objects into

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # A DefinitionList object holds a list of all of the ComponentDefinition

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # This observer interface is implemented to react to component definition

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # This observer interface is implemented to react to events on a definitions

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Dimension class provides base functionality for classes DimensionLinear

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The DimensionLinear class represents linear dimensions.

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # This observer interface is implemented to react to changes in dimension text.

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The DimensionRadial class represents radius and diameter dimensions on

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # Drawingelement is a base class for an item in the model that can be

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Edge class contains methods modifying and extracting information for

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The EdgeUse class defines how an Edge is used in the definition of a Face.

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Entities class is a container class for all entities in a model (it is a

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # This observer interface is implemented to react to {Sketchup::Entities}

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # This is the base class for all SketchUp entities. Entities are basically
@@ -344,6 +344,9 @@ class Sketchup::Entity
   #
   # The persistent id persistent between sessions.
   #
+  # [SketchUp 2020.0]
+  #   - {Sketchup::Layer}
+  #   - {Sketchup::LineStyle}
   # [SketchUp 2018]
   #   - {Sketchup::Page}
   # [SketchUp 2017]

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # This observer interface is implemented to react to entity events. To

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The ExtensionsManager class provides a way of accessing the

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # Faces in SketchUp are flat, 2-sided polygons with 3 or more sides.

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # This observer interface is implemented to react to changes in camera

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # A Group class contains methods for manipulating groups of entities.

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The {Sketchup::Http} module provides interfaces to create asynchronous HTTP

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # Http::Request objects allows you to send HTTP request to HTTP servers.

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # Http::Response objects allows you to get the response information from the

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # An Image object represents a raster image placed in the Model.

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # References an image representation object.

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Importer interface lets you build your own importers for SketchUp. To

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The InputPoint used to pick entities that reside under the current cursor

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # This observer interface is implemented to react to component instance

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The {Sketchup::InstancePath} class represent the instance path to a given

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Layer class contains methods modifying and extracting information for a
@@ -103,6 +103,26 @@ class Sketchup::Layer < Sketchup::Entity
   def color=(color)
   end
 
+  # The {#display_name} method is used to retrieve the display name of the layer.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   layers = model.layers
+  #   new_layer = layers.add ("test layer")
+  #   name = new_layer.display_name
+  #
+  # @return [String] the display name of the Layer object
+  #
+  # @see #name
+  #
+  # @version SketchUp 2020.0
+  def display_name
+  end
+
+  # Layer Group methods
+  def layer_group
+  end
+
   # The {#line_style} method retrieves the line style on this layer.
   #
   # @example
@@ -129,7 +149,7 @@ class Sketchup::Layer < Sketchup::Entity
   def line_style=(line_style)
   end
 
-  # The name method is used to retrieve the name of the layer.
+  # The {#name} method is used to retrieve the name of the layer.
   #
   # @example
   #   model = Sketchup.active_model
@@ -137,7 +157,9 @@ class Sketchup::Layer < Sketchup::Entity
   #   new_layer = layers.add "test layer"
   #   name = new_layer.name
   #
-  # @return name - the name of the Layer object
+  # @return [String]
+  #
+  # @see #display_name
   #
   # @version SketchUp 6.0
   def name

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Layers collection allows you to see and manage all of the layers in a

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # This observer interface is implemented to react to layers events. To

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The +Sketchup::Licensing+ module contains methods for

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Sketchup::Licensing::ExtensionLicense class is used to store extension

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 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 2019 Trimble Inc.
+# Copyright:: Copyright 2020 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/Loop.rb

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

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Material class represents a texture or color that can be applied to

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # A collection of Materials objects. Each model contains a Materials collection

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # This observer interface is implemented to react to materials events. To

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # An interface to a menu.

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2019 Trimble Inc.
+# Copyright:: Copyright 2020 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # This is the interface to a SketchUp model. The model is the 3D drawing that
@@ -14,6 +14,9 @@
 # - Model::MakeTrial
 # - Model::MakeTrialExpired
 #
+# @bug Prior to SketchUp 2019.0 this class would yield +TypeError+ for all
+#   method calls if +#singleton_class+ was called on the model object.
+#
 # @example
 #   # Grab a handle to the currently active model (aka the one the user is
 #   # looking at in SketchUp.)
@@ -36,9 +39,6 @@
 #
 #   new_edge = entities.add_line([0,0,0], [500,500,0])
 #
-# @note Prior to SketchUp 2019 this class would yield +TypeError+ for all
-#   method calls if +#singleton_class+ was called on the model object.
-#
 # @version SketchUp 6.0
 class Sketchup::Model
 
@@ -56,6 +56,7 @@ class Sketchup::Model
   VERSION_2017 = nil # Stub value.
   VERSION_2018 = nil # Stub value.
   VERSION_2019 = nil # Stub value.
+  VERSION_2020 = nil # Stub value.
   VERSION_3 = nil # Stub value.
   VERSION_4 = nil # Stub value.
   VERSION_5 = nil # Stub value.
@@ -152,6 +153,73 @@ class Sketchup::Model
   def active_path
   end
 
+  # The {#active_path=} method is used to open a given instance path for editing.
+  #
+  # It is expected that no entities are modified in an operation that
+  # opens/closes instances.
+  #
+  # To ensure that undo/redo is done correctly this method breaks up any open
+  # Ruby operations into a set of chained operations:
+  #
+  # If the API user tries to do this:
+  #
+  #     model.start_operation('...', true)
+  #     model.entities.add_face(...)
+  #     model.active_path = instance_path
+  #     model.entities.add_face(...)
+  #     model.commit_operation
+  #
+  # Then the method will break it up to something like this:
+  #
+  #     model.start_operation('...', true)
+  #     model.entities.add_face(...)
+  #     model.commit_operation
+  #
+  #     model.start_operation('...', true, false, true)
+  #     model.active_path = instance_path
+  #     model.commit_operation
+  #
+  #     model.start_operation('...', true, false, true)
+  #     model.entities.add_face(...)
+  #     model.commit_operation
+  #
+  # For the end user this will be experienced as a single operation.
+  # For the API user the side-effect is multiple transaction notifications.
+  #
+  # @example Open an instance
+  #   model = Sketchup.active_model
+  #   instance = model.active_entities.grep(Sketchup::ComponentInstance).first
+  #   instance_path = Sketchup::InstancePath.new([instance])
+  #   model.active_path = instance_path
+  #
+  # @example Close all instances
+  #   model = Sketchup.active_model
+  #   model.active_path = nil
+  #
+  # @note An instance path can only be opened if the instances are not locked.
+  #   This also include instances of the same component definition that are not
+  #   on the given path. A definition cannot be edited if any of its instances
+  #   are locked.
+  #
+  # @note Open/close operations are special operations in SketchUp which has to
+  #   be treated with special care.
+  #
+  # @param [Sketchup::InstancePath, Array<Sketchup::ComponentInstance, Sketchup::Group>, nil] instance_path
+  #   Passing +nil+ or an empty array will close all open instances.
+  #
+  # @raise [ArgumentError] if the instance path is not valid.
+  #
+  # @raise [ArgumentError] if the instance path contains locked instances.
+  #
+  # @raise [ArgumentError] if the instance path contains instances who's
+  #   siblings are locked.
+  #
+  # @return [Sketchup::Model]
+  #
+  # @version SketchUp 2020.0
+  def active_path=(instance_path)
+  end
+
   # The {#active_view} method returns the active View object for this model.
   #
   # @example
@@ -338,17 +406,17 @@ class Sketchup::Model
   def close(ignore_changes = false)
   end
 
-  # The close_active method is used to close the currently active (open) group
+  # The {#close_active} method is used to close the currently active (open) group
   # or component.
   #
-  # Note: before SketchUp 2014 this method had a bug where it didn't create an
-  # undo operation and that could lead to corrupted geometry when undo/redo was
-  # used after invoking this method.
-  #
   # @example
   #   model = Sketchup.active_model
   #   status = model.close_active
   #
+  # @note Before SketchUp 2014 this method had a bug where it didn't create an
+  #   undo operation and that could lead to corrupted geometry when undo/redo was
+  #   used after invoking this method.
+  #
   # @return [Boolean] true if successful, false if unsuccessful.
   #
   # @version SketchUp 6.0
@@ -414,6 +482,54 @@ class Sketchup::Model
   def description=(description)
   end
 
+  # The {#drawing_element_visible?} method reports whether the given drawing
+  # element in an instance path is visible given the current model options.
+  #
+  # @example Traversing every visible entity in the model
+  #   module Example
+  #
+  #     def self.instance?(entity)
+  #       entity.is_a?(Sketchup::ComponentInstance) || entity.is_a?(Sketchup::Group)
+  #     end
+  #
+  #     # Walk the visible entities in the model, taking into account
+  #     # "DrawHiddenGeometry" and "DrawHiddenObjects" rendering options.
+  #     def self.walk(entities, transformation = IDENTITY, path = [], &block)
+  #       entities.each { |entity|
+  #         entity_path = path + [entity]
+  #         next unless entity.model.drawing_element_visible?(entity_path)
+  #         block.call(entity, transformation, path)
+  #         if instance?(entity)
+  #           child_entities = entity.definition.entities
+  #           child_transformation = transformation * entity.transformation
+  #           walk(child_entities, child_transformation, entity_path, &block)
+  #         end
+  #       }
+  #     end
+  #
+  #   end
+  #
+  #   model = Sketchup.active_model
+  #   Example.walk(model.entities) do |entity, transformation, path|
+  #     # Do something to every visible entity in the model...
+  #   end
+  #
+  # @param [Sketchup::InstancePath, Array<Sketchup::Drawingelement>] instance_path
+  #
+  # @raise [ArgumentError] if the +instance_path+ is not valid.
+  #
+  # @return [Boolean]
+  #
+  # @see Sketchup::RenderingOptions
+  #
+  # @see Sketchup::Drawingelement#visible?
+  #
+  # @see Sketchup::Layer#visible?
+  #
+  # @version SketchUp 2020.0
+  def drawing_element_visible?(instance_path)
+  end
+
   # Returns the transformation of the current component edit session. If a user
   # has double-clicked to edit a component's geometry, this will
   # return the transformation of that component, relative to its parent's
@@ -1150,7 +1266,8 @@ class Sketchup::Model
   #     Sketchup::Model::VERSION_2016,
   #     Sketchup::Model::VERSION_2017,
   #     Sketchup::Model::VERSION_2018,
-  #     Sketchup::Model::VERSION_2019
+  #     Sketchup::Model::VERSION_2019,
+  #     Sketchup::Model::VERSION_2020
   #
   # @return [Boolean] true if successful, false if unsuccessful
   #
@@ -1186,7 +1303,8 @@ class Sketchup::Model
   #   Sketchup::Model::VERSION_2016,
   #   Sketchup::Model::VERSION_2017,
   #   Sketchup::Model::VERSION_2018,
-  #   Sketchup::Model::VERSION_2019
+  #   Sketchup::Model::VERSION_2019,
+  #   Sketchup::Model::VERSION_2020
   #
   # @return [Boolean] true if successful, false if unsuccessful
   #