Promotic

Object PmgRasterImage (Raster image)

Description:
This object serves for displaying images with raster (PNG, JPG, GIF, TIF, BMP ...) and vector (SVG, WMF) graphic.
The vector SVG graphic is rendered as vector, but after that it is processed the same way as raster graphic. The advantage of vector graphic is thar the original image redimensioning does not reduce the image quality keeping the image "nice". Therefore all images supplied with the PROMOTIC system are in SVG format.
For the designer, creating the images to fit his needs it may be easier to make images for example in the PNG format or JPG.

The PmgRasterImage object allows:
- rotation (see the "Flip and rotate" configurator)
- coloring (see the "Light color" configurator)
- transparency of entire image (see the "Enable opacity" configurator)
- image exclusion display (see the "Crop image" configurator)


The Pmg object doesn't include the data itself from the file, it is only the reference to the file. The designer must ensure so that the corresponding file is always accessible by the application - by correctly entering the filename and setting the path to the file. It is recommended to use the files located on #pmres: or #appres: paths only
This object inherits properties, methods and events of the PmgObject object.
Properties and methods of this object:
ColorBgBackground color
ColorItemLight color
RotationImage rotation and flip
SrcThe file name with the path to the file with the picture
Properties and methods inherited from the PmgObject object:
AddEvent()Registers a function into the specified event
Blink()Starts/stops blinking of the Pmg object
DxWidth of the Pmg object
DyHeight of the Pmg object
EnabledEnable/disable the control, i.e. user's inputs to the object
FocusDetects/set the focus of the Pmg object
GetChildByIndex()Returns the nested Pmg object defined by order
GetChildCount()Returns the number of nested Pmg objects
GetPathName()Object name with the path to this object
GetItemInfo()Returns special information regarding the Pmg object
GetPar()Reading the value of the Pmg object parameter (or its parents)
IniDxInitial width of the Pmg object
IniDyInitial height of the Pmg object
IniXInitial X-position of the left upper corner of the Pmg object relative to superior object
IniYInitial Y-position of the left upper corner of the Pmg object relative to superior object
Items()Returns reference to Pmg object
MethodsAccess to designer's methods of this object
MouseOnIdentification if the mouse cursor finds itself over the Pmg object
NameThe name of the Pmg object
ParentReturns reference to the parent Pmg object
Pm()Returns the Pma object (obsolete)
PmPanelReturns reference to the PmaPanel object where the Pmg object is placed
Refresh()Refresh of the Pmg object
RemoveEvent()Unregisters the function in the specified event
RootReturns reference to the root PmgRoot object
ShowMenu()Opens local menu of the Pmg object
ScreenXX-coordinate of the left upper corner of the Pmg object relative to computer screen
ScreenYY-coordinate of the left upper corner of the Pmg object relative to computer screen
ToolTipTooltip text of the Pmg object
Vars()Returns the variable of the Pmg object
ViewXPosition of X-coordinate of the left upper corner of the Pmg object relative to the PmgRoot object
ViewYPosition of the Y-coordinate of the left upper corner of the Pmg object relative to the PmgRoot object
VisibleSets the visibility/invisibility of the Pmg object
XX-coordinate of the left upper corner of the Pmg object relative to superior Pmg object
YY-coordinate of the left upper corner of the Pmg object relative to superior Pmg object
Events inherited from the PmgObject object:
onStartIs triggered on the construction of the Pmg object in the course of opening the panel
onStopIs triggered on the destruction of the Pmg object in the course of closing the panel
onRefreshIs triggered on the data refresh of the Pmg object
onKeyPressIs triggered after pressing or releasing the key of the keyboard
onMousePressIs triggered after pressing or releasing the left mouse button
onMenuFillIs triggered after pressing by the right mouse button over the Pmg object
onMenuSelectIs triggered on the selection of the item from the Pmg object local menu
onModeChangeIs triggered when the Pmg object mode changes
onFocusInIs triggered if the object receives focus
onFocusOutIs triggered if the object loses focus
Configuration tabs:
ObjectGeneral information about the object
PositionSetting the position, width and height of the Pmg object
VariablesList and configuration of user defined Pmg object variables
EventsAlgorithms definition for the object events
MethodsDefinition of designer's method of the Pmg object
ImageImage properties.
See also:
- PmgAnimImage (object)

History:
Pm9.00.00: Object name changed: PmiRasterImage -> PmgRasterImage
Pm8.03.01: Fixed bug: The transparency defined of the "Opacity level" configurator was sometimes rendered incorrectly.
Pm8.02.16: Support for WMF format added.
Pm8.02.13: If the "Size" configurator was set to "Over parent", then the PNG format image did not display correctly on the Web.
Pm8.00.05: has new properties ColorItem (light color) and ColorBg (Background color).
PROMOTIC 9.0.27 SCADA system documentation MICROSYS, spol. s r.o.

Send page remarkContact responsible person
© MICROSYS, spol. s r.o.