CAD-страница НП | Статьи | English | Download

Часто используемой функцией геометрических вычислений является intersectWith - пересечение примитивов. Метод с таким названием присутствует как у AcGe-объектов, так и у примитивов, порожденных классом AcDbEntity.
Пример расчета точек пересечения выбираемых примитивов приведен в листинге 5.15.

Листинг 5.15. Пересечение примитивов
// Н.Н.Полещук, Глава 5\Book09\acrxEntryPoint.cpp
// В книге "AutoCAD: разработка приложений, настройка и адаптация"
// (издательство "БХВ-Петербург", 2006)
// http://poleshchuk.spb.ru/cad/2006/Razr2006.htm
//
// ----- ads_book09 symbol (do not rename)
static int ads_book09(void)
{
int es1, es2;
ads_name ent1, ent2;
ads_point pt1, pt2;
AcDbObjectId entId1, entId2;
AcDbEntity* pEnt1 = NULL;
AcDbEntity* pEnt2 = NULL;
AcGePoint3dArray points;
 
// Выбор первого объекта по запросу
es1 = acedEntSel("\nУкажите объект 1: ", ent1, pt1);
if (es1 != RTNORM)
{
acutPrintf("\nОбъект не выбран.");
return (RSRSLT);
}
 
// Вычисление ID для перехода от ads_name к AcDbObjectId
es1 = acdbGetObjectId(entId1, ent1);
if (es1 != Acad::eOk)
{
acutPrintf("\nНе получен 1 ");
return (RSRSLT);
}
// Вычисление указателя на AcDbEntity
es1 = acdbOpenAcDbEntity(pEnt1, entId1, AcDb::kForRead);
if (es1 != Acad::eOk)
{
acutPrintf("\nНе открыт объект 1 ");
return (RSRSLT);
}
// Подсветка первого объекта
pEnt1->highlight();
 
// Выбор второго объекта по запросу
label_select2:
es2 = acedEntSel("\nУкажите объект 2: ", ent2, pt2);
if (es2 != RTNORM)
{
pEnt1->unhighlight(); // сброс подсветки
pEnt1->close();// закроем объект 1
acutPrintf("\nОбъект не выбран. ");
return (RSRSLT);
}
// Вычисление ID для перехода от ads_name к AcDbObjectId
es2 = acdbGetObjectId(entId2, ent2);
if (es2 != Acad::eOk)
{
pEnt1->unhighlight();
pEnt1->close(); // закроем объект 1
acutPrintf("\nНе получен Id 2 ");
return (RSRSLT);
}
// Проверка совпадения объектов
if(entId2 == entId1)
{
acutPrintf(" Повторите выбор: ");
goto label_select2;
}
 
// Вычисление указателя на AcDbEntity
es2 = acdbOpenAcDbEntity(pEnt2, entId2, AcDb::kForRead);
if (es2 != Acad::eOk)
{
pEnt1->unhighlight();
pEnt1->close(); // закроем объект 1
acutPrintf("\nНе открыт объект 2 ");
return (RSRSLT);
}
 
// Подсветка второго объекта
pEnt2->highlight();
 
// Распечатка выбранных объектов
acutPrintf("\n");// переход на новую строку
pEnt1->list();
acutPrintf("\n");
pEnt2->list();
 
// Вычисление точек пересечения для объектов
es1 = pEnt2->intersectWith(pEnt1, AcDb::kOnBothOperands, points);
int len;
if ( (es1 != Acad::eOk) || ((len = points.length() ) == 0) )
acutPrintf("\nОбъекты не пересекаются.");
else
{
acutPrintf("\nТочки пересечения:");
for (int i=0; i<len; ++i)
{
acutPrintf("\n%d: %.6f %.6f %.6f",
i+1, points[i].x, points[i].y, points[i].z);
}
}
 
// Сброс подсветки
pEnt1->unhighlight();
pEnt2->unhighlight();
 
// Закрытие объектов с освобождением памяти
pEnt1->close();
pEnt2->close();
 
// TODO: Replace the following line by your returned value if any
acedRetVoid () ;
return (RSRSLT) ;
}

Пояснения к тексту программы. Для выбора объекта в интерактивном режиме используется функция acedEntSel, которая описана в файле acedads.h следующим образом:

Первый параметр - это текст подсказки, выводимой на экран, а через второй и третий по ссылке возвращается результат выбора (имя примитива и точка, в которой он был указан). В отличие от аналогичной LISP-функции entsel возвращается целочисленный код, а не список. Нормальным возвращаемым значением является RTNORM.
Имя первого из указываемых примитивов сохраняется в переменной ent1, которая имеет тип ads_name  - это один из типов данных, в котором представляется примитив в системе программирования ObjectARX. Для преобразования данных примитива из одного представления в другое используются соответствующие функции.
Для дальнейшей работы с первым указанным на экране объектом необходимо получить его идентификатор в базе рисунка, или ID (Object ID). Идентификаторы, как и имена примитивов (ads_name), не являются постоянными и в каждом новом сеансе редактирования рисунка имеют свои значения.
Имя примитива ent1 преобразуется в идентификатор entId1 с помощью функции acdbGetObjectId, описанной в файле dbmain.h так:

Acad::ErrorStatus acdbGetObjectId (AcDbObjectId& objId, const ads_name objName);

Через первый аргумент по ссылке передается вычисленный ID примитива.
Далее по entId1 с помощью функции acdbOpenAcDbEntity можно по ссылке получить значение указателя на примитив, как объект класса AcDbEntity, и, соответственно, доступ к свойствам и методам примитива. Эта функция описана в заголовочном файле dbmain.h следующим образом:

Acad::ErrorStatus acdbOpenAcDbEntity (AcDbEntity*& pEnt, AcDbObjectId id, AcDb::OpenMode mode, bool openErasedEntity = false);

Первый параметр функции acdbOpenAcDbEntity - это вычисляемый указатель, второй - ID объекта, третий - режим доступа (чтение, запись и т. п.), а четвертый - признак доступа к удаленным примитивам (по умолчанию удаленные примитивы недоступны). Таким образом мы для первого указанного на экране объекта получили указатель pEnt1, который указывает уже на объект типа AcDbEntity.
С помощью указателя pEnt1 можно вызвать метод подсветки выбранного примитива. Для этого используется функция highlight.
Все, что мы перечислили выше для первого примитива, применяется затем в программе ко второму объекту. Вычисляется ID второго объекта (entId2), а затем - указатель pEnt2 и объект тоже подсвечивается (хотя это не заметно, поскольку программа выполняется быстро, а в конце ее работы подсветка сбрасывается).
В процессе вычислений проверяется, не указан ли один и тот же объект два раза (тогда entId2 == entId1), и если да, то управление передается снова на метку label_select2, которой помечена операция выбора второго примитива.
Далее подробные сведения об обоих указанных примитивах с помощью функции list выводятся на экран точно так же, как это делает команда LIST (СПИСОК).
После этого переходим к непосредственному вычислению точек пересечения, для чего необходимо применить метод (функцию) intersectWith, о котором речь шла выше. Функция является виртуальной в классе AcDbEntity и описана в файле dbmain.h так:

virtual═ Acad::ErrorStatus intersectWith (const AcDbEntity* pEnt, AcDb::Intersect intType, AcGePoint3dArray& points, int thisGsMarker = 0, int otherGsMarker = 0) const;

В рассматриваемом варианте (а есть и перегруженный вариант, с другими аргументами) функция в качестве первого аргумента принимает указатель на вспомогательный объект типа AcDbEntity, в качестве второго ≈ признак продления одного или обоих примитивов при расчете пересечения, а в качестве третьего - ссылку на массив из трехмерных точек типа AcGePoint3d. Четвертый и пятый параметры нами в явном виде не используются (они принимают значения по умолчанию).
В нашем примере основным является первый из указанных на экране объектов, а pEnt2 - это указатель на вспомогательный примитив, который необходимо передать функции. Признак продления intType может принимать следующие значения: