Справка

Эта страница только для чтения. Вы можете посмотреть исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
====== Выбор объектов на поперечном профиле ======

[[road:work_with_track:cross_profiles:start|Поперечные профили]] являются экземплярами класса [[developers:references:topomatic.alg.crs.section|Section]]. Получение списка поперечных профилей осуществляется через свойство [[developers:references:topomatic.alg.crs.corridor.sections|Sections]] класса [[developers:references:topomatic.alg.crs.corridor|Corridor]] (подробнее о получении [[developers:references:topomatic.alg.alignment.corridor|Corridor]] можно узнать из раздела руководства [[developers:tutorial:algstationing|Выбор модели подобъекта и преобразование координат]]). Состояние [[developers:references:topomatic.alg.crs.section|Section]] определяется следующими свойствами:
  * [[developers:references:topomatic.alg.crs.section.constructionid|ConstructionId]] - Идентификатор проектной конструкции
  * [[developers:references:topomatic.alg.crs.section.sectionline|SectionLine]] - Контур сечения ЦММ, на которые ссылается подобъект. Статический или динамический, в зависимости от состояния свойства StaticEg
  * [[developers:references:topomatic.alg.crs.section.selected|Selected]] - признак [[road:work_with_track:cross_profiles:mark_diameters:start|выбора поперечного профиля]] для последующего экспорта в чертёж
  * [[developers:references:topomatic.alg.crs.section.staticeg|StaticEg]] - 	[[road:work_with_track:cross_profiles:editing_black_diameters:start|Статическая существующая земля]]. Если статическая земля не содержит узлов, то поперечный профиль становится динамическим
  * [[developers:references:topomatic.alg.crs.section.station|Station]] - Расстояние от начала трассы до створа поперечного профиля

==== Поиск поперечного профиля по пикетажу ====

Найти поперечный профиль по его пикетажу можно воспользовавшись следующей конструкцией:
<code csharp>
...
    var corridor = alignment.Corridor;
    var sections = corridor.Sections; //список поперечных профилей
    var pkPlus = "1+00.00"; //пикетаж поперечного профиля
    double sta;
    if (!alignment.Stationing.TryStringToStation(pkPlus, out sta)) return;
    if (!sections.IsExist(sta)) return;
    var sectionIndex = sections.GetIndex(sta); //индекс поперечного профиля в списке поперечных профилей
    var section = sections[sectionIndex]; //поперечный профиль
...
</code>

==== Контекст конструирования поперечного профиля ====

[[developers:references:topomatic.alg.crs.section|Section]] не содержит в себе проектную конструкцию. В программном комплексе [[http://topomatic.ru/|Топоматик Робур]] проектная конструкция представлена в виде контекста конструирования поперечного профиля ([[developers:references:topomatic.crs.templates.crsdesigncontext|CrsDesignContext]]), который может содержать в себе различные [[rail:rail:projecting_cross_profiles:start|элементы построения проектного контура поперечного профиля]]. Все элементы контекста являются наследниками [[developers:references:topomatic.crs.templates.crscomponent|CrsComponent]]. Получить доступ к контексту можно двумя способами:
  - По индексу поперечного профиля с помощью свойства [[developers:references:topomatic.alg.crs.corridor.item_system.int32|Item[Int32] ]] класса [[developers:references:topomatic.alg.crs.corridor|Corridor]].
  - По расстоянию от начала трассы до створа поперечного профиля с помощью метода [[developers:references:topomatic.alg.crs.corridor.createdesigncontext_system.double|CreateDesignContext()]] класса [[developers:references:topomatic.alg.crs.corridor|Corridor]]. В этом случае контекст создаётся даже если поперечного профиля нет в списке поперечных профилей.

Базовые элементы контекста конструирования поперечного профиля:
  * [[developers:references:topomatic.crs.templates.crscontainer|CrsContainer]] - коллекция элементов
  * [[developers:references:topomatic.crs.templates.crscontour|CrsContour]] - контур
  * [[developers:references:topomatic.crs.templates.crsnode|CrsNode]] - Узел
  * [[developers:references:topomatic.crs.templates.crsray|CrsRay]] - луч
  * [[developers:references:topomatic.crs.templates.crsvolume|CrsVolume]] - объём

===== Подготовка модуля =====

Создайте и настройте новый [[developers:tutorial:module|модуль]] для подключения к программному комплексу [[http://www.topomatic.ru|Топоматик Робур]]. 

С помощью диалогового окна Менеджер ссылок добавьте ссылки на следующие библиотеки:

  * [[developers:references:topomatic.alg|Topomatic.Alg.dll]] - базовые классы подобъектов
  * [[developers:references:topomatic.alg.model|Topomatic.Alg.Model.dll]] - возможность использования класса [[developers:references:topomatic.alg.model.alignmentactivitymanager|AlignmentActivityManager]] для получения индекса текущего поперечного профиля
  * [[developers:references:topomatic.cad.foundation|Topomatic.Cad.Foundation.dll]] - базовые математические типы и операции
  * [[developers:references:topomatic.cad.view|Topomatic.Cad.View.dll]] - элемент управления для отображения слоёв моделей
  * [[developers:references:topomatic.controls|Topomatic.Controls.dll]] - возможность использования нативного диалогового окна программного комплекса Топоматик Робур (Класс [[developers:references:topomatic.controls.dialogs.messagedlg|MessageDlg]]). Данная библиотека не является обязательной, но она требуется для работоспособности кода примеров приведённых далее.
  * [[developers:references:topomatic.crs|Topomatic.Crs.dll]] - базовые классы поперечных профилей

Выбор элементов контекста конструирования поперечного профиля на экране осуществляется с помощью методов статического класса [[developers:references:topomatic.cad.view.hints.cadcursors|CadCursors]]. Подробнее о работе с классом [[developers:references:topomatic.cad.view.hints.cadcursors|CadCursors]] можно узнать в разделе руководства [[developers:tutorial:cadcursors|"Выбор элемента и ввод через курсор"]].

==== Выбор узлов конструкции поперечного профиля по коду ====

В этом примере мы выделим узлы конструкции поперечника с введённым пользователем кодом.

Сперва определим активную модель объекта аналогично тому, как это сделано в разделе руководства [[developers:tutorial:algedit|Редактирование плана и профиля]] в подразделе **Подготовка модуля**. Далее предложим пользователю ввести код узла с помощью статического класса [[developers:references:topomatic.cad.view.hints.cadcursors|CadCursors]] и его метода [[developers:references:topomatic.cad.view.hints.cadcursors.getinteger_topomatic.cad.view.cadview_ref_system.int32_system.string_arr_system.string|GetInteger()]]. Получим указатель на набор объектов нашего [[developers:references:topomatic.cad.view.cadview|CadView]] c помощью свойства [[developers:references:topomatic.cad.view.cadview.selectionset|SelectionSet]] и отфильтруем объекты на поперечном профиле так, чтобы в выбор были помещены только узлы с заданным кодом.

В теле программного модуля объявите команду, и декорируйте её атрибутом «cmd». Команда «select_construction_nodes_by_code» предложит пользователю ввести код узла конструкции поперечного профиля и поместит в текущий набор объектов все узлы с введённым кодом.

<code csharp>
...
    [cmd("select_construction_nodes_by_code")]
    private void SelectConstructionNodesByCode()
    {
        //Получаем модель текущей трассы. Если текущей является не трасса, то активируется последняя активная трасса
        Alignment alignment;
        using (var receiver = ActiveAlignmentReciver<Alignment>.CreateReciver(false))
        {
            alignment = receiver.Alignment;
            if (alignment == null)
            {
                MessageDlg.Show("Необходимо сделать трассу активной.", MessageBoxButtons.OK, MessageBoxIcon.Information, MessageBoxDefaultButton.Button1);
                return;
            }
            var cadview = CadView;
            if (cadview == null) return;

            // Выбор точек по коду
            var code = 0;
            var getPointRes = CadCursors.GetInteger(cadview, ref code, "Введите код точки:");
            if (getPointRes == GetPointResult.Cancel) return;

            var ss = CadView.SelectionSet;
            ss.Clear();
            ss.SelectAll();
            ss.FilterSelected(o =>
            {
                var wrapper = o as CrsDesignEntityWrapper;
                if (wrapper == null) return false;

                var node = wrapper.Component as CrsNode;
                if (node == null) return false;

                return node.Code.Equals(code);
            });
        }
    }
...
</code>

{{ :developers:tutorial:alignmentedit:tutalgselectnodes.png?nolink |}}

==== Расчёт площади контуров конструкции поперечного профиля ====

В этом примере рассчитаем сумму площадей контуров конструкции поперечного с введённым пользователем кодом.

В отличии от предыдущего примера, доступ к элементам конструкции поперечного профиля мы осуществим не через набор объектов текущего видового экрана, а через контекст конструирования поперечного профиля. Для получения контекста воспользуемся свойством [[developers:references:topomatic.alg.crs.corridor.item_system.int32|Item[Int32] ]] класса [[developers:references:topomatic.alg.alignment.corridor|Corridor]]. Индекс текущего поперечного профиля получим через свойство [[developers:references:topomatic.alg.model.alignmentactivitymanager|CurrentSection]] менеджера активности подобъекта ([[developers:references:topomatic.alg.model.alignmentactivitymanager|AlignmentActivityManager]]). [[developers:references:topomatic.alg.model.alignmentactivitymanager|AlignmentActivityManager]] получается с помощью свойства [[developers:references:topomatic.alg.runtime.serviceclasses.activealignmentreciver.manager|Manager ]] класса [[developers:references:topomatic.alg.runtime.serviceclasses.activealignmentreciver|ActiveAlignmentReciver]]. Получив контекст мы можем найти среди его элементов контуры при помощи метода [[developers:references:topomatic.crs.templates.crscontainer.findcontour_system.int32|FindContour()]], передав указанный код в качестве аргумента.
[[developers:references:topomatic.crs.templates.crscontour|CrsContour]] не содержит информации о занимаемой им площади. Чтобы получить площадь контура следует получить список его векторов и передать этот список в качестве аргумента методу [[developers:references:topomatic.cad.foundation.cadlibrary.polygonarea_system.collections.generic.ienumerable_1|PolygonArea()]] статического класса [[developers:references:topomatic.cad.foundation.cadlibrary|CadLibrary]].

В теле программного модуля объявите команду, и декорируйте её атрибутом «cmd». Команда «get_construction_contours_by_code» предложит пользователю ввести код контура конструкции поперечного профиля и рассчитает суммарную площадь контуров с введённым кодом.

<code csharp>
...
    [cmd("get_construction_contours_by_code")]
    private void GetConstructionContoursByCode()
    {
        //Получаем модель текущей трассы. Если текущей является не трасса, то активируется последняя активная трасса
        Alignment alignment;
        using (var receiver = ActiveAlignmentReciver<Alignment>.CreateReciver(false))
        {
            alignment = receiver.Alignment;
            if (alignment == null)
            {
                MessageDlg.Show("Необходимо сделать трассу активной.", MessageBoxButtons.OK, MessageBoxIcon.Information, MessageBoxDefaultButton.Button1);
                return;
            }

            //Переключаемся на вкладку поперечников и указываем код для поиска контуров
            IDocumentWindow window;
            if (!ApplicationHost.Current.ActiveProject.TryGetWindow(Consts.CrossWindow, out window)) return;
            window.Activate();

            var cadview = CadView;
            if (cadview == null) return;

            var code = 0;
            var getPointRes = CadCursors.GetInteger(cadview, ref code, "Введите код контура:");
            if (getPointRes == GetPointResult.Cancel) return;

            // Получение контуров по коду и расчёт их площади
            var corridor = alignment.Corridor;
            var index = receiver.Manager.CurrentSection;
            var context = corridor[index];
            if (context == null) return;

            var contours = context.FindContour(code);
            if (contours == null || !contours.Any())
            {
                MessageDlg.Show($"Контуры с кодом {code} не найдены.");
                return;
            }

            var commonArea = 0.0;
            foreach (CrsContour contour in contours)
                commonArea += CadLibrary.PolygonArea(contour.AsVectorList());

            MessageDlg.Show($"Общая площадь контуров с кодом {code} = {ValueConverter.AreaToStr(commonArea)}");
        }
    }
...
</code>

{{ :developers:tutorial:alignmentedit:tutalgcalcarea.png?nolink |}}

==== Расчёт объёма насыпи и выемки поперечного профиля ====

В этом примере определим величину объёма насыпи и выемки на поперечном профиле. За величину объёма примем площадь пресечения контура чёрной земли и контура проектной конструкции поперечного профиля.

Аналогично предыдущему примеру, получим контекст конструирования поперечного профиля. Далее из контекста получим контур поверхности земли и контур проектной линии с помощью методов [[developers:references:topomatic.crs.templates.crsdesigncontext.getegcontour|GetEgContour()]] и [[developers:references:topomatic.crs.templates.crsdesigncontext.getredlinecontour|GetRedLineContour()]] соответственно. Полученные контуры представим в виде списка двумерных векторов ([[developers:references:topomatic.cad.foundation.vector2d|Vector2D]]), для дальнейшей возможности рассчитать их площадь.
Для расчёта площади пересечения, контуры необходимо достроить. Если требуется рассчитать площадь насыпи, в контур поверхности земли добавим два новых узла располагающиеся на 100 метров выше относительно крайних вершин контура. Контур проектной линии достроим аналогично контуру поверхности земли, но новые узлы расположим на 100 метров ниже. Величина смещения 100 метров взята в качестве примера. Важно, чтобы сегменты контура не пересекали этот контур при замыкании. Если требуется рассчитать площадь выемки, то нужно достроить контуры таким же образом, но в противоположном направлении.
После того, как контур поверхности земли и контур проектной линии достроены, определим контуры их пересечения с помощью метода [[developers:references:topomatic.cad.foundation.polygonoperation.intersection_system.collections.generic.ilist_1_system.collections.generic.ilist_1|Intersection()]] класса [[developers:references:topomatic.cad.foundation.polygonoperation|PolygonOperation]]. Для подсчёта суммы площадей контуров пересечения следует воспользоваться методом [[developers:references:topomatic.cad.foundation.cadlibrary.polygonarea_system.collections.generic.ienumerable_1|PolygonArea()]] статического класса [[developers:references:topomatic.cad.foundation.cadlibrary|CadLibrary]].

В теле программного модуля объявите команду, и декорируйте её атрибутом «cmd». Команда «calculate_construction_contours_intersection» предложит пользователю выбрать тип площади и выведет экран рассчитанные значения.

<code csharp>
...
    [cmd("calculate_construction_contours_intersection")]
    private void CalculateConstructionContoursIntersection()
    {
        //Получаем модель текущей трассы. Если текущей является не трасса, то активируется последняя активная трасса
        Alignment alignment;
        using (var receiver = ActiveAlignmentReciver<Alignment>.CreateReciver(false))
        {
            alignment = receiver.Alignment;
            if (alignment == null)
            {
                MessageDlg.Show("Необходимо сделать трассу активной.", MessageBoxButtons.OK,
                    MessageBoxIcon.Information, MessageBoxDefaultButton.Button1);
                return;
            }

            var cadview = CadView;
            if (cadview == null) return;

            //Получаем контуры поверхности земли и проектной линии и указываем тип рассчёта
            var corridor = alignment.Corridor;

            var index = receiver.Manager.CurrentSection;
            var context = corridor[index];
            if (context == null) return;

            var eg = context.GetEgContour().AsVectorList();
            if (eg == null || eg.Count == 0)
            {
                MessageDlg.Show("Поверхность земли отсутствует.", MessageBoxButtons.OK, MessageBoxIcon.Information,
                    MessageBoxDefaultButton.Button1);
                return;
            }

            var red = context.GetRedLineContour().AsVectorList();
            if (red == null || red.Count == 0)
            {
                MessageDlg.Show("Проектная линия отсутствует.", MessageBoxButtons.OK, MessageBoxIcon.Information,
                    MessageBoxDefaultButton.Button1);
                return;
            }

            var userSelect = "Насыпи";
            if (!CadCursors.GetUserSelect(cadview, ref userSelect, null, "Рассчитать площадь: ", "Насыпи",
                "Выемки")) return;

            //Рассчитываем площадь пересечения
            var area = 0.0;
            if (userSelect.Equals("Насыпи", StringComparison.OrdinalIgnoreCase))
            {
                eg.Add(eg[eg.Count - 1] + new Vector2D(0.0, 100.0));
                eg.Add(eg[0] + new Vector2D(0.0, 100.0));

                red.Add(red[red.Count - 1] + new Vector2D(0.0, -100.0));
                red.Add(red[0] + new Vector2D(0.0, -100.0));
            }
            else
            {
                eg.Add(eg[eg.Count - 1] + new Vector2D(0.0, -100.0));
                eg.Add(eg[0] + new Vector2D(0.0, -100.0));

                red.Add(red[red.Count - 1] + new Vector2D(0.0, 100.0));
                red.Add(red[0] + new Vector2D(0.0, 100.0));
            }

            var intersections = new PolygonOperation().Intersection(eg, red);
            foreach (var intersection in intersections)
                area += CadLibrary.PolygonArea(intersection);

            MessageDlg.Show($"Площадь {userSelect.ToLower()}: {ValueConverter.AreaToStr(area)}");
        }
    }
...
</code>

{{ :developers:tutorial:alignmentedit:tutalgcalcvolumes.png?nolink |}}

Теперь необходимо сформировать наш файл .plugin. Заполните его следующим образом.

<code javascript>
{
  "assemblies": {
    "TutorialSelectCrossectionElements": {
      "assembly": "TutorialSelectCrossectionElements.dll, TutorialSelectCrossectionElements.ModulePluginHost"
    }
  },

  "actions": {
    "id_select_construction_nodes_by_code": {
      "cmd": "select_construction_nodes_by_code",
      "title": "Выделить точки конструкции поперечника по коду"
    },
    "id_get_construction_contours_by_code": {
      "cmd": "get_construction_contours_by_code",
      "title": "Рассчитать площадь контуров конструкции поперечника по коду"
    },
    "id_calculate_construction_contours_intersection": {
      "cmd": "calculate_construction_contours_intersection",
      "title": "Рассчитать площадь насыпи/выемки на поперечнике"
    }
  },

  "menubars": {
    "rbproj": {
      "items": [
        {
          "id": "tutorial_menu",
          "title": "Tutorial",
          "items": [
            "id_select_construction_nodes_by_code",
            "id_get_construction_contours_by_code",
            "id_calculate_construction_contours_intersection"
          ]
        }
      ]
    }
  }
}
</code>

Результатом запуска проекта будет появление в главном меню пункта «Tutorial», с подпунктами, которые будут работать в соответствии с описанными выше алгоритмами.

<note>[[developers:tutorial:tutorialcode|Исходный код]] примера расположен в проекте **"TutorialSelectCrossectionElements"**.</note>
Справка

Инструменты пользователя

Инструменты сайта

Инструменты страницы
