跳转到主要内容

可缩放图像

可缩放图像是能够绘制缩放版位图的控件。 只需更改控件的宽度/高度即可调整图像大小。 缩放图像的质量取决于使用的渲染算法。 可动态更改渲染算法。

Note
  • 该控件对MCU负载有很大影响。
  • 该控件不支持每像素1位的色深。
  • 在模拟器中运行的可缩放图像

    控件组

    可缩放图像位于 TouchGFX Designer 中的图像控件组中。控件

    TouchGFX Designer 中的可缩放图像

    属性

    TouchGFX Designer 中可缩放图像的属性。

    属性组属性说明
    名称控件的名称名称是TouchGFX Designer和代码中使用的唯一标识符
    位置XY 指定控件左上角相对于其父的位置。

    WH 指定控件的宽度和高度。

    锁定指定控件是否应锁定为其当前的X、Y、W和H。
    如果锁定控件,还会禁止通过屏幕与控件进行交互。

    可见 指定控件的可见性。 如果将控件标记为不可见,还会禁止通过屏幕与控件进行交互。
    样式样式 指定控件的预定义设置,用于将所选属性设为预定义的值。
    这些样式包含可免费使用的图像
    图像缩放算法指定缩放所选图像使用的算法。

    图像 指定控件应使用的图像。
    外观Alpha 指定控件的透明度。 控件的Alpha值介于0和255之间。 0表示完全透明,255表示不透明。
    Mixin可拖动 指定在运行时控件是否可拖动。

    ClickListener 指定控件被点击时是否会调用回调函数。

    FadeAnimator 指定控件是否可绘制其 Alpha 值变化的动画。

    MoveAnimator 指定控件是否可绘制 XY 值变化的动画。

    交互

    TouchGFX Designer 中的可缩放图像支持的操作和触发。

    操作

    控件特有的操作说明
    调整控件的尺寸调整控件的宽度和高度。
    标准控件操作说明
    移动控件随时间的推移将控件移动到新位置。
    渐隐控件随时间的推移改变控件的Alpha值。
    隐藏控件隐藏控件(将可见性设置为false)。
    显示控件使隐藏的控件可见(将可见性设置为true)。

    触发条件

    可缩放图像不会发出任何触发条件。

    性能

    可缩放图像主要靠 MCU 来缩放图像。 因此,在大部分平台上,会将可缩放图像视为高要求控件。

    关于绘制性能的更多信息,请阅读通用UI组件性能一节。

    示例

    生成代码

    在生成的视图基类的代码中,可以查看 Designer 是如何创建可缩放图像的。

    Screen1ViewBase.cpp
    #include <gui_generated/screen1_screen/Screen1ViewBase.hpp>
    #include "BitmapDatabase.hpp"

    Screen1ViewBase::Screen1ViewBase()
    {
    scalableImage.setBitmap(touchgfx::Bitmap(BITMAP_IMAGE_ID));
    scalableImage.setPosition(246, 36, 200, 200);
    scalableImage.setScalingAlgorithm(touchgfx::ScalableImage::NEAREST_NEIGHBOR);

    add(scalableImage);
    }

    void Screen1ViewBase::setupScreen()
    {

    }
    Tip
    可在用户代码中使用这些函数以及 ScalableImage 类中提供的其他函数。 如果更改控件的外观,请必须调用 scalableImage.invalidate() 强制进行重新绘制。

    TouchGFX Designer示例

    为了进一步了解可缩放图像,请尝试在 TouchGFX Designer 中使用下列 UI 模板之一创建新应用:

    TouchGFX Designer 中的缩放示例 UI 模板

    API参考