sketchup-api-stubs 0.7.4 → 0.7.5

data/lib/sketchup-api-stubs/stubs/Layout/Pages.rb

@@ -1,204 +1,209 @@
-# Copyright:: Copyright 2020 Trimble Inc.
-# License:: The MIT License (MIT)
-
-# The Pages class is a container class for all pages in a {Layout::Document}.
-#
-# @example
-#   # Grab a handle to an existing LayOut document's pages.
-#   doc = Layout::Document.open("C:/path/to/document.layout")
-#   pages = doc.pages
-#
-#   # From here, we can add pages to or remove them from the document
-#   pages.add("New Page")
-#   pages.remove(pages[0])
-#
-# @version LayOut 2018
-class Layout::Pages
-
-  # Includes
-
-  include Enumerable
-
-  # Instance Methods
-
-  # The {#[]} method returns a value from the array of {Layout::Page}s.
-  #
-  # @example
-  #   doc = Layout::Document.open("C:/path/to/document.layout")
-  #   pages = doc.pages
-  #   page = pages[2]
-  #
-  # @param [Integer] index
-  #   The index of the {Layout::Page} to return.
-  #
-  # @raise [IndexError] if index is out of range
-  #
-  # @return [Layout::Page]
-  #
-  # @version LayOut 2018
-  def [](index)
-  end
-
-  # The {#add} method adds a new {Layout::Page} to the {Layout::Document}.
-  # The newly added {Layout::Page} will be the last one in the {Layout::Document}.
-  #
-  # @example
-  #   doc = Layout::Document.open("C:/path/to/document.layout")
-  #   pages = doc.pages
-  #   new_page = doc.add
-  #
-  # @param [String] name
-  #   The name for the new page.
-  #
-  # @return [Layout::Page] The newly added {Layout::Page}.
-  #
-  # @version LayOut 2018
-  def add(name = nil)
-  end
-
-  # The {#each} method iterates through all of the {Layout::Page}s.
-  #
-  # @example
-  #   doc = Layout::Document.open("C:/path/to/document.layout")
-  #   pages = doc.pages
-  #   pages.each { |page|
-  #     puts page.name
-  #   }
-  #
-  # @version LayOut 2018
-  #
-  # @yieldparam [Layout::Page] page
-  def each
-  end
-
-  # The {#index} method returns the index of the {Layout::Page}, or +nil+ if
-  # it doesn't exist in the {Layout::Document}.
-  #
-  # @example
-  #   doc = Layout::Document.open("C:/path/to/document.layout")
-  #   pages = doc.pages
-  #   page_index = pages.index(pages.first) # Returns 0
-  #
-  # @param [Layout::Page] page
-  #
-  # @return [Integer, nil]
-  #
-  # @version LayOut 2018
-  def index(page)
-  end
-
-  # The {#initial} method returns the initial {Layout::Page} that will be
-  # displayed the next time the {Layout::Document} is opened. This value will
-  # change whenever the {Layout::Page} is changed in the {Layout::Document} in
-  # LayOut.
-  #
-  # @example
-  #   doc = Layout::Document.open("C:/path/to/document.layout")
-  #   pages = doc.pages
-  #   page = pages.initial
-  #
-  # @return [Layout::Page]
-  #
-  # @version LayOut 2018
-  def initial
-  end
-
-  # The {#initial=} method sets the initial {Layout::Page} that will be
-  # displayed the next time the {Layout::Document} is opened. This value will
-  # change whenever the {Layout::Page} is changed in the {Layout::Document} in
-  # LayOut.
-  #
-  # @example
-  #   doc = Layout::Document.open("C:/path/to/document.layout")
-  #   pages = doc.pages
-  #   pages.initial = doc.pages[0]
-  #
-  # @overload initial=(page)
-  #
-  #   @param [Layout::Page] page The {Layout::Page} to set as the initial one
-  #
-  #   @raise [ArgumentError] if page does not belong to the {Layout::Document}
-  #
-  # @overload initial=(index)
-  #
-  #   @param [Integer] index The index of the {Layout::Page} to set as the
-  #     initial one
-  #
-  #   @raise [IndexError] if index is out of range
-  #
-  # @version LayOut 2018
-  def initial=(page)
-  end
-
-  # The {#length} method returns the number of {Layout::Page}s.
-  #
-  # @example
-  #   doc = Layout::Document.open("C:/path/to/document.layout")
-  #   pages = doc.pages
-  #   num_pages = pages.length
-  #
-  # @return [Integer]
-  #
-  # @version LayOut 2018
-  def length
-  end
-  alias_method :size, :length
-
-  # The {#remove} method deletes the given {Layout::Page} from the
-  # {Layout::Document}.
-  #
-  # @example
-  #   doc = Layout::Document.open("C:/path/to/document.layout")
-  #   pages = doc.pages
-  #   pages.remove(pages[0])
-  #
-  # @overload remove(page)
-  #
-  #   @param [Layout::Page] page The {Layout::Page} to be removed
-  #
-  #   @raise [ArgumentError] if the {Layout::Page} is not in the
-  #     {Layout::Document}
-  #   @raise [ArgumentError] if the {Layout::Page} is the only one in the
-  #     {Layout::Document}
-  #
-  # @overload remove(index)
-  #
-  #   @param [Integer] index The index of the {Layout::Page} to be removed
-  #
-  #   @raise [ArgumentError] if the {Layout::Page} is the only one in the
-  #     {Layout::Document}
-  #   @raise [IndexError] if index is out of range
-  #
-  # @version LayOut 2018
-  def remove(page)
-  end
-
-  # The {#reorder} method moves a {Layout::Page} to a different index within
-  # the {Layout::Document}'s list of pages. This will move the {Layout::Page}
-  # such that its new index becomes new_index.
-  #
-  # @example
-  #   doc = Layout::Document.open("C:/path/to/document.layout")
-  #   pages = doc.pages
-  #   pages.reorder(pages[1], 3)
-  #
-  # @overload reorder(page, new_index)
-  #
-  #   @param [Layout::Page] page The {Layout::Page} to be reordered
-  #   @param [Integer] new_index The index to put the {Layout::Page} at
-  #
-  #   @raise [ArgumentError] if the {Layout::Page} is not in the {Layout::Document}
-  #   @raise [IndexError] if new_index is out of range
-  #
-  # @overload reorder(index, new_index)
-  #
-  #   @param [Integer] index The index of the {Layout::Page} to be reordered
-  #   @param [Integer] new_index The index to put the {Layout::Page} at
-  #
-  #   @raise [IndexError] if index or new_index is out of range
-  #
-  # @version LayOut 2018
-  def reorder(page, new_index)
-  end
-
-end
+# Copyright:: Copyright 2020 Trimble Inc.
+# License:: The MIT License (MIT)
+
+# The Pages class is a container class for all pages in a {Layout::Document}.
+#
+# @example
+#   # Grab a handle to an existing LayOut document's pages.
+#   doc = Layout::Document.open("C:/path/to/document.layout")
+#   pages = doc.pages
+#
+#   # From here, we can add pages to or remove them from the document
+#   pages.add("New Page")
+#   pages.remove(pages[0])
+#
+# @version LayOut 2018
+class Layout::Pages
+
+  # Includes
+
+  include Enumerable
+
+  # Instance Methods
+
+  # The {#[]} method returns a value from the array of {Layout::Page}s.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   pages = doc.pages
+  #   page = pages[2]
+  #
+  # @param [Integer] index
+  #   The index of the {Layout::Page} to return.
+  #
+  # @raise [IndexError] if index is out of range
+  #
+  # @return [Layout::Page]
+  #
+  # @version LayOut 2018
+  def [](index)
+  end
+
+  # The {#add} method adds a new {Layout::Page} to the {Layout::Document}.
+  # The newly added {Layout::Page} will be the last one in the {Layout::Document}.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   pages = doc.pages
+  #   new_page = doc.add
+  #
+  # @param [String] name
+  #   The name for the new page.
+  #
+  # @return [Layout::Page] The newly added {Layout::Page}.
+  #
+  # @version LayOut 2018
+  def add(name = nil)
+  end
+
+  # The {#each} method iterates through all of the {Layout::Page}s.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   pages = doc.pages
+  #   pages.each { |page|
+  #     puts page.name
+  #   }
+  #
+  # @note Don't remove content from this collection while iterating over it with
+  #   {#each}. This would change the size of the collection and cause elements to
+  #   be skipped as the indices change. Instead copy the current collection to an
+  #   array using +to_a+ and then use +each+ on the array, when removing content.
+  #
+  # @version LayOut 2018
+  #
+  # @yieldparam [Layout::Page] page
+  def each
+  end
+
+  # The {#index} method returns the index of the {Layout::Page}, or +nil+ if
+  # it doesn't exist in the {Layout::Document}.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   pages = doc.pages
+  #   page_index = pages.index(pages.first) # Returns 0
+  #
+  # @param [Layout::Page] page
+  #
+  # @return [Integer, nil]
+  #
+  # @version LayOut 2018
+  def index(page)
+  end
+
+  # The {#initial} method returns the initial {Layout::Page} that will be
+  # displayed the next time the {Layout::Document} is opened. This value will
+  # change whenever the {Layout::Page} is changed in the {Layout::Document} in
+  # LayOut.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   pages = doc.pages
+  #   page = pages.initial
+  #
+  # @return [Layout::Page]
+  #
+  # @version LayOut 2018
+  def initial
+  end
+
+  # The {#initial=} method sets the initial {Layout::Page} that will be
+  # displayed the next time the {Layout::Document} is opened. This value will
+  # change whenever the {Layout::Page} is changed in the {Layout::Document} in
+  # LayOut.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   pages = doc.pages
+  #   pages.initial = doc.pages[0]
+  #
+  # @overload initial=(page)
+  #
+  #   @param [Layout::Page] page The {Layout::Page} to set as the initial one
+  #
+  #   @raise [ArgumentError] if page does not belong to the {Layout::Document}
+  #
+  # @overload initial=(index)
+  #
+  #   @param [Integer] index The index of the {Layout::Page} to set as the
+  #     initial one
+  #
+  #   @raise [IndexError] if index is out of range
+  #
+  # @version LayOut 2018
+  def initial=(page)
+  end
+
+  # The {#length} method returns the number of {Layout::Page}s.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   pages = doc.pages
+  #   num_pages = pages.length
+  #
+  # @return [Integer]
+  #
+  # @version LayOut 2018
+  def length
+  end
+  alias_method :size, :length
+
+  # The {#remove} method deletes the given {Layout::Page} from the
+  # {Layout::Document}.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   pages = doc.pages
+  #   pages.remove(pages[0])
+  #
+  # @overload remove(page)
+  #
+  #   @param [Layout::Page] page The {Layout::Page} to be removed
+  #
+  #   @raise [ArgumentError] if the {Layout::Page} is not in the
+  #     {Layout::Document}
+  #   @raise [ArgumentError] if the {Layout::Page} is the only one in the
+  #     {Layout::Document}
+  #
+  # @overload remove(index)
+  #
+  #   @param [Integer] index The index of the {Layout::Page} to be removed
+  #
+  #   @raise [ArgumentError] if the {Layout::Page} is the only one in the
+  #     {Layout::Document}
+  #   @raise [IndexError] if index is out of range
+  #
+  # @version LayOut 2018
+  def remove(page)
+  end
+
+  # The {#reorder} method moves a {Layout::Page} to a different index within
+  # the {Layout::Document}'s list of pages. This will move the {Layout::Page}
+  # such that its new index becomes new_index.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   pages = doc.pages
+  #   pages.reorder(pages[1], 3)
+  #
+  # @overload reorder(page, new_index)
+  #
+  #   @param [Layout::Page] page The {Layout::Page} to be reordered
+  #   @param [Integer] new_index The index to put the {Layout::Page} at
+  #
+  #   @raise [ArgumentError] if the {Layout::Page} is not in the {Layout::Document}
+  #   @raise [IndexError] if new_index is out of range
+  #
+  # @overload reorder(index, new_index)
+  #
+  #   @param [Integer] index The index of the {Layout::Page} to be reordered
+  #   @param [Integer] new_index The index to put the {Layout::Page} at
+  #
+  #   @raise [IndexError] if index or new_index is out of range
+  #
+  # @version LayOut 2018
+  def reorder(page, new_index)
+  end
+
+end

data/lib/sketchup-api-stubs/stubs/Layout/Path.rb

@@ -1,344 +1,344 @@
-# Copyright:: Copyright 2020 Trimble Inc.
-# License:: The MIT License (MIT)
-
-# A path entity represents a continuous, multi-segment polyline or bezier
-# curve.
-#
-# @version LayOut 2018
-class Layout::Path < Layout::Entity
-
-  # Constants
-
-  POINT_TYPE_ARC_CENTER = nil # Stub value.
-  POINT_TYPE_BEZIER_CONTROL = nil # Stub value.
-  POINT_TYPE_BEZIER_TO = nil # Stub value.
-  POINT_TYPE_CLOSE = nil # Stub value.
-  POINT_TYPE_LINE_TO = nil # Stub value.
-  POINT_TYPE_MOVE_TO = nil # Stub value.
-
-  PATH_WINDING_CLOCKWISE = nil # Stub value.
-  PATH_WINDING_COUNTER_CLOCKWISE = nil # Stub value.
-  PATH_WINDING_NONE = nil # Stub value.
-
-  # Class Methods
-
-  # The {.new_arc} method creates a new arc-shaped {Layout::Path}.
-  #
-  # @example
-  #   center = Geom::Point2d.new(5, 5)
-  #   radius = 2.0
-  #   start_angle = 180.0
-  #   end_angle = 360.0
-  #   arc = Layout::Path.new_arc(center, radius, start_angle, end_angle)
-  #
-  # @param [Geom::Point2d] center_point
-  #
-  # @param [Float] radius
-  #
-  # @param [Float] start_angle
-  #
-  # @param [Float] end_angle
-  #
-  # @raise [ArgumentError] if radius is less than or equal to zero
-  #
-  # @raise [ArgumentError] if start angle is equal to end angle
-  #
-  # @return [Layout::Path] an arc path
-  #
-  # @version LayOut 2018
-  def self.new_arc(center_point, radius, start_angle, end_angle)
-  end
-
-  # Instance Methods
-
-  # The {#append_point} method appends a {Geom::Point2d} to the end of the
-  # {Layout::Path}.
-  #
-  # @example
-  #   point = Geom::Point2d.new(2, 5)
-  #   path.append_point(point)
-  #
-  # @overload append_point(point)
-  #
-  #   @param  [Geom::Point2d] point
-  #   @return [Layout::Path]
-  #
-  # @overload append_point(control_point1, control_point2, point)
-  #
-  #   @param  [Geom::Point2d] control_point1 The first bezier control point
-  #   @param  [Geom::Point2d] control_point2 The second bezier control point
-  #   @param  [Geom::Point2d] point The point to append
-  #   @return [Layout::Path]
-  #
-  # @raise [LockedLayerError] if the {Layout::Path} is on a locked {Layout::Layer}
-  #
-  # @raise [LockedEntityError] if the {Layout::Path} is locked
-  #
-  # @version LayOut 2018
-  def append_point(*args)
-  end
-
-  # The {#arc} method returns the parameters of an arc from the {Layout::Path},
-  # or +nil+ if path is not an arc.
-  #
-  # @example
-  #   start_angle, radius, start, end = path.arc
-  #
-  # @return [Array(Geom::Point2d, Float, Float, Float), nil] The center point,
-  #   radius, start angle, and end angle
-  #
-  # @version LayOut 2018
-  def arc
-  end
-
-  # The {#circle} method returns the parameters of a circle from the
-  # {Layout::Path}, or +nil+ if path is not a circle.
-  #
-  # @example
-  #   center_point, radius = path.circle
-  #
-  # @return [Array(Geom::Point2d, Float), nil] The center point and the radius
-  #
-  # @version LayOut 2018
-  def circle
-  end
-
-  # The {#close} method closes the {Layout::Path}.
-  #
-  # @example
-  #   path.close
-  #
-  # @raise [LockedLayerError] if the {Layout::Path} is on a locked
-  #   {Layout::Layer}
-  #
-  # @raise [ArgumentError] if the {Layout::Path} can not be closed becauase it
-  #   contains less than three points.
-  #
-  # @raise [LockedEntityError] if the {Layout::Path} is locked
-  #
-  # @version LayOut 2018
-  def close
-  end
-
-  # The {#closed?} method returns whether the {Layout::Path} is closed.
-  #
-  # @example
-  #   is_closed = path.closed?
-  #
-  # @return [Boolean]
-  #
-  # @version LayOut 2018
-  def closed?
-  end
-
-  # The {#end_arrow} method creates a new {Layout::Path} from an end arrow.
-  #
-  # @example
-  #   path = Layout::Path.end_arrow(path_with_end_arrow)
-  #
-  # @return [Layout::Path, nil] The end arrow
-  #
-  # @version LayOut 2018
-  def end_arrow
-  end
-
-  # The {#end_point} method returns the end point of the {Layout::Path}.
-  #
-  # @example
-  #   start_point = Geom::Point2d.new(1, 1)
-  #   end_point = Geom::Point2d.new(2, 2)
-  #   path = Layout::Path.new(start_point, end_point)
-  #   # should be equal to end_point
-  #   endp = path.end_point
-  #
-  # @return [Geom::Point2d]
-  #
-  # @version LayOut 2018
-  def end_point
-  end
-
-  # The {#initialize} method creates a new {Layout::Path} between a start point
-  # and an end point, or from a provided {Layout::Rectangle} or
-  # {Layout::Ellipse}.
-  #
-  # @example
-  #   start = Geom::Point2d.new(1, 1)
-  #   end = Geom::Point2d.new(2, 2)
-  #   new_path = Layout::Path.new(start, end)
-  #
-  # @example
-  #   start = Geom::Point2d.new(1, 1)
-  #   control_1 = Geom::Point2d.new(1.5, 1)
-  #   control_2 = Geom::Point2d.new(1, 1.5)
-  #   end = Geom::Point2d.new(2, 2)
-  #   new_path = Layout::Path.new(start, control_1, control_2, end)
-  #
-  # @overload initialize(start_point, end_point)
-  #
-  #   @param [Geom::Point2D] start_point
-  #   @param [Geom::Point2D] end_point
-  #   @return [Layout::Path] a straight path
-  #
-  #   @raise [ArgumentError] if the length between start point and end point is
-  #     zero
-  #
-  # @overload initialize(start_point, control_point_1, control_point_2, end_point)
-  #
-  #   @param [Geom::Point2D] start_point
-  #   @param [Geom::Point2D] control_point_1 The first bezier control point
-  #   @param [Geom::Point2D] control_point_2 The second bezier control point
-  #   @param [Geom::Point2D] end_point
-  #   @return [Layout::Path] a bezier path
-  #
-  #   @raise [ArgumentError] if the length between start point and end point is
-  #     zero
-  #
-  # @overload initialize(rectangle)
-  #
-  #   @param [Layout::Rectangle] rectangle
-  #   @return [Layout::Path] a path created from the {Layout::Rectangle}
-  #
-  #   @raise [TypeError] if rectangle is not a {Layout::Rectangle}
-  #
-  # @overload initialize(ellipse)
-  #
-  #   @param [Layout::Ellipse] ellipse
-  #   @return [Layout::Path] a path created from the {Layout::Ellipse}
-  #
-  #   @raise [TypeError] if ellipse is not an {Layout::Ellipse}
-  #
-  # @version LayOut 2018
-  def initialize(*args)
-  end
-
-  # The {#parametric_length} method returns the parametric length for the
-  # {Layout::Path}. The parametric length is the length with respect to the curve
-  # of the {Layout::Path}.
-  #
-  # @example
-  #   length = path.parametric_length
-  #
-  # @return [Float]
-  #
-  # @version LayOut 2018
-  def parametric_length
-  end
-
-  # The {#point_at} method returns the {Geom::Point2d} at a given parametric
-  # value.
-  #
-  # @example
-  #   length = path.parametric_length
-  #   # Get the point halfway along the path
-  #   halfway_point = path.point_at(length/2)
-  #
-  # @param [Float] parametric_value
-  #
-  # @raise [ArgumentError] if the parametric value is less than zero or greater
-  #   than the {Layout::Path}'s parametric length
-  #
-  # @return [Geom::Point2d]
-  #
-  # @version LayOut 2018
-  def point_at(parametric_value)
-  end
-
-  # The {#point_types} method returns an array of point types corresponding to
-  # the {Geom::Point2d}s in the {Layout::Path}.
-  #
-  # A point type can be one of the following values:
-  # [+POINT_TYPE_MOVE_TO+]
-  # [+POINT_TYPE_LINE_TO+]
-  # [+POINT_TYPE_BEZIER_TO+]
-  # [+POINT_TYPE_ARC_CENTER+]
-  # [+POINT_TYPE_BEZIER_CONTROL+]
-  # [+POINT_TYPE_CLOSE+]
-  #
-  # @example
-  #   types = path.point_types
-  #
-  # @return [Array<Integer>] An array of integers that correspond with point types.
-  #
-  # @version LayOut 2018
-  def point_types
-  end
-
-  # The {#points} method returns an array of {Geom::Point2d}s in the
-  # {Layout::Path}.
-  #
-  # @example
-  #   start_point = Geom::Point2d.new(1, 1)
-  #   end_point = Geom::Point2d.new(2, 2)
-  #   new_path = Layout::Path.new(start_point, end_point)
-  #   # Should be an array with points [1, 1] and [2, 2]
-  #   points = new_path.points
-  #
-  # @return [Array<Geom::Point2d>]
-  #
-  # @version LayOut 2018
-  def points
-  end
-
-  # The {#start_arrow} method creates a new {Layout::Path} from a start
-  # arrow.
-  #
-  # @example
-  #   start_arrow = path.start_arrow
-  #
-  # @return [Layout::Path, nil] The start arrow
-  #
-  # @version LayOut 2018
-  def start_arrow
-  end
-
-  # The {#start_point} method returns the start point of the {Layout::Path}.
-  #
-  # @example
-  #   start_point = Geom::Point2d.new(1, 1)
-  #   end_point = Geom::Point2d.new(2, 2)
-  #   path = Layout::Path.new(start_point, end_point)
-  #   # should be equal to start_point
-  #   start = path.start_point
-  #
-  # @return [Geom::Point2d]
-  #
-  # @version LayOut 2018
-  def start_point
-  end
-
-  # The {#tangent_at} method returns the tangent {Geom::Vector2d} at the given
-  # parametric value.
-  #
-  # @example
-  #   length = path.parametric_length
-  #   # Get the tangent halfway along the path
-  #   halfway_tangent = path.tangent_at(length/2)
-  #
-  # @param [Float] parametric_value
-  #
-  # @raise [ArgumentError] if the parametric value is less than zero or greater
-  #   than the {Layout::Path}'s parametric length
-  #
-  # @return [Geom::Vector2d]
-  #
-  # @version LayOut 2018
-  def tangent_at(parametric_value)
-  end
-
-  # The {#winding} method returns the winding type of the {Layout::Path}.
-  #
-  # A point type can be one of the following values:
-  # [+PATH_WINDING_NONE+]
-  # [+PATH_WINDING_CLOCKWISE+]
-  # [+PATH_WINDING_COUNTER_CLOCKWISE+]
-  #
-  # @example
-  #   winding = path.winding
-  #
-  # @return [Integer]
-  #
-  # @version LayOut 2019
-  def winding
-  end
-
-end
+# Copyright:: Copyright 2020 Trimble Inc.
+# License:: The MIT License (MIT)
+
+# A path entity represents a continuous, multi-segment polyline or bezier
+# curve.
+#
+# @version LayOut 2018
+class Layout::Path < Layout::Entity
+
+  # Constants
+
+  POINT_TYPE_ARC_CENTER = nil # Stub value.
+  POINT_TYPE_BEZIER_CONTROL = nil # Stub value.
+  POINT_TYPE_BEZIER_TO = nil # Stub value.
+  POINT_TYPE_CLOSE = nil # Stub value.
+  POINT_TYPE_LINE_TO = nil # Stub value.
+  POINT_TYPE_MOVE_TO = nil # Stub value.
+
+  PATH_WINDING_CLOCKWISE = nil # Stub value.
+  PATH_WINDING_COUNTER_CLOCKWISE = nil # Stub value.
+  PATH_WINDING_NONE = nil # Stub value.
+
+  # Class Methods
+
+  # The {.new_arc} method creates a new arc-shaped {Layout::Path}.
+  #
+  # @example
+  #   center = Geom::Point2d.new(5, 5)
+  #   radius = 2.0
+  #   start_angle = 180.0
+  #   end_angle = 360.0
+  #   arc = Layout::Path.new_arc(center, radius, start_angle, end_angle)
+  #
+  # @param [Geom::Point2d] center_point
+  #
+  # @param [Float] radius
+  #
+  # @param [Float] start_angle
+  #
+  # @param [Float] end_angle
+  #
+  # @raise [ArgumentError] if radius is less than or equal to zero
+  #
+  # @raise [ArgumentError] if start angle is equal to end angle
+  #
+  # @return [Layout::Path] an arc path
+  #
+  # @version LayOut 2018
+  def self.new_arc(center_point, radius, start_angle, end_angle)
+  end
+
+  # Instance Methods
+
+  # The {#append_point} method appends a {Geom::Point2d} to the end of the
+  # {Layout::Path}.
+  #
+  # @example
+  #   point = Geom::Point2d.new(2, 5)
+  #   path.append_point(point)
+  #
+  # @overload append_point(point)
+  #
+  #   @param  [Geom::Point2d] point
+  #   @return [Layout::Path]
+  #
+  # @overload append_point(control_point1, control_point2, point)
+  #
+  #   @param  [Geom::Point2d] control_point1 The first bezier control point
+  #   @param  [Geom::Point2d] control_point2 The second bezier control point
+  #   @param  [Geom::Point2d] point The point to append
+  #   @return [Layout::Path]
+  #
+  # @raise [LockedLayerError] if the {Layout::Path} is on a locked {Layout::Layer}
+  #
+  # @raise [LockedEntityError] if the {Layout::Path} is locked
+  #
+  # @version LayOut 2018
+  def append_point(*args)
+  end
+
+  # The {#arc} method returns the parameters of an arc from the {Layout::Path},
+  # or +nil+ if path is not an arc.
+  #
+  # @example
+  #   start_angle, radius, start, end = path.arc
+  #
+  # @return [Array(Geom::Point2d, Float, Float, Float), nil] The center point,
+  #   radius, start angle, and end angle
+  #
+  # @version LayOut 2018
+  def arc
+  end
+
+  # The {#circle} method returns the parameters of a circle from the
+  # {Layout::Path}, or +nil+ if path is not a circle.
+  #
+  # @example
+  #   center_point, radius = path.circle
+  #
+  # @return [Array(Geom::Point2d, Float), nil] The center point and the radius
+  #
+  # @version LayOut 2018
+  def circle
+  end
+
+  # The {#close} method closes the {Layout::Path}.
+  #
+  # @example
+  #   path.close
+  #
+  # @raise [LockedLayerError] if the {Layout::Path} is on a locked
+  #   {Layout::Layer}
+  #
+  # @raise [ArgumentError] if the {Layout::Path} can not be closed becauase it
+  #   contains less than three points.
+  #
+  # @raise [LockedEntityError] if the {Layout::Path} is locked
+  #
+  # @version LayOut 2018
+  def close
+  end
+
+  # The {#closed?} method returns whether the {Layout::Path} is closed.
+  #
+  # @example
+  #   is_closed = path.closed?
+  #
+  # @return [Boolean]
+  #
+  # @version LayOut 2018
+  def closed?
+  end
+
+  # The {#end_arrow} method creates a new {Layout::Path} from an end arrow.
+  #
+  # @example
+  #   path = Layout::Path.end_arrow(path_with_end_arrow)
+  #
+  # @return [Layout::Path, nil] The end arrow
+  #
+  # @version LayOut 2018
+  def end_arrow
+  end
+
+  # The {#end_point} method returns the end point of the {Layout::Path}.
+  #
+  # @example
+  #   start_point = Geom::Point2d.new(1, 1)
+  #   end_point = Geom::Point2d.new(2, 2)
+  #   path = Layout::Path.new(start_point, end_point)
+  #   # should be equal to end_point
+  #   endp = path.end_point
+  #
+  # @return [Geom::Point2d]
+  #
+  # @version LayOut 2018
+  def end_point
+  end
+
+  # The {#initialize} method creates a new {Layout::Path} between a start point
+  # and an end point, or from a provided {Layout::Rectangle} or
+  # {Layout::Ellipse}.
+  #
+  # @example
+  #   start = Geom::Point2d.new(1, 1)
+  #   end = Geom::Point2d.new(2, 2)
+  #   new_path = Layout::Path.new(start, end)
+  #
+  # @example
+  #   start = Geom::Point2d.new(1, 1)
+  #   control_1 = Geom::Point2d.new(1.5, 1)
+  #   control_2 = Geom::Point2d.new(1, 1.5)
+  #   end = Geom::Point2d.new(2, 2)
+  #   new_path = Layout::Path.new(start, control_1, control_2, end)
+  #
+  # @overload initialize(start_point, end_point)
+  #
+  #   @param [Geom::Point2D] start_point
+  #   @param [Geom::Point2D] end_point
+  #   @return [Layout::Path] a straight path
+  #
+  #   @raise [ArgumentError] if the length between start point and end point is
+  #     zero
+  #
+  # @overload initialize(start_point, control_point_1, control_point_2, end_point)
+  #
+  #   @param [Geom::Point2D] start_point
+  #   @param [Geom::Point2D] control_point_1 The first bezier control point
+  #   @param [Geom::Point2D] control_point_2 The second bezier control point
+  #   @param [Geom::Point2D] end_point
+  #   @return [Layout::Path] a bezier path
+  #
+  #   @raise [ArgumentError] if the length between start point and end point is
+  #     zero
+  #
+  # @overload initialize(rectangle)
+  #
+  #   @param [Layout::Rectangle] rectangle
+  #   @return [Layout::Path] a path created from the {Layout::Rectangle}
+  #
+  #   @raise [TypeError] if rectangle is not a {Layout::Rectangle}
+  #
+  # @overload initialize(ellipse)
+  #
+  #   @param [Layout::Ellipse] ellipse
+  #   @return [Layout::Path] a path created from the {Layout::Ellipse}
+  #
+  #   @raise [TypeError] if ellipse is not an {Layout::Ellipse}
+  #
+  # @version LayOut 2018
+  def initialize(*args)
+  end
+
+  # The {#parametric_length} method returns the parametric length for the
+  # {Layout::Path}. The parametric length is the length with respect to the curve
+  # of the {Layout::Path}.
+  #
+  # @example
+  #   length = path.parametric_length
+  #
+  # @return [Float]
+  #
+  # @version LayOut 2018
+  def parametric_length
+  end
+
+  # The {#point_at} method returns the {Geom::Point2d} at a given parametric
+  # value.
+  #
+  # @example
+  #   length = path.parametric_length
+  #   # Get the point halfway along the path
+  #   halfway_point = path.point_at(length/2)
+  #
+  # @param [Float] parametric_value
+  #
+  # @raise [ArgumentError] if the parametric value is less than zero or greater
+  #   than the {Layout::Path}'s parametric length
+  #
+  # @return [Geom::Point2d]
+  #
+  # @version LayOut 2018
+  def point_at(parametric_value)
+  end
+
+  # The {#point_types} method returns an array of point types corresponding to
+  # the {Geom::Point2d}s in the {Layout::Path}.
+  #
+  # A point type can be one of the following values:
+  # [+POINT_TYPE_MOVE_TO+]
+  # [+POINT_TYPE_LINE_TO+]
+  # [+POINT_TYPE_BEZIER_TO+]
+  # [+POINT_TYPE_ARC_CENTER+]
+  # [+POINT_TYPE_BEZIER_CONTROL+]
+  # [+POINT_TYPE_CLOSE+]
+  #
+  # @example
+  #   types = path.point_types
+  #
+  # @return [Array<Integer>] An array of integers that correspond with point types.
+  #
+  # @version LayOut 2018
+  def point_types
+  end
+
+  # The {#points} method returns an array of {Geom::Point2d}s in the
+  # {Layout::Path}.
+  #
+  # @example
+  #   start_point = Geom::Point2d.new(1, 1)
+  #   end_point = Geom::Point2d.new(2, 2)
+  #   new_path = Layout::Path.new(start_point, end_point)
+  #   # Should be an array with points [1, 1] and [2, 2]
+  #   points = new_path.points
+  #
+  # @return [Array<Geom::Point2d>]
+  #
+  # @version LayOut 2018
+  def points
+  end
+
+  # The {#start_arrow} method creates a new {Layout::Path} from a start
+  # arrow.
+  #
+  # @example
+  #   start_arrow = path.start_arrow
+  #
+  # @return [Layout::Path, nil] The start arrow
+  #
+  # @version LayOut 2018
+  def start_arrow
+  end
+
+  # The {#start_point} method returns the start point of the {Layout::Path}.
+  #
+  # @example
+  #   start_point = Geom::Point2d.new(1, 1)
+  #   end_point = Geom::Point2d.new(2, 2)
+  #   path = Layout::Path.new(start_point, end_point)
+  #   # should be equal to start_point
+  #   start = path.start_point
+  #
+  # @return [Geom::Point2d]
+  #
+  # @version LayOut 2018
+  def start_point
+  end
+
+  # The {#tangent_at} method returns the tangent {Geom::Vector2d} at the given
+  # parametric value.
+  #
+  # @example
+  #   length = path.parametric_length
+  #   # Get the tangent halfway along the path
+  #   halfway_tangent = path.tangent_at(length/2)
+  #
+  # @param [Float] parametric_value
+  #
+  # @raise [ArgumentError] if the parametric value is less than zero or greater
+  #   than the {Layout::Path}'s parametric length
+  #
+  # @return [Geom::Vector2d]
+  #
+  # @version LayOut 2018
+  def tangent_at(parametric_value)
+  end
+
+  # The {#winding} method returns the winding type of the {Layout::Path}.
+  #
+  # A point type can be one of the following values:
+  # [+PATH_WINDING_NONE+]
+  # [+PATH_WINDING_CLOCKWISE+]
+  # [+PATH_WINDING_COUNTER_CLOCKWISE+]
+  #
+  # @example
+  #   winding = path.winding
+  #
+  # @return [Integer]
+  #
+  # @version LayOut 2019
+  def winding
+  end
+
+end