Aspose.3D FOSS
TypeScript
VertexElement

VertexElement — Aspose.3D TypeScript API Reference

Pacote: @aspose/3d (v24.12.0)

VertexElement é a classe base abstrata para canais de atributos por vértice anexados a um Geometry. Cada canal contém um array de dados tipado e mappingMode / referenceMode metadados que controlam como os dados se relacionam com primitivas de geometria. As subclasses são: VertexElementNormal, VertexElementUV, e VertexElementVertexColor.

import { VertexElement, VertexElementNormal, VertexElementUV, VertexElementVertexColor } from '@aspose/3d';

ImageRenderOptions 

export abstract class VertexElement implements IIndexedVertexElement

ImageRenderOptions 

constructor(
  elementType: VertexElementType,
  name: string = '',
  mappingMode: MappingMode | null = null,
  referenceMode: ReferenceMode | null = null,
)

ImageRenderOptions mappingMode é MappingMode.CONTROL_POINT; padrão referenceMode é ReferenceMode.DIRECT.

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptionsImageRenderOptions
vertexElementTypeVertexElementTypeleituraTipo semântico desta camada.
namestringleitura/gravaçãoRótulo opcional para esta camada.
mappingModeMappingModeleitura/gravaçãoControla qual primitivo de geometria cada valor está associado.
referenceModeReferenceModeleitura/gravaçãoControla se os valores são endereçados diretamente ou por meio de um array de índices.
indicesnumber[]leituraArray de índices para IndexToDirect modo de referência.

ImageRenderOptions

setIndices(data)

NOT IMPLEMENTED. Na base VertexElement classe, este método lança Error('set_indices is not implemented') em tempo de execução. As subclasses VertexElementFVector e VertexElementIntsTemplate fornecem implementações funcionais.

Substitui o array de índices.

setIndices(data: number[]): void

clear()

NOT IMPLEMENTED. Na classe base VertexElement classe, este método lança Error('clear is not implemented') em tempo de execução. As subclasses VertexElementFVector e VertexElementIntsTemplate fornecem implementações funcionais.

Remove todos os dados e índices da camada.

clear(): void

VertexElementNormal

Armazena vetores normais de superfície. Dados de normais são necessários para a maioria dos renderizadores para iluminação correta.

export class VertexElementNormal extends VertexElementFVector

ImageRenderOptions

VertexElement → VertexElementFVector → VertexElementNormal

ImageRenderOptions 

new VertexElementNormal(
  name: string = '',
  mappingMode: MappingMode | null = null,
  referenceMode: ReferenceMode | null = null,
)

vertexElementType é fixado em VertexElementType.NORMAL.

VertexElementUV

Armazena coordenadas de textura 2D. Uma malha pode conter múltiplas camadas UV para diferentes canais de textura. O textureMapping propriedade identifica o propósito do canal.

export class VertexElementUV extends VertexElementFVector

ImageRenderOptions

VertexElement → VertexElementFVector → VertexElementUV

ImageRenderOptions 

new VertexElementUV(
  textureMapping: TextureMapping | null = null,
  name: string = '',
  mappingMode: MappingMode | null = null,
  referenceMode: ReferenceMode | null = null,
)

Padrão é TextureMapping.DIFFUSE quando textureMapping é null.

Propriedade adicional

ImageRenderOptionsImageRenderOptionsImageRenderOptionsImageRenderOptions
textureMappingTextureMappinglerO canal de textura ao qual esta camada UV está associada.
dataFVector4[]lerValores UV expostos como FVector4 entradas (z e w são 0).
uvDataFVector2[]lerValores UV como FVector2 entradas (apenas x, y).

addData(data)

Anexar valores UV. Aceita FVector2[], FVector3[], ou FVector4[].

addData(data: FVector2[] | FVector3[] | FVector4[]): void

VertexElementVertexColor

Armazena valores de cor RGBA por vértice. Os componentes estão no intervalo 0–1.

export class VertexElementVertexColor extends VertexElementFVector

ImageRenderOptions

VertexElement → VertexElementFVector → VertexElementVertexColor

ImageRenderOptions 

new VertexElementVertexColor(
  name: string = '',
  mappingMode: MappingMode | null = null,
  referenceMode: ReferenceMode | null = null,
)

vertexElementType é fixado em VertexElementType.VERTEX_COLOR.

ImageRenderOptions

Adicionar normais a uma malha triangular:

import { Scene, Mesh, Vector4, VertexElementType, MappingMode, ReferenceMode, FVector4 } from '@aspose/3d';

const mesh = new Mesh();
mesh.controlPoints.push(new Vector4(0, 0, 0, 1));
mesh.controlPoints.push(new Vector4(1, 0, 0, 1));
mesh.controlPoints.push(new Vector4(0.5, 1, 0, 1));
mesh.createPolygon(0, 1, 2);

const normals = mesh.createElement(
  VertexElementType.NORMAL,
  MappingMode.CONTROL_POINT,
  ReferenceMode.DIRECT,
);
normals.setData([
  new FVector4(0, 0, 1, 0),
  new FVector4(0, 0, 1, 0),
  new FVector4(0, 0, 1, 0),
]);

const scene = new Scene();
scene.rootNode.createChildNode('tri', mesh);
scene.save('triangle_normals.glb');

Adicionar coordenadas UV:

import { Scene, Mesh, Vector4, TextureMapping, MappingMode, ReferenceMode, FVector2 } from '@aspose/3d';

const mesh = new Mesh();
for (const [x, z] of [[0,0],[1,0],[1,1],[0,1]]) {
  mesh.controlPoints.push(new Vector4(x, 0, z, 1));
}
mesh.createPolygon(0, 1, 2, 3);

const uv = mesh.createElementUV(TextureMapping.DIFFUSE, MappingMode.CONTROL_POINT, ReferenceMode.DIRECT);
uv.addData([
  new FVector2(0, 0),
  new FVector2(1, 0),
  new FVector2(1, 1),
  new FVector2(0, 1),
]);

const scene = new Scene();
scene.rootNode.createChildNode('quad', mesh);
scene.save('quad_uv.glb');

Veja Também

 Português