Behold Vilya, Ring of Air and repository for our game and virtual worldly

extensions to the distributed environment provided by Narya.


git-svn-id: svn+ssh://src.earth.threerings.net/vilya/trunk@1 c613c5cb-e716-0410-b11b-feb51c14d237
This commit is contained in:
Michael Bayne
2006-06-23 17:58:11 +00:00
commit a4df87e52f
317 changed files with 45818 additions and 0 deletions
@@ -0,0 +1,217 @@
//
// $Id$
//
// Narya library - tools for developing networked games
// Copyright (C) 2002-2005 Three Rings Design, Inc., All Rights Reserved
// http://www.threerings.net/code/narya/
//
// This library is free software; you can redistribute it and/or modify it
// under the terms of the GNU Lesser General Public License as published
// by the Free Software Foundation; either version 2.1 of the License, or
// (at your option) any later version.
//
// This library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
// Lesser General Public License for more details.
//
// You should have received a copy of the GNU Lesser General Public
// License along with this library; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
package com.threerings.parlor.turn.client;
import java.awt.Color;
import java.awt.GridBagConstraints;
import java.awt.GridBagLayout;
import java.util.HashMap;
import javax.swing.JLabel;
import javax.swing.JPanel;
import javax.swing.Icon;
import com.samskivert.swing.GroupLayout;
import com.samskivert.swing.VGroupLayout;
import com.samskivert.swing.util.SwingUtil;
import com.threerings.util.Name;
import com.threerings.crowd.client.PlaceView;
import com.threerings.crowd.data.PlaceObject;
import com.threerings.parlor.game.data.GameObject;
import com.threerings.parlor.turn.data.TurnGameObject;
import com.threerings.presents.dobj.AttributeChangeListener;
import com.threerings.presents.dobj.AttributeChangedEvent;
import com.threerings.presents.dobj.ElementUpdateListener;
import com.threerings.presents.dobj.ElementUpdatedEvent;
import com.threerings.presents.dobj.DObject;
/**
* Automatically display a list of players and turn change information
* in a turn-based game.
*/
// TODO
// - adapt this to be able to display scores in some generic way as well.
// - allow configuring of turn / winner labels from prototypes,
// rather than forcing one to be an icon, the other a string, and
// examine the prototype to determine how to highlight the turnholder.
public class TurnDisplay extends JPanel
implements PlaceView, AttributeChangeListener, ElementUpdateListener
{
/**
* Create a TurnDisplay.
*/
public TurnDisplay ()
{
}
/**
* Create a TurnDisplay for a game using the specified Icon to denote
* whose turn it is.
*/
public TurnDisplay (Icon turnIcon)
{
setTurnIcon(turnIcon);
}
/**
* Set the icon to use.
*/
public void setTurnIcon (Icon turnIcon)
{
_turnIcon = turnIcon;
if (_turnObj != null) {
createList();
}
}
/**
* Set the text to be displayed next to the winner's name.
*/
public void setWinnerText (String winnerText)
{
_winnerText = winnerText;
}
/**
* Set optional icons to use for identifying each player in the game.
*/
public void setPlayerIcons (Icon[] icons)
{
_playerIcons = icons;
if (_turnObj != null) {
createList();
}
}
/**
* Create the list of names and highlight as appropriate.
*/
protected void createList ()
{
removeAll();
_labels.clear();
GridBagLayout gridbag = new GridBagLayout();
setLayout(gridbag);
GridBagConstraints iconC = new GridBagConstraints();
GridBagConstraints labelC = new GridBagConstraints();
iconC.fill = labelC.fill = GridBagConstraints.BOTH;
labelC.weightx = 1.0;
labelC.insets.left = 10;
labelC.gridwidth = GridBagConstraints.REMAINDER;
Name[] names = _turnObj.getPlayers();
boolean[] winners = ((GameObject) _turnObj).winners;
Name holder = _turnObj.getTurnHolder();
for (int ii=0, jj=0; ii < names.length; ii++, jj++) {
if (names[ii] == null) continue;
JLabel iconLabel = new JLabel();
if (winners == null) {
if (names[ii].equals(holder)) {
iconLabel.setIcon(_turnIcon);
}
} else if (winners[ii]) {
iconLabel.setText(_winnerText);
iconLabel.setForeground(Color.GREEN);
}
_labels.put(names[ii], iconLabel);
add(iconLabel, iconC);
JLabel label = new JLabel(names[ii].toString());
if (_playerIcons != null) {
label.setIcon(_playerIcons[jj]);
}
add(label, labelC);
}
SwingUtil.refresh(this);
}
// documentation inherited from interface PlaceView
public void willEnterPlace (PlaceObject plobj)
{
_turnObj = (TurnGameObject) plobj;
plobj.addListener(this);
createList();
}
// documentation inherited from interface PlaceView
public void didLeavePlace (PlaceObject plobj)
{
plobj.removeListener(this);
_turnObj = null;
removeAll();
}
// documentation inherited from interface AttributeChangeListener
public void attributeChanged (AttributeChangedEvent event)
{
String name = event.getName();
if (name.equals(_turnObj.getTurnHolderFieldName())) {
JLabel oldLabel = (JLabel) _labels.get((Name) event.getOldValue());
if (oldLabel != null) {
oldLabel.setIcon(null);
}
JLabel newLabel = (JLabel) _labels.get((Name) event.getValue());
if (newLabel != null) {
newLabel.setIcon(_turnIcon);
}
} else if (name.equals(GameObject.PLAYERS)) {
createList();
} else if (name.equals(GameObject.WINNERS)) {
createList();
}
}
// documentation inherited from interface ElementUpdateListener
public void elementUpdated (ElementUpdatedEvent event)
{
String name = event.getName();
if (name.equals(GameObject.PLAYERS)) {
createList();
}
}
/** The TurnGameObject we're displaying. */
protected TurnGameObject _turnObj;
/** A mapping of the labels currently associated with each player. */
protected HashMap _labels = new HashMap();
/** The game-specified player icons. */
protected Icon[] _playerIcons;
/** The text to display next to a winner's name. */
protected String _winnerText;
/** The Icon we use for indicating the turn. */
protected Icon _turnIcon;
}
@@ -0,0 +1,44 @@
//
// $Id: TurnGameController.java 3381 2005-03-03 19:36:34Z mdb $
//
// Narya library - tools for developing networked games
// Copyright (C) 2002-2004 Three Rings Design, Inc., All Rights Reserved
// http://www.threerings.net/code/narya/
//
// This library is free software; you can redistribute it and/or modify it
// under the terms of the GNU Lesser General Public License as published
// by the Free Software Foundation; either version 2.1 of the License, or
// (at your option) any later version.
//
// This library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
// Lesser General Public License for more details.
//
// You should have received a copy of the GNU Lesser General Public
// License along with this library; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
package com.threerings.parlor.turn.client;
import com.threerings.util.Name;
import com.threerings.parlor.game.client.GameController;
/**
* Games that wish to make use of the turn game services should have their
* controller implement this interface and create an instance of {@link
* TurnGameControllerDelegate} which should be passed to {@link
* GameController#addDelegate}.
*/
public interface TurnGameController
{
/**
* Called when the turn changed. This indicates the start of a turn
* and the user interface should adjust itself accordingly (activating
* controls if it is our turn and deactivating them if it is not).
*
* @param turnHolder the username of the new holder of the turn.
*/
public void turnDidChange (Name turnHolder);
}
@@ -0,0 +1,149 @@
//
// $Id: TurnGameControllerDelegate.java 3758 2005-11-10 23:18:58Z mdb $
//
// Narya library - tools for developing networked games
// Copyright (C) 2002-2004 Three Rings Design, Inc., All Rights Reserved
// http://www.threerings.net/code/narya/
//
// This library is free software; you can redistribute it and/or modify it
// under the terms of the GNU Lesser General Public License as published
// by the Free Software Foundation; either version 2.1 of the License, or
// (at your option) any later version.
//
// This library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
// Lesser General Public License for more details.
//
// You should have received a copy of the GNU Lesser General Public
// License along with this library; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
package com.threerings.parlor.turn.client;
import com.threerings.util.Name;
import com.threerings.presents.dobj.AttributeChangedEvent;
import com.threerings.presents.dobj.AttributeChangeListener;
import com.threerings.crowd.data.BodyObject;
import com.threerings.crowd.data.PlaceConfig;
import com.threerings.crowd.data.PlaceObject;
import com.threerings.crowd.util.CrowdContext;
import com.threerings.parlor.game.client.GameController;
import com.threerings.parlor.game.client.GameControllerDelegate;
import com.threerings.parlor.game.data.GameObject;
import com.threerings.parlor.turn.data.TurnGameObject;
/**
* Performs the client-side processing for a turn-based game. Games which
* wish to make use of these services must construct a delegate and call
* out to it at the appropriate times (see the method documentation for
* which methods should be called when). The game's controller must also
* implement the {@link TurnGameController} interface so that it can be
* notified when turn-based game events take place.
*/
public class TurnGameControllerDelegate extends GameControllerDelegate
implements AttributeChangeListener
{
/**
* Constructs a delegate which will call back to the supplied {@link
* TurnGameController} implementation wen turn-based game related
* things happen.
*/
public TurnGameControllerDelegate (TurnGameController tgctrl)
{
super((GameController)tgctrl);
// keep this around for later
_tgctrl = tgctrl;
}
/**
* Returns true if the game is in progress and it is our turn; false
* otherwise.
*/
public boolean isOurTurn ()
{
BodyObject self = (BodyObject)_ctx.getClient().getClientObject();
return (_gameObj.state == GameObject.IN_PLAY &&
self.getVisibleName().equals(_turnGame.getTurnHolder()));
}
/**
* Returns the index of the current turn holder as configured in the
* game object.
*
* @return the index into the players array of the current turn holder
* or -1 if there is no current turn holder.
*/
public int getTurnHolderIndex ()
{
return _gameObj.getPlayerIndex(_turnGame.getTurnHolder());
}
// documentation inherited
public void init (CrowdContext ctx, PlaceConfig config)
{
_ctx = ctx;
}
// documentation inherited
public void willEnterPlace (PlaceObject plobj)
{
// get a casted reference to the object
_gameObj = (GameObject)plobj;
_turnGame = (TurnGameObject)plobj;
_thfield = _turnGame.getTurnHolderFieldName();
// and add ourselves as a listener
plobj.addListener(this);
}
// documentation inherited
public void didLeavePlace (PlaceObject plobj)
{
// remove our listenership
plobj.removeListener(this);
// clean up
_turnGame = null;
}
// documentation inherited
public void attributeChanged (AttributeChangedEvent event)
{
// handle turn changes
if (event.getName().equals(_thfield)) {
Name name = (Name)event.getValue();
Name oname = (Name)event.getOldValue();
if (TurnGameObject.TURN_HOLDER_REPLACED.equals(name) ||
TurnGameObject.TURN_HOLDER_REPLACED.equals(oname)) {
// small hackery: ignore the turn holder being set to
// TURN_HOLDER_REPLACED as it means that we're replacing
// the current turn holder rather than switching turns;
// also ignore the new turn holder when we switch from THR
// to a real name again
} else {
_tgctrl.turnDidChange(name);
}
}
}
/** The turn game controller for whom we are delegating. */
protected TurnGameController _tgctrl;
/** A reference to our client context. */
protected CrowdContext _ctx;
/** A reference to our game object. */
protected GameObject _gameObj;
/** A casted reference to our game object as a turn game. */
protected TurnGameObject _turnGame;
/** The name of the turn holder field. */
protected String _thfield;
}