HALCON Website / HALCON Operator-Referenz / Graphik / Fenster
KlassenKlassen | | Operatoren

dump_windowT_dump_windowDumpWindowDumpWindow (Operator)

Name

dump_windowT_dump_windowDumpWindowDumpWindow — Ausgeben des Fensterinhaltes in eine Datei.

Signatur

dump_window( : : WindowHandle, Device, FileName : )

Herror T_dump_window(const Htuple WindowHandle, const Htuple Device, const Htuple FileName)

void DumpWindow(const HTuple& WindowHandle, const HTuple& Device, const HTuple& FileName)

void HWindow::DumpWindow(const HTuple& Device, const HString& FileName) const

void HWindow::DumpWindow(const HString& Device, const HString& FileName) const

void HWindow::DumpWindow(const char* Device, const char* FileName) const

void HWindow::DumpWindow(const wchar_t* Device, const wchar_t* FileName) const   (Nur Windows)

static void HOperatorSet.DumpWindow(HTuple windowHandle, HTuple device, HTuple fileName)

void HWindow.DumpWindow(HTuple device, string fileName)

void HWindow.DumpWindow(string device, string fileName)

Beschreibung

dump_windowdump_windowDumpWindowDumpWindowDumpWindow gibt den Inhalt des Fensters in eine Datei aus. Diese Datei kann dann mit geeigneten Druckern oder anderen Programmen weiterverarbeitet werden. Der Bildschirminhalt wird dabei jeweils für ein spezielles Gerät (DeviceDeviceDeviceDevicedevice) aufbereitet, d.h. so formatiert, dass die Datei direkt ausgedruckt oder von einem Grafikprogramm weiterverarbeitet werden kann.

Für die Umsetzung der Grauwerte wird die aktuelle Farbtabelle des Fensters verwendet.

Mögliche Werte für DeviceDeviceDeviceDevicedevice

'postscript':

PostScript - Datei.

Dateiendung: '.ps'

'postscript',Breite,Höhe:

PostScript - Datei mit Angabe der Ausgabegröße. Width und Height beziehen sich dabei auf die Größe des Ausdrucks. In diesem Fall wird ein Tupel mit den drei Werten als DeviceDeviceDeviceDevicedevice übergeben.

Dateiendung: '.ps'

'tiff':

TIFF-Format; Komprimierung ist möglich mit Adobe-Deflate-Komprimierung ('deflate [num]'"deflate [num]""deflate [num]""deflate [num]""deflate [num]", verlustfrei), JPEG ('jpeg [num]'"jpeg [num]""jpeg [num]""jpeg [num]""jpeg [num]", verlustbehaftet), LZW ('lzw'"lzw""lzw""lzw""lzw", verlustfrei) und PackBits ('packbits'"packbits""packbits""packbits""packbits", verlustfrei). '[num]'"[num]""[num]""[num]""[num]" bedeutet hier eine optionale Angabe der Komprimierung. Bei 'deflate'"deflate""deflate""deflate""deflate" kann eine Zahl zwischen 0 (keine Komprimierung) und 9 (maximale Komprimierung) angegeben werden. Bei 'jpeg'"jpeg""jpeg""jpeg""jpeg" kann eine Zahl zwischen 0 und 100 angegeben werden. Die Semantik ist identisch mit der unten bei 'jpeg' beschriebenen Semantik. Die Optionen können durch Leerzeichen getrennt aneinander gefügt werden. Beispiele: 'tiff deflate 9'"tiff deflate 9""tiff deflate 9""tiff deflate 9""tiff deflate 9": Maximale Adobe-Deflate-Komprimierung; 'tiff jpeg 90'"tiff jpeg 90""tiff jpeg 90""tiff jpeg 90""tiff jpeg 90": JPEG-Komprimierung mit hoher Qualität; 'tiff lzw'"tiff lzw""tiff lzw""tiff lzw""tiff lzw": LZW-Komprimierung; 'tiff'"tiff""tiff""tiff""tiff" oder 'tiff none'"tiff none""tiff none""tiff none""tiff none": Keine Komprimierung.

Dateiendung: '.tif'

'bmp':

Windows-BMP-Format, RGB-Bild, 3 Byte pro Pixel;

Dateiendung: '.bmp'

'jpeg':

JPEG-Format (verlustbehaftete Komprimierung); Zusammen mit dem Format kann ein Qualitätsmaß angeben werden, das die Komprimierungsrate und die Qualität des gespeicherten Bildes bestimmt. Große Werte (Maximum 100) erzeugen eine relativ große Datei mit hoher Qualität, bei kleine Werten nimmt die Qualität und die Dateigröße deutlich ab; Bsp.: 'jpeg 30'.

Dateiendung: '.jpg'

'jpegxr':

JPEG-Format (verlustfreie und verlustbehaftete Komprimierung); Zusammen mit dem Format kann ein Qualitätsmaß angeben werden, das die Komprimierungsrate und die Qualität des gespeicherten Bildes bestimmt. Große Werte (Maximum 100) erzeugen eine relativ große Datei mit hoher Qualität, bei kleine Werten nimmt die Qualität und die Dateigröße deutlich ab; Bsp.: 'jpegxr 30'.

Dateiendung: '.jpg'

'jp2':

JPEG2000-Format (verlustfreie und verlustbehaftete Komprimierung); Zusammen mit dem Format kann ein Maß angegeben werden, welches die Komprimierungsrate und damit die Qualität des gespeicherten Bildes bestimmt (z.B. 'jp2 40'). Der angegebene Wert entspricht ungefähr dem Verhältnis der Größe des komprimierten Bildes zur Größe des unkomprimierten Bildes (in Prozent). Da JPEG2000 ohnehin stark komprimiert, haben erst kleinere Werte (typischerweise unter 50) Einfluss auf die Dateigröße. Wird kein Wert angegeben (und nur dann) wird das Bild verlustfrei komprimiert.

Dateiendung: '.jp2'

'png':

PNG-Format (verlustfreie Komprimierung); zusammen mit dem Format kann ein Komprimierungsgrad zwischen 0 und 9 angegeben werden, wobei 0 keiner Kompression und 9 der bestmöglichen Kompression entspricht. Alternativ kann die Kompression über folgende Konstanten ausgewählt werden: 'best', 'fastest' und 'none'. Korrekte Formatparameter sind also z.B. 'png', 'png 7' und 'png none'.

Dateiendung: '.png'

Achtung

Unter unixartigen Systemen muss das Grafikfenster vollständig auf dem Root-Fenster sichtbar sein, da sonst der Fensterinhalt aufgrund von Einschränkungen in X Windows nicht ausgelesen werden kann. Sollen Ausgaben von größeren Darstellungen in eine Datei geschrieben werden, bietet sich der Windowtyp 'pixmap'"pixmap""pixmap""pixmap""pixmap" an.

Ausführungsinformationen

Parameter

WindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control)  window → HWindow, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Fenster-Handle.

DeviceDeviceDeviceDevicedevice (input_control)  string(-array) → HTupleHTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)

Name des Zielgerätes bzw. des Grafikformats.

Defaultwert: 'postscript' "postscript" "postscript" "postscript" "postscript"

Wertevorschläge: 'postscript'"postscript""postscript""postscript""postscript", 'tiff'"tiff""tiff""tiff""tiff", 'tiff deflate 9'"tiff deflate 9""tiff deflate 9""tiff deflate 9""tiff deflate 9", 'tiff jpeg 90'"tiff jpeg 90""tiff jpeg 90""tiff jpeg 90""tiff jpeg 90", 'tiff lzw'"tiff lzw""tiff lzw""tiff lzw""tiff lzw", 'tiff packbits'"tiff packbits""tiff packbits""tiff packbits""tiff packbits", 'bmp'"bmp""bmp""bmp""bmp", 'jpeg'"jpeg""jpeg""jpeg""jpeg", 'jpeg 100'"jpeg 100""jpeg 100""jpeg 100""jpeg 100", 'jpeg 80'"jpeg 80""jpeg 80""jpeg 80""jpeg 80", 'jpeg 60'"jpeg 60""jpeg 60""jpeg 60""jpeg 60", 'jpeg 40'"jpeg 40""jpeg 40""jpeg 40""jpeg 40", 'jpeg 20'"jpeg 20""jpeg 20""jpeg 20""jpeg 20", 'jpegxr'"jpegxr""jpegxr""jpegxr""jpegxr", 'jpegxr 50'"jpegxr 50""jpegxr 50""jpegxr 50""jpegxr 50", 'jpegxr 40'"jpegxr 40""jpegxr 40""jpegxr 40""jpegxr 40", 'jpegxr 30'"jpegxr 30""jpegxr 30""jpegxr 30""jpegxr 30", 'jpegxr 20'"jpegxr 20""jpegxr 20""jpegxr 20""jpegxr 20", 'jp2'"jp2""jp2""jp2""jp2", 'jp2 50'"jp2 50""jp2 50""jp2 50""jp2 50", 'jp2 40'"jp2 40""jp2 40""jp2 40""jp2 40", 'jp2 30'"jp2 30""jp2 30""jp2 30""jp2 30", 'jp2 20'"jp2 20""jp2 20""jp2 20""jp2 20", 'png'"png""png""png""png", 'png best'"png best""png best""png best""png best", 'png fastest'"png fastest""png fastest""png fastest""png fastest", 'png none'"png none""png none""png none""png none"

FileNameFileNameFileNameFileNamefileName (input_control)  filename.write → HTupleHTupleHtuple (string) (string) (HString) (char*)

Dateiname (ohne Extension).

Defaultwert: 'halcon_dump' "halcon_dump" "halcon_dump" "halcon_dump" "halcon_dump"

Beispiel (HDevelop)

dev_open_window (0, 0, 512, 512, 'black', WindowHandle)
read_image (Image, 'fabrik')
gen_circle (Circle, 200, 200, 100.5)
dev_display (Image)
dev_display (Circle)
dump_window(WindowHandle,'postscript','halcon_dump')

Beispiel (C)

/* PostScript - Dump of Image and Regions */
disp_image(Image,WindowHandle);
set_colored(WindowHandle,12);
disp_region(Regions,WindowHandle);
dump_window(WindowHandle,"postscript","halcon_dump");

Beispiel (HDevelop)

dev_open_window (0, 0, 512, 512, 'black', WindowHandle)
read_image (Image, 'fabrik')
gen_circle (Circle, 200, 200, 100.5)
dev_display (Image)
dev_display (Circle)
dump_window(WindowHandle,'postscript','halcon_dump')

Beispiel (HDevelop)

dev_open_window (0, 0, 512, 512, 'black', WindowHandle)
read_image (Image, 'fabrik')
gen_circle (Circle, 200, 200, 100.5)
dev_display (Image)
dev_display (Circle)
dump_window(WindowHandle,'postscript','halcon_dump')

Beispiel (HDevelop)

dev_open_window (0, 0, 512, 512, 'black', WindowHandle)
read_image (Image, 'fabrik')
gen_circle (Circle, 200, 200, 100.5)
dev_display (Image)
dev_display (Circle)
dump_window(WindowHandle,'postscript','halcon_dump')

Ergebnis

dump_windowdump_windowDumpWindowDumpWindowDumpWindow liefert den Wert 2 (H_MSG_TRUE), falls das passende Fenster gültig ist und die Parameter korrekt sind. Ansonsten wird eine Fehlerbehandlung durchgeführt.

Vorgänger

open_windowopen_windowOpenWindowOpenWindowOpenWindow, set_drawset_drawSetDrawSetDrawSetDraw, set_colorset_colorSetColorSetColorSetColor, set_coloredset_coloredSetColoredSetColoredSetColored, set_line_widthset_line_widthSetLineWidthSetLineWidthSetLineWidth, disp_regiondisp_regionDispRegionDispRegionDispRegion

Nachfolger

system_callsystem_callSystemCallSystemCallSystemCall

Siehe auch

open_windowopen_windowOpenWindowOpenWindowOpenWindow, set_systemset_systemSetSystemSetSystemSetSystem, dump_window_imagedump_window_imageDumpWindowImageDumpWindowImageDumpWindowImage

Modul

Foundation

KlassenKlassen | | Operatoren
HALCON Operator-Referenz 19.11.0.0 Copyright © 1996-2019 MVTec Software GmbH