re_viewport_blueprint

Rust 3D视口蓝图库，提供高效视口布局与交互设计功能，是rerun系列crate的一部分。

该库提供了描述视口布局的数据模型。

安装

在项目目录中运行以下Cargo命令：

cargo add re_viewport_blueprint

或者在Cargo.toml中添加：

re_viewport_blueprint = "0.24.1"

示例代码

以下是一个基本使用示例，展示如何创建和配置视口布局：

use re_viewport_blueprint::ViewportBlueprint;
use re_viewport_blueprint::space_view::SpaceViewBlueprint;
use re_viewport_blueprint::viewport::ViewportComponent;

fn main() {
    // 创建一个新的视口蓝图
    let mut viewport_blueprint = ViewportBlueprint::default();
    
    // 添加一个空间视图
    let space_view = SpaceViewBlueprint::new("my_space_view".into());
    viewport_blueprint.add_space_view(space_view);
    
    // 配置视口组件
    viewport_blueprint.set_viewport_component(ViewportComponent {
        auto_layout: true,
        maximized: None,
        ..Default::default()
    });
    
    // 序列化视口配置
    let serialized = ron::to_string(&viewport_blueprint).unwrap();
    println!("Serialized viewport blueprint: {}", serialized);
    
    // 反序列化视口配置
    let deserialized: ViewportBlueprint = ron::from_str(&serialized).unwrap();
    println!("Deserialized space view count: {}", deserialized.space_views().count());
}

完整示例

以下是一个更完整的示例，展示如何创建多个空间视图并配置它们的布局：

use re_viewport_blueprint::{
    ViewportBlueprint, 
    SpaceViewBlueprint, 
    ViewportComponent,
    space_view::SpaceViewComponent,
    space_view::SpaceViewClass,
};

fn main() {
    // 创建视口蓝图
    let mut viewport = ViewportBlueprint::new();
    
    // 创建2D空间视图
    let mut space_view_2d = SpaceViewBlueprint::new("2d_view".into());
    space_view_2d.set_class(SpaceViewClass::TwoD);
    space_view_2d.set_component(SpaceViewComponent {
        visible: true,
        display_name: Some("2D View".into()),
        ..Default::default()
    });
    
    // 创建3D空间视图
    let mut space_view_3d = SpaceViewBlueprint::new("3d_view".into());
    space_view_3d.set_class(SpaceViewClass::ThreeD);
    space_view_3d.set_component(SpaceViewComponent {
        visible: true,
        display_name: Some("3D View".into()),
        ..Default::default()
    });
    
    // 添加空间视图到视口
    viewport.add_space_view(space_view_2d);
    viewport.add_space_view(space_view_3d);
    
    // 配置视口属性
    viewport.set_viewport_component(ViewportComponent {
        auto_layout: false,
        maximized: Some("3d_view".into()),
        layout_columns: 2,
        ..Default::default()
    });
    
    // 打印配置信息
    println!("Viewport configuration:");
    for (i, space_view) in viewport.space_views().enumerate() {
        println!("  Space View {}: {}", i, space_view.display_name().unwrap_or("Unnamed"));
    }
}

完整示例扩展

以下是一个更复杂的示例，展示如何创建带时间轴控制的3D视口：

use re_viewport_blueprint::{
    ViewportBlueprint,
    SpaceViewBlueprint,
    ViewportComponent,
    space_view::{SpaceViewComponent, SpaceViewClass},
    time_control::TimeControl,
};

fn main() {
    // 创建视口蓝图
    let mut viewport = ViewportBlueprint::new();
    
    // 创建主3D视图
    let mut main_3d_view = SpaceViewBlueprint::new("main_3d_view".into());
    main_3d_view.set_class(SpaceViewClass::ThreeD);
    main_3d_view.set_component(SpaceViewComponent {
        visible: true,
        display_name: Some("Main 3D View".into()),
        ..Default::default()
    });
    
    // 创建时间轴视图
    let mut timeline_view = SpaceViewBlueprint::new("timeline_view".into());
    timeline_view.set_class(SpaceViewClass::TimeSeries);
    timeline_view.set_component(SpaceViewComponent {
        visible: true,
        display_name: Some("Timeline".into()),
        ..Default::default()
    });
    
    // 添加视图到视口
    viewport.add_space_view(main_3d_view);
    viewport.add_space_view(timeline_view);
    
    // 配置时间控制
    let time_control = TimeControl {
        paused: false,
        speed: 1.0,
        time_range: None, // 自动检测
        ..Default::default()
    };
    
    // 配置视口属性
    viewport.set_viewport_component(ViewportComponent {
        auto_layout: false,
        maximized: None,
        layout_columns: 1,
        time_control: Some(time_control),
        ..Default::default()
    });
    
    // 打印最终配置
    println!("Advanced viewport configuration:");
    println!("Time control enabled: {}", viewport.viewport_component().time_control.is_some());
    for view in viewport.space_views() {
        println!(" - {}: {}", view.id(), view.display_name().unwrap_or("Unnamed"));
    }
}

文档

完整API文档请参考官方文档。

许可证

该项目采用MIT或Apache-2.0双重许可证。