Aspose.3D FOSS
TypeScript
Class Light

Class Light

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

Light est un Entity qui peut être attaché à un Node pour ajouter une source lumineuse à la scène. Le type de lumière est défini via le lightType propriété. Parce que Light étend Camera dans le source, il hérite de toutes les propriétés de la caméra (nearPlane, farPlane, aspect, etc.) du modèle de données FBX sous-jacent — ces propriétés ne sont pas pertinentes pour l’éclairage et peuvent être ignorées dans une utilisation standard.

export class Light extends Camera

Properties

Quaternion représente une rotation sous forme d’un quaternion unité (w, x, y, z) et fournit des méthodes de fabrique, une interpolation sphérique et une conversion en angles d’Euler et en Matrix4.

Properties

Quaternion est utilisé partout dans l’API @aspose/3d pour représenter des rotations sans verrouillage d’axe (gimbal lock). C’est le type renvoyé par Transform.rotation et GlobalTransform.rotation. Le quaternion identité (1, 0, 0, 0) représente aucune rotation. Quaternion est exporté depuis le sous‑chemin @aspose/3d/utilities.

import { Scene, Node, Light, LightType } from '@aspose/3d';

const scene = new Scene();
scene.open('model.obj');

const lightNode = scene.rootNode.createChildNode('sun');
const light = new Light('sun', LightType.DIRECTIONAL);
lightNode.entity = light;

// Position the light node above the scene
lightNode.transform.setTranslation(0, 10, 0);

scene.save('lit-model.fbx');
console.log(`Light type: ${light.lightType}`);
// Light type: DIRECTIONAL

Properties

PropertiesPropertiesPropertiesProperties
namestring''Le nom de cette lumière, utilisé pour l’identifier dans le graphe de la scène.
lightType`LightTypestring`LightType.POINT

Les propriétés suivantes sont héritées de Camera et sont disponibles sur Light objets dans le système de types, bien qu’ils ne soient pertinents que lorsque le nœud est utilisé comme caméra :

Propriété héritéePropertiesProperties
nearPlanenumberDistance de coupe proche (utilisation caméra).
farPlanenumberDistance de clipping lointain (utilisation de la caméra).
aspectnumberRatio d’aspect (utilisation de la caméra).

Properties

  • Light est construit avec new Light(name?, lightType?). Les deux paramètres sont optionnels ; le type de lumière par défaut est LightType.POINT.
  • Properties LightType constantes de classe (LightType.POINT, LightType.DIRECTIONAL, LightType.SPOT) plutôt que des littéraux de chaîne bruts pour la sécurité de type. LightType.AREA et LightType.VOLUME sont également définis mais rarement utilisés par les importateurs/exportateurs de format.
  • Les propriétés d’ombrage, de couleur, d’intensité et d’atténuation présentes dans les moteurs 3D complets ne sont pas exposées en tant que propriétés TypeScript directes dans cette version de la bibliothèque. Ces valeurs peuvent être présentes dans les données chargées sous forme d’objets génériques Property objets accessibles via getProperty().
 Français