Promotic
WikipediaLinkedInYoutubeTwitterFacebook

PrintToBmp - metoda objektu PmPanel

Popis:
Uložení obrazu nebo jeho části do souboru *.bmp, *.png, *.jpg, *.gif nebo *.tif.

Tato metoda je zastaralá (ale funkční). Viz PmPanel.Print, PmiRoot.Print.

Syntaxe:
PrintToBmp(sFile As String, [sOptions As String], [sParams As String]) As Boolean
Volání:
b = oPanel.PrintToBmp(sFile, sOptions)
Parametry:
sFile(String) Název souboru (*.bmp, *.png, *.jpg, *.gif nebo *.tif) s cestou. Přípona souboru určuje formát uložení. Pokud není zadána celá cesta, doplní se relativně vzhledem k souborové složce aplikace.

Je doporučeno použít cestu v syntaxi PROMOTIC - viz PROMOTIC cesta k souborům nebo složkám.

sOptions[nepovinné] (String) Textový seznam dodatečných parametrů definující způsob tisku (výřez, atd.). Neuvede-li se, tiskne se celý obraz s implicitními nastaveními. Údaje s přiřazenou hodnotou jsou zde odděleny středníkem, například "x:0;y:0;dx:300;dy:200;".
"x:nnn;" (nepovinné) - Pozice x levého horního bodu výřezu (v pixelech, přednastaveno 0).
"y:nnn;" (nepovinné) - Pozice y levého horního bodu výřezu (v pixelech, přednastaveno 0).
"dx:nnn;" (nepovinné) - Velikost x výřezu (implicitně celý obraz) (v pixelech).
"dy:nnn;" (nepovinné) - Velikost y výřezu (implicitně celý obraz) (v pixelech).
sParams[nepovinné] (String) Umožňuje nastavit hodnotu parametrů grafického prvku PmiRoot. Tento parametr je pak přístupný v konfigurátorech obrazu pomocí Makro výraz $.par a ze skriptu pomocí metody GetPar. Každý jednotlivý parametr je tvořen identifikátorem (název) a hodnotou. Syntaxe: "par:name1=value1;par:name2=value2; ...". Viz také: Parametry grafického prvku. Textový seznam dodatečných parametrů definující způsob tisku (výřez, atd.). Neuvede-li se, tiskne se celý obraz s implicitními nastaveními. Viz Výchozí hodnota sParams.
Vrácená hodnota:
true - pokud byl obraz úspěšně uložen.
false - v opačném případě
Poznámka:
Pokud se tato metoda vyvolá nad obrazem, který není otevřen, obraz se neviditelně otevře a po tisku zavře. Přitom se nevyvolají události onOpen a onClose.

Upozornění! Okenní grafické prvky nemusí být zobrazeny vždy správně (např. prvek PmiWAnimate v módu přehrávání Multimediální), protože se nestihnou včas vytvořit nebo načíst data.

Charakteristika základních tří grafických formátů:

*.bmp - zcela bez komprese, soubory jsou největší ze všech formátů.
*.png - bezeztrátová komprese, obraz je v originální kvalitě, soubory jsou značně menší (doporučený formát).
*.jpg - ztrátová komprese, obraz už není v originální kvalitě, ale soubory jsou nejmenší z dostupných formátů.
Příklad1:
Uložení celého obrazu do souboru test.bmp:
oPanel.PrintToBmp "#appres:test.bmp"
Příklad2:
Uložení výřezu části obrazu do souboru test.png, kde výřez začíná na pozici 100,100 a jeho velikost je 300,200:
oPanel.PrintToBmp "#appres:test.png", "x:100;y:100;dx:300;dy:200;"
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice