harmony 鸿蒙SceneType

  • 2025-06-12
  • 浏览 (3)

SceneType

本模块提供3D图形中常用的数据类型。

说明： - 本模块首批接口从API version 12开始支持，后续版本的新增接口，采用上角标标记接口的起始版本。

导入模块

import { Vec2, Vec3, Vec4, Quaternion, Aabb, Color, Rect, GeometryType, PrimitiveTopology, CustomGeometry, CubeGeometry, PlaneGeometry, SphereGeometry, Position3, Rotation3, Scale3 } from '@kit.ArkGraphics3D';

Vec2

二维向量，通常用于表示2D空间中的点或方向，由x和y两个分量组成。

系统能力： SystemCapability.ArkUi.Graphics3D |名称|类型|只读|可选|说明| |—-|—-|—-|—-|—-| |x|number|否|否|x轴分量，取值范围是实数。| |y|number|否|否|y轴分量，取值范围是实数。|

Vec3

三维向量，通常用于表示3D空间中的点、方向或向量变换，由x、y和z三个分量组成。

系统能力： SystemCapability.ArkUi.Graphics3D |名称|类型|只读|可选|说明| |—-|—-|—-|—-|—-| |x|number|否|否|x轴分量，取值范围是实数。| |y|number|否|否|y轴分量，取值范围是实数。| |z|number|否|否|z轴分量，取值范围是实数。|

Vec4

四维向量，通常用于表示4D空间中的点、方向或向量变换，由x、y、z和w四个分量组成，增加第四个分量为各种计算和变换增加了规整性和便捷性。

系统能力： SystemCapability.ArkUi.Graphics3D |名称|类型|只读|可选|说明| |—-|—-|—-|—-|—-| |x|number|否|否|x轴分量，取值范围是实数。| |y|number|否|否|y轴分量，取值范围是实数。| |z|number|否|否|z轴分量，取值范围是实数。| |w|number|否|否|w轴分量，取值范围是实数。|

Quaternion

用于表示3D空间中旋转的数学结构。与传统的欧拉角相比，四元数在数值稳定性和避免万向节锁方面具有优势。

系统能力： SystemCapability.ArkUi.Graphics3D |名称|类型|只读|可选|说明| |—-|—-|—-|—-|—-| |x|number|否|否|x轴分量，取值范围是实数。| |y|number|否|否|y轴分量，取值范围是实数。| |z|number|否|否|z轴分量，取值范围是实数。| |w|number|否|否|w轴分量，取值范围是实数。|

Aabb

轴对齐边界盒，主要用于判断空间中的物体是否重叠。

系统能力： SystemCapability.ArkUi.Graphics3D |名称|类型|只读|可选|说明| |—-|—-|—-|—-|—-| |aabbMin|Vec3|否|否|轴对齐边界盒的小值点。| |aabbMax|Vec3|否|否|轴对齐边界盒的大值点。|

Color

用于表示RGBA格式的颜色，包含四个分量，依次为红色、绿色、蓝色和透明度。

系统能力： SystemCapability.ArkUi.Graphics3D |名称|类型|只读|可选|说明| |—-|—-|—-|—-|—-| |r|number|否|否|红色分量，取值范围是[0, 1]。| |g|number|否|否|绿色分量，取值范围是[0, 1]。| |b|number|否|否|蓝色分量，取值范围是[0, 1]。| |a|number|否|否|透明度分量，取值范围是[0, 1]。|

Rect

用于表示平面中的矩形。

系统能力： SystemCapability.ArkUi.Graphics3D |名称|类型|只读|可选|说明| |—-|—-|—-|—-|—-| |x|number|否|否|矩形左下角x轴分量，取值范围是实数。| |y|number|否|否|矩形左下角y轴分量，取值范围是实数。| |width|number|否|否|矩形宽度，有效取值范围大于0。| |height|number|否|否|矩形高度，有效取值范围大于0。|

GeometryType18+

几何类型枚举，用于指定不同的几何类型。

系统能力： SystemCapability.ArkUi.Graphics3D

名称 值 说明
CUSTOM 0 未定义类型。
CUBE 1 立方体类型。
PLANE 2 平面类型。
SPHERE 3 球体类型。

GeometryDefinition18+

几何类型定义抽象类，用于解释特定几何类型的属性。

系统能力： SystemCapability.ArkUi.Graphics3D |名称|类型|只读|可选|说明| |—-|—-|—-|—-|—-| |geometryType|GeometryType|是|否|定义不同的几何类型。|

PrimitiveTopology18+

图元拓扑枚举，在顶点处理过程中，指定顶点的不同处理方式。

系统能力： SystemCapability.ArkUi.Graphics3D

名称 值 说明
TRIANGLE_LIST 0 由不相交的顶点集合构成不同的三角形。
TRIANGLE_STRIP 1 每个顶点和前一个三角形的一条边构成新的三角形。

CustomGeometry18+

自定义几何类型，继承自GeometryDefinition。

系统能力： SystemCapability.ArkUi.Graphics3D

名称 类型 只读 可选 说明
topology PrimitiveTopology 否 是 三角形图元的解析方式，默认值为TRIANGLE_LIST。
vertices Vec3[] 否 否 模型的顶点数组。
indices number[] 否 是 顶点索引数组，数组中元素的取值范围大于等于0，默认值为undefined。
normals Vec3[] 否 是 顶点数组对应的法向量数组，默认值为undefined。
uvs Vec2[] 否 是 顶点数组对应的UV坐标数组，默认值为undefined。
colors Color[] 否 是 顶点数组对应的颜色数组，默认值为undefined。

CubeGeometry18+

立方体几何类型，继承自GeometryDefinition。

系统能力： SystemCapability.ArkUi.Graphics3D

名称 类型 只读 可选 说明
size Vec3 否 否 立方体的宽、高和深度，表示立方体的大小。

PlaneGeometry18+

平面几何类型，继承自GeometryDefinition。

系统能力： SystemCapability.ArkUi.Graphics3D

名称 类型 只读 可选 说明
size Vec2 否 否 平面的宽、高，表示平面的大小。

SphereGeometry18+

球体几何类型，继承自GeometryDefinition。

系统能力： SystemCapability.ArkUi.Graphics3D

名称 类型 只读 可选 说明
radius number 否 否 球体半径，取值范围大于0。
segmentCount number 否 否 在球体上以经纬度分割的段数，取值范围大于0。

Position3

type Position3 = Vec3

用于表示3维空间中物体的位置，是Vec3类型。

系统能力： SystemCapability.ArkUi.Graphics3D

类型 说明
Vec3 类型为三维向量，可取任意值。

Rotation3

type Rotation3 = Vec3

用于表示3维空间中物体的旋转，是Vec3类型。

系统能力： SystemCapability.ArkUi.Graphics3D

类型 说明
Vec3 类型为三维向量，可取任意值。

Scale3

type Scale3 = Vec3

用于表示3维空间中物体的缩放，是Vec3类型。

系统能力： SystemCapability.ArkUi.Graphics3D

类型 说明
Vec3 类型为三维向量，可取任意值。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙ArkGraphics 3D（方舟3D图形）

harmony 鸿蒙SceneNode

harmony 鸿蒙ScenePostProcessSettings

harmony 鸿蒙SceneResource

harmony 鸿蒙Scene

harmony 鸿蒙@ohos.graphics.scene (ArkGraphics 3D模块)

0  赞
  • 所属分类： 后端技术
  • 本文标签：
  • 版权声明： 原创文章如转载，请注明本文链接: https://m.seaxiang.com/blog/nJMiIR
热门推荐
标签云
Linux Java Spring Spring Boot docker 大数据 前端 生活 maven golang 软件 spring cloud fintech mac vscode 其他 区块链 以太坊 V神 开发者 技术 股票 git greenplum 分布式事务 chrome mysql flink kafka 设计模式 原理 鸿蒙 seo
最新文章
本文目录