воскресенье, 20 декабря 2015 г.

[Revit API] - Особенности работы с макросами.

Виктор Чекалин разместил ряд статей на adn-cis.org на тему работы с макросами:

Работа с макросами в Revit - Введение
Работа с макросами в Revit - Первый макрос
Работа с макросами в Revit - Выбор языка программирования
Работа с макросами - Изучение Revit API
Работа с макросами. Отладка
Работа с макросами Пошаговая отладка кода
Работа с макросами. Использование контрольных точек
Работа с макросами Комментирование кода
Работа с макросами. Исключения
Работа с макросами. Пример макроса
Работа с макросами. Дальнейшие действия и заключение

Чуть больше года назад я начинал свои первые программы с создания макросов, за время работы накопился некоторый опыт работы с ними.

Для начала опишу плюсы работы с макросами:

1. Прекрасно подходят для новичков. Не нужно заморачиваться с созданием проекта, писать файл манифеста, можно быстро написать короткий код.

2. Для проверки работы макроса не требуется каждый раз перезагружать Revit. Если единожды запустил плагин, созданный в Visual Studio, то Revit занимает файл сборки dll и её не удаётся перезаписать, пока не перезагрузишь Revit.
С макросами такой проблемы не существует. Собрал решение, запустил из диспетчера макросов.

3. Очень хорошо подходят для тестовых проработок. Если нужно быстро что-то проверить, посмотреть как работает пример кода.

4. Возможно сделать отладку макроса, не перезагружая каждый раз Revit. Как выполнить отладку макроса я уже писал ранее, повторюсь:
Для отладки в макросах служит кнопка "Войти в блок" в диспетчере макросов.Подробнее см. справку                                                                                                                    Команда "Войти в блок" в справке неверно переведена как "ШагВ", что сбило меня с толку.
5. Мне очень нравится, что SharpDevelop не подсвечивает ошибки в коде сразу же после набора. Ошибки подчёркиваются после компиляции решения. В Visual Studio меня очень раздражает, когда происходит подчёркивание незавершённого кода.

Теперь о том, почему я отказался от регулярной работы с макросами и перешёл на Visual Studio:

1. Макрос хранится в файле Revit со всеми вытекающими последствиями. Если будет сбой с вылетом из Revit, то не закрывайте SharpDevelop.

Варианты действий после аварийного завершения Revit:
- скопируйте куда-нибудь код из окна редактора
- сохраните файл с кодом

- найдите решение с макросом во временной папке пользователя. 
Вот как выглядит путь к папке с решением на моём компьютере:
%username%\AppData\Local\Temp\{6586EA70-C4F5-4461-8CEB-FD58406E0247}\Revit\DocHookups9148\890337088\test\Source

После открытия проекта Revit вставьте сохранённый код в редакторе макроса. 

2. Возможны проблемы при совместной работе. Могут занять рабочий набор с макросом (да, да, макрос тоже имеет свой рабочий набор!), не удастся выполнить синхронизацию. Был противоположный случай - я редактировал макрос, занял его рабочий набор, синхронизировался, закрыл файл и другие участники проекта не смогли синхронизироваться.

3. Распространение и запуск макроса для пользователей. Макрос живёт в проекте, а следовательно чтобы подгрузить его в другой проект, то нужно открыть файл с макросом, скопировать его текст в свой файл. Конечно можно сделать отдельный проект Revit с макросами, держать его открытым, макросы из него будут запускаться в другом проекте, но это о-о-о-чень напряжно для пользователей. Гораздо проще запускать плагины кнопкой с панели.

4. Обновление макроса. Допустим, я получил сообщение об ошибке в моём макросе. Мои действия: отладил, поправил. Теперь нужно обновить макрос в файле пользователя. Я не вижу другого пути, кроме как через копирование кода из окна редактора в моём файле и вставку кода в файле пользователя. А если проект не один? Может есть какой-то другой подход, не знаю, но мне проще обновить dll-ки на сервере, чем морочить голову пользователям макросами.

5. Разрастание кода. При тестовых проработках нужно внимательно следить за тем, чтобы маленький тест не разросся в полноценный проект. Появление нового класса или появление более пяти методов является для меня сигналом к переходу на Visual Studio.

6. InteliSense не подхватывает некоторые методы. Например, для объекта Element не отображается метод get_Parameter.

Не стоит совсем отказываться от работы с макросами. 
Это идеальный инструмент для начала работы с Revit API. Когда макрос перерастает в полноценный плагин, то я рекомендую переносить проект в Visual Studio.
Сейчас я применяю макросы в тестовых проработках и при изысканиях. Быстренько набрал небольшой код, проверил, отладил, скопировал методы в проект Visual Studio.
 
Удачи!
 
UPD:
Статья  Вадима Муратова: Revit: макросы и как их копировать://zen.yandex.ru/media/muratovbim/revit-makrosy-i-kak-ih-kopirovat-6020d15586f4e22208fd0c37Revit: макросы и как их копироватьhttps://zen.yandex.ru/media/muratovbim/revit-makrosy-i-kak-ih-kopirovat-6020d15586f4e22208fd0c37

пятница, 11 декабря 2015 г.

[Revit API] - Как получить линии из условного обозначения отверстия (продолжение)

Всё-таки нашёл решение с получением линий из семейства категории "Типовые аннотации". Как и обещал, пишу продолжение.

Google не помог, в руководстве пользователя тоже ничего не смог обнаружить.
На этот раз выручил сайт revitapisearch.com. Этот сайт - последний рубеж в моих изысканиях.
Если что-то совсем не выходит или нужно окончательно убедиться в том, что невозможно сделать через Revit API - захожу туда, нажимаю на кнопку "Members" и забиваю в поиске на страничке слова по смыслу.
Довольно-таки муторное занятие:


И далее F3, F3, F3 по всей простыне.
На 118-м найденном слове наткнулся на метод:


Ага, на этот раз охота оказалась удачной.

Строку из предыдущего сообщения

GeometryElement geometryElement = element.get_Geometry(geomOption);

заменяю на

FamilyInstance fi = (FamilyInstance)element;
GeometryElement geometryElement = fi.GetOriginalGeometry(geomOption);

Код скомпилировался и даже сработал, но в итоге я получил какую-то козявку в базовой точке проекта:


Видимо OriginalGeometry - это описание геометрии внутри семейства.

В объекте типа FamilyInstance есть метод GetTransform()
Смотрю что есть интересного в линии:

Добавляю строчку с трансформацией линии:

if (l != null)
{
    l = (Line)l.CreateTransformed(fi.GetTransform());
    lines.Add(l);
}

В итоге получаю список линий, с изменённым положением и отмасштабированных таким же образом, как и семейства аннотаций:
Удачи! 

четверг, 3 декабря 2015 г.

[Revit API] - Как получить линии из условного обозначения отверстия

На прошлой неделе Хасан Мамаев задал вопрос:
Я пытаюсь получить геометрию нескольких экземпляров одного плоского семейства таким кодом:
i.GetInstanceGeometry()
но выдаёт ошибку: AttributeError: 'FamilyInstance' object has no attribute 'GetInstanceGeometry'
Объекты, из которых нужно вытянуть линии - условное отображение отверстий:

Сегодня появилось время, пытаюсь разобраться.

Первым делом обращаюсь к документации.
Есть пример с извлечением геометрии из стены, но применить один в один не удалось.

После изысканий разработал такой код:

private List<Line> GetLines(Element element)
{

    List<Line> lines = new List<Line>();

    Autodesk.Revit.DB.Options geomOption = element.Document.Application.Create.NewGeometryOptions();

            if (null != geomOption)
            {
                geomOption.View = element.Document.ActiveView;               
            }

    GeometryElement geometryElement = element.get_Geometry(geomOption);

    foreach (GeometryInstance gi in geometryElement)
    {
        foreach (GeometryObject go in gi.GetInstanceGeometry())
        {
            Line l = go as Line;

            if (l != null)
            {
                lines.Add(l);
            }
        }
    }

    return lines;

}

Этот код заработал для элементов типа Элементы узлов
Для Типовых аннотаций не работает. Если найду решение, то сделаю продолжение.

Удачи!