Obsolete mPlay Functions

These functions deal with multi player/internet information transfer.

Function List:

FunctionDescription
mplay_data_writeWrite value val (string or real) into location ind (ind between 0 and 1000000).
mplay_data_readReturns the value in location ind (ind between 0 and 1000000). Initially all values are 0.
mplay_data_modeSets whether or not to use guaranteed transmission for shared data. guar should either be true (the default) or false.
mplay_init_ipxInitializes an IPX connection.
mplay_init_tcpipInitializes a TCP/IP connection. addr is a string containing the web address or IP address, e.g. 'www.gameplay.com' or '123.123.123.12', possibly followed by a port number (e.g. ':12'). Only when joining a session (see below) do you need to provide an address. On a local area network no addresses are necessary.
mplay_init_modemInitializes a modem connection. initstr is the initialization string for the modem (can be empty). phonenr is a string that contains the phone number to ring (e.g. '0201234567'). Only when joining a session (see below) do you need to provide a phone number.
mplay_init_serialInitializes a serial connection. portno is the port number (1-4). baudrate is the baud rate to be used (100-256K). stopbits indicates the number of stopbits (0 = 1 bit, 1 = 1.5 bit, 2 = 2 bits). parity indicates the parity (0=none, 1=odd, 2=even, 3=mark). And flow indicates the type of flow control (0=none, 1=xon/xoff, 2=rts, 3=dtr, 4=rts and dtr). Returns whether successful. A typical call is mplay_init_serial(1,57600,0,0,4). Give 0 as a first argument to open a dialog for the user to change the settings.
mplay_connect_statusReturns the status of the current connection.
mplay_endEnds the current connection.
mplay_ipaddressReturns the IP address of your machine (e.g. '123.123.123.12') as a string.
mplay_message_sendSends a message to the indicated player (either an identifier or a name; use 0 to send the message to all players). id is an integer message identifier and val is the value (either a real or a string). The message is sent in non-guaranteed mode. If val contains a string the maximal string length allowed is 30000 characters.
mplay_message_send_guaranteedSends a message to the indicated player (either an identifier or a name; use 0 to send the message to all players). id is an integer message identifier and val is the value (either a real or a string). This is a guaranteed send. If val contains a string the maximal string length allowed is 30000 characters.
mplay_message_receiveReceives the next message from the message queue that came from the indicated player (either an identifier or a name). Use 0 for messages from any player. The routine returns whether there was indeed a new message.
mplay_message_idReturns the identifier of the last received message.
mplay_message_valueReturns the value of the last received message.
mplay_message_playerReturns the player who sent the last received message.
mplay_message_nameReturns the name of the player who sent the last received message.
mplay_message_countReturns the number of messages left in the queue from the player (use 0 to count all message).
mplay_message_clearRemoves all messages left in the queue from the player (use 0 to remove all message).
mplay_player_findSearches for all players in the current session and returns the number of players found.
mplay_player_nameReturns the name of player number numb (0 is the first player, which is always yourself). This routine can only be called after calling the previous routine.
mplay_player_idReturns the unique id of player number numb (0 is the first player, which is always yourself). This routine can only be called after calling the first routine. This id is used in sending and receiving messages to and from individual players.
mplay_session_createCreates a new session on the current connection.
mplay_session_findSearches for all sessions that still accept players and returns the number of sessions found.
mplay_session_nameReturns the name of session number numb (0 is the first session). This routine can only be called after calling the previous routine.
mplay_session_joinMakes you join session number numb (0 is the first session). playername is your name as a player. Returns whether successful.
mplay_session_modeSets whether or not to move the session host to another computer when the host ends. move should either be true or false (the default).
mplay_session_statusReturns the status of the current session.
mplay_session_endEnds the session for this player.

Why These Are Obsolete

These were Windows only functions and are no longer applicable to any other device, and even for Windows they have been superceded by much better methods of doing the same thing.


Back: Obsolete Functions
Next: Message Functions

© Copyright YoYo Games Ltd. 2018 All Rights Reserved