VertexElement — Aspose.3D Python API Reference

Pakej: aspose.threed.entities (aspose-3d-foss 26.1.0)

VertexElement adalah kelas asas abstrak untuk semua lapisan data per-vertex yang boleh dilampirkan kepada satu Geometry objek. Setiap lapisan menyimpan satu tatasusunan nilai data bersama dengan mapping_mode dan reference_mode metadata yang menerangkan bagaimana data dipetakan ke atas geometri asas. Subkelas khusus untuk normal, koordinat UV, warna vertex, tangent, binormal, dan kumpulan pelicinan.

Properties

from aspose.threed.entities import VertexElement

Properties

VertexElement

Properties

Properties

VertexElementNormal

Menyimpan vektor normal permukaan. Data normal biasanya digunakan oleh renderer untuk pengiraan pencahayaan.

from aspose.threed.entities import VertexElementNormal

Properties

VertexElement → VertexElementFVector → VertexElementNormal

Properties

VertexElementNormal(name="", mapping_mode=None, reference_mode=None)

vertex_element_type ditetapkan kepada VertexElementType.NORMAL.

Mengembalikan: VertexElementUV

Menyimpan koordinat tekstur UV. Sesebuah mesh boleh membawa pelbagai lapisan UV untuk saluran tekstur yang berbeza.

from aspose.threed.entities import VertexElementUV

Properties

VertexElement → VertexElementFVector → VertexElementUV

Properties

VertexElementUV(texture_mapping=None, name="", mapping_mode=None, reference_mode=None)

Kembalikan Mesh baru di mana setiap poligon telah dibahagikan kepada segitiga menggunakan triangulasi kipas. Mesh asal tidak diubah. Berguna sebelum mengeksport ke format yang memerlukan geometri hanya segitiga (seperti STL atau beberapa pipeline glTF).

add_data(data)

Tambah data koordinat UV. Menerima list[Vector2], list[Vector3], list[FVector2], list[FVector3], atau list[FVector4]. Semua nilai disimpan secara dalaman sebagai FVector4 dengan komponen yang tidak digunakan ditetapkan kepada 0.0.

VertexElementVertexColor

Menyimpan nilai warna RGBA per-vertex dalam julat 0–1.

from aspose.threed.entities import VertexElementVertexColor

Properties

VertexElement → VertexElementFVector → VertexElementVertexColor

Properties

VertexElementVertexColor(name="", mapping_mode=None, reference_mode=None)

vertex_element_type ditetapkan kepada VertexElementType.VERTEX_COLOR.

VertexElementTangent

Menyimpan vektor tangent per-vertex atau per-sudut, digunakan untuk rendering peta normal.

from aspose.threed.entities import VertexElementTangent

Properties

VertexElement → VertexElementFVector → VertexElementTangent

vertex_element_type ditetapkan kepada VertexElementType.TANGENT.

VertexElementBinormal

Menyimpan vektor binormal (bitangent) per-vertex atau per-corner, melengkapkan VertexElementTangent untuk tangent-space normal mapping.

from aspose.threed.entities import VertexElementBinormal

Properties

VertexElement → VertexElementFVector → VertexElementBinormal

vertex_element_type ditetapkan kepada VertexElementType.BINORMAL.

VertexElementSmoothingGroup

Menyimpan per-polygon integer smoothing group IDs. Dimuatkan dari fail OBJ yang mengandungi s pengisytiharan.

from aspose.threed.entities import VertexElementSmoothingGroup

Properties

VertexElement → VertexElementIntsTemplate → VertexElementSmoothingGroup

vertex_element_type ditetapkan kepada VertexElementType.SMOOTHING_GROUP.

Enumerasi VertexElementType

Mengenal pasti peranan semantik lapisan elemen vertex.

from aspose.threed.entities import VertexElementType

Enumerasi MappingMode

Mengawal primitif geometri mana setiap nilai elemen vertex dikaitkan.

from aspose.threed.entities import MappingMode

Enumerasi ReferenceMode

Mengawal cara susunan data diindeks.

from aspose.threed.entities import ReferenceMode

Properties

Lampirkan lapisan normal ke mesh (DIRECT mapping):

from aspose.threed import Scene
from aspose.threed.entities import Mesh, VertexElementType, MappingMode, ReferenceMode, VertexElementNormal
from aspose.threed.utilities import Vector4, FVector4

mesh = Mesh()
mesh.control_points.append(Vector4(0.0, 0.0, 0.0, 1.0))
mesh.control_points.append(Vector4(1.0, 0.0, 0.0, 1.0))
mesh.control_points.append(Vector4(0.5, 1.0, 0.0, 1.0))
mesh.create_polygon(0, 1, 2)

normals: VertexElementNormal = mesh.create_element(
    VertexElementType.NORMAL,
    MappingMode.CONTROL_POINT,
    ReferenceMode.DIRECT,
)
normals.set_data([
    FVector4(0.0, 0.0, 1.0, 0.0),
    FVector4(0.0, 0.0, 1.0, 0.0),
    FVector4(0.0, 0.0, 1.0, 0.0),
])

scene = Scene()
scene.root_node.create_child_node("tri", mesh)
scene.save("triangle_normals.glb")

Lampirkan koordinat UV (INDEX_TO_DIRECT mapping):

from aspose.threed import Scene
from aspose.threed.entities import Mesh, TextureMapping, MappingMode, ReferenceMode
from aspose.threed.utilities import Vector4, FVector4

mesh = Mesh()
for x, z in [(0, 0), (1, 0), (1, 1), (0, 1)]:
    mesh.control_points.append(Vector4(float(x), 0.0, float(z), 1.0))
mesh.create_polygon(0, 1, 2, 3)

uv = mesh.create_element_uv(
    TextureMapping.DIFFUSE,
    MappingMode.POLYGON_VERTEX,
    ReferenceMode.INDEX_TO_DIRECT,
)
uv.set_data([
    FVector4(0.0, 0.0, 0.0, 0.0),
    FVector4(1.0, 0.0, 0.0, 0.0),
    FVector4(1.0, 1.0, 0.0, 0.0),
    FVector4(0.0, 1.0, 0.0, 0.0),
])
uv.set_indices([0, 1, 2, 3])

scene = Scene()
scene.root_node.create_child_node("quad", mesh)
scene.save("quad_uv.glb")

Lihat Juga

• Rujukan kelas Mesh
• Rujukan kelas FVector
• Rujukan Enumerasi