class
TransformTool
Extends: Sprite
Class Information
- Author
- Trevor McCauley
http://www.senocular.com - Version
- 0.9.11
- Description
- Creates a transform tool that allows uaers to modify display objects on the screen
- Usage
var tool:TransformTool = new TransformTool(); addChild(tool); tool.target = targetDisplayObject;
| Constructors | |
|---|---|
| TransformTool() | TransformTool Constructor. Creates new instances of the transform tool |
| Properties | |
|---|---|
| target | The display object the transform tool affects |
| raiseNewTargets | When true, new targets are placed at the top of their display list |
| moveNewTargets | When true, new targets are immediately given a move interaction and can be dragged |
| livePreview | When true, the target instance scales with the tool as it is transformed. When false, transforms in the tool are only reflected when transforms are completed. |
| controlSize | Controls the default Control sizes of controls used by the tool |
| maintainControlForm | When true, counters transformations applied to controls by their parent containers |
| moveUnderObjects | When true (default), the transform tool uses an invisible control using the shape of the current target to allow movement. This means any objects above the target but below the tool cannot be clicked on since this hidden control will be clicked on first (allowing you to move objects below others without selecting the objects on top). When false, the target itself is used for movement and any objects above the target become clickable preventing tool movement if the target itself is not clicked directly. |
| toolMatrix | The transform matrix of the tool as it exists in its on coordinate space |
| globalMatrix | The transform matrix of the tool as it appears in global space |
| registration | The location of the registration point in the tool. Note: registration points are tool-specific. If you change the registration point of a target, the new registration will only be reflected in the tool used to change that point. |
| currentControl | The current control being used in the tool if being manipulated. This value is null if the user is not transforming the tool. |
| moveEnabled | Allows or disallows users to move the tool |
| registrationEnabled | Allows or disallows users to see and move the registration point |
| rotationEnabled | Allows or disallows users to see and adjust rotation controls |
| scaleEnabled | Allows or disallows users to see and adjust scale controls |
| skewEnabled | Allows or disallows users to see and adjust skew controls |
| outlineEnabled | Allows or disallows users to see tool boundry outlines |
| cursorsEnabled | Allows or disallows users to see native cursors |
| customControlsEnabled | Allows or disallows users to see and use custom controls |
| customCursorsEnabled | Allows or disallows users to see custom cursors |
| rememberRegistration | Allows or disallows users to see custom cursors |
| constrainScale | Allows constraining of scale transformations that scale along both X and Y. |
| constrainRotation | Allows constraining of rotation transformations by an angle |
| constrainRotationAngle | The angle at which rotation is constrainged when constrainRotation is true |
| maxScaleX | The maximum scaleX allowed to be applied to a target |
| maxScaleY | The maximum scaleY allowed to be applied to a target |
| Methods | |
|---|---|
| toString() | Provides a string representation of the transform instance |
| addControl() | Allows you to add a custom control to the tool |
| removeControl() | Allows you to remove a custom control to the tool |
| addCursor() | Allows you to add a custom cursor to the tool |
| removeCursor() | Allows you to remove a custom cursor to the tool |
| setSkin() | Allows you to change the appearance of default controls |
| getSkin() | Allows you to get the skin of an existing control. If one was not set, null is returned |
| moveInteraction() | Control Interaction. Moves the tool |
| registrationInteraction() | Control Interaction. Moves the registration point |
| rotationInteraction() | Control Interaction. Rotates the tool |
| scaleXInteraction() | Control Interaction. Scales the tool along the X axis |
| scaleYInteraction() | Control Interaction. Scales the tool along the Y axis |
| scaleBothInteraction() | Control Interaction. Scales the tool along both the X and Y axes |
| skewXInteraction() | Control Interaction. Skews the tool along the X axis |
| skewYInteraction() | Control Interaction. Skews the tool along the Y axis |
| draw() | Draws the transform tool over its target instance |
| apply() | Applies the current tool transformation to its target instance |
Constructors
TransformTool()
public function TransformTool()TransformTool Constructor. Creates new instances of the transform tool
Properties
target
public function get target():DisplayObjectThe display object the transform tool affects
raiseNewTargets
public function get raiseNewTargets():BooleanWhen true, new targets are placed at the top of their display list
- See:
- target
moveNewTargets
public function get moveNewTargets():BooleanWhen true, new targets are immediately given a move interaction and can be dragged
- See:
- target, moveEnabled
livePreview
public function get livePreview():BooleanWhen true, the target instance scales with the tool as it is transformed. When false, transforms in the tool are only reflected when transforms are completed.
controlSize
public function get controlSize():NumberControls the default Control sizes of controls used by the tool
maintainControlForm
public function get maintainControlForm():BooleanWhen true, counters transformations applied to controls by their parent containers
moveUnderObjects
public function get moveUnderObjects():BooleanWhen true (default), the transform tool uses an invisible control using the shape of the current target to allow movement. This means any objects above the target but below the tool cannot be clicked on since this hidden control will be clicked on first (allowing you to move objects below others without selecting the objects on top). When false, the target itself is used for movement and any objects above the target become clickable preventing tool movement if the target itself is not clicked directly.
toolMatrix
public function get toolMatrix():MatrixThe transform matrix of the tool as it exists in its on coordinate space
- See:
- globalMatrix
globalMatrix
public function get globalMatrix():MatrixThe transform matrix of the tool as it appears in global space
- See:
- toolMatrix
registration
public function get registration():PointThe location of the registration point in the tool. Note: registration points are tool-specific. If you change the registration point of a target, the new registration will only be reflected in the tool used to change that point.
currentControl
public function get currentControl():TransformToolControlThe current control being used in the tool if being manipulated. This value is null if the user is not transforming the tool.
moveEnabled
public function get moveEnabled():BooleanAllows or disallows users to move the tool
registrationEnabled
public function get registrationEnabled():BooleanAllows or disallows users to see and move the registration point
rotationEnabled
public function get rotationEnabled():BooleanAllows or disallows users to see and adjust rotation controls
scaleEnabled
public function get scaleEnabled():BooleanAllows or disallows users to see and adjust scale controls
skewEnabled
public function get skewEnabled():BooleanAllows or disallows users to see and adjust skew controls
outlineEnabled
public function get outlineEnabled():BooleanAllows or disallows users to see tool boundry outlines
cursorsEnabled
public function get cursorsEnabled():BooleanAllows or disallows users to see native cursors
customControlsEnabled
public function get customControlsEnabled():BooleanAllows or disallows users to see and use custom controls
customCursorsEnabled
public function get customCursorsEnabled():BooleanAllows or disallows users to see custom cursors
rememberRegistration
public function get rememberRegistration():BooleanAllows or disallows users to see custom cursors
- See:
- registration
constrainScale
public function get constrainScale():BooleanAllows constraining of scale transformations that scale along both X and Y.
- See:
- constrainRotation
constrainRotation
public function get constrainRotation():BooleanAllows constraining of rotation transformations by an angle
constrainRotationAngle
public function get constrainRotationAngle():NumberThe angle at which rotation is constrainged when constrainRotation is true
- See:
- constrainRotation
maxScaleX
public function get maxScaleX():NumberThe maximum scaleX allowed to be applied to a target
maxScaleY
public function get maxScaleY():NumberThe maximum scaleY allowed to be applied to a target
Methods
toString()
override public function toString():StringProvides a string representation of the transform instance
addControl()
public function addControl(control:TransformToolControl):voidAllows you to add a custom control to the tool
- See:
- removeControl, addCursor, removeCursor
removeControl()
public function removeControl(control:TransformToolControl):TransformToolControlAllows you to remove a custom control to the tool
- See:
- addControl, addCursor, removeCursor
addCursor()
public function addCursor(cursor:TransformToolCursor):voidAllows you to add a custom cursor to the tool
- See:
- removeCursor, addControl, removeControl
removeCursor()
public function removeCursor(cursor:TransformToolCursor):TransformToolCursorAllows you to remove a custom cursor to the tool
- See:
- addCursor, addControl, removeControl
setSkin()
public function setSkin(controlName:String, skin:DisplayObject):voidAllows you to change the appearance of default controls
- See:
- addControl, removeControl
getSkin()
public function getSkin(controlName:String):DisplayObjectAllows you to get the skin of an existing control. If one was not set, null is returned
- See:
- addControl, removeControl
moveInteraction()
public function moveInteraction():voidControl Interaction. Moves the tool
registrationInteraction()
public function registrationInteraction():voidControl Interaction. Moves the registration point
rotationInteraction()
public function rotationInteraction():voidControl Interaction. Rotates the tool
scaleXInteraction()
public function scaleXInteraction():voidControl Interaction. Scales the tool along the X axis
scaleYInteraction()
public function scaleYInteraction():voidControl Interaction. Scales the tool along the Y axis
scaleBothInteraction()
public function scaleBothInteraction():voidControl Interaction. Scales the tool along both the X and Y axes
skewXInteraction()
public function skewXInteraction():voidControl Interaction. Skews the tool along the X axis
skewYInteraction()
public function skewYInteraction():voidControl Interaction. Skews the tool along the Y axis
draw()
public function draw():voidDraws the transform tool over its target instance
apply()
public function apply():voidApplies the current tool transformation to its target instance
Page generated: 2:29 am on September 7, 2007
'IT관련글모음' 카테고리의 다른 글
| SNS2.0 적용된 엔플러그(Nplugs)가 뭐지? (0) | 2007.09.11 |
|---|---|
| paperVision3D 기초 샘플 (0) | 2007.09.09 |
| 네이버 첫페이지에서 낚였다 (0) | 2007.09.03 |
| IT근로자 수면시간 얼마나 되나 (12) | 2007.08.23 |
| IT직장인. 집 살 수 있나? (77) | 2007.08.22 |
| 이 날만 손꼽아 기다리는 중... |
|