<functions>
#AQL functions
#####################################################################
"FormShow"
function  : Manage/show the Form widget (parameter)
parameter : widget Form [, string Caption] [, integer Left] [, integer Top]
result    : no result returned

"FormDialog"
function  : Create a Form widget
parameter : integer Width, integer Height, boolean Toplevel(optional)
result    : a Form widget

"FormBase"
function  : Create a Base widget
parameter : 
result    : a Base widget

"FormLabel"
function  : Create a Label widget
parameter : widget Parent, integer Left, integer Top, string Caption
result    : a Label widget

"FormCommandButton"
function  : Create a CommandButton widget
parameter : widget Parent, integer Left, integer Top, integer Width, integer Height, string Caption
result    : a CommandButton widget

"FormTextBox"
function  : Create a TextBox widget
parameter : widget Parent, integer Left, integer Top, integer Width, integer Height
result    : a TextBox widget

"FormListBox"
function  : Create a ListBox widget
parameter : widget Parent, integer Left, integer Top, integer Width, integer Height
result    : a ListBox widget

"FormComboBox"
function  : Create a ComboBox widget
parameter : widget Parent, integer Left, integer Top, integer Width, integer Height
result    : a ComboBox widget

"FormFrame"
function  : Create a Frame widget
parameter : widget Parent, integer Left, integer Top, integer Width, integer Height
result    : a Frame widget

"FormOptionBox"
function  : Create a OptionBox widget
parameter : widget Parent, integer Left, integer Top, integer Width, integer Height, string Caption
result    : a OptionBox widget

"FormCheckBox"
function  : Create a CheckBox widget
parameter : widget Parent, integer Left, integer Top, integer Width, integer Height, string Caption
result    : a CheckBox widget

"FormMenu"
function  : Create a Menu widget
parameter : widget Parent, string Caption, boolean Checked(optional)
result    : a Menu widget

"FormPopup"
function  : Create a Menu widget
parameter : widget Parent
result    : a Menu widget

"FormPopupMenu"
function  : unkown
parameter : widget Menu
result    : no result returned

"FormHScrollBar"
function  : Create a ScrollBar widget
parameter : widget Parent, integer Left, integer Top, integer Width, integer Height
result    : a ScrollBar widget

"FormSlider"
function  : Create a Slider widget
parameter : widget Parent, integer Left, integer Top, integer Width(optional), integer Height(optional), boolean Horizontal(optional), integer Min(optional), integer Max(optional), string Caption(optional), integer DecimalPoints(optional), integer Value(optional), group BackColor(optional)
result    : a Slider widget

"FormVScrollBar"
function  : Create a ScrollBar widget
parameter : widget Parent, integer Left, integer Top, integer Width, integer Height
result    : a ScrollBar widget

"FormPictureBox"
function  : Create a PictureBox widget
parameter : widget Parent, integer Left, integer Top, integer Width, integer Height
result    : a PictureBox widget

"FormLine"
function  : Create a Line widget
parameter : widget Parent, integer X1(optional), integer Y1(optional), integer X2(optional), integer Y2(optional)
result    : a Line widget

"FormShape"
function  : Create a Shape widget
parameter : widget Parent, integer Left, integer Top, integer Width, integer Height
result    : a Shape widget

"FormMDIFrame"
function  : Create a MDIFrame widget
parameter : widget Parent, integer Left, integer Top, integer Width, integer Height, boolean Scrolled
result    : a MDIFrame widget

"FormMDIChild"
function  : Create a MDIChild widget
parameter : widget Parent, integer Left, integer Top, integer Width, integer Height, string Caption
result    : a MDIChild widget

"FormToMDIChild"
function  : Create a MDIChild widget
parameter : widget Form
result    : a MDIChild widget

"FormListFonts"
function  : Get list of available fonts (for use as attribute 'Font' of many widgets)
parameter : string Wildcard(optional), string Display(optional)
result    : group of fonts
            Examples:
              my_fonts = FormListFonts()
              my_fonts = FormListFonts("*")
              my_fonts = FormListFonts("?elv*", "indigo5")

"FormBitmap"
function  : Create a FormsBitmap - a data type for creating, drawing and manipulating bitmaps
parameter : group|string|object Data(optional), object Parent(optional), integer Left(optional), integer Top(optional), integer Width(optional), integer Height(optional)

            Examples for parameter 'Data':
            ------------------------------
            a. colored bitmap
            { 4, 2,                   // size
              {  { 1, 3, 26, 1 },     // color indices: first line
                 { 3, 1, 1,  1 },     //                2nd line
              },
              {  { 1,  {0  ,0,  0} }, // palette: {color index, {r, g, b}}
                 { 3,  {255,0,  0} }, 
                 { 26, {0  ,0,255} }
              }
            } 
 
            b. monochrome bitmap         
            { 4, 2,                   // size
              " 11 ",                 // '1' = black, ' ' = white
              " 11 " }

            or 
            { " 11 ",                 // '1' = black, ' ' = white
              " 11 " }

            c. empty bitmap, one color
            { 4, 2,                   // size
              { 0, 255, 0 }           // color
            }

            d. from file:
            string:filename   or   { string:filename }

            e. from FormsBitmap:
            FormsBitmap:bitmap   or   { FormsBitmap:bitmap }

            f. totally empty: {}
            

            Parameter 'Parent':
            -------------------
            a. AQL-types 'Forms*' (FormsForm, FormsPictureBox, FormsMDIChild etc.)
            b. AQL-type  'Bea_viewport_window' (e.g. program.list_viewports)
            c. AQL-type  'Window'

result    : a FormsBitmap

################################################################################
<type attributes>

"FormsBase"
"FormsForm"
.  "Left"
               "integer"
               "read / write access"
.  "Top"
               "integer"
               "read / write access"
.  "Width"
               "integer"
               "read / write access"
.  "Height"
               "integer"
               "read / write access"
.  "Caption"
               "string"
               "read / write access"
.  "BorderStyle"
               "integer"
               "read / write access"
.  "Resize"
               "Callback"
               "Callback called when the user Resizes the widget"
               "This attribute is write only"
.  "Load"
               "Callback"
               "Callback called when the user Loads the widget"
               "This attribute is write only"
.  "Unload"
               "Callback"
               "Callback called when the user Unloads the widget"
               "This attribute is write only"
.  "Paint"
               "Callback"
               "Callback called when the user Paints the widget"
               "This attribute is write only"
"FormsCore"
.  "Parent"
               "widget"
               "read only access"
.  "ParentForm"
               "widget"
               "read only access"
.  "Left"
               "integer"
               "read / write access"
.  "Top"
               "integer"
               "read / write access"
.  "Width"
               "integer"
               "read / write access"
.  "Height"
               "integer"
               "read / write access"
.  "Enabled"
               "boolean"
               "read / write access"
.  "SetFocus"
               "boolean"
               "read / write access"
.  "Visible"
               "boolean"
               "read / write access"
.  "ForeColor"
               "group"
               "read / write access"
.  "BackColor"
               "group"
               "read / write access"
.  "BorderStyle"
               "integer"
               "read / write access"
.  "Tooltip"
               "string"
               "read / write access"
.  "Font"
               "string"
               "read / write access"
"FormsLabel"
.  "Parent"
               "widget"
               "read only access"
.  "ParentForm"
               "widget"
               "read only access"
.  "Left"
               "integer"
               "read / write access"
.  "Top"
               "integer"
               "read / write access"
.  "Width"
               "integer"
               "read / write access"
.  "Height"
               "integer"
               "read / write access"
.  "Enabled"
               "boolean"
               "read / write access"
.  "SetFocus"
               "boolean"
               "read / write access"
.  "Visible"
               "boolean"
               "read / write access"
.  "ForeColor"
               "group"
               "read / write access"
.  "BackColor"
               "group"
               "read / write access"
.  "BorderStyle"
               "integer"
               "read / write access"
.  "Tooltip"
               "string"
               "read / write access"
.  "Font"
               "string"
               "read / write access"
.  "Caption"
               "string"
               "read / write access"
.  "AutoSize"
               "boolean"
               "read / write access"
.  "MouseDown"
               "Callback"
               "Callback called when the user MouseDowns the widget"
               "This attribute is write only"
"FormsCommandButton"
.  "Parent"
               "widget"
               "read only access"
.  "ParentForm"
               "widget"
               "read only access"
.  "Left"
               "integer"
               "read / write access"
.  "Top"
               "integer"
               "read / write access"
.  "Width"
               "integer"
               "read / write access"
.  "Height"
               "integer"
               "read / write access"
.  "Enabled"
               "boolean"
               "read / write access"
.  "SetFocus"
               "boolean"
               "read / write access"
.  "Visible"
               "boolean"
               "read / write access"
.  "ForeColor"
               "group"
               "read / write access"
.  "BackColor"
               "group"
               "read / write access"
.  "BorderStyle"
               "integer"
               "read / write access"
.  "Tooltip"
               "string"
               "read / write access"
.  "Font"
               "string"
               "read / write access"
.  "Caption"
               "string"
               "read / write access"
.  "Cancel"
               "boolean"
               "read / write access"
.  "Default"
               "boolean"
               "read / write access"
.  "Click"
               "Callback"
               "Callback called when the user Clicks the widget"
               "This attribute is write only"
.  "MouseDown"
               "Callback"
               "Callback called when the user MouseDowns the widget"
               "This attribute is write only"
"FormsTextBox"
.  "Parent"
               "widget"
               "read only access"
.  "ParentForm"
               "widget"
               "read only access"
.  "Left"
               "integer"
               "read / write access"
.  "Top"
               "integer"
               "read / write access"
.  "Width"
               "integer"
               "read / write access"
.  "Height"
               "integer"
               "read / write access"
.  "Enabled"
               "boolean"
               "read / write access"
.  "SetFocus"
               "boolean"
               "read / write access"
.  "Visible"
               "boolean"
               "read / write access"
.  "ForeColor"
               "group"
               "read / write access"
.  "BackColor"
               "group"
               "read / write access"
.  "BorderStyle"
               "integer"
               "read / write access"
.  "Tooltip"
               "string"
               "read / write access"
.  "Font"
               "string"
               "read / write access"
.  "Text"
               "string"
               "read / write access"
.  "LostFocus"
               "Callback"
               "Callback called when the user LostFocuss the widget"
               "This attribute is write only"
.  "MouseDown"
               "Callback"
               "Callback called when the user MouseDowns the widget"
               "This attribute is write only"
.  "KeyUp"
               "Callback"
               "Callback called when the user KeyUps the widget"
               "This attribute is write only"
.  "KeyPress"
               "Callback"
               "Callback called when the user KeyPresss the widget"
               "This attribute is write only"
.  "KeyDown"
               "Callback"
               "Callback called when the user KeyDowns the widget"
               "This attribute is write only"
"FormsListBox"
.  "Parent"
               "widget"
               "read only access"
.  "ParentForm"
               "widget"
               "read only access"
.  "Left"
               "integer"
               "read / write access"
.  "Top"
               "integer"
               "read / write access"
.  "Width"
               "integer"
               "read / write access"
.  "Height"
               "integer"
               "read / write access"
.  "Enabled"
               "boolean"
               "read / write access"
.  "SetFocus"
               "boolean"
               "read / write access"
.  "Visible"
               "boolean"
               "read / write access"
.  "ForeColor"
               "group"
               "read / write access"
.  "BackColor"
               "group"
               "read / write access"
.  "BorderStyle"
               "integer"
               "read / write access"
.  "Tooltip"
               "string"
               "read / write access"
.  "Font"
               "string"
               "read / write access"
.  "MultiSelect"
               "string"
               "read / write access"
.  "List"
               "group"
               "read / write access"
.  "ListIndex"
               "group"
               "read / write access"
.  "ListCount"
               "integer"
               "read only access"
.  "ValueVS"
               "integer"
               "read / write access"
.  "ValueHS"
               "integer"
               "read / write access"
.  "Click"
               "Callback"
               "Callback called when the user Clicks the widget"
               "This attribute is write only"
.  "DblClick"
               "Callback"
               "Callback called when the user DblClicks the widget"
               "This attribute is write only"
.  "MouseDown"
               "Callback"
               "Callback called when the user MouseDowns the widget"
               "This attribute is write only"
.  "MoveVS"
               "Callback"
               "Callback called when the user MoveVSs the widget"
               "This attribute is write only"
.  "MoveHS"
               "Callback"
               "Callback called when the user MoveHSs the widget"
               "This attribute is write only"
"FormsComboBox"
.  "Parent"
               "widget"
               "read only access"
.  "ParentForm"
               "widget"
               "read only access"
.  "Left"
               "integer"
               "read / write access"
.  "Top"
               "integer"
               "read / write access"
.  "Width"
               "integer"
               "read / write access"
.  "Height"
               "integer"
               "read / write access"
.  "Enabled"
               "boolean"
               "read / write access"
.  "SetFocus"
               "boolean"
               "read / write access"
.  "Visible"
               "boolean"
               "read / write access"
.  "List"
               "group"
               "read / write access"
.  "ListIndex"
               "integer"
               "read / write access"
.  "Click"
               "Callback"
               "Callback called when the user Clicks the widget"
               "This attribute is write only"
"FormsFrame"
.  "Parent"
               "widget"
               "read only access"
.  "ParentForm"
               "widget"
               "read only access"
.  "Left"
               "integer"
               "read / write access"
.  "Top"
               "integer"
               "read / write access"
.  "Width"
               "integer"
               "read / write access"
.  "Height"
               "integer"
               "read / write access"
.  "Enabled"
               "boolean"
               "read / write access"
.  "SetFocus"
               "boolean"
               "read / write access"
.  "Visible"
               "boolean"
               "read / write access"
.  "ForeColor"
               "group"
               "read / write access"
.  "BackColor"
               "group"
               "read / write access"
.  "BorderStyle"
               "integer"
               "read / write access"
.  "Tooltip"
               "string"
               "read / write access"
.  "Font"
               "string"
               "read / write access"
.  "MouseDown"
               "Callback"
               "Callback called when the user MouseDowns the widget"
               "This attribute is write only"
.  "Paint"
               "Callback"
               "Callback called when the user Paints the widget"
               "This attribute is write only"
"FormsOptionBox"
.  "Parent"
               "widget"
               "read only access"
.  "ParentForm"
               "widget"
               "read only access"
.  "Left"
               "integer"
               "read / write access"
.  "Top"
               "integer"
               "read / write access"
.  "Width"
               "integer"
               "read / write access"
.  "Height"
               "integer"
               "read / write access"
.  "Caption"
               "string"
               "read / write access"
.  "Value"
               "boolean"
               "read / write access"
.  "Enabled"
               "boolean"
               "read / write access"
.  "Font"
               "string"
               "read / write access"
.  "Tooltip"
               "string"
               "read / write access"
.  "Click"
               "Callback"
               "Callback called when the user Clicks the widget"
               "This attribute is write only"
"FormsCheckBox"
.  "Parent"
               "widget"
               "read only access"
.  "ParentForm"
               "widget"
               "read only access"
.  "Left"
               "integer"
               "read / write access"
.  "Top"
               "integer"
               "read / write access"
.  "Width"
               "integer"
               "read / write access"
.  "Height"
               "integer"
               "read / write access"
.  "Enabled"
               "boolean"
               "read / write access"
.  "SetFocus"
               "boolean"
               "read / write access"
.  "Visible"
               "boolean"
               "read / write access"
.  "ForeColor"
               "group"
               "read / write access"
.  "BackColor"
               "group"
               "read / write access"
.  "BorderStyle"
               "integer"
               "read / write access"
.  "Tooltip"
               "string"
               "read / write access"
.  "Font"
               "string"
               "read / write access"
.  "Caption"
               "string"
               "read / write access"
.  "Value"
               "boolean"
               "read / write access"
.  "Click"
               "Callback"
               "Callback called when the user Clicks the widget"
               "This attribute is write only"
"FormsMenu"
.  "Parent"
               "widget"
               "read only access"
.  "ParentForm"
               "widget"
               "read only access"
.  "Caption"
               "string"
               "read / write access"
.  "Checked"
               "boolean"
               "read / write access"
.  "Enabled"
               "boolean"
               "read / write access"
.  "Visible"
               "boolean"
               "read / write access"
.  "Shortcut"
               "string"
               "read / write access"
.  "Click"
               "Callback"
               "Callback called when the user Clicks the widget"
               "This attribute is write only"
"FormsScrollBar"
.  "Parent"
               "widget"
               "read only access"
.  "ParentForm"
               "widget"
               "read only access"
.  "Left"
               "integer"
               "read / write access"
.  "Top"
               "integer"
               "read / write access"
.  "Width"
               "integer"
               "read / write access"
.  "Height"
               "integer"
               "read / write access"
.  "Enabled"
               "boolean"
               "read / write access"
.  "SetFocus"
               "boolean"
               "read / write access"
.  "Visible"
               "boolean"
               "read / write access"
.  "ForeColor"
               "group"
               "read / write access"
.  "BackColor"
               "group"
               "read / write access"
.  "BorderStyle"
               "integer"
               "read / write access"
.  "Tooltip"
               "string"
               "read / write access"
.  "Font"
               "string"
               "read / write access"
.  "Horizontal"
               "boolean"
               "read only access"
.  "Min"
               "integer"
               "read / write access"
.  "Max"
               "integer"
               "read / write access"
.  "SmallChange"
               "integer"
               "read / write access"
.  "LargeChange"
               "integer"
               "read / write access"
.  "Value"
               "integer"
               "read / write access"
.  "Change"
               "Callback"
               "Callback called when the user Changes the widget"
               "This attribute is write only"
.  "Move"
               "Callback"
               "Callback called when the user Moves the widget"
               "This attribute is write only"
"FormsSlider"
.  "Parent"
               "widget"
               "read only access"
.  "ParentForm"
               "widget"
               "read only access"
.  "Left"
               "integer"
               "read / write access"
.  "Top"
               "integer"
               "read / write access"
.  "Width"
               "integer"
               "read / write access"
.  "Height"
               "integer"
               "read / write access"
.  "Enabled"
               "boolean"
               "read / write access"
.  "SetFocus"
               "boolean"
               "read / write access"
.  "Visible"
               "boolean"
               "read / write access"
.  "ForeColor"
               "group"
               "read / write access"
.  "BackColor"
               "group"
               "read / write access"
.  "BorderStyle"
               "integer"
               "read / write access"
.  "Tooltip"
               "string"
               "read / write access"
.  "Font"
               "string"
               "read / write access"
.  "Horizontal"
               "boolean"
               "read / write access"
.  "Min"
               "integer"
               "read / write access"
.  "Max"
               "integer"
               "read / write access"
.  "Value"
               "integer"
               "read / write access"
.  "DecimalPoints"
               "integer"
               "read / write access"
.  "Caption"
               "string"
               "read / write access"
.  "Change"
               "Callback"
               "Callback called when the user Changes the widget"
               "This attribute is write only"
"FormsPictureBox"
.  "Parent"
               "widget"
               "read only access"
.  "ParentForm"
               "widget"
               "read only access"
.  "Left"
               "integer"
               "read / write access"
.  "Top"
               "integer"
               "read / write access"
.  "Width"
               "integer"
               "read / write access"
.  "Height"
               "integer"
               "read / write access"
.  "Enabled"
               "boolean"
               "read / write access"
.  "SetFocus"
               "boolean"
               "read / write access"
.  "Visible"
               "boolean"
               "read / write access"
.  "ForeColor"
               "group"
               "read / write access"
.  "BackColor"
               "group"
               "read / write access"
.  "BorderStyle"
               "integer"
               "read / write access"
.  "Tooltip"
               "string"
               "read / write access"
.  "Font"
               "string"
               "read / write access"
.  "Picture"
               "group"
               "read / write access"
.  "AutoSize"
               "boolean"
               "read / write access"
.  "Click"
               "Callback"
               "Callback called when the user Clicks the widget"
               "This attribute is write only"
.  "DoubleClick"
               "Callback"
               "Callback called when the user DoubleClicks the widget"
               "This attribute is write only"
.  "MouseDown"
               "Callback"
               "Callback called when the user MouseDowns the widget"
               "This attribute is write only"
.  "MouseUp"
               "Callback"
               "Callback called when the user MouseUps the widget"
               "This attribute is write only"
.  "MouseMove"
               "Callback"
               "Callback called when the user MouseMoves the widget"
               "This attribute is write only"
"FormsLine"
.  "Parent"
               "widget"
               "read only access"
.  "ParentForm"
               "widget"
               "read only access"
.  "X1"
               "integer"
               "read / write access"
.  "Y1"
               "integer"
               "read / write access"
.  "X2"
               "integer"
               "read / write access"
.  "Y2"
               "integer"
               "read / write access"
.  "DrawMode"
               "integer"
               "read / write access"
.  "Visible"
               "boolean"
               "read / write access"
.  "BorderColor"
               "integer"
               "read / write access"
"FormsShape"
.  "Parent"
               "widget"
               "read only access"
.  "ParentForm"
               "widget"
               "read only access"
.  "Left"
               "integer"
               "read / write access"
.  "Top"
               "integer"
               "read / write access"
.  "Width"
               "integer"
               "read / write access"
.  "Height"
               "integer"
               "read / write access"
.  "DrawMode"
               "integer"
               "read / write access"
.  "Visible"
               "boolean"
               "read / write access"
.  "BorderColor"
               "integer"
               "read / write access"
.  "Shape"
               "integer"
               "read / write access"
"FormsTooltip"
.  "dummy"
               "string"
               "read only access"
"FormsMDIFrame"
.  "Parent"
               "widget"
               "read only access"
.  "Left"
               "integer"
               "read only access"
.  "Top"
               "integer"
               "read only access"
.  "Width"
               "integer"
               "read only access"
.  "Height"
               "integer"
               "read only access"
.  "Scrolled"
               "boolean"
               "read only access"
.  "Resize"
               "Callback"
               "Callback called when the user Resizes the widget"
               "This attribute is write only"
"FormsMDIChild"
.  "Parent"
               "widget"
               "read only access"
.  "Left"
               "integer"
               "read / write access"
.  "Top"
               "integer"
               "read / write access"
.  "Width"
               "integer"
               "read / write access"
.  "Height"
               "integer"
               "read / write access"
.  "Caption"
               "string"
               "read / write access"
.  "Minimized"
               "boolean"
               "read / write access"
.  "Maximized"
               "boolean"
               "read / write access"
.  "IconColor"
               "group"
               "read / write access"
.  "Tooltip"
               "string"
               "read / write access"
.  "Resize"
               "Callback"
               "Callback called when the user Resizes the widget"
               "This attribute is write only"
"FormsBitmap"
.  "Data"
               "group"
               "read / write access"
               "syntax: see parameter 'Data' of function FormBitmap()"
.  "Parent"
               "object"
               "read / write access"
.  "Left"
               "integer"
               "read / write access"
.  "Top"
               "integer"
               "read / write access"
.  "Width"
               "integer"
               "read / write access"
               " "
               "Examples for using the Methods of FormsBitmap:"
               "----------------------------------------------"
               "Replace one color in 'bitm':"
               "ok = bitm.ChangeColor ( {r_old,g_old,b_old},"
               "                        {r_new,g_new,b_new} )"
               " "
               "Clear undo, keep 'keep_steps':"
               "ok = bitm.ClearUndo (keep_steps)"
               " "
               "Copy from 'FromObject' (Forms*, Bea_viewport_window,"
               "Window) to the paste-buffer:"
               "ok = bitm.Copy (FromObject, from_x, from_y,"
               "                from_width, from_height)"
               " "
               "Cut from 'FromObject' (Forms*, Bea_viewport_window,"
               "Window) to the paste-buffer:"
               "ok = bitm.Cut (from, from_x, from_y,"
               "               from_width, from_height)"
               " "
               "ok = bitm.DetachParent() // -> has no Parent any longer"
               " "
               "Draw various objects (FormsBitmap, circle, ellips etc.)"
               "into 'bitm':"
               "ok = bitm.DrawBitmap(myFormsBitmap,x,y,w,h,transparent)"
               "ok = bitm.DrawCircle (center_x,center_y,radius,{r,g,b})"
               "ok = bitm.DrawEllips (center_x,center_y,"
               "                      radius_x,radius_y,{r,g,b})"
               "ok = bitm.DrawFilledRectangle (x,y,w,h,{r,g,b})"
               "ok = bitm.DrawLine (p1_x, p1_y, p2_x, p2_y, {r,g,b})"
               "ok = bitm.DrawPoint (x,y,{r,g,b})"
               "ok = bitm.DrawRectangle (x,y,w,h,{r,g,b)"
               "ok = bitm.DrawShape (my_FormsShape)"
               " "
               "Draw a text (annotation) into 'bitm':"
               "font       = "helvr10" // (default font = "")"
               "text_angle = 90.0      // degrees"
               "ok = bitm.DrawText ("my_text",x,y, {r,g,b},"
               "                    font, text_angle, inverse)"
               " "
               "Create a duplicate of 'bitm':"
               "bitm_dupl = bitm.Duplicate()"
               " "
               "ok = bitm.Erase() // temporarily remove from screen"
               " "
               "Change size without changing the scale:"
               "ok = bitm.Extend (new_width, new_height)"
               "  "
               "Get color at position x,y in bitmap 'bitm':"
               "my_rgb = bitm.GetColor(x,y) // -> {r,g,b}"
               " "
               "ok = bitm.Invert()    // invert all colors"
               "ok = bitm.MirrorX()   // mirror at x-axis"
               "ok = bitm.MirrorY()   // mirror at y-axis"
               "ok = bitm.Pan(dx,dy)  // pan"
               " "
               "Paste contents of paste-buffer to"
               "'ToObject' (Forms*, Bea_viewport_window,Window or"
               "FormsBitmap):"
               "ok = bitm.Paste (ToObject, x, y,transparent)"
               " "
               "Read contents of 'bitm' from file:"
               "keep_size = true // don't change size of 'bitm'"
               "ok = bitm.Read ("xxx.bmp",keep_size)"
               " "
               "ok = bitm.Redo()   // Undo Undo"
               "ok = bitm.Redraw() // Refresh"
               " "
               "Remove all callbacks 'Click', 'DoubleClick' and 'Move':"
               "ok = bitm.RemoveCallbacks()"
               " "
               "Change size (scale will change):"
               "ok = bitm.Resize (new_width, new_height)"
               " "
               "Rotate 'bitm':"
               "center_x=-1 center_y=-1 // take center of bitmap"
               "ok = bitm.Rotate (angle_degrees, center_x, center_y)"
               " "
               "Create snapshot from 'FromObject'"
               "(Forms*, Bea_viewport_window or Window):"
               "FromObject = program.list_viewports.el_1"
               "keep_size  = true // don't change size of 'bitm'"
               "ok = bitm.Snapshot (FromObject, x, y, w, h, keep_size)"
               " "
               "ok = bitm.StoreUndo() // store one Undo step"
               " "
               "Create new bitmap from part of 'bitm':"
               "bitm_sub = bitm.SubImage (fromx,fromy,w,h,scale)"
               " "
               "ok = bitm.Undo(1) // Undo one step (the last one)"
               "ok = bitm.View("my_comment") // show in viewer"
               " "
               "Write to file:"
               "ok = bitm.Write ("xxx.tif", "tif", bring_message)"
               " "
               "ok = bitm.ZoomIn(x,y,w,h) // magnify"
               " "

.  "Height"
               "integer"
               "read / write access"
.  "Visible"
               "boolean"
               "read / write access"
.  "Transparent"
               "boolean"
               "read / write access"
.  "Valid"
               "boolean"
               "read only access"
.  "BackColor"
               "group"
               "read / write access"
.  "NumberOfColors"
               "integer"
               "read only access"
.  "Palette"
               "group"
               "read only access"
.  "Monochrome"
               "boolean"
               "read / write access"
.  "Greyscale"
               "boolean"
               "read / write access"
.  "NumberUndo"
               "integer"
               "read only access"
.  "Click"
               "Callback"
               "Callback called when the user Clicks the bitmap"
               "This attribute is write only"
.  "DoubleClick"
               "Callback"
               "Callback called when the user DoubleClicks the bitmap"
               "This attribute is write only"
.  "Move"
               "Callback"
               "Callback called when the user Moves inside the bitmap"
               "This attribute is write only"

################################################################################
<variables>
