C#开发BIMFACE系列28 服务端API之获取模型数据13:获取三维视点或二维视图列表
本篇主要介绍如何获取一个模型中包含的三维视点或二维视图列表。
请求地址:GET https://api.bimface.com/data/v2/files/{fileId}/views
说明:获取单模型中包含的三维视点或二维视图列表。
参数:

请求 path(示例):https://api.bimface.com/data/v2/files/1211223382064960/views
请求 header(示例):"Authorization: Bearer dc671840-bacc-4dc5-a134-97c1918d664b"
HTTP响应示例(200):
{
"code" : "success",
"data" : [ {
"cropBox" : [ -12147.804809235151, -19279.554054815613, -30480.0, 22637.545576143948, 6805.089759789783, 30480.0 ],
"elevation" : 0.0,
"id" : "",
"levelId" : "",
"name" : "Level 1",
"outline" : [ -146.52900292249365, -215.01048476685295, 240.3331231070219, 110.78415780710446 ],
"preview" : {
"height" : ,
"path" : "path",
"width" :
},
"thumbnails" : [ "m.bimface.com/9b711803a43b92d871cde346b63e5019/resource/thumbnails/312/312.96x96.png" ],
"viewPoint" : {
"origin" : [ 0.0 ],
"rightDirection" : [ 0.0 ],
"scale" : ,
"upDirection" : [ 0.0 ],
"viewDirection" : [ 0.0 ]
},
"viewType" : "FloorPlain"
} ],
"message" : ""
}
该返回结果的结构比较复杂,封装成如下的C#类
/// <summary>
/// 获取三维视点或二维视图列表的返回结果类
/// </summary>
[Serializable]
public class SingleModelViews : GeneralResponse<List<ViewInfo>>
{ }
引用的 ViewInfo 类
/// <summary>
/// 三维视点或二维视图
/// </summary>
[Serializable]
public class ViewInfo
{
/// <summary>
/// 样例:[ -12147.804809235151, -19279.554054815613, -30480.0, 22637.545576143948, 6805.089759789783, 30480.0 ]
/// </summary>
[JsonProperty("cropBox")]
public double?[] CropBox { get; set; } /// <summary>
/// 样例:0.0
/// </summary>
[JsonProperty("elevation")]
public double? Elevation { get; set; } /// <summary>
/// 样例:"312"
/// </summary>
[JsonProperty("id")]
public string Id { get; set; } /// <summary>
/// 样例:"312"
/// </summary>
[JsonProperty("levelId")]
public string LevelId { get; set; } /// <summary>
/// 样例:[ -146.52900292249365, -215.01048476685295, 240.3331231070219, 110.78415780710446 ]
/// </summary>
[JsonProperty("outline")]
public double?[] Outline { get; set; } [JsonProperty("preview")]
public Preview Preview { get; set; } /// <summary>
/// 缩略图数组。样例:[ "m.bimface.com/9b711803a43b92d871cde346b63e5019/resource/thumbnails/312/312.96x96.png" ]
/// </summary>
[JsonProperty("thumbnails")]
public string[] Thumbnails { get; set; } [JsonProperty("viewPoint")]
public ViewPoint ViewPoint { get; set; } [JsonProperty("viewType")]
public string ViewType { get; set; } /// <summary>返回表示当前对象的字符串。</summary>
/// <returns>表示当前对象的字符串。</returns>
public override string ToString()
{
return string.Format("[cropBox={0}, elevation={1}, width={2}, Id={2}, levelId={3}, Outline={4}, preview={5}, thumbnails={6}, viewPoint={7}, viewType={8}]",
CropBox.ToStringWith(","), Elevation, Id, LevelId, Outline.ToStringWith(","), Preview, Thumbnails.ToStringWith(","), ViewPoint, ViewType);
}
}
其中引用的 Preview 类
[Serializable]
public class Preview
{
/// <summary>
/// 样例:0
/// </summary>
[JsonProperty("height")]
public int? Height { get; set; } [JsonProperty("path")]
public string Path { get; set; } /// <summary>
/// 样例:0
/// </summary>
[JsonProperty("width")]
public int? Width { get; set; } /// <summary>返回表示当前对象的字符串。</summary>
/// <returns>表示当前对象的字符串。</returns>
public override string ToString()
{
return string.Format("[height={0}, path={1}, width={2}]",
Height, Path, Width);
}
}
ViewPoint 类
[Serializable]
public class ViewPoint
{
/// <summary>
/// 样例 : [ 0.0 ]
/// </summary>
[JsonProperty("origin")]
public double?[] Origin { get; set; } /// <summary>
/// 样例 : [ 0.0 ]
/// </summary>
[JsonProperty("rightDirection")]
public double?[] RightDirection { get; set; } /// <summary>
/// 样例 : [ 0.0 ]
/// </summary>
[JsonProperty("scale")]
public int? Scale { get; set; } /// <summary>
/// 样例 : [ 0.0 ]
/// </summary>
[JsonProperty("upDirection")]
public double?[] UpDirection { get; set; } /// <summary>
/// 样例 : [ 0.0 ]
/// </summary>
[JsonProperty("viewDirection")]
public double?[] ViewDirection { get; set; } /// <summary>返回表示当前对象的字符串。</summary>
/// <returns>表示当前对象的字符串。</returns>
public override string ToString()
{
return String.Format("[origin={0}, rightDirection={1}, scale={2}, upDirection={3}, viewDirection={4}]",
Origin.ToStringWith(","), RightDirection.ToStringWith(","), Scale, UpDirection.ToStringWith(","),
ViewDirection.ToStringWith(","));
}
}
C#实现方法:
/// <summary>
/// 获取三维视点或二维视图列表
/// </summary>
/// <param name="accessToken">【必填】令牌</param>
/// <param name="fileId">【必填】代表该单模型的文件ID</param>
/// <returns></returns>
public virtual SingleModelViews GetSingleModelViews(string accessToken, long fileId)
{
// GET https://api.bimface.com/data/v2/files/{fileId}/views
string url = string.Format(BimfaceConstants.API_HOST + "/data/v2/files/{0}/views", fileId); BimFaceHttpHeaders headers = new BimFaceHttpHeaders();
headers.AddOAuth2Header(accessToken); try
{
SingleModelViews response; HttpManager httpManager = new HttpManager(headers);
HttpResult httpResult = httpManager.Get(url);
if (httpResult.Status == HttpResult.STATUS_SUCCESS)
{
response = httpResult.Text.DeserializeJsonToObject<SingleModelViews>();
}
else
{
response = new SingleModelViews
{
Message = httpResult.RefText
};
} return response;
}
catch (Exception ex)
{
throw new Exception("[获取楼层对应面积分区列表]发生异常!", ex);
}
}
其中调用到的 httpManager.Get() 方法,请参考《C# HTTP系列》
在BIMFACE的控制台中可以看到我们上传的文件列表,模型状态均为转换成功。

使用“bimface_2018_mdv_room.rvt”为例测试上述方法。

完整的视图列表为
success [fileId=,
portAndViews=,
viewInfo=[cropBox=-30479.998046875,-30479.998046875,-,30479.998046875,30479.998046875,-30.4799995422363,
elevation=,
width=,
Id=,
levelId=,
Outline=2.49999989974552,-0.999999959964061,842.499966258321,592.999976250742,
preview=[height=,
path=m.bimface.com/6bd2057ac6d8072ad03758b0b34e205d/resource/thumbnails//.png,
width=
],
thumbnails=m.bimface.com/6bd2057ac6d8072ad03758b0b34e205d/resource/thumbnails//.96x96.png,
viewPoint=[origin=,,,
rightDirection=,,,
scale=,
upDirection=,,,
viewDirection=,,
],
viewType=DrawingSheet
]
] [fileId=, portAndViews=, viewInfo=[cropBox=-30479.998046875,-30479.998046875,-,30479.998046875,30479.998046875,-30.4799995422363, elevation=, width=, Id=, levelId=, Outline=2.49999989974552,-0.999999959964061,842.499966258321,592.999976250742, preview=[height=, path=m.bimface.com/6bd2057ac6d8072ad03758b0b34e205d/resource/thumbnails//.png, width=], thumbnails=m.bimface.com/6bd2057ac6d8072ad03758b0b34e205d/resource/thumbnails//.96x96.png, viewPoint=[origin=,,, rightDirection=,,, scale=, upDirection=,,, viewDirection=,,], viewType=DrawingSheet]]
[fileId=, portAndViews=, viewInfo=[cropBox=-30479.998046875,-30479.998046875,-,30479.998046875,30479.998046875,-30.4799995422363, elevation=, width=, Id=, levelId=, Outline=2.49999989974552,-0.999999959964061,842.499966258321,592.999976250742, preview=[height=, path=m.bimface.com/6bd2057ac6d8072ad03758b0b34e205d/resource/thumbnails//.png, width=], thumbnails=m.bimface.com/6bd2057ac6d8072ad03758b0b34e205d/resource/thumbnails//.96x96.png, viewPoint=[origin=,,, rightDirection=,,, scale=, upDirection=,,, viewDirection=,,], viewType=DrawingSheet]]
[fileId=, portAndViews=, viewInfo=[cropBox=-30479.998046875,-30479.998046875,-,30479.998046875,30479.998046875,-30.4799995422363, elevation=, width=, Id=, levelId=, Outline=2.49999989974552,-0.999999959964061,842.499966258321,592.999976250742, preview=[height=, path=m.bimface.com/6bd2057ac6d8072ad03758b0b34e205d/resource/thumbnails//.png, width=], thumbnails=m.bimface.com/6bd2057ac6d8072ad03758b0b34e205d/resource/thumbnails//.96x96.png, viewPoint=[origin=,,, rightDirection=,,, scale=, upDirection=,,, viewDirection=,,], viewType=DrawingSheet]]
[fileId=, portAndViews=, viewInfo=[cropBox=-30479.998046875,-30479.998046875,-,30479.998046875,30479.998046875,-30.4799995422363, elevation=, width=, Id=, levelId=, Outline=2.49999989974552,-0.999999959964061,842.499966258321,592.999976250742, preview=[height=, path=m.bimface.com/6bd2057ac6d8072ad03758b0b34e205d/resource/thumbnails//.png, width=], thumbnails=m.bimface.com/6bd2057ac6d8072ad03758b0b34e205d/resource/thumbnails//.96x96.png, viewPoint=[origin=,,, rightDirection=,,, scale=, upDirection=,,, viewDirection=,,], viewType=DrawingSheet]]
[fileId=, portAndViews=, viewInfo=[cropBox=-30479.998046875,-30479.998046875,-,30479.998046875,30479.998046875,-30.4799995422363, elevation=, width=, Id=, levelId=, Outline=2.49999989974552,-73.1185993073838,842.499966258321,592.999976250742, preview=[height=, path=m.bimface.com/6bd2057ac6d8072ad03758b0b34e205d/resource/thumbnails//.png, width=], thumbnails=m.bimface.com/6bd2057ac6d8072ad03758b0b34e205d/resource/thumbnails//.96x96.png, viewPoint=[origin=,,, rightDirection=,,, scale=, upDirection=,,, viewDirection=,,], viewType=DrawingSheet]]
[fileId=, portAndViews=, viewInfo=[cropBox=-30479.998046875,-30479.998046875,-,30479.998046875,30479.998046875,-30.4799995422363, elevation=, width=, Id=, levelId=, Outline=2.49999989974552,-0.999999959964061,842.499966258321,592.999976250742, preview=[height=, path=m.bimface.com/6bd2057ac6d8072ad03758b0b34e205d/resource/thumbnails//.png, width=], thumbnails=m.bimface.com/6bd2057ac6d8072ad03758b0b34e205d/resource/thumbnails//.96x96.png, viewPoint=[origin=,,, rightDirection=,,, scale=, upDirection=,,, viewDirection=,,], viewType=DrawingSheet]]
[fileId=, portAndViews=, viewInfo=[cropBox=-30479.998046875,-30479.998046875,-,30479.998046875,30479.998046875,-30.4799995422363, elevation=, width=, Id=, levelId=, Outline=2.49999989974552,-0.999999959964061,842.499966258321,592.999976250742, preview=[height=, path=m.bimface.com/6bd2057ac6d8072ad03758b0b34e205d/resource/thumbnails//.png, width=], thumbnails=m.bimface.com/6bd2057ac6d8072ad03758b0b34e205d/resource/thumbnails//.96x96.png, viewPoint=[origin=,,, rightDirection=,,, scale=, upDirection=,,, viewDirection=,,], viewType=DrawingSheet]]
[fileId=, portAndViews=, viewInfo=[cropBox=-30479.998046875,-30479.998046875,-,30479.998046875,30479.998046875,-30.4799995422363, elevation=, width=, Id=, levelId=, Outline=2.49999989974552,-0.999999959964061,842.499966258321,592.999976250742, preview=[height=, path=m.bimface.com/6bd2057ac6d8072ad03758b0b34e205d/resource/thumbnails//.png, width=], thumbnails=m.bimface.com/6bd2057ac6d8072ad03758b0b34e205d/resource/thumbnails//.96x96.png, viewPoint=[origin=,,, rightDirection=,,, scale=, upDirection=,,, viewDirection=,,], viewType=DrawingSheet]]
测试代码如下:
// 获取三维视点或二维视图列表
protected void btnGetSingleModelViews_Click(object sender, EventArgs e)
{
long fileId = txtFileID.Text.Trim().ToLong();
FileConvertApi api = new FileConvertApi();
SingleModelViews response = api.GetSingleModelViews(txtAccessToken.Text, fileId); txtResult.Text = response.Code.ToString2()
+ Environment.NewLine
+ response.Message.ToString2()
+ Environment.NewLine
+ response.Data.ToStringLine();
}
C#开发BIMFACE系列28 服务端API之获取模型数据13:获取三维视点或二维视图列表的更多相关文章
- C#开发BIMFACE系列45 服务端API之创建离线数据包
BIMFACE二次开发系列目录 [已更新最新开发文章,点击查看详细] BIMFACE的常规应用方式有公有云与私有化部署两种方式,并且浏览模型或者图纸需要使用ViewToken,ViewToke ...
- C#开发BIMFACE系列46 服务端API之离线数据包下载及结构详解
BIMFACE二次开发系列目录 [已更新最新开发文章,点击查看详细] 在前一篇博客<C#开发BIMFACE系列45 服务端API之创建离线数据包>中通过调用接口成功的创建一个离线数 ...
- C#开发BIMFACE系列40 服务端API之模型集成
BIMFACE二次开发系列目录 [已更新最新开发文章,点击查看详细] 随着建筑信息化模型技术的发展,越来越多的人选择在云端浏览建筑模型.现阶段的云端模型浏览大多是基于文件级别,一次只可以浏览一 ...
- C#开发BIMFACE系列41 服务端API之模型对比
BIMFACE二次开发系列目录 [已更新最新开发文章,点击查看详细] 在建筑施工图审查系统中,设计单位提交设计完成的模型/图纸,审查专家审查模型/图纸.审查过程中如果发现不符合规范的地方,则流 ...
- C#开发BIMFACE系列42 服务端API之图纸对比
BIMFACE二次开发系列目录 [已更新最新开发文章,点击查看详细] 在我的前一篇博客<C#开发BIMFACE系列42 服务端API之图纸对比>中详细介绍了BIMFACE服务端接口 ...
- C#开发BIMFACE系列43 服务端API之图纸拆分
BIMFACE二次开发系列目录 [已更新最新开发文章,点击查看详细] 在上一篇博客<C#开发BIMFACE系列42 服务端API之图纸对比>的最后留了一个问题,在常规业务场景下,一 ...
- C#开发BIMFACE系列44 服务端API之计算图纸对比差异项来源自哪个图框
BIMFACE二次开发系列目录 [已更新最新开发文章,点击查看详细] 在前两篇博客<C#开发BIMFACE系列42 服务端API之图纸对比>.<C#开发BIMFACE系列43 ...
- C#开发BIMFACE系列6 服务端API之获取文件信息
在<C#开发BIMFACE系列4 服务端API之源上传文件>.<C#开发BIMFACE系列5 服务端API之文件直传>两篇文章中详细介绍了如何将本地文件上传到BIMFACE服务 ...
- C#开发BIMFACE系列4 服务端API之源上传文件
在注册成为BIMFACE的应用开发者后,要能在浏览器里浏览你的模型或者获取你模型内的BIM数据, 首先需要把你的模型文件上传到BIMFACE.根据不同场景,BIMFACE提供了丰富的文件相关的接口. ...
随机推荐
- 在Dynamics CRM中使用Bootstrap
我是微软Dynamics 365 & Power Platform方面的工程师罗勇,也是2015年7月到2018年6月连续三年Dynamics CRM/Business Solutions方面 ...
- Kingfisher
Kingfisher ima1.kf.setImage(with: url) 为了兼容macOS, IOS 通过协议定义了kf,实际上就是本身 KingfisherOptionsInfo 可以配置一些 ...
- ORA-16032和ORA-07286 LOG_ARCHIVE_DEST_1没生效
主备切换在备库startup时出现归档路径没写到spfile里...注意:修改参数时最好带上scope=spfile或scope=both,以免重启出现异常.SQL> startup mount ...
- Navicat 软件的使用以及pymysql
Navicat 软件的使用以及pymysql 一.navicate的安装及使用 下载 直接百度搜索navicate ,如下图 连接数据库 新建数据库以及新建表 选中然后鼠标右键 建模 利用navica ...
- Mac录制或保存视频后如何放大?
想要在录制和拍摄视频后在喜欢的场景(例如Mark)中放大视频吗?本文将向您展示如何放大视频并通过裁剪视频和“平移和缩放”效果来制作Ken Burns效果.Filmora9是一款功能强大的视频编辑器,具 ...
- Mac中 pip3 install mysqlclient 报错
主要错误提示如下: ld: library not found for -lssl clang: error: linker command failed with exit code 1 (use ...
- linux 执行 javac 报错 javac: command not found
bash: javac: command not found java 版本 1.8 [root@localhost home]# java -version openjdk version &quo ...
- Orcl分页查询的语法示例
Orcle分页查询SQL sql = SELECT T.* FROM (SELECT X.*, ROWNUM AS RN FROM (SELECT * FROM +表名) X WHERE ROWNU ...
- Vue父子组件数据双向绑定,子组件可修改props
第一种,子组件通过监听父组件数据,子组件改变数据之后通知给父组件 原文链接:https://blog.csdn.net/m0_37728716/article/details/81776929 父组件 ...
- angularjs路由监听,uirouter感知路由变化,解决uirouter路由监听不生效的问题
壹 ❀ 引 angularjs除了惊为天人的双向数据绑定外,路由也是出彩的一笔,通过路由配置,我们能在不发起页面跳转的情况下,对当前页内容进行整体更新,angularjs提供了ngRoute模块用于 ...