summaryrefslogblamecommitdiffstats
path: root/src/core/hle/applets/applet.h
blob: af442f81d57dc87e755bac536ef1890ad914fe20 (plain) (tree)
1
2
3
4
5
6
7
8
9





                                            


                            




                                     
              
       

                                                  

       
                                                                              
                                     

                                                                       



                                                        


                                                                    



                                                                  


                                                                       
       
                                                                                             

       


                                                                       
       
                                                                            
 


                                                                                        
                                       





                                                                                            







                                                                                            


                                                     


                                                         





                               

              
// Copyright 2015 Citra Emulator Project
// Licensed under GPLv2 or any later version
// Refer to the license.txt file included.

#pragma once

#include <memory>

#include "core/hle/result.h"
#include "core/hle/service/apt/apt.h"

namespace HLE {
namespace Applets {

class Applet {
public:
    virtual ~Applet() { }
    Applet(Service::APT::AppletId id) : id(id) { }

    /**
     * Creates an instance of the Applet subclass identified by the parameter.
     * and stores it in a global map.
     * @param id Id of the applet to create.
     * @returns ResultCode Whether the operation was successful or not.
     */
    static ResultCode Create(Service::APT::AppletId id);

    /**
     * Retrieves the Applet instance identified by the specified id.
     * @param id Id of the Applet to retrieve.
     * @returns Requested Applet or nullptr if not found.
     */
    static std::shared_ptr<Applet> Get(Service::APT::AppletId id);

    /**
     * Handles a parameter from the application.
     * @param parameter Parameter data to handle.
     * @returns ResultCode Whether the operation was successful or not.
     */
    virtual ResultCode ReceiveParameter(const Service::APT::MessageParameter& parameter) = 0;

    /**
     * Handles the Applet start event, triggered from the application.
     * @param parameter Parameter data to handle.
     * @returns ResultCode Whether the operation was successful or not.
     */
    ResultCode Start(const Service::APT::AppletStartupParameter& parameter);

    /**
     * Whether the applet is currently executing instead of the host application or not.
     */
    virtual bool IsRunning() const = 0;

    /**
     * Handles an update tick for the Applet, lets it update the screen, send commands, etc.
     */
    virtual void Update() = 0;

protected:
    /**
     * Handles the Applet start event, triggered from the application.
     * @param parameter Parameter data to handle.
     * @returns ResultCode Whether the operation was successful or not.
     */
    virtual ResultCode StartImpl(const Service::APT::AppletStartupParameter& parameter) = 0;

    Service::APT::AppletId id; ///< Id of this Applet
};

/// Returns whether a library applet is currently running
bool IsLibraryAppletRunning();

/// Initializes the HLE applets
void Init();

/// Shuts down the HLE applets
void Shutdown();

}
} // namespace