API Docs for:
Show:

Site3dPlanner Class

Класс планировщика

Constructor

Site3dPlanner

(
  • s3d
  • options
)

Parameters:

  • s3d Site3d

    Объект 3D-сцены

  • options Site3dConfiguratorOptions

    Параметры конфигуратора

Item Index

Methods

Properties

Methods

getSaveItems

(
  • root
)
Site3dConfiguratorItemSaveData | Site3dConfiguratorItemSaveData

Inherited from Site3dConfigurator but overwritten in modules\planner\planner.js:284

Метод возвращает элементы дерева планировщика для сохранения в json формате

Parameters:

Returns:

Site3dConfiguratorItemSaveData | Site3dConfiguratorItemSaveData:

Данные для сохранения

getFloat

(
  • value
)
Number | number static

Метод возвращает округленное значение

Parameters:

  • value Number | string | number | string

    Входное значение (может быть числом или строкой)

Returns:

Number | number:

Округленное значение с дробной частью

getEventRot

(
  • item
  • delta
)
Number static

Метод возвращает значение настройки угла поворота при редактировании указателем

Parameters:

  • item Site3dPlannerCabinItem

    Элемент конфигуратора

  • delta Number

    Изменение угла поворота

Returns:

Number:

Угол поворота

projectOpen

(
  • data
)
async

Метод открывает проект

Parameters:

  • data Object

    Сохраненные в JSON формате данные

projectSave

() async

Метод сохраняет проект

getNextCabinIndex

() Number

Метод возвращает следующий индекс для новой бытовки

Returns:

Number:

Новый индекс

getNextRoomIndex

() Number

Метод возвращает следующий индекс для новой комнаты

Returns:

Number:

Новый индекс

getNextObjectIndex

() Number

Метод возвращает следующий индекс для нового объекта

Returns:

Number:

Новый индекс

isCabinParent

(
  • cabin
)
Boolean

Метод возвращает истину, если на бытовке есть другие бытовки

Parameters:

  • cabin Site3dPlannerCabin

    Объект бытовки

Returns:

Boolean:

Результат

getCabinsSorted

(
  • sort
)
Object

Метод возвращает отсортированные бытовки

Parameters:

  • sort Function

    Функуия сортировки

Returns:

Object:

Результат

getCabinsCoresItems

(
  • options
)
Site3dPlannerCabinCore[]

Метод возвращает каркасы бытовок

Parameters:

  • options Object

    Дополнительные параметры:

    • cabins - Объекты бытовок для обработки (включая дочерние бытовки)
    • exceptCabins - Объекты бытовок для исключения (включая дочерние бытовки)

Returns:

Site3dPlannerCabinCore[]:

Результат

getCabinsCoresModels

(
  • options
)
Site3dModel[]

Метод возвращает модели каркасов бытовок

Parameters:

  • options Object

    Дополнительные параметры:

    • cabins - Объекты бытовок для обработки (включая дочерние бытовки)
    • exceptCabins - Объекты бытовок для исключения (включая дочерние бытовки)

Returns:

Site3dModel[]:

Результат

getCabinsBoundModels

(
  • options
)
Site3dModel[]

Метод возвращает модели границ бытовок

Parameters:

  • options Object

    Дополнительные параметры:

    • cabins - Объекты бытовок для обработки (включая дочерние бытовки)
    • exceptCabins - Объекты бытовок для исключения (включая дочерние бытовки)

Returns:

Site3dModel[]:

Результат

getCabinsItemCoreModels

(
  • options
)
Site3dModel[]

Метод возвращает модели частей каркасов бытовок

Parameters:

  • options Object

    Дополнительные параметры:

    • cabins - Объекты бытовок для обработки (включая дочерние бытовки)
    • exceptCabins - Объекты бытовок для исключения (включая дочерние бытовки)

Returns:

Site3dModel[]:

Результат

getCabin

(
  • index
)
Site3dPlannerCabin | undefined

Метод возвращает данные бытовки по ее индексу

Parameters:

  • index String

    Индекс бытовки

Returns:

Site3dPlannerCabin | undefined:

Данные

getCabinByCoreItemIndex

(
  • index
)
Site3dPlannerCabin | undefined

Метод возвращает данные бытовки по индексу каркаса

Parameters:

  • index String

    Индекс каркаса бытовки

Returns:

Site3dPlannerCabin | undefined:

Данные

getCabinsUp

(
  • cabin
)
Object

Метод возвращает бытовки, расположенные на данной бытовке

Parameters:

  • cabin Site3dPlannerCabin

    Объект бытовки

Returns:

Object:

Данные бытовки или false

getCabinLastParent

(
  • cabin
)
Site3dPlannerCabin | false

Метод возвращает самую нижнюю бытовку под данной бытовкой

Parameters:

  • cabin Site3dPlannerCabin

    Объект бытовки

Returns:

Site3dPlannerCabin | false:

Данные бытовки или false

getCabinLevel

(
  • cabin
)
Number

Метод возвращает этажность бытовки

Parameters:

  • cabin Site3dPlannerCabin

    Объект бытовки

Returns:

Number:

Результат

getCabinHeight

(
  • cabin
)
Number

Метод возвращает высоту бытовки над уровнем земли

Parameters:

  • cabin Site3dPlannerCabin

    Объект бытовки

Returns:

Number:

Результат

getRoomWallInners

(
  • cabin
)
Site3dPlannerCabinWallInner[]

Метод возвращает элементы внутренних стен комнаты

Parameters:

  • cabin Object

    Объект бытовки

Returns:

Site3dPlannerCabinWallInner[]:

Массив элементов

getCabinWallItems

(
  • cabin
)
Site3dPlannerWallItem[]

Метод возвращает объекты стен бытовки

Parameters:

  • cabin Site3dPlannerCabin

    Объект бытовки

Returns:

Site3dPlannerWallItem[]:

Результат

getCabinWall

(
  • cabin
  • wallType
  • index
)
Site3dPlannerCabinBlock

Метод возвращает стену бытовки

Parameters:

  • cabin Site3dPlannerCabin

    Объект бытовки

  • wallType Site3dPlannerCabinBlockClass

    Класс стены

  • index Number

    Индекс стены

Returns:

Site3dPlannerCabinBlock:

Результат

getCabinDoorsOut

(
  • cabin
)
Site3dPlannerDoorOut[]

Метод возвращает внешние двери бытовки

Parameters:

  • cabin Site3dPlannerCabin

    Объект бытовки

Returns:

Site3dPlannerDoorOut[]:

Результат

getCabinWallInnerDoors

(
  • wallInnerItem
)
Site3dPlannerWallItem[]

Метод возвращает двери на стене бытовки

Parameters:

Returns:

Site3dPlannerWallItem[]:

Массив объектов

getCabinCloneInfo

(
  • cabin
  • prevCloneInfo
)
Object

Метод возвращает информацию о клонировании бытовки

Parameters:

  • cabin Site3dPlannerCabin

    Объект бытовки

  • prevCloneInfo Object

    Предыдущая информация о клонировании бытовки

Returns:

Object:

Результат

getCabinCloneSaveItems

(
  • cabin
  • }
  • parent
)
Site3dPlannerCabinCloneSaveData

Метод возвращает элементы дерева конфигуратора для сохранения в json формате с корректировкой информацией о клонировании бытовки

Parameters:

  • cabin Site3dPlannerCabin

    Объект бытовки

  • } RoomsIndexes: Map, objectsIndexes: Map

    cabinCloneInfo Информация о клонировании бытовки

  • parent String

    Индекс элемента, на который клонируется бытовка

Returns:

Site3dPlannerCabinCloneSaveData:

Результат

setCabinsUpMoveLocal

(
  • cabin
)

Метод устанавливает местоположение бытовок, находящихся над данной бытовкой

Parameters:

  • cabin Site3dPlannerCabin

    Объект бытовки

setCabinWallInnerMaterial

(
  • cabin
  • value
)
async

Метод устанавливает материал для всех внутренних стен бытовки

Parameters:

  • cabin Site3dPlannerCabin

    Объект бытовки

  • value String | object

    Значение материала

getCabinWallInnerDistanceToEnd

(
  • cabin
)
Number

Метод возвращает дистанцию от любой внутренней стены до ближайшего края бытовки

Parameters:

  • cabin Site3dPlannerCabin

    Объект бытовки

Returns:

Number:

Результат

getRoom

(
  • cabin
  • index
)
Site3dPlannerRoom

Метод возвращает данные комнаты бытовки по ее индексу

Parameters:

  • cabin Site3dPlannerCabin

    Объект бытовки

  • index Number

    Индекс комнаты

Returns:

Site3dPlannerRoom:

Данные

getRooms

(
  • cabin
)
Site3dPlannerRoom

Метод возвращает комнаты бытовки

Parameters:

  • cabin Site3dPlannerCabin

    Объект бытовки

Returns:

Site3dPlannerRoom:

Комнаты бытовки

getRoomsOut

(
  • cabin
)
Site3dPlannerRoom

Метод возвращает комнаты бытовки, оказавшиеся за её пределами

Parameters:

  • cabin Site3dPlannerCabin

    Объект бытовки

Returns:

Site3dPlannerRoom:

Комнаты вне бытовки

getRoomHeight

(
  • cabin
)
Number

Метод возвращает высоту комнаты бытовки

Parameters:

  • cabin Site3dPlannerCabin

    Объект бытовки

Returns:

Number:

Высота комнаты

getRoomIndexPrefix

(
  • index
)
String

Метод возвращает префикс индекса элемента комнаты по её номеру

Parameters:

  • index Number

    Номер комнаты

Returns:

String:

Результат

getRoomFloorIndex

(
  • index
)
String

Метод возвращает индекс элемента пола комнаты по её номеру

Parameters:

  • index Number

    Номер комнаты

Returns:

String:

Результат

getRoomFloor

(
  • room
)
Site3dPlannerRoomFloor

Метод возвращает пол комнаты

Parameters:

  • room Site3dPlannerRoom

    Объект комнаты

Returns:

Site3dPlannerRoomFloor:

Элемент пола комнаты

getRoomWallInnerIndexPrefix

(
  • index
)
String

Метод возвращает префикс индекса элемента внутренней стены комнаты по номеру комнаты

Parameters:

  • index Number

    Номер комнаты

Returns:

String:

Результат

getRoomWallInnerIndex

(
  • index
  • number
)
String

Метод возвращает индекс элемента внутренней стены комнаты по номеру комнаты и стены

Parameters:

  • index Number

    Номер комнаты

  • number Number

    Номер стены

Returns:

String:

Результат

getRoomWallInner

(
  • room
  • number
)
Site3dPlannerRoomWallInner

Метод возвращает внутреннюю стену комнаты

Parameters:

  • room Site3dPlannerRoom

    Объект комнаты

  • number Number

    Номер стены

Returns:

Site3dPlannerRoomWallInner:

Результат

getRoomWallInners

(
  • room
)
Site3dPlannerRoomWallInner[]

Метод возвращает элементы внутренних стен комнаты

Parameters:

  • room Site3dPlannerRoom

    Объект комнаты

Returns:

Site3dPlannerRoomWallInner[]:

Массив элементов

getRoomObjects

(
  • room
  • cabin
)
Site3dPlannerObject[]

Метод возвращает объекты комнаты

Parameters:

  • room Site3dPlannerRoom

    Объект комнаты

  • cabin Site3dPlannerCabin

    Объект бытовки (если объекты находятся временно вне комнаты)

Returns:

Site3dPlannerObject[]:

Результат

getRoomObjectsOut

(
  • room
)
Site3dPlannerObject[]

Метод возвращает обеъекты комнаты, оказавшиеся за её пределами

Parameters:

  • room Site3dPlannerRoom

    Объект комнаты

Returns:

Site3dPlannerObject[]:

Результат

getRoomItems

(
  • room
)
Site3dPlannerCabinItem[]

Метод возвращает все элементы комнаты

Parameters:

  • room Site3dPlannerRoom

    Объект комнаты

Returns:

Site3dPlannerCabinItem[]:

Массив элементов

setRoomWallInnerMaterial

(
  • room
  • value
)
async

Метод устанавливает материал для всех внутренних стен комнаты бытовки

Parameters:

  • room Site3dPlannerRoom

    Объект комнаты

  • value String | object

    Значение материала

getObject

(
  • cabin
  • index
)
Object

Метод возвращает данные объекта бытовки по ее индексу

Parameters:

  • cabin Site3dPlannerCabin

    Объект бытовки

  • index Number

    Индекс комнаты

Returns:

Object:

Данные

getObjects

(
  • cabin
  • options
)
Site3dPlannerObject[]

Метод возвращает объекты бытовки

Parameters:

  • cabin Site3dPlannerCabin

    Объект бытовки

  • options Object

    Дополнительные параметры

Returns:

Site3dPlannerObject[]:

Объекты бытовки

getObjectsOut

(
  • cabin
  • options
)
Site3dPlannerObject[]

Метод возвращает объекты бытовки, оказавшиеся за её пределами

Parameters:

  • cabin Site3dPlannerCabin

    Объект бытовки

  • options Object

    Дополнительные параметры

Returns:

Site3dPlannerObject[]:

Результат

getObjectsByPlaceItem

(
  • cabin
  • placeItem
)
Site3dPlannerObject[]

Метод возвращает объекты бытовки, расположенных на определенном элементе конфигуратора

Parameters:

  • cabin Site3dPlannerCabin

    Объект бытовки

  • placeItem Site3dPlannerCabinItem

    Индекс комнаты

Returns:

Site3dPlannerObject[]:

Результат

getObjectsWithLevels

(
  • objects
)
Site3dPlannerObject[]

Метод возвращает объекты бытовки с учетом расположенных на них объектов

Parameters:

Returns:

Site3dPlannerObject[]:

Результат

removeObject

(
  • item
)
async

Метод удаляет объект внутри бытовки с учетом истории

Parameters:

createEntityModel

(
  • type
  • name
  • options
)
Site3dModel async

Метод создает модель элемента конфигуратора

Parameters:

  • type String

    Тип модели

  • name String

    Имя модели

  • options Object

    Дополнительные параметры

Returns:

Site3dModel:

Модель

createEntityItem

(
  • entity
  • data
  • prefix
  • connectModelName
  • options
)
Site3dPlannerItem async

Метод добавляет элемент конфигуратора

Parameters:

  • entity Site3dPlannerCabinEntityClass

    Конструктор элемента бытовки (класс)

  • data Object

    Элемент дерева конфигуратора

  • prefix String

    Префикс к имени модели, создаваемого элемента

  • connectModelName String

    Имя модели для присоединения

  • options Object

    Дополнительные параметры

Returns:

Site3dPlannerItem:

Результат

createEntityItems

(
  • entity
  • data
  • prefix
  • connectModelName
  • options
)
async

Метод добавляет элементы конфигуратора

Parameters:

  • entity Site3dPlannerCabinEntityClass

    Класс элементов

  • data Object

    Элемент дерева конфигуратора

  • prefix String

    Префикс к имени моделям, создаваемых элементов

  • connectModelName String

    Имя модели для присоединения

  • options Object

    Дополнительные параметры

updatePlinthModels

(
  • item
)
async

Метод обновляет плинтуса элемента конфигуратора

Parameters:

  • item Site3dPlannerWallInner

    Внутренняя стена

addCabin

(
  • data
)
async

Метод добавляет бытовку

Parameters:

  • data Site3dPlannerCabinData

    Данные бытовки

addRoom

(
  • cabin
  • data
)
async

Метод добавляет комнату

Parameters:

  • cabin Site3dPlannerCabin

    Объект бытовки

  • data Site3dPlannerRoomData

    Данные комнаты

addObject

(
  • cabin
  • data
)
async

Метод добавляет объект внутри бытовки

Parameters:

  • cabin Site3dPlannerCabin

    Объект бытовки

  • data Site3dPlannerObjectData

    Данные объекта внутри бытовки

setCabinWallOutView

(
  • wallOutItem
  • value
  • options
)
async

Метод изменяет видимость внешней стены бытовки

Parameters:

  • wallOutItem Site3dPlannerCabinWallOut

    Элемент внешней стены бытовки

  • value String

    Значение видимости стены

  • options Object

    Дополнительные параметры

setCabinWallInnerView

(
  • wallInnerItem
  • value
)
async

Метод изменяет видимость внутренней стены бытовки

Parameters:

  • wallInnerItem Site3dPlannerCabinWallInner

    Элемент внутренней стены бытовки

  • value String

    Значение видимости стены

setCabinCeilingVisibility

(
  • cabin
)

Метод устанавливает видимость внешнего и внутреннего потолка бытовки

Parameters:

  • cabin Site3dPlannerCabin

    Объект бытовки

updateCabinsUpDoorStairs

(
  • cabin
)

Метод обновляет лестницы дверей у вышестоящих бытовок

Parameters:

  • cabin Site3dPlannerCabin

    Объект бытовки

getChangeValue

(
  • data
  • change
)
Any

Метод возвращает значение объекта изменений

Parameters:

  • data Object

    Объект изменений

  • change Object

    Изменение

Returns:

Any:

Значение

setChangeValue

(
  • data
  • change
)

Метод устанавливает значение объекта изменений

Parameters:

  • data Object

    Объект изменений

  • change Object

    Изменение

removeObjectsByData

(
  • data
  • cabin
)

Метод удаляет объекты из данных в виде сохраненных объектов

Parameters:

  • data Object

    Объекты данных

  • cabin Site3dPlannerCabin

    Объект бытовки

buildCabin

(
  • data
  • changes
  • options
)
async

Метод строит бытовку

Parameters:

  • data Object

    Данные бытовки

  • changes Array

    Изменения в бытовке

  • options Object

    Дополнительные параметры

buildRoom

(
  • data
  • changes
  • options
)
async

Метод строит комнату

Parameters:

  • data Object

    Данные комнаты

  • changes Array

    Изменения в комнате

  • options Object

    Дополнительные параметры

removeCabin

(
  • data
  • options
)
async

Метод удаляет бытовку

Parameters:

  • data Object

    Данные бытовки

  • options Object

    Дополнительные параметры

removeRoom

(
  • data
  • options
)
async

Метод удаляет комнату

Parameters:

  • data Object

    Данные комнаты

  • options Object

    Дополнительные параметры

intersectCabin

(
  • checkItem
  • checkItemData
  • options
)
Site3dPlannerPlaceIntersect

Метод возвращает информацию о пересечении указателя с элементом бытовки

Parameters:

  • checkItem Site3dPlannerCabinItem

    Элемент бытовки (объект или класс)

  • checkItemData Object

    Данные элемента бытовки

  • options Object

    Дополнительные параметры

Returns:

Site3dPlannerPlaceIntersect:

Результат

getGroundIntersect

(
  • options
)
Site3dPlannerPlace

Метод возвращает местоположение для объектов конфигуратора по пересечению указателя с землей

Parameters:

  • options Object

    Дополнительные параметры:

    • cabins - Объекты бытовок для обработки (включая дочерние бытовки)
    • exceptCabins - Объекты бытовок для исключения (включая дочерние бытовки)
    • posShift - Смещение итоговой позиции

Returns:

Site3dPlannerPlace:

Местоположение

startAddToHistory

(
  • index
  • caption
  • cancel
  • data
)

Метод начинает добавление действия в историю

Parameters:

  • index String

    Идентификатор действия

  • caption String

    Название действия

  • cancel Function

    Функция отмены действия

  • data Object

    Данные для обработки функциями отмены и совершения действия

stopAddToHistory

()

Метод останавливает добавление действия в историю

setDataToHistory

(
  • data
)

Метод устанавливает дополнительные данные для обработки функциями отмены и совершения действия

Parameters:

  • data Object

    Дополнительные данные

endAddToHistory

(
  • make
  • additionalData
  • options
)
async

Метод заканчивает добавление действия в историю и запускает его

Parameters:

  • make Function

    Функция совершения действия

  • additionalData Object

    Дополнительные данные для обработки функциями отмены и совершения действия

  • options Object

    Дополнительные параметры

    • isAutoStart - истина, если make исполняется (по умолчанию истина)

addToHistory

(
  • index
  • caption
  • cancel
  • make
  • data
  • options
)
async

Метод добавляет информацию о действии и запускает его

Parameters:

  • index String

    Идентификатор действия

  • caption String

    Название действия

  • cancel Function

    Функция отмены действия

  • make Function

    Функция совершения действия

  • data Object

    Данные для обработки функциями отмены и совершения действия

  • options Object

    Дополнительные параметры

    • isAutoStart - истина, если make исполняется (по умолчанию истина)

isHistoryChanges

(
  • changes
)
Boolean async

Метод возвращает истину, если изменения в истории произошли

Parameters:

  • changes Array

    Изменения в комнате

Returns:

Boolean:

Результат

setHistoryActions

()

Метод устанавливает активность действий над историей

updateRoof

() async

Метод обновляет крышу

updateView

()

Метод обновляет вид обзора сцены

createTexture

(
  • [options]
)
Promise async

Метод создания текстуры

Parameters:

  • [options] Site3dConfiguratorCreateTextureOptions optional

    Параметры

Returns:

Promise:

Файл текстуры в base64

getServerData

(
  • filePath
  • [data=null]
  • [format='json']
)
Promise async

Метод вызывает серверный скрипт и возвращает результат через промис

Parameters:

  • filePath String

    Путь до файла скрипта с расширением

  • [data=null] Site3dConfiguratorServerRequestData | null optional

    Отправляемые на сервер данные

  • [format='json'] Site3dConfiguratorServerDataFormat optional

    Формат возвращаемого результата

Returns:

Promise:

Результат

checkDevice

()

Метод производит проверку типа устройства

start

(
  • options
)
async

Метод запуска конфигуратора

Parameters:

  • options Site3dConfiguratorOptions

    Параметры конфигуратора

init

() async

Метод инициализации конфигуратора. Используйте перегреженную версию для переопределения базовых параметров:

  • templatesPath - путь к HTML-шаблонам
  • actionsPath - путь к иконкам действий
  • texturesPath - путь к текстурам

getOrderItems

()

Метод возвращает родительский элемент дерева конфигуратора для отображения в заказе (для переопределения)

addBuildLogic

()

Метод формирования логики построения конфигуратора (для переопределения)

addOrderInfo

()

Метод формирования формы заказа конфигуратора (для переопределения)

addTemplates

()

Метод добавления описаний для загрузки HTML-шаблонов (для переопределения с целью добавления новых шаблонов в свойство templates)

beforeLoad

() async

Метод запускается перед началом загрузки данных конфигуратора (для переопределения)

addPanels

() async

Метод добавления панелей управления (для переопределения с целью добавления новых панелей в коллекцию panels)

loadDataCompleted

(
  • data
)
async

Метод запускается после завершения загрузки данных конфигуратора (для переопределения)

Parameters:

  • data Site3dConfiguratorData

    Данные конфигуратора

load

(
  • options
)
async

Метод загрузки параметров конфигуратора (используется для загрузки сохраненных ранее проектов)

Parameters:

  • options Site3dConfiguratorOptions

    Параметры конфигуратора

updateLoadScreenBackgroundColor

(
  • value
)

Метод обновляет цвет фона окна загрузки

Parameters:

  • value String

    Цвет фона в HEX формате с альфа каналом

updateShowPanelControlsButton

(
  • value
)

Метод обновляет показ кнопки вызова панелей управления

Parameters:

  • value Boolean

    Истина, если кнопка активна

addSettings

() async

Метод добавления настроек конфигуратора (для переопределения)

addActions

() async

Метод добавления действий для конфигуратора (для переопределения)

addItems

() async

Метод добавления элементов конфигуратора (для переопределения)

addItem

(
  • model
  • options
)
Promise async

Метод добавления элемента конфигуратора

Parameters:

  • model Site3dModel

    3D модель элемента

  • options Site3dConfiguratorItemOptions

    Параметры элемента

Returns:

Promise:

Новый элемент конфигуратора или null

loadItemsCompleted

() async

Метод завершения загрузки частей конфигуратора (для переопределения)

autoStartSettingsCompleted

() async

Метод завершения автозапуска настроек конфигуратора (для переопределения)

build

()

Метод сборки элементов конфигуратора (для переопределения)

loadCompleted

() async

Метод завершения загрузки конфигуратора (для переопределения)

addTemplate

(
  • name
  • options
)
async

Метод загружает и добавляет содержимое шаблона в список templates

Parameters:

  • name String

    Имя шаблона

  • options Site3dConfiguratorTemplateOptions

    Параметры шаблона

getTemplate

(
  • name
  • params
  • subName
)
Promise async

Метод получения HTML-шаблона

Parameters:

  • name String

    Имя шаблона

  • params String

    Массив значений, подставляемых в шаблон

  • subName String

    Постфикс в названии шаблона

Returns:

Promise:

Содержимое шаблона

s

(
  • name
)
String | number | object

Метод получения значения настройки

Parameters:

  • name String

    Имя настройки

Returns:

String | number | object:

Значение настройки

setSettings

()

Метод для массового изменения значений настроек конфигуратора

loadItems

(
  • promise
)
Promise

Метод регистрации результата добавления части конфигуратора (элемент или часть дерева элементов)

Parameters:

  • promise Promise

    Промис окончания загрузки части конфигуратора

Returns:

Promise:

Промис

itemsForEach

(
  • childAction
  • parentAction
)

Метод прохода по дереву элементов конфигуратора. В функциях обработки в качестве аргументов передается сам элемент дерева и объект из элементов:

  • index - идентификатор элемента
  • parent - родительский элемент
  • level - уровень вложенности

Parameters:

  • childAction Function

    Функция для обработки элементов конфигуратора

  • parentAction Function

    Функция для обработки родительских элементов дерева конфигуратора

getItemIntersectByModels

(
  • models
  • options
)
Site3dConfiguratorIntersectModelResult | null

Метод возвращает объект из элемента конфигуратора и его позиции, по которой кликнули мышкой

Parameters:

  • models Site3dModel[]

    Модели, среди которых нужно выбирать нужный элемент

  • options Site3dConfiguratorIntersectModelOptions

    Дополнительные параметры:

    • itemCandidates — если задан массив элементов, владелец intersect ищется только среди них (а не по всему дереву конфигуратора)

Returns:

Site3dConfiguratorIntersectModelResult | null:

Результат

getItemIntersect

(
  • items
  • options
)
Site3dConfiguratorIntersectModelResult | null

Метод возвращает объект из элемента конфигуратора и его позиции, по которой кликнули мышкой

Parameters:

  • items Site3dConfiguratorItem[]

    Элементы конфигуратора, среди которых нужно выбирать нужный элемент

  • options Site3dConfiguratorIntersectModelOptions

    Дополнительные параметры

Returns:

Site3dConfiguratorIntersectModelResult | null:

Результат

getItems

(
  • check
  • [options]
)
Site3dConfiguratorItem[]

Метод возвращает список элементов конфигуратора по условию через функцию

Parameters:

  • check Function

    Функция обработки условий

  • [options] Site3dConfiguratorGetItemsOptions optional

    Дополнительные параметры

Returns:

Site3dConfiguratorItem[]:

Список элементов конфигуратора

getItemsByType

(
  • type
  • [options]
)
Site3dConfiguratorItem[]

Метод возвращает список элементов конфигуратора по типу

Parameters:

  • type String

    Тип элемента конфигуратора

  • [options] Site3dConfiguratorGetItemsOptions optional

    Параметры

Returns:

Site3dConfiguratorItem[]:

Список элементов конфигуратора

getItemByIndex

(
  • index
  • [options]
)
Site3dConfiguratorItem

Метод возвращает элемент конфигуратора по индексу

Parameters:

  • index String

    Индекс элемента конфигуратора

  • [options] Site3dConfiguratorGetItemsOptions optional

    Дополнительные параметры

Returns:

Site3dConfiguratorItem:

Элемент конфигуратора

updatePriceInfo

(
  • value
  • [options]
)

Метод обновляет информацию о стоимости

Parameters:

  • value Site3dConfiguratorSettingValue

    Значение

  • [options] Site3dConfiguratorUpdatePriceInfoOptions optional

    Дополнительные параметры

calcPrice

()

Метод расчета строимости (для переопределения)

getFormatPrice

() String

Метод возвращает форматированное значение стоимости

Returns:

String:

Результат

updatePrice

()

Метод считает и показывает стоимость (для возможного переопределения)

updateOrderWindow

()

Метод создает окно заказа

updateOrderInfo

(
  • [value]
)

Метод обновляет информацию о заказе

Parameters:

  • [value] Partial optional

    Значение

startLoading

(
  • [type='main']
  • [content='']
)

Метод показывает статус загрузки

Parameters:

  • [type='main'] 'init' | 'main' optional

    Тип экрана загрузки

  • [content=''] String optional

    Текст статуса загрузки

setLoadingStatus

(
  • content
  • percent
)

Метод устанавливает статус загрузки

Parameters:

  • content String

    Статус загрузки

  • percent Number

    Процент загрузки

endLoading

()

Метод скрывает статус загрузки

startLock

()

Метод запускает блокировку интерфейса

endLock

()

Метод скрывает блокировку интерфейса

enableItems

()

Метод активирует элементы конфигуратора

disableItems

()

Метод деактивирует элементы конфигуратора

setItemsEnabledPrev

()

Метод устанавливает предыдущую активность элементов конфигуратора

deselectActions

()

Метод снимает выделения у всех действий конфигуратора

getActionPath

(
  • name
  • owner
)
String

Метод возвращает путь до действия с учетом вложенности групп

Parameters:

Returns:

String:

Путь

findActionPickerData

(
  • check
)
Index: string, factoryType: string, typeData: Site3dConfiguratorSettingValueItem

Метод возвращает данные действия Site3dConfiguratorActionsPicker по условию

Parameters:

  • check Function

    Условие

Returns:

Index: string, factoryType: string, typeData: Site3dConfiguratorSettingValueItem:

| undefined} Результат

panel

(
  • name
)
Site3dConfiguratorPanel | undefined

Метод возвращает панель

Parameters:

  • name String

    Название панели

Returns:

Site3dConfiguratorPanel | undefined:

Панель

panelControls

(
  • name
)
Site3dConfiguratorPanelControls | undefined

Метод возвращает панель

Parameters:

  • name String

    Название панели

Returns:

Site3dConfiguratorPanelControls | undefined:

Панель настроек

showPanel

(
  • name
  • data
  • [eventData]
)
async

Метод показывает панель

Parameters:

  • name String

    Название панели

  • data Site3dConfiguratorPanelData | null

    Данные для наполнения панели

  • [eventData] Site3dConfiguratorSettingValue optional

    Данные для передачи в событие показа панели

hide

(
  • name
)

Метод скрывает панель

Parameters:

  • name String

    Название панели

togglePanel

(
  • name
)
async

Метод переключает видимость панели

Parameters:

  • name String

    Название панели

callEvent

(
  • name
  • data
)

Метод вызывает событие конфигуратора

Parameters:

  • name String

    Имя событие

  • data Site3dConfiguratorSettingValue | undefined

    Данные для передачи в событие

event

(
  • name
  • call
)

Метод подписывает на события конфигуратора

Parameters:

  • name String

    Имя события

  • call Function

    Функция обработки события

removeEvent

(
  • name
  • call
)

Метод удаляет подписку на событие конфигуратора

Parameters:

  • name String

    Имя события

  • call Function

    Функция обработки события

getSaveData

()

Метод возвращает объект для сохранения конфигуратора в json формате

loadDataItems

(
  • items
  • loadItem
  • [options]
)
async

Метод загружает элементы конфигуратора из объекта в json формате

Parameters:

  • items Site3dConfiguratorItemSaveData

    Данные

  • loadItem Function

    Обработчик загрузки элементов конфигуратора

  • [options] Site3dConfiguratorLoadDataItemsOptions optional

    Дополнительные параметры

loadDataItemSettings

(
  • item
  • dataItemSettings
)
async

Метод загружает настройки конфигуратора или его элемента из объекта в json формате

Parameters:

  • item Site3dConfigurator | Site3dConfiguratorItem

    Конфигуратор или его элемент

  • dataItemSettings Site3dConfiguratorItemSettings

    Данные настроек в json формате

loadDataSettings

(
  • settings
)

Метод загружает настройки конфигуратора из объекта в json формате

Parameters:

  • settings Site3dConfiguratorItemSettings

    Данные

getItemsInfo

(
  • childAction
  • parentAction
)

Метод возвращает информацию об элементах дерева конфигуратора:

Parameters:

  • childAction Function

    Функция для обработки элемента конфигуратора

  • parentAction Function

    Функция для обработки родительских элементов дерева конфигуратора

Properties

cabins

Unknown

Свойство возвращает список с полной информацией о бытовках

{boolean} loaded - Завершена ли загрузка

Site3dWidget

Аргумент колбэка window.site3dConfiguratorLoadStatus (хост страницы, вне конфигуратора).

[texture] - Путь/ключ текстуры во входных данных презентации

String

Дополнительные параметры презентации значения настройки для {@link Site3dConfiguratorSettingsMaterial#getPresentValue}, {@link Site3dConfiguratorSettingsMaterial#getPresentValueData}.

{Site3dConfiguratorPlaceOptions|null} [options] - Дополнительные параметры

String | Null

Данные местоположения для сериализации/десериализации Site3dConfiguratorPlace.

{'beforebegin' | 'afterbegin' | 'beforeend' | 'afterend' | 'beforeBegin' | 'afterBegin' | 'beforeEnd' | 'afterEnd'} where - Позиция вставки (поддерживаются и legacy-значения в camelCase)

HTMLElement

Место вставки контента конфигуратора в DOM

{string} [currency] - Валюта (например '₽')

Boolean

Параметры отображения цены конфигуратора

{(params: { comment: string, isOrder: boolean }) => (Promise<string> | string)} [getLink] - Генератор ссылки для заказа/шаринга

Boolean

Параметры формы заказа конфигуратора

{number} multiplier - Множитель для перевода в базовые единицы

String

Данные единицы измерения настройки

{boolean} [isEnabled] - Доступность элемента

Number

Элемент списка значений настройки (radio, enum, color и т.д.)

{'none' | 'all' | 'onlyTexture'} [repeatType] - Область применения repeat (тайл/материал)

String | Blob | MediaSource

Базовый элемент списка значений для настроек, наследованных от Site3dConfiguratorSettingsEnum.

{number} [opacity] - Непрозрачность материала

Boolean

Элемент списка значений для Site3dConfiguratorSettingsMaterial.

{string[]} [tabs] - Вкладки интерфейса выбора цвета

Site3dConfiguratorSettingValue

Данные цвета для элемента значения настройки материала.

{'none' | 'all' | 'onlyTexture'} [repeatType] - Область применения repeat

Site3dFillData

Элемент списка значений для Site3dConfiguratorSettingsMaterial.

{{repeat?: {x: number, y: number}}} [initValue] - Исходные значения value (например repeat текстуры)

Clone: function(): getHexString: function(): string

Runtime-дополнения, которые конфигуратор записывает в material.

{number | string} [heightAboveMax] - Максимальная высота

String | Blob | MediaSource

Элемент списка значений для Site3dConfiguratorSettingsModel.

{number} connectDistance - Радиус стыковки по XZ (м), 0 — без стыковки

Boolean

Параметры перемещения моделей (элемент конфигуратора)

{number} step - Шаг изменения

Boolean

Параметры осей изменения размеров настройки

{Site3dConfiguratorSizeAxeOptions} z - Ось Z

Site3dConfiguratorSizeAxeOptions

Параметры осей размеров (x, y, z)

{Site3dConfiguratorItemSettings} [settings] - Сохранённые настройки: при сохранении берётся из item.getSaveData().settings (getSaveValue), при загрузке передаётся в item.loadSettingsData() и затем удаляется

Number

Элемент списка перемещаемых моделей настройки (добавленная для перемещения модель)

{Site3dModel | null} model - Модель элемента.

String

Элемент списка моделей для опции itemsInfo (виджет-конфигуратор и др.).

{Site3dConfiguratorItemInfo[]} [itemsInfo] - Элементы виджет-конфигуратора (Site3dWidgetConfigurator)

String

Параметры конфигуратора (options). Структура по умолчанию в конструкторе Site3dConfigurator.

[itemCandidates] - Ограничить поиск этими элементами конфигуратора

Site3dConfiguratorItem[]

Параметры поиска элемента конфигуратора по пересечению.

{Site3dPoint3D} [pos] - Точка пересечения

Site3dConfiguratorItem

Параметры поиска элемента конфигуратора по пересечению.

{Object.<string, string>} [parts] - Дополнительные подшаблоны в виде "имя -> HTML"

String

Параметры HTML-шаблона конфигуратора.

{string[]} [ownTemplates] - Имена собственных шаблонов

Site3dConfiguratorTemplates

Конфигурационные данные конфигуратора (из JSON конфига). Загружаются при инициализации.

mesh - Имя модели/части для выборки mesh-объектов

String

Модель для SSR-фильтра.

{number} [radius] - Радиус SSAO

Boolean

Параметры SSAO.

{number} [opacity] - Прозрачность отражений

Boolean

Параметры SSR.

{number} [radius] - Радиус размытия

Boolean

Параметры Bloom.

{number} [b] - Множитель синего канала

Number

Параметры цветокоррекции RGB.

{boolean} [canPlaceOnObject] - Разрешить установку объектов на другие объекты

Boolean

Дополнительные параметры загрузки конфигуратора. Используются, в том числе, при слиянии в Site3dPlanner.params.

{Site3dConfiguratorParamsData} [params] - Дополнительные параметры загрузки (напр. слияние в Site3dPlanner.params)

Object.

Данные конфигуратора из JSON/options.

{boolean} [show=false] - Показывать панель после загрузки конфигуратора

String

Данные панелей при загрузке конфигуратора.

{boolean} [show=false] - Показывать панель сразу после загрузки/инициализации

Boolean

Общие данные, передаваемые в панель.

{string[]} [tabs] - Вкладки панели выбора цвета

Site3dConfiguratorSettingValue | null

Данные для панели выбора цвета.

{Function | null} [createComplete=null] - Обработчик завершения создания

String

Параметры элемента конфигуратора. Структура по умолчанию в конструкторе Site3dConfiguratorItem.

{Site3dConfiguratorItemSettings} settings - Сохранённые значения настроек

String

Сохраняемые данные элемента конфигуратора.

{boolean} [isVisible=true] - Видимость группы

String

Параметры группы настроек или группы действий. Структура в Site3dConfiguratorSettingsGroup / ActionsGroup.

{Site3dConfiguratorSettingsMaterialWrapType} [wrap] - Режим тайлинга

Site3dConfiguratorSettingsEnumValue

Тип значения настройки материала.

{Site3dConfiguratorMoveItem[]} [moveItems] - Список добавленных/перемещённых элементов

Site3dConfiguratorSettingsEnumValue

Тип значения настройки модели.

{boolean} [isLastModelSetting] - Последняя настройка в цепочке для модели

Boolean

Базовые runtime-параметры методов настройки (setValue/onChange/update/run).

[needRadioChange] - Принудительно обработать смену radio-группы

Boolean

Runtime-параметры для checkbox/toggle.

{boolean} [calcSize] - Пересчитать габариты/размеры после setValue

Number

Runtime-параметры для size.

{Function | null} [change=null] - Обработчик редактирования настройки

String

Базовые параметры настройки конфигуратора. Структура по умолчанию в Site3dConfiguratorSettingsItem.

{string} [width] - Ширина контрола в CSS

'number' | 'input' | 'inputNumber'

Параметры настроек с полем ввода (input/inputNumber/number).

{Function | null} [getRangeValue] - Кастомное отображение значения диапазона

'range'

Параметры настроек диапазона.

{string} [radio] - Имя radio-группы для взаимоисключения

'list' | 'tile' | 'radio' | 'checkBox' | 'toggle'

Параметры перечисляемых настроек (list/tile/radio/checkBox/toggle).

{boolean} [isInsideMode] - Режим встраивания панели цвета

'color'

Параметры цветовой настройки.

{number} step - Шаг диапазона

Boolean

Параметры настройки материала.

isEnabled - Включено ли отображение селектора wrap

Boolean

Параметры редактирования wrap у материала.

{string} unit - Единица измерения

Number

Параметры размера шрифта при генерации текстуры.

{string} color - Цвет текста

String

Параметры текста при генерации текстуры.

{Site3dConfiguratorSettingsMaterialCreateTextOptions} text - Параметры текстовой генерации

Boolean

Параметры генерации текстуры в настройке материала.

{boolean} [edited] - Материал был отредактирован пользователем

'material'

Параметры настройки материала.

{boolean} [setGeometry] - После выбора вызывать setGeometry

'model'

Параметры настройки модели.

{boolean} [isRepeatTexture] - Повторять текстуру при масштабе

'size'

Параметры размерной настройки.

{Function | null} [getContentInside] - Фабрика DOM/HTML внутри панели настройки

'custom'

Параметры кастомной настройки.

[additional=false] - Признак дополнительного режима рендера

Boolean

Дополнительные параметры рендера содержимого настройки.

[notClone=false] - Вернуть ссылку на исходный объект без клонирования

Boolean

Дополнительные параметры получения данных элемента списка настройки.

{boolean} [mirroredX] - Отражать fill по оси X

Number

Дополнительные параметры формирования fill-данных материала.

{Site3dConfiguratorActionData | null} [data] - Дополнительные данные picker-действия

String

Параметры действия конфигуратора. Структура по умолчанию в Site3dConfiguratorActionsItem.

{string} [backgroundImage]

String

Параметры создания текстуры.

[parent]

Map

Параметры выборки элементов конфигуратора.

[updatePrice]

Boolean

Параметры обновления блока стоимости.

[isLoadSettings]

Boolean

Данные загрузки элементов из сохранения.

{boolean} [isAllItems]

Boolean

Параметры поиска частей модели.

[isNotCancel]

Boolean

Параметры скрытия панели.

{Object.<string, Site3dConfiguratorActionsItemOptions> | undefined} [items]

Object. | undefined

Данные загрузки групп/элементов действий.

{Object.<string, Site3dConfiguratorActionsItemOptions>} [itemsActions]

Object.

Типы данных для getDataItems по имени секции.

[isAutoStart]

Boolean

Параметры добавления элемента в историю.

{string} [fileName] - Имя файла

Blob

Данные файла для отправки на сервер через FormData.

templatesPath

String

Путь к HTML-шаблонам

actionsPath

String

Путь к иконкам действий

texturesPath

String

Путь к текстурам

modelsPath

String

Путь к моделям

s3d

Site3d

Свойство возвращает объект сцены

options

Site3dConfiguratorOptions

Свойство возвращает параметры конфигуратора

name

String

Свойство возвращает название конфигуратора

path

String

Свойство возвращает путь до файлов конфигуратора

insertPlace

Site3dConfiguratorInsertPlace

Свойство возвращает место содержимого конфигуратора ({domElement: HTMLElement, where: string})

connectModelName

String

Свойство возвращает имя модели в сцене, к которой присоединяются элементы конфигуратора

priceList

Map

Свойство возвращает прайс-лист конфигуратора

buildLogic

Site3dConfiguratorBuildLogic

Свойство возвращает логику построения конфигуратора

priceInfo

Site3dConfiguratorPriceInfo

Свойство возвращает информацию о стоимости

orderInfo

Site3dConfiguratorOrderInfo

Свойство возвращает информацию для формы заказа конфигуратора

itemsInfo

Site3dConfiguratorItemInfo | Undefined

Свойство возвращает информацию по элементам конфигуратора (опция itemsInfo)

config

Site3dConfiguratorConfig | null

Свойство возвращает конфигурационные данные конфигуратора

data

Site3dConfiguratorData | null

Свойство возвращает данные конфигуратора

isMobile

Boolean

Свойство возвращает истину, если конфигуратор запущен на мобильном устройстве

isPortrait

Boolean

Свойство возвращает истину, если устройство находится в вертикальной ориентации

settings

Site3dConfiguratorSettings

Свойство возвращает настройки конфигуратора

settingsUpdated

Map

Свойство возвращает обновленные настройки во время обновления конфигуратора

actions

Site3dConfiguratorActions

Свойство возвращает действия конфигуратора

items

Map

Свойство возвращает элементы конфигуратора

model

Site3dModel

Свойство возвращает связующую модель конфигуратора

panels

Map

Свойство возвращает панели конфигуратора

panelControlsButton

HTMLElement

Свойство возвращает кнопку вызова панели управления конфигуратором

history

Site3dConfiguratorHistory

История действий конфигуратора

container

HTMLElement

Контейнер конфигуратора

isLoadingData

Boolean

Свойство возвращает истину, если конфигуратор загружается

isLoadDataCompleted

Boolean

Свойство возвращает истину, если конфигуратор загружен

isVisible

Boolean

Свойство возвращает видимость конфигуратора

isAnyItemOnChange

Boolean

Свойство возвращает истину, если какая-то настройка была запущена через интерфейс пользователя

panelControlsButtonClick

Site3dConfiguratorPanelControlsButtonClick | null

Свойство возвращает событие клика для кнопки показа и скрытия главных панелей управления