Name
PICTURE2
Syntax
PICTURE2 ausdruck,a,b,mask
Wertebereicheausdruck = Dateiname eines Bitmaps, Typ string oder
ausdruck ≥ 0, Index auf ein objektinternes Bild, Typ integer
a > 0, Typ real
b > 0, Typ real
mask, Transparenz, Typ binär 0 oder 1
ausdruck ≥ 0, Index auf ein objektinternes Bild, Typ integer
a > 0, Typ real
b > 0, Typ real
mask, Transparenz, Typ binär 0 oder 1
Mask-Wertemask: Steuerung des Alphakanals (Bestandteil einer Bilddatei, der die Transparenz des Bildes definiert)
=0 : Alphakanal nicht verwenden, keine Transparenz.
=1 : Alphakanal (wenn vorhanden) verwenden, Teile des Bildes sind transparent
=0 : Alphakanal nicht verwenden, keine Transparenz.
=1 : Alphakanal (wenn vorhanden) verwenden, Teile des Bildes sind transparent
ErläuterungSetzt ein Bitmap in den Grundriss ein. Die Abmessungen werden mit a und b in Metern (nicht in Pixel) angegeben. Die Linke untere Ecke ist der Koordinatennullpunkt.
Als Dateiformat des Bildes können alle ArchiCAD-konformen Bitmaps sein. (s.u.)
Der Verweis auf die Bilddatei kann in 2 Arten erfolgen: 1. Die Bilddatei ist Bestandteil einer aktuell geladenen Bibliothek. Der Dateiname kann ohne Erweiterung (.jpg etc.) angegeben werden. 2. Die Bilddatei ist im Objekt mitgespeichert (s.u.). Dann erfolgt der Verweis per numerischem Index. Der Index 0 verweist, so vorhanden, auf das Vorschaubild des Objektes.
Transparente Bereiche müssen bereits in der Bilddatei in einem Alphakanal definiert sein. Ab ArchiCAD 8.0 ist dies auch alternativ mit dem Befehl PICTURE2{2} möglich.
Die Syntax und Funktionsweise entspricht in etwa dem Befehl PICTURE.
Als Dateiformat des Bildes können alle ArchiCAD-konformen Bitmaps sein. (s.u.)
Der Verweis auf die Bilddatei kann in 2 Arten erfolgen: 1. Die Bilddatei ist Bestandteil einer aktuell geladenen Bibliothek. Der Dateiname kann ohne Erweiterung (.jpg etc.) angegeben werden. 2. Die Bilddatei ist im Objekt mitgespeichert (s.u.). Dann erfolgt der Verweis per numerischem Index. Der Index 0 verweist, so vorhanden, auf das Vorschaubild des Objektes.
Transparente Bereiche müssen bereits in der Bilddatei in einem Alphakanal definiert sein. Ab ArchiCAD 8.0 ist dies auch alternativ mit dem Befehl PICTURE2{2} möglich.
Die Syntax und Funktionsweise entspricht in etwa dem Befehl PICTURE.
BeispielPICTURE2 "Feder",1,5,1
Gibt die Bilddatei "Feder" mit einer Breite von 1m und einer Höhe von 5m aus. Wenn in der Bilddatei ein Alphakanal vorhanden ist, werden Teile transparent.
Gibt die Bilddatei "Feder" mit einer Breite von 1m und einer Höhe von 5m aus. Wenn in der Bilddatei ein Alphakanal vorhanden ist, werden Teile transparent.
BesonderheitenDie Abmessungen des Bitmaps selbst lassen sich in GDL nicht ermitteln. D.h. die Proportionen des Bildes werden mit dem Befehl explizit vorgegeben. Die Darstellung wird also verzerrt, wenn das Verhältnis a/b nicht den Bildproportionen entspricht.
Bitmaps aus Dateien:
Beim Archivieren eines Projektes (PLA) werden die im Objekt mit Dateinamen dezidiert angegebenen Bitmaps mitgesichert. Prinzipiell kann der Dateiname auch in Form einer Variablen (Typ Text) angegeben werden. Dann allerdings können die möglicherweise verwendeten Bitmaps in ein Archiv nicht mitgesichert werden.
Indizierte Bitmaps:
Um Bitmaps in ein Objekt einzubetten muss dies bei der Erstellung des Objektes mit angelegt werden. Dazu platzieren Sie in einem leeren Projekt die gewünschten Bilddateien. Die Skalierung ist egal. Dann das neue Objekt mit "Datei/Ablage > Speziell sichern > ArchiCAD-Objekt..." (bis ArchiCAD 7) bzw. mit "Datei/Ablage > GDL Objekte > Projekt sichern als..." (ab ArchiCAD 8) erzeugen. Die Indizierung entspricht der Stapelung der Bilder im Grundriss vor dem Export.
Nachträglich können Bitmaps nur unter zu Hilfenahme des XML-Konverters in bestehende Objekte eingebettet werden.
Die Verwendung von eingebetteten Bildern funktioniert nicht mit dem GDL Webplugin bis Version 2.0.
Unterstützte Dateiformate:
BMP, GIF, JPG, PNG, TGA, PICT und TIF, wobei PNG und TGA nur in ArchiCAD, nicht im Web Control/Plugin funktionieren.
Da die Bilddateiformate mitunter sehr unterschiedliche Spezifikationen haben, kann es sein, dass z.B. trotz TIF-Format das Bild nicht importiert/dargestellt werden kann. Dies kann durch ein versuchsweises "Dazuladen" im Grundriss geprüft werden. Wird es dort nicht dargestellt, kann dies auch in GDL nicht funktionieren.
Bilder im CMYK-Farbraum können von AC nicht verarbeitet werden. Sie müssen mit einem externen Programm vorher in den RGB-Farbraum konvertiert werden.
Bitmaps aus Dateien:
Beim Archivieren eines Projektes (PLA) werden die im Objekt mit Dateinamen dezidiert angegebenen Bitmaps mitgesichert. Prinzipiell kann der Dateiname auch in Form einer Variablen (Typ Text) angegeben werden. Dann allerdings können die möglicherweise verwendeten Bitmaps in ein Archiv nicht mitgesichert werden.
Indizierte Bitmaps:
Um Bitmaps in ein Objekt einzubetten muss dies bei der Erstellung des Objektes mit angelegt werden. Dazu platzieren Sie in einem leeren Projekt die gewünschten Bilddateien. Die Skalierung ist egal. Dann das neue Objekt mit "Datei/Ablage > Speziell sichern > ArchiCAD-Objekt..." (bis ArchiCAD 7) bzw. mit "Datei/Ablage > GDL Objekte > Projekt sichern als..." (ab ArchiCAD 8) erzeugen. Die Indizierung entspricht der Stapelung der Bilder im Grundriss vor dem Export.
Nachträglich können Bitmaps nur unter zu Hilfenahme des XML-Konverters in bestehende Objekte eingebettet werden.
Die Verwendung von eingebetteten Bildern funktioniert nicht mit dem GDL Webplugin bis Version 2.0.
Unterstützte Dateiformate:
BMP, GIF, JPG, PNG, TGA, PICT und TIF, wobei PNG und TGA nur in ArchiCAD, nicht im Web Control/Plugin funktionieren.
Da die Bilddateiformate mitunter sehr unterschiedliche Spezifikationen haben, kann es sein, dass z.B. trotz TIF-Format das Bild nicht importiert/dargestellt werden kann. Dies kann durch ein versuchsweises "Dazuladen" im Grundriss geprüft werden. Wird es dort nicht dargestellt, kann dies auch in GDL nicht funktionieren.
Bilder im CMYK-Farbraum können von AC nicht verarbeitet werden. Sie müssen mit einem externen Programm vorher in den RGB-Farbraum konvertiert werden.
Tipps und TricksEine häufige Ursache für nicht dargestellte Bilddateien ist, dass sie nicht im Verzeichnisast einer geladenen Bibliothek liegen. Das alleinige Verschieben in einen eingebundenen Ordner ist auch nicht ausreichend, wenn das Projekt bereits geöffnet ist. Dann muss nach dem Verschieben die Bibliothek in ArchiCAD® über den Bibliothekenmanager aktualisiert werden.
Vor ArchiCAD® 6.0 funktionierte der PICTURE-Befehl auch in der 2D-Umgebung. Dieses Feature ist bis Version 7.0 erhalten geblieben.
Es gibt bis mind. ArchiCAD 20 einen Darstellungsfehler der Bitmaps: Die Pixel der ersten Spalte und Zeile werden nur halb so groß ausgegeben wie die übrigen. Dafür die der letzten Spalte und Zeile 1,5fach so groß.
Vor ArchiCAD® 6.0 funktionierte der PICTURE-Befehl auch in der 2D-Umgebung. Dieses Feature ist bis Version 7.0 erhalten geblieben.
Es gibt bis mind. ArchiCAD 20 einen Darstellungsfehler der Bitmaps: Die Pixel der ersten Spalte und Zeile werden nur halb so groß ausgegeben wie die übrigen. Dafür die der letzten Spalte und Zeile 1,5fach so groß.
Kontext2D-Skript
ArchiCADab 6.0
