class Behavior

Parent: Entity | Class Index
Methods:always_face_camera=, always_face_camera?, cuts_opening=, cuts_opening?, is2d=, is2d?, snapto, snapto= |
Sample Code: behaviortests.rb |

This class is used to control the behavior of components. A behavior is accessed from a ComponentDefinition object.

Instance Methods

always_face_camera=
The always_face_camera= method is used to set the always_face_camera behavior for a component.
Syntax:
status = behavior.always_face_camera=true | false
Arguments:
true – sets the always_face_camera behavior to true false – sets the always_face_camera behavior to false
Return Value:
status – the status of the always_face_camera behavior if successful
Comments:
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:
status = behavior.always_face_camera=false if (status) # if status is true, print the status UI.messagebox status else # code to respond to always_face_camera being false end

always_face_camera?
The always_face_camera? method is used to retrieve the always_face_camera behavior for a component.
Syntax:
behvior = behavior.always_face_camera?
Arguments:
Return Value:
behavior - true if the component is set to always face the camera, false if the component is not set to always face camera.
Comments:
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 DefintionList definitions = model.definitions path = Sketchup.find_support_file "BedTraditional.skp" ,"Components/Furniture/" 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

cuts_opening=
The cuts_opening= method is used to set the cut opening behavior for a component.
Syntax:
status = behavior.cuts_opening=true | false
Arguments:
true – sets the cuts_opening behavior to true false – sets the cuts_opening behavior to false
Return Value:
status – the status of the cuts_opening behavior (either true or false)
Comments:
Example:
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

cuts_opening?
The cuts_opening? method is used to verify the status of a component’s cut opening behavior.
Syntax:
status = behavior.cuts_opening?
Arguments:
Return Value:
status – the status of the cuts_opening behavior (either true or false)
Comments:
Example:
staus=behavior.cuts_opening? if (status) #if status is true, do something else # if status is false, do something else end

is2d=
The is2d= method is used to set the 2D behavior for a component: whether it can be glued or aligned to a face.
Syntax:
status = behavior.is2d=true | false
Arguments:
true – sets the 2D behavior to true false – sets the 2D behavior to false
Return Value:
status – the status of the 2D behavior (either true or false)
Comments:
Example:
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

is2d?
The is2d? method is used to verify the status of a component’s 2D behavior.
Syntax:
status = behavior.is2d?
Arguments:
Return Value:
status – the status of the 2D behavior (either true or false)
Comments:
Example:
staus=behavior.is2d? if (status) #if status is true, do something else # if status is false, do something else end

snapto
The snapto method is used to verify the status of a component’s "snap to" behavior.
Syntax:
status = behavior.snapto
Arguments:
Return Value:
status – the status of the snapto behavior (either true or false)
Comments:
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:
staus=behavior.snapto? if (status) #if status is true, do something else # if status is false, do something else end

snapto=
The is2d= method is used to set the snap to behavior for a component: whether it aligns (snaps) to a particular orientation.
Syntax:
status = behavior.snapto=true | false
Arguments:
true – sets the snapto behavior to true false – sets the snapto behavior to false
Return Value:
status – the status of the snapto behavior (either true or false)
Comments:
Example:
status = behavior.snapto=false if (status) # if status is true, print the status UI.messagebox status else # code to respond snapto behavior being false end