VertexElement — Aspose.3D Python API Reference

الحزمة: aspose.threed.entities (aspose-3d-foss 26.1.0)

VertexElement هي الفئة الأساسية المجردة لجميع طبقات بيانات كل رأس التي يمكن إرفاقها بـ Geometry كائن. تحتفظ كل طبقة بمصفوفة من قيم البيانات مع mapping_mode و reference_mode metadata التي تصف كيفية ربط البيانات بالهندسة الأساسية. الفئات الفرعية متخصصة للـnormals، UV coordinates، vertex colours، tangents، binormals، وsmoothing groups.

Methods

from aspose.threed.entities import VertexElement

Methods

VertexElement

Methods

Methods

VertexElementNormal

يخزن متجهات السطح العمودية. عادةً ما تُستخدم بيانات المتجهات العمودية من قبل المُعالجين لحساب الإضاءة.

from aspose.threed.entities import VertexElementNormal

Methods

VertexElement → VertexElementFVector → VertexElementNormal

Methods

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

vertex_element_type مُثَبَّت على VertexElementType.NORMAL.

VertexElementUV

يخزن إحداثيات القوام UV. قد يحمل النموذج عدة طبقات UV لقنوات قوام مختلفة.

from aspose.threed.entities import VertexElementUV

Methods

VertexElement → VertexElementFVector → VertexElementUV

Methods

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

خاصية إضافية

add_data(data)

إلحاق بيانات إحداثيات UV. يقبل list[Vector2], list[Vector3], list[FVector2], list[FVector3], أو list[FVector4]. جميع القيم تُخزن داخليًا كـ FVector4 مع تعيين المكونات غير المستخدمة إلى 0.0.

VertexElementVertexColor

يخزن قيم ألوان RGBA لكل رأس في النطاق 0–1.

from aspose.threed.entities import VertexElementVertexColor

Methods

VertexElement → VertexElementFVector → VertexElementVertexColor

Methods

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

vertex_element_type ثابت على VertexElementType.VERTEX_COLOR.

VertexElementTangent

يخزن متجهات الظل لكل رأس أو لكل ركن، تُستخدم في عرض خريطة العادي.

from aspose.threed.entities import VertexElementTangent

Methods

VertexElement → VertexElementFVector → VertexElementTangent

vertex_element_type ثابت على VertexElementType.TANGENT.

VertexElementBinormal

يخزن متجهات الباينورمال (البيتانجينت) لكل رأس أو لكل زاوية، مكملة VertexElementTangent لـ tangent-space normal mapping.

from aspose.threed.entities import VertexElementBinormal

Methods

VertexElement → VertexElementFVector → VertexElementBinormal

vertex_element_type مُثَبَّت على VertexElementType.BINORMAL.

VertexElementSmoothingGroup

يخزن معرفات مجموعة التنعيم الصحيحة لكل مضلع. يتم تحميلها من ملفات OBJ التي تحتوي على s الإعلانات.

from aspose.threed.entities import VertexElementSmoothingGroup

Methods

VertexElement → VertexElementIntsTemplate → VertexElementSmoothingGroup

vertex_element_type مُثَبَّت على VertexElementType.SMOOTHING_GROUP.

تعداد VertexElementType

يحدد الدور الدلالي لطبقة عنصر الرأس.

from aspose.threed.entities import VertexElementType

تعداد MappingMode

يتحكم في أي بدائية هندسية يرتبط كل قيمة لعنصر الرأس.

from aspose.threed.entities import MappingMode

تعداد ReferenceMode

يتحكم في طريقة فهرسة مصفوفة البيانات.

from aspose.threed.entities import ReferenceMode

Methods

إرفاق طبقة عادية إلى شبكة (تعيين DIRECT):

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")

إرفاق إحداثيات UV (تخطيط INDEX_TO_DIRECT):

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")

انظر أيضًا

• مرجع فئة Mesh
• مرجع فئات FVector
• مرجع التعدادات