Class: Sketchup::Group

Relationships
Super Chains via Extension / Inclusion / Inheritance
Class Chain: self, `Drawingelement`, `Entity`
Instance Chain: self, `Drawingelement`, `Entity`
Inherits:	Sketchup::Drawingelement Object Sketchup::Entity Sketchup::Drawingelement Sketchup::Group

Overview

A Group class contains methods for manipulating groups of entities.

Groups in SketchUp are very similar to components, but can from a user point of view be thought of as unique objects. Groups can be instanced when copied but are silently made unique when edited through the GUI. To honor this behavior, make sure to call #make_unique before modifying a group through the API.

Version:

SketchUp 6.0

Instance Attribute Summary

#description ⇒ String rw

The description method is used to retrieve the description for the group.
#description=(description) ⇒ String rw

The description= method is used to set the description for the group.
#glued_to ⇒ Sketchup::Face, ... rw

The #glued_to method is used to retrieve the entity that this group is glued to.
#glued_to=(drawing_element) ⇒ Sketchup::Face, ... rw

The #glued_to= method glues this group to a drawing element.
#locked=(lock) ⇒ Boolean rw

The locked= method is used to lock a group.
#locked? ⇒ Boolean rw

The locked? method is used to determine if a group is locked.
#manifold? ⇒ Boolean readonly

The manifold? method is used to determine if a group is manifold.
#name ⇒ String rw

The name method is used to retrieve the name of the group.
#name=(name) ⇒ String rw

The name= method is used to set the description for the group.
#transformation ⇒ Geom::Transformation rw

The transformation method is used to retrieve the transformation for the group.
#transformation=(transformation) rw

The #transformation= method is used to set the transformation of this group.

`Drawingelement` - Inherited

#casts_shadows=	The casts_shadows= method is used to set the `Drawingelement` to cast shadows.
#casts_shadows?	The casts_shadows? method is used to determine if the `Drawingelement` is casting shadows.
#hidden=	The hidden= method is used to set the hidden status for an element.
#hidden?	The hidden? method is used to determine if the element is hidden.
#layer	The layer method is used to retrieve the `Layer` object of the drawing element.
#layer=	The layer= method is used to set the layer for the drawing element.
#material	The material method is used to retrieve the material for the drawing element.
#material=	The material= method is used to set the material for the drawing element.
#receives_shadows=	The receive_shadows= method is used to set the `Drawingelement` to receive shadows.
#receives_shadows?	The receive_shadows? method is used to determine if the `Drawingelement` is receiving shadows.
#visible=	The visible= method is used to set the visible status for an element.
#visible?	The visible? method is used to get the visible status for an element.

`Entity` - Inherited

#deleted?	The deleted? method is used to determine if your entity is still valid (not deleted by another script, for example.).
#valid?	The `#valid?` method is used to determine if your entity is still valid (not deleted by another script, for example).

Instance Method Summary

#add_observer(observer) ⇒ Boolean

The add_observer method is used to add a ComponentInstance observer to the group.
#copy ⇒ Sketchup::Group

The copy method is used to create a new Group object that is a copy of the group.
#definition ⇒ Sketchup::ComponentDefinition

The definition method is used to retrieve the component definition for this group.
#entities ⇒ Sketchup::Entities

The entities method is used to retrieve a collection of entities in the group.
#equals?(group) ⇒ Boolean

The equals? method is used to determine if a group is geometrically equivalent to another group.
#explode ⇒ Array<Sketchup::Drawingelement>

The explode method is used to explode the group into individual entities.
#guid ⇒ String

The guid method is used to get the base 64 encoded unique id for this SketchUp object.
#intersect(group) ⇒ Sketchup::Group^?

The intersect method is used to compute the boolean intersection of two groups representing manifold solid volumes (this & arg).
#local_bounds ⇒ Geom::BoundingBox deprecated Deprecated.

In favor of ‘group.definition.bounds`.
#make_unique ⇒ Sketchup::Group

The #make_unique method is used to force a group to have a unique definition.
#move!(transformation) ⇒ Sketchup::Group

The #move! method is used to set the transformation of this group instance, similarly to #transformation= but without recording to the undo stack.
#outer_shell(group) ⇒ Sketchup::Group^?

The outer_shell method is used to compute the outer shell of the two groups representing manifold solid volumes (this || arg).
#remove_observer(observer) ⇒ Boolean

The remove_observer method is used to remove a ComponentInstance observer from the group.
#show_differences(group, verbose) ⇒ Boolean

The show_differences method is used to determine if a group is geometrically equivalent to another group and in addition move the non- matching and matching geometry to new layers.
#split(group) ⇒ Array(Sketchup::Group, Sketchup::Group, Sketchup::Group)^?

The split method is used to compute the boolean split (map overlay) of the two groups representing manifold solid volumes (this ^ arg).
#subtract(group) ⇒ Sketchup::Group^?

The subtract method is used to compute the boolean difference of the two groups representing manifold solid volumes (this - arg).
#to_component ⇒ Sketchup::ComponentInstance

The to_component method is used to convert the group to a component instance.
#transform!(transform) ⇒ Sketchup::Group

The transform! method is used to apply a transformation to a group.
#trim(group) ⇒ Sketchup::Group^?

The trim method is used to compute the (non-destructive) boolean difference of the two groups representing manifold solid volumes (this - arg).
#union(group) ⇒ Sketchup::Group^?

The union method is used to compute the boolean union of the two groups representing manifold solid volumes (this | arg).
#volume ⇒ Float

The volume method is used to compute the volume of this group if and only if this group is manifold.

`Drawingelement` - Inherited

#bounds	The `#bounds` method is used to retrieve the `::Geom::BoundingBox` bounding a `Drawingelement`.
#erase!	The `#erase!` method is used to erase an element from the model.

`Entity` - Inherited

#add_observer	The add_observer method is used to add an observer to the current object.
#attribute_dictionaries	The attribute_dictionaries method is used to retrieve the `AttributeDictionaries` collection attached to the entity.
#attribute_dictionary	The attribute_dictionary method is used to retrieve an attribute dictionary with a given name that is attached to an `Entity`.
#delete_attribute	The `#delete_attribute` method is used to delete an attribute from an entity.
#entityID	The entityID method is used to retrieve a unique ID assigned to an entity.
#get_attribute	The `#get_attribute` method is used to retrieve the value of an attribute in the entity’s attribute dictionary.
#inspect	The `#inspect` method is used to retrieve the string representation of the entity.
#model	The model method is used to retrieve the model for the entity.
#parent	The parent method is used to retrieve the parent of the entity.
#persistent_id	The `#persistent_id` method is used to retrieve a unique persistent id assigned to an entity.
#remove_observer	The remove_observer method is used to remove an observer from the current object.
#set_attribute	The set attribute is used to set the value of an attribute in an attribute dictionary with the given name.
#to_s	The `#to_s` method is used to retrieve the string representation of the entity.
#typename	The typename method retrieves the type of the entity, which will be a string such as “Face”, “Edge”, or “Group”.

Instance Attribute Details

#description ⇒ String (rw)

The description method is used to retrieve the description for the group.

Examples:

depth = 100
width = 100
model = Sketchup.active_model
entities = model.active_entities
pts = []
pts[0] = [0, 0, 0]
pts[1] = [width, 0, 0]
pts[2] = [width, depth, 0]
pts[3] = [0, depth, 0]
# Add the group to the entities in the model
group = entities.add_group

# Get the entities within the group
entities2 = group.entities

# Add a face to within the group
face = entities2.add_face pts
group.description = "This is a Group with a 2d Face"
description = group.description

Returns:

(String) —

a string description if successful

Version:

SketchUp 6.0

#description=(description) ⇒ String (rw)

The description= method is used to set the description for the group.

Examples:

depth = 100
width = 100
model = Sketchup.active_model
entities = model.active_entities
pts = []
pts[0] = [0, 0, 0]
pts[1] = [width, 0, 0]
pts[2] = [width, depth, 0]
pts[3] = [0, depth, 0]

# Add the group to the entities in the model
group = entities.add_group

# Get the entities within the group
entities2 = group.entities

# Add a face to within the group
face = entities2.add_face pts
group.description = "This is a Group with a 2d Face"
description = group.description
if (description)
  UI.messagebox description
else
  UI.messagebox "Failure"
end

Parameters:

description (String) —

A string description.

Returns:

(String) —

the new description if successful

Version:

SketchUp 6.0

#glued_to ⇒ Sketchup::Face, ... (rw)

The #glued_to method is used to retrieve the entity that this group is glued to.

Examples:

point = Geom::Point3d.new(10, 20, 30)
transform = Geom::Transformation.new(point)
model = Sketchup.active_model
entities = model.active_entities
group = entities.add_group
group.entities.add_face([[0, 0, 0], [10, 0, 0], [10, 10, 0], [0, 10, 0]])
status = group.glued_to

Version:

SketchUp 2021.1

#glued_to=(drawing_element) ⇒ Sketchup::Face, ... (rw)

The glued_to= method glues this group to a drawing element. When moving this other drawing elment with the Move tool, the glued group moves with it.

Examples:

model = Sketchup.active_model
entities = model.active_entities

# Create a face
face = entities.add_face([[0, 0, 0], [100, 0, 0], [100, 100, 0], [0, 100, 0]])

# Create a group
definitions = model.definitions
group = entities.add_group
group.entities.add_face([[0, 0, 0], [10, 0, 0], [10, 10, 0], [0, 10, 0]])

# Make group "gluable"
group.definition.behavior.is2d = true

# Glue the group to the face.
# If you now move the face, the group will follow.
group.glued_to = face

Parameters:

drawing_element (Sketchup::Face, Group, Sketchup::ComponentInstance, Sketchup::Image, nil)

Returns:

(Sketchup::Face, Group, Sketchup::ComponentInstance, Sketchup::Image, nil) —

the entity the group was glued to.

Raises:

ArgumentError if the Behavior for this group doesn’t allow gluing, if the alignment is wrong, or if this would lead to cyclic gluing.

Version:

SketchUp 2021.1

#locked=(lock) ⇒ `Boolean` (rw)

The locked= method is used to lock a group.

Examples:

# Add a group to the model.
group = Sketchup.active_model.entities.add_group
group.entities.add_line([0,0,0],[100,100,100])
status = group.locked = true

Parameters:

lock (Boolean)

Returns:

(Boolean) —

true if the group is locked, false if not

Version:

SketchUp 6.0

#locked? ⇒ `Boolean` (rw)

The locked? method is used to determine if a group is locked.

Examples:

depth = 100
width = 100
model = Sketchup.active_model
entities = model.active_entities
pts = []
pts[0] = [0, 0, 0]
pts[1] = [width, 0, 0]
pts[2] = [width, depth, 0]
pts[3] = [0, depth, 0]

# Add the group to the entities in the model
group = entities.add_group
status = group.locked?
UI.messagebox status

Version:

SketchUp 6.0

#manifold? ⇒ `Boolean` (readonly)

The manifold? method is used to determine if a group is manifold.

Examples:

entities = Sketchup.active_model.entities
definition = Sketchup.active_model.definitions[0]
transformation = Geom::Transformation.new([0,0,0])
group = entities.add_instance(definition, transformation)
status = group.manifold?

Version:

SketchUp 8.0

#name ⇒ String (rw)

The name method is used to retrieve the name of the group.

Examples:

# Add a group to the model.
group = Sketchup.active_model.entities.add_group
group.entities.add_line([0,0,0],[100,100,100])
group.name = "A Line"
name = group.name

Returns:

(String) —

The name of the group if successful

Version:

SketchUp 6.0

#name=(name) ⇒ String (rw)

The name= method is used to set the description for the group.

Examples:

# Add a group to the model.
group = Sketchup.active_model.entities.add_group
group.entities.add_line([0,0,0],[100,100,100])
group.name = "A Line"
name = group.name

Parameters:

name (String) —

A string name.

Returns:

(String) —

a new name if successful

Version:

SketchUp 6.0

#transformation ⇒ Geom::Transformation (rw)

The transformation method is used to retrieve the transformation for the group.

Examples:

# Add a group to the model.
group = Sketchup.active_model.entities.add_group
group.entities.add_line([0,0,0],[100,100,100])

trans = group.transformation

Returns:

(Geom::Transformation) —

a Transformation object if successful

Version:

SketchUp 6.0

#transformation=(transformation) (rw)

The #transformation= method is used to set the transformation of this group

Examples:

# Add a group to the model.
group = Sketchup.active_model.entities.add_group
group.entities.add_line([0,0,0],[100,100,100])

new_transformation = Geom::Transformation.new([100,0,0])
group.transformation = new_transformation

Parameters:

transformation (Geom::Transformation)

Version:

SketchUp 6.0

Instance Method Details

#add_observer(observer) ⇒ `Boolean`

The add_observer method is used to add a ComponentInstance observer to the group.

Examples:

# Add a group to the model.
group = Sketchup.active_model.entities.add_group
group.entities.add_line([0,0,0],[100,100,100])
status = group.add_observer observer

Parameters:

observer (Object) —

An observer.

Returns:

(Boolean) —

true if successful, false if unsuccessful.

Version:

SketchUp 6.0

#copy ⇒ `Group`

The copy method is used to create a new Group object that is a copy of the group.

Examples:

# Add a group to the model.
group = Sketchup.active_model.entities.add_group
group.entities.add_line([0,0,0],[100,100,100])
group2 = group.copy

Returns:

(Group) —

a new Group object

Version:

SketchUp 6.0

#definition ⇒ Sketchup::ComponentDefinition

The definition method is used to retrieve the component definition for this group.

Examples:

group = Sketchup.active_model.entities.add_group
definition = group.definition

Returns:

(Sketchup::ComponentDefinition) —

a ComponentDefinition object if successful

Version:

SketchUp 2015

#entities ⇒ Sketchup::Entities

The entities method is used to retrieve a collection of entities in the group.

Examples:

depth = 100
width = 100
model = Sketchup.active_model
entities = model.active_entities
pts = []
pts[0] = [0, 0, 0]
pts[1] = [width, 0, 0]
pts[2] = [width, depth, 0]
pts[3] = [0, depth, 0]
# Add the group to the entities in the model
group = entities.add_group

# Get the entities within the group
entities2 = group.entities

# Add a face to within the group
face = entities2.add_face pts
entities = group.entities
if (entities)
  UI.messagebox entities
else
  UI.messagebox "Failure"
end

Returns:

(Sketchup::Entities) —

an Entities object if successful

Version:

SketchUp 6.0

#equals?(group) ⇒ `Boolean`

The equals? method is used to determine if a group is geometrically equivalent to another group.

Examples:

entities = Sketchup.active_model.entities
group1 = entities[0]
group2 = entities[1]
status = group1.equals?(group2)

Parameters:

group (Group) —

The group to compare this group with.

Version:

SketchUp 8.0

#explode ⇒ Array<Sketchup::Drawingelement>

The explode method is used to explode the group into individual entities.

Examples:

# Add a group to the model.
group = Sketchup.active_model.entities.add_group
group.entities.add_line([0,0,0],[100,100,100])

array = group.explode
if array
  UI.messagebox "Exploded the group"
else
  UI.messagebox "Failure"
end

Returns:

(Array<Sketchup::Drawingelement>) —

An array of entity objects if successful, false if unsuccessful.

Version:

SketchUp 6.0

#guid ⇒ String

The guid method is used to get the base 64 encoded unique id for this SketchUp object.

Examples:

# Add a group to the model.
group = Sketchup.active_model.entities.add_group
group.entities.add_line([0,0,0],[100,100,100])
guid = group.guid

Returns:

(String) —

a unique 22 character string

Version:

SketchUp 2014

#intersect(group) ⇒ `Group`^?

Note:

This method is not available in SketchUp Make.

The intersect method is used to compute the boolean intersection of two groups representing manifold solid volumes (this & arg). If the specified objects (this and arg) do not represent manifold volumes, this method fails.

Examples:

entities = Sketchup.active_model.entities
group1 = entities[0]
group2 = entities[1]
result = group1.intersect(group2)

Parameters:

group (Group, Sketchup::ComponentInstance) —

The group to intersect this group with.

Returns:

(Group, nil) —

The resultant group if the two objects (this and arg) represent manifold solids and the operation succeeds. Otherwise nil is returned.

Version:

SketchUp 8.0

#local_bounds ⇒ Geom::BoundingBox

Deprecated.

In favor of ‘group.definition.bounds`.

The #local_bounds method is used to retrieve the ::Geom::BoundingBox bounding the contents of a Group, in the group’s own internal coordinate system.

Examples:

# Add a group to the model.
group = Sketchup.active_model.entities.add_group
group.entities.add_line([0,0,0],[100,100,100])
transformation = Geom::Transformation.new([100,0,0])

# Note that local_bounds_1 and local_bounds_2 will be identical, since
# they both find the bounding box in group's untransformed state.
local_bounds_1 = group.local_bounds
group.transform! transformation
local_bounds_2 = group.local_bounds

Version:

SketchUp 7.0

#make_unique ⇒ `Group`

The #make_unique method is used to force a group to have a unique definition. If the group is already unique in the model, nothing happens.

Copying a group in SketchUp will create a group that shares the same definition. SketchUp implicitly makes group unique when edited from the GUI, and from a user point of view groups could be thought of as always being unique. To honor this behavior, call this method before editing a group through the API.

Examples:

# Assume we have 2 groups, one copied from the other and sharing definitions
groups = Sketchup.active_model.entities.grep(Sketchup::Group)
groups[0].make_unique
if (groups[0].entities.to_a == groups[1].entities.to_a)
  puts "This should not happen since we made the groups unique"
end

Returns:

(Group) —

the unique group

Version:

SketchUp 6.0

#move!(transformation) ⇒ `Group`

Note:

Despite the name being similar to #transform!, this method closer corresponds to #transformation=.

The #move! method is used to set the transformation of this group instance, similarly to #transformation= but without recording to the undo stack.

This method is useful for moving entities inside of an animation or page transition.

Examples:

point = Geom::Point3d.new 500,500,500
transformation = Geom::Transformation.new point
depth = 100
width = 100
model = Sketchup.active_model
entities = model.active_entities
pts = []
pts[0] = [0, 0, 0]
pts[1] = [width, 0, 0]
pts[2] = [width, depth, 0]
pts[3] = [0, depth, 0]

# Add the group to the entities in the model
group = entities.add_group

# Get the entities within the group
entities2 = group.entities

# Add a face to within the group
face = entities2.add_face pts
UI.messagebox "Group before Move"
group = group.move!(transformation)

Parameters:

transformation (Geom::Transformation)

Returns:

(Group) —

the transformed Group object if successful

Version:

SketchUp 6.0

#outer_shell(group) ⇒ `Group`^?

The outer_shell method is used to compute the outer shell of the two groups representing manifold solid volumes (this || arg). If the specified objects (this and arg) do not represent manifold volumes, this method fails.

Examples:

entities = Sketchup.active_model.entities
group1 = entities[0]
group2 = entities[1]
result = group1.outer_shell(group2)

Parameters:

group (Group, Sketchup::ComponentInstance) —

The group to outer shell this group with.

Returns:

(Group, nil) —

The resultant group if the two objects (this and arg) represent manifold solids and the operation succeeds otherwise nil is returned.

Version:

SketchUp 8.0

#remove_observer(observer) ⇒ `Boolean`

The remove_observer method is used to remove a ComponentInstance observer from the group.

Examples:

group = Sketchup.active_model.entities[0]
if group != nil
  if group.is_a? Sketchup::Group
    status = group.remove_observer observer
  end
end

Parameters:

observer (Object) —

An observer.

Returns:

(Boolean) —

true if successful, false if unsuccessful.

Version:

SketchUp 6.0

#show_differences(group, verbose) ⇒ `Boolean`

The show_differences method is used to determine if a group is geometrically equivalent to another group and in addition move the non- matching and matching geometry to new layers.

This method will move both groups to Layer0. Geometry that is the same in both groups will be moved to a new layer named group_name + “_same”. Geometry that is not the same will be moved to a layer named group_name + “_diff”.

If verbose is true, a list of all the geometry that is different from one group to the other is displayed texturally in the Ruby Console.

Examples:

entities = Sketchup.active_model.entities
group1 = entities[0]
group2 = entities[1]
status = group1.show_differences(group2, true)

Parameters:

group (Group, Sketchup::ComponentInstance) —

The group to be compared with.
verbose (Boolean) —

A boolean flag indicating whether to display a textural report of the found differences to the Ruby console.

Returns:

(Boolean) —

true if the groups are geometrically equivalent. Otherwise false.

Version:

SketchUp 8.0

#split(group) ⇒ Array(`Group`, `Group`, `Group`)^?

Note:

This method is not available in SketchUp Make.

The split method is used to compute the boolean split (map overlay) of the two groups representing manifold solid volumes (this ^ arg). If the specified objects (this and arg) do not represent manifold volumes, this method fails.

Examples:

entities = Sketchup.active_model.entities
group1 = entities[0]
group2 = entities[1]
result = group1.split(group2)

Parameters:

group (Group, Sketchup::ComponentInstance) —

The group to split this group with.

Returns:

(Array(Group, Group, Group), nil) —

A vector (array) of the three resultant groups If the two objects (this and arg) represent manifold solids and the operation succeeds otherwise nil is returned. The 3 groups are as follows: The intersection of volume 1 & volume 2, the difference of volume 1 minus volume 2, and the reverse difference of volume 2 minus volume 1.

Version:

SketchUp 8.0

#subtract(group) ⇒ `Group`^?

Note:

This method is not available in SketchUp Make.

The subtract method is used to compute the boolean difference of the two groups representing manifold solid volumes (this - arg). If the specified objects (this and arg) do not represent manifold volumes, this method fails.

Examples:

entities = Sketchup.active_model.entities
group1 = entities[0]
group2 = entities[1]
result = group1.subtract(group2)

Parameters:

group (Group, Sketchup::ComponentInstance) —

The group to subtract this group from.

Returns:

(Group, nil) —

The resultant group if the two objects (this and arg) represent manifold solids and the operation succeeds. Otherwise nil is returned.

Version:

SketchUp 8.0

#to_component ⇒ Sketchup::ComponentInstance

The to_component method is used to convert the group to a component instance.

Examples:

# Add a group to the model.
group = Sketchup.active_model.entities.add_group
group.entities.add_line([0,0,0],[100,100,100])

# change the group to a component instance
group.to_component

Returns:

(Sketchup::ComponentInstance) —

the new ComponentInstance object

Version:

SketchUp 6.0

#transform!(transform) ⇒ `Group`

The transform! method is used to apply a transformation to a group.

Examples:

point = Geom::Point3d.new 500,500,500
t = Geom::Transformation.new point
depth = 100
width = 100
model = Sketchup.active_model
entities = model.active_entities
pts = []
pts[0] = [0, 0, 0]
pts[1] = [width, 0, 0]
pts[2] = [width, depth, 0]
pts[3] = [0, depth, 0]

# Add the group to the entities in the model
group = entities.add_group

# Get the entities within the group
entities2 = group.entities

# Add a face to within the group
face = entities2.add_face pts
UI.messagebox "Group before Move"
group = group.transform! t
if (group)
  UI.messagebox "Group after move"
  UI.messagebox group
else
  UI.messagebox "Failure"
end

Parameters:

transform (Geom::Transformation) —

A Transformation object.

Returns:

(Group) —

a transformed group object if successful

Version:

SketchUp 6.0

#trim(group) ⇒ `Group`^?

Note:

This method is not available in SketchUp Make.

The trim method is used to compute the (non-destructive) boolean difference of the two groups representing manifold solid volumes (this - arg). If the specified objects (this and arg) do not represent manifold volumes, this method fails.

Examples:

entities = Sketchup.active_model.entities
group1 = entities[0]
group2 = entities[1]
result = group1.trim(group2)

Parameters:

group (Group, Sketchup::ComponentInstance) —

The group to trim this group against.

Returns:

(Group, nil) —

The resultant group if the two objects (this and arg) represent manifold solids and the operation succeeds otherwise nil is returned.

Version:

SketchUp 8.0

#union(group) ⇒ `Group`^?

Note:

This method is not available in SketchUp Make.

The union method is used to compute the boolean union of the two groups representing manifold solid volumes (this | arg). If the specified objects (this and arg) do not represent manifold volumes, this method fails.

Examples:

entities = Sketchup.active_model.entities
group1 = entities[0]
group2 = entities[1]
result = group1.union(group2)

Parameters:

group (Group, Sketchup::ComponentInstance) —

The group to union this group with.

Returns:

(Group, nil) —

The resultant group if the two objects (this and arg) represent manifold solids and the operation succeeds. Otherwise nil is returned.

Version:

SketchUp 8.0

#volume ⇒ `Float`

The volume method is used to compute the volume of this group if and only if this group is manifold.

Examples:

entities = Sketchup.active_model.entities
definition = Sketchup.active_model.definitions[0]
transformation = Geom::Transformation.new([0,0,0])
group = entities.add_instance(definition, transformation)
volume = group.volume

Returns:

(Float) —

If the group represents a manifold volume, volume will be a positive value. If volume is negative, the group is not manifold.

Version:

SketchUp 8.0

Class: Sketchup::Group

Overview

Instance Attribute Summary

Drawingelement - Inherited

Entity - Inherited

Instance Method Summary

Drawingelement - Inherited

Entity - Inherited

Instance Attribute Details

#description ⇒ String (rw)

#description=(description) ⇒ String (rw)

#glued_to ⇒ Sketchup::Face, ... (rw)

#glued_to=(drawing_element) ⇒ Sketchup::Face, ... (rw)

#locked=(lock) ⇒ Boolean (rw)

#locked? ⇒ Boolean (rw)

#manifold? ⇒ Boolean (readonly)

#name ⇒ String (rw)

#name=(name) ⇒ String (rw)

#transformation ⇒ Geom::Transformation (rw)

#transformation=(transformation) (rw)

Instance Method Details

#add_observer(observer) ⇒ Boolean

#copy ⇒ Group

#definition ⇒ Sketchup::ComponentDefinition

#entities ⇒ Sketchup::Entities

#equals?(group) ⇒ Boolean

#explode ⇒ Array<Sketchup::Drawingelement>

#guid ⇒ String

#intersect(group) ⇒ Group?

#local_bounds ⇒ Geom::BoundingBox

#make_unique ⇒ Group

#move!(transformation) ⇒ Group

#outer_shell(group) ⇒ Group?

#remove_observer(observer) ⇒ Boolean

#show_differences(group, verbose) ⇒ Boolean

#split(group) ⇒ Array(Group, Group, Group)?

#subtract(group) ⇒ Group?

#to_component ⇒ Sketchup::ComponentInstance

#transform!(transform) ⇒ Group

#trim(group) ⇒ Group?

#union(group) ⇒ Group?

#volume ⇒ Float

`Drawingelement` - Inherited

`Entity` - Inherited

`Drawingelement` - Inherited

`Entity` - Inherited

#locked=(lock) ⇒ `Boolean` (rw)

#locked? ⇒ `Boolean` (rw)

#manifold? ⇒ `Boolean` (readonly)

#add_observer(observer) ⇒ `Boolean`

#copy ⇒ `Group`

#equals?(group) ⇒ `Boolean`

#intersect(group) ⇒ `Group`^?

#make_unique ⇒ `Group`

#move!(transformation) ⇒ `Group`

#outer_shell(group) ⇒ `Group`^?

#remove_observer(observer) ⇒ `Boolean`

#show_differences(group, verbose) ⇒ `Boolean`

#split(group) ⇒ Array(`Group`, `Group`, `Group`)^?

#subtract(group) ⇒ `Group`^?

#transform!(transform) ⇒ `Group`

#trim(group) ⇒ `Group`^?

#union(group) ⇒ `Group`^?

#volume ⇒ `Float`