bCAD^®

для Windows NT^™ и Windows95^®
версия 3.51
Интерфейс программирования приложений

на языке JAVA

версия 1.16

Справочное руководство

Ограничения ответственности

Этот документ и прилагающееся программное обеспечение подготовле­ны ПроПро Группой и могут быть изменены без предупреждения. Авто­ры не не­сут ответственности за последствия неправильного использова­ния про­грам­мы или документации.

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

 1991—99 ProPro Group. Все права защищены.
ProPro, ProPro Group, bCAD, Plug&Work являются зарегистрированными тор­говыми марками ПроПро Группы, bCAD LT, bCAD Vista, bREN яв­ля­ют­ся тор­говыми марками ПроПро Группы.
Microsoft, MS-DOS, Windows95 и Windows98 являются зарегистрирован­ными тор­говыми марками, а Windows, Windows NT — тор­говыми марками Microsoft Corporation.
Autodesk, AutoCAD являются Зарегистрирован­ными Тор­говыми Марками а DXF — торговой маркой Autodesk Corporation.
OpenGL — зарегистрированная торговая марка Silicon Graphics, Inc.
Sun, Sun Microsystems, Sun Microsystems Computer Corporation, Sun logo, Sun Microsystems Computer Corporation logo, Java, JavaSoft, JavaScript и HotJava — торговые марки и зарегистрированные торговые марки Sun Microsystems, Inc.
Примечание: Наименования упоминающихся ниже других продуктов ис­пользованы исключительно в целях идентификации и могут быть торго­выми марками, принадлежащими их владельцам. ПроПро Группа отказы­вается от каких-либо прав на них.

Оглавление

Основные положения

Структура API (интерфейс программирования)

Интерфейс программирования bCAD основан на двух общедоступных клас­сах bCAD.class и Tform.class. Все вызовы API, доступные разра­бот­чи­кам, описаны в bCAD.class.

Tform.class предназначен для хранения матричных данных и методов вы­полнения всех матричных операций, необходимых для определения коор­ди­нат и преобразований в трёхмерном пространстве.

Исходные файлы bCAD.java и Tform.java а также соответствующие им скомпилированные файлы .class предназначены для справки и создания приложений. Окончательная версия приложения может и не содержать эти файлы, так как bCAD.class и Tform.class являются встроенными компо­нентами исполняемого модуля bCAD.

В основе некоторых методов программирования bCAD лежит концепция полиморфизма. Это позволяет использовать несколько способов вызова команды c различными параметрами. Так например, команда поворот позволяет два способа поворота выбран­ных объектов: поворот вокруг координатной оси или вокруг указанной линии.

Структура приложений

Большая часть методов программирования bCAD использует контекстный параметр, позволяющие связать приложение с текущим окном редактора. Так простейший код приложения bCAD выглядит следующим образом:
public class MyProgram extends bCAD

{

public MyProgram(){};

/* конструктор должен быть public */
public void bcadmain( long ctxt ) /* точка входа */

{

/* тело приложения */

...

}

}

Системные вызовы

getVersion

long getVersion( )

Возвращает текущую версию интерфейса программирования (API) bCAD. Если версия оказалась некорректной, на экране появляется сообщение и работа приложения на этом прекращается. Рекомендуется встроить про­верку версии в своё приложение, чтобы избежать запуска Ваших при­ложений с ранними версиями bCAD API.

Например:

public class MyProgram extends bCAD

{

public MyProgram(){};

public long getVersion() { return classVersion; }
public void bcadmain( long ctxt ) /* точка входа */

{

/* тело приложения */

...

}

}

getbCADDir

String getbCADDir()

Возвращает строку, в которой указан путь на директорию, из которой был запущен bCAD.

getAppletDir

String getAppletDir()

Возвращает строку, в которой указан путь на директорию, из которой было запущено приложение (applet).

getArguments

String getArguments ()

Возвращает строку с параметрами приложения (Plug-in), если таковые бы­ли заданы. Строка параметров может содержать любое текстовое значение.

traceMessage

Имеет два полиморфных метода вызова:
traceMessage ( String str )

Печатает текстовую строку в раздел «Open bCAD» стандартного окна вы­вода.

Данный системный вызов рекомендуется только для отладочных целей, а не для вывода информации пользователю.

traceMessage ( String str int page )

Печатает тестовую строку на определенную страницу page стандартного ок­на вывода bCAD. Параметр page может иметь следующие значения:
pageTrace = 0

pageStatistics = 1

pageOpenbCAD = 2

Опция pageStatics используется при выводе информации для пользо­вателя.

getLinearUnit

double getLinearUnit ( long ctxt )

Возвращает значение единиц измерений, установленных в текущем окне редактирования. Например, если в качестве единиц измерения были уста­нов­лены миллиметры, возвращает значение 1, а если дюймы – воз­вра­ща­е­мое значение будет 25,4.

registerRootWindow

registerRootWindow ( int wnd )

Регистрирует основное окно приложения в иерархии окон bCAD. Это по­зво­ляет открывать окно приложения всегда поверх основного окна bCAD. При этом основное окно bCAD можно поднять наверх, используя стан­дарт­ную для Windows комбинацию ALT-TAB и выбрав bCAD в появив­шем­ся списке запущенных в данный момент приложений.

unregisterRootWindow

unregisterRootWindow ( int wnd )

Удаляет регистрацию основного окна приложения из иерархической структуры bCAD.

Вызовы registerRootWindow и unregisterRootWindow используются сов­местно. Настоятельно рекомендуем вставить следующий текст в код, им­плементирующий основное окно приложения.

boolean registered = false;

protected void onActivate(Event e)

{

super.onActivate(e);

if (!registered)

{

bCAD.registerRootWindow(getHandle());

registered = true;

}

}

protected void onClosing(CancelEvent e)

{

bCAD.unregisterRootWindow(getHandle());

}