Text.h

/*--------------------------------------------------------------------------------------------
Copyright (c) 2019, NDEVR LLC
tyler.parke@ndevr.org
  __    __   ____     _____ __     __  _______
 |  \  |  | |  __ \  |  ___|\ \   / / |   __  \
 |   \ |  | | |  \ \ | |___  \ \ / /  |  |__)  |
 |  . \|  | | |__/ / | |___   \ V /   |   _   /
 |  |\    |_|_____/__|_____|___\_/____|  | \  \
 |__| \__________________________________|  \__\
 
Subject to the terms of the Enterprise+ Agreement, NDEVR hereby grants 
Licensee a limited, non-exclusive, non-transferable, royalty-free license 
(without the right to sublicense) to use the API solely for the purpose of 
Licensee's internal development efforts to develop applications for which 
the API was provided.
 
The above copyright notice and this permission notice shall be included in all 
copies or substantial portions of the Software.
 
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE
FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.
 
Library: Design
File: Text
Included in API: True
Author(s): Tyler Parke
 *-----------------------------------------------------------------------------------------**/
#pragma once
#include "DLLInfo.h"
#if NDEVR_TEXT_MODEL
#include <NDEVR/Model.h>
#include <NDEVR/TextConstructor.h>
#include <NDEVR/Font.h>
#include <NDEVR/StringEnum.h>
namespace NDEVR
{
    enum TextControlSequence
    {
          e_set_font = 'f'          
        , e_set_color = 'c'         
        , e_set_bold = 'b'          
        , e_set_italic = 'i'        
        , e_set_underline = '_'     
        , e_set_overstrike = '-'    
        , e_set_alignment = 'a'     
        , e_set_font_size = 's'     
        , e_set_fixed_width = 'w'   
        , e_set_tab_advance = 't'   
    };
    class TextConstructor; 
    class NDEVR_DESIGN_API Text : public Model
    {
    public:
        Text();
        Text(const Model& model);
        void setText(const TranslatedString& text, bool update_now = false);
        void setText(const StringView& text, bool update_now = false);
        void setText(const Buffer<TextBlock>& text, bool update_now = false);
        void setAlignment(uint01 alignment, bool update_now = false);

        uint01 alignment() const { return m_alignment; }
        void setInsertionAlignment(uint01 alignment, bool update_now = false);
        Model textLayer();
        Model textObject() const;
        void setCursor(uint04 cursor_position);
        void updateText();
        bool needsUpdate() const;
        void updateTranslation();
        void setConstrainedSize(const Vector<2, fltp08>& size);
        void setMaximumSize(const Vector<2, fltp08>& size);
        void setReferenceSize(const Vector<2, fltp08>& size);

        Vector<2, fltp08> getConstrainedSize();
        Vector<2, fltp08> getMaximumSize();
        Vector<2, fltp08> getReferenceSize();

        void setForwardBias(fltp08 forward_bias);
        void setLineSpaceFactor(fltp08 line_space);
        fltp08 lineSpaceFactor() const;
        StringView plainText() const;
        const Buffer<TextBlock>& blocks() const { return m_text_blocks; };
        Buffer<TextBlock> autoInsertNewLines() const;
        void autoReserveLines(Buffer<TextBlock>& blocks);
        void setFont(const Font& font, bool repaint_now = false);
        Font font() const;
        void saveBlockMetaData();
        void readMetaData();
        Model getLine(uint04 index);
        Model getLetterAt(uint04 string_position) const;
        Model getLetterAt(uint04 string_position, const Buffer<TextBlock>& blocks) const;
        static constexpr StringView TypeName() { return "text"; }
        void setFaceCamera(bool face_camera);
        void setScaleToCamera(bool face_camera);
        void setFillBackground(bool fill_background);
        static fltp04 DefaultScaler() { return .01f; }
    private:
        void init();
        bool setupLetter(const ConstPointer<TextConstructor>& printer, Model& letter, wchar value, fltp08 hor_advance, fltp08 scale, const Font& font);
        void setupCursor(const Matrix<fltp08>& matrix, const Vector<2, fltp08>& cursor_location, const Font& font);
        void findCursor(bool create_if_not_exists);
        void updateBackground();
        void createCursor();
    private:
        Buffer<TextBlock> m_text_blocks;            
        Vector<2, fltp08> m_constrained_size;       
        Vector<2, fltp08> m_maximum_size;           
        Vector<2, fltp08> m_reference_size;         
        Model m_text_model;                         
        uint04 m_cursor_index;                      
        uint04 m_cursor_position;                   
        uint01 m_alignment;                         
        uint01 m_insertion_alignment;               
        mutable fltp08 m_line_space_factor;         
        fltp08 m_forward_bias = 0.0;                
        bool m_has_background = false;              
        bool m_has_read_metadata = false;           
    };

#define TEXT_MODEL_PARAMS(X) \
        X(e_constrained_size) \
        X(e_maximum_size) \
        X(e_reference_size) \
        X(e_translated_text) \
        X(e_text_blocks) \
        X(e_font) \
        X(e_line_space_factor) \
        X(e_text)
    NDEVR_DEFINE_STRING_STREAM(TextProperty, TEXT_MODEL_PARAMS)
 
    
    template<> struct PropertySpec<TextProperty::e_constrained_size> { using type = Vector<2, fltp08>; };
    template<> struct PropertySpec<TextProperty::e_maximum_size> { using type = Vector<2, fltp08>; };
    template<> struct PropertySpec<TextProperty::e_reference_size> { using type = Vector<2, fltp08>; };
    template<> struct PropertySpec<TextProperty::e_translated_text> { using type = TranslatedString; };
    template<> struct PropertySpec<TextProperty::e_text> { using type = String; };
    template<> struct PropertySpec<TextProperty::e_line_space_factor> { using type = fltp08; };
    template<> struct PropertySpec<TextProperty::e_text_blocks> { using type = Buffer<TextBlock>; };
    template<> struct PropertySpec<TextProperty::e_font> { using type = Font; };
    template<>
    class PropertyInterface<TextProperty>
    {
    public:

        template<TextProperty t_property, class t_value_type>
        static void Set(DesignInfo* object, const t_value_type& value)
        {
            Text text = Text(Model(*object));
            if constexpr (t_property == TextProperty::e_constrained_size)
                text.setConstrainedSize(value);
            if constexpr (t_property == TextProperty::e_font)
                text.setFont(value);
            if constexpr (t_property == TextProperty::e_line_space_factor)
                text.setLineSpaceFactor(value);
            if constexpr (t_property == TextProperty::e_maximum_size)
                text.setMaximumSize(value);
            if constexpr (t_property == TextProperty::e_reference_size)
                text.setSize(value);
            if constexpr (t_property == TextProperty::e_translated_text)
                text.setText(value);
            if constexpr (t_property == TextProperty::e_text_blocks)
                text.setText(value);
            if constexpr (t_property == TextProperty::e_text)
                text.setText(value);
            text.updateText();
            text.saveBlockMetaData();
        }
        template<TextProperty t_property>
        static decltype(auto) Get(const DesignInfo* object)
        {
            Text text = Text(Model(*object));
            text.readMetaData();
            if constexpr (t_property == TextProperty::e_constrained_size)
                return text.getConstrainedSize();
            if constexpr (t_property == TextProperty::e_font)
                return text.font();
            if constexpr (t_property == TextProperty::e_line_space_factor)
                return text.lineSpaceFactor();
            if constexpr (t_property == TextProperty::e_maximum_size)
                return text.getMaximumSize();
            if constexpr (t_property == TextProperty::e_reference_size)
                return text.getReferenceSize();
            if constexpr (t_property == TextProperty::e_translated_text)
                return TranslatedString(text.plainText());
            if constexpr (t_property == TextProperty::e_text_blocks)
                return text.blocks();
            if constexpr (t_property == TextProperty::e_text)
                return text.plainText();
        }
        template<TextProperty t_property, class t_value_type>
        static decltype(auto) Get(const DesignInfo* object)
        {
            return Get<t_property>(object);
        }
    };
}
#endif