Packagecom.whirled
Classpublic class FurniControl
InheritanceFurniControl Inheritance EntityControl Inheritance AbstractControl Inheritance flash.events.EventDispatcher
SubclassesBackdropControl, PropControl, ToyControl

This file should be included by furniture, so that it can communicate with the whirled.



Protected Properties
 PropertyDefined by
 Inherited_env : String
The environment in which we're running.
EntityControl
Public Methods
 MethodDefined by
  
FurniControl(disp:DisplayObject)
Create a furni interface.
FurniControl
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registers an event listener.
AbstractControl
 Inherited
canManageRoom(memberId:int = 0):Boolean
Returns true if the local client has management privileges in the current room.
EntityControl
 Inherited
clearPopup():void
Clear any showing popup.
EntityControl
 Inherited
doBatch(fn:Function, ... args):void
Execute the specified function as a batch of commands that will be sent to the server together.
AbstractControl
 Inherited
getCamera(index:String = null):Camera
Access the local user's camera.
EntityControl
 Inherited
getDefaultDataPack():ByteArray
Get the default datapack for this entity, or null if there is none defined.
EntityControl
 Inherited
getEntityIds(type:String = null):Array
Enumerates the ids of all entities in this room.
EntityControl
 Inherited
getEntityProperty(key:String, entityId:String = null):Object
Looks up and returns the specified property for the specified entity.
EntityControl
 Inherited
getEnvironment():String
Get the "environment" in which this entity is presently running.
EntityControl
 Inherited
Get the id of the viewer that is viewing this instance.
EntityControl
 Inherited
Returns our current logical location in the scene.
EntityControl
 Inherited
getMemories():Object
Return an associative hash of all the memories.
EntityControl
 Inherited
getMemory(key:String, defval:Object = null):Object
Returns the value associated with the supplied key in this item's memory.
EntityControl
 Inherited
getMicrophone(index:int = -1):Microphone
Access the local user's microphone.
EntityControl
 Inherited
getMusicId3():Object
Get the id3 metadata of the currently playing music.
EntityControl
 Inherited
Get the playerId of the owner of the currently playing music, aka the player who added it to the playlist, or 0 if there is no music currently playing.
EntityControl
 Inherited
getMyEntityId():String
Returns the Whirled-wide unique ID of this copy of the entity.
EntityControl
 Inherited
Returns our current location in the scene, in pixel coordinates.
EntityControl
 Inherited
getRoomBounds():Array
Get the room's bounds in pixels.
EntityControl
 Inherited
getViewerName(id:int = 0):String
Get the non-unique display name of the user viewing a particular instance.
EntityControl
 Inherited
hasControl():Boolean
Detects whether this client is in control.
EntityControl
 Inherited
isConnected():Boolean
Are we connected and running inside the whirled environment, or has someone just loaded up our SWF by itself?
AbstractControl
 Inherited
registerCustomConfig(func:Function):void
Register a function used for generating a custom config panel.
EntityControl
 Inherited
registerPropertyProvider(func:Function):void
Registers a function that provides custom entity properties.
EntityControl
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Unregisters an event listener.
AbstractControl
 Inherited
sendMessage(name:String, arg:Object = null):void
Send a message to other instances of this entity, resulting in a MESSAGE_RECEIVED event.
EntityControl
 Inherited
sendSignal(name:String, arg:Object = null):void
Send a message to all instances of all entities in this instance's current room, resulting in a SIGNAL_RECEIVED event.
EntityControl
 Inherited
setHotSpot(x:Number, y:Number, height:Number):void
Set the layout "hotspot" for your item, specified as pixels relative to (0, 0) the top-left coordinate.
EntityControl
 Inherited
setMemory(key:String, value:Object, callback:Function = null):void
Requests that this item's memory be updated with the supplied key/value pair.
EntityControl
 Inherited
setTickInterval(interval:Number):void
Configures the interval on which this item is "ticked" in milliseconds.
EntityControl
  
showPage(token:String):Boolean
Shows the Whirled page identified by the supplied token.
FurniControl
 Inherited
showPopup(title:String, panel:DisplayObject, width:Number, height:Number, backgroundColor:uint = 0xFFFFFF, backgroundAlpha:Number = 1.0):Boolean
Show a popup to the current user in the whirled.
EntityControl
 Inherited
triggerAction(name:String, arg:Object = null):void
Triggers an action on this scene object.
EntityControl
Events
 EventSummaryDefined by
 Inherited Dispatched when the instance in control sends a trigger action to all instances.EntityControl
 Inherited Dispatched to entities when they overhear chatter in the room.EntityControl
 Inherited Dispatched when this instance gains control.EntityControl
 Inherited Dispatched when an entity enters the room.EntityControl
 Inherited Dispatched when an entity leaves the room.EntityControl
 Inherited Dispatched when an entity in the room (other than the listening entity) changes location.EntityControl
   Dispatched when the local user unhovers the mouse from this sprite.FurniControl
   Dispatched when the local user hovers the mouse over this sprite.FurniControl
 Inherited Dispatched when the instance in control updates the memory of this digital item.EntityControl
 Inherited Dispatched when any instance sends a message to all instances.EntityControl
 Inherited Dispatched when id3 data is found in the currently playing song.EntityControl
 Inherited Dispatched when music starts playing in the room.EntityControl
 Inherited Dispatched when music stops playing in the room.EntityControl
 Inherited Dispatched when any entity or AVR game sends a message to all other entities.EntityControl
 Inherited Dispatched once per tick, only when this instance has control and only if tick interval is registered.EntityControl
 Inherited Event.UNLOAD Dispatched when the SWF using this control has been unloaded.AbstractControl
Public Constants
 ConstantDefined by
  BODY_ENTERED : String = "bodyEntered"
[static] An action triggered when someone arrives at the location at which this furniture is placed, if this piece of furniture is a doorway.
FurniControl
  BODY_LEFT : String = "bodyLeft"
[static] An action triggered when someone leaves via this piece of doorway furniture.
FurniControl
 InheritedENV_ROOM : String = "room"
[static] A constant returned by getEnvironment() to indicate that this entity is being viewed in a room.
EntityControl
 InheritedENV_SHOP : String = "shop"
[static] A constant returned by getEnvironment() to indicate that this entity is being viewed in the shop.
EntityControl
 InheritedENV_VIEWER : String = "viewer"
[static] A constant returned by getEnvironment() to indicate that this entity is being viewed in the "viewer": memories may be set and read, but they will not be saved.
EntityControl
 InheritedPROP_DIMENSIONS : String = "std:dimensions"
[static] The entity pixel dimensions (an Array [width, height]).
EntityControl
 InheritedPROP_HOTSPOT : String = "std:hotspot"
[static] The entity's hot spot (an Array [x, y]).
EntityControl
 InheritedPROP_LOCATION_LOGICAL : String = "std:location_logical"
[static] The entity's location in logical coordinates (an Array [ x, y, z ]).
EntityControl
 InheritedPROP_LOCATION_PIXEL : String = "std:location_pixel"
[static] The entity's location in pixel coordinates (an Array [ x, y, z ]).
EntityControl
 InheritedPROP_MEMBER_ID : String = "std:member_id"
[static] The unique Whirled player ID (int) of the wearer of the avatar, or the owner of the pet.
EntityControl
 InheritedPROP_MOVE_SPEED : String = "std:move_speed"
[static] The current movement speed of an actor (Number).
EntityControl
 InheritedPROP_NAME : String = "std:name"
[static] The non-unique display name of the entity (a String).
EntityControl
 InheritedPROP_ORIENTATION : String = "std:orientation"
[static] The entity facing direction (a Number).
EntityControl
 InheritedPROP_TYPE : String = "std:type"
[static] The type of the entity, TYPE_AVATAR, TYPE_PET or TYPE_FURNI.
EntityControl
 InheritedTYPE_AVATAR : String = "avatar"
[static] The type of avatar entities.
EntityControl
 InheritedTYPE_FURNI : String = "furni"
[static] The type of furniture entities.
EntityControl
 InheritedTYPE_PET : String = "pet"
[static] The type of pet entities.
EntityControl
Constructor detail
FurniControl()constructor
public function FurniControl(disp:DisplayObject)

Create a furni interface. The display object is your piece of furni.

Parameters
disp:DisplayObject
Method detail
showPage()method
public function showPage(token:String):Boolean

Shows the Whirled page identified by the supplied token.

Parameters
token:String — the token that identifies the page to be shown. This is not the full URL, just the part after http://www.whirled.com/#. For example: passing "me" would show the Me page. Passing "shop-l_5_343" would show the shop page for the Kawaii Knight avatar.

Returns
Boolean — true if the page was shown, false if it could not be shown for some reason.
Event detail
hoverOutevent 
Event object type: com.whirled.ControlEvent
ControlEvent.type property = com.whirled.ControlEvent.HOVER_OVER

Dispatched when the local user unhovers the mouse from this sprite. Note that normal MouseEvents are blocked when this sprite has "action", like it is a doorway. If you want the doorway to react to the mouse being over it then you should listen for this event.

An event type dispatched to Furniture and Toys when the mouse is leaves them. Note that the normal MouseEvents will be blocked if the furniture has an action, so this is necessary to make doorways that react to mouse hovering.
name - unused
value - unused

hoverOverevent  
Event object type: com.whirled.ControlEvent
ControlEvent.type property = com.whirled.ControlEvent.HOVER_OVER

Dispatched when the local user hovers the mouse over this sprite. Note that normal MouseEvents are blocked when this sprite has "action", like it is a doorway. If you want the doorway to react to the mouse being over it then you should listen for this event.

An event type dispatched to Furniture and Toys when the mouse is over them. Note that the normal MouseEvents will be blocked if the furniture has an action, so this is necessary to make doorways that react to mouse hovering.
name - unused
value - unused

Constant detail
BODY_ENTEREDconstant
public static const BODY_ENTERED:String = "bodyEntered"

An action triggered when someone arrives at the location at which this furniture is placed, if this piece of furniture is a doorway.

This will arrive via an ACTION_TRIGGERED event with the name property set to BODY_ENTERED.

BODY_LEFTconstant 
public static const BODY_LEFT:String = "bodyLeft"

An action triggered when someone leaves via this piece of doorway furniture.

This will arrive via an ACTION_TRIGGERED event with the name property set to BODY_LEFT.