Eiffel Media API
Overview Cluster Class Classes Index      Previous Next      Top Features

em.network.multiplayer

Class EM_NET_OBJECT


Direct ancestors

EM_NETWORK_CONSTANTS

Known direct descendants

EM_NET_TIME_OBJECT, EM_NET_EVENT_OBJECT, EM_NET_EVENT_CONTAINER_OBJECT, EM_NET_CLIENT_OBJECT

Features

Invariants

indexing

description

Represents an object than can be transmitted over a network.

date

$Date: 2005/10/26 14:05:23 $

revision

$Revision: 1.37 $

deferred class

EM_NET_OBJECT

feature -- Initialization

init_serialization_byte_count: INTEGER

-- Count of bytes needed for a successful serialization of initialization data.
-- The default behaviour uses the serialize_byte_count feature.
-- If you redefine serialize_init_data, you'll also to redefine this feature.
-- This might be a constant and *could* be a dynamic value.
-- {EM_NET_WORK_CONSTANTS}.max_serialization_byte_count is the limit!

make_from_stream (an_unserializer: EM_NET_UNSERIALIZER)

-- Initialize object with data from an_unserializer.
-- The default behaviour uses the unserialize feature.
-- If you have other/extended initialization data you need to redefine this feature.
-- Note: There is no need to serialize the type ID, this is done automatically.
-- This function will usually be called by the EM_NET_OBJECT_GENERATOR class.

make_set_type (a_type_id: INTEGER)

-- Create an instance and set type_id to a_type_id.

serialize_init_data (a_serializer: EM_NET_SERIALIZER)

-- Serialize initialization data to the given stream using a_serializer.
-- The default behaviour uses the serialize feature.
-- If you redefine make_from_stream, you'll also have to redefine this feature.
-- Note: There is no need to serialize the type ID, this is done automatically.

feature {EM_NET_BASE,EM_NET_EVENT_CONTAINER_OBJECT} -- Element change

set_group (a_group: EM_NET_GROUP)

-- Set group to a_group.
-- Note that an object can only belong to one group.
-- If you set a new group, the object should be removed from the previous one first.

require
not_already_added_to_a_group: not a_group.has_object (Current)
ensure
group_set: group = a_group
set_id (an_id: INTEGER)

-- Set id to an_id.

ensure
id_correct_set: an_id = id
set_time_offset (a_time: INTEGER)

-- Set last_update to a_time.

ensure
last_update_set: time_offset = a_time
set_updating_connection (a_connection: EM_NET_CONNECTION)

-- Set updating_connection to a_connection.

require
a_connection_not_void: a_connection /= Void
ensure
updating_connection_set: updating_connection = a_connection

feature -- Serialization

serialization_byte_count: INTEGER

-- Count of bytes needed for a successful serialization
-- This might be a constant and *could* be a dynamic value.
-- {EM_NET_WORK_CONSTANTS}.max_serialization_byte_count is the limit!

ensure
Result_in_max_serialization_byte_count_range: Result <= max_serialization_byte_count.item
serialize (a_serializer: EM_NET_SERIALIZER)

-- Serialize to the given stream using a_serializer.

require
a_serializer_not_void: a_serializer /= Void
unserialize (an_unserializer: EM_NET_UNSERIALIZER)

-- Unserialize from a given stream using an_unserializer.

require
a_unserializer_not_void: an_unserializer /= Void

feature -- Information

group: EM_NET_GROUP

-- Group that contains the current object
-- The object will be synchronized with all clients that are in
-- the same group.

id: INTEGER

-- Unique ID that indentifies a single instance of an object

is_make_set_type_called: BOOLEAN

-- Has make_set_type been called?

is_synchronisation_needed: BOOLEAN

-- Is synchronisation needed?
-- False by default.

is_synchronized: BOOLEAN

-- Is this object currently synchronized over network?
-- True if this object is added to a server or client list for synchronisation.

next_sync_frame: INTEGER

-- Next time when object synchronisation occurs

time_offset: INTEGER

-- Time in miliseconds of the lastupdate

type_id: INTEGER

-- ID that identifies the type of of an on object

updating_connection: EM_NET_CONNECTION

-- Connection which sent the last update

invariant

type_id_set_by_factory: type_id > 0 and is_make_set_type_called

-- From ANY
reflexive_equality: standard_is_equal (Current)
reflexive_conformance: conforms_to (Current)

end