factory.hpp

Go to the documentation of this file.

/*
    Copyright 2005-2007 Adobe Systems Incorporated
    Distributed under the MIT License (see accompanying file LICENSE_1_0_0.txt
    or a copy at http://stlab.adobe.com/licenses.html)
*/

/*************************************************************************************************/

#ifndef ADOBE_UI_CORE_FACTORY_HPP
#define ADOBE_UI_CORE_FACTORY_HPP

/*************************************************************************************************/

#include <adobe/config.hpp>

#include <adobe/adam.hpp>
#include <adobe/any_regular.hpp>
#include <adobe/dictionary.hpp>
#include <adobe/dictionary.hpp>
#include <adobe/eve_parser.hpp>
#include <adobe/eve.hpp>
#include <adobe/future/assemblage.hpp>
#include <adobe/future/behavior.hpp>
#include <adobe/future/debounce.hpp>
#include <adobe/future/widgets/headers/display.hpp>
#include <adobe/future/widgets/headers/visible_change_queue.hpp>
#include <adobe/future/widgets/headers/widget_tokens.hpp>
#include <adobe/future/widgets/headers/widget_utils.hpp>
#include <adobe/future/widgets/headers/widget_factory_registry.hpp>
#include <adobe/istream.hpp>
#include <adobe/keyboard.hpp>
#include <adobe/memory.hpp>
#include <adobe/name.hpp>

#include <boost/filesystem/path.hpp>
#include <boost/function.hpp>

#include <list>
#include <vector>

/*************************************************************************************************/
//
//
/*************************************************************************************************/

namespace adobe {

/*************************************************************************************************/

struct eve_client_holder : public boost::noncopyable
{
    eve_client_holder(behavior_t& sheet_scope_root_behavior) :
        visible_change_queue_m(eve_m),
        root_behavior_m(sheet_scope_root_behavior),
        root_display_m()
    {
        eve_eval_token_m = root_behavior_m.insert(boost::bind(&visible_change_queue_t::update,
                                                              boost::ref(visible_change_queue_m)));
    }


    ~eve_client_holder()
    {
        root_behavior_m.disconnect(eve_eval_token_m);
    }

    /*
    NOTE (sparent) : Order is important here - we want to destruct window_m prior to destructing
    eve_m so that any notifications sent by the system are sent to valid object. Slots and
    signals on the window widgets would be a better way to handle this connection but I'm not
    there yet.
    */

    //
    //
    eve_t                                    eve_m;

    //
    //
    sheet_t                                  layout_sheet_m;
        
    //
    //
    assemblage_t                             assemblage_m;

    //
    //
    dictionary_t                             contributing_m;

    //
    //
    boost::signal<void ()>                   show_window_m;

    //
    //
    visible_change_queue_t                   visible_change_queue_m;
    
    //
    //
    behavior_t&                               root_behavior_m;

    //
    //
    behavior_t::verb_token_t                  eve_eval_token_m;

    //
    //
    behavior_t*                              my_behavior_m;

    //
    //
    platform_display_type                    root_display_m;

    //
    //
    boost::filesystem::path                  path_m;
};

/*************************************************************************************************/

typedef boost::function<void (name_t action, const any_regular_t&)> button_notifier_t;

/****************************************************************************************************/

/*
    REVISIT (sparent) : Size is inherited from the parent during initialization - the size
    specified to the client is relative to the parent's size. Does this ever need to
    be specified in absolutes?
*/

enum size_enum_t
{
    size_mini_s     = -2,
    size_small_s    = -1,
    size_normal_s   = 0,

    size_minimum_s  = size_mini_s,
    size_maximum_s  = size_normal_s
};

/*************************************************************************************************/

//
//
struct factory_token_t
{
    factory_token_t(display_t&                display,
                    sheet_t&                  sheet,
                    eve_client_holder& client_holder,
                    button_notifier_t  notifier) :
        display_m(display),
        sheet_m(sheet),
        client_holder_m(client_holder),
        notifier_m(notifier)
    { }

    //
    //
    display_t& display_m;

    //
    //
    sheet_t& sheet_m;

    //
    //
    eve_client_holder& client_holder_m;

    //
    //
    button_notifier_t notifier_m;
};

/*************************************************************************************************/
//
//
struct widget_node_t
{
    widget_node_t(  size_enum_t                     size,
                    const eve_t::iterator&          eve_token,
                    const platform_display_type&    display_token,
                    const keyboard_t::iterator&     keyboard_token
                    ) :
        size_m(size),
        eve_token_m(eve_token),
        display_token_m(display_token),
        keyboard_token_m(keyboard_token)
    { } 
    //
    //
    size_enum_t size_m;
    //
    //
    eve_t::iterator eve_token_m;
    //
    //
    mutable platform_display_type display_token_m;

    //
    keyboard_t::iterator keyboard_token_m;

};

/*************************************************************************************************/
//
//
widget_node_t row_factory(const dictionary_t& parameters, const widget_node_t& parent, const factory_token_t& token, const widget_factory_t& factory);

/*************************************************************************************************/
//
//
widget_node_t column_factory(const dictionary_t& parameters, const widget_node_t& parent, const factory_token_t& token, const widget_factory_t& factory);

/*************************************************************************************************/
//
//
widget_node_t overlay_factory(const dictionary_t& parameters, const widget_node_t& parent, const factory_token_t& token, const widget_factory_t& factory);

/*************************************************************************************************/
//
//
const widget_factory_t& default_asl_widget_factory();

/*************************************************************************************************/

inline widget_node_t default_factory(const widget_factory_t& factory,
                                     name_t                  widget_type,
                                     const dictionary_t&     parameters,
                                     const widget_node_t&    parent,
                                     const factory_token_t&  token)
{
    return factory.method(widget_type)(parameters, parent, token, factory);
}

/*************************************************************************************************/

typedef boost::function<widget_node_t (name_t                 widget_type,
                                       const dictionary_t&    parameters,
                                       const widget_node_t&   parent,
                                       const factory_token_t& token)> widget_factory_proc_t;

/*************************************************************************************************/

inline widget_factory_proc_t default_widget_factory_proc_with_factory(const widget_factory_t& factory)
{
    return boost::bind(&default_factory,
                       boost::cref(factory),
                       _1, _2, _3, _4);
}

/*************************************************************************************************/

inline widget_factory_proc_t default_widget_factory_proc()
{ return default_widget_factory_proc_with_factory(default_asl_widget_factory()); }

/*************************************************************************************************/

adobe::auto_ptr<eve_client_holder> make_view(name_t                                 file_name,
                                             const line_position_t::getline_proc_t& getline_proc,
                                             std::istream&                          stream,
                                             sheet_t&                               sheet,
                                             behavior_t&                            root_behavior,
                                             const button_notifier_t&               notifier,
                                             size_enum_t                            dialog_size,
                                             const widget_factory_proc_t&           proc = default_widget_factory_proc(),
                                             platform_display_type                  display_root=platform_display_type());

/*************************************************************************************************/

} // namespace adobe

/*************************************************************************************************/

#endif

/*************************************************************************************************/