sketchup-api-stubs 0.7.2 → 0.7.7

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2020 Trimble Inc.
+# Copyright:: Copyright 2021 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The TextureWriter class is used primarily for writing the textures used in a

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2020 Trimble Inc.
+# Copyright:: Copyright 2021 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # Tool is the interface that you implement to create a SketchUp tool.
@@ -32,12 +32,15 @@
 # - +ALT_MODIFIER_KEY+ = Command on Mac, Alt on PC
 # - +ALT_MODIFIER_MASK+ = Command on Mac, Alt on PC
 #
+# @abstract Implement the methods described in this class to create a tool.
+#   You can not sub-class this class because it is not defined by the API.
+#
 # @version SketchUp 6.0
 class Sketchup::Tool
 
   # Instance Methods
 
-  # The #{activate} method is called by SketchUp when the tool is selected.
+  # The {#activate} method is called by SketchUp when the tool is selected.
   # It is a good place to put most of your initialization, such as instance
   # variables to track the state of the tool.
   #
@@ -50,7 +53,7 @@ class Sketchup::Tool
   def activate
   end
 
-  # The #{deactivate} method is called when the tool is deactivated because a
+  # The {#deactivate} method is called when the tool is deactivated because a
   # different tool was selected.
   #
   # @example
@@ -102,7 +105,7 @@ class Sketchup::Tool
   def draw(view)
   end
 
-  # The #{enableVCB?} method is used to tell SketchUp whether to allow the user
+  # The {#enableVCB?} method is used to tell SketchUp whether to allow the user
   # to enter text into the VCB (value control box, aka the "measurements" panel).
   # If you do not implement this method, then the vcb is disabled by default.
   #
@@ -141,7 +144,7 @@ class Sketchup::Tool
   def getExtents
   end
 
-  # The #{getInstructorContentDirectory} method is used to tell SketchUp the
+  # The {#getInstructorContentDirectory} method is used to tell SketchUp the
   # directory containing your Tool's instructor content. To use this, create
   # a custom instructor directory, put an index.html file inside of it, and then
   # return that path via this method. If the SketchUp user has the Instructor
@@ -165,7 +168,7 @@ class Sketchup::Tool
   def getInstructorContentDirectory
   end
 
-  # The #{getMenu} method is called by SketchUp to let the tool provide its own
+  # The {#getMenu} method is called by SketchUp to let the tool provide its own
   # context menu. Most tools will not want to implement this method and,
   # instead, use the normal context menu found on all entities.
   #
@@ -250,6 +253,9 @@ class Sketchup::Tool
   #   actually executed. If you need to do something with the model after an undo
   #   use {Sketchup::ModelObserver#onTransactionUndo}.
   #
+  # @note When {#onKeyDown} is implemented and returns +true+, pressing Esc
+  #   doesn't trigger {#onCancel}.
+  #
   # @param [Integer] reason
   #   A reason value (see comments).
   #
@@ -259,7 +265,7 @@ class Sketchup::Tool
   def onCancel(reason, view)
   end
 
-  # The #{onKeyDown} method is called by SketchUp when the user presses a key on
+  # The {#onKeyDown} method is called by SketchUp when the user presses a key on
   # the keyboard. If you want to get input from the VCB, you should implement
   # onUserText rather than this method.
   #
@@ -320,7 +326,7 @@ class Sketchup::Tool
   def onKeyDown(key, repeat, flags, view)
   end
 
-  # The #{onKeyUp} method is called by SketchUp when the user releases a key on
+  # The {#onKeyUp} method is called by SketchUp when the user releases a key on
   # the keyboard.
   #
   # @example
@@ -352,7 +358,7 @@ class Sketchup::Tool
   def onKeyUp(key, repeat, flags, view)
   end
 
-  # The #{onLButtonDoubleClick} is called by SketchUp when the user double clicks
+  # The {#onLButtonDoubleClick} is called by SketchUp when the user double clicks
   # with the left mouse button.
   #
   # @example
@@ -379,7 +385,7 @@ class Sketchup::Tool
   def onLButtonDoubleClick(flags, x, y, view)
   end
 
-  # The #{onLButtonDown} method is called by SketchUp when the left mouse button
+  # The {#onLButtonDown} method is called by SketchUp when the left mouse button
   # is pressed. Most tools will implement this method.
   #
   # @example
@@ -406,7 +412,7 @@ class Sketchup::Tool
   def onLButtonDown(flags, x, y, view)
   end
 
-  # The #{onLButtonUp} method is called by SketchUp when the left mouse button is
+  # The {#onLButtonUp} method is called by SketchUp when the left mouse button is
   # released.
   #
   # @example
@@ -433,7 +439,7 @@ class Sketchup::Tool
   def onLButtonUp(flags, x, y, view)
   end
 
-  # The #{onMButtonDoubleClick} method is called by SketchUp when the middle
+  # The {#onMButtonDoubleClick} method is called by SketchUp when the middle
   # mouse button (on a three button mouse) is double-clicked.
   #
   # Only implement this method if you want SketchUp to react to a middle mouse
@@ -468,7 +474,7 @@ class Sketchup::Tool
   def onMButtonDoubleClick(flags, x, y, view)
   end
 
-  # The #{onMButtonDown} method is called by SketchUp when the middle mouse
+  # The {#onMButtonDown} method is called by SketchUp when the middle mouse
   # button (on a three button mouse) is down.
   #
   # The Orbit tool is activated by default when the middle mouse button is down.
@@ -499,7 +505,7 @@ class Sketchup::Tool
   def onMButtonDown(flags, x, y, view)
   end
 
-  # The #{onMButtonUp} method is called by SketchUp when the middle mouse button
+  # The {#onMButtonUp} method is called by SketchUp when the middle mouse button
   # (on a three button mouse) is released.
   #
   # SketchUp returns to the previous tool from the Orbit tool when the middle
@@ -531,7 +537,7 @@ class Sketchup::Tool
   def onMButtonUp(flags, x, y, view)
   end
 
-  # The #{onMouseEnter} method is called by SketchUp when the mouse enters the
+  # The {#onMouseEnter} method is called by SketchUp when the mouse enters the
   # viewport.
   #
   # @example
@@ -545,7 +551,7 @@ class Sketchup::Tool
   def onMouseEnter(view)
   end
 
-  # The #{onMouseLeave} method is called by SketchUp when the mouse leaves the
+  # The {#onMouseLeave} method is called by SketchUp when the mouse leaves the
   # viewport.
   #
   # @example
@@ -559,7 +565,7 @@ class Sketchup::Tool
   def onMouseLeave(view)
   end
 
-  # The #{onMouseMove} method is called by SketchUp whenever the mouse is moved.
+  # The {#onMouseMove} method is called by SketchUp whenever the mouse is moved.
   # You will often want to implement this method.
   #
   # Try to make this method as efficient as possible because this method is
@@ -589,7 +595,7 @@ class Sketchup::Tool
   def onMouseMove(flags, x, y, view)
   end
 
-  # The #{onMouseWheel} method is called by SketchUp when the mouse scroll wheel
+  # The {#onMouseWheel} method is called by SketchUp when the mouse scroll wheel
   # is used.
   #
   # @example
@@ -660,7 +666,7 @@ class Sketchup::Tool
   def onMouseWheel(flags, delta, x, y, view)
   end
 
-  # The #{onRButtonDoubleClick} is called by SketchUp when the user double clicks
+  # The {#onRButtonDoubleClick} is called by SketchUp when the user double clicks
   # with the right mouse button.
   #
   # @example
@@ -687,7 +693,7 @@ class Sketchup::Tool
   def onRButtonDoubleClick(flags, x, y, view)
   end
 
-  # The #{onRButtonDown} method is called by SketchUp when the user presses
+  # The {#onRButtonDown} method is called by SketchUp when the user presses
   # the right mouse button. Implement this method, along with the tool.getMenu
   # method, when you want your tool to do something other than display the
   # default context menu when the right mouse button is clicked.
@@ -716,7 +722,7 @@ class Sketchup::Tool
   def onRButtonDown(flags, x, y, view)
   end
 
-  # The #{onRButtonUp} method is called by SketchUp when the user releases the
+  # The {#onRButtonUp} method is called by SketchUp when the user releases the
   # right mouse button.
   #
   # @example
@@ -760,7 +766,7 @@ class Sketchup::Tool
   def onReturn(view)
   end
 
-  # The #{onSetCursor} method is called by SketchUp when the tool wants to set
+  # The {#onSetCursor} method is called by SketchUp when the tool wants to set
   # the cursor.
   #
   # @example
@@ -783,7 +789,7 @@ class Sketchup::Tool
   #   def onUserText(text, view)
   #     @distance = text.to_l
   #   rescue ArgumentError
-  #     view.tooltop = 'Invalid length'
+  #     view.tooltip = 'Invalid length'
   #   end
   #
   # @param [String] text
@@ -796,7 +802,7 @@ class Sketchup::Tool
   def onUserText(text, view)
   end
 
-  # The #{resume} method is called by SketchUp when the tool becomes active again
+  # The {#resume} method is called by SketchUp when the tool becomes active again
   # after being suspended.
   #
   # @example
@@ -810,7 +816,7 @@ class Sketchup::Tool
   def resume(view)
   end
 
-  # The #{suspend} method is called by SketchUp when the tool temporarily becomes
+  # The {#suspend} method is called by SketchUp when the tool temporarily becomes
   # inactive because another tool has been activated. This typically happens
   # when a viewing tool is activated, such as when orbit is active due to the
   # middle mouse button.

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2020 Trimble Inc.
+# Copyright:: Copyright 2021 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Tools class contains methods to manipulate a collection of SketchUp
@@ -16,7 +16,7 @@ class Sketchup::Tools
   #
   # @example
   #   tools = Sketchup.active_model.tools
-  #   tool = tools.current
+  #   tool = tools.active_tool
   #
   # @return [Object, nil] Returns the active Ruby tool, or `nil` otherwise.
   #

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

@@ -1,9 +1,7 @@
-# Copyright:: Copyright 2020 Trimble Inc.
+# Copyright:: Copyright 2021 Trimble Inc.
 # License:: The MIT License (MIT)
 
-# This observer interface is implemented to react to tool events. To implement
-# this observer, create a Ruby class of this type, override the desired
-# methods, and add an instance of the observer to the {Sketchup::Tools} object.
+# This observer interface is implemented to react to tool events.
 #
 # Some of the code below mentions +tool_names+ and +tool_ids+. Here is a list
 # of the common tool IDs and names:
@@ -42,6 +40,10 @@
 # - +21020+ = SketchTool
 # - +21405+ = TextTool
 #
+# @abstract To implement this observer, create a Ruby class of this type,
+#   override the desired methods, and add an instance of the observer to the
+#   {Sketchup::Tools} object.
+#
 # @example
 #   # This is an example of an observer that watches tool interactions.
 #   class MyToolsObserver < Sketchup::ToolsObserver

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2020 Trimble Inc.
+# Copyright:: Copyright 2021 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The UV Helper class contains methods allowing you to determine the location
@@ -14,45 +14,55 @@ class Sketchup::UVHelper
 
   # Instance Methods
 
-  # The get_back_UVQ method is used to get the UV coordinates for the back of a
-  # face.
+  # The {#get_back_UVQ} method is used to get the UV texture coordinates on the
+  # back of a face.
   #
   # @example
-  #   uv_helper = face.get_UVHelper true, true, my_texture_writer
+  #   uv_helper = face.get_UVHelper(true, true, my_texture_writer)
   #   face.outer_loop.vertices.each do |vert|
-  #     uvq = uv_help.get_back_UVQ(vert.position)
-  #     puts "u=" + uvq.x.to_s + " v=" + uvq.y.to_s
+  #     uvq = uv_helper.get_back_UVQ(vert.position)
+  #     # "Normalize" UVQ to UV.
+  #     u = uvq.u / unq.q
+  #     v = uvq.v / unq.q
+  #     puts "u=#{u} v=#{v}""
   #   end
   #
-  # @param point
-  #   A Point3d object containing one of the 3D vertexes of
-  #   the face.
+  # @note To convert UVQ coordinates to UV,
+  #   divide U and V by Q.
+  #       u = uvq.u / uvq.q
+  #       v = uvq.v / uvq.q
   #
-  # @return point - a Point3d containing the UV coordinates where
-  #   the X value is the U value, the Y value is the V value
-  #   and the Z value is a Q value (which is not used).
+  # @param [Geom::Point3d] point
+  #   A point on the face.
+  #
+  # @return [Geom::Point3d] Point where X represents U, Y represents V and Z represents Q.
   #
   # @version SketchUp 6.0
   def get_back_UVQ(point)
   end
 
-  # The get_front_UVQ method is used to get the UV coordinates for a front of a
-  # face.
+  # The {#get_front_UVQ} method is used to get the UV texture coordinates on the
+  # front of a face.
   #
   # @example
-  #   uv_helper = face.get_UVHelper true, true, my_texture_writer
+  #   uv_helper = face.get_UVHelper(true, true, my_texture_writer)
   #   face.outer_loop.vertices.each do |vert|
   #     uvq = uv_helper.get_front_UVQ(vert.position)
-  #     puts "u=" + uvq.x.to_s + " v=" + uvq.y.to_s
+  #     # "Normalize" UVQ to UV.
+  #     u = uvq.u / unq.q
+  #     v = uvq.v / unq.q
+  #     puts "u=#{u} v=#{v}""
   #   end
   #
-  # @param point
-  #   A Point3d object containing one of the 3D vertexes of
-  #   the face.
+  # @note To convert UVQ coordinates to UV,
+  #   divide U and V by Q.
+  #       u = uvq.u / uvq.q
+  #       v = uvq.v / uvq.q
+  #
+  # @param [Geom::Point3d] point
+  #   A point on the face.
   #
-  # @return point - a Point3d containing the UV coordinates where
-  #   the X value is the U value, the Y value is the V value
-  #   and the Z value is a Q value (which is not used).
+  # @return [Geom::Point3d] Point where X represents U, Y represents V and Z represents Q.
   #
   # @version SketchUp 6.0
   def get_front_UVQ(point)

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2020 Trimble Inc.
+# Copyright:: Copyright 2021 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 2020 Trimble Inc.
+# Copyright:: Copyright 2021 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # This class contains methods to manipulate the current point of view of the
@@ -91,15 +91,13 @@ class Sketchup::View
   #
   # @overload camera=(camera)
   #
-  #   @param camera [Sketchup::Camera] The new Camera object.
-  #   @return [Sketchup::Camera]
+  #   @param [Sketchup::Camera] camera The new camera object.
   #
   # @overload camera=(camera_and_transition)
   #
-  #   @param camera_and_transition [Array(Sketchup::Camera, Float)]
+  #   @param [Array(Sketchup::Camera, Float)] camera_and_transition
   #     The second item in the array represents the transition time from the
-  #     existing camera to the new one
-  #   @return [Array(Sketchup::Camera, Float)]
+  #     existing camera to the new one.
   #
   # @version SketchUp 6.0
   def camera=(arg)
@@ -246,11 +244,11 @@ class Sketchup::View
   #     light will affect it. By providing an array of vertex normals lighting
   #     is turned on and will use the model's current light. Note that the number
   #     of normals must match the number of points provided.
-  #   @option options [Integer] :texture_id
+  #   @option options [Integer] :texture
   #     A texture id provided by {#load_texture}.
   #   @option options [Array<Geom::Vector3d>] :uvs
   #     Set of UV (Not UVQ) coordinates matching the number of points provided.
-  #     This must be used along with the +:texture_id+ option.
+  #     This must be used along with the +:texture+ option.
   #
   # @overload draw(openglenum, *points, **options)
   #
@@ -265,11 +263,11 @@ class Sketchup::View
   #     light will affect it. By providing an array of vertex normals lighting
   #     is turned on and will use the model's current light. Note that the number
   #     of normals must match the number of points provided.
-  #   @option options [Integer] :texture_id
+  #   @option options [Integer] :texture
   #     A texture id provided by {#load_texture}.
   #   @option options [Array<Geom::Vector3d>] :uvs
   #     Set of UV (Not UVQ) coordinates matching the number of points provided.
-  #     This must be used along with the +:texture_id+ option.
+  #     This must be used along with the +:texture+ option.
   #
   # @return [Sketchup::View]
   #
@@ -320,11 +318,11 @@ class Sketchup::View
   #     from the comments, such as +GL_LINES+.
   #   @param [Array<Geom::Point3d>] points
   #   @param [Hash] options
-  #   @option options [Integer] :texture_id
+  #   @option options [Integer] :texture
   #     A texture id provided by {#load_texture}.
   #   @option options [Array<Geom::Vector3d>] :uvs
   #     Set of UV (Not UVQ) coordinates matching the number of points provided.
-  #     This must be used along with the +:texture_id+ option.
+  #     This must be used along with the +:texture+ option.
   #
   # @overload draw2d(openglenum, *points, **options)
   #
@@ -334,11 +332,11 @@ class Sketchup::View
   #     from the comments, such as +GL_LINES+.
   #   @param [Array<Geom::Point3d>] points
   #   @param [Hash] options
-  #   @option options [Integer] :texture_id
+  #   @option options [Integer] :texture
   #     A texture id provided by {#load_texture}.
   #   @option options [Array<Geom::Vector3d>] :uvs
   #     Set of UV (Not UVQ) coordinates matching the number of points provided.
-  #     This must be used along with the +:texture_id+ option.
+  #     This must be used along with the +:texture+ option.
   #
   # @return [Sketchup::View]
   #
@@ -362,15 +360,16 @@ class Sketchup::View
   #   status = view.drawing_color="red"
   #   status = view.draw_lines point4, point5
   #
-  # @overload draw_lines(point_list, ...)
+  # @overload draw_lines(points, ...)
   #
-  #   @param point_list [Array<Geom::Point3d>] An even number of Point3d objects.
-  #   @return [Sketchup::View] returns the View object
+  #   @param [Array<Geom::Point3d>] points
+  #     An even number of Point3d objects.
+  #   @return [Sketchup::View]
   #
-  # @overload draw_lines(pts)
+  # @overload draw_lines(points)
   #
-  #   @param pts [Array<Geom::Point3d>] An array of Point3d objects.
-  #   @return [Sketchup::View] returns the View object
+  #   @param [Array<Geom::Point3d>] points An array of Point3d objects.
+  #   @return [Sketchup::View]
   #
   # @version SketchUp 6.0
   def draw_line(*args)
@@ -388,15 +387,16 @@ class Sketchup::View
   #   status = view.drawing_color="red"
   #   status = view.draw_lines point4, point5
   #
-  # @overload draw_lines(point_list, ...)
+  # @overload draw_lines(points, ...)
   #
-  #   @param point_list [Array<Geom::Point3d>] An even number of Point3d objects.
-  #   @return [Sketchup::View] returns the View object
+  #   @param [Array<Geom::Point3d>] points
+  #     An even number of Point3d objects.
+  #   @return [Sketchup::View]
   #
-  # @overload draw_lines(pts)
+  # @overload draw_lines(points)
   #
-  #   @param pts [Array<Geom::Point3d>] An array of Point3d objects.
-  #   @return [Sketchup::View] returns the View object
+  #   @param [Array<Geom::Point3d>] points An array of Point3d objects.
+  #   @return [Sketchup::View]
   #
   # @version SketchUp 6.0
   def draw_lines(*args)
@@ -409,26 +409,23 @@ class Sketchup::View
   # @example
   #   point3 = Geom::Point3d.new 0,0,0
   #   # returns a view
-  #   status = view.draw_points point3, 10, 1, "red"
+  #   status = view.draw_points(point3, 10, 1, "red")
   #
-  # @param [Array<Geom::Point3d>] pts
-  #   An array of Point3d objects.
+  # @param [Array<Geom::Point3d>] points
   #
-  # @param [Integer] pointsize
+  # @param [Integer] size
   #   Size of the point in pixels.
   #
-  # @param [Sketchup::Color] pointcolor
-  #   Color of the point.
-  #
-  # @param [Integer] pointstyle
-  #   Style of the point. 1 = open square,
-  #   2 = filled square, 3 = "+", 4 = "X", 5 = "*",
+  # @param [Integer] style
+  #   1 = open square, 2 = filled square, 3 = "+", 4 = "X", 5 = "*",
   #   6 = open triangle, 7 = filled triangle.
   #
+  # @param [Sketchup::Color] color
+  #
   # @return [Sketchup::View] a View object
   #
   # @version SketchUp 6.0
-  def draw_points(pts, pointsize = 6, pointstyle = 3, pointcolor = 'black')
+  def draw_points(points, size = 6, style = 3, color = 'black')
   end
 
   # The draw_polyline method is used to draw a series of connected line segments
@@ -443,15 +440,15 @@ class Sketchup::View
   #   point15 = Geom::Point3d.new 30,30,30
   #   status = view.draw_polyline point12, point13, point14, point15
   #
-  # @overload draw_polyline(point_list, ...)
+  # @overload draw_polyline(points, ...)
   #
-  #   @param point_list [Array<Geom::Point3d>] An even number of Point3d objects.
-  #   @return [Sketchup::View] a View object
+  #   @param [Array<Geom::Point3d>] points An even number of Point3d objects.
+  #   @return [Sketchup::View]
   #
-  # @overload draw_polyline(pts)
+  # @overload draw_polyline(points)
   #
-  #   @param pts [Array<Geom::Point3d>] An array of Point3d objects.
-  #   @return [Sketchup::View] a View object
+  #   @param [Array<Geom::Point3d>] points An array of Point3d objects.
+  #   @return [Sketchup::View]
   #
   # @version SketchUp 6.0
   def draw_polyline(*args)
@@ -473,7 +470,7 @@ class Sketchup::View
   #   class ExampleTool
   #     def draw(view)
   #       # This works in all SketchUp versions and draws the text using the
-  #       # default font, color and size.
+  #       # default font, size and color (i.e. the model edge color).
   #       point = Geom::Point3d.new(200, 100, 0)
   #       view.draw_text(point, "This is a test")
   #
@@ -498,14 +495,14 @@ class Sketchup::View
   #     IS_WIN = Sketchup.platform == :platform_win
   #
   #     def draw(view)
-  #       draw_text(view, "Hello World", size: 20)
+  #       draw_text(view, [100, 200, 0], "Hello World", size: 20)
   #     end
   #
   #     private
   #
   #     # This will ensure text is drawn with consistent size across platforms,
   #     # using pixels as size units.
-  #     def draw_text(view, text, **options)
+  #     def draw_text(view, position, text, **options)
   #       native_options = options.dup
   #       if IS_WIN && options.key?(:size)
   #         native_options[:size] = pixels_to_points(size)
@@ -763,7 +760,6 @@ class Sketchup::View
   # @example
   #   module Example
   #     class MyTool
-  #
   #       def activate
   #         view = Sketchup.active_model.active_view
   #         image_rep = view.model.materials.current.texture.image_rep
@@ -777,9 +773,8 @@ class Sketchup::View
   #       def draw(view)
   #         points = [ [0, 0, 0], [9, 0, 0], [9, 9, 0], [0, 9, 0] ]
   #         uvs = [ [0, 0, 0], [1, 0, 0], [1, 1, 0], [0, 1, 0] ]
-  #         view.draw(points, texture_id: @texture_id, uvs: uvs)
+  #         view.draw(GL_QUADS, points, texture: @texture_id, uvs: uvs)
   #       end
-  #
   #     end
   #   end
   #   Sketchup.active_model.select_tool(Example::MyTool.new)
@@ -804,16 +799,20 @@ class Sketchup::View
   # @see #release_texture
   #
   # @see #draw
+  #
+  # @version SketchUp 2020.0
   def load_texture(image_rep)
   end
 
-  # The lock_inference method is used to lock or unlock an inference.
+  # The {#lock_inference} method is used to lock or unlock an inference.
   #
   # This method will typically be called from inside a tool class when the user
-  # presses the shift key.
+  # presses the shift key or arrow keys.
   #
-  # With no arguments it unlocks all inferences. With one or two arguments, it
-  # locks the inference based on the given InputPoint(s).
+  # With no arguments it unlocks all inferences. With one argument it locks
+  # inference based on that passed {Sketchup::InputPoint}'s entities, e.g. along
+  # a {Sketchup::Edge}'s line or a {Sketchup::Face}'s plane. With two arguments,
+  # it locks inference along an axis.
   #
   # @example
   #   view = view.lock_inference
@@ -826,14 +825,19 @@ class Sketchup::View
   # @overload lock_inference(inputpoint)
   #
   #   @param [Sketchup::InputPoint] inputpoint
-  #     1st InputPoint to inference to.
   #
   # @overload lock_inference(inputpoint, inputpoint2)
   #
   #   @param [Sketchup::InputPoint] inputpoint
-  #     1st InputPoint to inference to.
   #   @param [Sketchup::InputPoint] inputpoint2
-  #     2nd InputPoint to inference to.
+  #   @example
+  #     # Lock inference to X axis.
+  #     # The points can be anywhere; only the vector between them affects
+  #     # the result.
+  #     view.lock_inference(
+  #       Sketchup::InputPoint.new(ORIGIN),
+  #       Sketchup::InputPoint.new(Geom::Point3d.new(1, 0, 0))
+  #     )
   #
   # @return [Sketchup::View] a View object
   #
@@ -949,7 +953,6 @@ class Sketchup::View
   # @example
   #   module Example
   #     class MyTool
-  #
   #       def activate
   #         view = Sketchup.active_model.active_view
   #         image_rep = view.model.materials.current.texture.image_rep
@@ -963,9 +966,8 @@ class Sketchup::View
   #       def draw(view)
   #         points = [ [0, 0, 0], [9, 0, 0], [9, 9, 0], [0, 9, 0] ]
   #         uvs = [ [0, 0, 0], [1, 0, 0], [1, 1, 0], [0, 1, 0] ]
-  #         view.draw(points, texture_id: @texture_id, uvs: uvs)
+  #         view.draw(GL_QUADS, points, texture: @texture_id, uvs: uvs)
   #       end
-  #
   #     end
   #   end
   #   Sketchup.active_model.select_tool(Example::MyTool.new)
@@ -1166,7 +1168,7 @@ class Sketchup::View
   #   view = model.active_view
   #   height = view.vpheight
   #
-  # @return [Integer] the height of the viewport in pixels.
+  # @return [Integer] the height of the viewport in physical pixels.
   #
   # @version SketchUp 6.0
   def vpheight
@@ -1178,7 +1180,7 @@ class Sketchup::View
   # @example
   #   width = view.vpwidth
   #
-  # @return [Integer] the width of the viewport in pixels.
+  # @return [Integer] the width of the viewport in physical pixels.
   #
   # @version SketchUp 6.0
   def vpwidth
@@ -1186,15 +1188,19 @@ class Sketchup::View
 
   # The {#write_image} method is used to write the current view to an image file.
   #
+  # Supported file types are `.png`, `.jpg`, `.jpeg`, `gif`, `.bmp`, `.tif`.
+  # For other file formats  available from the GUI in File > Export > 2D
+  # Graphics, .e.g `.pdf`, use {Sketchup::Model#export}.
+  #
   # @overload write_image(filename, width = view.vpwidth, height = view.vpheight, antialias = false, compression = 1.0)
   #
   #   @note Prefer the overload with option hash instead of this variant. This
   #     overload is not updated with new options.
   #
   #   @example
-  #     filename => "c:/tmp/write_image.png"
-  #     antialias => false
-  #     compression => 0.9
+  #     filename = File.join(Sketchup.temp_dir, 'example.png')
+  #     antialias = false
+  #     compression = 0.9
   #     model = Sketchup.active_model
   #     view = model.active_view
   #     view.write_image(filename, 640, 480, antialias, compression)
@@ -1213,7 +1219,7 @@ class Sketchup::View
   #
   #   @example
   #     options = {
-  #       :filename => "c:/tmp/write_image.png",
+  #       :filename => File.join(Sketchup.temp_dir, 'example.png'),
   #       :width => 640,
   #       :height => 480,
   #       :antialias => false,
@@ -1227,7 +1233,7 @@ class Sketchup::View
   #   @version SketchUp 7
   #   @param [Hash] options
   #   @option options [String] filename  The filename for the saved image.
-  #   @option options [Integer] width (#vpwidth)  Width in pixels (max +1600+).
+  #   @option options [Integer] width (#vpwidth)  Width in pixels (max +16000+).
   #   @option options [Integer] height (#vpheight)  Height in pixels (max +16000+).
   #   @option options [Float] scale_factor (1.0)  Scaling factor for
   #     elements that are viewport dependent, such as text heights, arrow heads,
@@ -1245,7 +1251,7 @@ class Sketchup::View
   #
   #   @example
   #     options = {
-  #       :filename => "c:/tmp/write_image.png",
+  #       :filename => File.join(Sketchup.temp_dir, 'example.png'),
   #       :source => :framebuffer,
   #       :compression => 0.9,
   #     }