sketchup-api-stubs 0.7.2 → 0.7.7

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2020 Trimble Inc.
+# Copyright:: Copyright 2021 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # References an auto text definition. Some auto text definitions are mandatory.

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2020 Trimble Inc.
+# Copyright:: Copyright 2021 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The AutoTextDefinitions class is a container class for all
@@ -88,6 +88,11 @@ class Layout::AutoTextDefinitions
   #     puts auto_text.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::AutoTextDefinition] auto_text
@@ -129,6 +134,7 @@ class Layout::AutoTextDefinitions
   # @version LayOut 2018
   def length
   end
+  alias_method :size, :length
 
   # The {#remove} method removes an {Layout::AutoTextDefinition} from the
   # {Layout::Document}.
@@ -170,17 +176,4 @@ class Layout::AutoTextDefinitions
   def remove(*args)
   end
 
-  # The {#length} method returns the number of {Layout::AutoTextDefinition}s.
-  #
-  # @example
-  #   doc = Layout::Document.open("C:/path/to/document.layout")
-  #   auto_texts = doc.auto_text_definitions
-  #   num_auto_texts = auto_texts.length
-  #
-  # @return [Integer]
-  #
-  # @version LayOut 2018
-  def size
-  end
-
 end

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2020 Trimble Inc.
+# Copyright:: Copyright 2021 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # This is the interface to a LayOut Connection Point. A

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2020 Trimble Inc.
+# Copyright:: Copyright 2021 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # This is the interface to a LayOut document. A {Layout::Document} is the 2D
@@ -46,6 +46,7 @@ class Layout::Document
   VERSION_2018 = nil # Stub value.
   VERSION_2019 = nil # Stub value.
   VERSION_2020 = nil # Stub value.
+  VERSION_2021 = nil # Stub value.
   VERSION_3 = nil # Stub value.
   VERSION_CURRENT = nil # Stub value.
 
@@ -143,6 +144,61 @@ class Layout::Document
   def auto_text_definitions
   end
 
+  # The {#export} method exports the {Layout::Document} to a given file format.
+  # It knows which format to export based on the file extension you place on the
+  # file name. For example, a filename of "thing.pdf" will export a PDF file,
+  # whereas "thing.png" will export a set of PNG images.
+  #
+  # For LayOut version 2020.1, valid extensions include .pdf, .jpg, and .png.
+  #
+  # @example PDF Export Examples
+  #   doc = Layout::Document.open("c:/path/to/document.layout")
+  #
+  #   # Export pdf file on a PC, with default settings.
+  #   status = doc.export("c:/my_export.pdf")
+  #
+  #   # Export pages one through three at high quality, compressing jpeg images
+  #   # at 0.75 compression quality (valid range is 0.0 - 1.0). Note that the
+  #   # first page of a {Layout::Document} is index 0.
+  #   options = { start_page: 1,
+  #               end_page: 3,
+  #               output_resolution: Layout::PageInfo::RESOLUTION_HIGH,
+  #               compress_images: TRUE,
+  #               compress_quality: 0.75 }
+  #
+  #   status = doc.export("c:/my_export.pdf", options)
+  #
+  # @example Image Set Export Examples
+  #   doc = Layout::Document.open("c:/path/to/document.layout")
+  #
+  #   # Export png files on macOS, with default settings.
+  #   status = doc.export('/Users/username/Desktop/pngs/page.png')
+  #
+  #   # Export pages one through three at 300 dpi as JPGs.
+  #   options = { start_page: 1,
+  #               end_page: 3,
+  #               dpi: 300 }
+  #   status = doc.export('c:/page.jpg', options)
+  #
+  # @param [String] file_path
+  #   The file or image set to create. The directory
+  #   path must already exist. The path must include the file extension.
+  #
+  # @param [Hash, nil] options
+  #   An optional hash of settings for the export.
+  #
+  # @raise [TypeError] if an options value is the wrong type
+  #
+  # @raise [RangeError] if an options value is out of range
+  #
+  # @raise [ArgumentError] if the full file path does not exist
+  #
+  # @raise [ArgumentError] if the specified file type is missing or not supported
+  #
+  # @version LayOut 2020.1
+  def export(file_path, options = nil)
+  end
+
   # The {#grid} method returns the {Layout::Grid} for a {Layout::Document}.
   #
   # @example
@@ -347,15 +403,15 @@ class Layout::Document
   # @example
   #   doc = Layout::Document.open("C:/path/to/document.layout")
   #   # Save the model using the current Layout format
-  #   filename = File.join(ENV['Home'], 'Desktop', 'mydoc.layout')
-  #   status = doc.save(filename)
+  #   path = File.join(ENV['Home'], 'Desktop', 'mydoc.layout')
+  #   status = doc.save(path)
   #   # Save the document to the current file using the current LayOut format
   #   status = doc.save
   #   # Save the document to the current file in LayOut 3 format
   #   status = doc.save(Layout::Document::VERSION_3)
   #   # Save the document in LayOut 2013 format
-  #   filename = File.join(ENV['Home'], 'Desktop', 'mydoc_v2013.layout')
-  #   status = doc.save(filename, Layout::Document::VERSION_2013)
+  #   path = File.join(ENV['Home'], 'Desktop', 'mydoc_v2013.layout')
+  #   status = doc.save(path, Layout::Document::VERSION_2013)
   #
   # @overload save
   #

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2020 Trimble Inc.
+# Copyright:: Copyright 2021 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # A simple elliptical shape entity.

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2020 Trimble Inc.
+# Copyright:: Copyright 2021 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # The Entities class is a container class for {Layout::Entity}s. A
@@ -86,6 +86,11 @@ class Layout::Entities
   #     puts entity
   #   }
   #
+  # @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.
+  #
   # @param [Hash{Symbol => Boolean}] flags
   #   A hash that allows skipping of
   #   {Layout::Entity}s on hidden or locked {Layout::Layers}
@@ -108,6 +113,7 @@ class Layout::Entities
   # @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
@@ -139,17 +145,4 @@ class Layout::Entities
   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

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2020 Trimble Inc.
+# Copyright:: Copyright 2021 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # An entity is an object shown on a page of a LayOut document.

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2020 Trimble Inc.
+# Copyright:: Copyright 2021 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # A formatted text entity.

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

@@ -1,4 +1,4 @@
-# Copyright:: Copyright 2020 Trimble Inc.
+# Copyright:: Copyright 2021 Trimble Inc.
 # License:: The MIT License (MIT)
 
 # Class that references a {Layout::Document}'s grid settings.
@@ -8,6 +8,62 @@ class Layout::Grid
 
   # Instance Methods
 
+  # The {#clip_to_margins=} method sets whether or not the grid is clipped to the
+  # page margins.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   grid = doc.grid
+  #   grid.clip_to_margins = true
+  #
+  # @param [Boolean] clip
+  #
+  # @version LayOut 2020.1
+  def clip_to_margins=(clip)
+  end
+
+  # The {#clip_to_margins?} method returns whether or not the grid is clipped to
+  # the page margins.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   grid = doc.grid
+  #   in_front = grid.clip_to_margins?
+  #
+  # @return [Boolean]
+  #
+  # @version LayOut 2020.1
+  def clip_to_margins?
+  end
+
+  # The {#in_front=} method sets whether or not the grid is drawn on top of
+  # entities.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   grid = doc.grid
+  #   grid.in_front = true
+  #
+  # @param [Boolean] in_front
+  #
+  # @version LayOut 2020.1
+  def in_front=(in_front)
+  end
+
+  # The {#in_front?} method returns whether or not the grid is drawn on top of
+  # entities.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   grid = doc.grid
+  #   in_front = grid.in_front?
+  #
+  # @return [Boolean]
+  #
+  # @version LayOut 2020.1
+  def in_front?
+  end
+
   # The {#major_color} method returns the {Sketchup::Color} for the major grid
   # lines.
   #
@@ -22,6 +78,26 @@ class Layout::Grid
   def major_color
   end
 
+  # The {#major_color=} method sets the {Sketchup::Color} for the major grid
+  # lines.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   grid = doc.grid
+  #   grid.major_color = Sketchup::Color.new(255, 0, 0)
+  #   grid.major_color = 255
+  #   grid.major_color = 0x0000ff
+  #   grid.major_color = "red"
+  #   grid.major_color = "#ff0000"
+  #   grid.major_color = [1.0, 0.0, 0.0]
+  #   grid.major_color = [255, 0, 0]
+  #
+  # @param [Sketchup::Color] color
+  #
+  # @version LayOut 2020.1
+  def major_color=(color)
+  end
+
   # The {#major_spacing} method returns the major space size of the
   # {Layout::Grid}.
   #
@@ -36,6 +112,24 @@ class Layout::Grid
   def major_spacing
   end
 
+  # The {#major_spacing=} method sets the major space size of the
+  # {Layout::Grid}.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   grid = doc.grid
+  #   grid.major_spacing = 1.25
+  #
+  # @param [Float] spacing
+  #   The double specifying the space size for the
+  #   {Layout::Grid}
+  #
+  # @raise [ArgumentError] if spacing is not greater than zero
+  #
+  # @version LayOut 2020.1
+  def major_spacing=(spacing)
+  end
+
   # The {#minor_color} method returns the {Sketchup::Color} for the minor grid
   # lines.
   #
@@ -50,6 +144,26 @@ class Layout::Grid
   def minor_color
   end
 
+  # The {#minor_color=} method sets the {Sketchup::Color} for the minor grid
+  # lines.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   grid = doc.grid
+  #   grid.minor_color = Sketchup::Color.new(255, 0, 0)
+  #   grid.minor_color = 255
+  #   grid.minor_color = 0x0000ff
+  #   grid.minor_color = "red"
+  #   grid.minor_color = "#ff0000"
+  #   grid.minor_color = [1.0, 0.0, 0.0]
+  #   grid.minor_color = [255, 0, 0]
+  #
+  # @param [Sketchup::Color] color
+  #
+  # @version LayOut 2020.1
+  def minor_color=(color)
+  end
+
   # The {#minor_divisions} method returns the number of minor divisions of the
   # {Layout::Grid}.
   #
@@ -64,6 +178,38 @@ class Layout::Grid
   def minor_divisions
   end
 
+  # The {#minor_divisions=} method sets the number of minor divisions of the
+  # {Layout::Grid}.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   grid = doc.grid
+  #   grid.major_spacing = 1.25
+  #
+  # @param [Integer] divisions
+  #   The number of minor divisions for the
+  #   {Layout::Grid}
+  #
+  # @raise [ArgumentError] if divisions is negative
+  #
+  # @version LayOut 2020.1
+  def minor_divisions=(divisions)
+  end
+
+  # The {#print=} method sets whether or not the {Layout::Grid} is
+  # printed.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   grid = doc.grid
+  #   grid.print = false
+  #
+  # @param [Boolean] print
+  #
+  # @version LayOut 2020.1
+  def print=(print)
+  end
+
   # The {#print?} method returns whether or not the {Layout::Grid} is
   # printed.
   #
@@ -78,6 +224,20 @@ class Layout::Grid
   def print?
   end
 
+  # The {#show=} method sets whether or not the {Layout::Grid} is
+  # visible.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   grid = doc.grid
+  #   grid.show = true
+  #
+  # @param [Boolean] show
+  #
+  # @version LayOut 2020.1
+  def show=(show)
+  end
+
   # The {#show?} method returns whether or not the {Layout::Grid} is
   # visible.
   #
@@ -92,6 +252,20 @@ class Layout::Grid
   def show?
   end
 
+  # The {#show_major=} method sets whether or not the major grid lines are
+  # visible.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   grid = doc.grid
+  #   grid.show_major = true
+  #
+  # @param [Boolean] show
+  #
+  # @version LayOut 2020.1
+  def show_major=(show)
+  end
+
   # The {#show_major?} method returns whether or not the major grid lines are
   # visible.
   #
@@ -106,6 +280,20 @@ class Layout::Grid
   def show_major?
   end
 
+  # The {#show_minor=} method sets whether or not the minor grid lines are
+  # visible.
+  #
+  # @example
+  #   doc = Layout::Document.open("C:/path/to/document.layout")
+  #   grid = doc.grid
+  #   grid.show_minor = false
+  #
+  # @param [Boolean] show
+  #
+  # @version LayOut 2020.1
+  def show_minor=(show)
+  end
+
   # The {#show_minor?} method returns whether or not the minor grid lines are
   # visible.
   #