摘要: Opticks4.11运行时配置；Opticks运行时自动访问一系列配置文件；加载默认部署文件(安装路径\Opticks\4.；加载默认配置文件(安装路径\Opticks\4.；注意1：用户配置文件中包含了默认配置文件的自定义；1、Opticks部署文件(.d...
Opticks4.11运行时配置；Opticks运行时自动访问一系列配置文件；加载默认部署文件(安装路径\Opticks\4.；加载默认配置文件(安装路径\Opticks\4.；注意1：用户配置文件中包含了默认配置文件的自定义；1、Opticks部署文件(.dep)；Opticks部署文件用于指定应用程序启动时所需；1.1部署文件中自定义路径（4个）；（1Opticks4.11运行时配置
Opticks运行时自动访问一系列配置文件：
加载默认部署文件(安装路径\Opticks\4.11.0\Bin\opticks.dep)，YAML格式，若默认部署文件不存在，则自动使用默认部署路径。
加载默认配置文件(安装路径\Opticks\4.11.0\DefaultSettings*.cfg)，XML格式。 加载用户配置文件(C:\Users\用户\AppData\Roaming\Opticks\UserSettings-4.11.0-Windows-x86-32.cfg)，XML格式。 加载最近使用(Most Recently Used , MRU)文件列表(C:\Users\用户\AppData\Roaming\Opticks\MruEntries-4.11.0-Windows-x86-32.xml)，XML格式。 写入日志文件(C:\Users\用户\AppData\Local\Temp{UUID}.log.gq####)，XML格式。 写入会话状态文件(C:\Users\用户\Opticks\AutoSave.session)，XML格式。
注意1：用户配置文件中包含了默认配置文件的自定义内容、会话状态的部分内容。 注意2：部分配置不能通过应用程序运行时界面进行设置，例如进度条是否自动关闭等。
1、Opticks部署文件(.dep)
Opticks部署文件用于指定应用程序启动时所需的自定义路径，若未指定自定义路径，则使用缺省路径。
1.1 部署文件中自定义路径（4个）
（1）AppHomePath : 应用程序主路径，缺省值为Opticks.exe的父目录。 若opticks.exe位于C:\Foo\Bar\Bin，则AppHomePath为C:\Foo\Bar。
（2）PlugInPath : 插件文件所在路径，缺省值为Opticks.exe父目录下PlugIns。 若opticks.exe位于C:\Foo\Bar\Bin，则PlugInPath为C:\Foo\Bar\PlugIns。
（3）UserConfigPath : 用户配置文件所在路径，缺省值Windows为"%APP_DATA%\Opticks"，Solaris为"$HOME/.opticks"。
（4）AdditionalDefaultPath : 除了缺省配置文件所在路径(AppHomePath/DefaultSettings)
之外，附加配置文件所在路径，没有缺省值，表示不需要在其它路径中搜索.cfg文件。
1.2 Opticks调用部署文件的方式（2种）
（1）Opticks自动调用默认部署文件opticks.dep，位于opticks.exe所在目录中。
（2）Opticks启动时使用命令行参数，参数包括deployment和部署文件名，要求部署文件名中包含完整路径，部署文件必须存在。
第二种方式比第一种方式优先。
Windows调用例子：
Opticks.exe /deployment:C:\FooBar\test.dep
OpticksBatch.exe /deployment:C:\FooBar\test.dep
Solaris调用例子：
Opticks -deployment:/FooBar/test.dep
Opticks -deployment:/FooBar/test.dep
1.3部署文件格式
（1）部署文件(.dep)采用YAML 1.2文件格式，开始必须为!depV1标记。
（2）部署文件必须包含根节点，根节点键为deployment，值为其他节点。
（3）部署文件仅支持4种路径节点，键分别为AppHomePath、PlugInPath、UserConfigPath、AdditionalDefaultPath，值为具体路径。
（4）路径节点个数是可选的（最多4个），可以需要自定义的路径节点。
（5）路径节点的顺序不重要，路径节点的值必须为路径，并且路径必须存在。
（6）路径中可以使用斜杠或反斜杠，如果路径中含有空格，使用单引号把路径括起来。
（7）通过$E()引用环境变量，路径可以为绝对路径或相对路径，相对路径是相对于部署文件(.dep)所在路径。
配置文件(.dep)例子1：
=================================================================
!depV1
Comment would go here
deployment:
AppHomePath: C:/FooBar PlugInPath: C:\FooBar UserConfigPath: 'C:\Path With\Spaces'
=================================================================
YAML语法还可以表示成单行形式，配置文件(.dep)例子2：
=================================================================
!depV1 { deployment: { PlugInPath: /FooBar, AppHomePath: /FooBar, UserConfigPath: /FooBar } }
=================================================================
配置文件(.dep)例子3：
=================================================================
!depV1
deployment:
AppHomePath: $E(MY_CUSTOM_ENVIRONMENT_VARIABLE_NAME_HERE) UserConfigPath: $E(ANOTHER_CUSTOM_ENV_VAR_NAME_HERE) AdditionalDefaultPath: ../../Relative/Path/Here
=================================================================
2、Opticks默认配置文件(.cfg)
默认配置文件用于指定应用程序运行时所需缺省选项配置，包括缺省图层设置、缺省窗体设置、缺省视图设置、缺省导入导出设置、缺省进度条设置等。
默认配置文件(.cfg)包括12个：
1-ApplicationDefaults.cfg
2-ApplicationMode.cfg
3-ApplicationTempDir.cfg
4-ClassificationSettings.cfg
40-PicturesExporters.cfg
41-MovieExporter.cfg
42-Nitf.cfg
43-IceExporter.cfg
44-AnnotationImagePalette.cfg
45-ConvolutionFilters.cfg
50-KmlServer.cfg
60-SpatialResampler.cfg
默认配置文件采用XML文件格式。
3、用户配置文件
用户配置文件用于保存和恢复应用程序运行时自定义选项配置，以及当前会话状态。
4、日志文件
日志文件用于保存消息、警告、错误等内容。
启动应用程序时自动创建两个日志文件，
关闭应用程序时自动删除一个日志文件，保留一个日志文件。
日志文件名随机生成。
5、会话状态文件
会话状态文件用于保存和恢复所有会话项的状态。
SessionItem(会话项)包括11类：
(1) Data Elements
(2) Windows
(3) Views
(4) Layers
(5) PlotSets
(6) Plot Widgets
(7) Animation Controllers
(8) Animations
(9) Modules
(10) PlugIn Descriptors
(11) PlugIn instances
SessionItem(会话项)分为4组：
（1）Windows
（2）Animations
（3）Elements
（4）Plug-Ins
会话状态内容保存为1个会话项索引文件和多个具体会话项文件：
================================================================= AutoSave.session 为会话项索引文件(XML格式)
AutoSave.sessionDir\
...
OpticksPlugInSampler.sessionItem 为会话项信息
OpticksPlugInSamplerHdf.sessionItem
...
=================================================================
