Настройки экземпляра

Ниже мы рассмотрим параметры, которые необходимо передать функции c3dviewer.createC3DViewer(..).

Основные параметры экземпляра (TypeScript):

 export type ViewerSettings = {
      c3dService:{
          host:string,
          port:string,
          path?:string
      },
      resources?:{
          fonts?:string[]
      },
      defines?: ViewerDefines
      logger?: Logger
 }

Обязательным является только один параметр. Это c3dService, который настраивает соединение со службой C3D. В него входят:

• host: имя хоста сервиса C3D;

• port: порт сервиса C3D;

• path: URL-адрес RPC-соединения с сервисом C3D. Значение по умолчанию — /wrpc.

Параметр resources содержит дополнительные ресурсы, которые могут быть доступны в сцене. В данный момент доступны только шрифты. Это список строк, содержащих URL-адреса шрифтов. Кроме того, эти шрифты могут использоваться семействами шрифтов в параметрах команд или процессов для отображения текста.

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

Последняя настройка — это режим «логгирования», который используется только для отладки. В общем случае, вы можете просто задать объект console веб-страницы в качестве этого параметра, чтобы просмотреть все сообщения. Также его можно использовать в расширенном режиме, поскольку этот параметр принимает любой объект, имеющий функции соответствующего уровня логирования (например, log(..), warn(..), debug(..) и т. д.).

Добавлено в версии 1.6.0: Добавлено ViewerSettings.defines.

Параметры отображения

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

Базовые параметры вьюера (TypeScript):

export type ViewerDefines = {
    comment?: {
        text?: string
    }
    click?: {
        delay?: number
        tolerance?: number
    }
    hint?: {
        delay?: number
        tolerance?: number
    }
    snap?: {
        delay?: number,
        tolerance?: number,
    },
}

Свойство comment.text указывает значение метки по умолчанию для комментария.

Группы click, hint и snap имеют один и тот же тип, но различное назначение. Каждая из них определяет:

• delay: время в миллисекундах до активации;

• tolerance: допустимое отклонение положения курсора мыши в пикселях.

Группа переменных click предназначена для интерпретации двойного щелчка мыши. Она используется в процессе по умолчанию для обратных вызовов onEdit и onEditText. Параметр delay определяет задержку между одиночными щелчками, чтобы отличать их от двойных, а параметр tolerance — допустимое отклонение курсора в ожидании второго щелчка.

Группа hint используется для всплывающих подсказок в процессе по умолчанию для функции обратного вызова onHint. Параметр delay определяет задержку, необходимую для интерпретации остановки движения мыши как запроса подсказки, а параметр tolerance — допустимое отклонение курсора во время ожидания истечения тайм-аута.

Группа snap используется для привязки к граничным точкам геометрии в процессах установка точки, добавление углового измерения и добавление линейного измерения. Параметр delay определяет задержку перед активацией механизма привязки курсора, а параметр tolerance — допустимое отклонение курсора во время ожидания истечения тайм-аута.

Все заданные константы имеют значения по умолчанию, указанные в следующей таблице.

Значения по умолчанию:

Группа	Свойство	Значение по умолчанию
comment	text	"text"
click	delay	300
	tolerance	5
hint	delay	1000
	tolerance	5
snap	delay	500
	tolerance	5