123456789_123456789_123456789_123456789_123456789_

Class: Sketchup::InstancePath

Relationships
Super Chains via Extension / Inclusion / Inheritance
Instance Chain:
self, Enumerable
Inherits: Object

Overview

The InstancePath class represent the instance path to a given entity within the model hierarchy.

Version:

  • SketchUp 2017

Class Method Summary

Instance Attribute Summary

  • #empty? ⇒ Boolean readonly
  • #valid? ⇒ Boolean readonly

    An instance path is valid if it has at least one element and consist of groups and instances with exception of the leaf which can be any entity.

Instance Method Summary

Constructor Details

.new(path) ⇒ InstancePath

Examples:

model = Sketchup.active_model
group = model.entities.add_group
edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
path = Sketchup::InstancePath.new([group, edge])

Parameters:

  • path (Array<Sketchup::Entity>) —

    The leaf can be any entity, but the rest must be a group or component instance.

Raises:

  • (ArgumentError) —

    if the instance path isn’t composed of instances and an optional leaf entity.

Version:

  • SketchUp 2017

Instance Attribute Details

#empty? ⇒ Boolean (readonly)

Examples:

model = Sketchup.active_model
group = model.entities.add_group
edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
path = Sketchup::InstancePath.new([group, edge])
if path.empty?
  # do something...
end

Raises:

  • (TypeError) —

    if the instance path refer to deleted entities.

Version:

  • SketchUp 2017

#valid? ⇒ Boolean (readonly)

An instance path is valid if it has at least one element and consist of groups and instances with exception of the leaf which can be any entity.

This method doesn’t check if the path can actually be looked up in the model.

Examples:

model = Sketchup.active_model
group = model.entities.add_group
edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
path = Sketchup::InstancePath.new([group, edge])
if path.valid?
  # do something...
end

Version:

  • SketchUp 2017

Instance Method Details

#==(other) ⇒ Boolean

Examples:

model = Sketchup.active_model
group = model.entities.add_group
edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
path = Sketchup::InstancePath.new([group, edge])
if path.size > 1
  # do something
end

Returns:

  • (Boolean) —

    ‘true` if the instances paths represent the same set of entities.

Version:

  • SketchUp 2017

#[](index) ⇒ Sketchup::Entity

Note:

This method does not accept negative indices. For the exact behavior of an array, use {#to_a}.

The elements of an instance path can be accessed similarly to an array.

Examples:

model = Sketchup.active_model
group = model.entities.add_group
edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
path = Sketchup::InstancePath.new([group, edge])
path[0] == group # returns true
path[1] == edge # returns true

Parameters:

  • index (Integer)

Raises:

  • (IndexError) —

    if the given index is out of bounds

  • (TypeError) —

    if the index is not of integer type

  • (TypeError) —

    if the instance path refer to deleted entities.

Version:

  • SketchUp 2017

#each {|entity| ... } ⇒ nil

The yielded entities will start with the root and end with the leaf.

Examples:

model = Sketchup.active_model
group = model.entities.add_group
edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
path = Sketchup::InstancePath.new([group, edge])
path.each { |entity|
  # do something
}

Yield Parameters:

Raises:

  • (TypeError) —

    if the instance path refer to deleted entities.

Version:

  • SketchUp 2017

#include?(object) ⇒ Boolean

Returns ‘true` if the instance path contain the given object.

Examples:

model = Sketchup.active_model
group = model.entities.add_group
edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
path = Sketchup::InstancePath.new([group, edge])
if path.include?(edge)
  # do something...
end

Parameters:

  • object (Object)

Raises:

  • (TypeError) —

    if the instance path refer to deleted entities.

Version:

  • SketchUp 2017

#leaf ⇒ Sketchup::Entity

The leaf of an instance path is the last element which can be any entity that can be represented in the model. This is normally a Drawingelement, but could be a Vertex.

An instance can also be a leaf.

Examples:

model = Sketchup.active_model
group = model.entities.add_group
edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
path = Sketchup::InstancePath.new([group, edge])
path.leaf == edge # returns true

Raises:

  • (TypeError) —

    if the instance path refer to deleted entities.

Version:

  • SketchUp 2017

#length ⇒ Integer

#length is an alias of #size.

Examples:

model = Sketchup.active_model
group = model.entities.add_group
edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
path = Sketchup::InstancePath.new([group, edge])
if path.length > 1
  # do something
end

Raises:

  • (TypeError) —

    if the instance path refer to deleted entities.

See Also:

Version:

  • SketchUp 2017

#persistent_id_path ⇒ String

The serialized version of an instance path is the persistent ids of its entities concatenated with a period.

Examples:

model = Sketchup.active_model
group = model.entities.add_group
edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
path = Sketchup::InstancePath.new([group, edge])
pid_path = path.persistent_id_path # something like "342.345"

Raises:

  • (TypeError) —

    if the instance path refer to deleted entities.

See Also:

Version:

  • SketchUp 2017

#root ⇒ Sketchup::Group, ...

The root of an instance path is the element located closest to the model root. This will be a group or component instance. If you have a non-instance as a leaf with no other parent component this will return ‘nil`.

Examples:

model = Sketchup.active_model
group = model.entities.add_group
edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
path = Sketchup::InstancePath.new([group, edge])
path.root == group # returns true

Raises:

  • (TypeError) —

    if the instance path refer to deleted entities.

Version:

  • SketchUp 2017

#size ⇒ Integer

Examples:

model = Sketchup.active_model
group = model.entities.add_group
edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
path = Sketchup::InstancePath.new([group, edge])
if path.size > 1
  # do something
end

Raises:

  • (TypeError) —

    if the instance path refer to deleted entities.

See Also:

Version:

  • SketchUp 2017

#to_a ⇒ Array

Examples:

model = Sketchup.active_model
group = model.entities.add_group
edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
path = Sketchup::InstancePath.new([group, edge])
pid_string = path.to_a.join('.')

Returns:

  • (Array) —

    an array representing the instance path.

Raises:

  • (TypeError) —

    if the instance path refer to deleted entities.

Version:

  • SketchUp 2017

#transformation ⇒ Geom::Transformation #transformation(index) ⇒ Geom::Transformation

Examples:

model = Sketchup.active_model
group = model.entities.add_group
edge = group.entities.add_line([10, 10, 10], [20, 20, 20])
path = Sketchup::InstancePath.new([group, edge])
tr = path.transformation

Overloads:

Raises:

  • (IndexError) —

    if the given index is out of bounds

  • (TypeError) —

    if the index is not of integer type

  • (TypeError) —

    if the instance path refer to deleted entities.

Version:

  • SketchUp 2017