Сообщество программистов Autodesk в СНГ :: Выбор категорий объектов, видимых на нескольких видах

Сообщество программистов Autodesk в СНГ
Revit API
Выбор категорий объектов, видимых на нескольких видах

07/04/2014

Выбор категорий объектов, видимых на нескольких видах

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

Это вторая часть реализации возможности редактирования помещения для упрощенного 2D BIM редактора.

В этой части мы рассмотрим пункты 4 и 5 моего плана:

Запустить команду RoomAppEditor для экспорта планов этажей
Отобразить список всех планов этажей на форме
Выбрать виды, которые нужно экспортировать и нажать ОК.
Отобразить категории на форме
Выбрать категории и нажать ОК.
Сохранить соответствующую графическую и другую информацию в облачной базе данных.
Отобразить модель на мобильном устройстве.
Отредактировать информацию, как графическую, так и нет.
Обновить модель в Revit в реальном времени.

Очевидно, что список категорий не должен включать в себя все категории, представленные в проекте. Нужно выбрать только те категории, объекты которых видимы на выбранных ранее видах.

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

Для каждого вида мы определим элементы отображаемы на нем элементы, которые нам интересны. Из этих элементов мы выберем различные категории. В данном случае, под выражением «Различные категории» мы понимаем категории, у которых различные идентификаторы, т.е. ElementId.

Создадим класс, сравнивающий категории, где будем считать, что категории равны, если равны их идентификаторы. В противном случае, категории различны. Этот класс будем передавать в типизированный словарь, который мы используем для хранения категорий. Без сравнения категорий мы получим большое количество одинаковых категорий в итоге.

В словаре сами категории используются в качестве ключа. Это позволяет нам с лёгкостью использовать этот словарь в качестве объектов для выбора на форме для 5ого шага.

В итоге я создал один вспомогательный класс и два основных класса для реализации этих шагов и обновил соответствующие команды:

CategoryEqualityComparer – Реализует сравнение категорий по их идентификатору.
CategoryCollector – Выбирает категории из элементов, отображаемых на заданных видах.
FrmSelectCategories – Форма для интерактивного выбора категорий пользователем
CmdUploadViews – Выбор видов и категорий.

CategoryEqualityComparer

Этот класс реализует интерфейс IEqualityComparer, который содержит два метода: Equals и GetHashCode.

Реализация основывается на сравнении идентификаторов категорий.

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

    /// <summary>
    /// Категории с одинаковыми ИД являются одинаковыми.
    /// Без этого сравнения получим кучу дубикатов   
    /// </summary>
    class CategoryEqualityComparer
      : IEqualityComparer<Category>
    {
      public bool Equals( Category x, Category y )
      {
        return x.Id.IntegerValue.Equals(
          y.Id.IntegerValue );
      }
 
      public int GetHashCode( Category obj )
      {
        return obj.Id.IntegerValue.GetHashCode();
      }
    }

CategoryCollector

Класс CategoryCollector собирает различные категории из всех элементов, отображаемых на заданных видах.

Нам интересны только те элементы, который мы желаем видеть в моем облачном BIM редакторе и просмотрщике.

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

Ранее мы уже несколько раз обсуждали как выбрать все элементы из модели, или видимые 3-D элементы в проекте несколькими разными спообами:

Последние 3 способа особенно эффективны.

В этом же случае, я выбрал комбинацию двух из способов, используя FilteredElementCollector передав ему идентификатор вида, а также дополнительно проверяю свойство Category.HasMaterialQuantities.

Класс также реализует пару дополнительных переменных, содержащих количество видов, общее количество элементов и количество элементов со свойством Category.HasMaterialQuantities. Эти переменные используются для отчета.

Все действия происходят в конструкторе класса:

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

  /// <summary>
  /// Выбирает все категории всех видимых элементов
  /// на заданном наборе видов
  /// </summary>
  class CategoryCollector : Dictionary<Category, int>
  {
    /// <summary>
    /// Количество видов
    /// </summary>
    int _nViews;
 
    /// <summary>
    /// Общее количество элементов на выбранных видах
    /// включая дублирующиеся элементы.
    /// </summary>
    int _nElements;
 
    /// <summary>
    /// Количество элементов, категория которых
    /// имеест свойство HasMaterialQuantities на всех видах
    /// включая дублирующиеся элементы.
    /// </summary>
    int _nElementsWithCategorMaterialQuantities;
 
    public CategoryCollector( IList<ViewPlan> views )
      : base( new CategoryEqualityComparer() )
    {
      _nViews = views.Count;
      _nElements = 0;
      _nElementsWithCategorMaterialQuantities = 0;
 
      if( 0 < _nViews )
      {
        Document doc = views[0].Document;
 
        FilteredElementCollector a;
       
        foreach( View v in views )
        {
          a = new FilteredElementCollector( doc, v.Id )
            .WhereElementIsViewIndependent();
 
          foreach( Element e in a )
          {
            ++_nElements;
 
            Category cat = e.Category;
 
            if( null != cat
              && cat.HasMaterialQuantities )
            {
              ++_nElementsWithCategorMaterialQuantities;
 
              if( !ContainsKey( cat ) )
              {
                Add( cat, 0 );
              }
              ++this[cat];
            }
          }
        }
      }
      Debug.Print( "Выбрано {0} категорий из "
        + "{1} видов с {2} элементами, "
        + "{3} элементов с HasMaterialQuantities=true",
        Count,
        _nViews,
        _nElements,
        _nElementsWithCategorMaterialQuantities );
    }
  }

Я выполнил этот код на очень простой модели, содержащей всего три вида: Уровень 1, Уровень 2 и Площадка. В результате осталось всего 5 категорий для выбора.

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

14 категорий – все элементы, выбранные на заданном наборе видов
13 категорий – категории, которые не зависят от вида
12 категорий – элементы, которые имеют границы
5 категорий - элементы, у которых свойство HasMaterialQuantities = true;

FrmSelectCategories

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

Выбор категорий аналогичен тому, как мы выбирали виды на форме FrmSelectViews в прошлой статье, за исключением того, что мы заранее передаем в конструктор список категорий, которые мы получили с помощью CategoryCollector.

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

  public partial class FrmSelectCategories : Form
  {
    IList<Category> _categories;
 
    /// <summary>
    /// Инициализируем класс, передав
    /// список категорий для выбора
    /// </summary>
    /// <param name="categories"></param>
    public FrmSelectCategories(
      IList<Category> categories )
    {
      InitializeComponent();
 
      _categories = categories;
    }
 
    /// <summary>
    /// При загрузке формы
    /// выделяем по умолчанию все категории   
    /// </summary>
    private void FrmSelectCategories_Load(
      object sender,
      EventArgs e )
    {
      checkedListBox1.DataSource = _categories;
      checkedListBox1.DisplayMember = "Name";
 
      // Set all entries to be initially checked.
 
      int n = checkedListBox1.Items.Count;
 
      for( int i = 0; i < n; ++i )
      {
        checkedListBox1.SetItemChecked( i, true );
      }
    }
 
    /// <summary>
    /// Получаем доступ к выбранным категориям   
    /// </summary>
    public List<Category> GetSelectedCategories()
    {
      return checkedListBox1.CheckedItems
        .Cast<Category>().ToList<Category>();
    }
  }

CmdUploadViews

Категории, полученные с помощью CategoryCollector были отсортированы по алфавиту, перед тем как добавить их на форму со списком для выбора пользователем.

Также, как и первая форма выбора видов, форме выбора категорий мы также зададим приложение Revit в качестве родительской формы.

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

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

  [Transaction( TransactionMode.ReadOnly )]
  public class CmdUploadViews : IExternalCommand
  {
    public Result Execute(
      ExternalCommandData commandData,
      ref string message,
      ElementSet elements )
    {
      IWin32Window revit_window
        = new JtWindowHandle(
          ComponentManager.ApplicationWindow );
 
      UIApplication uiapp = commandData.Application;
      UIDocument uidoc = uiapp.ActiveUIDocument;
      Application app = uiapp.Application;
      Document doc = uidoc.Document;
 
      if( null == doc )
      {
        Util.ErrorMsg( "ВЫполните команду"
          + " при открытом проекте." );
        return Result.Failed;
      }
 
      FrmSelectViews form = new FrmSelectViews( doc );
 
      if( DialogResult.OK == form.ShowDialog(
        revit_window ) )
      {
        List<ViewPlan> views = form.GetSelectedViews();
 
        int n = views.Count;
 
        string caption = string.Format(
          "{0} Планов этажей выбрано",
          n);
 
        string list = string.Join( ", ",
          views.Select<Element, string>(
            e => e.Name ) );
 
        Util.InfoMsg2( caption, list );
 
        List<Category> categories
          = new List<Category>(
            new CategoryCollector( views ).Keys );
 
        // Sort categories alphabetically by name
        // to display them in selection form.
 
        categories.Sort(
          delegate( Category c1, Category c2 )
          {
            return string.Compare( c1.Name, c2.Name );
          } );
 
        FrmSelectCategories form2
          = new FrmSelectCategories( categories );
 
        if( DialogResult.OK == form2.ShowDialog(
          revit_window ) )
        {
          categories = form2.GetSelectedCategories();
 
          n = categories.Count;
 
          caption = string.Format(
            "{0} Категорий выбрано",
            n);
 
          list = string.Join( ", ",
            categories.Select<Category, string>(
              e => e.Name ) );
 
          Util.InfoMsg2( caption, list );
        }
      }
      return Result.Succeeded;
    }
  }