source: GTP/trunk/App/Demos/Illum/Shark3D/version164x12u/IllumDemoApplication/src/res/universe/actor/universeplayer.s3d_actor @ 2269

///////////////////////////////////////////////////////////////////////////////
//
//      ##  ######
//       ######  ###
//  ## ###############        Shark 3D Engine (www.shark3d.com)
//   ########## # # #
//    ########                Copyright (c) 1996-2006 Spinor GmbH.
//   ######### # # #          All rights reserved.
//  ##   ##########
//      ##
//
///////////////////////////////////////////////////////////////////////////////

// Definition of a player on the universe.
//
// It mainly manages the connection to the client.
// A player actor lives as long as the connection to the client exists.
//
// A player actor does not contain level-specific player information.
// Such information is managed by a level-specific level-player actor.
// The level-player actor is created each time again entering a new level.
// For this, a level must understand a level-player command for producing
// the a level-player.

// Since each dsc-file formally can only contain a singe actor,
// we use the group actor to define more than one actor.
actor_ident "kit_base.group"
actor_param
{
    // Delegate action calls to the children.
    active 1
    child_array
    {
        ident "kit_base.producer"
        param
        {
            name "player_rawproducer"
            deleg_name "player_set"
            active 1
            ident "kit_base.capsule"
            param
            {
                // Delegate the action calls to all children:
                active 1
                // Name of the scope of the capsule.
                scope "universeplayer"
                // Name of the capsule actor within its own namespace.
                // Actors within the capsule can access the capsule
                // actor itself by this name.
                local_name "capsule"
                // Name of the capsule seen from outside
                // registered in the local namespace. Commands sent
                // to this actor are delegate to "delegate_target".
                local_deleg_name "capsule_deleg"
                // Delegate commands from outside to the dispatcher.
                deleg_target "dispatch_export"
                // The capsule contains a group of child actors.
                child_ident "kit_base.group"
                child_param
                {
                    // Delegate action calls to the children.
                    active 1
                    child_array
                    {
                        // Dispatcher for events from outside the player
                        // capsule.
                        ident "kit_base.dispatch"
                        param
                        {
                            name "dispatch_export"
                            entry_array
                            {
                                cmds "destroy"
                                targets "settingplayer" "capsule"
                            }
                            {
                                cmds "created_local"
                                targets
                            }
                            {
                                cmds "created_net"
                                targets "reproduce"
                                newcmd "set_blocked"
                            }
                            {
                                cmds "created_net"
                                targets "netlost"
                                newcmd "set_observe_activate"
                            }
                            {
                                cmds "store_pre"
                                targets "settingplayer_informmgr"
                                newcmd "inform_reset"
                            }
                            {
                                cmds "store_post"
                                targets "settingplayer_informmgr"
                                newcmd "inform_set"
                            }
                            {
                                cmds "load_post"
                                targets "settingplayer_fetch"
                                newcmd "perform_fetch_charge"
                            }
                            {
                                cmds "net_traverse"
                                targets
                                    "settingplayer_netproduce"
                                    "settingplayer_netappear"
                                    "netlost"
                                newcmd "traverse"
                            }
                            {
                                cmds "net_appear"
                                targets "reproduce"
                                newcmd "rework"
                            }
                            {
                                // Store the inform-actor in "inform":
                                cmds "assign_inform" "set_inform"
                                targets "inform_deleg"
                                newcmd "set_deleg_target"
                            }
                            {
                                cmds "assign_inform" "set_inform"
                                targets "informanswer"
                            }
                            {
                                // Refresh connection to setting-player.
                                cmds "assign_inform" "set_inform"
                                targets "settingplayer_refresh_charge"
                                newcmd "perform"
                            }
                            {
                                cmds "search_inform" "search_noinform"
                                targets "informanswer"
                            }
                            {
                                cmds "add_motion"
                                targets "settingplayer"
                            }
                            {
                                cmds "goto_level0" "goto_level1"
                                    "goto_level2" "goto_level3"
                                    "goto_level4" "goto_level5"
                                    "goto_level6" "goto_level7"
                                    "goto_level8" "goto_level9"
                                    "goto_level10" "goto_level11"
                                    "goto_level12" "goto_level13"
                                    "goto_level14" "goto_level15"
                                    "goto_level16" "goto_level17"
                                    "goto_level18" "goto_level19"
                                    "goto_level20" "goto_level21"
                                targets "^setting_serroot"
                            }
                            {
                                cmds "god" "goto_level_next" "goto_level_prev" 
                                    "special"
                                // Delegate to the setting-player:
                                targets "settingplayer"
                            }
                            {
                                cmds "store_file" "load_file"
                                targets "^setting"
                            }
                            {
                                cmds
                                    "notice_level_load_pre"
                                    "notice_level_load_post"
                                targets "inform"
                            }
                        }
                    }
                    {
                        ident "kit_base.dispatch"
                        param
                        {
                            name "dispatch"
                            entry_array
                            {
                                cmds
                                    "settingplayer_pre"
                                    "settingplayer_post"
                                targets
                            }
                        }
                    }
                    {
                        // Dispatcher for commands from the setting player:
                        ident "kit_base.dispatch"
                        param
                        {
                            name "dispatch_inform"
                            entry_array
                            {
                                cmds 
                                    "set_gfxmgr_level"
                                    "set_sndmgr_level"
                                    "set_state_world"
                                    "set_state_sky"
                                    "set_sim_world"
                                    "set_noise_world"
                                    "set_sensorstate_world"
                                    "set_camera"
                                    "set_playerbody"
                                targets "inform"
                            }
                            {
                                cmds "reproduce"
                                targets "settingplayer_netproduce"
                            }
                        }
                    }
                    {
                        ident "kit_base.deleg"
                        param
                        {
                            name "inform_deleg"
                            deleg_name "inform"
                            deleg_target ""
                            allow_no_target 1
                            enabled 1
                        }
                    }
                    {
                        ident "kit_engobj.informanswer"
                        param
                        {
                            name "informanswer"
                            answer_cmd "add_result"
                            answer_actor "capsule_deleg"
                        }
                    }
                    {
                        ident "kit_engobj.informmgr"
                        param
                        {
                            name "settingplayer_informmgr"
                            //
                            deleg_name "settingplayer"
                            // The inform-actor. A setting player sends
                            // its commands to this actor:
                            inform "dispatch_inform"
                            ignore_no_charge 1
                            // Recip about setting-player changes.
                            notify_target "dispatch"
                            notify_pre_cmd "settingplayer_pre"
                            notify_post_cmd "settingplayer_post"
                            // If no setting player exists, this command is 
                            // sent to this actor to get a player in a setting.
                            produce_target "^setting_serroot"
                            produce_cmd "rawproduce_player"
                        }
                    }
                    {
                        ident "kit_base.paramvoid"
                        param
                        {
                            name "settingplayer_refresh_charge"
                            target "settingplayer_informmgr"
                            cmd "refresh_charge"
                        }
                    }
                    {
                        ident "kit_engbase.netproducer"
                        param
                        {
                            name "settingplayer_netproduce"
                            produce_target "settingplayer_informmgr"
                            produce_cmd "produce_charge"
                            net_traverse_cmd "net_traverse"
                            created_local_cmd "created_local"
                            created_net_cmd "created_net"
                        }
                    }
                    {
                        ident "kit_engbase.netappear"
                        param
                        {
                            name "settingplayer_netappear"
                            appear_target "settingplayer"
                            appear_cmd "net_appear"
                        }
                    }
                    {
                        ident "kit_engobj.fetch"
                        param
                        {
                            name "settingplayer_fetch"
                            query_target "settingplayer_informmgr"
                            query_cmd "get_charge"
                            produce_target "settingplayer_netproduce"
                            produce_cmd "produce"
                            produce_report_target ""
                            produce_report_cmd ""
                            enum_target "^setting_serroot"
                            enum_cmd "find_player"
                            enum_report_target "settingplayer_informmgr"
                            enum_report_cmd "assign_charge"
                        }
                    }
                    {
                        ident "kit_engbase.netreproduce"
                        param
                        {
                            name "reproduce"
                            producer "^player_netproducer"
                            charge "capsule_deleg"
                            reproduce_cmd "reproduce"
                        }
                    }
                    {
                        ident "kit_snk.childif"
                        param
                        {
                            extcfg_actor "^^universe_cfg"
                            extcfg_entry_switch "server"
                            then_child_ident "kit_base.onaction"
                            then_child_param
                            {
                                // Check if a new player must be created.
                                active 1
                                name "check_settingplayer_onaction"
                                target "settingplayer_fetch"
                                cmd "check_produce_charge"
                            }
                        }
                    }
                    {
                        ident "kit_engbase.netlost"
                        param
                        {
                            active 0
                            name "netlost"
                            lost_target "dispatch_export"
                            lost_cmd "destroy"
                        }
                    }
                }
            }
        }
    }
}