sketchup-api-stubs 0.7.4 → 0.7.5

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

@@ -1,149 +1,149 @@
-# Copyright:: Copyright 2020 Trimble Inc.
-# License:: The MIT License (MIT)
-
-# SketchUp's drawing axes consist of three colored lines (red, green, blue),
-# usually perpendicular to each other, displayed in the drawing area. The
-# exception is when the user open an instance with a non-orthogonal
-# transformation. The root model transformation is always orthogonal.
-#
-# The drawing axes are used by drawing tools to align the geometry it creates
-# as well as affecting the inference engine.
-#
-# The plane where the red and green axes lines lie is called the ground plane.
-# The term origin, is used to define the place where all of axes lines start or
-# originate.
-#
-# @version SketchUp 2016
-class Sketchup::Axes < Sketchup::Entity
-
-  # Instance Methods
-
-  # The axes method returns the vectors representing the directions of the axes.
-  #
-  # @example
-  #   xaxis, yaxis, zaxis = Sketchup.active_model.axes.axes
-  #
-  # @return Array - an array of three vectors.
-  #
-  # @version SketchUp 2016
-  def axes
-  end
-
-  # The origin method returns the origin of the axes.
-  #
-  # @example
-  #   point = Sketchup.active_model.axes.origin
-  #
-  # @return Point3d - the origin for the axes.
-  #
-  # @version SketchUp 2016
-  def origin
-  end
-
-  # The set method allows the axes to be manipulated. The axes must always be
-  # orthogonal, otherwise an error is thrown.
-  #
-  # @example
-  #   xaxis = Geom::Vector3d.new(3, 5, 0)
-  #   yaxis = xaxis * Z_AXIS
-  #   Sketchup.active_model.axes.set([10,0,0], xaxis, yaxis, Z_AXIS)
-  #
-  # @param origin
-  #   Point3d - The origin to set.
-  #
-  # @param xaxis
-  #   Vector3d - The x axis to set.
-  #
-  # @param yaxis
-  #   Vector3d - The y axis to set.
-  #
-  # @param zaxis
-  #   Vector3d - The z axis to set.
-  #
-  # @return Axes - the axes object being set.
-  #
-  # @version SketchUp 2016
-  def set(origin, xaxis, yaxis, zaxis)
-  end
-
-  # The sketch_plane method returns a plane representing the ground plane of the
-  # axes.
-  #
-  # @example
-  #   plane = Sketchup.active_model.axes.sketch_plane
-  #
-  # @return Array - of 4 numbers that give the coefficients of a
-  #   plane equation.
-  #
-  # @version SketchUp 2016
-  def sketch_plane
-  end
-
-  # The axes method returns the origin and vectors representing the axes.
-  #
-  # @example
-  #   point, xaxis, yaxis, zaxis = Sketchup.active_model.axes.to_a
-  #
-  # @return Array - an array of a point and three vectors.
-  #
-  # @version SketchUp 2016
-  def to_a
-  end
-
-  # The transformation method returns the transformation of the axes. This is
-  # useful when creating tools that respect the model's drawing axes.
-  #
-  # @example
-  #   # Point for a rectangle.
-  #   points = [
-  #     Geom::Point3d.new( 0,  0, 0),
-  #     Geom::Point3d.new(10,  0, 0),
-  #     Geom::Point3d.new(10, 20, 0),
-  #     Geom::Point3d.new( 0, 20, 0)
-  #   ]
-  #   # Transform the points so they are local to the model axes. Otherwise
-  #   # they would be local to the model origin.
-  #   tr = Sketchup.active_model.axes.transformation
-  #   points.each { |point| point.transform!(tr) }
-  #   Sketchup.active_model.active_entities.add_face(points)
-  #
-  # @return Transformation - the transformation for the axes.
-  #
-  # @version SketchUp 2016
-  def transformation
-  end
-
-  # The xaxis method returns the x axis of the axes.
-  #
-  # @example
-  #   vector = Sketchup.active_model.axes.xaxis
-  #
-  # @return Vector3d - the x axis for the axes.
-  #
-  # @version SketchUp 2016
-  def xaxis
-  end
-
-  # The yaxis method returns the y axis of the axes.
-  #
-  # @example
-  #   vector = Sketchup.active_model.axes.yaxis
-  #
-  # @return Vector3d - the y axis for the axes.
-  #
-  # @version SketchUp 2016
-  def yaxis
-  end
-
-  # The zaxis method returns the z axis of the axes.
-  #
-  # @example
-  #   vector = Sketchup.active_model.axes.zaxis
-  #
-  # @return Vector3d - the z axis for the axes.
-  #
-  # @version SketchUp 2016
-  def zaxis
-  end
-
-end
+# Copyright:: Copyright 2020 Trimble Inc.
+# License:: The MIT License (MIT)
+
+# SketchUp's drawing axes consist of three colored lines (red, green, blue),
+# usually perpendicular to each other, displayed in the drawing area. The
+# exception is when the user open an instance with a non-orthogonal
+# transformation. The root model transformation is always orthogonal.
+#
+# The drawing axes are used by drawing tools to align the geometry it creates
+# as well as affecting the inference engine.
+#
+# The plane where the red and green axes lines lie is called the ground plane.
+# The term origin, is used to define the place where all of axes lines start or
+# originate.
+#
+# @version SketchUp 2016
+class Sketchup::Axes < Sketchup::Entity
+
+  # Instance Methods
+
+  # The axes method returns the vectors representing the directions of the axes.
+  #
+  # @example
+  #   xaxis, yaxis, zaxis = Sketchup.active_model.axes.axes
+  #
+  # @return Array - an array of three vectors.
+  #
+  # @version SketchUp 2016
+  def axes
+  end
+
+  # The origin method returns the origin of the axes.
+  #
+  # @example
+  #   point = Sketchup.active_model.axes.origin
+  #
+  # @return Point3d - the origin for the axes.
+  #
+  # @version SketchUp 2016
+  def origin
+  end
+
+  # The set method allows the axes to be manipulated. The axes must always be
+  # orthogonal, otherwise an error is thrown.
+  #
+  # @example
+  #   xaxis = Geom::Vector3d.new(3, 5, 0)
+  #   yaxis = xaxis * Z_AXIS
+  #   Sketchup.active_model.axes.set([10,0,0], xaxis, yaxis, Z_AXIS)
+  #
+  # @param origin
+  #   Point3d - The origin to set.
+  #
+  # @param xaxis
+  #   Vector3d - The x axis to set.
+  #
+  # @param yaxis
+  #   Vector3d - The y axis to set.
+  #
+  # @param zaxis
+  #   Vector3d - The z axis to set.
+  #
+  # @return Axes - the axes object being set.
+  #
+  # @version SketchUp 2016
+  def set(origin, xaxis, yaxis, zaxis)
+  end
+
+  # The sketch_plane method returns a plane representing the ground plane of the
+  # axes.
+  #
+  # @example
+  #   plane = Sketchup.active_model.axes.sketch_plane
+  #
+  # @return Array - of 4 numbers that give the coefficients of a
+  #   plane equation.
+  #
+  # @version SketchUp 2016
+  def sketch_plane
+  end
+
+  # The axes method returns the origin and vectors representing the axes.
+  #
+  # @example
+  #   point, xaxis, yaxis, zaxis = Sketchup.active_model.axes.to_a
+  #
+  # @return Array - an array of a point and three vectors.
+  #
+  # @version SketchUp 2016
+  def to_a
+  end
+
+  # The transformation method returns the transformation of the axes. This is
+  # useful when creating tools that respect the model's drawing axes.
+  #
+  # @example
+  #   # Point for a rectangle.
+  #   points = [
+  #     Geom::Point3d.new( 0,  0, 0),
+  #     Geom::Point3d.new(10,  0, 0),
+  #     Geom::Point3d.new(10, 20, 0),
+  #     Geom::Point3d.new( 0, 20, 0)
+  #   ]
+  #   # Transform the points so they are local to the model axes. Otherwise
+  #   # they would be local to the model origin.
+  #   tr = Sketchup.active_model.axes.transformation
+  #   points.each { |point| point.transform!(tr) }
+  #   Sketchup.active_model.active_entities.add_face(points)
+  #
+  # @return Transformation - the transformation for the axes.
+  #
+  # @version SketchUp 2016
+  def transformation
+  end
+
+  # The xaxis method returns the x axis of the axes.
+  #
+  # @example
+  #   vector = Sketchup.active_model.axes.xaxis
+  #
+  # @return Vector3d - the x axis for the axes.
+  #
+  # @version SketchUp 2016
+  def xaxis
+  end
+
+  # The yaxis method returns the y axis of the axes.
+  #
+  # @example
+  #   vector = Sketchup.active_model.axes.yaxis
+  #
+  # @return Vector3d - the y axis for the axes.
+  #
+  # @version SketchUp 2016
+  def yaxis
+  end
+
+  # The zaxis method returns the z axis of the axes.
+  #
+  # @example
+  #   vector = Sketchup.active_model.axes.zaxis
+  #
+  # @return Vector3d - the z axis for the axes.
+  #
+  # @version SketchUp 2016
+  def zaxis
+  end
+
+end

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

@@ -1,328 +1,302 @@
-# Copyright:: Copyright 2020 Trimble Inc.
-# License:: The MIT License (MIT)
-
-# The Behavior class is used to control the "behavior" of components, which
-# roughly correlates to the series of options that you see in the
-# Components dialog under the "edit" tab, such as whether it casts shadows,
-# glues to walls, etc.
-#
-# A Behavior object is accessed from a ComponentDefinition object, not created
-# with a Behavior.new call.
-#
-# @example
-#   # Grab the Behavior object from the first component definition.
-#   model = Sketchup.active_model
-#   definition = model.definitions[0]
-#   behavior = definition.behavior
-#
-# @version SketchUp 6.0
-class Sketchup::Behavior < Sketchup::Entity
-
-  # Instance Methods
-
-  # The always_face_camera= method is used to set the always_face_camera
-  # behavior for a component.
-  #
-  # If the always_face_camera behavior is true, a component will always try to
-  # orient itself so that the Y axis of the component is facing the camera.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   behavior = model.definitions[0].behavior
-  #   status = behavior.always_face_camera = false
-  #
-  # @param setting
-  #   Sets the always_face_camera behavior to true or false.
-  #
-  # @return status - the status of the always_face_camera behavior.
-  #
-  # @version SketchUp 6.0
-  def always_face_camera=(setting)
-  end
-
-  # The always_face_camera? method is used to retrieve the  always_face_camera
-  # behavior for a component.
-  #
-  # If the always_face_camera behavior is true, then a component will always try
-  # to orient itself so that the -Y axis of the component is facing the camera.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   # Returns a DefinitionList
-  #   definitions = model.definitions
-  #   path = Sketchup.find_support_file "Bed.skp",
-  #     "Components/Components Sampler/"
-  #
-  #   begin
-  #     definition = definitions.load path
-  #   rescue
-  #     UI.messagebox $!.message
-  #   end
-  #
-  #   behavior = definition.behavior
-  #   b = behavior.always_face_camera?
-  #   if (b)
-  #     UI.messagebox b
-  #   else
-  #     UI.messagebox "Always Face Camera is equal to false"
-  #   end
-  #   status = behavior.always_face_camera = true
-  #   b = behavior.always_face_camera?
-  #   if (b)
-  #     UI.messagebox b
-  #   else
-  #     UI.messagebox "Failure"
-  #   end
-  #
-  # @return [Boolean] behavior - true if the component is set to always face
-  #   the camera, false if the component is not set to always
-  #   face camera.
-  #
-  # @version SketchUp 6.0
-  def always_face_camera?
-  end
-
-  # The cuts_opening= method is used to set the cut opening behavior for a
-  # component.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   behavior = model.definitions[0].behavior
-  #   status = behavior.cuts_opening = false
-  #   if (status)
-  #     # if status is true, print the status
-  #     UI.messagebox status
-  #   else
-  #     # code to respond cuts_opening being false
-  #   end
-  #
-  # @param setting
-  #   Sets the cuts_opening behavior to true or false.
-  #
-  # @return status - the status of the cuts_opening behavior
-  #   (either true or false)
-  #
-  # @version SketchUp 6.0
-  def cuts_opening=(setting)
-  end
-
-  # The cuts_opening? method is used to get the status of a component's cut
-  # opening behavior.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   behavior = model.definitions[0].behavior
-  #   status = behavior.cuts_opening?
-  #   if (status)
-  #     # if status is true, do something
-  #   else
-  #     # if status is false, do something else
-  #   end
-  #
-  # @return [Boolean] status - the status of the cuts_opening behavior
-  #   (either true or false)
-  #
-  # @version SketchUp 6.0
-  def cuts_opening?
-  end
-
-  # The is2d= method is used to set the 2D behavior for a component: whether it
-  # can be glued or aligned to a face.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   behavior = model.definitions[0].behavior
-  #   status = behavior.is2d = false
-  #   if (status)
-  #     # if status is true, print the status
-  #     UI.messagebox status
-  #   else
-  #     # code to respond is2d behavior being false
-  #   end
-  #
-  # @param setting
-  #   Sets the 2D behavior to true or false.
-  #
-  # @return status - the new setting
-  #
-  # @version SketchUp 6.0
-  def is2d=(setting)
-  end
-
-  # The is2d? method is used to get the 2D behavior for a component: whether it
-  # can be glued or aligned to a face.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   behavior = model.definitions[0].behavior
-  #   status = behavior.is2d?
-  #   if (status)
-  #     # if status is true, do something
-  #   else
-  #     # if status is false, do something else
-  #   end
-  #
-  # @return [Boolean] status - the status of the 2D behavior (either true or
-  #   false)
-  #
-  # @version SketchUp 6.0
-  def is2d?
-  end
-
-  # Sets an integer that is really a bit-by-bit description of which scale
-  # tool handles are hidden on a given component. This is useful for creating
-  # definitions that can only be scaled in particular ways. If a bit contains a
-  # a 1, then a certain handle set will be hidden when the user selects the
-  # component and activates the Scale tool. Here is the map of which bits
-  # control which handles.
-  #
-  # - Bit0: disable scale along red (X),
-  # - Bit1: disable scale along green (Y),
-  # - Bit2: disable scale along blue (Z),
-  # - Bit3: disable scale in red/blue plane (X+Z),
-  # - Bit4: disable scale in green/blue plane (Y+Z),
-  # - Bit5: disable scale in red/green plane (X+Y),
-  # - Bit6: disable scale uniform (from corners) (XYZ).
-  #
-  # Note that for 2-dimensional components (such as face-me components), not all
-  # of the handles in the list above are even used. Also, if the component you
-  # are modifying is already selected with the scale tool, then you or your user
-  # must deactivate and reactivate the scale tool for your new behavior to take
-  # effect.
-  #
-  # @example
-  #   # Disable the green and red-axes handles by setting bits 1 and 2 to 1.
-  #   definition = Sketchup.active_model.definitions[0]
-  #   behavior = definition.behavior
-  #   behavior.no_scale_mask = (1 << 1) + (1 << 2)
-  #
-  # @param scale_mask
-  #   An integer describing which scale tool
-  #   handles are hidden.
-  #
-  # @return behavior - the Behavior object
-  #
-  # @version SketchUp 7.0
-  def no_scale_mask=(scale_mask)
-  end
-
-  # The no_scale_mask? method returns an integer that is a bit-by-bit
-  # description of which scale tool handles are hidden when the user selects
-  # this single component with the scale tool. See the no_scale_mask=
-  # method for details on the bit encodings used.
-  #
-  # @example
-  #   definition = Sketchup.active_model.definitions[0]
-  #   behavior = definition.behavior
-  #   no_scale_mask = behavior.no_scale_mask?
-  #
-  # @return [Boolean] scale_mask - an integer describing which scale tool
-  #   handles are hidden.
-  #
-  # @version SketchUp 7.0
-  def no_scale_mask?
-  end
-
-  # The shadows_face_sun= method is used to identify whether the component's
-  # shadow will be cast from the component's current position as though the
-  # component were facing the sun. See the Component entity within the SketchUp
-  # User's guide for more information on this feature.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   behavior = model.definitions[0].behavior
-  #   behavior = behavior.shadows_face_sun = true
-  #
-  # @param status
-  #   true if the component's is to be cast from the
-  #   component's current position as though the component
-  #   were facing the sun. False to cause the shadow to be
-  #   cast from the component's current position.
-  #
-  # @return behavior - the Behavior object
-  #
-  # @version SketchUp 6.0
-  def shadows_face_sun=(status)
-  end
-
-  # The shadows_face_sun? method is used to determine whether the component's
-  # shadow is being cast from the component's current position (as though the
-  # component were facing the sun). See the Component entity within the SketchUp
-  # User's guide for more information on this feature.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   # Returns a DefinitionList
-  #   definitions = model.definitions
-  #   path = Sketchup.find_support_file "Bed.skp",
-  #     "Components/Components Sampler/"
-  #   begin
-  #     definition = definitions.load path
-  #   rescue
-  #     UI.messagebox $!.message
-  #   end
-  #
-  # @return [Boolean] status - true if the component's is to be cast from the
-  #   component's current position as though the component
-  #   were facing the sun. False to cause the shadow to be
-  #   cast from the component's current position.
-  #
-  # @version SketchUp 6.0
-  def shadows_face_sun?
-  end
-
-  # The snapto method is used to verify the status of a component's "snap to"
-  # behavior.
-  #
-  # Returns a constant indicating the snapping behavior of the component
-  # described by behavior. Snapping behavior is how the x-y plane of a component
-  # instance will be snapped against a face. Possible values are:
-  #
-  # - +SnapTo_Arbitrary+ => Snap to any aribrary face,
-  # - +SnapTo_Horizontal+ => Snap to horizontal face like floors,
-  # - +SnapTo_Vertical+ => Snap to vertical face like walls,
-  # - +SnapTo_Sloped+ => Snap to sloped face like sloping roofs.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   behavior = model.definitions[0].behavior
-  #   status = behavior.snapto
-  #   if (status)
-  #     # if status is true, do something
-  #   else
-  #     # if status is false, do something else
-  #   end
-  #
-  # @return status - the status of the snapto behavior (either true
-  #   or false)
-  #
-  # @version SketchUp 6.0
-  def snapto
-  end
-
-  # The snapto= method sets a component's "snap to" behavior.
-  #
-  # Snapping behavior is how the x-y plane of a component instance will be
-  # snapped against a face. Possible constant values are:
-  #
-  # - +SnapTo_Arbitrary+ => Snap to any aribrary face,
-  # - +SnapTo_Horizontal+ => Snap to horizontal face like floors,
-  # - +SnapTo_Vertical+ => Snap to vertical face like walls,
-  # - +SnapTo_Sloped+ => Snap to sloped face like sloping roofs.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   behavior = model.definitions[0].behavior
-  #   behavior.snapto = SnapTo_Horizontal
-  #
-  # @param snapto
-  #   A numeric constant identifying one of the snapto
-  #   types.
-  #
-  # @return behavior - the Behavior object
-  #
-  # @version SketchUp 6.0
-  def snapto=(snapto)
-  end
-
-end
+# Copyright:: Copyright 2020 Trimble Inc.
+# License:: The MIT License (MIT)
+
+# The Behavior class is used to control the "behavior" of components, which
+# roughly correlates to the series of options that you see in the
+# Components dialog under the "edit" tab, such as whether it casts shadows,
+# glues to walls, etc.
+#
+# A Behavior object is accessed from a ComponentDefinition object, not created
+# with a Behavior.new call.
+#
+# @example
+#   # Grab the Behavior object from the first component definition.
+#   model = Sketchup.active_model
+#   definition = model.definitions[0]
+#   behavior = definition.behavior
+#
+# @version SketchUp 6.0
+class Sketchup::Behavior < Sketchup::Entity
+
+  # Instance Methods
+
+  # The always_face_camera= method is used to set the always_face_camera
+  # behavior for a component.
+  #
+  # If the always_face_camera behavior is true, a component will always try to
+  # orient itself so that the Y axis of the component is facing the camera.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   behavior = model.definitions[0].behavior
+  #   status = behavior.always_face_camera = false
+  #
+  # @param setting
+  #   Sets the always_face_camera behavior to true or false.
+  #
+  # @return status - the status of the always_face_camera behavior.
+  #
+  # @version SketchUp 6.0
+  def always_face_camera=(setting)
+  end
+
+  # The always_face_camera? method is used to retrieve the  always_face_camera
+  # behavior for a component.
+  #
+  # If the always_face_camera behavior is true, then a component will always try
+  # to orient itself so that the -Y axis of the component is facing the camera.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   # Returns a DefinitionList
+  #   definitions = model.definitions
+  #   path = Sketchup.find_support_file "Bed.skp",
+  #     "Components/Components Sampler/"
+  #
+  #   begin
+  #     definition = definitions.load path
+  #   rescue
+  #     UI.messagebox $!.message
+  #   end
+  #
+  #   behavior = definition.behavior
+  #   b = behavior.always_face_camera?
+  #   if (b)
+  #     UI.messagebox b
+  #   else
+  #     UI.messagebox "Always Face Camera is equal to false"
+  #   end
+  #   status = behavior.always_face_camera = true
+  #   b = behavior.always_face_camera?
+  #   if (b)
+  #     UI.messagebox b
+  #   else
+  #     UI.messagebox "Failure"
+  #   end
+  #
+  # @return [Boolean] behavior - true if the component is set to always face
+  #   the camera, false if the component is not set to always
+  #   face camera.
+  #
+  # @version SketchUp 6.0
+  def always_face_camera?
+  end
+
+  # The cuts_opening= method is used to set the cut opening behavior for a
+  # component.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   behavior = model.definitions[0].behavior
+  #   behavior.cuts_opening = false
+  #
+  # @note To enable cut opening, also set {#is2d=} to true.
+  #
+  # @param setting
+  #   Sets the cuts_opening behavior to true or false.
+  #
+  # @return status - the status of the cuts_opening behavior
+  #   (either true or false)
+  #
+  # @version SketchUp 6.0
+  def cuts_opening=(setting)
+  end
+
+  # The cuts_opening? method is used to get the status of a component's cut
+  # opening behavior.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   behavior = model.definitions[0].behavior
+  #   status = behavior.cuts_opening?
+  #
+  # @return [Boolean]
+  #
+  # @version SketchUp 6.0
+  def cuts_opening?
+  end
+
+  # The {#is2d=} method is used to set whether the component can glue to other
+  # entities or not.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   behavior = model.definitions[0].behavior
+  #   behavior.is2d = false
+  #
+  # @param [Boolean] is2d
+  #
+  # @version SketchUp 6.0
+  def is2d=(is2d)
+  end
+
+  # The {#is2d?} method is used to get whether the component can glue to other
+  # entities or not.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   behavior = model.definitions[0].behavior
+  #   if behavior.is2d?
+  #     # We can also set what planes component can glue to.
+  #     behavior.snapto = SnapTo_Arbitrary
+  #   end
+  #
+  # @return [Boolean]
+  #
+  # @version SketchUp 6.0
+  def is2d?
+  end
+
+  # Sets an integer that is really a bit-by-bit description of which scale
+  # tool handles are hidden on a given component. This is useful for creating
+  # definitions that can only be scaled in particular ways. If a bit contains a
+  # a 1, then a certain handle set will be hidden when the user selects the
+  # component and activates the Scale tool. Here is the map of which bits
+  # control which handles.
+  #
+  # - Bit0: disable scale along red (X),
+  # - Bit1: disable scale along green (Y),
+  # - Bit2: disable scale along blue (Z),
+  # - Bit3: disable scale in red/blue plane (X+Z),
+  # - Bit4: disable scale in green/blue plane (Y+Z),
+  # - Bit5: disable scale in red/green plane (X+Y),
+  # - Bit6: disable scale uniform (from corners) (XYZ).
+  #
+  # Note that for 2-dimensional components (such as face-me components), not all
+  # of the handles in the list above are even used. Also, if the component you
+  # are modifying is already selected with the scale tool, then you or your user
+  # must deactivate and reactivate the scale tool for your new behavior to take
+  # effect.
+  #
+  # @example
+  #   # Disable the green and red-axes handles by setting bits 1 and 2 to 1.
+  #   definition = Sketchup.active_model.definitions[0]
+  #   behavior = definition.behavior
+  #   behavior.no_scale_mask = (1 << 1) + (1 << 2)
+  #
+  # @param scale_mask
+  #   An integer describing which scale tool
+  #   handles are hidden.
+  #
+  # @return behavior - the Behavior object
+  #
+  # @version SketchUp 7.0
+  def no_scale_mask=(scale_mask)
+  end
+
+  # The no_scale_mask? method returns an integer that is a bit-by-bit
+  # description of which scale tool handles are hidden when the user selects
+  # this single component with the scale tool. See the no_scale_mask=
+  # method for details on the bit encodings used.
+  #
+  # @example
+  #   definition = Sketchup.active_model.definitions[0]
+  #   behavior = definition.behavior
+  #   no_scale_mask = behavior.no_scale_mask?
+  #
+  # @return [Boolean] scale_mask - an integer describing which scale tool
+  #   handles are hidden.
+  #
+  # @version SketchUp 7.0
+  def no_scale_mask?
+  end
+
+  # The shadows_face_sun= method is used to identify whether the component's
+  # shadow will be cast from the component's current position as though the
+  # component were facing the sun. See the Component entity within the SketchUp
+  # User's guide for more information on this feature.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   behavior = model.definitions[0].behavior
+  #   behavior = behavior.shadows_face_sun = true
+  #
+  # @param status
+  #   true if the component's is to be cast from the
+  #   component's current position as though the component
+  #   were facing the sun. False to cause the shadow to be
+  #   cast from the component's current position.
+  #
+  # @return behavior - the Behavior object
+  #
+  # @version SketchUp 6.0
+  def shadows_face_sun=(status)
+  end
+
+  # The shadows_face_sun? method is used to determine whether the component's
+  # shadow is being cast from the component's current position (as though the
+  # component were facing the sun). See the Component entity within the SketchUp
+  # User's guide for more information on this feature.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   # Returns a DefinitionList
+  #   definitions = model.definitions
+  #   path = Sketchup.find_support_file "Bed.skp",
+  #     "Components/Components Sampler/"
+  #   begin
+  #     definition = definitions.load path
+  #   rescue
+  #     UI.messagebox $!.message
+  #   end
+  #
+  # @return [Boolean] status - true if the component's is to be cast from the
+  #   component's current position as though the component
+  #   were facing the sun. False to cause the shadow to be
+  #   cast from the component's current position.
+  #
+  # @version SketchUp 6.0
+  def shadows_face_sun?
+  end
+
+  # The {#snapto} method is used to see how a component can glue to other
+  # entities.
+  #
+  # Returns a value indicating the snapping behavior of the component. Snapping
+  # behavior is how the x-y plane of a component instance will be snapped against
+  # a face. Possible values are:
+  #
+  # - +SnapTo_Arbitrary+ => Snap to any arbitrary face,
+  # - +SnapTo_Horizontal+ => Snap to horizontal face like floors,
+  # - +SnapTo_Vertical+ => Snap to vertical face like walls,
+  # - +SnapTo_Sloped+ => Snap to sloped face like sloping roofs.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   behavior = model.definitions[0].behavior
+  #   snapto = behavior.snapto
+  #
+  # @return [Integer]
+  #
+  # @version SketchUp 6.0
+  def snapto
+  end
+
+  # The {#snapto=} method is used to set how a component can glue to other
+  # entities.
+  #
+  # Snapping behavior is how the x-y plane of a component instance will be
+  # snapped against a face. Possible constant values are:
+  #
+  # - +SnapTo_Arbitrary+ => Snap to any arbitrary face,
+  # - +SnapTo_Horizontal+ => Snap to horizontal face like floors,
+  # - +SnapTo_Vertical+ => Snap to vertical face like walls,
+  # - +SnapTo_Sloped+ => Snap to sloped face like sloping roofs.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   behavior = model.definitions[0].behavior
+  #   behavior.is2d = true
+  #   behavior.snapto = SnapTo_Horizontal
+  #
+  # @note To enable gluing, also set {#is2d=} to true.
+  #
+  # @note To disable gluing, set {#is2d=} to false.
+  #
+  # @param [Integer] snapto
+  #
+  # @version SketchUp 6.0
+  def snapto=(snapto)
+  end
+
+end