<< Click to Display Table of Contents >> Navigation: 3. Script Language > Image/Pixel-Color Operations > Undercover and Graphics > Undercover Operations |
MiniRobotLanguage (MRL)
UCV.transparency
UCV.tra
Change transparency value of Cover
Intention
This command is used to change the transparency value of the screen cover.
A value of 1 will make it completely transparent, a value of 255 will make it opaque.
All values between will change the cover visibility to any value between.
The transparency command is a modifier command. It is used to modify an existing cover, or to modify an cover that is soon to be created.
The "desktop-picture cover" is shown with the simple line:
UCV.dc
PAU.10
' This line will remove the cover
UCV.
The desktop-cover behavior can be changed/customized using the additional features:
UCV.transparency
UCV.no transparency
UCV.no blend
UCV.no blend-in
UCV.no blend-out
UCV.write
' this line will remove the cover
UCV.close
You can make the desktop-cover half transparent, by prefixing the script with:
UCV.tra
UCV.dc
PAU.10
' This line will remove the cover
UCV.
A transparency value of 0 (zero) which is used after the cover has been created, will deactivate the cover while its still there. You can switch it on later just by giving another transparency value. Here is an example:
UCV.cov
UCV.tra|0
UCV.bgr|&HFF00FF
UCV.pri|$$TXT
UCV.tra|126
PAU.4
UCV.
ENR.
* PopUp-Menus and other TopMost Forms may be able to get temporarily in front of the Cover-form. This is due to windows-technical reasons and not a bug.
Syntax
UCV.transparency[|P1]
UCV.tra[|P1]
Parameter Explanation
P1 - (optional) transparency value between 1 and 255. If omitted 128 is used. A transparency value of 0 can only be used for a cover that already exists. In that case the cover will be deactivated. It can still be printed and painted on the cover, even though it seems not to be there. You can later make it visible just by changing the transparency value to a higher value.
Example
'***********************************
' UCV.-Sample
' In this Mode, the cover will fade in slowly
' which is invisible if no on going
' changes on the desktop happen.
'***********************************
' Switch cover on
UCV.desktop-copy
PAU.20
UCV.
ENR.
'***********************************
' UCV.-Sample 2
' In this Mode, the cover will appear immediately.
'
'***********************************
' prevent fade-in
UCV.no blend-in
' Switch cover on
UCV.desktop-copy
PAU.20
UCV.
ENR.
'***********************************
' UCV.-Sample 3
' In this Mode, the cover will appear
' and then be faded to transparent.
'
'***********************************
'
UCV.dc
UCV.tra
PAU.10
' This line will remove the cover
UCV.
'***********************************
' UCV.-Sample 4
' We will make the existing cover to disappear
' using a transparency value of 0.
' Then we print on the cover and just
' make it visible again.
'
'***********************************
'
UCV.cov
UCV.tra|0
UCV.bgr|&HFF00FF
UCV.pri|$$TXT
UCV.tra|126
PAU.4
UCV.
ENR.
Remarks
Any cover is been removed immediately, when the script-process ends or when the script runs into an error.
Limitations:
-
See also:
• ! Smart Package Robot 's Undercover Operations
• ! UCV. - Undercover Graphics