sketchup-api-stubs 0.6.1 → 0.7.4

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

@@ -1,29 +1,29 @@
-# Copyright:: Copyright 2019 Trimble Inc.
-# License:: The MIT License (MIT)
-
-# A simple elliptical shape entity.
-#
-# @version LayOut 2018
-class Layout::Ellipse < Layout::Entity
-
-  # Instance Methods
-
-  # The {#initialize} method creates a new {Layout::Ellipse}.
-  #
-  # @example
-  #   upper_left = Geom::Point2d.new(1, 1)
-  #   lower_right = Geom::Point2d.new(2, 2)
-  #   bounds = Geom::Bounds2d.new(upper_left, lower_right)
-  #   ellipse = Layout::Ellipse.new(bounds)
-  #
-  # @param [Geom::Bounds2d] bounds
-  #
-  # @raise ArgumentError if bounds is zero size
-  #
-  # @return [Layout::Ellipse]
-  #
-  # @version LayOut 2018
-  def initialize(bounds)
-  end
-
-end
+# Copyright:: Copyright 2020 Trimble Inc.
+# License:: The MIT License (MIT)
+
+# A simple elliptical shape entity.
+#
+# @version LayOut 2018
+class Layout::Ellipse < Layout::Entity
+
+  # Instance Methods
+
+  # The {#initialize} method creates a new {Layout::Ellipse}.
+  #
+  # @example
+  #   upper_left = Geom::Point2d.new(1, 1)
+  #   lower_right = Geom::Point2d.new(2, 2)
+  #   bounds = Geom::Bounds2d.new(upper_left, lower_right)
+  #   ellipse = Layout::Ellipse.new(bounds)
+  #
+  # @param [Geom::Bounds2d] bounds
+  #
+  # @raise ArgumentError if bounds is zero size
+  #
+  # @return [Layout::Ellipse]
+  #
+  # @version LayOut 2018
+  def initialize(bounds)
+  end
+
+end

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

@@ -1,155 +1,143 @@
-# Copyright:: Copyright 2019 Trimble Inc.
-# License:: The MIT License (MIT)
-
-# The Entities class is a container class for {Layout::Entity}s. A
-# {Layout::Entities} object is different from a SketchUp::Entities object in
-# that it is read-only. Adding or removing {Layout::Entity}s from a
-# {Layout::Document} happens with the {Layout::Document#add_entity} and
-# {Layout::Document#remove_entity} methods.
-#
-# The {Layout::Entities} from {Layout::AngularDimension#entities},
-# {Layout::Label#entities}, {Layout::LinearDimension#entities}, or
-# {Layout::Table#entities} contains the {Layout::Entity}s that represent the
-# {Layout::Entity} in its exploded form.
-#
-# The {Layout::Entities} from {Layout::Group#entities} contains all the
-# {Layout::Entity}s that belong to the {Layout::Group}.
-#
-# The {Layout::Entities} from {Layout::Page#entities} contains all of the
-# {Layout::Entity}s on both shared and non-shared {Layout::Layer}s. This class
-# is used to iterate through the {Layout::Entity}s in draw order or pick order
-# (reverse draw order) using the {#each} and {#reverse_each} methods.
-#
-# The {Layout::Entities} from {Layout::Document#shared_entities} contains all
-# of the {Layout::Entity}s that belong on all shared {Layout::Layer}s.
-#
-# The {Layout::Entities} from {Layout::Page#nonshared_entities} contains all of
-# the {Layout::Entity}s that belong to that {Layout::Page}.
-#
-# The {Layout::Entities} from {Layout::LayerInstance#entities} contains all of
-# the {Layout::Entity}s that belong on that {Layout::LayerInstance}.
-#
-# @example
-#   # Grab a handle to a pages entities
-#   doc = Layout::Document.open("C:/path/to/document.layout")
-#   entities = doc.pages.first.entities
-#
-#   # From here, we can iterate over the entities in draw order or pick order
-#   entities.each { |entity|
-#     puts entity
-#   }
-#   entities.reverse_each(skip_locked: true) { |entity|
-#     puts entity
-#   }
-#
-# @version LayOut 2018
-class Layout::Entities
-
-  # Includes
-
-  include Enumerable
-
-  # Instance Methods
-
-  # The {#[]} method returns the {Layout::Entity} at the given index. This method
-  # is not valid for use when the {Layout::Entities} object came from a
-  # {Layout::Page}.
-  #
-  # @example
-  #   table = Layout::Table.new([1, 1, 4, 4], 4, 4)
-  #   entities = table.entities
-  #   entity = entities[10]
-  #
-  # @param [Integer] index
-  #
-  # @raise [ArgumentError] if this came from a {Layout::Page}
-  #
-  # @return [Layout::Entity]
-  #
-  # @version LayOut 2018
-  def [](index)
-  end
-
-  # The {#each} method iterates through all of the {Layout::Entity}s. When
-  # iterating over a {Layout::LayerInstance}'s {Layout::Entities}, it is not
-  # necessary to provide a flags Hash. When iterating over a {Layout::Page}'s
-  # {Layout::Entities}, the flags Hash is optional; providing no Hash will
-  # result in iterating over all {Layout::Entity}s, including those on hidden or
-  # locked {Layout::Layer}s. Valid symbols for the Hash are +:skip_hidden+ and
-  # +:skip_locked+.
-  #
-  # @example
-  #   doc = Layout::Document.open("C:/path/to/document.layout")
-  #   flags = { :skip_hidden => true }
-  #   entities = doc.pages.first.entities
-  #   entities.each(flags) { |entity|
-  #     puts entity
-  #   }
-  #
-  # @param [Hash{Symbol => Boolean}] flags
-  #   A hash that allows skipping of
-  #   {Layout::Entity}s on hidden or locked {Layout::Layers}
-  #
-  # @version LayOut 2018
-  #
-  # @yieldparam [Layout::Entity] entity
-  def each(flags = {})
-  end
-
-  # The {#length} method returns the number of {Layout::Entity}s.
-  #
-  # @example
-  #   doc = Layout::Document.open("C:/path/to/document.layout")
-  #   entities = doc.shared_entities
-  #   num_entities = entities.length
-  #
-  # @return [Integer]
-  #
-  # @version LayOut 2018
-  def length
-  end
-
-  # The {#reverse_each} method iterates through all of the {Layout::Entity}s in
-  # reverse order. When iterating over a {Layout::LayerInstance}'s
-  # {Layout::Entities}, it is not necessary to provide a flags Hash. When
-  # iterating over a {Layout::Page}'s {Layout::Entities}, the flags Hash is
-  # optional; providing no Hash will result in iterating over all
-  # {Layout::Entity}s, including those on hidden or locked {Layout::Layer}s.
-  # Valid symbols for the Hash are +:skip_hidden+ and +:skip_locked+.
-  #
-  # @example
-  #   doc = Layout::Document.open("C:/path/to/document.layout")
-  #   flags = { :skip_hidden => true, :skip_locked => true }
-  #   entities = doc.pages.first.entities
-  #   entities.reverse_each(flags) { |entity|
-  #     puts entity
-  #   }
-  #
-  # @overload reverse_each
-  #
-  #   @yieldparam [Layout::Entity] entity
-  #
-  # @overload reverse_each(flags)
-  #
-  #   @param [Hash{Symbol => Boolean}] flags A hash that allows skipping of
-  #     {Layout::Entity}s on hidden or locked {Layout::Layers}.
-  #   @yieldparam [Layout::Entity] entity
-  #
-  # @version LayOut 2018
-  def reverse_each(*args)
-  end
-
-  # The {#length} method returns the number of {Layout::Entity}s.
-  #
-  # @example
-  #   doc = Layout::Document.open("C:/path/to/document.layout")
-  #   entities = doc.shared_entities
-  #   num_entities = entities.length
-  #
-  # @return [Integer]
-  #
-  # @version LayOut 2018
-  def size
-  end
-
-end
+# Copyright:: Copyright 2020 Trimble Inc.
+# License:: The MIT License (MIT)
+
+# The Entities class is a container class for {Layout::Entity}s. A
+# {Layout::Entities} object is different from a SketchUp::Entities object in
+# that it is read-only. Adding or removing {Layout::Entity}s from a
+# {Layout::Document} happens with the {Layout::Document#add_entity} and
+# {Layout::Document#remove_entity} methods.
+#
+# The {Layout::Entities} from {Layout::AngularDimension#entities},
+# {Layout::Label#entities}, {Layout::LinearDimension#entities}, or
+# {Layout::Table#entities} contains the {Layout::Entity}s that represent the
+# {Layout::Entity} in its exploded form.
+#
+# The {Layout::Entities} from {Layout::Group#entities} contains all the
+# {Layout::Entity}s that belong to the {Layout::Group}.
+#
+# The {Layout::Entities} from {Layout::Page#entities} contains all of the
+# {Layout::Entity}s on both shared and non-shared {Layout::Layer}s. This class
+# is used to iterate through the {Layout::Entity}s in draw order or pick order
+# (reverse draw order) using the {#each} and {#reverse_each} methods.
+#
+# The {Layout::Entities} from {Layout::Document#shared_entities} contains all
+# of the {Layout::Entity}s that belong on all shared {Layout::Layer}s.
+#
+# The {Layout::Entities} from {Layout::Page#nonshared_entities} contains all of
+# the {Layout::Entity}s that belong to that {Layout::Page}.
+#
+# The {Layout::Entities} from {Layout::LayerInstance#entities} contains all of
+# the {Layout::Entity}s that belong on that {Layout::LayerInstance}.
+#
+# @example
+#   # Grab a handle to a pages entities
+#   doc = Layout::Document.open("C:/path/to/document.layout")
+#   entities = doc.pages.first.entities
+#
+#   # From here, we can iterate over the entities in draw order or pick order
+#   entities.each { |entity|
+#     puts entity
+#   }
+#   entities.reverse_each(skip_locked: true) { |entity|
+#     puts entity
+#   }
+#
+# @version LayOut 2018
+class Layout::Entities
+
+  # Includes
+
+  include Enumerable
+
+  # Instance Methods
+
+  # The {#[]} method returns the {Layout::Entity} at the given index. This method
+  # is not valid for use when the {Layout::Entities} object came from a
+  # {Layout::Page}.
+  #
+  # @example
+  #   table = Layout::Table.new([1, 1, 4, 4], 4, 4)
+  #   entities = table.entities
+  #   entity = entities[10]
+  #
+  # @param [Integer] index
+  #
+  # @raise [ArgumentError] if this came from a {Layout::Page}
+  #
+  # @return [Layout::Entity]
+  #
+  # @version LayOut 2018
+  def [](index)
+  end
+
+  # The {#each} method iterates through all of the {Layout::Entity}s. When
+  # iterating over a {Layout::LayerInstance}'s {Layout::Entities}, it is not
+  # necessary to provide a flags Hash. When iterating over a {Layout::Page}'s
+  # {Layout::Entities}, the flags Hash is optional; providing no Hash will
+  # result in iterating over all {Layout::Entity}s, including those on hidden or
+  # locked {Layout::Layer}s. Valid symbols for the Hash are +:skip_hidden+ and
+  # +:skip_locked+.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   flags = { :skip_hidden => true }
+  #   entities = doc.pages.first.entities
+  #   entities.each(flags) { |entity|
+  #     puts entity
+  #   }
+  #
+  # @param [Hash{Symbol => Boolean}] flags
+  #   A hash that allows skipping of
+  #   {Layout::Entity}s on hidden or locked {Layout::Layers}
+  #
+  # @version LayOut 2018
+  #
+  # @yieldparam [Layout::Entity] entity
+  def each(flags = {})
+  end
+
+  # The {#length} method returns the number of {Layout::Entity}s.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   entities = doc.shared_entities
+  #   num_entities = entities.length
+  #
+  # @return [Integer]
+  #
+  # @version LayOut 2018
+  def length
+  end
+  alias_method :size, :length
+
+  # The {#reverse_each} method iterates through all of the {Layout::Entity}s in
+  # reverse order. When iterating over a {Layout::LayerInstance}'s
+  # {Layout::Entities}, it is not necessary to provide a flags Hash. When
+  # iterating over a {Layout::Page}'s {Layout::Entities}, the flags Hash is
+  # optional; providing no Hash will result in iterating over all
+  # {Layout::Entity}s, including those on hidden or locked {Layout::Layer}s.
+  # Valid symbols for the Hash are +:skip_hidden+ and +:skip_locked+.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   flags = { :skip_hidden => true, :skip_locked => true }
+  #   entities = doc.pages.first.entities
+  #   entities.reverse_each(flags) { |entity|
+  #     puts entity
+  #   }
+  #
+  # @overload reverse_each
+  #
+  #   @yieldparam [Layout::Entity] entity
+  #
+  # @overload reverse_each(flags)
+  #
+  #   @param [Hash{Symbol => Boolean}] flags A hash that allows skipping of
+  #     {Layout::Entity}s on hidden or locked {Layout::Layers}.
+  #   @yieldparam [Layout::Entity] entity
+  #
+  # @version LayOut 2018
+  def reverse_each(*args)
+  end
+
+end

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

@@ -1,359 +1,353 @@
-# Copyright:: Copyright 2019 Trimble Inc.
-# License:: The MIT License (MIT)
-
-# An entity is an object shown on a page of a LayOut document.
-#
-# @example
-#   doc = Layout::Document.open("C:/path/to/document.layout")
-#   # Get the shared entities in the document. If there are no shared layers,
-#   # the resulting array will be empty.
-#   entities = doc.entities
-#   # Count how many of the entites are a rectangle
-#   rectangle_count = 0
-#
-#   # Look at all of the entities in the array.
-#   entities.each { |entity|
-#     if entity.is_a?(Layout::Rectangle)
-#       rectangle_count = rectangle_count++
-#     end
-#   }
-#
-# @version LayOut 2018
-class Layout::Entity
-
-  # Instance Methods
-
-  # The {#==} method checks to see if the two {Layout::Entity}s are equal. This
-  # checks whether the Ruby Objects are pointing to the same internal object.
-  #
-  # @example
-  #   doc = Layout::Document.open("C:/path/to/document.layout")
-  #   page_entities = doc.pages.first.entities
-  #   layer_entities = doc.layers.first.layer_instance(page).entities
-  #   page_entities.first == layer_entities.first
-  #
-  # @param [Layout::Entity] other
-  #
-  # @return [Boolean]
-  #
-  # @version LayOut 2018
-  def ==(other)
-  end
-
-  # The {#bounds} method returns the 2D rectangular bounds of the {Layout::Entity}.
-  #
-  # @example
-  #   doc = Layout::Document.open("C:/path/to/document.layout")
-  #   entities = doc.pages.first.entities
-  #   bounds = entities.first.bounds
-  #
-  # @return [Geom::Bounds2d]
-  #
-  # @version LayOut 2018
-  def bounds
-  end
-
-  # The {#document} method returns the {Layout::Document} that the
-  # {Layout::Entity} belongs to, or +nil+ if it is not in a {Layout::Document}.
-  #
-  # @example
-  #   doc = Layout::Document.open("C:/path/to/document.layout")
-  #   entities = doc.shared_entities
-  #   # entity_doc should be the same document as doc
-  #   entity_doc = entities.first.document
-  #
-  # @return [Layout::Document, nil]
-  #
-  # @version LayOut 2018
-  def document
-  end
-
-  # The {#drawing_bounds} method returns the 2D rectangular drawing bounds of the
-  # {Layout::Entity}.
-  #
-  # @example
-  #   doc = Layout::Document.open("C:/path/to/document.layout")
-  #   entities = doc.pages.first.entities
-  #   draw_bounds = entities.first.drawing_bounds
-  #
-  # @return [Geom::OrientedBounds2d]
-  #
-  # @version LayOut 2018
-  def drawing_bounds
-  end
-
-  # The {#group} method returns the {Layout::Group} the {Layout::Entity} belongs
-  # to, or +nil+ if it is not in a {Layout::Group}.
-  #
-  # @example
-  #   doc = Layout::Document.open("C:/path/to/document.layout")
-  #   pages = doc.pages
-  #   entities = pages.first.entities
-  #   group = entities.first.group
-  #
-  # @return [Layout::Group, nil]
-  #
-  # @version LayOut 2018
-  def group
-  end
-
-  # The {#layer_instance} method returns the {Layout::LayerInstance} that the
-  # {Layout::Entity} is on, or +nil+ if it is not associated with a
-  # {Layout::LayerInstance}.
-  #
-  # @example
-  #   doc = Layout::Document.open("C:/path/to/document.layout")
-  #   entities = doc.pages.first.entities
-  #   entity_layer_instance = entities.first.layer_instance
-  #
-  # @note {Layout::Group}s are never associated with a {Layout::LayerInstance}.
-  #
-  # @return [Layout::LayerInstance, nil]
-  #
-  # @version LayOut 2018
-  def layer_instance
-  end
-
-  # The {#locked=} method sets the {Layout::Entity} as locked or unlocked. When
-  # locked, the {Layout::Entity} cannot be modified directly.
-  #
-  # @example
-  #   doc = Layout::Document.open("C:/path/to/document.layout")
-  #   entities = doc.pages.first.entities
-  #   entities.first.locked = true
-  #
-  # @param [Boolean] is_locked
-  #
-  # @version LayOut 2018
-  def locked=(is_locked)
-  end
-
-  # The {#locked?} method returns whether the {Layout::Entity} is locked or
-  # unlocked.
-  #
-  # @example
-  #   doc = Layout::Document.open("C:/path/to/document.layout")
-  #   entities = doc.pages.first.entities
-  #   is_first_locked = entities.first.locked?
-  #
-  # @return [Boolean]
-  #
-  # @version LayOut 2018
-  def locked?
-  end
-
-  # The {#move_to_group} method moves the {Layout::Entity} into a {Layout::Group}.
-  # If the {Layout::Entity} is already in a {Layout::Group}, it will be removed
-  # from that {Layout::Group} prior to being added to the new one. If this action
-  # results in the old {Layout::Group} containing only one {Layout::Entity}, the
-  # old {Layout::Group} will be collapsed and the remaining {Layout::Entity} will
-  # be moved to the old {Layout::Group}'s parent.
-  #
-  # @example
-  #   doc = Layout::Document.open("C:/path/to/document.layout")
-  #   entities = doc.pages.first.entities
-  #   new_group = Layout::Group.new
-  #   entities.first.move_to_group(new_group)
-  #
-  # @param [Layout::Group] group
-  #
-  # @raise [LockedLayerError] if the {Layout::Entity} is on a locked
-  #   {Layout::Layer}
-  #
-  # @raise [ArgumentError] if entity and group are not in the same
-  #   {Layout::Document}
-  #
-  # @raise [ArgumentError] if entity and group are not on the same {Layout::Page}
-  #
-  # @raise [ArgumentError] if of entity and group one is shared and one is not
-  #
-  # @raise [LockedEntityError] if the {Layout::Entity} is locked
-  #
-  # @version LayOut 2018
-  def move_to_group(group)
-  end
-
-  # The {#move_to_layer} method moves the {Layout::Entity} to the given
-  # {Layout::Layer}. If the {Layout::Layer} is non-shared and the
-  # {Layout::Entity} is currently on a shared {Layout::Layer}, an array of
-  # {Layout::Page}s must be provided to move the {Layout::Entity} to. In all other
-  # cases, passing in an array of {Layout::Page}s is not necessary. The
-  # {Layout::Entity} must belong to the same {Layout::Document} as the the
-  # {Layout::Layer} and the {Layout::Page}s.
-  #
-  # @example
-  #   doc = Layout::Document.open("C:/path/to/document.layout")
-  #   entities = doc.pages.first.entities
-  #   layers = doc.layers
-  #   entities.last.move_to_layer(layers.first)
-  #
-  # @overload move_to_layer(layer)
-  #
-  #   @param [Layout::Layer] layer
-  #
-  # @overload move_to_layer(layer, pages)
-  #
-  #   @param [Layout::Layer] layer
-  #   @param [Array<Layout::Page>] pages
-  #
-  # @raise [ArgumentError] if layer is shared and a valid array of non-duplicate
-  #   {Layout::Page}s is not passed in
-  #
-  # @raise [ArgumentError] if entity, layer, and pages are not all in the same
-  #   {Layout::Document}
-  #
-  # @raise [LockedLayerError] if the {Layout::Entity} is on a locked
-  #   {Layout::Layer}
-  #
-  # @raise [LockedLayerError] if layer is locked
-  #
-  # @raise [LockedEntityError] if the {Layout::Entity} is locked
-  #
-  # @version LayOut 2018
-  def move_to_layer(*args)
-  end
-
-  # The {#on_shared_layer?} method returns whether or not the {Layout::Entity} is
-  # on a shared {Layout::Layer}. This function works for all {Layout::Entity}
-  # types, including {Layout::Group}. {Layout::Group}s do not belong to a
-  # specific {Layout::Layer}, but their children are all on either a shared
-  # or non-shared {Layout::Layer}.
-  #
-  # @example
-  #   doc = Layout::Document.open("C:/path/to/document.layout")
-  #   entities = doc.pages.first.entities
-  #   on_shared_layer = entities.first.on_shared_layer?
-  #
-  # @raise [ArgumentError] if the {Layout::Entity} is not in a {Layout::Document}
-  #
-  # @return [Boolean]
-  #
-  # @version LayOut 2018
-  def on_shared_layer?
-  end
-
-  # The {#page} method returns the {Layout::Page} that the {Layout::Entity}
-  # belongs to, or +nil+ if it is on a shared {Layout::Layer} or not in a
-  # {Layout::Document}.
-  #
-  # @example
-  #   doc = Layout::Document.open("C:/path/to/document.layout")
-  #   # page will be nil
-  #   page = doc.shared_entities.first.page
-  #   # page will be the first page of the document
-  #   page = doc.pages.first.nonshared_entities.first.page
-  #
-  # @return [Layout::Page, nil]
-  #
-  # @version LayOut 2018
-  def page
-  end
-
-  # The {#style} method returns the {Layout::Style} of the {Layout::Entity}. If
-  # the {Layout::Entity} is a {Layout::Group}, +nil+ will be returned, as they
-  # do not have a {Layout::Style}.
-  #
-  # @example
-  #   doc = Layout::Document.open("C:/path/to/document.layout")
-  #   entities = doc.entities
-  #   style = entities.first.style
-  #
-  # @return [Layout::Style, nil]
-  #
-  # @version LayOut 2018
-  def style
-  end
-
-  # The {#style=} method sets the {Layout::Style} of the {Layout::Entity}.
-  #
-  # @param [Layout::Style] style
-  #
-  # @raise [LockedLayerError] if the {Layout::Entity} is on a locked
-  #   {Layout::Layer}
-  #
-  # @raise [LockedEntityError] if the {Layout::Entity} is locked
-  #
-  # @version LayOut 2018
-  def style=(style)
-  end
-
-  # The {#transform!} method transforms the {Layout::Entity} with a given
-  # {Geom::Transformation2d}.
-  #
-  # @example
-  #   doc = Layout::Document.open("C:/path/to/document.layout")
-  #   entities = doc.pages.first.entities
-  #   transform = Geom::Transformation2d.new([1.0, 0.0, 0.0, 1.0, 1.0, 1.0])
-  #   entity = entities.first.transform!(transform)
-  #
-  # @param [Geom::Transformation2d] transformation
-  #
-  # @raise [LockedLayerError] if the {Layout::Entity} is on a locked
-  #   {Layout::Layer}
-  #
-  # @raise [LockedEntityError] if the {Layout::Entity} is locked
-  #
-  # @version LayOut 2018
-  def transform!(transformation)
-  end
-
-  # The {#transformation} method returns the explicit {Geom::Transformation2d}.
-  #
-  # @example
-  #   doc = Layout::Document.open("C:/path/to/document.layout")
-  #   entities = doc.pages.first.entities
-  #   transform = entities.first.transformation
-  #
-  # @return [Geom::Transformation2d, nil]
-  #
-  # @version LayOut 2018
-  def transformation
-  end
-
-  # The {#untransformed_bounds} method returns the untransformed bounds of the
-  # {Layout::Entity}. This is the bounds of the {Layout::Entity} before its
-  # explicit {Geom::Transformation2d} is applied.
-  #
-  # @example
-  #   doc = Layout::Document.open("C:/path/to/document.layout")
-  #   entities = doc.pages.first.entities
-  #   bounds = entities.first.untransformed_bounds
-  #
-  # @raise [ArgumentError] if the {Layout::Entity} does not have an explicit
-  #   {Geom::Transformation2d}
-  #
-  # @return [Geom::Bounds2d]
-  #
-  # @version LayOut 2018
-  def untransformed_bounds
-  end
-
-  # The {#untransformed_bounds=} method sets the untransformed bounds of the
-  # {Layout::Entity}. This is the bounds of the {Layout::Entity} before its
-  # explicit {Geom::Transformation2d} is applied.
-  #
-  # @example
-  #   doc = Layout::Document.open("C:/path/to/document.layout")
-  #   entities = doc.pages.first.entities
-  #   point1 = Geom::Point2d.new(1, 1)
-  #   point2 = Geom::Point2d.new(2, 2)
-  #   bounds = Geom::Bounds2d(point1, point2)
-  #   entities.first.untransformed_bounds = bounds
-  #
-  # @param [Geom::Bounds2d] bounds
-  #
-  # @raise [ArgumentError] if the {Layout::Entity} does not have an explicit
-  #   {Geom::Transformation2d}
-  #
-  # @raise [LockedLayerError] if the {Layout::Entity} is on a locked
-  #   {Layout::Layer}
-  #
-  # @raise [LockedEntityError] if the {Layout::Entity} is locked
-  #
-  # @raise [ArgumentError] if the bounds are of zero size
-  #
-  # @version LayOut 2018
-  def untransformed_bounds=(bounds)
-  end
-
-end
+# Copyright:: Copyright 2020 Trimble Inc.
+# License:: The MIT License (MIT)
+
+# An entity is an object shown on a page of a LayOut document.
+#
+# @example
+#   doc = Layout::Document.open("C:/path/to/document.layout")
+#   # Get the shared entities in the document. If there are no shared layers,
+#   # the resulting array will be empty.
+#   entities = doc.shared_entities
+#
+#   # Count how many of the shared entites are rectangles.
+#   rectangle_count = entities.grep(Layout::Rectangle).size
+#
+# @version LayOut 2018
+class Layout::Entity
+
+  # Instance Methods
+
+  # The {#==} method checks to see if the two {Layout::Entity}s are equal. This
+  # checks whether the Ruby Objects are pointing to the same internal object.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   page_entities = doc.pages.first.entities
+  #   layer_entities = doc.layers.first.layer_instance(page).entities
+  #   page_entities.first == layer_entities.first
+  #
+  # @param [Layout::Entity] other
+  #
+  # @return [Boolean]
+  #
+  # @version LayOut 2018
+  def ==(other)
+  end
+
+  # The {#bounds} method returns the 2D rectangular bounds of the {Layout::Entity}.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   entities = doc.pages.first.entities
+  #   bounds = entities.first.bounds
+  #
+  # @return [Geom::Bounds2d]
+  #
+  # @version LayOut 2018
+  def bounds
+  end
+
+  # The {#document} method returns the {Layout::Document} that the
+  # {Layout::Entity} belongs to, or +nil+ if it is not in a {Layout::Document}.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   entities = doc.shared_entities
+  #   # entity_doc should be the same document as doc
+  #   entity_doc = entities.first.document
+  #
+  # @return [Layout::Document, nil]
+  #
+  # @version LayOut 2018
+  def document
+  end
+
+  # The {#drawing_bounds} method returns the 2D rectangular drawing bounds of the
+  # {Layout::Entity}.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   entities = doc.pages.first.entities
+  #   draw_bounds = entities.first.drawing_bounds
+  #
+  # @return [Geom::OrientedBounds2d]
+  #
+  # @version LayOut 2018
+  def drawing_bounds
+  end
+
+  # The {#group} method returns the {Layout::Group} the {Layout::Entity} belongs
+  # to, or +nil+ if it is not in a {Layout::Group}.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   pages = doc.pages
+  #   entities = pages.first.entities
+  #   group = entities.first.group
+  #
+  # @return [Layout::Group, nil]
+  #
+  # @version LayOut 2018
+  def group
+  end
+
+  # The {#layer_instance} method returns the {Layout::LayerInstance} that the
+  # {Layout::Entity} is on, or +nil+ if it is not associated with a
+  # {Layout::LayerInstance}.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   entities = doc.pages.first.entities
+  #   entity_layer_instance = entities.first.layer_instance
+  #
+  # @note {Layout::Group}s are never associated with a {Layout::LayerInstance}.
+  #
+  # @return [Layout::LayerInstance, nil]
+  #
+  # @version LayOut 2018
+  def layer_instance
+  end
+
+  # The {#locked=} method sets the {Layout::Entity} as locked or unlocked. When
+  # locked, the {Layout::Entity} cannot be modified directly.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   entities = doc.pages.first.entities
+  #   entities.first.locked = true
+  #
+  # @param [Boolean] is_locked
+  #
+  # @version LayOut 2018
+  def locked=(is_locked)
+  end
+
+  # The {#locked?} method returns whether the {Layout::Entity} is locked or
+  # unlocked.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   entities = doc.pages.first.entities
+  #   is_first_locked = entities.first.locked?
+  #
+  # @return [Boolean]
+  #
+  # @version LayOut 2018
+  def locked?
+  end
+
+  # The {#move_to_group} method moves the {Layout::Entity} into a {Layout::Group}.
+  # If the {Layout::Entity} is already in a {Layout::Group}, it will be removed
+  # from that {Layout::Group} prior to being added to the new one. If this action
+  # results in the old {Layout::Group} containing only one {Layout::Entity}, the
+  # old {Layout::Group} will be collapsed and the remaining {Layout::Entity} will
+  # be moved to the old {Layout::Group}'s parent.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   entities = doc.pages.first.entities
+  #   new_group = Layout::Group.new
+  #   entities.first.move_to_group(new_group)
+  #
+  # @param [Layout::Group] group
+  #
+  # @raise [LockedLayerError] if the {Layout::Entity} is on a locked
+  #   {Layout::Layer}
+  #
+  # @raise [ArgumentError] if entity and group are not in the same
+  #   {Layout::Document}
+  #
+  # @raise [ArgumentError] if entity and group are not on the same {Layout::Page}
+  #
+  # @raise [ArgumentError] if of entity and group one is shared and one is not
+  #
+  # @raise [LockedEntityError] if the {Layout::Entity} is locked
+  #
+  # @version LayOut 2018
+  def move_to_group(group)
+  end
+
+  # The {#move_to_layer} method moves the {Layout::Entity} to the given
+  # {Layout::Layer}. If the {Layout::Layer} is non-shared and the
+  # {Layout::Entity} is currently on a shared {Layout::Layer}, an array of
+  # {Layout::Page}s must be provided to move the {Layout::Entity} to. In all other
+  # cases, passing in an array of {Layout::Page}s is not necessary. The
+  # {Layout::Entity} must belong to the same {Layout::Document} as the the
+  # {Layout::Layer} and the {Layout::Page}s.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   entities = doc.pages.first.entities
+  #   layers = doc.layers
+  #   entities.last.move_to_layer(layers.first)
+  #
+  # @overload move_to_layer(layer)
+  #
+  #   @param [Layout::Layer] layer
+  #
+  # @overload move_to_layer(layer, pages)
+  #
+  #   @param [Layout::Layer] layer
+  #   @param [Array<Layout::Page>] pages
+  #
+  # @raise [ArgumentError] if layer is shared and a valid array of non-duplicate
+  #   {Layout::Page}s is not passed in
+  #
+  # @raise [ArgumentError] if entity, layer, and pages are not all in the same
+  #   {Layout::Document}
+  #
+  # @raise [LockedLayerError] if the {Layout::Entity} is on a locked
+  #   {Layout::Layer}
+  #
+  # @raise [LockedLayerError] if layer is locked
+  #
+  # @raise [LockedEntityError] if the {Layout::Entity} is locked
+  #
+  # @version LayOut 2018
+  def move_to_layer(*args)
+  end
+
+  # The {#on_shared_layer?} method returns whether or not the {Layout::Entity} is
+  # on a shared {Layout::Layer}. This function works for all {Layout::Entity}
+  # types, including {Layout::Group}. {Layout::Group}s do not belong to a
+  # specific {Layout::Layer}, but their children are all on either a shared
+  # or non-shared {Layout::Layer}.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   entities = doc.pages.first.entities
+  #   on_shared_layer = entities.first.on_shared_layer?
+  #
+  # @raise [ArgumentError] if the {Layout::Entity} is not in a {Layout::Document}
+  #
+  # @return [Boolean]
+  #
+  # @version LayOut 2018
+  def on_shared_layer?
+  end
+
+  # The {#page} method returns the {Layout::Page} that the {Layout::Entity}
+  # belongs to, or +nil+ if it is on a shared {Layout::Layer} or not in a
+  # {Layout::Document}.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   # page will be nil
+  #   page = doc.shared_entities.first.page
+  #   # page will be the first page of the document
+  #   page = doc.pages.first.nonshared_entities.first.page
+  #
+  # @return [Layout::Page, nil]
+  #
+  # @version LayOut 2018
+  def page
+  end
+
+  # The {#style} method returns the {Layout::Style} of the {Layout::Entity}. If
+  # the {Layout::Entity} is a {Layout::Group}, +nil+ will be returned, as they
+  # do not have a {Layout::Style}.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   entities = doc.entities
+  #   style = entities.first.style
+  #
+  # @return [Layout::Style, nil]
+  #
+  # @version LayOut 2018
+  def style
+  end
+
+  # The {#style=} method sets the {Layout::Style} of the {Layout::Entity}.
+  #
+  # @param [Layout::Style] style
+  #
+  # @raise [LockedLayerError] if the {Layout::Entity} is on a locked
+  #   {Layout::Layer}
+  #
+  # @raise [LockedEntityError] if the {Layout::Entity} is locked
+  #
+  # @version LayOut 2018
+  def style=(style)
+  end
+
+  # The {#transform!} method transforms the {Layout::Entity} with a given
+  # {Geom::Transformation2d}.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   entities = doc.pages.first.entities
+  #   transform = Geom::Transformation2d.new([1.0, 0.0, 0.0, 1.0, 1.0, 1.0])
+  #   entity = entities.first.transform!(transform)
+  #
+  # @param [Geom::Transformation2d] transformation
+  #
+  # @raise [LockedLayerError] if the {Layout::Entity} is on a locked
+  #   {Layout::Layer}
+  #
+  # @raise [LockedEntityError] if the {Layout::Entity} is locked
+  #
+  # @version LayOut 2018
+  def transform!(transformation)
+  end
+
+  # The {#transformation} method returns the explicit {Geom::Transformation2d}.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   entities = doc.pages.first.entities
+  #   transform = entities.first.transformation
+  #
+  # @return [Geom::Transformation2d, nil]
+  #
+  # @version LayOut 2018
+  def transformation
+  end
+
+  # The {#untransformed_bounds} method returns the untransformed bounds of the
+  # {Layout::Entity}. This is the bounds of the {Layout::Entity} before its
+  # explicit {Geom::Transformation2d} is applied.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   entities = doc.pages.first.entities
+  #   bounds = entities.first.untransformed_bounds
+  #
+  # @raise [ArgumentError] if the {Layout::Entity} does not have an explicit
+  #   {Geom::Transformation2d}
+  #
+  # @return [Geom::Bounds2d]
+  #
+  # @version LayOut 2018
+  def untransformed_bounds
+  end
+
+  # The {#untransformed_bounds=} method sets the untransformed bounds of the
+  # {Layout::Entity}. This is the bounds of the {Layout::Entity} before its
+  # explicit {Geom::Transformation2d} is applied.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   entities = doc.pages.first.entities
+  #   point1 = Geom::Point2d.new(1, 1)
+  #   point2 = Geom::Point2d.new(2, 2)
+  #   bounds = Geom::Bounds2d(point1, point2)
+  #   entities.first.untransformed_bounds = bounds
+  #
+  # @param [Geom::Bounds2d] bounds
+  #
+  # @raise [ArgumentError] if the {Layout::Entity} does not have an explicit
+  #   {Geom::Transformation2d}
+  #
+  # @raise [LockedLayerError] if the {Layout::Entity} is on a locked
+  #   {Layout::Layer}
+  #
+  # @raise [LockedEntityError] if the {Layout::Entity} is locked
+  #
+  # @raise [ArgumentError] if the bounds are of zero size
+  #
+  # @version LayOut 2018
+  def untransformed_bounds=(bounds)
+  end
+
+end