Optionalconflict同名处理:rename 自动追加数字后缀(默认),error 拒绝冲突;均不覆盖已有资源。
Optionalfile可读取的 file:// 或 content:// 文件 URI;省略时打开系统文件选择器。外部 URI 须具有读取权限。
Optionalgenerate是否补齐内部金字塔以改善缩小显示;默认值:false。生成过程会增加导入时间与资源大小。
Optionalname目标资源名称;省略时使用文件名或包内名称。不能包含路径分隔符或文件名非法字符。
Optionalon仅回调本次调用的阶段;回调抛错不会终止导入。
Optionalpyramid新增层级的采样方法:nearest 保留邻近像素值(默认),average 取邻域平均值;不会重新采样已有层级。
Optionalsignal通过 AbortController.abort() 请求取消。已取消的信号不会启动导入。 提交前取消不会登记资源,Promise 在原生处理停止并清理后以 CANCELLED 拒绝。 部分复制/解析阶段会在下一检查点停止,系统文件选择器可能仍需手动关闭。 已完成提交的任务返回成功;取消不会删除已提交资源。
TIFF / GeoTIFF 影像导入参数。
原始文件不会被修改。开启金字塔时在工作空间内的副本中补齐缺失的内部缩略层级; 已有且可用的内部金字塔保持不变,外部 .ovr 不作为可复用的内部金字塔。 小影像可能无需生成缩略层级。完整分辨率像素、坐标系、NoData 与透明信息保持不变。