sketchup-api-stubs 0.7.6 → 0.7.7

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2020 Trimble Inc.
+# Copyright:: Copyright 2021 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 2020 Trimble Inc.
+# Copyright:: Copyright 2021 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 2020 Trimble Inc.
+# Copyright:: Copyright 2021 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 2020 Trimble Inc.
+# Copyright:: Copyright 2021 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The {Sketchup::ComponentDefinition} class is used to define the contents for
@@ -20,7 +20,7 @@
 # will be raised. The key/value pairs in the dictionary can be deleted safely.
 #
 # @version SketchUp 6.0
-class Sketchup::ComponentDefinition < Sketchup::Drawingelement
+class Sketchup::ComponentDefinition < DrawingElement
 
   # Includes
 

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2020 Trimble Inc.
+# Copyright:: Copyright 2021 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The {Sketchup::ComponentInstance} class is used to represent component
@@ -123,73 +123,63 @@ class Sketchup::ComponentInstance < Sketchup::Drawingelement
   def explode
   end
 
-  # The glued_to method is used to retrieve the entity that this instance is
+  # The {#glued_to} method is used to retrieve the entity that this instance is
   # glued to.
   #
-  # Returns nil if it is not glued to anything.
-  #
   # @example
-  #   point = Geom::Point3d.new 10,20,30
-  #   transform = Geom::Transformation.new point
+  #   point = Geom::Point3d.new(10, 20, 30)
+  #   transform = Geom::Transformation.new(point)
   #   model = Sketchup.active_model
   #   entities = model.active_entities
-  #   path = Sketchup.find_support_file "Bed.skp",
-  #     "Components/Components Sampler/"
+  #   path = Sketchup.find_support_file("Bed.skp", "Components/Components Sampler/")
   #   definitions = model.definitions
-  #   componentdefinition = definitions.load path
-  #   instance = entities.add_instance componentdefinition, transform
+  #   componentdefinition = definitions.load(path)
+  #   instance = entities.add_instance(componentdefinition, transform)
   #   status = instance.glued_to
   #
-  # @return [Sketchup::Face, nil] the Entity object that the instance is glued
-  #   to (if successful)
+  # @return [Sketchup::Face, Sketchup::Group, Sketchup::ComponentInstance, Sketchup::Image, nil]
   #
   # @version SketchUp 6.0
   def glued_to
   end
 
-  # The glued_to= method glues this instance to a face.
+  # The {glued_to=} method glues this instance to a drawing element.
+  # When moving this other drawing elment with the Move tool, the glued instance moves with it.
   #
-  # This method will raise an exception if the instance cannot be glued to the
-  # given face. Instances cannot be glued if the definition of the instance
-  # doesn't support gluing or if the alignment is wrong.
+  # In SketchUp 2021.1 support for passing {Sketchup::Group}, {Sketchup::ComponentInstance} and
+  # {Sketchup::Image} was added.
   #
   # @example
-  #   depth = 100
-  #   width = 100
-  #   path=Sketchup.find_support_file "Bed.skp",
-  #     "Components/Components Sampler/"
   #   model = Sketchup.active_model
   #   entities = model.active_entities
-  #   pts = []
-  #   pts[0] = [0, 0, 0]
-  #   pts[1] = [width, 0, 0]
-  #   pts[2] = [width, depth, 0]
-  #   pts[3] = [0, depth, 0]
-  #   # Add the face to the entities in the model
-  #   face = entities.add_face pts
-  #   point = Geom::Point3d.new 10,10,0
-  #   transform = Geom::Transformation.new point
+  #
+  #   # Create a face
+  #   face = entities.add_face([[0, 0, 0], [100, 0, 0], [100, 100, 0], [0, 100, 0]])
+  #
+  #   # Add component
+  #   path = Sketchup.find_support_file("Bed.skp", "Components/Components Sampler/")
+  #   point = Geom::Point3d.new(10, 10, 0)
+  #   transformation = Geom::Transformation.new(point)
   #   definitions = model.definitions
-  #   componentdefinition = definitions.load path
-  #   instance = entities.add_instance componentdefinition, transform
-  #   begin
-  #     status = instance.glued_to = face
-  #   rescue
-  #     UI.messagebox $!.message
-  #   end
-  #   if (status)
-  #     UI.messagebox status.to_s
-  #   else
-  #     UI.messagebox "Failure"
-  #   end
+  #   definition = definitions.load(path)
+  #   instance = entities.add_instance(definition, transformation)
   #
-  # @param [Sketchup::Face, nil] face
+  #   # Make component "gluable"
+  #   definition.behavior.is2d = true
   #
-  # @return [Sketchup::Face, nil] - the Face object where the component is glued if
-  #   successful
+  #   # Glue the component to the face.
+  #   # If you now move the face, the component will follow.
+  #   instance.glued_to = face
+  #
+  # @param [Sketchup::Face, Sketchup::Group, Sketchup::ComponentInstance, Sketchup::Image, nil] drawing_element
+  #
+  # @raise ArgumentError if the {Sketchup::Behavior} for this component doesn't allow gluing,
+  #   if the alignment is wrong, or if this would lead to cyclic gluing.
+  #
+  # @return [Sketchup::Face, Sketchup::Group, Sketchup::ComponentInstance, Sketchup::Image, nil] the entity the instance was glued to.
   #
   # @version SketchUp 6.0
-  def glued_to=(face)
+  def glued_to=(drawing_element)
   end
 
   # The guid method is used to get the base 64 encoded unique id

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2020 Trimble Inc.
+# Copyright:: Copyright 2021 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 2020 Trimble Inc.
+# Copyright:: Copyright 2021 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 2020 Trimble Inc.
+# Copyright:: Copyright 2021 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 2020 Trimble Inc.
+# Copyright:: Copyright 2021 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 2020 Trimble Inc.
+# Copyright:: Copyright 2021 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # A DefinitionList object holds a list of all of the ComponentDefinition
@@ -6,7 +6,7 @@
 # definitions from the list.
 #
 # @version SketchUp 6.0
-class Sketchup::DefinitionList < Sketchup::Entity
+class Sketchup::DefinitionList < Entity
 
   # Includes
 
@@ -153,6 +153,33 @@ class Sketchup::DefinitionList < Sketchup::Entity
   def each
   end
 
+  # The {#import} method is used to import a (non-SketchUp) 3d model file as a definition.
+  #
+  # Importers using the C API +SketchUpModelImporterInterface+ interface are supported (those in the +Importers/+ directory).
+  #
+  # See the {file:pages/importer_options.md Importer Options} file for information
+  # on creating a valid hash for the various importers.
+  #
+  # For SketchUp models, instead use {#load}.
+  #
+  # @example
+  #   path = "C:/circle.dwg"
+  #   definition = Sketchup.active_model.definitions.import(path)
+  #
+  # @param [String] path
+  #
+  # @param [Hash] options
+  #
+  # @raise [IOError] if the file is missing.
+  #
+  # @raise [ArgumentError] if no suitable importer could be found.
+  #
+  # @return [Sketchup::ComponentDefinition]
+  #
+  # @version SketchUp 2021.1
+  def import(path, options = {})
+  end
+
   # The {#length} method is used to retrieve number of component definitions in
   # the list.
   #
@@ -218,20 +245,28 @@ class Sketchup::DefinitionList < Sketchup::Entity
   end
 
   # The {#load_from_url} method loads a component from a location specified by
-  # string url. This method throws an exception if an url string is not
-  # given, or an error occurs during retrieval from url and a
-  # load_handler was not given. Optional second parameter load_handler can be
-  # used to pass in a ruby object that responds to the following methods:
+  # string url.
   #
-  #   - cancelled?(a_boolean)
-  #   - onPercentChange(a_float)
-  #   - onSuccess()
-  #   - onFailure(message_string)
+  # This method throws an exception if an url string is not
+  # given, or an error occurs during retrieval from URL and a
+  # +load_handler+ was not given. Optional second parameter +load_handler+ can be
+  # used to pass in a Ruby object that responds to the following methods:
   #
-  # @example
+  # - +cancelled?+
+  # - +onPercentChange(percent)+
+  # - +onSuccess()+
+  # - +onFailure(message_string)+
+  #
+  # @bug Calling this method from an {UI::HtmlDialog}'s action callback on macOS will cause the
+  #   SketchUp application to become unresponsive. To work around this, defer the call from the
+  #   action callback with a non-repeating zero-delay timer;
+  #   +UI.start_timer(0, false) { method_calling_load_from_url }+
+  #
+  # @example Download a component using a LoadHandler
   #   class LoadHandler
   #     attr_accessor :error
   #
+  #     # @param [Float] percent
   #     def onPercentChange(percent)
   #       Sketchup::set_status_text("loading: #{percent.round}%")
   #     end
@@ -247,6 +282,7 @@ class Sketchup::DefinitionList < Sketchup::Entity
   #       Sketchup::set_status_text('')
   #     end
   #
+  #     # @param [String] error_message
   #     def onFailure(error_message)
   #       self.error = error_message
   #       Sketchup::set_status_text('')
@@ -254,7 +290,7 @@ class Sketchup::DefinitionList < Sketchup::Entity
   #   end
   #
   #   # Replace this with a real URL...
-  #   url = 'http://www.sketchup.com/model.skp'
+  #   url = 'https://www.sketchup.com/model.skp'
   #   model = Sketchup.active_model
   #   load_handler = LoadHandler.new
   #   definition = model.definitions.load_from_url(url, load_handler)
@@ -263,6 +299,33 @@ class Sketchup::DefinitionList < Sketchup::Entity
   #     puts "Error: #{load_handler.error}"
   #   end
   #
+  # @example Workaround for macOS bug related to HtmlDialog action callbacks
+  #   module Example
+  #
+  #     def self.open_dialog
+  #       @dialog = UI::HtmlDialog.new
+  #       @dialog.add_action_callback("say") { |action_context, url|
+  #         self.load_component_deferred(url)
+  #       }
+  #       @dialog.set_file("path/to/file.html")
+  #       @dialog.show
+  #     end
+  #
+  #     def load_component_deferred
+  #       # The timer delay is enough to avoid .load_from_url from deadlocking.
+  #       UI.start_timer(0, false) do
+  #         self.load_component(url)
+  #       end
+  #     end
+  #
+  #     def self.load_component(url)
+  #       model = Sketchup.active_model
+  #       definition = model.definitions.load_from_url(url)
+  #       # ...
+  #     end
+  #
+  #   end
+  #
   # @overload load_from_url(url)
   #
   #   @param [String] url
@@ -274,7 +337,7 @@ class Sketchup::DefinitionList < Sketchup::Entity
   #     URL to load a .skp file from.
   #   @param [Object] load_handler
   #     Ruby object that has methods defined
-  #     as described in the load_from_url details.
+  #     as described in the +load_from_url+ details above.
   #
   # @return [Sketchup::ComponentDefinition]
   #

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2020 Trimble Inc.
+# Copyright:: Copyright 2021 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 2020 Trimble Inc.
+# Copyright:: Copyright 2021 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 2020 Trimble Inc.
+# Copyright:: Copyright 2021 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 2020 Trimble Inc.
+# Copyright:: Copyright 2021 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 2020 Trimble Inc.
+# Copyright:: Copyright 2021 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 2020 Trimble Inc.
+# Copyright:: Copyright 2021 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 2020 Trimble Inc.
+# Copyright:: Copyright 2021 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 2020 Trimble Inc.
+# Copyright:: Copyright 2021 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 2020 Trimble Inc.
+# Copyright:: Copyright 2021 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 2020 Trimble Inc.
+# Copyright:: Copyright 2021 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The {Sketchup::Entities} class is a collection of Entity objects, either in a

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2020 Trimble Inc.
+# Copyright:: Copyright 2021 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 2020 Trimble Inc.
+# Copyright:: Copyright 2021 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # This is the base class for all SketchUp entities. Entities are basically

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

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

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2020 Trimble Inc.
+# Copyright:: Copyright 2021 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 2020 Trimble Inc.
+# Copyright:: Copyright 2021 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # Faces in SketchUp are flat, 2-sided polygons with 3 or more sides.
@@ -200,6 +200,21 @@ class Sketchup::Face < Sketchup::Drawingelement
   def classify_point(point)
   end
 
+  # The {#clear_texture_projection} method is used to clear the texture
+  # projection. This is similar to toggling off Projection from the Position
+  # Texture tool in the UI.
+  #
+  # @param [Boolean] frontside
+  #   +true+ for front side, +false+ for back side.
+  #
+  # @see #position_material
+  #
+  # @see #get_texture_projection
+  #
+  # @version SketchUp 2021.1
+  def clear_texture_projection(frontside)
+  end
+
   # The edges method is used to get an array of edges that bound the face.
   #
   # @example
@@ -331,7 +346,7 @@ class Sketchup::Face < Sketchup::Drawingelement
   def get_glued_instances
   end
 
-  # The get_texture_projection method will return a vector representing the
+  # The {#get_texture_projection} method will return a vector representing the
   # projection for either the front or back side of the face.
   #
   # @example
@@ -365,9 +380,14 @@ class Sketchup::Face < Sketchup::Drawingelement
   #   vector = face.get_texture_projection(true)
   #
   # @param [Boolean] frontside
-  #   true for front side, false for back side.
+  #   +true+ for front side, +false+ for back side.
+  #
+  # @return [Geom::Vector3d, nil] a vector on success, +nil+ if face is not
+  #   textured with a projected texture mapping.
+  #
+  # @see #position_material
   #
-  # @return [Geom::Vector3d] a vector on success, nil on failure.
+  # @see #texture_projected?
   #
   # @version SketchUp 2014
   def get_texture_projection(frontside)
@@ -568,25 +588,26 @@ class Sketchup::Face < Sketchup::Drawingelement
   def plane
   end
 
-  # The position_material method is used to position a material on a face.
+  # The {#position_material} method is used to position a material on a face.
   #
-  # The pt_array must contain 2, 4, 6 or 8 points. The points are used in pairs
-  # to tell where a point in the texture image is positioned on the Face. The
-  # first point in each pair is a 3D point in the model. It should be a point on
-  # the Face. The second point in each pair of points is a 2D point that gives
-  # the (u,v) coordinates of a point in the image to match up with the 3D point.
+  # The +points+ argument must contain 2, 4, 6 or 8 points. The points are used
+  # in pairs to describe where a point in the texture image is positioned on the
+  # Face. The first point in each pair is a 3D point in the model. The second
+  # point in each pair of points is a 2D point that gives the (u,v) coordinates
+  # of a point in the image to match up with the 3D point.
   #
   # @example
   #   model = Sketchup.active_model
   #   entities = model.active_entities
   #
   #   # Create a face and add it to the model entities
-  #   pts = []
-  #   pts[0] = [0, 0, 1]
-  #   pts[1] = [9, 0, 1]
-  #   pts[2] = [9, 9, 1]
-  #   pts[3] = [0, 9, 1]
-  #   face = entities.add_face(pts)
+  #   points = [
+  #     Geom::Point3d.new(0, 0, 1),
+  #     Geom::Point3d.new(9, 0, 1),
+  #     Geom::Point3d.new(9, 9, 1),
+  #     Geom::Point3d.new(0, 9, 1),
+  #   ]
+  #   face = entities.add_face(points)
   #
   #   # Export an image to use as a texture
   #   path = Sketchup.temp_dir
@@ -600,26 +621,64 @@ class Sketchup::Face < Sketchup::Drawingelement
   #   # Assign the new material to our face we created
   #   face.material = material
   #
-  #   pt_array = []
-  #   pt_array[0] = Geom::Point3d.new(3,0,0)
-  #   pt_array[1] = Geom::Point3d.new(0,0,0)
+  #   mapping = [
+  #     Geom::Point3d.new(3,0,0), # Model coordinate
+  #     Geom::Point3d.new(0,0,0), # UV coordinate
+  #   ]
   #   on_front = true
-  #   face.position_material(material, pt_array, on_front)
+  #   face.position_material(material, mapping, on_front)
   #
-  # @param [Sketchup::Material] material
-  #   a Material object.
+  # @overload position_material(material, points, on_front)
+  #
+  #   This variant positions a material on the face's plane without projection.
+  #
+  #   @param [Sketchup::Material] material
+  #
+  #   @param [Array<Geom::Point3d>] points
+  #     An array of Point3d objects used to position the material.
+  #     The points should be on the plane of the face. If they are not they will
+  #     be projected to the face's plane.
+  #
+  #   @param [Boolean] on_front
+  #     +true+ to position the texture on the front of the Face or
+  #     +false+ to position it on the back of the Face.
   #
-  # @param [Array<Geom::Point3d>] pt_array
-  #   An array of Point3d objects used to position the material.
+  # @overload position_material(material, points, on_front, projection)
   #
-  # @param [Boolean] o_front
-  #   true to position the texture on the front of the Face or
-  #   false to position it on the back of the Face.
+  #   This variant positions a material on the face's plane with projection.
   #
-  # @return [Sketchup::Face, false] the face upon success, false upon failure.
+  #   @param [Sketchup::Material] material
+  #
+  #   @param [Array<Geom::Point3d>] points
+  #     An array of Point3d objects used to position the material.
+  #     The points should be on the same plane. The plane should be parallel to
+  #     the +projection+ vector. If they are not on a plane parallel to the
+  #     projection vector they will be projected to such a plane.
+  #
+  #   @param [Boolean] on_front
+  #     +true+ to position the texture on the front of the Face or
+  #     +false+ to position it on the back of the Face.
+  #
+  #   @param [Geom::Vector3d] projection_vector
+  #     The direction of the texture projection.
+  #
+  # @raise ArgumentError if the provided points are not in the size of 2, 4, 6 or 8.
+  #
+  # @raise ArgumentError if the provided points could not be computed to a valid UV mapping.
+  #
+  # @return [Sketchup::Face, false] the face upon success, +false+ if material or
+  #   texture if not valid.
+  #
+  # @see #texture_positioned?
+  #
+  # @see #texture_projected?
+  #
+  # @see #get_texture_projection
+  #
+  # @see #clear_texture_projection
   #
   # @version SketchUp 6.0
-  def position_material(material, pt_array, o_front)
+  def position_material(*args)
   end
 
   # The pushpull method is used to perform a push/pull on a face.
@@ -678,50 +737,157 @@ class Sketchup::Face < Sketchup::Drawingelement
   def reverse!
   end
 
-  # The set_texture_projection method is used to set the texture projection
+  # The {#set_texture_projection} method is used to set the texture projection
   # direction.
   #
-  # @deprecated This function never worked right. It's not possible to control
-  #   the position and orientation of the texture.
+  # @deprecated This function never worked correctly. It's not capable of
+  #   controlling the position and orientation of the texture. In some cases it
+  #   produced an invalid model. After SketchUp 2021.1 the method will raise
+  #   +NotImplementedError+.
+  #
+  # @param [Geom::Vector3d] vector
+  #   representing the direction of the projection. Use +nil+ to remove the
+  #   projection.
+  #
+  # @param [Boolean] frontside
+  #   +true+ for front side, +false+ for back side.
+  #
+  # @return [Boolean]
+  #
+  # @see #position_material
+  #
+  # @see #clear_texture_projection
+  #
+  # @version SketchUp 2014
+  def set_texture_projection(vector, frontside)
+  end
+
+  # The {#texture_positioned?} method is used to check if the face has a
+  # texture that is positioned.
+  #
+  # A texture is positioned when it's not using the default texture coordinates.
+  #
+  # When a user uses the Paint Bucket Tool to apply a material sampled from the
+  # Material Browser it will use default texture coordinates and not be
+  # positioned. It will be positioned if the user uses the Position Texture Tool.
+  #
+  # When an API user uses {Sketchup::Drawinglement#material=} the texture is not
+  # positioned. It will be positioned when the API user uses
+  # {Sketchup::Face#position_material}. It it also positioned of the face was
+  # crafted via {Geom::PolygonMesh}.
   #
   # @example
   #   model = Sketchup.active_model
   #   entities = model.active_entities
-  #   materials = model.materials
+  #   faces = entities.grep(Sketchup::Face).select { |face|
+  #     face.texture_positioned?(true) || face.texture_positioned?(false)
+  #   }
   #
-  #   # Create a face and add it to the model entities
-  #   pts = []
-  #   pts[0] = [0, 0, 1]
-  #   pts[1] = [10, 0, 1]
-  #   pts[2] = [10, 10, 1]
-  #   face = entities.add_face(pts)
+  # @param [Boolean] front
+  #   +true+ Checks the front side of the face, +face+
+  #   the back side.
   #
-  #   # Export an image to use as a texture
-  #   path = Sketchup.temp_dir
-  #   full_name = File.join(path, "temp_image.jpg")
-  #   model.active_view.write_image(full_name, 500, 500, false, 0.0)
+  # @return [Boolean]
   #
-  #   # Create a material and assign the testure to it.
-  #   material = materials.add("Test Material")
-  #   material.texture = full_name
+  # @see #position_material
   #
-  #   # Assign the new material to our face we created
-  #   face.material = material
+  # @see #material=
   #
-  #   # Returns nil if not successful, path if successful
-  #   result = face.set_texture_projection(face.normal, true)
+  # @see #back_material=
   #
-  # @param [Geom::Vector3d] vector
-  #   representing the direction of the projection. Use nil
-  #   to remove the projection.
+  # @version SketchUp 2021.1
+  def texture_positioned?(front)
+  end
+
+  # The {#texture_projected?} method is used to check if the face has a
+  # texture that is projected.
   #
-  # @param [Boolean] frontside
-  #   true for front side, false for back side.
+  # A texture is projected when the user enables this property via the
+  # Position Texture Tool.
   #
-  # @return [Boolean] true on success
+  # It is also projected when the API user passes a projection vector to
+  # {#position_material}.
   #
-  # @version SketchUp 2014
-  def set_texture_projection(vector, frontside)
+  # @param [Boolean] front
+  #   +true+ Checks the front side of the face, +face+
+  #   the back side.
+  #
+  # @return [Boolean]
+  #
+  # @see #get_texture_projection
+  #
+  # @see #clear_texture_projection
+  #
+  # @see #position_material
+  #
+  # @version SketchUp 2021.1
+  def texture_projected?(front)
+  end
+
+  # The {#uv_tile_at} method is used to get the corner positions (model and UV)
+  # of a UV tile.
+  #
+  # The UV tile bounds the given reference point on the plane of the face. If the
+  # reference isn't on the plane of the face it will be projected onto it.
+  #
+  # The world coordinates are on the plane of the face unless the texture is
+  # projected. When the texture is projected the the world points are on an
+  # arbitrary plane that is perpendicular to the projection direction.
+  #
+  # The returned coordinates are arranged to be compatible with {#position_material}.
+  #
+  # <b>Getting the bounds of the UV tile under the cursor:</b>
+  #
+  # <i>The red quadrilateral represents the model points returned.</i>
+  #
+  # rdoc-image:../images/face-uv-tile-at.png
+  #
+  # @example Copy material from front to back
+  #   model = Sketchup.active_model
+  #   model.active_entities.grep(Sketchup::Face) { |face|
+  #     material = face.material
+  #
+  #     if material&.texture.nil?
+  #       face.back_material = material
+  #     end
+  #
+  #     reference = face.vertices.first.position
+  #     mapping = face.uv_tile_at(reference, true)
+  #     if face.texture_projected?(true)
+  #       projection = face.get_texture_projection(true)
+  #       face.position_material(material, mapping, false, projection)
+  #     else
+  #       face.position_material(material, mapping, false)
+  #     end
+  #   }
+  #
+  # @example Iterate each set of world and UV coordinates
+  #   model = Sketchup.active_model
+  #   faces = model.active_entities.grep(Sketchup::Face)
+  #   face = faces.find { |face| face.material&.texture }
+  #   reference = face.vertices.first.position
+  #   mapping = face.uv_tile_at(reference, true)
+  #   mapping.each_slice(2) { |position, uv|
+  #     puts "World: #{position.inspect} - UV: #{uv.inspect}"
+  #   }
+  #
+  # @param [Geom::Point3d] position
+  #   Model position on the face's plane that will be
+  #   bounded by the UV tile.
+  #
+  # @param [Boolean] front
+  #   +true+ Checks the front side of the face, +face+
+  #   the back side.
+  #
+  # @return [Array<Geom::Point3d>, nil] A set of 8 points. Each stride of two is
+  #   first a model space point, the second a UV
+  #   coordinate. +nil+ if the face doesn't have
+  #   a texture on the given side.
+  #
+  # @see #position_material
+  #
+  # @version SketchUp 2021.1
+  def uv_tile_at(position, front)
   end
 
   # The vertices method is used to get an array of all of the vertices that