Сообщество программистов Autodesk в СНГ :: Использование метода NewTakeOffFitting для создания врезки

Сообщество программистов Autodesk в СНГ
Revit API
Использование метода NewTakeOffFitting для создания врезки

24/04/2014

Использование метода NewTakeOffFitting для создания врезки

Вопрос: В середине одного из воздуховодов моей MEP модели я хочу сделать врезку. В API для этого есть метод NewTakeOffFitting, который принимает 2 аргумента: коннектор и MEP-кривую (трубу, воздуховод, кабельные лотки) и возвращает созданный экземпляр семейства. Вопрос состоит в том, что я не пойму, как создать эту кривую и коннектор. Можете привести пример кода по созданию врезки с использованием этого метода? Спасибо

Ответ: Для начала я бы посоветовал просмотреть примеры AutoRoute и AvoidObstruction из примеров Revit SDK, в которых показано, как программно создавать трубы, воздуховоды и фитинги к ним.

Я так же просмотрел пример создания и позиционирования фитингов кабельных лотков.

Однако ни в одном из этих примеров нет явного использования метода NewTakeOffFitting.

Метод NewTakeOffFitting используется для вставки нового экземпляра семейства, представляющего фитинг врезки, с помощью одного коннектора и одной MEP-кривой.

MEP-кривая представляет собой трубу или воздуховод. Коннектор принадлежит другому элементу, который мы хотим присоединить.

Я создал небольшой пример CreateTakeoff для демонстрации использования этого метода. На самом деле, при создании я столкнулся с некоторыми проблемами. Основные из них это какой элемент воздуховода использовать и как их позиционировать.

Ниже представлен полный код команды для создания врезки:

Код - C#: [Выделить]

        public Result Execute(ExternalCommandData commandData,
              ref string message,
              ElementSet elements)
        {
            Result result = Result.Failed;
 
            UIApplication uiapp = commandData.Application;
            Document doc = uiapp.ActiveUIDocument.Document;
 
            Transaction t = null;
 
            Autodesk.Revit.Creation.Document creDoc
              = doc.Create;
 
            try
            {
                // determine duct type to use:
 
                FilteredElementCollector collector
                  = new FilteredElementCollector(doc);
 
                collector.OfCategory(
                  BuiltInCategory.OST_DuctCurves);
 
                collector.OfClass(typeof(
                  ElementType));
 
                DuctType ductType
                  = collector.FirstElement() as DuctType;
 
                if (null == ductType)
                {
                    message = ("Не найден тип воздуховода");
                    return Result.Failed;
                }
                else
                {
                    t = new Transaction(doc, "Создание врезки");
 
                    t.Start();
 
                    // Создадим воздуховод1 вдоль оси Х
                    // c (0,0,0) до (6,0,0):
 
                    XYZ start = XYZ.Zero;
                    XYZ end = start + 6 * XYZ.BasisX;
                    XYZ mid = 0.5 * (start + end);
 
                    Duct duct1 = creDoc.NewDuct(
                      start, end, ductType);
 
                    // создадим воздуховод2 параллельно оси Y
                    // с (1,2,0) по (1,4,0):
 
                    start = mid + 2 * XYZ.BasisY;
                    end = start - 2 * XYZ.BasisY;
 
                    Duct duct2 = creDoc.NewDuct(
                      start, end, ductType);
 
                    // выберем ближайщий к первому воздуховоду коннектор
                    // на втором воздуховоде.
 
                    Connector duct2_start = null;
 
                    // Просто взять первый попавшийся не получится
                    // так как порядок может измениться.
                    // нужно всегда учитывать месторасположение коннектора
 
                    double dist = double.MaxValue;
 
                    foreach (Connector c in
                      duct2.ConnectorManager.Connectors)
                    {
                        XYZ p = c.Origin;
                        double d = p.DistanceTo(mid);
 
                        if (d < dist)
                        {
                            dist = d;
                            duct2_start = c;
                        }
                        break;
                    }
 
                    // создадим врезку
 
                    FamilyInstance takeoff
                      = creDoc.NewTakeoffFitting(
                        duct2_start, duct1);
 
                    t.Commit();
 
                    result = Result.Succeeded;
                }
            }
            catch (Exception ex)
            {
                if (null != t)
                {
                    t.RollBack();
                }
                message = ex.Message;
            }
            return result;
        }
    }

Важно запомнить, что вы не можете полагаться на порядок коннекторов, который возвращает вам ConnectorManager, так как этот порядок может меняться. Поэтому мы не можем просто взять скажем первый попавшийся коннектор. Нужно учитывать другие критерии при поиски коннектора, например, месторасположение. В своем коде я определяю расстояние коннекторов второго воздуховода до центра первого и беру ближайший.

С другой стороны, можно попробовать расположить воздуховод таким образом, что его коннектор будет располагаться практически на середине и в этом случае можно использовать метод XYZ.IsAlmostEqualTo.

Вот результат выполнения команды: