Interface MainViewConfig

主视图配置接口

interface MainViewConfig {
    appname?: string;
    version?: string;
    wasmServiceUrl?: string;
    serviceUrl?: string;
    workspace?: string;
    accessToken?: string;
    accessKey?: string;
    fonts?: {
        path: string;
        name?: string;
        kind?: "ttf" | "woff" | "otf" | "shx";
    }[];
    closeDocOnOpen?: boolean;
    plugins?: PluginConfig[];
    pluginMarketUrl?: string;
    docUrl?: string;
    sidebarStyle?: "left"
    | "right"
    | "none"
    | "both";
    viewMode?: "full" | "viewer";
    showMenuBar?: boolean;
    showToolBar?: boolean;
    showDocBar?: boolean;
    showCoordsBar?: boolean;
    showCommandLine?: boolean;
    showBottomBar?: boolean;
    enableContextMenu?: boolean;
    showGrips?: boolean;
    showUcsIcon?: boolean;
    showAxis?: boolean;
    backgroundAlpha?: number;
    showCrosshair?: boolean;
    disablePointerEvents?: boolean;
    themeMode?: number;
}

Properties

`Optional`appname

appname?: string

`Optional`version

version?: string

`Optional`wasmServiceUrl

wasmServiceUrl?: string

`Optional`serviceUrl

serviceUrl?: string

`Optional`workspace

workspace?: string

`Optional`accessToken

accessToken?: string

`Optional`accessKey

accessKey?: string

`Optional`fonts

fonts?: { path: string; name?: string; kind?: "ttf" | "woff" | "otf" | "shx" }[]

`Optional`closeDocOnOpen

closeDocOnOpen?: boolean

打开图纸时关闭当前文档（单文档打开模式）

true（默认）: 打开新图纸时先关闭当前文档，节省内存
- 新建文档不受影响，可以正常增加文档数量
false: 打开新图纸时保留当前文档（传统方式）

`Optional`plugins

plugins?: PluginConfig[]

插件配置列表 - 启动时自动加载的插件

Example

plugins: [
  { url: '/plugins/find-replace/plugin.js' },
  { url: 'https://example.com/my-plugin.js', cssUrl: 'https://example.com/my-plugin.css' }
]

`Optional`pluginMarketUrl

pluginMarketUrl?: string

服务端插件市场地址

访问此地址可获取服务端插件市场的插件列表（JSON格式）。自动加载的插件会在程序启动时自动下载并加载。

Example

pluginMarketUrl: "http://127.0.0.1:8082/plugins.json"

`Optional`docUrl

docUrl?: string

官方文档地址

点击顶栏右侧的文档按钮时打开此地址。默认为 https://www.vjmap.com

Example

docUrl: "https://www.vjmap.com/docs"

`Optional`sidebarStyle

sidebarStyle?: "left" | "right" | "none" | "both"

侧边栏样式

控制侧边栏的初始显示位置：

"both": 左右两侧都显示
"left": 只显示左侧
"right": 只显示右侧（默认）
"none": 不显示侧边栏

Example

sidebarStyle: "none" // 初始不显示侧边栏

`Optional`viewMode

viewMode?: "full" | "viewer"

视图模式

控制 UI 组件的显示：

"full": 完整模式，显示所有 UI 组件（默认）
"viewer": 查看模式，只显示绘图区域，隐藏菜单、工具栏、命令行等

viewer 模式适用于只需要查看和选择实体的场景，可通过 SDK 获取选中实体信息。

Example

viewMode: "viewer" // 只显示绘图区域

`Optional`showMenuBar

showMenuBar?: boolean

是否显示菜单栏（细粒度控制）默认 true。设为 false 时隐藏菜单栏。

`Optional`showToolBar

showToolBar?: boolean

是否显示工具栏/Ribbon（细粒度控制）默认 true。设为 false 时隐藏工具栏。

`Optional`showDocBar

showDocBar?: boolean

是否显示文档栏（细粒度控制）默认 true。设为 false 时隐藏文档标签栏。

`Optional`showCoordsBar

showCoordsBar?: boolean

是否显示坐标栏（细粒度控制）默认 true。设为 false 时隐藏坐标栏。

`Optional`showCommandLine

showCommandLine?: boolean

是否显示命令行（细粒度控制）默认 true。设为 false 时隐藏命令行。

`Optional`showBottomBar

showBottomBar?: boolean

是否显示底部状态栏（细粒度控制）默认 true。设为 false 时隐藏底部状态栏。

`Optional`enableContextMenu

enableContextMenu?: boolean

是否启用右键菜单（细粒度控制）默认 true。设为 false 时禁用右键菜单。 viewer 模式下默认禁用。

`Optional`showGrips

showGrips?: boolean

是否显示选择夹点（细粒度控制）默认 true。设为 false 时选择实体后不显示夹点。 viewer 模式下默认禁用（防止通过夹点拖动修改实体）。

`Optional`showUcsIcon

showUcsIcon?: boolean

是否显示左下角的坐标轴图标（UCS 图标）默认 true。设为 false 时隐藏左下角的坐标轴指示器。

`Optional`showAxis

showAxis?: boolean

是否显示图中绘制的坐标轴默认 true。设为 false 时隐藏图中绘制的坐标轴。

`Optional`backgroundAlpha

backgroundAlpha?: number

背景透明度 (0-1) 默认 1（不透明）。设为 0 可实现透明背景，用于图层叠加场景。

`Optional`showCrosshair

showCrosshair?: boolean

是否显示十字光标默认 true。设为 false 时隐藏十字光标和拾取框。

`Optional`disablePointerEvents

disablePointerEvents?: boolean

是否禁用鼠标事件（允许事件穿透）默认 false。设为 true 时 canvas 不接收鼠标事件，用于图层叠加场景。

`Optional`themeMode

themeMode?: number

主题模式 0=深色（默认），1=浅色。影响实体默认颜色等。

Interface MainViewConfig

Index

Properties

Properties

`Optional`appname

`Optional`version

`Optional`wasmServiceUrl

`Optional`serviceUrl

`Optional`workspace

`Optional`accessToken

`Optional`accessKey

`Optional`fonts

`Optional`closeDocOnOpen

`Optional`plugins

Example

`Optional`pluginMarketUrl

Example

`Optional`docUrl

Example

`Optional`sidebarStyle

Example

`Optional`viewMode

Example

`Optional`showMenuBar

`Optional`showToolBar

`Optional`showDocBar

`Optional`showCoordsBar

`Optional`showCommandLine

`Optional`showBottomBar

`Optional`enableContextMenu

`Optional`showGrips

`Optional`showUcsIcon

`Optional`showAxis

`Optional`backgroundAlpha

`Optional`showCrosshair

`Optional`disablePointerEvents

`Optional`themeMode

Settings

On This Page

Interface MainViewConfig

Index

Properties

Properties

Optionalappname

Optionalversion

OptionalwasmServiceUrl

OptionalserviceUrl

Optionalworkspace

OptionalaccessToken

OptionalaccessKey

Optionalfonts

OptionalcloseDocOnOpen

Optionalplugins

Example

OptionalpluginMarketUrl

Example

OptionaldocUrl

Example

OptionalsidebarStyle

Example

OptionalviewMode

Example

OptionalshowMenuBar

OptionalshowToolBar

OptionalshowDocBar

OptionalshowCoordsBar

OptionalshowCommandLine

OptionalshowBottomBar

OptionalenableContextMenu

OptionalshowGrips

OptionalshowUcsIcon

OptionalshowAxis

OptionalbackgroundAlpha

OptionalshowCrosshair

OptionaldisablePointerEvents

OptionalthemeMode

Settings

On This Page

`Optional`appname

`Optional`version

`Optional`wasmServiceUrl

`Optional`serviceUrl

`Optional`workspace

`Optional`accessToken

`Optional`accessKey

`Optional`fonts

`Optional`closeDocOnOpen

`Optional`plugins

`Optional`pluginMarketUrl

`Optional`docUrl

`Optional`sidebarStyle

`Optional`viewMode

`Optional`showMenuBar

`Optional`showToolBar

`Optional`showDocBar

`Optional`showCoordsBar

`Optional`showCommandLine

`Optional`showBottomBar

`Optional`enableContextMenu

`Optional`showGrips

`Optional`showUcsIcon

`Optional`showAxis

`Optional`backgroundAlpha

`Optional`showCrosshair

`Optional`disablePointerEvents

`Optional`themeMode