Light

Inheritance: java.lang.Object, com.aspose.threed.A3DObject, com.aspose.threed.SceneObject, com.aspose.threed.Entity, com.aspose.threed.Frustum

public class Light extends Frustum

La luce illumina la scena.

La formula per calcolare l’attenuazione totale della luce è: A = ConstantAttenuation + (Dist * LinearAttenuation) + ((Dist^2) * QuadraticAttenuation)

Costruttori

Costruttore	Descrizione
Light()	Inizializza una nuova istanza della classe Light.
Light(String name)	Inizializza una nuova istanza della classe Light.
Light(String name, LightType type)	Inizializza una nuova istanza della classe Light.

Metodi

Metodo	Descrizione
equals(Object arg0)
findProperty(String propertyName)	Trova la proprietà.
getAspect()	Ottiene il rapporto d’aspetto del frustum
getBoundingBox()	Ottiene il bounding box dell’entità corrente nel suo sistema di coordinate dello spazio oggetto.
getCastLight()	Ottiene se l’istanza corrente di luce può illuminare altri oggetti.
getCastShadows()	Ottiene se la luce può proiettare ombre su altri oggetti.
getClass()
getColor()	Ottiene il colore della luce
getConstantAttenuation()	Ottiene l’attenuazione costante per calcolare l’attenuazione totale della luce
getDirection()	Ottiene la direzione verso cui la fotocamera sta guardando.
getEntityRendererKey()	Ottiene la chiave del renderer dell’entità registrata nel renderer
getExcluded()	Ottiene se escludere questa entità durante l’esportazione.
getFalloff()	Ottiene l’angolo del cono di decadimento (in gradi).
getFarPlane()	Ottiene la distanza del piano lontano del frustum.
getHotSpot()	Restituisce l’angolo del cono del punto caldo (in gradi).
getIntensity()	Restituisce l’intensità della luce, il valore predefinito è 100
getLightType()	Restituisce il tipo di luce
getLinearAttenuation()	Restituisce l’attenuazione lineare per calcolare l’attenuazione totale della luce
getLookAt()	Restituisce la posizione di interesse verso cui la fotocamera sta guardando.
getName()	Ottiene il nome.
getNearPlane()	Restituisce la distanza del piano vicino del frustum.
getOrthoHeight()	Restituisce l’altezza quando il frustum è in proiezione ortografica.
getParentNode()	Ottiene il primo nodo genitore; se impostato, questa entità verrà staccata dagli altri nodi genitori.
getParentNodes()	Ottiene tutti i nodi genitore; un’entità può essere collegata a più nodi genitore per l’instancing della geometria.
getProperties()	Ottiene la collezione di tutte le proprietà.
getProperty(String property)	Ottieni il valore della proprietà specificata
getQuadraticAttenuation()	Restituisce l’attenuazione quadratica per calcolare l’attenuazione totale della luce
getRotationMode()	Restituisce la modalità di orientamento del frustum. Questa proprietà funziona solo quando il getTarget è nullo.
getScene()	Ottiene la scena a cui appartiene questo oggetto
getShadowColor()	Restituisce il colore dell’ombra.
getTarget()	Restituisce il bersaglio verso cui la fotocamera sta guardando.
getUp()	Restituisce la direzione verso l’alto della fotocamera
hashCode()
notify()
notifyAll()
removeProperty(Property property)	Rimuove una proprietà dinamica.
removeProperty(String property)	Rimuove la proprietà specificata identificata per nome
setAspect(double value)	Imposta il rapporto d’aspetto del frustum
setCastLight(boolean value)	Imposta se l’istanza corrente della luce può illuminare altri oggetti.
setCastShadows(boolean value)	Imposta se la luce può proiettare ombre su altri oggetti.
setColor(Vector3 value)	Imposta il colore della luce
setConstantAttenuation(double value)	Imposta l’attenuazione costante per calcolare l’attenuazione totale della luce
setDirection(Vector3 value)	Imposta la direzione verso cui la fotocamera sta guardando.
setExcluded(boolean value)	Imposta se escludere questa entità durante l’esportazione.
setFalloff(double value)	Imposta l’angolo del cono di decadimento (in gradi).
setFarPlane(double value)	Imposta la distanza del piano lontano del frustum.
setHotSpot(double value)	Imposta l’angolo del cono del punto caldo (in gradi).
setIntensity(double value)	Imposta l’intensità della luce, il valore predefinito è 100
setLightType(LightType value)	Imposta il tipo di luce
setLinearAttenuation(double value)	Imposta l’attenuazione lineare per calcolare l’attenuazione totale della luce
setLookAt(Vector3 value)	Imposta la posizione di interesse verso cui la fotocamera sta guardando.
setName(String value)	Imposta il nome.
setNearPlane(double value)	Imposta la distanza del piano vicino del frustum.
setOrthoHeight(double value)	Imposta l’altezza quando il frustum è in proiezione ortografica.
setParentNode(Node value)	Imposta il primo nodo genitore; se impostato, questa entità verrà staccata dagli altri nodi genitori.
setProperty(String property, Object value)	Imposta il valore della proprietà specificata
setQuadraticAttenuation(double value)	Imposta l’attenuazione quadratica per calcolare l’attenuazione totale della luce
setRotationMode(RotationMode value)	Imposta la modalità di orientamento del frustum. Questa proprietà funziona solo quando il getTarget è nullo.
setShadowColor(Vector3 value)	Imposta il colore dell’ombra.
setTarget(Node value)	Imposta il bersaglio verso cui la fotocamera sta guardando.
setUp(Vector3 value)	Imposta la direzione verso l’alto della fotocamera
toString()
wait()
wait(long arg0)
wait(long arg0, int arg1)

Light()

public Light()

Inizializza una nuova istanza della classe Light.

Light(String name)

public Light(String name)

Inizializza una nuova istanza della classe Light.

Parameters:

Parametro	Tipo	Descrizione
nome	java.lang.String	Nome

Light(String name, LightType type)

public Light(String name, LightType type)

Inizializza una nuova istanza della classe Light.

Parameters:

Parametro	Tipo	Descrizione
nome	java.lang.String	Nome
type	LightType	Nuovo tipo di luce

equals(Object arg0)

public boolean equals(Object arg0)

Parameters:

Parametro	Tipo	Descrizione
arg0	java.lang.Object

Returns: boolean

findProperty(String propertyName)

public Property findProperty(String propertyName)

Trova la proprietà. Può essere una proprietà dinamica (creata con CreateDynamicProperty/SetProperty) o una proprietà nativa (identificata per nome).

Parameters:

Parametro	Tipo	Descrizione
propertyName	java.lang.String	Nome della proprietà.

Returns: Property - The property.

getAspect()

public double getAspect()

Ottiene il rapporto d’aspetto del frustum

Returns: double - il rapporto d’aspetto del frustum

getBoundingBox()

public BoundingBox getBoundingBox()

Ottiene il bounding box dell’entità corrente nel suo sistema di coordinate dello spazio oggetto.

Returns: BoundingBox - the bounding box of current entity in its object space coordinate system. Example: The following code shows how to calculate the bounding box of a shape

Entity entity = new Sphere();
     entity.setRadius(10);
     var bbox = entity.getBoundingBox();
     System.out.printf("The bounding box of the entity is %s ~ %s", bbox.getMinimum(), bbox.getMaximum());

getCastLight()

public boolean getCastLight()

Ottiene se l’istanza corrente di luce può illuminare altri oggetti.

Returns: boolean - se l’istanza corrente della luce può illuminare altri oggetti.

getCastShadows()

public boolean getCastShadows()

Ottiene se la luce può proiettare ombre su altri oggetti.

Returns: boolean - se la luce può proiettare ombre su altri oggetti.

getClass()

public final native Class<?> getClass()

Returns: java.lang.Class

getColor()

public Vector3 getColor()

Ottiene il colore della luce

Returns: Vector3 - the light’s color

getConstantAttenuation()

public double getConstantAttenuation()

Ottiene l’attenuazione costante per calcolare l’attenuazione totale della luce

Returns: double - l’attenuazione costante per calcolare l’attenuazione totale della luce

getDirection()

public Vector3 getDirection()

Ottiene la direzione verso cui la fotocamera sta guardando. Le modifiche a questa proprietà influenzeranno anche il getLookAt e il getTarget.

Returns: Vector3 - the direction that the camera is looking at. Changes on this property will also affects the getLookAt and getTarget.

getEntityRendererKey()

public EntityRendererKey getEntityRendererKey()

Ottiene la chiave del renderer dell’entità registrata nel renderer

Returns: EntityRendererKey - the key of the entity renderer registered in the renderer

getExcluded()

public boolean getExcluded()

Ottiene se escludere questa entità durante l’esportazione.

Returns: boolean - se escludere questa entità durante l’esportazione.

getFalloff()

public double getFalloff()

Ottiene l’angolo del cono di decadimento (in gradi).

Returns: double - l’angolo del cono di decadimento (in gradi).

getFarPlane()

public double getFarPlane()

Ottiene la distanza del piano lontano del frustum.

Returns: double - la distanza del piano lontano del frustum.

getHotSpot()

public double getHotSpot()

Restituisce l’angolo del cono del punto caldo (in gradi).

Returns: double - l’angolo del cono hotspot (in gradi).

getIntensity()

public double getIntensity()

Restituisce l’intensità della luce, il valore predefinito è 100

Returns: double - l’intensità della luce, il valore predefinito è 100

getLightType()

public LightType getLightType()

Restituisce il tipo di luce

Returns: LightType - the light’s type

getLinearAttenuation()

public double getLinearAttenuation()

Restituisce l’attenuazione lineare per calcolare l’attenuazione totale della luce

Returns: double - l’attenuazione lineare per calcolare l’attenuazione totale della luce

getLookAt()

public Vector3 getLookAt()

Restituisce la posizione di interesse verso cui la fotocamera sta guardando.

Returns: Vector3 - the the interested position that the camera is looking at.

getName()

public String getName()

Ottiene il nome.

Returns: java.lang.String - il nome.

getNearPlane()

public double getNearPlane()

Restituisce la distanza del piano vicino del frustum.

Returns: double - la distanza del piano vicino del frustum.

getOrthoHeight()

public double getOrthoHeight()

Restituisce l’altezza quando il frustum è in proiezione ortografica.

Returns: double - l’altezza quando il frustum è in proiezione ortografica.

getParentNode()

public Node getParentNode()

Ottiene il primo nodo genitore; se impostato, questa entità verrà staccata dagli altri nodi genitori.

Returns: Node - the first parent node, if set the first parent node, this entity will be detached from other parent nodes.

getParentNodes()

public ArrayList<Node> getParentNodes()

Ottiene tutti i nodi genitore; un’entità può essere collegata a più nodi genitore per l’instancing della geometria.

Returns: java.util.ArrayList<com.aspose.threed.Node> - tutti i nodi genitore, un’entità può essere collegata a più nodi genitore per l’instanziazione della geometria

getProperties()

public PropertyCollection getProperties()

Ottiene la collezione di tutte le proprietà.

Returns: PropertyCollection - the collection of all properties.

getProperty(String property)

public Object getProperty(String property)

Ottieni il valore della proprietà specificata

Parameters:

Parametro	Tipo	Descrizione
proprietà	java.lang.String	Nome della proprietà

Returns: java.lang.Object - Il valore della proprietà trovata

getQuadraticAttenuation()

public double getQuadraticAttenuation()

Restituisce l’attenuazione quadratica per calcolare l’attenuazione totale della luce

Returns: double - l’attenuazione quadratica per calcolare l’attenuazione totale della luce

getRotationMode()

public RotationMode getRotationMode()

Ottiene la modalità di orientamento del frustum. Questa proprietà funziona solo quando il getTarget è nullo. Se il valore è RotationMode.FIXED_TARGET, la direzione è sempre calcolata dalla proprietà getLookAt. Altrimenti il getLookAt è sempre calcolato da getDirection.

Returns: RotationMode - the frustum’s orientation mode This property only works when the getTarget is null. If the value is RotationMode.FIXED_TARGET, the direction is always calculated by the property getLookAt Otherwise the getLookAt is always calculated by the getDirection

getScene()

public Scene getScene()

Ottiene la scena a cui appartiene questo oggetto

Returns: Scene - the scene that this object belongs to

getShadowColor()

public Vector3 getShadowColor()

Restituisce il colore dell’ombra.

Returns: Vector3 - the shadow’s color.

getTarget()

public Node getTarget()

Ottiene il bersaglio verso cui la fotocamera sta guardando. Se l’utente supporta questa proprietà, dovrebbe essere impostata prima della proprietà getLookAt.

Returns: Node - the target that the camera is looking at. If the user supports this property, it should be prior to getLookAt property.

getUp()

public Vector3 getUp()

Restituisce la direzione verso l’alto della fotocamera

Returns: Vector3 - the up direction of the camera

hashCode()

public native int hashCode()

Returns: int

notify()

public final native void notify()

notifyAll()

public final native void notifyAll()

removeProperty(Property property)

public boolean removeProperty(Property property)

Rimuove una proprietà dinamica.

Parameters:

Parametro	Tipo	Descrizione
property	Property	Quale proprietà rimuovere

Returns: boolean - true se la proprietà è stata rimossa con successo

removeProperty(String property)

public boolean removeProperty(String property)

Rimuove la proprietà specificata identificata per nome

Parameters:

Parametro	Tipo	Descrizione
proprietà	java.lang.String	Quale proprietà rimuovere

Returns: boolean - true se la proprietà è stata rimossa con successo

setAspect(double value)

public void setAspect(double value)

Imposta il rapporto d’aspetto del frustum

Parameters:

Parametro	Tipo	Descrizione
valore	double	Nuovo valore

setCastLight(boolean value)

public void setCastLight(boolean value)

Imposta se l’istanza corrente della luce può illuminare altri oggetti.

Parameters:

Parametro	Tipo	Descrizione
valore	boolean	Nuovo valore

setCastShadows(boolean value)

public void setCastShadows(boolean value)

Imposta se la luce può proiettare ombre su altri oggetti.

Parameters:

Parametro	Tipo	Descrizione
valore	boolean	Nuovo valore

setColor(Vector3 value)

public void setColor(Vector3 value)

Imposta il colore della luce

Parameters:

Parametro	Tipo	Descrizione
value	Vector3	Nuovo valore

setConstantAttenuation(double value)

public void setConstantAttenuation(double value)

Imposta l’attenuazione costante per calcolare l’attenuazione totale della luce

Parameters:

Parametro	Tipo	Descrizione
valore	double	Nuovo valore

setDirection(Vector3 value)

public void setDirection(Vector3 value)

Imposta la direzione verso cui la fotocamera sta guardando. Le modifiche a questa proprietà influenzeranno anche il getLookAt e il getTarget.

Parameters:

Parametro	Tipo	Descrizione
value	Vector3	Nuovo valore

setExcluded(boolean value)

public void setExcluded(boolean value)

Imposta se escludere questa entità durante l’esportazione.

Parameters:

Parametro	Tipo	Descrizione
valore	boolean	Nuovo valore

setFalloff(double value)

public void setFalloff(double value)

Imposta l’angolo del cono di decadimento (in gradi).

Parameters:

Parametro	Tipo	Descrizione
valore	double	Nuovo valore

setFarPlane(double value)

public void setFarPlane(double value)

Imposta la distanza del piano lontano del frustum.

Parameters:

Parametro	Tipo	Descrizione
valore	double	Nuovo valore

setHotSpot(double value)

public void setHotSpot(double value)

Imposta l’angolo del cono del punto caldo (in gradi).

Parameters:

Parametro	Tipo	Descrizione
valore	double	Nuovo valore

setIntensity(double value)

public void setIntensity(double value)

Imposta l’intensità della luce, il valore predefinito è 100

Parameters:

Parametro	Tipo	Descrizione
valore	double	Nuovo valore

setLightType(LightType value)

public void setLightType(LightType value)

Imposta il tipo di luce

Parameters:

Parametro	Tipo	Descrizione
value	LightType	Nuovo valore

setLinearAttenuation(double value)

public void setLinearAttenuation(double value)

Imposta l’attenuazione lineare per calcolare l’attenuazione totale della luce

Parameters:

Parametro	Tipo	Descrizione
valore	double	Nuovo valore

setLookAt(Vector3 value)

public void setLookAt(Vector3 value)

Imposta la posizione di interesse verso cui la fotocamera sta guardando.

Parameters:

Parametro	Tipo	Descrizione
value	Vector3	Nuovo valore

setName(String value)

public void setName(String value)

Imposta il nome.

Parameters:

Parametro	Tipo	Descrizione
valore	java.lang.String	Nuovo valore

setNearPlane(double value)

public void setNearPlane(double value)

Imposta la distanza del piano vicino del frustum.

Parameters:

Parametro	Tipo	Descrizione
valore	double	Nuovo valore

setOrthoHeight(double value)

public void setOrthoHeight(double value)

Imposta l’altezza quando il frustum è in proiezione ortografica.

Parameters:

Parametro	Tipo	Descrizione
valore	double	Nuovo valore

setParentNode(Node value)

public void setParentNode(Node value)

Imposta il primo nodo genitore; se impostato, questa entità verrà staccata dagli altri nodi genitori.

Parameters:

Parametro	Tipo	Descrizione
value	Node	Nuovo valore

setProperty(String property, Object value)

public void setProperty(String property, Object value)

Imposta il valore della proprietà specificata

Parameters:

Parametro	Tipo	Descrizione
proprietà	java.lang.String	Nome della proprietà
valore	java.lang.Object	Il valore della proprietà

setQuadraticAttenuation(double value)

public void setQuadraticAttenuation(double value)

Imposta l’attenuazione quadratica per calcolare l’attenuazione totale della luce

Parameters:

Parametro	Tipo	Descrizione
valore	double	Nuovo valore

setRotationMode(RotationMode value)

public void setRotationMode(RotationMode value)

Imposta la modalità di orientamento del frustum. Questa proprietà funziona solo quando il getTarget è nullo. Se il valore è RotationMode.FIXED_TARGET, la direzione è sempre calcolata dalla proprietà getLookAt. Altrimenti il getLookAt è sempre calcolato da getDirection.

Parameters:

Parametro	Tipo	Descrizione
value	RotationMode	Nuovo valore

setShadowColor(Vector3 value)

public void setShadowColor(Vector3 value)

Imposta il colore dell’ombra.

Parameters:

Parametro	Tipo	Descrizione
value	Vector3	Nuovo valore

setTarget(Node value)

public void setTarget(Node value)

Imposta il bersaglio verso cui la fotocamera sta guardando. Se l’utente supporta questa proprietà, dovrebbe essere prima della proprietà getLookAt.

Parameters:

Parametro	Tipo	Descrizione
value	Node	Nuovo valore

setUp(Vector3 value)

public void setUp(Vector3 value)

Imposta la direzione verso l’alto della fotocamera

Parameters:

Parametro	Tipo	Descrizione
value	Vector3	Nuovo valore

toString()

public String toString()

Returns: java.lang.String

wait()

public final void wait()

wait(long arg0)

public final void wait(long arg0)

Parameters:

Parametro	Tipo	Descrizione
arg0	long

wait(long arg0, int arg1)

public final void wait(long arg0, int arg1)

Parameters:

Parametro	Tipo	Descrizione
arg0	long
arg1	int