AnlaxRevitTools 2025.1.14

AnlaxRevitTools

Библиотека для разработки плагинов Autodesk Revit, предоставляющая набор полезных инструментов и утилит для упрощения разработки.

Описание

AnlaxRevitTools - это комплексная библиотека, которая помогает разработчикам создавать стабильные и функциональные плагины для Autodesk Revit. Библиотека включает в себя инструменты для логирования, асинхронного выполнения команд, управления параметрами и многое другое.

Основные компоненты

🔍 Логирование - AnlaxBaseLog

Центральный компонент для логирования в плагинах Revit. Прост в использовании и не требует дополнительной настройки.

// Примеры использования
AnlaxBaseLog.LogInfo("Информационное сообщение");
AnlaxBaseLog.LogWarning("Предупреждение");
AnlaxBaseLog.LogError("Ошибка");
AnlaxBaseLog.LogDebug("Отладочная информация");

⚡ Асинхронное выполнение - AsyncTask

Класс для безопасного запуска команд в Revit без блокировки интерфейса. Предотвращает вылеты Revit при использовании диалоговых окон.

// Пример использования
await AsyncTask.RunAsync(() => {
    // Ваш код для выполнения в Revit
    // Revit не будет зависать или вылетать
});

🪟 Окно результатов - ResultWindow

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

// Создание и отображение окна результатов
var operationData = new OperationResultData();
var resultWindow = new OperationResultWindow(operationData);
resultWindow.Show();

📦 Загрузка плагинов

GitHub Downloader

Класс для загрузки плагинов и обновлений через GitHub API.

Yandex Downloader

Альтернативный способ загрузки через Yandex сервисы.

🔧 Управление параметрами - RevitParameter

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

// Примеры использования
var parameter = new RevitParameter();
// Добавление параметра
parameter.AddParameter(document, element, parameterDefinition);
// Проверка существования параметра
bool exists = parameter.ParameterExists(element, parameterName);

Расширения (Extensions)

BoundingBoxXYZEx

Расширения для работы с ограничивающими блоками элементов.

DocumentEx

Расширения для работы с документами Revit.

ElementEx

Расширения для работы с элементами Revit.

Утилиты

ParameterTypeUniversal

Универсальные типы параметров для работы с различными версиями Revit.

UnitTypeUniversal

Универсальные типы единиц измерения.

WindowManager

Менеджер для управления окнами приложения.

BackgroundErrorReporter

Система отчетности об ошибках в фоновом режиме.

Установка

1. Скачайте последнюю версию библиотеки
2. Добавьте ссылку на AnlaxRevitTools в ваш проект
3. Убедитесь, что у вас установлена совместимая версия .NET Framework

Совместимость

Библиотека поддерживает следующие версии Autodesk Revit:

• Revit 2020
• Revit 2021
• Revit 2022
• Revit 2023
• Revit 2024
• Revit 2025

Примеры использования

using AnlaxRevitTools;

public class MyRevitPlugin
{
    public async Task ExecuteAsync()
    {
        try
        {
            AnlaxBaseLog.LogInfo("Начало выполнения плагина");
            
            await AsyncTask.RunAsync(() => {
                // Ваш код для Revit
                var parameter = new RevitParameter();
                // ... логика работы с параметрами
            });
            
            AnlaxBaseLog.LogInfo("Плагин выполнен успешно");
        }
        catch (Exception ex)
        {
            AnlaxBaseLog.LogError($"Ошибка: {ex.Message}");
        }
    }
}

Лицензия

Проект распространяется по лицензии Apache 2.0. Подробности см. в LICENSE.txt

Поддержка

Для получения поддержки или сообщения об ошибках, пожалуйста, создайте issue в репозитории проекта.

Вклад в проект

Мы приветствуем вклад в развитие проекта! Если у вас есть предложения по улучшению или исправлению ошибок, создайте pull request.

AnlaxRevitTools - упрощаем разработку плагинов для Autodesk Revit