在 Preview 中编辑您的应用程序。

创建和定位2D节点,创建和编辑 Text Block 节点,添加触发器,创建和定位 Camera 节点,并在 Preview 周围缩放和平移。

要在 Preview 中编辑您的应用程序,请使用 Preview 工具。

../../_images/edit-mode.png

Preview 工具

您可以使用以下工具编辑工程中的内容:

工具

控件

描述 (Description)

快捷键

../../_images/node-tool.png

使用 Node tool 选择任何节点。

../../_images/move.png

移动选定的节点。

1

../../_images/rotate.png

旋转选定的节点。

2

../../_images/scale.png

缩放选定的节点。

3

../../_images/align.png

单击正方形以将选定的2D节点对齐到该侧。 例如,此图像中的设置将 Vertical Alignment 属性设置为 Top,将 Horizontal Alignment 属性设置为 Left。

../../_images/horizontal-stretch.png

将选定的2D节点水平拉伸。将 Horizontal Alignment 属性设置为 Stretch。

../../_images/vertical-stretch.png

垂直拉伸所选的2D节点。将 Vertical Alignment 属性设置为 Stretch。

image7

水平和垂直拉伸所选的2D节点。将 Horizontal Alignment 和 Vertical Alignment 属性设置为 Stretch。

image8

使用 Layout Transformation 属性字段放置所选节点。对于2D节点,输入 X 和 Y 属性字段的值。请参阅 优化布局的渲染。

image9

使用 Render Transformation 属性字段放置所选节点。对于 2D 节点,输入 X 和 Y 属性字段的值。请参阅 优化布局的渲染。

image10

使用 Layout Height 和 Layout Width 属性设置所选二维节点的大小。

image11

将选定的 2D 节点的尺寸或位置与周围节点最近的坐标对齐。

image12

使用 Layout Transformation 或 Render Transformation 属性的 Scale 来设置所选节点的大小。

image13

使用世界坐标定位选定的 3D 节点。

image14

使用本地坐标定位选定的 3D 节点。

image15

Grid Layout 2D tool。在 Preview 中单击并拖动以创建一个 Grid Layout 2D。您创建的区域大小定义了布局的大小(Layout Width 和 Layout Height)。请参阅 使用 Grid Layout 节点。

image16

Text Block 2D tool。在 Preview 中单击并拖动以创建一个 Text Block 2D。您创建的区域大小定义了布局的大小(Layout Width 和 Layout Height)。请参阅 使用 Text Block 节点。

image17

输入 Text Block 2D 显示的文本。

image18

单击正方形以将文本对齐到该侧。 例如,此图像中的设置将 Text Vertical Alignment 属性设置为 Top,将 Text Horizontal Alignment 属性设置为 Left。

image19

选择您要用于 Text Block 2D 节点的设备无关像素中的字体大小。

image20

选择您要用于 Text Block 2D 节点的字体。请注意,下拉菜单仅列出您当前项目中的字体。请参阅 导入字体。

image21

Stack Layout 2D tool。在 Preview 中单击并拖动以创建一个 Stack Layout 2D。您创建的区域大小定义了布局的大小(Layout Width 和 Layout Height)。要设置 Stack Layout 2D 沿 x 轴或 y 轴排列其项目,请在您希望 Stack Layout 2D 排列其项目的轴上创建一个较长的区域。请参阅 使用 Stack Layout 节点。

image22

Flow Layout 2D tool。在 Preview 中单击并拖动以创建一个 Flow Layout 2D。您创建的区域大小定义了布局的大小(Layout Width 和 Layout Height)。请参阅 使用 Flow Layout 节点。

image23

使用 Camera tool 使用预览相机在场景中移动,并在项目中创建和定位相机。请参阅 使用 Camera 节点。

小技巧

在 Preview 窗口中使用 Node tool 时,您可以控制 Camera 节点的位置。

要使用 Orbit Camera 移动,请按住 Alt 并使用以下控件:

  • 点击鼠标左键并拖动以旋转。

  • 点击鼠标中键并拖动以平移。

  • 滚动鼠标滚轮以缩放。

要使用 Free Camera 移动,请按住鼠标右键并使用以下控件:

  • 移动鼠标以向任意方向倾斜和旋转摄像机角度。

  • 使用 W、S、A 和 D 将摄像机位置向前、向后、向左和向右移动。

  • 使用 E 和 Q 将摄像机位置向上和向下移动。

  • 滚动鼠标滚轮设置摄像机速度。

  • 移动时按住 Shift 以加倍速度。

  • 使用 F 将摄像机引入在 Preview 中选择的 3D 对象

小技巧

要放置:

  • 节点到 Preview 中 Camera 当前视图的位置,在 Node Tree 中右键单击该节点,然后选择 Align With View。

  • Preview 视图到任意节点的位置,在 Node Tree 中右键单击该节点,然后选择 Align View To Selected。

例如,要将 Camera 节点放置到 Scene 节点中任意节点的位置:

  1. 右键单击您要将 Camera 节点放置到其位置的节点,然后选择 Align View To Selected。

  2. 要将该位置存储到 Camera,右键单击 Camera,然后选择 Align With View。

../../_images/node-tree-align-view-align-to-selected.png

image24

将摄像机的当前位置存储到预览 Camera 节点。

image25

将摄像机重置为预览 Camera 节点的当前位置。

image26

从相机的当前位置创建一个新的 Camera 节点。

J

image27

Orbit Camera 允许您移动:

  • 您在 Node Tree 中选择的节点。

  • 您使用相机的 Constraints > Look At 属性设置的节点。

image28

Free Camera 允许您在不依附于任何点的情况下移动。

image29

将摄像机引入在 Node Tree 或 Preview 中选择的 3D 对象。

image30

选择您想通过其查看当前场景的 Camera 节点。

image31

使用 3D 节点时,以度为单位设置摄像机的视野。

在 Preview 中平移和缩放。

要在 Preview 中平移和缩放:

动作

快捷键

平移

点击鼠标中键并拖动。

缩放

  • 使用 Preview 右上角的控件:

    ../../_images/adjust-the-preview-zoom-level.png
  • 滚动鼠标滚轮。

  • 按下 Shift 和 Alt 键,然后单击并拖动鼠标左键。

在 Preview 中重置视图

当您想将 Preview 缩放级别返回到 100% 并将您的应用程序屏幕置于 Preview 的中心时,单击 image32 或按下 Ctrl 1 以重置 Preview 中的视图。

../../_images/view-in-the-preview-needs-resetting.png ../../_images/view-in-the-preview-position-and-zoom-reset.png

截取预览的屏幕截图

使用 Screenshot 按钮 image33 捕获应用程序在 Preview 中显示的当前视图。这对于产品验证、文档或用作工程缩略图等非常有用。

在 User Preferences > Advanced 选项卡中设置:

  • 保存屏幕截图的 Default Screenshot location。

  • Screenshot background options,用于控制如何填充图像的背景。

    • Without Background 以透明背景截取屏幕截图。

    • With Screen Clear Color 以屏幕清除颜色 (Screen Clear Color) 作为背景截取屏幕截图。

    ../../_images/preview-screenshot-user-preferences.png

    备注

    仅当背景笔刷 (Background Brush) 和前景笔刷 (Foreground Brush) 属性设置为 NullBrush 和 No Brush 时,Screenshot background options 才会生效。否则,将使用节点的 Brush 属性中定义的背景笔刷填充屏幕截图背景。

  • 要截取 Preview 窗口中当前视图的屏幕截图,请单击 Screenshot image33 按钮。

    ../../_images/preview-screenshot-button.png

    Status Bar 中的消息表示已成功截取屏幕截图。图像以 png 文件形式保存在您在 User Preferences 中设置的位置,文件名由工程名称和日期时间戳组成。

在 Preview 中设置抗锯齿。

默认情况下,Windows 上的 Kanzi Studio Preview 和 Kanzi Application Player 使用 4 个样本应用抗锯齿。对于这两者,您可以配置要使用的抗锯齿数量。

如果您有一个 Kanzi 应用程序和一个 C++ 应用程序,要在 Kanzi Studio Preview 和 Kanzi Application Player 中以与在目标设备上运行 Kanzi 应用程序相同的方式查看您的内容,可以在 application.cfg 文件中设置抗锯齿。请参阅 对整个应用程序应用抗锯齿。

要在没有 C++ 应用程序的 Kanzi 应用程序中设置 Kanzi Studio Preview 的抗锯齿:

  1. 在 Kanzi Studio 主菜单中,选择 Project > Properties。在 Preview 部分的 Properties 中,将 Preview Working Directory 属性的值设置为您要存储 application.cfg 的目录,以配置 Preview。

    例如,将 Preview Working Directory 属性设置为 Application Player。这样,您可以将相同的抗锯齿设置应用于 Windows 上的 Preview 和 Kanzi Application Player。如果 <ProjectName>/Application Player 目录尚不存在,请选择 File > Export > Export as KZB Player for Windows。请参阅 从 Kanzi Studio 构建和部署 Kanzi 应用程序到 Windows。。

    ../../_images/project-properties-myproject.png ../../_images/preview-working-dir-application-player.png
  2. 在您在上一步中设置的目录中,创建或打开 application.cfg 文件。添加并将 SurfaceSamplesAntialiasing 参数设置为您希望 Preview 使用的抗锯齿采样数。

    例如,要在 Preview 中禁用抗锯齿,在 application.cfg 中添加:

    SurfaceSamplesAntialiasing = 0
    
  3. 在 Kanzi Studio 中,重启 Preview。

    ../../_images/preview-restart-button-gray.png

另请参阅

在 Preview 中分析您的应用程序

控制 Preview

使用 Camera 节点

预览 (Preview)

使用标尺和参考线

应用抗锯齿功能