简体中文

下载 App

探索
探索
了解鸿蒙应用和多设备开发，学习如何构建应用/元服务
应用形态
HarmonyOS 应用
One as All，All as One
元服务
秒开直达服务随行无处不在
游戏
为游戏创意玩法带来无限可能
多设备应用开发
穿戴
折叠屏手机
鸿蒙电脑
开发者学堂
视频课程
Codelabs
设计
设计
了解鸿蒙应用和多设备开发，学习如何构建应用/元服务
开发
开发
获取官方开发工具和文档等资源，将创意转化为鸿蒙应用
开发工具
DevEco Studio
应用开发 IDE, AI Agent 和 CLI
小艺开放平台
Skill 和智能体开发平台
ArkTS
ArKUI
AppGallery Connect
DevEco Testing
开发资源
工具下载
示例代码
开发文档
最佳实践
分发
分发
通过华为应用市场发布你的应用，多渠道触达用户
应用分发
应用市场
纯净安全的全场景应用分发平台
游戏中心
应用审核政策
服务分发
小艺
HarmonyOS 的超级 AI 入口
智慧助手·今天
服务分发文档
内容分发
主题服务
内容分发文档
推广与变现
推广与变现
一站式流量增长与营销变现平台
推广
应用推广引擎
全链路应用推广与增长服务平台
鲸鸿动能广告
为企业广告主提供广告营销服务
联运服务
推广文档
变现
鲸鸿动能流量变现
使能应用展示广告，实现流量变现
应用内支付
变现文档
生态合作
生态合作
携手伙伴共建共享鸿蒙智能终端生态
伙伴 SDK
一站式获取安全可靠的鸿蒙伙伴 SDK
生态服务
鸿蒙应用开发、培训和人力服务
服务商伙伴中心
华为终端云服务商伙伴的统一门户
伙伴入驻指南
生态市场介绍，卖家和买家服务指引
廉洁政策
合作伙伴诚信廉洁政策
支持
支持
获取客服帮助、技术支持、活动资讯等信息
智能客服
24小时 AI 在线自助服务，即问即答
社区问答
在官方论坛提问，与开发者互动交流
在线提单
提交工单，获得技术支持
开发者活动
HDD 等线下活动速览及报名入口
资讯
帮助指南

输入关键字搜索

开发者能力认证

鸿蒙高校创新赛

HarmonyOS 7

animation

HarmonyOS行业解决方案

layoutWeight

HarmonyOS模板&组件

bindPopup

bindsheet

CTRL+K

文档管理中心

我的

Hello，

欢迎来到开发者联盟

Transform

更新时间: 2022-10-27 06:33

展开

Class Info
class Transform : public IComponent 坐标转换类，主要提供不同坐标系下向量平移、旋转和缩放功能，以及不同坐标间的转换矩阵。

Class Info

class Transform : public IComponent

坐标转换类，主要提供不同坐标系下向量平移、旋转和缩放功能，以及不同坐标间的转换矩阵。

Public Constructor Summary

展开

Constructor Name
Transform(SceneObject* sceneObject= nullptr) 构造函数。

Constructor Name

Transform(SceneObject* sceneObject= nullptr)

构造函数。

Public Destructor Summary

展开

Destructor Name
virtual ~Transform() 析构函数。

Destructor Name

virtual ~Transform()

析构函数。

Public Method Summary

展开

Qualifier and Type	Method Name and Description
void	Translate(const Vector3& translate) 局部坐标系下的平移变换。
void	Rotate(f32 angle, const Vector3& axis) 局部坐标系下的旋转变换，绕旋转轴axis旋转angle弧度。
void	Scale(const Vector3& scale) 局部坐标系下的缩放变换。
void	SetLocalPosition(const Vector3& position) 设置局部坐标系下，当前场景对象相对于父场景对象的位置。
void	SetLocalRotation(const Vector3& rotation) 设置当前场景对象在局部坐标系下的旋转向量（相对于父场景对象）。
void	SetLocalScale(const Vector3& scale) 设置当前场景对象在局部坐标系下的缩放向量（相对于父场景对象）。
void	SetWorldPosition(const Vector3& position) 设置当前场景对象在世界坐标系下的绝对位置。
void	SetWorldRotation(const Vector3& rotation) 设置当前场景对象在世界坐标系下的旋转向量。
void	SetWorldScale(const Vector3& scale) 设置当前场景对象在世界坐标系下的缩放向量。
const Vector3&	GetLocalPosition() const 获取局部坐标系下当前场景对象相对于父场景对象的位置。
const Vector3&	GetLocalRotation() const 获取当前场景对象在局部坐标系下的旋转向量（相对于父场景对象）。
const Vector3&	GetLocalScale() const 获取当前场景对象在局部坐标系下的缩放向量（相对于父场景对象）。
const Vector3&	GetWorldPosition() const 获取当前场景对象在世界坐标系下的绝对位置。
const Vector3&	GetWorldRotation() const 获取当前场景对象在世界坐标系下的旋转向量。
const Vector3&	GetWorldScale() const 获取当前场景对象在世界坐标系下的缩放向量。
const Matrix4&	GetLocalToWorldMatrix() const 获取局部坐标转换为世界坐标的转换矩阵。
bool	IsTransChanged() const 判断是否发生了平移变换。
void	ClearTransFlags() 清空坐标变换标志位。

Qualifier and Type

Method Name and Description

void

Translate(const Vector3& translate)

局部坐标系下的平移变换。

void

Rotate(f32 angle, const Vector3& axis)

局部坐标系下的旋转变换，绕旋转轴axis旋转angle弧度。

void

Scale(const Vector3& scale)

局部坐标系下的缩放变换。

void

SetLocalPosition(const Vector3& position)

设置局部坐标系下，当前场景对象相对于父场景对象的位置。

void

SetLocalRotation(const Vector3& rotation)

设置当前场景对象在局部坐标系下的旋转向量（相对于父场景对象）。

void

SetLocalScale(const Vector3& scale)

设置当前场景对象在局部坐标系下的缩放向量（相对于父场景对象）。

void

SetWorldPosition(const Vector3& position)

设置当前场景对象在世界坐标系下的绝对位置。

void

SetWorldRotation(const Vector3& rotation)

设置当前场景对象在世界坐标系下的旋转向量。

void

SetWorldScale(const Vector3& scale)

设置当前场景对象在世界坐标系下的缩放向量。

const

Vector3&

GetLocalPosition() const

获取局部坐标系下当前场景对象相对于父场景对象的位置。

const

Vector3&

GetLocalRotation() const

获取当前场景对象在局部坐标系下的旋转向量（相对于父场景对象）。

const

Vector3&

GetLocalScale() const

获取当前场景对象在局部坐标系下的缩放向量（相对于父场景对象）。

const

Vector3&

GetWorldPosition() const

获取当前场景对象在世界坐标系下的绝对位置。

const

Vector3&

GetWorldRotation() const

获取当前场景对象在世界坐标系下的旋转向量。

const

Vector3&

GetWorldScale() const

获取当前场景对象在世界坐标系下的缩放向量。

const

Matrix4&

GetLocalToWorldMatrix() const

获取局部坐标转换为世界坐标的转换矩阵。

bool

IsTransChanged() const

判断是否发生了平移变换。

void

ClearTransFlags()

清空坐标变换标志位。

Public Constructors

Transform

展开

Constructor
Transform(SceneObject* sceneObject= nullptr) 构造函数。

Constructor

Transform(SceneObject* sceneObject= nullptr)

构造函数。

Parameters

展开

Name	Description
sceneObject	指定初始化的场景对象。

Public Destructors

~Transform

展开

Destructor
virtual ~Transform() 析构函数。

Destructor

virtual ~Transform()

析构函数。

Public Methods

Translate

展开

Method
void Translate(const Vector3& translate) 局部坐标系下的平移变换。

Method

void Translate(const Vector3& translate)

局部坐标系下的平移变换。

Parameters

展开

Name	Description
translate	平移向量。

Rotate

展开

Method
void Rotate(f32 angle, const Vector3& axis) 局部坐标系下的旋转变换，绕旋转轴axis旋转angle弧度。

Method

void Rotate(f32 angle, const Vector3& axis)

局部坐标系下的旋转变换，绕旋转轴axis旋转angle弧度。

Parameters

展开

Name	Description
angle	旋转弧度。
axis	旋转轴。

Scale

展开

Method
void Scale(const Vector3& scale) 局部坐标系下的缩放变换。

Method

void Scale(const Vector3& scale)

局部坐标系下的缩放变换。

Parameters

展开

Name	Description
scale	缩放系数。

SetLocalPosition

展开

Method
void SetLocalPosition(const Vector3& position) 设置局部坐标系下，当前场景对象相对于父场景对象的位置。

Method

void SetLocalPosition(const Vector3& position)

设置局部坐标系下，当前场景对象相对于父场景对象的位置。

Parameters

展开

Name	Description
position	Vector3类型局部坐标系下待设置的位置。

SetLocalRotation

展开

Method
void SetLocalRotation(const Vector3& rotation) 设置当前场景对象在局部坐标系下的旋转向量（相对于父场景对象）。

Method

void SetLocalRotation(const Vector3& rotation)

设置当前场景对象在局部坐标系下的旋转向量（相对于父场景对象）。

Parameters

展开

Name	Description
rotation	Vector3类型局部坐标系下的待设置旋转向量。各分量的值为弧度。

SetLocalScale

展开

Method
void SetLocalScale(const Vector3& scale) 设置当前场景对象在局部坐标系下的缩放向量（相对于父场景对象）。

Method

void SetLocalScale(const Vector3& scale)

设置当前场景对象在局部坐标系下的缩放向量（相对于父场景对象）。

Parameters

展开

Name	Description
scale	Vector3类型局部坐标系下的待设置缩放向量。各分量的值为弧度。

SetWorldPosition

展开

Method
void SetWorldPosition(const Vector3& position) 设置当前场景对象在世界坐标系下的绝对位置。

Method

void SetWorldPosition(const Vector3& position)

设置当前场景对象在世界坐标系下的绝对位置。

Parameters

展开

Name	Description
position	Vector3类型给定世界坐标系下的位置。

SetWorldRotation

展开

Method
void SetWorldRotation(const Vector3& rotation) 设置当前场景对象在世界坐标系下的旋转向量。

Method

void SetWorldRotation(const Vector3& rotation)

设置当前场景对象在世界坐标系下的旋转向量。

Parameters

展开

Name	Description
rotation	Vector3类型给定世界坐标系下的旋转向量。各分量的值为弧度。

SetWorldScale

展开

Method
void SetWorldScale(const Vector3& scale) 设置当前场景对象在世界坐标系下的缩放向量。

Method

void SetWorldScale(const Vector3& scale)

设置当前场景对象在世界坐标系下的缩放向量。

Parameters

展开

Name	Description
scale	Vector3类型给定世界坐标系下的缩放向量。

GetLocalPosition

展开

Method
const Vector3& GetLocalPosition() const 获取局部坐标系下当前场景对象相对于父场景对象的位置。

Method

const Vector3& GetLocalPosition() const

获取局部坐标系下当前场景对象相对于父场景对象的位置。

Returns

展开

Type	Description
const Vector3&	返回局部坐标系下当前场景对象相对于父场景对象的位置。

GetLocalRotation

展开

Method
const Vector3& GetLocalRotation() const 获取当前场景对象在局部坐标系下的旋转向量（相对于父场景对象）。返回值各分量的值为弧度。

Method

const Vector3& GetLocalRotation() const

获取当前场景对象在局部坐标系下的旋转向量（相对于父场景对象）。返回值各分量的值为弧度。

Returns

展开

Type	Description
const Vector3&	返回当前场景对象在局部坐标系下的旋转向量（相对于父场景对象）。各分量的值为弧度。

GetLocalScale

展开

Method
const Vector3& GetLocalScale() const 获取当前场景对象在局部坐标系下的缩放向量（相对于父场景对象）。

Method

const Vector3& GetLocalScale() const

获取当前场景对象在局部坐标系下的缩放向量（相对于父场景对象）。

Returns

展开

Type	Description
const Vector3&	返回当前场景对象在局部坐标系下的缩放向量（相对于父场景对象）。

GetWorldPosition

展开

Method
const Vector3& GetWorldPosition() const 获取当前场景对象在世界坐标系下的绝对位置。

Method

const Vector3& GetWorldPosition() const

获取当前场景对象在世界坐标系下的绝对位置。

Returns

展开

Type	Description
const Vector3&	返回当前场景对象在世界坐标系下的绝对位置。

GetWorldRotation

展开

Method
const Vector3& GetWorldRotation() const 获取当前场景对象在世界坐标系下的旋转向量。返回值各分量的值为弧度。

Method

const Vector3& GetWorldRotation() const

获取当前场景对象在世界坐标系下的旋转向量。返回值各分量的值为弧度。

Returns

展开

Type	Description
const Vector3&	返回当前场景对象在世界坐标系下的旋转向量。各分量的值为弧度。

GetWorldScale

展开

Method
const Vector3& GetWorldScale() const 获取当前场景对象在世界坐标系下的缩放向量。

Method

const Vector3& GetWorldScale() const

获取当前场景对象在世界坐标系下的缩放向量。

Returns

展开

Type	Description
const Vector3&	返回当前场景对象在世界坐标系下的缩放向量。

GetLocalToWorldMatrix

展开

Method
const Matrix4& GetLocalToWorldMatrix() const 获取局部坐标转换为世界坐标的转换矩阵。

Method

const Matrix4& GetLocalToWorldMatrix() const

获取局部坐标转换为世界坐标的转换矩阵。

Returns

展开

Type	Description
const Matrix4&	局部坐标转换为世界坐标的转换矩阵。

IsTransChanged

展开

Method
bool IsTransChanged() const 判断是否进行了平移变换。

Method

bool IsTransChanged() const

判断是否进行了平移变换。

Returns

展开

Type	Description
bool	true：进行平移变换。 false：未进行平移变换。

ClearTransFlags

展开

Method
void ClearTransFlags() 清空坐标变换标志位。

Method

void ClearTransFlags()

清空坐标变换标志位。

TouchInputEvent

TweenManager

意见反馈

以上内容对您是否有帮助？

意见反馈

如果您有其他疑问，您也可以通过开发者社区问答频道来和我们联系探讨。

社区提问智能客服提问

在 API参考中进行搜索

只在 Class Summary 中搜索只搜索章节标题

请输入您想要搜索的关键词