Name
LIGHT
Syntax
LIGHT rot, grün, blau, schatten,
radius, alpha, beta, abnahme1,
abstand1, abstand2, abnahme2
[[,] ADDITIONAL_DATA [name_extern1= wert_extern1, ... name_externn= wert_externn]
radius, alpha, beta, abnahme1,
abstand1, abstand2, abnahme2
[[,] ADDITIONAL_DATA [name_extern1= wert_extern1, ... name_externn= wert_externn]
Wertebereiche0 ≤ rot ≤ 1, Typ real
0 ≤ grün ≤ 1, Typ real
0 ≤ blau ≤ 1, Typ real
schatten =0 oder =1; Typ binär
0 ≤ alpha ≤ beta, Kernbereich, Typ real
0 ≤ beta ≤ 80°, Abnahmebereich, Typ real
radius ≥ 0, kleiner Radius des Lichtkegel(stumpfes), Typ real
abnahme1 ≥ 0; radialer Abnahmefaktor, Typ real
abnahme2 ≥ 0; axialer Abnahmefaktor, Typ real
abstand1 ≥ 0, Beginn, Typ real
abstand2 ≥ abstand1, Leuchtweite, Typ real
name_externi, in der externen Anwendung verwendeter Parametername
wert_externi, Ausdruck oder Wert, Typ abhängig von der externen Anwendung
0 ≤ grün ≤ 1, Typ real
0 ≤ blau ≤ 1, Typ real
schatten =0 oder =1; Typ binär
0 ≤ alpha ≤ beta, Kernbereich, Typ real
0 ≤ beta ≤ 80°, Abnahmebereich, Typ real
radius ≥ 0, kleiner Radius des Lichtkegel(stumpfes), Typ real
abnahme1 ≥ 0; radialer Abnahmefaktor, Typ real
abnahme2 ≥ 0; axialer Abnahmefaktor, Typ real
abstand1 ≥ 0, Beginn, Typ real
abstand2 ≥ abstand1, Leuchtweite, Typ real
name_externi, in der externen Anwendung verwendeter Parametername
wert_externi, Ausdruck oder Wert, Typ abhängig von der externen Anwendung
ErläuterungVerwendet in einem Leuchtenobjekt, erzeugt LIGHT eine Lichtquelle, beginnen vom Ursprung in Richtung der X-Achse. Es wird eine Lichtkegelstumpf erzeugt, der in X-Richtung und an den Rändern an Intensität verliert. Siehe Abbildung.
Die Lichtfarbe bestimmen die drei Parameter rot, grün und blau.
Der Lichtkern wird durch die Parameter radius, abstand1 und abstand2 bestimmt. Innerhalb dieses Kerns besteht die größte Lichtintensität. Das Licht beginnt in einem Abstand x=abstand1 vom Ursprung und endet mit x=abstand2. Demnach hat der tatsächlich Licht enthaltende Kegelstumpf des Kerns folgende Radien:
rbeginn = radius + abstand1 * TAN(alpha)
rende = radius + abstand2 * TAN(alpha)
und hat die Höhe h = abstand2 - abstand1
Die radiale (in Y/Z-Ebene) Abschwächung des Lichtes erfolgt innerhalb eines den Kegelstumpf umgebenden Winkelbereichs beta in einer von abnahme1 bestimmten Schärfe. Je größer beta-alpha, also der effektive Übergangsbereich, und je größer der Abnahmefaktor abnahme1, desto weicher (diffuser) nimmt das Licht ab.
Die axiale (in X-Richtung) Abschwächung erfolgt hingegen innerhalb des Kernbereiches zwischen abstand1 und abstand2. Die Schärfe und Stärke dieses Übergangs (Abnahme) bestimmt abnahme2. Je größer abnahme2, desto weicher der Übergang, desto stärker die Abnahme. Mit abnahme2=0 hat der Kernbereich über die gesamte Höhe des Lichtkegelstumpfes eine konstante Lichtintensität.
Der Parameter schatten bestimmt den Schattenwurf.
=0: das Licht wirft keinen Schatten
=1: das Licht wirft Schatten
Ob Objekte selbst wiederum in die Schattenberechnung mit einbezogen werden, hängt von der Verwendung des Attributbefehls SHADOW und den Einstellungen zur Photorealistik ab. Die Berechnung der Schatten ist sehr komplex. Es kann daher sinnvoll sein nicht alle Lichtquellen einer Szene Schatten erzeugen zu lassen.
Transformationen des Koordinatensystems beeinflussen nur den Ausgangspunkt der Lichtquelle und die Ausrichtung des Lichtes, nicht aber Form und Größe des Lichtkegels.
Es stehen einige spezielle lokale (C, D, E, F, G) und globale Parameter zur Verfügung, die die speziellen Einstellmöglichkeiten von Lampenobjekten (Intensitätsschieberegler, Lichtschalter, Lichtfarbe) zur Verfügung stellen. Die lokalen Parameter werden im Objekt selbst in der Parameterliste geführt und enthalten damit Standardwerte.
Die Darstellung des Lichtes hängt auch stark von der verwendeten Rendering-Engine ab, welche Komponenten der Lichtdefinition unterstützt werden. Ggf. sind ab ArchiCAD 9 mit dem optionalen Syntaxfragment ADDITIONAL_DATA weitere Werte zu definieren. Siehe die separat Erläuterung zu dem Schlüsselwort.
Die Lichtfarbe bestimmen die drei Parameter rot, grün und blau.
Der Lichtkern wird durch die Parameter radius, abstand1 und abstand2 bestimmt. Innerhalb dieses Kerns besteht die größte Lichtintensität. Das Licht beginnt in einem Abstand x=abstand1 vom Ursprung und endet mit x=abstand2. Demnach hat der tatsächlich Licht enthaltende Kegelstumpf des Kerns folgende Radien:
rbeginn = radius + abstand1 * TAN(alpha)
rende = radius + abstand2 * TAN(alpha)
und hat die Höhe h = abstand2 - abstand1
Die radiale (in Y/Z-Ebene) Abschwächung des Lichtes erfolgt innerhalb eines den Kegelstumpf umgebenden Winkelbereichs beta in einer von abnahme1 bestimmten Schärfe. Je größer beta-alpha, also der effektive Übergangsbereich, und je größer der Abnahmefaktor abnahme1, desto weicher (diffuser) nimmt das Licht ab.
Die axiale (in X-Richtung) Abschwächung erfolgt hingegen innerhalb des Kernbereiches zwischen abstand1 und abstand2. Die Schärfe und Stärke dieses Übergangs (Abnahme) bestimmt abnahme2. Je größer abnahme2, desto weicher der Übergang, desto stärker die Abnahme. Mit abnahme2=0 hat der Kernbereich über die gesamte Höhe des Lichtkegelstumpfes eine konstante Lichtintensität.
Der Parameter schatten bestimmt den Schattenwurf.
=0: das Licht wirft keinen Schatten
=1: das Licht wirft Schatten
Ob Objekte selbst wiederum in die Schattenberechnung mit einbezogen werden, hängt von der Verwendung des Attributbefehls SHADOW und den Einstellungen zur Photorealistik ab. Die Berechnung der Schatten ist sehr komplex. Es kann daher sinnvoll sein nicht alle Lichtquellen einer Szene Schatten erzeugen zu lassen.
Transformationen des Koordinatensystems beeinflussen nur den Ausgangspunkt der Lichtquelle und die Ausrichtung des Lichtes, nicht aber Form und Größe des Lichtkegels.
Es stehen einige spezielle lokale (C, D, E, F, G) und globale Parameter zur Verfügung, die die speziellen Einstellmöglichkeiten von Lampenobjekten (Intensitätsschieberegler, Lichtschalter, Lichtfarbe) zur Verfügung stellen. Die lokalen Parameter werden im Objekt selbst in der Parameterliste geführt und enthalten damit Standardwerte.
Die Darstellung des Lichtes hängt auch stark von der verwendeten Rendering-Engine ab, welche Komponenten der Lichtdefinition unterstützt werden. Ggf. sind ab ArchiCAD 9 mit dem optionalen Syntaxfragment ADDITIONAL_DATA weitere Werte zu definieren. Siehe die separat Erläuterung zu dem Schlüsselwort.
Beispielabnahme1=1
abnahme1=0.5
LIGHT 1,1,1, 0,
0.90, 1.5, 20.0, abnahme1,
0.50, 5.75, abnahme2
Lichtobjekt für Abb. 2 und Abb. 3.
abnahme1=0.5
LIGHT 1,1,1, 0,
0.90, 1.5, 20.0, abnahme1,
0.50, 5.75, abnahme2
Lichtobjekt für Abb. 2 und Abb. 3.
BesonderheitenBesondere Parameterwerte erzeugen besondere Lichtquellen:
radius = 0, alpha = 0, beta = 0
Erzeugt eine punktförmige Lichtquelle mit Kugelförmiger Abstrahlung. Die Parameter schatten, abnahme1 werden ignoriert (=0). Das Licht wirft keinen Schatten.
radius > 0, alpha = 0, beta = 0
Erzeugt eine zylindrische Lichtquelle wie ein Spotlight. Auf den Radius "fokussiert".
Lineare Leuchten und leuchtende Materialien sind mit dem Befehl nicht zu realisieren.
Der Bereich ADDITIONAL_DATA ist ab ArchiCAD® 9 gültig und wird separat erläutert. Das optionale Komma (,) davor wurde mit ArchiCAD® 10 eingeführt, um mit der Befehlserweiterung eine neue Programmzeile beginnen zu können, und war zuvor nicht erlaubt. Diese Quellcodelayout-unterstützende Option sollte ab ArchiCAD® 10 verwendet werden.
radius = 0, alpha = 0, beta = 0
Erzeugt eine punktförmige Lichtquelle mit Kugelförmiger Abstrahlung. Die Parameter schatten, abnahme1 werden ignoriert (=0). Das Licht wirft keinen Schatten.
radius > 0, alpha = 0, beta = 0
Erzeugt eine zylindrische Lichtquelle wie ein Spotlight. Auf den Radius "fokussiert".
Lineare Leuchten und leuchtende Materialien sind mit dem Befehl nicht zu realisieren.
Der Bereich ADDITIONAL_DATA ist ab ArchiCAD® 9 gültig und wird separat erläutert. Das optionale Komma (,) davor wurde mit ArchiCAD® 10 eingeführt, um mit der Befehlserweiterung eine neue Programmzeile beginnen zu können, und war zuvor nicht erlaubt. Diese Quellcodelayout-unterstützende Option sollte ab ArchiCAD® 10 verwendet werden.
Tipps und Tricks"Warte bis es dunkel ist." oder warum ist das Licht aus?
Der Lichtkörper ist unsichtbar, weswegen die Suche nach einer Fehlerquelle manchmal schwierig ist. Hier einige gängige Fehler:
- Lichtschalter in dem Objekt ist aus.
- Keine photorealistische Darstellung (Lichter werden im 3D-Fenster nicht angezeigt)
- In den Einstellungen der Photorealistik sind "Lichtquellen" deaktiviert
- Leuchte liegt innerhalb eines Bauteils (Licht kann nicht heraus)
Die Einstellung der Lichtabnahmefaktoren ist nirgendwo sauber dokumentiert. Aus unseren Versuchen (siehe Abb. 2) haben sich für den axialen Abnahmefaktor (abnahme2) Werte zwischen 0 und 1 und für den radialen Faktor (abnahme1) Werte zwischen 0 und 100 als brauchbar erwiesen. Siehe Abbildung 3 in der 30 Lichtquellen mit unterschiedlichen Parametern zentral in die Achse einer Wendeltreppe orientiert wurden. Der LIGHT-Befehl findet sich unter Beispiel.
Der Lichtkörper ist unsichtbar, weswegen die Suche nach einer Fehlerquelle manchmal schwierig ist. Hier einige gängige Fehler:
- Lichtschalter in dem Objekt ist aus.
- Keine photorealistische Darstellung (Lichter werden im 3D-Fenster nicht angezeigt)
- In den Einstellungen der Photorealistik sind "Lichtquellen" deaktiviert
- Leuchte liegt innerhalb eines Bauteils (Licht kann nicht heraus)
Die Einstellung der Lichtabnahmefaktoren ist nirgendwo sauber dokumentiert. Aus unseren Versuchen (siehe Abb. 2) haben sich für den axialen Abnahmefaktor (abnahme2) Werte zwischen 0 und 1 und für den radialen Faktor (abnahme1) Werte zwischen 0 und 100 als brauchbar erwiesen. Siehe Abbildung 3 in der 30 Lichtquellen mit unterschiedlichen Parametern zentral in die Achse einer Wendeltreppe orientiert wurden. Der LIGHT-Befehl findet sich unter Beispiel.
LinksBasic Libraray Documentation:
Leuchtenobjekte (EN)
Leuchtenobjekte (EN)
Kontext3D-Skript, Lampenobjekt
