sketchup-api-stubs 0.1.2 → 0.2.0

data/SketchUp/Sketchup/Text.rb

@@ -17,7 +17,7 @@ class Sketchup::Text < Sketchup::Drawingelement
   # @example
   #   type = text.arrow_type=0
   #
-  # @return arrow - a numerical representation for the type of
+  # @return [Integer] a numerical representation for the type of
   #   arrow.
   #
   # @version SketchUp 6.0
@@ -32,11 +32,11 @@ class Sketchup::Text < Sketchup::Drawingelement
   # @example
   #   arrow = text.arrow_type=type
   #
-  # @param type
+  # @param [Integer] type
   #   A numerical representation of the type of arrow to be
   #   set.
   #
-  # @return arrow - a numerical representation for the type of
+  # @return [Integer] a numerical representation for the type of
   #   arrow.
   #
   # @version SketchUp 6.0
@@ -51,11 +51,11 @@ class Sketchup::Text < Sketchup::Drawingelement
   # @example
   #   leader = text.display_leader=true
   #
-  # @param status
+  # @param [Boolean] status
   #   true if you want to display the leader text, false if
   #   you do not want to display the leader text.
   #
-  # @return status - the status that you set.
+  # @return [Boolean] the status that you set.
   #
   # @version SketchUp 6.0
   def display_leader=(status)
@@ -66,8 +66,7 @@ class Sketchup::Text < Sketchup::Drawingelement
   # @example
   #   status = text.display_leader
   #
-  # @return status - true if the leader is being displayed, false
-  #   if it is not displayed.
+  # @return [Boolean]
   #
   # @return [Boolean]
   #
@@ -80,8 +79,7 @@ class Sketchup::Text < Sketchup::Drawingelement
   # @example
   #   status = text.has_leader
   #
-  # @return status - true if the Text object has a leader. False if
-  #   the Text object does not have a leader.
+  # @return [Boolean]
   #
   # @return [Boolean]
   #
@@ -94,7 +92,7 @@ class Sketchup::Text < Sketchup::Drawingelement
   # @example
   #   leader = text.leader_type
   #
-  # @return leader - a numerical value representing the currently
+  # @return [Integer] a numerical value representing the currently
   #   set leader type.
   #
   # @version SketchUp 6.0
@@ -108,11 +106,11 @@ class Sketchup::Text < Sketchup::Drawingelement
   # @example
   #   leader = text.leader_type=1
   #
-  # @param type
+  # @param [Integer] type
   #   A numerical value representing the leader type to be
   #   set.
   #
-  # @return leader - a numerical value representing the leader type
+  # @return [Integer] a numerical value representing the leader type
   #   you just set.
   #
   # @version SketchUp 6.0
@@ -126,7 +124,7 @@ class Sketchup::Text < Sketchup::Drawingelement
   # @example
   #   weight = text.line_weight
   #
-  # @return lineweight - the line weight in pixels
+  # @return [Integer] the line weight in pixels
   #
   # @version SketchUp 6.0
   def line_weight
@@ -139,10 +137,10 @@ class Sketchup::Text < Sketchup::Drawingelement
   # @example
   #   newweight = text.line_weight = 4
   #
-  # @param weight
+  # @param [Integer] weight
   #   The line weight to be set (in pixels).
   #
-  # @return The line weight that has been set.
+  # @return [Integer] The line weight that has been set.
   #
   # @version SketchUp 6.0
   def line_weight=(weight)
@@ -153,7 +151,7 @@ class Sketchup::Text < Sketchup::Drawingelement
   # @example
   #   point3d = text.point
   #
-  # @return point - a Point3d object.
+  # @return [Geom::Point3d] a Point3d object.
   #
   # @version SketchUp 6.0
   def point
@@ -164,10 +162,10 @@ class Sketchup::Text < Sketchup::Drawingelement
   # @example
   #   status = text.point = point3d
   #
-  # @param point3d
+  # @param [Geom::Point3d] point3d
   #   A Point3d object.
   #
-  # @return status - true if successful, false if unsuccessful.
+  # @return [Geom::Point3d] true if successful, false if unsuccessful.
   #
   # @version SketchUp 6.0
   def point=(point3d)
@@ -179,10 +177,10 @@ class Sketchup::Text < Sketchup::Drawingelement
   # @example
   #   text = text.set_text "This is another text"
   #
-  # @param textstring
+  # @param [String] textstring
   #   The string to be set within the Text object.
   #
-  # @return text - the Text object
+  # @return [Sketchup::Text] the Text object
   #
   # @version SketchUp 6.0
   def set_text(textstring)
@@ -193,7 +191,7 @@ class Sketchup::Text < Sketchup::Drawingelement
   # @example
   #   textstring = text.text
   #
-  # @return textstring - the string representation of the Text
+  # @return [String] the string representation of the Text
   #   object
   #
   # @version SketchUp 6.0
@@ -205,9 +203,9 @@ class Sketchup::Text < Sketchup::Drawingelement
   # @example
   #   textstring = text.text= "text"
   #
-  # @param textstring
+  # @param [String] textstring
   #
-  # @return textstring - the newly set text
+  # @return [String] the newly set text
   #
   # @version SketchUp 6.0
   def text=(textstring)
@@ -218,7 +216,7 @@ class Sketchup::Text < Sketchup::Drawingelement
   # @example
   #   vector = text.vector
   #
-  # @return vector - a Vector3d object.
+  # @return [Geom::Vector3d] a Vector3d object.
   #
   # @version SketchUp 6.0
   def vector
@@ -229,10 +227,10 @@ class Sketchup::Text < Sketchup::Drawingelement
   # @example
   #   vector = text.vector
   #
-  # @param vector
+  # @param [Geom::Vector3d] vector
   #   A Vector3d object.
   #
-  # @return success - true if successful.
+  # @return [Geom::Vector3d]
   #
   # @version SketchUp 6.0
   def vector=(vector)

data/SketchUp/Sketchup/Texture.rb

@@ -34,7 +34,7 @@ class Sketchup::Texture < Sketchup::Entity
   #     UI.messagebox "Failure: No average color"
   #   end
   #
-  # @return color - a color object (if successful), nil if
+  # @return [Sketchup::Color, nil] a color object (if successful), nil if
   #   unsuccessful.
   #
   # @version SketchUp 6.0
@@ -63,7 +63,7 @@ class Sketchup::Texture < Sketchup::Entity
   #     UI.messagebox "Failure"
   #   end
   #
-  # @return filename - a string representation of the path and
+  # @return [String] a string representation of the path and
   #   filename used for the texture.
   #
   # @version SketchUp 6.0
@@ -76,7 +76,7 @@ class Sketchup::Texture < Sketchup::Entity
   # @example
   #   height = texture.height
   #
-  # @return height - the height, in inches, of the texture pattern
+  # @return [Integer] the height, in inches, of the texture pattern
   #
   # @version SketchUp 6.0
   def height
@@ -93,13 +93,29 @@ class Sketchup::Texture < Sketchup::Entity
   #     UI.messagebox "Failure"
   #   end
   #
-  # @return imageheight - the height, in pixels, of the texture
+  # @return [Integer] the height, in pixels, of the texture
   #   pattern
   #
   # @version SketchUp 6.0
   def image_height
   end
 
+  # The {#image_rep} method returns a copy of a {Sketchup::ImageRep} object
+  # representing the texture pixel data.
+  #
+  # @example
+  #   texture = Sketchup.active_model.materials[0].texture
+  #   image_rep = texture.image_rep
+  #
+  # @param [Boolean] colorized
+  #   Set to +true+ to obtain the colorized version.
+  #
+  # @return [Sketchup::ImageRep]
+  #
+  # @version SketchUp 2018
+  def image_rep(colorized = false)
+  end
+
   # The image_width method retrieves the width of the repeatable texture image,
   # in pixels.
   #
@@ -111,7 +127,7 @@ class Sketchup::Texture < Sketchup::Entity
   #     UI.messagebox "Failure"
   #   end
   #
-  # @return imagewidth - the width, in pixels, of the texture
+  # @return [Integer] the width, in pixels, of the texture
   #   pattern
   #
   # @version SketchUp 6.0
@@ -139,14 +155,14 @@ class Sketchup::Texture < Sketchup::Entity
   #     UI.messagebox "Failure"
   #   end
   #
-  # @param size
+  # @param [Integer, Array(Integer, Integer)] size
   #   The size, in inches, of the texture. This number will
   #   apply to height and width to keep aspect ratio.
   #   You can also pass as a parameter an array of two
   #   numeric values which will set width and height
   #   regardless of maintaining the height/width ratio.
   #
-  # @return size - the size, in inches, of the texture. This number
+  # @return [Integer, Array(Integer, Integer)] the size, in inches, of the texture. This number
   #   will apply to height and width to keep aspect ratio.
   #   If you have passed in an array of two numbers for width
   #   and height, the same array will be returned if
@@ -166,7 +182,7 @@ class Sketchup::Texture < Sketchup::Entity
   #     UI.messagebox status
   #   end
   #
-  # @return status - true if valid, false if invalid.
+  # @return [Boolean]
   #
   # @return [Boolean]
   #
@@ -180,7 +196,7 @@ class Sketchup::Texture < Sketchup::Entity
   # @example
   #   width = texture.width
   #
-  # @return width - the width, in inches, of the texture pattern
+  # @return [Integer] the width, in inches, of the texture pattern
   #
   # @version SketchUp 6.0
   def width
@@ -195,14 +211,14 @@ class Sketchup::Texture < Sketchup::Entity
   #   filename = File.join(Sketchup.temp_dir, basename)
   #   material.texture.write(filename)
   #
-  # @param filename
+  # @param [String] filename
   #   String - The filename to write the texture to.
   #
-  # @param colorize
+  # @param [Boolean] colorize
   #   Boolean - Allows for the texture to
   #   be exported with the color adjustments.
   #
-  # @return Boolean - true if the method succeeded
+  # @return [Boolean] true if the method succeeded
   #
   # @version SketchUp 2016
   def write(filename, colorize = false)

data/SketchUp/Sketchup/Vertex.rb

@@ -24,10 +24,10 @@ class Sketchup::Vertex < Sketchup::Entity
   #     UI.messagebox "Failure"
   #   end
   #
-  # @param vertex2
+  # @param [Sketchup::Vertex] vertex2
   #   A Vertex object.
   #
-  # @return edge - an Edge object common to both vertices if
+  # @return [Sketchup::Edge, nil] an Edge object common to both vertices if
   #   successful. Returns nil if there is no edge between the
   #   two vertices.
   #
@@ -35,7 +35,7 @@ class Sketchup::Vertex < Sketchup::Entity
   def common_edge(vertex2)
   end
 
-  # The curve_interior? method is used to determine if this vertex is on the
+  # The {#curve_interior?} method is used to determine if this vertex is on the
   # interior of a Curve.
   #
   # @example
@@ -51,8 +51,11 @@ class Sketchup::Vertex < Sketchup::Entity
   #     UI.messagebox "Failure"
   #   end
   #
-  # @return status - true if it is used by exactly two edges which
-  #   are both part of the same curve.
+  # @note This method doesn't actually return a boolean as the question mark
+  #   post-fix would normally indicate. But the result still evaluates to
+  #   truthy or falsy.
+  #
+  # @return [Boolean]
   #
   # @return [Boolean]
   #
@@ -69,7 +72,7 @@ class Sketchup::Vertex < Sketchup::Entity
   #   vertex1 = verticies[0]
   #   edges = vertex1.edges
   #
-  # @return edges - an Array of edge objects if successful
+  # @return [Array<Sketchup::Edge>] an Array of edge objects if successful
   #
   # @version SketchUp 6.0
   def edges
@@ -84,7 +87,7 @@ class Sketchup::Vertex < Sketchup::Entity
   #   vertex1 = verticies[0]
   #   faces = vertex1.faces
   #
-  # @return faces - an Array of faces that use the vertex if
+  # @return [Array<Sketchup::Face>] an Array of faces that use the vertex if
   #   successful
   #
   # @version SketchUp 6.0
@@ -100,7 +103,7 @@ class Sketchup::Vertex < Sketchup::Entity
   #   vertex1 = verticies[0]
   #   loops = vertex1.loops
   #
-  # @return loops - an Array of loops that use the vertex if
+  # @return [Array<Sketchup::Loop>] an Array of loops that use the vertex if
   #   successful
   #
   # @version SketchUp 6.0
@@ -116,7 +119,7 @@ class Sketchup::Vertex < Sketchup::Entity
   #   vertex1 = verticies[0]
   #   position = vertex1.position
   #
-  # @return point - a Point3d object representing the position of
+  # @return [Geom::Point3d] a Point3d object representing the position of
   #   the vertex if successful
   #
   # @version SketchUp 6.0
@@ -129,10 +132,10 @@ class Sketchup::Vertex < Sketchup::Entity
   # @example
   #   used = vertex1.used_by? my_face
   #
-  # @param face_or_edge
+  # @param [Sketchup::Edge, Sketchup::Face] face_or_edge
   #   A Face or Edge ot test against.
   #
-  # @return used - true if the Vertex is used in the given entity.
+  # @return [Boolean]
   #
   # @return [Boolean]
   #

data/SketchUp/Sketchup/View.rb

@@ -22,10 +22,10 @@ class Sketchup::View
   #   view = Sketchup.active_model.active_view
   #   status = view.add_observer observer
   #
-  # @param observer
+  # @param [Object] observer
   #   An observer.
   #
-  # @return true if successful, false if unsuccessful.
+  # @return [Boolean] true if successful, false if unsuccessful.
   #
   # @version SketchUp 6.0
   def add_observer(observer)
@@ -45,10 +45,10 @@ class Sketchup::View
   #     UI.messagebox "Failure"
   #   end
   #
-  # @param animation
+  # @param [#nextFrame] animation
   #   An Animation object.
   #
-  # @return animation - the newly set Animation object
+  # @return [#nextFrame] the newly set Animation object
   #
   # @version SketchUp 6.0
   def animation=(animation)
@@ -63,7 +63,7 @@ class Sketchup::View
   #   view = model.active_view
   #   time = view.average_refresh_time
   #
-  # @return time - the time in milliseconds
+  # @return [Float] the time in seconds
   #
   # @version SketchUp 6.0
   def average_refresh_time
@@ -74,7 +74,7 @@ class Sketchup::View
   # @example
   #   camera = view.camera
   #
-  # @return camera - a Camera object
+  # @return [Sketchup::Camera] a Camera object
   #
   # @version SketchUp 6.0
   def camera
@@ -92,15 +92,15 @@ class Sketchup::View
   #
   # @overload camera=(camera)
   #
-  #   @param [Sketchup::Camera] camera  The new Camera object.
-  #   @return nil
+  #   @param camera [Sketchup::Camera] The new Camera object.
+  #   @return [Sketchup::Camera]
   #
   # @overload camera=(camera_and_transition)
   #
-  #   @param [Array(Sketchup::Camera, Float)] camera_and_transition
-  #       The second item in the array represent the transition time from the
-  #       existing camera to the
-  #   @return nil
+  #   @param camera_and_transition [Array(Sketchup::Camera, Float)]
+  #     The second item in the array represents the transition time from the
+  #     existing camera to the new one
+  #   @return [Array(Sketchup::Camera, Float)]
   #
   # @version SketchUp 6.0
   def camera=(arg)
@@ -114,7 +114,7 @@ class Sketchup::View
   #   view = model.active_view
   #   c = view.center
   #
-  # @return center - the center of the view
+  # @return [Geom::Point3d] the center of the view
   #
   # @version SketchUp 6.0
   def center
@@ -137,11 +137,11 @@ class Sketchup::View
   # @example
   #   point = view.corner index
   #
-  # @param index
+  # @param [Integer] index
   #   A value between (or including) 0 and 3 identifying the
   #   corner whose coordinate you want to retrieve.
   #
-  # @return point - a 2d array [w,h] representing the screen point
+  # @return [Array(Integer, Integer)] a 2d array [w,h] representing the screen point
   #
   # @version SketchUp 6.0
   def corner(index)
@@ -217,10 +217,10 @@ class Sketchup::View
   #   view.draw(GL_LINE_LOOP, points)
   #
   # @note If you draw outside the model bounds you need to implement
-  #   {Tool#getExtents} which return a bounding box large enough to include the
+  #   {Tool#getExtents} which returns a bounding box large enough to include the
   #   points you draw. Otherwise your drawing will be clipped.
   #
-  # @param [Integer] mode
+  # @param [Integer] openglenum
   #   The item you are going to draw, one of the constants
   #   from the comments, such as +GL_LINES+.
   #
@@ -231,7 +231,7 @@ class Sketchup::View
   # @see Tool#getExtents
   #
   # @version SketchUp 6.0
-  def draw(mode, points)
+  def draw(openglenum, points)
   end
 
   # The {#draw2d} method is used to draw in screen space (using 2D screen
@@ -253,12 +253,12 @@ class Sketchup::View
   #   ]
   #   view.draw2d(GL_LINE_STRIP, points)
   #
-  # @param [Array<Geom::Point3d>] points
-  #
   # @param [Integer] openglenum
   #   An OpenGL enumerator (unsigned integer). See
   #   comments in the {#draw} method for a list of constants.
   #
+  # @param [Array<Geom::Point3d>] points
+  #
   # @return [Sketchup::View] returns the View object.
   #
   # @see #draw
@@ -283,13 +283,13 @@ class Sketchup::View
   #
   # @overload draw_lines(point_list, ...)
   #
-  #   @param point_list    An even number of Point3d objects.
-  #   @return              view - a View object
+  #   @param point_list [Array<Geom::Point3d>] An even number of Point3d objects.
+  #   @return [Sketchup::View] returns the View object
   #
   # @overload draw_lines(pts)
   #
-  #   @param pts           An array of Point3d objects.
-  #   @return              view - a View object
+  #   @param pts [Array<Geom::Point3d>] An array of Point3d objects.
+  #   @return [Sketchup::View] returns the View object
   #
   # @version SketchUp 6.0
   def draw_line(*args)
@@ -309,13 +309,13 @@ class Sketchup::View
   #
   # @overload draw_lines(point_list, ...)
   #
-  #   @param point_list    An even number of Point3d objects.
-  #   @return              view - a View object
+  #   @param point_list [Array<Geom::Point3d>] An even number of Point3d objects.
+  #   @return [Sketchup::View] returns the View object
   #
   # @overload draw_lines(pts)
   #
-  #   @param pts           An array of Point3d objects.
-  #   @return              view - a View object
+  #   @param pts [Array<Geom::Point3d>] An array of Point3d objects.
+  #   @return [Sketchup::View] returns the View object
   #
   # @version SketchUp 6.0
   def draw_lines(*args)
@@ -330,24 +330,24 @@ class Sketchup::View
   #   # returns a view
   #   status = view.draw_points point3, 10, 1, "red"
   #
-  # @param pts
+  # @param [Array<Geom::Point3d>] pts
   #   An array of Point3d objects.
   #
-  # @param [optional] pointsize
-  #   Size of the point in pixels.
-  #
-  # @param [optional] pointcolor
-  #   Color of the point.
-  #
-  # @param [optional] pointstyle
+  # @param [Integer] pointstyle
   #   Style of the point. 1 = open square,
   #   2 = filled square, 3 = "+", 4 = "X", 5 = "*",
   #   6 = open triangle, 7 = filled triangle.
   #
-  # @return view - a View object
+  # @param [Sketchup::Color] pointcolor
+  #   Color of the point.
+  #
+  # @param [Integer] pointsize
+  #   Size of the point in pixels.
+  #
+  # @return [Sketchup::View] a View object
   #
   # @version SketchUp 6.0
-  def draw_points(pts, pointsize, pointstyle, pointcolor)
+  def draw_points(pts, pointsize = 6, pointstyle = 3, pointcolor = 'black')
   end
 
   # The draw_polyline method is used to draw a series of connected line segments
@@ -364,13 +364,13 @@ class Sketchup::View
   #
   # @overload draw_polyline(point_list, ...)
   #
-  #   @param point_list    An even number of Point3d objects.
-  #   @return              view - a View object
+  #   @param point_list [Array<Geom::Point3d>] An even number of Point3d objects.
+  #   @return [Sketchup::View] a View object
   #
   # @overload draw_polyline(pts)
   #
-  #   @param pts           An array of Point3d objects.
-  #   @return              view - a View object
+  #   @param pts [Array<Geom::Point3d>] An array of Point3d objects.
+  #   @return [Sketchup::View] a View object
   #
   # @version SketchUp 6.0
   def draw_polyline(*args)
@@ -443,10 +443,10 @@ class Sketchup::View
   # @example
   #   view = view.drawing_color = color
   #
-  # @param color
+  # @param [Sketchup::Color, String] color
   #   A Color object.
   #
-  # @return view - a View object
+  # @return [Sketchup::View]
   #
   # @version SketchUp 6.0
   def drawing_color=(color)
@@ -463,10 +463,10 @@ class Sketchup::View
   # @example
   #   view.dynamic = true
   #
-  # @param value
+  # @param [Boolean] value
   #   true or false
   #
-  # @return nil
+  # @return [Boolean]
   #
   # @version SketchUp 6.0
   def dynamic=(value)
@@ -478,7 +478,7 @@ class Sketchup::View
   # @example
   #   fov = Sketchup.active_model.active_view.field_of_view
   #
-  # @return fov - the field of view
+  # @return [Float] the field of view
   #
   # @version SketchUp 6.0
   def field_of_view
@@ -492,10 +492,10 @@ class Sketchup::View
   #   my_view.field_of_view = 45
   #   my_view.invalidate
   #
-  # @param fov
-  #   - the field of view
+  # @param [Numeric] fov
+  #   the field of view
   #
-  # @return status - true if successful
+  # @return [Numeric]
   #
   # @version SketchUp 6.0
   def field_of_view=(fov)
@@ -510,11 +510,11 @@ class Sketchup::View
   # @example
   #   target = view.guess_target
   #
-  # @return target - a Point3d object representing the point in the
+  # @return [Geom::Point3d] a Point3d object representing the point in the
   #   model that the user is likely interested in.
   #
   # @version SketchUp 6.0
-  def guess_target
+  def guess_target(*args)
   end
 
   # The inference_locked? method is used to determine if inference locking is on
@@ -525,7 +525,7 @@ class Sketchup::View
   #   view = model.active_view
   #   status = view.inference_locked
   #
-  # @return status - true if locked, false if unlocked
+  # @return [Boolean]
   #
   # @return [Boolean]
   #
@@ -542,16 +542,16 @@ class Sketchup::View
   # @example
   #   inputpoint = view.inputpoint x, y, inputpoint1
   #
-  # @param x
+  # @param [Numeric] x
   #   A x value.
   #
-  # @param y
-  #   A y value.
-  #
-  # @param inputpoint1
+  # @param [Sketchup::InputPoint] inputpoint1
   #   An InputPoint object.
   #
-  # @return nil
+  # @param [Numeric] y
+  #   A y value.
+  #
+  # @return [Sketchup::InputPoint]
   #
   # @version SketchUp 6.0
   def inputpoint(x, y, inputpoint1)
@@ -567,7 +567,7 @@ class Sketchup::View
   # @note This is the preferred method to update the viewport. Use this before
   #   trying to use {#refresh}.
   #
-  # @return invalidated_view - the invalidated View object
+  # @return [Sketchup::View] the invalidated View object
   #
   # @version SketchUp 6.0
   def invalidate
@@ -579,10 +579,10 @@ class Sketchup::View
   # @example
   #   time = view.last_refresh_time
   #
-  # @return time - time in milliseconds
+  # @return [Float] time in milliseconds
   #
   # @version SketchUp 6.0
-  def last_refresh_time
+  def last_refresh_time(*args)
   end
 
   # The line_stipple= method is used to set the line pattern to use for drawing.
@@ -602,10 +602,10 @@ class Sketchup::View
   #   view.line_stipple = "-.-"
   #   view = view.draw_lines point8, point9
   #
-  # @param pattern
+  # @param [String] pattern
   #   A string stipple pattern, such as "-.-"
   #
-  # @return view - the View object
+  # @return [Sketchup::View] the View object
   #
   # @version SketchUp 6.0
   def line_stipple=(pattern)
@@ -619,10 +619,10 @@ class Sketchup::View
   # @example
   #   view.line_width = width
   #
-  # @param width
+  # @param [Integer] width
   #   The width in pixels.
   #
-  # @return view - a View object
+  # @return [Integer]
   #
   # @version SketchUp 6.0
   def line_width=(width)
@@ -638,19 +638,28 @@ class Sketchup::View
   #
   # @example
   #   view = view.lock_inference
-  #   view = view.lock_inference inputpoint
-  #   view = view.lock_inference inputpoint1, inputpoint2
+  #   view = view.lock_inference(inputpoint)
+  #   view = view.lock_inference(inputpoint1, inputpoint2)
+  #
+  # @overload lock_inference
+  #
   #
-  # @param [optional] inputpoint
-  #   1st InputPoint to inference to.
+  # @overload lock_inference(inputpoint)
   #
-  # @param [optional] inputpoint2
-  #   2nd InputPoint to inference to.
+  #   @param [Sketchup::InputPoint] inputpoint
+  #     1st InputPoint to inference to.
   #
-  # @return view - a View object
+  # @overload lock_inference(inputpoint, inputpoint2)
+  #
+  #   @param [Sketchup::InputPoint] inputpoint
+  #     1st InputPoint to inference to.
+  #   @param [Sketchup::InputPoint] inputpoint2
+  #     2nd InputPoint to inference to.
+  #
+  # @return [Sketchup::View] a View object
   #
   # @version SketchUp 6.0
-  def lock_inference(inputpoint, inputpoint2)
+  def lock_inference(*args)
   end
 
   # The model method is used to retrieve the model for the current view.
@@ -658,7 +667,7 @@ class Sketchup::View
   # @example
   #   model = view.model
   #
-  # @return model - the model for this view
+  # @return [Sketchup::Model] the model for this view
   #
   # @version SketchUp 6.0
   def model
@@ -676,14 +685,14 @@ class Sketchup::View
   #
   # @overload pick_helper
   #
-  #   @return              pickhelper - a PickHelper object
+  #   @return [Sketchup::PickHelper] a PickHelper object
   #
   # @overload pick_helper(x, y, aperture = 0)
   #
   #   @param [Integer] x
   #   @param [Integer] y
   #   @param [Integer] aperture
-  #   @return              pickhelper - a PickHelper object
+  #   @return [Sketchup::PickHelper] a PickHelper object
   #
   # @version SketchUp 6.0
   def pick_helper(*args)
@@ -698,13 +707,13 @@ class Sketchup::View
   # @overload pickray(screen_point)
   #
   #   @param [Array(Integer, Integer)] screen_point
-  #   @return              ray - a ray
+  #   @return [Array(Geom::Point3d, Geom::Vector3d)] a ray
   #
   # @overload pickray(x, y)
   #
   #   @param [Integer] x
   #   @param [Integer] y
-  #   @return              ray - a ray
+  #   @return [Array(Geom::Point3d, Geom::Vector3d)] a ray
   #
   # @version SketchUp 6.0
   def pickray(*args)
@@ -719,13 +728,13 @@ class Sketchup::View
   # @example
   #   size = view.pixels_to_model pixels, point
   #
-  # @param pixels
+  # @param [Numeric] pixels
   #   The pixel size.
   #
-  # @param point
+  # @param [Geom::Point3d] point
   #   A Point3d object where the size will be calculated from.
   #
-  # @return size - the model size
+  # @return [Float] the model size
   #
   # @version SketchUp 6.0
   def pixels_to_model(pixels, point)
@@ -742,7 +751,7 @@ class Sketchup::View
   #   instability or crashes. Don't use this unless you have verified that
   #   you cannot use {#invalidate} instead.
   #
-  # @return refreshed_view - the refreshed View object
+  # @return [Sketchup::View] the refreshed View object
   #
   # @version SketchUp 7.1
   def refresh
@@ -755,10 +764,10 @@ class Sketchup::View
   #   view = Sketchup.active_model.active_view
   #   status = view.remove_observer observer
   #
-  # @param observer
+  # @param [Object] observer
   #   An observer.
   #
-  # @return true if successful, false if unsuccessful.
+  # @return [Boolean] true if successful, false if unsuccessful.
   #
   # @version SketchUp 6.0
   def remove_observer(observer)
@@ -774,10 +783,10 @@ class Sketchup::View
   # @example
   #   point = view.screen_coords(ORIGIN)
   #
-  # @param point3d
+  # @param [Geom::Point3d] point3d
   #   A Point3d object.
   #
-  # @return x, y - A Point3d containing the screen position
+  # @return [Geom::Point3d] A Point3d containing the screen position
   #
   # @version SketchUp 6.0
   def screen_coords(point3d)
@@ -792,13 +801,13 @@ class Sketchup::View
   # @example
   #   view = view.set_color_from_line point1, point2
   #
-  # @param point1
+  # @param [Geom::Point3d] point1
   #   Point3d object representing first point in the line.
   #
-  # @param point2
-  #   Point3d object representing second point in the line.
+  # @param [Geom::Point3d] point2
+  #   Point3d object representing the second point in the line.
   #
-  # @return view - a View object
+  # @return [Sketchup::View] a View object
   #
   # @version SketchUp 6.0
   def set_color_from_line(point1, point2)
@@ -811,12 +820,12 @@ class Sketchup::View
   # frame. This can be useful to control the speed at which the animation runs.
   #
   # @example
-  #   status = view.show_frame &lt;delay
+  #   status = view.show_frame delay
   #
-  # @param delay
+  # @param [Numeric] delay
   #   An optional delay in seconds.
   #
-  # @return nil
+  # @return [Sketchup::View]
   #
   # @version SketchUp 6.0
   def show_frame(delay)
@@ -828,10 +837,10 @@ class Sketchup::View
   # @example
   #   tooltip = view.tooltip = string
   #
-  # @param string
+  # @param [String] string
   #   The string tooltip.
   #
-  # @return tooltip - the new tooltip string
+  # @return [String] the new tooltip string
   #
   # @version SketchUp 6.0
   def tooltip=(string)
@@ -845,7 +854,7 @@ class Sketchup::View
   #   view = model.active_view
   #   height = view.vpheight
   #
-  # @return height - the height of the viewport in pixels.
+  # @return [Integer] the height of the viewport in pixels.
   #
   # @version SketchUp 6.0
   def vpheight
@@ -857,7 +866,7 @@ class Sketchup::View
   # @example
   #   width = view.vpwidth
   #
-  # @return width - the width of the viewport in pixels.
+  # @return [Integer] the width of the viewport in pixels.
   #
   # @version SketchUp 6.0
   def vpwidth
@@ -908,27 +917,28 @@ class Sketchup::View
   #   view = model.active_view
   #   view.write_image keys
   #
-  # @param [optional] width
-  #   Width in pixels.
+  # @overload write_image(filename, width = view.vpwidth, height = view.vpheight, antialias = false, compression = 1.0)
   #
-  # @param filename_or_hash
-  #   The filename for the saved image or a hash
-  #   containing a set of keys.
+  #   @param [String] filename
+  #     The filename for the saved image
+  #   @param [Integer] width
+  #     Width in pixels, defaults to the current viewport width {#vpwidth}.
+  #   @param [Integer] height
+  #     Height in pixels, defaults to the current viewport height {#vpheight}.
+  #   @param [Boolean] antialias
+  #     true or false
+  #   @param [Float] compression
+  #     Float compression factor for JPEG images,
+  #     between 0.0 and 1.0
   #
-  # @param [optional] height
-  #   Height in pixels.
+  # @overload write_image(options)
   #
-  # @param [optional] compression
-  #   Float compression factor for JPEG images,
-  #   between 0.0 and 1.0
+  #   @param [Hash] options
   #
-  # @param [optional] antialias
-  #   true or false
-  #
-  # @return nil
+  # @return [Boolean]
   #
   # @version SketchUp 6.0
-  def write_image(filename_or_hash, width, height, antialias, compression)
+  def write_image(*args)
   end
 
   # The zoom method is used to zoom in or out by some zoom factor.
@@ -939,11 +949,11 @@ class Sketchup::View
   #   view = view.zoom entity
   #   view = view.zoom array_of_entities
   #
-  # @param zoom_or_ents
+  # @param [Numeric, Sketchup::Selection, Sketchup::Entity, Array<Sketchup::Entity>] zoom_or_ents
   #   A Float zoom factor from 1.0 or larger or an Array or
   #   collection of entities to "zoom extents" around.
   #
-  # @return view - the zoomed View object
+  # @return [Sketchup::View] the zoomed View object
   #
   # @version SketchUp 6.0
   def zoom(zoom_or_ents)
@@ -956,7 +966,7 @@ class Sketchup::View
   #   view = Sketchup.active_model.active_view
   #   new_view = view.zoom_extents
   #
-  # @return new_view - the zoomed View object
+  # @return [Sketchup::View] the zoomed View object
   #
   # @version SketchUp 6.0
   def zoom_extents