Site3dWidget Class
Класс виджета Site3d
Constructor
Site3dWidget
-
containerId -
name -
path -
options
Parameters:
-
containerIdStringИдентификатор корневого элемента виджета
-
nameStringИмя базовой модели виджета
-
pathStringПуть до базовой модели виджета
-
optionsSite3dWidgetOptionsПараметры виджета
Item Index
Methods
- initShow
- initHide
- loadShow
- loadHide
- loadSetStatus
- setRender
- updateIsRender
- renderOn
- renderOff
- navButtonUpdate
- navPanelsShow
- navPanelsHide
- navPanelsToggle
- navSkyboxChange
- fullOn
- fullOff
- updateFullButton
- fullToggle
- fullScreenExit
- helpWindowShow
- helpWindowHide
- helpWindowToggle
- rotateOn
- rotateOff
- rotateStop
- rotateToggle
- updateRotateButton
- lightToggle
- updateLightButton
- isCanAnim
- getAnimOptions
- getAnimNumber
- animOn
- animOff
- animToggle
- animScroll
- animByEventOn
- animByEventOff
- animStop
- animReset
- animManualOn
- animManualOff
- animManualToggle
- animShowMark
- animRemoveMarks
- animClearMarksTimer
- skyboxShow
- skyboxHide
- skyboxToggle
- updateSkyboxButton
- sizeOn
- sizeOff
- sizeToggle
- updateSizeButton
- labelOn
- labelOff
- labelToggle
- updateLabelButton
- painterOn
- painterOff
- painterToggle
- updatePainterButton
- vrOn
- vrOff
- vrToggle
- updateVrButton
- arOn
- arOff
- arToggle
- updateArButton
- saveFile
- saveTextureFromObjectURL
- saveSettingTexture
- getLink
- getShareImageAsHTML
- getShareDataAsHTML
- getShareDataAsPdf
- share
- link
- download
- exportImage
- exportVideo
- appendNav
- loadStyleString
- loadStyleFile
- loadStyle
- showNav
- hideNav
- showLogo
- hideLogo
- showModel
- hideModel
- updateTheme
- updateAppearance
- updateFontFamily
- updateBorderRadius
- updateBackgroundColor
- updatePreloadBackgroundColor
- updatePreloadBackgroundImage
- updatePreloadPoster
- updatePreloadButton
- updateScaleFading
- updateRotateFading
- updatePosCorrection
- updateSizeCorrection
- updateRotateCorrection
- updateMoveControl
- updateScaleControl
- updateRotateControl
- updateSizeControl
- updateAmbientLight
- updateDirectionalLight
- updateDirectionalLights
- restoreMaterialParams
- updateGraphics
- updatePainter
- updateModelPainter
- updateModelClicks
- updateLod
- updateFloor
- updateSkyboxModel
- updateSkybox
- updateLabels
- updateConfigurator
- updateConfiguratorInLabels
- updateScreenSizeCorrection
- updateLinks
- updateModelLinks
- updateAr
- updateNavButtons
- updateAnimControl
- updateModelAnimControl
- updateAnimButton
- updateNavLink
- updateNavHelp
- updateNavPanel
- selectNavPanel
- enableNavPanel
- disableNavPanel
- updateNavPanels
- updateNavStart
- updateLogo
- updateWatermark
- updateStartRotate
- stopStartRotate
- updateStartHelp
- stopStartHelp
- updateAutoRotate
- updateTargetControl
- updateCamera
- updateSizeInfo
- updateLink
- updateNavShare
- moveToInitView
- moveToLabel
- moveToModelPart
- setStyles
- event
- removeEvent
- load
- saveConfiguratorStat
- getConfiguratorInfo
- clear
- widget static
- widgetAsync static
Properties
- {string|(() => void)} url - Шаблон URL с `[path]` или функция «Скачать».
- value - Код (value) выбранной настройки.
- {string} [animVariant] - Вариант анимации при показе.
- {Site3dWidgetLabelMoveCameraOptions} [moveCamera] - Сценарий камеры по клику.
- {Object} [styles] - Стили блока меток.
- value - Индекс трека анимации на модели.
- {HTMLElement} [elem] - Созданный DOM узел метки.
- {number} [speed] - Скорость воспроизведения.
- {boolean} [commonSettings] - Если true — в getAnimOptions к базовому animControl подставляется только number варианта.
- {boolean} [showPanel] - Показывать панель управления анимацией.
- {number} [angleY] - Угол направления света по Y (градусы).
- {number} [opacity] - Непрозрачность слоя кисти (0…1).
- {Site3dWidgetPainterBrushOptions} brush - Параметры активной кисти.
- {Site3dWidgetPainterBrushOptions} [brush] - Слить параметры кисти.
- [isUpdateModel] - По умолчанию не `false` — вызывается `updateModelClicks`.
- {CSSStyleDeclaration} style - Стили элемента; {@link Site3dWidget#getLink} читает поле `navLink` на объекте стилей.
- [autoHide] - Автоскрытие панели навигации.
- [url] - URL ссылки «поделиться» по умолчанию.
- {boolean} [autoStart] - Показывать при старте.
- {boolean} [showPanels] - Показать панели.
- [screenshots] - Доп. скриншоты в окне шеринга.
- {'start'|'hover'|string} [enabledTime] - Когда показывать.
- {number} [opacity] - Интенсивность (как в UI, 0…100).
- {string} [caption] - Подпись.
- {string} [axes] - Оси (`xy`, …).
- {number|undefined} [max] - Абсолютный максимум.
- {number} [maxY] - Максимум по Y.
- {number} [speed] - Скорость авто-вращения.
- {boolean} [recalc] - Пересчёт при смене масштаба.
- {'around'|'flick'|string} [type] - Тип / режим.
- [isEnabled] - Включить опцию.
- {*} [pos] - Служебное поле позиции (сбрасывается).
- {number} [threshold] - Порог яркости bloom.
- {number} [maxDistance] - SSAO: макс. дистанция (1…20).
- {number} [opacity] - Прозрачность / сила эффекта.
- {number} [b] - Синий канал (слайдер 0…10).
- {number} [quality] - Качество рендера (0…100).
- {number} [emissive] - Эмиссия PBR.
- {Site3dWidgetGraphicsPhysicalProperties} [physicalProperties] - Подблок PBR общего материала.
- {number} [thickness] - Толщина линии / рёбер.
- [isEnabled] - Включить опцию.
- {number} [minSquare] - Мин. площадь экрана для коррекции.
- [fill] - Заливка окружения (`grey`, …).
- {boolean} [autoCorrection] - Автокоррекция графики.
- {Object<string, string>} [window] - Окно заказа.
- {string} [part] - Имя части модели для ссылки.
- {Object<string, Object<string, string>>} [styles] - В т.ч. `hint` → карта CSS.
- {string} [error] - Текст ошибки AR.
- {string} [path] - Путь к модели LOD.
- {Site3dWidgetLodLevelOptions[]} [items] - Уровни LOD.
- [caption] - Текст на кнопке формы.
- {Site3dWidgetConfiguratorOrderButtonOptions} [button] - Кнопка отправки формы.
- {{ toEmail?: string }} [admin] - Настройки администратора заказа.
- {string} [currency] - Символ валюты.
- {number} [step] - Шаг слайдера оси.
- {string} [unit] - Единица размеров изделия.
- {boolean} [hideAfterSelect] - Скрывать панель после выбора.
- {string} [viewUrl] - База URL просмотра сохранённой сцены.
- {Site3dWidgetConfiguratorServiceOptions} [configuratorService] - Сервис ссылок/языка для {@link Site3dWidget#getLink}.
- {boolean} [loaded] - Флаг «загрузка завершена» для колбэка статуса.
- {boolean} [notUpdateRenderIsActive] - Не менять `isActive` у текущего рендера.
- {(info: { percent: number }) => void} [onProgress] - Колбэк прогресса POST.
- [texture] - URL, blob: или путь после сохранения на сервер.
- {boolean} [isOrder] - Пометить запрос как заказ.
- [cameraOptions] - То же, что в `options.camera` / снимке сцены.
- [start] - Вызов при старте сцены (учитывается только если коррекция включена).
- {boolean} [isAdditional] - Обновлять `directionalLightAdditional`.
- [isUpdateModel] - После смены данных вызвать `updateModelClicks` и т.п.
- {string} [scaleMax] - Макс. дистанция зума для части модели.
- {string[]} [styles] - Дополнительные CSS-классы.
- {number} z - Смещение по Z в % от размера модели.
- {string[]} [exceptions] - Имена частей модели, которые скрыть на кадр.
- {boolean} [isWatermark] - Наложить водяной знак на запись.
- {Object} initBrush - Исходные параметры материала для отката.
- } userData - userData three.js; в `painter` — состояние кисти.
- delta - `[dx, dy]` в пикселях (как `mousePosDelta` в Site3d).
- info - Данные смещения drag (второй аргумент {@link Site3d#callEvent}).
- delta - Относительное изменение масштаба (знак и величина — как в Site3d).
- info - Данные жеста масштаба (второй аргумент {@link Site3d#callEvent}).
- {string} color - Цвет заливки пола (RGBA/HEX).
- [needRebuild] - Принудительно пересоздать геометрию пола.
- {string} color - Цвет заливки skydome без текстуры.
- [checkOther] - Если не `false`, переключить соседние панели из `_navButtonsCollection`.
- container
- name
- guid
- path
- options
- s3d
- model
- isModelErrorLoad
- configurator
- isFull
- isRotate
- isAnim
- isVR
- isAR
- isLod
- isConfiguratorData
- isConfigurator
- isLoad
- isLight
Methods
initShow
()
Метод показывает дополнительный слой начальной загрузки
initHide
()
Метод скрывает дополнительный слой начальной загрузки
loadShow
-
info
Метод показывает загрузку
Parameters:
-
infoSite3dWidgetLoadStatusInfo=Объект статуса
loadHide
()
Метод скрывает загрузку
loadSetStatus
-
info
Метод устанавливает статус загрузки
Parameters:
-
infoSite3dWidgetLoadStatusInfoОбъект статуса
setRender
-
renderType
Метод устанавливает тип рендера
Parameters:
-
renderType'actions' | 'full'Тип рендера
updateIsRender
-
value -
options
Метод обновляет включение или отключение рисования сцены виджета
Parameters:
-
valueBoolean=Истина, если нужно включить рисование сцены виджета
-
optionsSite3dWidgetUpdateIsRenderOptions=Дополнительные параметры
renderOn
()
Метод включает рисование сцены виджета
renderOff
()
Метод выключает рисование сцены виджета
fullOn
()
async
Метод включает полноэкранный режим
fullOff
()
async
Метод выключает полноэкранный режим
updateFullButton
()
Метод обновляет кнопку управления полноэкранным просмотром
fullToggle
()
async
Метод переключает полноэкранный режим
fullScreenExit
()
async
Метод обрабатывает выход из полноэкранного режима
helpWindowShow
()
Метод показывает окно помощи
helpWindowHide
()
Метод скрывает окно помощи
helpWindowToggle
()
Метод показывает и скрывает окно помощи
rotateOn
()
Метод включает вращение модели
rotateOff
()
Метод выключает вращение модели
rotateStop
()
Метод выключает вращение модели и сбрасывает поворот в первоначальное состояние
rotateToggle
()
Метод переключает вращение модели
updateRotateButton
()
Метод обновляет кнопку управления вращением камеры
lightToggle
()
Метод переключает свечение
updateLightButton
()
Метод обновляет кнопку управления свечением
isCanAnim
()
Boolean
Метод возвращает истину, если анимацию можно запускать
Returns:
Результат
getAnimOptions
()
Site3dWidgetAnimControlOptions
Метод возвращает параметры анимации
Returns:
getAnimNumber
-
[number]
Метод возвращает номер анимации
Parameters:
-
[number]Site3dWidgetAnimControlNumberItem= optionalКак в animControl.number; по умолчанию из getAnimOptions()
Returns:
animOn
()
Метод включает анимацию
animOff
()
Метод выключает анимацию
animToggle
()
Метод переключает анимацию
animScroll
-
delta -
options
Метод осуществляет ручную анимацию
Parameters:
-
deltaNumberШаг изменения анимации
-
optionsSite3dWidgetAnimControlOptionsПараметры анимации
animByEventOn
-
eventName
Метод включает анимацию по событию
Parameters:
-
eventNameStringИмя события
animByEventOff
-
eventName
Метод выключает анимацию по событию
Parameters:
-
eventNameStringИмя события
animStop
()
Метод останавливает все анимации
animReset
()
Метод выключает все анимации с начала
animManualOn
()
Метод включает режим ручной анимации
animManualOff
()
Метод выключает режим ручной анимации
animManualToggle
()
Метод переключает ручной режим анимации
animShowMark
-
options
Метод показывает текущую метку анимации
Parameters:
-
optionsSite3dWidgetAnimControlOptionsПараметры анимации
animRemoveMarks
-
marks
Метод удаляет метки анимации
Parameters:
-
marksSite3dWidgetAnimControlMark=Метки
animClearMarksTimer
()
Метод удаляет таймер анимации
skyboxShow
()
async
Метод показывает панораму
skyboxHide
()
async
Метод скрывает панораму
skyboxToggle
()
async
Метод переключает видимость панорамы
updateSkyboxButton
()
Метод обновляет кнопку управления показом панорамы
sizeOn
()
Метод включает показ размеров модели
sizeOff
()
Метод выключает показ размеров модели
sizeToggle
()
Метод переключает показ размеров модели
updateSizeButton
()
Метод обновляет кнопку управления показом размеров модели
labelOn
()
Метод включает показ меток модели
labelOff
()
Метод выключает показ меток модели
labelToggle
()
Метод переключает показ меток модели
updateLabelButton
()
Метод обновляет кнопку управления показом меток модели
painterOn
()
Метод включает раскраску по клику
painterOff
()
Метод выключает раскраску по клику
painterToggle
()
Метод переключает раскраску по клику
updatePainterButton
()
Метод обновляет кнопку управления раскраской по клику
vrOn
()
async
Метод включает режим виратуальной реальности
vrOff
()
Метод выключает режим виратуальной реальности
vrToggle
()
async
Метод переключает режим виратуальной реальности
updateVrButton
()
Метод обновляет кнопку управления VR
arOn
()
Object
async
Метод включает режим дополненной реальности
Returns:
Служебный объект результата (расширяется по платформе)
arOff
()
Метод выключает режим дополненной реальности
arToggle
()
async
Метод переключает режим дополненной реальности
updateArButton
()
Метод обновляет кнопку управления AR
saveFile
-
category -
blob -
options
Метод сохраняет файл и возвращает полный путь к файлу
Parameters:
-
categoryStringКатегория
-
blobBlobДанные файла
-
optionsSite3dWidgetSaveFileOptions=Параметры
Returns:
Результат
saveTextureFromObjectURL
-
texture
Метод сохраняет файл текстуры из ссылки на объект и возвращает полный путь к файлу
Parameters:
-
textureString | TextureURL объекта или уже загруженная текстура
Returns:
Результат
saveSettingTexture
-
setting
Метод сохраняет файл текстуры в сохраненных данных настройки
Parameters:
-
settingSite3dWidgetConfiguratorSettingTextureСохраненные данные настройки
getLink
-
options
Метод возвращает ссылку на просмотр виджета
Parameters:
-
optionsSite3dWidgetGetLinkOptions=Параметры
Returns:
Результат
link
()
async
Метод вызова окна, где можно поделиться ссылкой на виджет
download
()
async
Метод скачивания файла модели
exportImage
-
options
Метод создает скриншот сцены
Parameters:
-
optionsSite3dWidgetExportImageOptions=Параметры экспорта изображения
Returns:
Итоговый файл изображения
exportVideo
-
options
Метод создает видео
Parameters:
-
optionsSite3dWidgetExportVideoOptions=Параметры создания видео
Returns:
Итоговый файл видео
loadStyleString
-
elem -
styleString
Метод вставляет строку стилей
Parameters:
-
elemHTMLElementDOM-элемент стилей
-
styleStringStringСтрока стилей
loadStyleFile
-
elem -
path -
fileName
Метод вставляет файл стилей
Parameters:
-
elemHTMLElementDOM-элемент стилей
-
pathStringПуть до файла стилей
-
fileNameStringИмя файла стилей
loadStyle
-
elem -
category -
value
Метод вставляет файл стилей
Parameters:
-
elemHTMLElementDOM-элемент стилей
-
categoryStringКатегория
-
valueStringЗначение
showLogo
()
Метод показывает логотип
hideLogo
()
Метод скрывает логотип
showModel
()
Метод показывает модель
hideModel
()
Метод скрывает модель
updateTheme
-
value
Метод обновляет тему оформления
Parameters:
-
valueStringКодовое обозначение
updateAppearance
-
value
Метод обновляет внешний вид виджета
Parameters:
-
valueSite3dWidgetAppearanceOptions=Внешний вид (категории CSS-переменных)
updateFontFamily
-
value
Метод обновляет шрифт виджета
Parameters:
-
valueStringНазвание шрифта
updateBorderRadius
-
value
Метод обновляет радиус закругления виджета
Parameters:
-
valueNumberРадиус закругления
updateBackgroundColor
-
value
Метод обновляет цвет фона
Parameters:
-
valueStringЦвет фона в HEX формате с альфа каналом
updatePreloadBackgroundColor
-
value
Метод обновляет цвет фона окна загрузки
Parameters:
-
valueStringЦвет фона в HEX формате с альфа каналом
updatePreloadBackgroundImage
-
value
Метод обновляет изображение фона окна загрузки
Parameters:
-
valueStringПуть до изображения
updatePreloadPoster
-
value
Метод обновляет изображение кнопки загрузки
Parameters:
-
valueStringПуть до изображения
updatePreloadButton
-
value
Метод обновляет стандартную кнопку загрузки
Parameters:
-
valueSite3dWidgetPreloadButtonOptionsПараметры кнопки загрузки
updateScaleFading
-
value
Метод обновляет затухание при масштабировании
Parameters:
-
valueNumberЗначение от 0 до 10
updateRotateFading
-
value
Метод обновляет затухание при вращении
Parameters:
-
valueNumberЗначение от 0 до 10
updatePosCorrection
-
value
Метод обновляет коррекцию смещения
Parameters:
-
valueSite3dWidgetPosCorrection=Коррекция позиции (% от размера модели)
updateSizeCorrection
-
value
Метод обновляет коррекцию размера
Parameters:
-
valueNumberЗначение
updateRotateCorrection
-
value
Метод обновляет коррекцию вращения
Parameters:
-
valueNumber=Коррекция начального вращения модели
updateMoveControl
-
value
Метод обновляет управление перемещением камеры
Parameters:
-
valueObject=Частичное обновление
options.moveControl
updateScaleControl
-
value
Метод обновляет максимальный масштаб относительно модели
Parameters:
-
valueObject=Частичное обновление
options.scaleControl
updateRotateControl
-
value
Метод обновляет управление вращением камеры
Parameters:
-
valueObject=Частичное обновление
options.rotateControl
updateSizeControl
-
value
Метод обновляет управление показом размеров модели
Parameters:
-
valueObject=Новое значение
options.sizeControl
updateAmbientLight
-
value
Метод обновляет общее освещение
Parameters:
-
valueObject=Параметры
options.ambientLightдля сцены
updateDirectionalLight
-
value -
options
Метод обновляет направленное освещение
Parameters:
-
valueSite3dWidgetDirectionalLightItem | Site3dWidgetDirectionalLightItem=Источник(и) света
-
optionsSite3dWidgetDirectionalLightCallOptions=isUp/isAdditional
updateDirectionalLights
()
Метод обновляет все направленное освещение
restoreMaterialParams
-
paramNames
Метод восстанавливает параметры материала у модели конфигуратора
Parameters:
-
paramNamesStringНазвания сохраняемых параметров
updateGraphics
-
value
Метод обновляет настройки графики
Parameters:
-
valueObject=Новый блок
options.graphics
updatePainter
-
[value] -
[options]
Метод обновляет раскраску
Parameters:
-
[value]Site3dWidgetPainterValue= optionalМерж в
options.painter -
[options]Site3dWidgetUpdatePainterOptions= optionalФлаги вызова
Returns:
updateModelPainter
()
Boolean
Метод устанавливает клики у модели и её элементов для раскраски
Returns:
Результат
updateModelClicks
()
Метод устанавливает клики у модели и её элементов
updateLod
()
async
Метод обновляет уровень детализации модели
updateFloor
-
value -
options
Метод обновляет пол
Parameters:
-
valueSite3dWidgetFloorOptions=Блок пола
-
optionsSite3dWidgetFloorUpdateCallOptions=Доп. вызов (
needRebuild)
updateSkyboxModel
()
async
Метод обновляет модель панорамы
updateSkybox
-
value -
options
Метод обновляет варианты панорамы
Parameters:
-
valueSite3dWidgetSkyboxOptions=Блок skybox
-
optionsObject=Дополнительные параметры
updateLabels
-
[value]
Метод обновляет метки
Parameters:
-
[value]Site3dWidgetLabelsOptions optionalДанные меток
updateConfigurator
-
value -
options
Метод обновляет настройки конфигуратора
Parameters:
-
valueObject=Частичное обновление
options.configurator -
optionsObject=Дополнительные параметры
updateConfiguratorInLabels
()
async
Метод обновляет информацию от конфигуратора в метках
updateScreenSizeCorrection
-
options
Метод обновляет настройки коррекции графики в зависимости от размеров отображаемых частей модели
Parameters:
-
optionsSite3dWidgetScreenSizeCorrectionOptions=Например
start: trueпри старте
updateLinks
-
value -
options
Метод обновляет ссылки
Parameters:
-
valueObject=Блок
options.links -
optionsSite3dWidgetUpdateMergeOptions=isUpdateModelи др.
updateModelLinks
()
Boolean
Метод устанавливает ссылки у модели и её элементов
Returns:
Результат
updateAr
-
value
Метод обновляет AR
Parameters:
-
valueObject=Частичное обновление
options.ar
updateAnimControl
-
[value]
Метод обновляет управление анимацией
Parameters:
-
[value]Site3dWidgetAnimControlOptions= optionalПараметры animControl
updateModelAnimControl
()
Boolean
Метод устанавливает события у модели для управления анимацией
Returns:
Результат
updateAnimButton
()
Метод обновляет кнопку управления анимацией
updateLogo
-
value
Метод обновляет показ логотипа
Parameters:
-
valueObject=Блок
options.logo
updateWatermark
-
[value]
Метод обновляет водяной знак
Parameters:
-
[value]Object= optionalБлок
options.watermark
Returns:
updateStartRotate
-
value
Метод обновляет вращение камеры вокруг модели после старта сцены
Parameters:
-
valueObject=Блок
options.startRotate
stopStartRotate
()
Метод останавливает вращение камеры вокруг модели после старта сцены
updateStartHelp
-
value
Метод обновляет показ анимационных иконок после старта сцены
Parameters:
-
valueObject=Блок
options.startHelp
stopStartHelp
()
Метод останавливает показ анимационных иконок после старта сцены
updateAutoRotate
-
value
Метод обновляет автовращение
Parameters:
-
valueObject=Блок
options.autoRotate
updateTargetControl
-
value
Метод обновляет центр вращения и масштабирования
Parameters:
-
value(false | Number | Object)=false, массив target или объект
updateCamera
-
value
Метод обновляет параметры камеры
Parameters:
-
valueObject=Частичное обновление
options.camera
updateSizeInfo
()
Метод обновляет показ размеров модели
updateLink
-
value
Метод обновляет ссылку для кнопки поделиться ссылкой
Parameters:
-
valueObject=Блок
options.navLink
moveToInitView
()
async
Метод перемещает камеру к первоначальному виду
moveToLabel
-
index
Метод перемещает камеру к метке или первоначальному виду
Parameters:
-
indexNumberИндекс метки (начиная с 1) или 0 для первоначального вида
moveToModelPart
-
name -
options
Метод перемещает камеру к части модели
Parameters:
-
nameStringИмя части модели
-
optionsSite3dWidgetMoveToModelPartOptions=Дистанция, углы, масштаб обзора
setStyles
-
name -
styles -
domElement
Метод устанавливает стили
Parameters:
-
nameStringИмя префикса CSS-переменных
-
stylesObjectВложенная карта значений
-
domElementHTMLElement=Область видимости (
document.bodyпо умолчанию)
event
-
name -
call
Метод подписывает на события виджета
Parameters:
-
nameStringИмя события
-
callFunction(!Event):voidОбработчик
removeEvent
-
name -
call
Метод удаляет подписку на события виджета
Parameters:
-
nameStringИмя события
-
callFunction(!Event):voidТот же callback, что в {@link Site3dWidget#event}
load
()
async
Метод загружает виджет
saveConfiguratorStat
()
async
Метод сохраняет статистику
getConfiguratorInfo
()
Object
Метод возвращает информацию о выборе пользователя в конфигураторе
Returns:
{ items: { caption, settings: { caption, data }[] }[] }
clear
()
Метод очистки виджета
widget
-
containerId -
name -
path -
options
Метод создания 3D виджета
Parameters:
-
containerIdStringИдентификатор HTML-контейнера
-
nameStringИмя модели
-
pathStringПуть до модели
-
optionsSite3dWidgetOptionsПараметры виджета
Returns:
Объект виджета
widgetAsync
-
containerId -
name -
path -
options
Метод асинхронного создания 3D виджета
Parameters:
-
containerIdStringИдентификатор HTML-контейнера
-
nameStringИмя модели
-
pathStringПуть до модели
-
optionsSite3dWidgetOptionsПараметры виджета
Returns:
Объект виджета как результат промиса
Properties
{string|(() => void)} url - Шаблон URL с `[path]` или функция «Скачать».
String
Платформа, доступная для шеринга.
value - Код (value) выбранной настройки.
String
Ссылка на настройку конфигуратора в окне метки.
{string} [animVariant] - Вариант анимации при показе.
Boolean
Параметры сценария камеры при клике по метке.
{Site3dWidgetLabelMoveCameraOptions} [moveCamera] - Сценарий камеры по клику.
String
Элемент списка options.labels.items (поверх дефолтов _labelItemInit).
{Object} [styles] - Стили блока меток.
Boolean
Блок параметров меток виджета (options.labels).
value - Индекс трека анимации на модели.
Number
Элемент массива номеров треков (animControl.number, hover.number, variants[].number).
{HTMLElement} [elem] - Созданный DOM узел метки.
String
Метка на таймлайне анимации (animControl.marks, variants[].marks).
{number} [speed] - Скорость воспроизведения.
Site3dWidgetAnimControlNumberItem
Параметры анимации для hover (animControl.hover).
{boolean} [commonSettings] - Если true — в getAnimOptions к базовому animControl подставляется только number варианта.
String
Вариант анимации в панели (animControl.variants[]).
{boolean} [showPanel] - Показывать панель управления анимацией.
Boolean
Блок options.animControl.
{number} [angleY] - Угол направления света по Y (градусы).
Number
Элемент массива directionalLight / directionalLightUp / directionalLightAdditional (углы задаёт виджет).
{number} [opacity] - Непрозрачность слоя кисти (0…1).
Boolean
Параметры кисти (options.painter.brush).
{Site3dWidgetPainterBrushOptions} brush - Параметры активной кисти.
Boolean
Блок options.painter.
{Site3dWidgetPainterBrushOptions} [brush] - Слить параметры кисти.
Boolean
Частичное обновление painter (аргумент {@link Site3dWidget#updatePainter}).
[isUpdateModel] - По умолчанию не `false` — вызывается `updateModelClicks`.
Boolean
Опции вызова {@link Site3dWidget#updatePainter}.
[autoHide] - Автоскрытие панели навигации.
Boolean
options.navControl
[url] - URL ссылки «поделиться» по умолчанию.
String
options.navLink
{boolean} [autoStart] - Показывать при старте.
String
options.navHelp (объект окна справки; false — отключить блок).
{boolean} [showPanels] - Показать панели.
Boolean
options.navStart
[screenshots] - Доп. скриншоты в окне шеринга.
Site3dWidgetNavShareScreenshotItem
options.navShare
{'start'|'hover'|string} [enabledTime] - Когда показывать.
Boolean
options.logo
{number} [opacity] - Интенсивность (как в UI, 0…100).
Boolean
options.watermark
{string} [caption] - Подпись.
Boolean
options.preloadButton
{string} [axes] - Оси (`xy`, …).
Boolean
options.moveControl
{number|undefined} [max] - Абсолютный максимум.
Boolean
options.scaleControl
{number} [maxY] - Максимум по Y.
Boolean
options.rotateControl
{number} [speed] - Скорость авто-вращения.
Boolean
options.autoRotate
{boolean} [recalc] - Пересчёт при смене масштаба.
Boolean
options.sizeControl
{'around'|'flick'|string} [type] - Тип / режим.
Boolean
options.startRotate
[isEnabled] - Включить опцию.
Boolean
options.startHelp
{*} [pos] - Служебное поле позиции (сбрасывается).
'perspective' | 'orthographic' | String
options.camera (сливается в {@link Site3dWidget#updateCamera} / cameraSetup).
{number} [threshold] - Порог яркости bloom.
Boolean
options.graphics.bloom
{number} [maxDistance] - SSAO: макс. дистанция (1…20).
Boolean
options.graphics.ssao
{number} [opacity] - Прозрачность / сила эффекта.
Boolean
options.graphics.ssr
{number} [b] - Синий канал (слайдер 0…10).
Number
options.graphics.color (RGB-слайдеры UI, 0…10).
{number} [quality] - Качество рендера (0…100).
Boolean
options.graphics.shadows
{number} [emissive] - Эмиссия PBR.
Boolean
options.graphics.commonMaterial.physicalProperties
{Site3dWidgetGraphicsPhysicalProperties} [physicalProperties] - Подблок PBR общего материала.
Boolean
options.graphics.commonMaterial
{number} [thickness] - Толщина линии / рёбер.
Boolean
options.graphics.edges
[isEnabled] - Включить опцию.
Boolean
options.graphics.optimize / screenSizeCorrection
{number} [minSquare] - Мин. площадь экрана для коррекции.
Boolean
[fill] - Заливка окружения (`grey`, …).
String
options.graphics.environment
{boolean} [autoCorrection] - Автокоррекция графики.
Number
Блок options.graphics.
{Object<string, string>} [window] - Окно заказа.
Boolean
Темизация (options.appearance): карты CSS-переменных по зонам.
{string} [part] - Имя части модели для ссылки.
Boolean
Элемент options.links.items[] (база + {@link Site3dWidget#_linkItemInit}).
{Object<string, Object<string, string>>} [styles] - В т.ч. `hint` → карта CSS.
Site3dWidgetLinkItemOptions
options.links
{string} [error] - Текст ошибки AR.
'quicklook' | String
options.ar
{string} [path] - Путь к модели LOD.
Number | String
Уровень options.lod.items[]
{Site3dWidgetLodLevelOptions[]} [items] - Уровни LOD.
Boolean
options.lod
[caption] - Текст на кнопке формы.
String
Кнопка формы заказа конфигуратора.
{{ toEmail?: string }} [admin] - Настройки администратора заказа.
Boolean
options.configurator.orderInfo
{string} [currency] - Символ валюты.
Boolean
options.configurator.priceInfo
{number} [step] - Шаг слайдера оси.
Boolean
Ось options.configurator.settingSize.axes.*
{string} [unit] - Единица размеров изделия.
Boolean
options.configurator.settingSize
{boolean} [hideAfterSelect] - Скрывать панель после выбора.
String
Блок options.configurator.
{string} [viewUrl] - База URL просмотра сохранённой сцены.
String
Сервис сохранения ссылок (getLink / статистика).
{Site3dWidgetConfiguratorServiceOptions} [configuratorService] - Сервис ссылок/языка для {@link Site3dWidget#getLink}.
String
Полные опции конструктора {@link Site3dWidget} (дефолты — optionsInit в конструкторе; внешний объект сливается через mergeObjects).
{boolean} [loaded] - Флаг «загрузка завершена» для колбэка статуса.
String
Статус индикатора загрузки ({@link Site3dWidget#loadSetStatus}).
{boolean} [notUpdateRenderIsActive] - Не менять `isActive` у текущего рендера.
Boolean
Доп. флаги {@link Site3dWidget#updateIsRender}.
{(info: { percent: number }) => void} [onProgress] - Колбэк прогресса POST.
'fullPath' | 'arPath' | String
Параметры {@link Site3dWidget#saveFile}.
[texture] - URL, blob: или путь после сохранения на сервер.
String
Настройка конфигуратора с текстурой (blob/url).
{boolean} [isOrder] - Пометить запрос как заказ.
String
Аргумент {@link Site3dWidget#getLink}.
[cameraOptions] - То же, что в `options.camera` / снимке сцены.
Object
Опции {@link Site3dWidget#getShareImageAsHTML}.
[start] - Вызов при старте сцены (учитывается только если коррекция включена).
Boolean
Аргумент {@link Site3dWidget#updateScreenSizeCorrection}.
{boolean} [isAdditional] - Обновлять `directionalLightAdditional`.
Boolean
Второй аргумент {@link Site3dWidget#updateDirectionalLight}.
[isUpdateModel] - После смены данных вызвать `updateModelClicks` и т.п.
Boolean
Общие флаги merge-методов (updateLinks, updatePainter, …).
{string} [scaleMax] - Макс. дистанция зума для части модели.
String
Опции {@link Site3dWidget#moveToModelPart}.
{string[]} [styles] - Дополнительные CSS-классы.
String
Опции разметки кнопки навигации ({@link Site3dWidget#_getNavButtonAsString}).
{number} z - Смещение по Z в % от размера модели.
Number
Коррекция позиции модели (проценты от размера).
{string[]} [exceptions] - Имена частей модели, которые скрыть на кадр.
String
Параметры {@link Site3dWidget#exportImage}.
{boolean} [isWatermark] - Наложить водяной знак на запись.
String
Параметры {@link Site3dWidget#exportVideo}.
{Object} initBrush - Исходные параметры материала для отката.
Boolean
Служебные данные раскраски в material.userData.
} userData - userData three.js; в `painter` — состояние кисти.
painter?: Site3dWidgetPainterUserData
Материал с расширенным userData для painter-режима.
delta - `[dx, dy]` в пикселях (как `mousePosDelta` в Site3d).
Number
Второй аргумент {@link Site3d#callEvent} для имени dragMove (смещение указателя по осям).
info - Данные смещения drag (второй аргумент {@link Site3d#callEvent}).
Site3dWidgetDragMoveEventInfo | null
DOM-событие dragMove от сцены Site3d: на Event добавлено поле info из {@link Site3d#callEvent}.
delta - Относительное изменение масштаба (знак и величина — как в Site3d).
Number
Второй аргумент {@link Site3d#callEvent} для имени scale (щипок / масштаб жеста).
info - Данные жеста масштаба (второй аргумент {@link Site3d#callEvent}).
Site3dWidgetScaleGestureEventInfo | null
DOM-событие scale от сцены Site3d.
{string} color - Цвет заливки пола (RGBA/HEX).
Boolean
Блок options.floor.
[needRebuild] - Принудительно пересоздать геометрию пола.
Boolean
Второй аргумент {@link Site3dWidget#updateFloor}.
{string} color - Цвет заливки skydome без текстуры.
Boolean
Блок options.skybox.
container
Site3dWidgetContainerElement | Null
Свойство возвращает корневой элемент виджета
name
String
Свойство возвращает имя базовой модели виджета
guid
String
Свойство возвращает уникальное имя виджета
path
String
Свойство возвращает путь до базовой модели виджета
options
Site3dWidgetOptions
Свойство возвращает параметры виджета
model
(Site3dImportModel | Site3dCube) | Null
Свойство возвращает базовую модель виджета
isModelErrorLoad
Boolean
Свойство возвращает истину, если модель виджета загрузилась с ошибкой
isFull
Boolean
Свойство возвращает истину, если запущен полноэкранный режим
isRotate
Boolean
Свойство возвращает истину, если запущен режим вращения
isAnim
Boolean
Свойство возвращает истину, если запущена анимация
isVR
Boolean
Свойство возвращает истину, если запущен режим VR
isAR
Boolean
Свойство возвращает истину, если запущен режим AR
isLod
Boolean
Свойство возвращает истину, если действует LOD
isConfiguratorData
Boolean
Свойство возвращает истину, если переданы данные для создания конфигуратора
isConfigurator
Boolean
Свойство возвращает истину, если подключен конфигуратор
isLoad
Boolean
Свойство возвращает истину, если виджет загружен
isLight
Boolean
Свойство возвращает истину, если включено свечение
