Obsolete mPlay Functions

These functions deal with multi player/internet information transfer.

Function List:

Function Description
mplay_data_write Write value val (string or real) into location ind (ind between 0 and 1000000).
mplay_data_read Returns the value in location ind (ind between 0 and 1000000). Initially all values are 0.
mplay_data_mode Sets whether or not to use guaranteed transmission for shared data. guar should either be true (the default) or false.
mplay_init_ipx Initializes an IPX connection.
mplay_init_tcpip Initializes 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_modem Initializes 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_serial Initializes 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_status Returns the status of the current connection.
mplay_end Ends the current connection.
mplay_ipaddress Returns the IP address of your machine (e.g. '123.123.123.12') as a string.
mplay_message_send Sends 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_guaranteed Sends 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_receive Receives 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_id Returns the identifier of the last received message.
mplay_message_value Returns the value of the last received message.
mplay_message_player Returns the player who sent the last received message.
mplay_message_name Returns the name of the player who sent the last received message.
mplay_message_count Returns the number of messages left in the queue from the player (use 0 to count all message).
mplay_message_clear Removes all messages left in the queue from the player (use 0 to remove all message).
mplay_player_find Searches for all players in the current session and returns the number of players found.
mplay_player_name Returns 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_id Returns 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_create Creates a new session on the current connection.
mplay_session_find Searches for all sessions that still accept players and returns the number of sessions found.
mplay_session_name Returns the name of session number numb (0 is the first session). This routine can only be called after calling the previous routine.
mplay_session_join Makes you join session number numb (0 is the first session). playername is your name as a player. Returns whether successful.
mplay_session_mode Sets 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_status Returns the status of the current session.
mplay_session_end Ends 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.





No Examples Submitted

Does this page need better examples? Be the first to Submit

No Edits Suggested

Is this page unclear or not descriptive enough? Suggest an edit to the page and with enough upvotes your changes will be made.

No Questions Have Been Ask

Do you have a question about this page? Ask it Here