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:
@@ -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;
|
||||
}
|
||||
Reference in New Issue
Block a user