Sources/AddOn/Spec.hpp - master - kuvbur/AddOn_SomeStuff

Sources/AddOn/Spec.hpp
127 строк8 KB
Дмитрий
Исправил ошибку в нумерации, добавил файлы примера
21 авг 2025, 15:20
21 авг 2025, 15:205709f97
//------------ kuvbur 2022 ------------
#pragma once
#if !defined (SPEC_HPP)
#define	SPEC_HPP
#ifdef AC_25
#include	"APICommon25.h"
#endif // AC_25
#ifdef AC_26
#include	"APICommon26.h"
#endif // AC_26
#ifdef AC_27
#include	"APICommon27.h"
#endif // AC_27
#ifdef AC_28
#include	"APICommon28.h"
#endif // AC_28
#ifdef AC_29
#include	"APICommon29.h"
#endif // AC_28
#include	"Helpers.hpp"

namespace Spec
{
struct GroupSpec
{
    GS::Array<GS::UniString> unic_paramrawname = {}; // Массив имён уникальных параметров
    GS::Array<GS::UniString> out_paramrawname = {}; // Массив имён параметров для передачи новым элементам
    GS::Array<GS::UniString> sum_paramrawname = {}; // Массив имён параметров, которые требуется просуммировать
    GS::UniString flag_paramrawname = "";           // Имя параметра-флага, определяющего - будет ли элемент учтён в спецификации
    bool is_Valid = true;
    bool fromMaterial = false;
    GS::Int32 n_layer = 0;
};


struct SpecRule
{
    GS::Array<GroupSpec> groups = {};                   // Массив с группами подэлементов 
    GS::Array<GS::UniString> out_paramrawname = {};     // Массив имён параметров новых элементов
    GS::Array<GS::UniString> out_sum_paramrawname = {}; // Массив имён параметров сумм новых элементов
    GS::UniString subguid_paramrawname = "";       // Имя свойства для записи GUID созданных элементов (в описании должно содержатся Sync_GUID+Имя правила)
    GS::UniString subguid_rulename = "";           // Имя свойства с правилом, на основании которого созданы элементы
    GS::UniString subguid_rulevalue = "";
    GS::Array<API_Guid> elements = {};                  // Элементы, которые обрабатываются правилом
    GS::Array<API_Guid> exsist_elements = {}; // Прежде созданные элементы для этого правила
    API_PropertyDefinition rule_definitions = {};       // Определение свойства с правилом для поиска элементов, в которых оно доступно
    GS::UniString favorite_name = "";              //Имя элемента в избранном
    bool is_Valid = true;
    bool delete_old = false;
    bool stop_on_error = true;
    bool only_visible = true;
};

struct Element
{
    GS::Array<ParamValue> out_param = {};
    GS::Array<ParamValue> out_sum_param = {};
    GS::Array<GS::UniString> out_paramrawname;
    GS::Array<GS::UniString> out_sum_paramrawname;
    GS::UniString subguid_paramrawname = "";
    GS::UniString subguid_rulename = "";
    GS::UniString subguid_rulevalue = "";
    GS::UniString favorite_name = "";              //Имя элемента в избранном
    GS::Array<API_Guid> elements = {};                  // Элементы, которые обрабатываются правилом
    API_Guid exs_guid = APINULLGuid; // GUID существующего элемента для перезаписи
};

typedef GS::HashTable<GS::UniString, Element> ElementDict; // Словарь элементов для создания, ключ - сцепка значений уникальных параметров

typedef GS::HashTable<GS::UniString, SpecRule> SpecRuleDict; // Словарь правил, ключ - имя правила

// --------------------------------------------------------------------
// Получение правил из свойств элемента по умолчанию
// --------------------------------------------------------------------
bool GetRuleFromDefaultElem (SpecRuleDict& rules, API_DatabaseInfo& homedatabaseInfo, bool& has_elementspec);

GSErrCode SpecAll (const SyncSettings& syncSettings);

void SpecFilter (API_Guid& elemguid, API_DatabaseInfo& homedatabaseInfo);

void SpecFilter (GS::Array<API_Guid>& guidArray, API_DatabaseInfo& homedatabaseInfo);

GSErrCode SpecArray (const SyncSettings& syncSettings, GS::Array<API_Guid>& guidArray, SpecRuleDict& rules, const UnicGuid& selected_elements);

// --------------------------------------------------------------------
// Проверяет значение свойства с правилом и формрует правила
// --------------------------------------------------------------------
GSErrCode GetRuleFromElement (const API_Guid& elemguid, SpecRuleDict& rules);

void AddRule (const API_PropertyDefinition& definition, const API_Guid& elemguid, SpecRuleDict& rules);

// --------------------------------------------------------------------
// Разбивает строку на части. Будем постепенно заменять на пустоту обработанные части 
// Критерий - значение, по которому будет сгруппированы элементы
// g(P1, P2, P3; F; Q1, Q2) - P1...P3 параметры, уникальные для вложенного элемента,
// 
//                            F - флаг включения группы 1/0. Если не найден - всегда 1
//                            Q1...Q2 параметры или значения количества, будут просуммированы. Если их нет - запишем 1 для суммы.
// s(Pn1, Pn2, Pn3; Qn1, Qn2) - Pn1...Pn3 параметры размещаемых объектов,
//                              Qn1...Qn2 параметры для записи количества
// Spec_rule {КРИТЕРИЙ ;g(P1, P2, P3; Q1, Q2) g(P4, P5, P6; Q3, Q4) s(Pn1, Pn2, Pn3; Qn1, Qn2)}
// --------------------------------------------------------------------
SpecRule GetRuleFromDescription (GS::UniString& description);

GSErrCode GetElementForPlaceProperties (const GS::UniString& favorite_name, GS::HashTable<GS::UniString, GS::UniString>& paramdict);

bool GetParamValue (const API_Guid& elemguid, const GS::UniString& rawname, const ParamDictElement& paramToRead, ParamValue& pvalue, bool fromMaterial, GS::Int32 n_layer);

Int32 GetElementsForRule (SpecRule& rule, const ParamDictElement& paramToRead, ElementDict& elements, ElementDict& elements_mod, GS::Array<API_Guid>& elements_delete, UnicGuid& error_element);

// --------------------------------------------------------------------
// Выбирает из параметров групп имена свойств для дальнейшего чтения
// --------------------------------------------------------------------
void GetParamToReadFromRule (SpecRuleDict& rules, ParamDictValue& propertyParams, ParamDictElement& paramToRead, ParamDictValue& paramToWrite);

GSErrCode GetElementForPlace (const GS::UniString& favorite_name, API_Element& element, API_ElementMemo& memo);

// --------------------------------------------------------------------
// Получение размеров элемента для размещения по сетке
// Возвращает истину, если был найден параметр somestuff_spec_hrow - в этом случае элементы размещаются сверху вниз
// --------------------------------------------------------------------
bool GetSizePlaceElement (const API_Element& elementt, const API_ElementMemo& memot, double& dx, double& dy);

GSErrCode PlaceElements (GS::Array<ElementDict>& elementstocreate, ParamDictValue& paramToWrite, ParamDictElement& paramOut, Point2D& startpos);
}

#endif