$Date: 2005/10/23 10:46:16 $
$Revision: 1.3 $
-- Returns reference to the singleton
-- (From EM_TIME_SINGLETON)
-- Should Current not scale when drawed?
-- True means that the object will be drawed unscaled
-- but its position (reference_point) will still be transformed correctly
-- if drawed on a transformed scaled coordinate system
-- (This is handled accordingly by draw_object of EM_SURFACE)
-- (From EM_DRAWABLE)
-- Horizontal position, distance in pixels from left
-- (From EM_DRAWABLE)
-- Vertical position, distance in pixels from top
-- (From EM_DRAWABLE)
-- Change Current object state to
-- state at a_time (in milliseconds).
-- (From EM_ANIMATABLE)
-- Draw rectangular part of Current defined by a_rect to a_surface.
-- (Subclasses could redefine this feature for providing an implementation
-- with better performance, otherwise its just done per default by
-- transforming and clipping coordinates on a_surface before calling draw).
-- (From EM_DRAWABLE)
-- The current position in the image
-- Sets cur_position to i, only change cur_position if you know what you are doing
-- Sets the speed to i pixels per second
-- The speed in pixels per sec
-- Have events been initialized?
-- (From EM_DRAWABLE)
-- Event initialization.
-- Needs to be called before subscribing for events.
-- (From EM_DRAWABLE)
-- Mouse button down event,
-- gets published when the mouse button is pressed over Current,
-- an EM_MOUSEBUTTON_EVENT is passed as argument
-- (From EM_DRAWABLE)
-- Mouse button up event,
-- gets published when the mouse button is released over Current,
-- an EM_MOUSEBUTTON_EVENT is passed as argument
-- (From EM_DRAWABLE)
-- Mouse button up event,
-- gets published when the mouse button is released over Current,
-- an EM_MOUSEMOTION_EVENT is passed as argument
-- (From EM_DRAWABLE)
-- Publish mouse event when a_mouse_event occured on Current.
-- Descendants should redefine this feature
-- for only catching and publishing their mouse events when mouse pointer
-- is realy inside object or for
-- distributing mouse events to child objects.
-- (From EM_DRAWABLE)
-- Orthogonal rectangle surrounding Current; (i.e. usefull
-- for visibility testing if it intersects with
-- coordinate_area of EM_SURFACE) TODO: We create a new
-- one on each call. Maybe there is a more efficient way to
-- do that?
-- (From EM_DRAWABLE)
-- Reference point of Current relative to which it should be positioned.
-- (i.e. important when drawn on a scaled coordinate system and is_size_fixed is True)
-- (From EM_DRAWABLE)
An EM_NEVER_ENDING_BACKGROUND uses an EM_TILE_PATTERN that is glued together infinite
times in either horizontal or vertical direction. You can
move that background in the corresponding direction at any speed
(given in pixels per second).
See the tile_pattern example for a demonstration.