class EdgeUse

Parent: Entity | Class Index
Methods:edge, face, loop, next, partners, previous, reversed? |
Sample Code: edgeusetests.rb |

The EdgeUse class defines how an Edge is used in the definition of a Face.

Instance Methods

edge
The edge method is used to retrieve the edge for the edge use.
Syntax:
edge = edgeuse.edge
Arguments:
Return Value:
edge - an Edge object used by this edge use
Comments:
Example:
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 face to the entities in the model face = entities.add_face pts loop = face.outer_loop edgeuses = loop.edgeuses edgeuse = edgeuses[0] edge = edgeuse.edge if (edge) UI.messagebox edge else UI.messagebox "Failure" end

face
The face method is used to retrieve the face used by this edge use.
Syntax:
face = edgeuse.face
Arguments:
Return Value:
face - a Face object used by this edge use
Comments:
Example:
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 face to the entities in the model face = entities.add_face pts loop = face.outer_loop edgeuses = loop.edgeuses edgeuse = edgeuses[0] face = edgeuse.face if (face) UI.messagebox face else UI.messagebox "Failure" end

loop
The loop method is used to retrieve the loop for this edge use.
Syntax:
loop = edgeuse.loop
Arguments:
Return Value:
loop - a Loop object that contains this edge use.
Comments:
Example:
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 face to the entities in the model face = entities.add_face pts loop = face.outer_loop edgeuses = loop.edgeuses edgeuse = edgeuses[0] loop = edgeuse.loop if (loop) UI.messagebox loop else UI.messagebox "Failure" end

next
The next method is used to retrieve the next edge use in a loop.
Syntax:
next = edgeuse.next
Arguments:
Return Value:
next - the next EdgeUse object in a loop
Comments:
Example:
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 face to the entities in the model face = entities.add_face pts loop = face.outer_loop edgeuses = loop.edgeuses edgeuse = edgeuses[0] eunext = edgeuse.next if (eunext) UI.messagebox eunext else UI.messagebox "Failure" end

partners
The partners method is used to retrieve all of the partner edge uses. This method allows you to find all Faces that use an edge.
Syntax:
partners = edgeuse.partners
Arguments:
Return Value:
partners - an array of partner Edge Use objects.
Comments:
Example:
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 face to the entities in the model face = entities.add_face pts pts2 = [] pts2[0] = [100, 0, 0] pts2[1] = [200, 0, 0] pts2[2] = [200, 100, 0] pts2[3] = [100,100,0] # Add the face to the entities in the model face2 = entities.add_face pts2 loop = face.outer_loop edgeuses = loop.edgeuses edgeuse = edgeuses[1] p = edgeuse.partners if (p) UI.messagebox p else UI.messagebox "Failure" end

previous
The previous method is used to retrieve the previous edge use in a loop.
Syntax:
edgeuse = edgeuse.previous
Arguments:
Return Value:
edgeuse - the previous Edge Use object in the loop
Comments:
Example:
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 face to the entities in the model face = entities.add_face pts loop = face.outer_loop edgeuses = loop.edgeuses edgeuse = edgeuses[0] euprevious = edgeuse.previous if (euprevious) UI.messagebox euprevious else UI.messagebox "Failure" end

reversed?
The reversed? method is used to determine if the edge is reversed in this use.
Syntax:
status = edgeuse.reversed?
Arguments:
Return Value:
status - true if reversed, false if not reversed.
Comments:
Example:
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 face to the entities in the model face = entities.add_face pts loop = face.outer_loop edgeuses = loop.edgeuses edgeuse = edgeuses[0] status = edgeuse.reversed? if (status) UI.messagebox status else UI.messagebox "Failure" end