Class: Sketchup::Loop

Inherits:
Entity
  • Object
show all
Defined in:
SketchUp/Sketchup/Loop.rb

Overview

Loop is a low level topology class that will not need to be used often. A Loop is a chain of Edges that bound a Face.

Version:

  • SketchUp 6.0

Instance Method Summary collapse

Methods inherited from Entity

#add_observer, #attribute_dictionaries, #attribute_dictionary, #delete_attribute, #deleted?, #entityID, #get_attribute, #inspect, #model, #parent, #persistent_id, #remove_observer, #set_attribute, #to_s, #typename, #valid?

Instance Method Details

#convex? ⇒ Boolean

Determine if the loop is convex.

Examples:

entities = Sketchup.active_model.active_entities
points = []
points << Geom::Point3d.new(0, 0, 0)
points << Geom::Point3d.new(100, 0, 0)
points << Geom::Point3d.new(100, 200, 0)
points << Geom::Point3d.new(0, 200, 0)
face = entities.add_face(points)
loop = face.outer_loop
if loop.convex?
  puts "Loop is convex."
else
  puts "Loop is not convex."
end

Returns:

  • (Boolean) —

    status - true if convex, false if not convex.

  • (Boolean)

Version:

  • SketchUp 6.0



34
35
 
# File 'SketchUp/Sketchup/Loop.rb', line 34

def convex?
end

#edges ⇒ Object

Get an array of the edges that define the loop in an ordered sequence.

Examples:

entities = Sketchup.active_model.active_entities
points = []
points << Geom::Point3d.new(0, 0, 0)
points << Geom::Point3d.new(100, 0, 0)
points << Geom::Point3d.new(100, 200, 0)
points << Geom::Point3d.new(0, 200, 0)
face = entities.add_face(points)
loop = face.outer_loop
edges = loop.edges

Returns:

  • edges - an array of Edge objects if successful.

Version:

  • SketchUp 6.0



53
54
 
# File 'SketchUp/Sketchup/Loop.rb', line 53

def edges
end

#edgeuses ⇒ Object

Get an array of the EdgeUse objects that define this loop in an ordered sequence.

Examples:

entities = Sketchup.active_model.active_entities
points = []
points << Geom::Point3d.new(0, 0, 0)
points << Geom::Point3d.new(100, 0, 0)
points << Geom::Point3d.new(100, 200, 0)
points << Geom::Point3d.new(0, 200, 0)
face = entities.add_face(points)
loop = face.outer_loop
edgeuses = loop.edgeuses

Returns:

  • edgeuses - an array of EdgeUse objects if successful.

Version:

  • SketchUp 6.0



73
74
 
# File 'SketchUp/Sketchup/Loop.rb', line 73

def edgeuses
end

#face ⇒ Object

Get the Face object that is bounded by this loop.

Examples:

entities = Sketchup.active_model.active_entities
points = []
points << Geom::Point3d.new(0, 0, 0)
points << Geom::Point3d.new(100, 0, 0)
points << Geom::Point3d.new(100, 200, 0)
points << Geom::Point3d.new(0, 200, 0)
face = entities.add_face(points)
loop = face.outer_loop
loop_face = loop.face

Returns:

  • face - a Face object if successful

Version:

  • SketchUp 6.0



92
93
 
# File 'SketchUp/Sketchup/Loop.rb', line 92

def face
end

#outer? ⇒ Boolean

Determine if this is an outer loop. Each face has one outer loop, and will have one loop for each hole.

Examples:

entities = Sketchup.active_model.active_entities
points = []
points << Geom::Point3d.new(0, 0, 0)
points << Geom::Point3d.new(100, 0, 0)
points << Geom::Point3d.new(100, 200, 0)
points << Geom::Point3d.new(0, 200, 0)
face = entities.add_face(points)
loop = face.outer_loop
if loop.outer?
  puts "Loop is an outer loop."
else
  puts "Loop is not an outer loop."
end

Returns:

  • (Boolean) —

    status - true if the loop is an outer loop, false if it is not an outer loop.

  • (Boolean)

Version:

  • SketchUp 6.0



119
120
 
# File 'SketchUp/Sketchup/Loop.rb', line 119

def outer?
end

#vertices ⇒ Object

Get an array of the vertices that define the loop in an ordered sequence.

Examples:

entities = Sketchup.active_model.active_entities
points = []
points << Geom::Point3d.new(0, 0, 0)
points << Geom::Point3d.new(100, 0, 0)
points << Geom::Point3d.new(100, 200, 0)
points << Geom::Point3d.new(0, 200, 0)
face = entities.add_face(points)
loop = face.outer_loop
vertices = loop.vertices

Returns:

  • vertices - an array of Vertex objects if successful.

Version:

  • SketchUp 6.0



138
139
 
# File 'SketchUp/Sketchup/Loop.rb', line 138

def vertices
end