sketchup-api-stubs 0.7.4 → 0.7.5

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

@@ -1,225 +1,217 @@
-# Copyright:: Copyright 2020 Trimble Inc.
-# License:: The MIT License (MIT)
-
-# The Texture class contains methods for obtaining information about textures
-# that are part of your materials in your model (within the In-Model section
-# of the Materials Browser). Remember, textures are repeatable images that
-# "tile" when painted on a surface.
-#
-# @version SketchUp 6.0
-class Sketchup::Texture < Sketchup::Entity
-
-  # Instance Methods
-
-  # The average_color method retrieves a color object with the average color
-  # found in the texture.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   materials=model.materials
-  #   # Adds a material as an in model material
-  #   m = materials.add "Test Color"
-  #   begin
-  #     # Returns nil if not successful, path if successful
-  #     m.texture = "c:\\Materials\\Carpet.jpg"
-  #   rescue
-  #     UI.messagebox $!.message
-  #   end
-  #   texture = m.texture
-  #   # Returns a color object
-  #   color = texture.average_color
-  #   if (color)
-  #     UI.messagebox color
-  #   else
-  #     UI.messagebox "Failure: No average color"
-  #   end
-  #
-  # @return [Sketchup::Color, nil] a color object (if successful), nil if
-  #   unsuccessful.
-  #
-  # @version SketchUp 6.0
-  def average_color
-  end
-
-  # The filename method retrieves the entire path, including the file, for a
-  # texture object.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   materials=model.materials
-  #   # Adds a material as an in model material
-  #   m = materials.add "Test Color"
-  #   begin
-  #     # Returns nil if not successful, path if successful
-  #     m.texture = "c:\\Materials\\Carpet.jpg"
-  #   rescue
-  #     UI.messagebox $!.message
-  #   end
-  #   texture = m.texture
-  #   filename = texture.filename
-  #   if (filename)
-  #     UI.messagebox filename
-  #   else
-  #     UI.messagebox "Failure"
-  #   end
-  #
-  # @return [String] a string representation of the path and
-  #   filename used for the texture.
-  #
-  # @version SketchUp 6.0
-  def filename
-  end
-
-  # The height method is used to get the height of a repeatable texture image,
-  # in inches.
-  #
-  # @example
-  #   height = texture.height
-  #
-  # @return [Integer] the height, in inches, of the texture pattern
-  #
-  # @version SketchUp 6.0
-  def height
-  end
-
-  # The image_height method retrieves the height of the repeatable texture
-  # image, in pixels.
-  #
-  # @example
-  #   imageheight = texture.image_height
-  #   if (imageheight)
-  #     UI.messagebox imageheight
-  #   else
-  #     UI.messagebox "Failure"
-  #   end
-  #
-  # @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.
-  #
-  # @example
-  #   imagewidth = texture.image_width
-  #   if (imagewidth)
-  #     UI.messagebox imagewidth
-  #   else
-  #     UI.messagebox "Failure"
-  #   end
-  #
-  # @return [Integer] the width, in pixels, of the texture
-  #   pattern
-  #
-  # @version SketchUp 6.0
-  def image_width
-  end
-
-  # The size= method allows you to set the size of the repeatable texture image,
-  # in inches,
-  #
-  # @example
-  #   size = texture.size = 60
-  #   imagewidth = texture.width
-  #
-  #   if (imagewidth)
-  #     UI.messagebox imagewidth
-  #   else
-  #     UI.messagebox "Failure"
-  #   end
-  #
-  #   # Using two values which will not preserve ratio
-  #   width_height = texture.size = [10,100]
-  #   if (width_height)
-  #     UI.messagebox width_height
-  #   else
-  #     UI.messagebox "Failure"
-  #   end
-  #
-  # @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 [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
-  #   successful.
-  #
-  # @version SketchUp 6.0
-  def size=(size)
-  end
-
-  # The valid? method ensures that a texture is valid.
-  #
-  # @example
-  #   status = texture.valid?
-  #   if (status)
-  #     UI.messagebox status
-  #   else
-  #     UI.messagebox status
-  #   end
-  #
-  # @return [Boolean]
-  #
-  # @version SketchUp 6.0
-  def valid?
-  end
-
-  # The width method is used to get the width of a repeatable texture image,
-  # in inches.
-  #
-  # @example
-  #   width = texture.width
-  #
-  # @return [Integer] the width, in inches, of the texture pattern
-  #
-  # @version SketchUp 6.0
-  def width
-  end
-
-  # Writes the texture to file with option to preserve the color adjustments made
-  # by the material.
-  #
-  # @example
-  #   material = Sketchup.active_model.materials[0]
-  #   basename = File.basename(material.texture.filename)
-  #   filename = File.join(Sketchup.temp_dir, basename)
-  #   material.texture.write(filename)
-  #
-  # @param [String] filename
-  #   String - The filename to write the texture to.
-  #
-  # @param [Boolean] colorize
-  #   Boolean - Allows for the texture to
-  #   be exported with the color adjustments.
-  #
-  # @return [Boolean] true if the method succeeded
-  #
-  # @version SketchUp 2016
-  def write(filename, colorize = false)
-  end
-
-end
+# Copyright:: Copyright 2020 Trimble Inc.
+# License:: The MIT License (MIT)
+
+# The Texture class contains methods for obtaining information about textures
+# that are part of your materials in your model (within the In-Model section
+# of the Materials Browser). Remember, textures are repeatable images that
+# "tile" when painted on a surface.
+#
+# @version SketchUp 6.0
+class Sketchup::Texture < Sketchup::Entity
+
+  # Instance Methods
+
+  # The average_color method retrieves a color object with the average color
+  # found in the texture.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   materials=model.materials
+  #   # Adds a material as an in model material
+  #   m = materials.add "Test Color"
+  #   begin
+  #     # Returns nil if not successful, path if successful
+  #     m.texture = "c:\\Materials\\Carpet.jpg"
+  #   rescue
+  #     UI.messagebox $!.message
+  #   end
+  #   texture = m.texture
+  #   # Returns a color object
+  #   color = texture.average_color
+  #   if (color)
+  #     UI.messagebox color
+  #   else
+  #     UI.messagebox "Failure: No average color"
+  #   end
+  #
+  # @return [Sketchup::Color, nil] a color object (if successful), nil if
+  #   unsuccessful.
+  #
+  # @version SketchUp 6.0
+  def average_color
+  end
+
+  # The {#filename} method retrieves the entire path, including the file, for a
+  # texture object.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   materials = model.materials
+  #   material = materials.add("Test Color")
+  #   material.texture = "c:\\Materials\\Carpet.jpg"
+  #   texture = material.texture
+  #   filename = texture.filename
+  #
+  # @note Since SketchUp 2021.0 this method will append a file extension matching
+  #   the image format if the file extension is missing from stored filepath.
+  #
+  # @return [String] a string representation of the path and
+  #   filename used for the texture.
+  #
+  # @version SketchUp 6.0
+  def filename
+  end
+
+  # The height method is used to get the height of a repeatable texture image,
+  # in inches.
+  #
+  # @example
+  #   height = texture.height
+  #
+  # @return [Integer] the height, in inches, of the texture pattern
+  #
+  # @version SketchUp 6.0
+  def height
+  end
+
+  # The image_height method retrieves the height of the repeatable texture
+  # image, in pixels.
+  #
+  # @example
+  #   imageheight = texture.image_height
+  #   if (imageheight)
+  #     UI.messagebox imageheight
+  #   else
+  #     UI.messagebox "Failure"
+  #   end
+  #
+  # @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.
+  #
+  # @example
+  #   imagewidth = texture.image_width
+  #   if (imagewidth)
+  #     UI.messagebox imagewidth
+  #   else
+  #     UI.messagebox "Failure"
+  #   end
+  #
+  # @return [Integer] the width, in pixels, of the texture
+  #   pattern
+  #
+  # @version SketchUp 6.0
+  def image_width
+  end
+
+  # The size= method allows you to set the size of the repeatable texture image,
+  # in inches,
+  #
+  # @example
+  #   size = texture.size = 60
+  #   imagewidth = texture.width
+  #
+  #   if (imagewidth)
+  #     UI.messagebox imagewidth
+  #   else
+  #     UI.messagebox "Failure"
+  #   end
+  #
+  #   # Using two values which will not preserve ratio
+  #   width_height = texture.size = [10,100]
+  #   if (width_height)
+  #     UI.messagebox width_height
+  #   else
+  #     UI.messagebox "Failure"
+  #   end
+  #
+  # @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 [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
+  #   successful.
+  #
+  # @version SketchUp 6.0
+  def size=(size)
+  end
+
+  # The valid? method ensures that a texture is valid.
+  #
+  # @example
+  #   status = texture.valid?
+  #   if (status)
+  #     UI.messagebox status
+  #   else
+  #     UI.messagebox status
+  #   end
+  #
+  # @return [Boolean]
+  #
+  # @version SketchUp 6.0
+  def valid?
+  end
+
+  # The width method is used to get the width of a repeatable texture image,
+  # in inches.
+  #
+  # @example
+  #   width = texture.width
+  #
+  # @return [Integer] the width, in inches, of the texture pattern
+  #
+  # @version SketchUp 6.0
+  def width
+  end
+
+  # Writes the texture to file with option to preserve the color adjustments made
+  # by the material.
+  #
+  # @example
+  #   material = Sketchup.active_model.materials[0]
+  #   basename = File.basename(material.texture.filename)
+  #   path = File.join(Sketchup.temp_dir, basename)
+  #   material.texture.write(path)
+  #
+  # @param [String] path
+  #   The file path to write the texture to.
+  #
+  # @param [Boolean] colorize
+  #   Boolean - Allows for the texture to
+  #   be exported with the color adjustments.
+  #
+  # @return [Boolean] true if the method succeeded
+  #
+  # @version SketchUp 2016
+  def write(path, colorize = false)
+  end
+
+end

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

@@ -1,237 +1,237 @@
-# Copyright:: Copyright 2020 Trimble Inc.
-# License:: The MIT License (MIT)
-
-# The TextureWriter class is used primarily for writing the textures used in a
-# SketchUp model out to files as part of an export for use in another
-# application. These methods are usually invoked in this order:
-#
-#   - 1. load - load one or more textures from a model into the TextureWriter.
-#   - 2. write_all or write - write the texture(s) to file.
-#
-# @example
-#   # This code snippet sets up a texture writer and some variables that are
-#   # used in the following texture writer examples.
-#   # Assumptions:
-#   # 1) The active model contains at least one entity at the root level of the
-#   #    following types: component instance, group, or image.
-#   # 2) The active model contains at least one face at the root level.
-#   model = Sketchup.active_model
-#   entities = model.entities
-#   faces = entities.grep(Sketchup::Face)
-#   texturable_entities = entities.select{ |ent|
-#       (ent.is_a?(Sketchup::ComponentInstance) ||
-#        ent.is_a?(Sketchup::Group) || ent.is_a?(Sketchup::Image)) }
-#   tw = Sketchup.create_texture_writer
-#
-# @version SketchUp 6.0
-class Sketchup::TextureWriter
-
-  # Instance Methods
-
-  # The {#length} method is used to determine the number of textures loaded into
-  # the texture writer.
-  #
-  # The {#count} method is an alias for {#length}.
-  #
-  # @example
-  #   length = tw.length
-  #   tw.load(texturable_entities[0])
-  #   if length < tw.length
-  #     puts("A new entity was successfully loaded into the writer.")
-  #   end
-  #
-  # @return [Integer] length - the number of textures loaded in the texture
-  #   writer
-  #
-  # @version SketchUp 6.0
-  def count
-  end
-
-  # The filename method is used to retrieve the original filename for a
-  # particular texture.
-  #
-  # @example
-  #   index = tw.load(texturable_entities[0])
-  #   filename = tw.filename(index)
-  #   puts("filename = #{filename}")
-  #
-  # @param [Integer] handle
-  #   The index or handle of the texture in the texture
-  #   writer.
-  #
-  # @return [String] filename - the filename of the texture on the file system.
-  #   Textures can be generated without filenames, so if the
-  #   texture doesn't have a name write_all will save the
-  #   texture to an image file named "i.png". Where i is the
-  #   first integer greater than zero which was not already used
-  #   for a png file name.
-  #
-  # @version SketchUp 6.0
-  def filename(handle)
-  end
-
-  # The handle method is used to retrieve a handle or index for a specific
-  # texture in the texture writer.
-  #
-  # @example
-  #   tw.load(texturable_entities[0])
-  #   handle = tw.handle(texturable_entities[0])
-  #
-  # @example
-  #   load_front_face = true
-  #   tw.load(faces[0], load_front_face)
-  #   handle = tw.handle(faces[0], load_front_face)
-  #
-  # @overload handle(entity)
-  #
-  #   @param [Sketchup::Entity] entity  A image, component instance, group, or
-  #                                     layer.
-  #   @return [Integer] the index for the entity in the texture writer.
-  #
-  # @overload handle(face, side)
-  #
-  #   @param [Sketchup::Face] face
-  #   @param [Boolean] side  Specifies one of the sides of the face
-  #                          (true if front, false if back.)
-  #   @return [Integer] the index for the entity in the texture writer.
-  #
-  # @version SketchUp 6.0
-  def handle(*args)
-  end
-
-  # The {#length} method is used to determine the number of textures loaded into
-  # the texture writer.
-  #
-  # The {#count} method is an alias for {#length}.
-  #
-  # @example
-  #   length = tw.length
-  #   tw.load(texturable_entities[0])
-  #   if length < tw.length
-  #     puts("A new entity was successfully loaded into the writer.")
-  #   end
-  #
-  # @return [Integer] length - the number of textures loaded in the texture
-  #   writer
-  #
-  # @version SketchUp 6.0
-  def length
-  end
-
-  # The load method is used to load one or more textures into the texture writer
-  # for writing out to a file.
-  #
-  # @example
-  #   index = tw.load(texturable_entities[0])
-  #
-  # @example
-  #   index = tw.load(faces[0], true)
-  #
-  # @note If you are passing a face in as the entity argument when loading a
-  #   texture you will have to specify the second boolean argument, side.
-  #   The argument side specifies which side of the face the texture will be
-  #   loaded from.
-  #
-  # @overload load(entity)
-  #
-  #   @param [Sketchup::Entity] entity Image, component instance, group, or layer
-  #                                      to load.
-  #   @return [Integer] handle - the index or handle of the entity that was
-  #                     loaded
-  #
-  # @overload load(face, side)
-  #
-  #   @param [Sketchup::Face] face A face to load.
-  #   @param [Boolean] side        A boolean used to indicate the side of the
-  #                                face being loaded (true if front, false if
-  #                                back).
-  #   @return [Integer] handle - the index or handle of the entity that was
-  #                     loaded
-  #
-  # @version SketchUp 6.0
-  def load(*args)
-  end
-
-  # The write method is used to write an individual textures, within the texture
-  # writer, to a file. An entity's texture must have been loaded into the texture
-  # writer before this method can be used to write it's texture.
-  #
-  # This method will return one of the following status messages. (These are
-  # constants that are defined by the API.)
-  #
-  #   - 0 = FILE_WRITE_OK
-  #   - 1 = FILE_WRITE_FAILED_INVALID_TIFF
-  #   - 2 = FILE_WRITE_FAILED_UNKNOWN
-  #
-  # @example
-  #   tw.load(texturable_entities[0])
-  #   if tw.write(texturable_entities[0], "C:\\textures\\A.jpg") == FILE_WRITE_OK
-  #     puts("JPEG file successfully written.")
-  #   end
-  #
-  # @example
-  #   tw.load(faces[0], true)
-  #   if tw.write(faces[0], true, "C:\\textures\\Face.png") == FILE_WRITE_OK
-  #     puts("PNG file successfully written.")
-  #   end
-  #   if tw.write(faces[0], true, "C:\\textures\\Face.bmp") == FILE_WRITE_OK
-  #     puts("BMP file successfully written.")
-  #   end
-  #   if tw.write(faces[0], true, "C:\\textures\\Face.tif") == FILE_WRITE_OK
-  #     puts("TIFF file successfully written.")
-  #   end
-  #
-  # @note If you are passing a face in as the entity argument when writing a
-  #   texture you will have to specify the boolean argument, side. The argument
-  #   side controls the side of the face from which the texture will be sampled
-  #   before writing it.
-  #
-  # @overload write(entity, filename)
-  #
-  #   @param [Sketchup::Entity] entity An image, component instance, group, or
-  #                                    layer to write.
-  #   @param [String] filename         The name of the file to contain the
-  #                                    texture.
-  #   @return [Integer] status - one of three status messages (see comments.)
-  #
-  # @overload write(entity, side, filename)
-  #
-  #   @param [Sketchup::Entity] entity A face to write.
-  #   @param [Boolean] side            A boolean used to indicate the side of the
-  #                                    face being written (true if front, false
-  #                                    if back).
-  #   @param [String] filename         The name of the file to contain the
-  #                                    texture.
-  #   @return [Integer] status - one of three status messages (see comments.)
-  #
-  # @version SketchUp 6.0
-  def write(*args)
-  end
-
-  # The write_all method is used to write all of the textures within the texture
-  # writer to files. It will return one of three status numbers:
-  #
-  #   - 0 = FILE_WRITE_OK
-  #   - 1 = FILE_WRITE_FAILED_INVALID_TIFF
-  #   - 2 = FILE_WRITE_FAILED_UNKNOWN
-  #
-  # @example
-  #   tw.load(texturable_entities[0]
-  #   tw.load(faces[0], false)
-  #   if tw.write_all("C:\\textures\\", true) == FILE_WRITE_OK
-  #     puts("Texture files were successfully written.")
-  #   end
-  #
-  # @param [String] dirname
-  #   The directory to write to.
-  #
-  # @param [Boolean] filename_format
-  #   true to use 8.3 DOS name format.
-  #
-  # @return [Integer] status - one of three status messages (see comments.)
-  #
-  # @version SketchUp 6.0
-  def write_all(dirname, filename_format)
-  end
-
-end
+# Copyright:: Copyright 2020 Trimble Inc.
+# License:: The MIT License (MIT)
+
+# The TextureWriter class is used primarily for writing the textures used in a
+# SketchUp model out to files as part of an export for use in another
+# application. These methods are usually invoked in this order:
+#
+#   - 1. load - load one or more textures from a model into the TextureWriter.
+#   - 2. write_all or write - write the texture(s) to file.
+#
+# @example
+#   # This code snippet sets up a texture writer and some variables that are
+#   # used in the following texture writer examples.
+#   # Assumptions:
+#   # 1) The active model contains at least one entity at the root level of the
+#   #    following types: component instance, group, or image.
+#   # 2) The active model contains at least one face at the root level.
+#   model = Sketchup.active_model
+#   entities = model.entities
+#   faces = entities.grep(Sketchup::Face)
+#   texturable_entities = entities.select{ |ent|
+#       (ent.is_a?(Sketchup::ComponentInstance) ||
+#        ent.is_a?(Sketchup::Group) || ent.is_a?(Sketchup::Image)) }
+#   tw = Sketchup.create_texture_writer
+#
+# @version SketchUp 6.0
+class Sketchup::TextureWriter
+
+  # Instance Methods
+
+  # The {#length} method is used to determine the number of textures loaded into
+  # the texture writer.
+  #
+  # The {#count} method is an alias for {#length}.
+  #
+  # @example
+  #   length = tw.length
+  #   tw.load(texturable_entities[0])
+  #   if length < tw.length
+  #     puts("A new entity was successfully loaded into the writer.")
+  #   end
+  #
+  # @return [Integer] length - the number of textures loaded in the texture
+  #   writer
+  #
+  # @version SketchUp 6.0
+  def count
+  end
+
+  # The filename method is used to retrieve the original filename for a
+  # particular texture.
+  #
+  # @example
+  #   index = tw.load(texturable_entities[0])
+  #   filename = tw.filename(index)
+  #   puts("filename = #{filename}")
+  #
+  # @param [Integer] handle
+  #   The index or handle of the texture in the texture
+  #   writer.
+  #
+  # @return [String] filename - the filename of the texture on the file system.
+  #   Textures can be generated without filenames, so if the
+  #   texture doesn't have a name write_all will save the
+  #   texture to an image file named "i.png". Where i is the
+  #   first integer greater than zero which was not already used
+  #   for a png file name.
+  #
+  # @version SketchUp 6.0
+  def filename(handle)
+  end
+
+  # The handle method is used to retrieve a handle or index for a specific
+  # texture in the texture writer.
+  #
+  # @example
+  #   tw.load(texturable_entities[0])
+  #   handle = tw.handle(texturable_entities[0])
+  #
+  # @example
+  #   load_front_face = true
+  #   tw.load(faces[0], load_front_face)
+  #   handle = tw.handle(faces[0], load_front_face)
+  #
+  # @overload handle(entity)
+  #
+  #   @param [Sketchup::Entity] entity  A image, component instance, group, or
+  #                                     layer.
+  #   @return [Integer] the index for the entity in the texture writer.
+  #
+  # @overload handle(face, side)
+  #
+  #   @param [Sketchup::Face] face
+  #   @param [Boolean] side  Specifies one of the sides of the face
+  #                          (true if front, false if back.)
+  #   @return [Integer] the index for the entity in the texture writer.
+  #
+  # @version SketchUp 6.0
+  def handle(*args)
+  end
+
+  # The {#length} method is used to determine the number of textures loaded into
+  # the texture writer.
+  #
+  # The {#count} method is an alias for {#length}.
+  #
+  # @example
+  #   length = tw.length
+  #   tw.load(texturable_entities[0])
+  #   if length < tw.length
+  #     puts("A new entity was successfully loaded into the writer.")
+  #   end
+  #
+  # @return [Integer] length - the number of textures loaded in the texture
+  #   writer
+  #
+  # @version SketchUp 6.0
+  def length
+  end
+
+  # The load method is used to load one or more textures into the texture writer
+  # for writing out to a file.
+  #
+  # @example
+  #   index = tw.load(texturable_entities[0])
+  #
+  # @example
+  #   index = tw.load(faces[0], true)
+  #
+  # @note If you are passing a face in as the entity argument when loading a
+  #   texture you will have to specify the second boolean argument, side.
+  #   The argument side specifies which side of the face the texture will be
+  #   loaded from.
+  #
+  # @overload load(entity)
+  #
+  #   @param [Sketchup::Entity] entity Image, component instance, group, or layer
+  #                                      to load.
+  #   @return [Integer] handle - the index or handle of the entity that was
+  #                     loaded
+  #
+  # @overload load(face, side)
+  #
+  #   @param [Sketchup::Face] face A face to load.
+  #   @param [Boolean] side        A boolean used to indicate the side of the
+  #                                face being loaded (true if front, false if
+  #                                back).
+  #   @return [Integer] handle - the index or handle of the entity that was
+  #                     loaded
+  #
+  # @version SketchUp 6.0
+  def load(*args)
+  end
+
+  # The write method is used to write an individual textures, within the texture
+  # writer, to a file. An entity's texture must have been loaded into the texture
+  # writer before this method can be used to write it's texture.
+  #
+  # This method will return one of the following status messages. (These are
+  # constants that are defined by the API.)
+  #
+  #   - 0 = FILE_WRITE_OK
+  #   - 1 = FILE_WRITE_FAILED_INVALID_TIFF
+  #   - 2 = FILE_WRITE_FAILED_UNKNOWN
+  #
+  # @example
+  #   tw.load(texturable_entities[0])
+  #   if tw.write(texturable_entities[0], "C:\\textures\\A.jpg") == FILE_WRITE_OK
+  #     puts("JPEG file successfully written.")
+  #   end
+  #
+  # @example
+  #   tw.load(faces[0], true)
+  #   if tw.write(faces[0], true, "C:\\textures\\Face.png") == FILE_WRITE_OK
+  #     puts("PNG file successfully written.")
+  #   end
+  #   if tw.write(faces[0], true, "C:\\textures\\Face.bmp") == FILE_WRITE_OK
+  #     puts("BMP file successfully written.")
+  #   end
+  #   if tw.write(faces[0], true, "C:\\textures\\Face.tif") == FILE_WRITE_OK
+  #     puts("TIFF file successfully written.")
+  #   end
+  #
+  # @note If you are passing a face in as the entity argument when writing a
+  #   texture you will have to specify the boolean argument, side. The argument
+  #   side controls the side of the face from which the texture will be sampled
+  #   before writing it.
+  #
+  # @overload write(entity, filename)
+  #
+  #   @param [Sketchup::Entity] entity An image, component instance, group, or
+  #                                    layer to write.
+  #   @param [String] filename         The name of the file to contain the
+  #                                    texture.
+  #   @return [Integer] status - one of three status messages (see comments.)
+  #
+  # @overload write(entity, side, filename)
+  #
+  #   @param [Sketchup::Entity] entity A face to write.
+  #   @param [Boolean] side            A boolean used to indicate the side of the
+  #                                    face being written (true if front, false
+  #                                    if back).
+  #   @param [String] filename         The name of the file to contain the
+  #                                    texture.
+  #   @return [Integer] status - one of three status messages (see comments.)
+  #
+  # @version SketchUp 6.0
+  def write(*args)
+  end
+
+  # The write_all method is used to write all of the textures within the texture
+  # writer to files. It will return one of three status numbers:
+  #
+  #   - 0 = FILE_WRITE_OK
+  #   - 1 = FILE_WRITE_FAILED_INVALID_TIFF
+  #   - 2 = FILE_WRITE_FAILED_UNKNOWN
+  #
+  # @example
+  #   tw.load(texturable_entities[0]
+  #   tw.load(faces[0], false)
+  #   if tw.write_all("C:\\textures\\", true) == FILE_WRITE_OK
+  #     puts("Texture files were successfully written.")
+  #   end
+  #
+  # @param [String] dirname
+  #   The directory to write to.
+  #
+  # @param [Boolean] filename_format
+  #   true to use 8.3 DOS name format.
+  #
+  # @return [Integer] status - one of three status messages (see comments.)
+  #
+  # @version SketchUp 6.0
+  def write_all(dirname, filename_format)
+  end
+
+end