Aros/Developer/Scalos
< Aros
Introduction
[edit | edit source]This is an incomplete guide, please support
- scalos.library - This library is used as application interface for the Scalos Workbench replacement
- scalosgfx.library - This documentation gives you information about scalosgfx.library
- scalos API - This documentation gives you information on how to communicate with Scalos and its windowtasks
- Scalos devicelist - This class is used to generate a list of all currently available devices
- Scalos devicewindow - This class implements the main Workbench (= root) window, which shows the icons for the mounted devices and volumes
- Scalos filetrans - This class is used to display a progress window showing the user what is currently going on while copying or moving files/directories
- Scalos root - This class is used for some fundamental message and event handling
- Scalos window - This class implements all common window functionality used for icon windows, text windows and device windows
- Scalos iconwindow - This class implements the functionality for the common Workbench icon windows
- Scalos textwindow - This class implements the text-only Scalos windows
- Scalos title - This class implements the screen title and window title functionality
- preferences.library - This library provides a convenient way to store the preferences for your program
- iconobject.library - This library is an interface to the iconobject.datatype
- iconobject.datatype - The iconobject.datatype has a special API to work with icons. makes both images, tooltypes and many more
AROS icon.library won't work on Scalos. Scalos uses its own iconobject.library and an iconobject datatype system enable the support for icon.library or other icons somewhere in the Scalos menu
Developer Docs
[edit | edit source]Scalos
[edit | edit source]--background SCA_AddBob SCA_AllocMessage SCA_AllocNode SCA_AllocStdNode SCA_CountWBArgs SCA_DisposeScalosObject SCA_DrawDrag SCA_EndDrag SCA_FreeAllNodes SCA_FreeMessage SCA_FreeNode SCA_FreeScalosClass SCA_FreeWBArgs SCA_GetDefIconObject SCA_InitDrag SCA_LockDrag SCA_LockWindowList SCA_MakeScalosClass SCA_MakeWBArgs SCA_MoveNode SCA_NewAddAppIcon SCA_NewAddAppMenuItem SCA_NewAddAppWindow SCA_NewScalosObject SCA_OpenDrawerByName SCA_OpenIconWindow SCA_RemoveAppObject SCA_ScalosControlA SCA_ScreenTitleMsg SCA_SortNodes SCA_SwapNodes SCA_UnlockDrag SCA_UnLockWindowList SCA_UpdateIcon SCA_WBStart
NAME
--background
DESCRIPTION
This library is used as application interface for the Scalos
workbenchreplacement. It's only available if Scalos is running.
This means if the library-open fails Scalos isn't running.
For information about NodeList see SCA_SortNodes() and Node see
SCA_AllocStdNode().
NAME
SCA_WBStart
SYNOPSIS
succ SCA_WBStart (ArgArray, Taglist, NumArgs )
A0 A1 D0
BOOL SCA_WBStart ( struct WBArg *ArgArray ,
const struct TagItem *Taglist, ULONG NumArgs );
BOOL SCA_WBStartTags( struct WBArg *ArgArray , ULONG NumArgs,
ULONG FirstTag, ... );
FUNCTION
The first argument is used as filename for the to started program.
The Locks inside the ArgArray are automatically unlocked (use DupLock)
and the strings are copied.
The first element in ArgArray must contain the directory lock and
name of the icon to start.
INPUTS
ArgArray - Standard Workbench Args
NumArgs - Number of Args in the ArgArray. This must be at least
one.
Taglist - Pointer to a taglist.
TAGS
SCA_IconObject (Object *) - iconobject.library - IconObject to get
information from it. No icon will be loaded.
SCA_Priority (LONG) - priority for the newly started process
SCA_Stacksize (ULONG) - stack size if no icon is available
SCA_WaitTimeout (ULONG) - wait timeout in seconds
SCA_Flags (ULONG) - Flags
SCAF_WBStart_NoIcon - don't read an icon.
SCAF_WBStart_Wait - wait until the program returns
SCAF_WBStart_PathSearch - search through paths
SCAF_WBStart_NoIconCheck - don't check icon type
RESULT
succ - FALSE if the start fails. It only fails if not enough
memory available or the WBL task couldn't be started.
If the program couldn't be loaded it will return TRUE, because
of it doesn't wait for the returncode of WBL task.
NOTE
Locks will *NOT* be unlocked if this function fails!
SEE ALSO
diskobject.library
NAME
SCA_SortNodes
SYNOPSIS
SCA_SortNodes (NodeList, CompareFunc, SortType)
A0 A1 D0
void SCA_SortNodes ( struct ScalosNodeList *, struct Hook *,
ULONG SortType);
FUNCTION
Sorts a list of MinNodes and uses the CompareFunc to find differences
between to nodes. NodeList is a pointer to a APTR which points to the
first node. The first node has as mln_succ a NULL and the last node
has as mln_pred a NULL. Only mln_succ, mln_pred and the address of the
first will changed. Nothing will be reallocated or freed.
The CompareFunc will be called with a pointer to one node in A1 (Node0)
and a pointer to second node in A2 (Node1). You have to return a
specific value in D0:
0 if Node0 = Node1
1 if Node0 < Node1
-1 if Node0 > Node1
INPUTS
NodeList - Pointer to an APTR which is a pointer to the first node
CompareFunc - Pointer to a Hook structure for the compare function
SortType -
SCA_SortType_Bubble : enhanced BubbleSort
SCA_SortType_Selection : SelectionSort
SCA_SortType_Insertion : InsertionSort
SCA_SortType_Quick : QuickSort
SCA_SortType_Best : The nodes will be counted and then
the best SortType will be used.
SEE ALSO
SCA_AllocNode(), SCA_AllocStdNode(), SCA_FreeNode(),
SCA_FreeAllNodes(), SCA_MoveNode(), SCA_SwapNodes()
NAME
SCA_NewAddAppIcon
SCA_NewAddAppIconTags
SYNOPSIS
AppObject = SCA_NewAddAppIcon (ID, UserData, IconObject, MessagePort,
D0 D0 D1 A0 A1
Taglist)
A2
struct AppObject *SCA_NewAddAppIcon( ULONG ID, ULONG UserData,
struct IconObject *, struct MsgPort *,
const struct TagItem *Taglist);
struct AppObject *SCA_NewAddAppIconTags( ULONG ID, ULONG UserData,
struct IconObject *, struct MsgPort *,
ULONG FirstTag, ...);
FUNCTION
Adds an icon to the mainwindow of the Scalos-screen. See
workbench.library/AddAppIconA() for more information.
INPUTS
ID, UserData - will be passed through the AppMessage
IconObject - diskobject.library - IconObject, IDTM_Layout should not
to be done.
MessagePort - a MsgPort where you will receive the AppMessage
Taglist - pointer to a taglist.
TAGS
Currently no tags are defined. With wb39.plugin, however, most of the
V44 workbench tags are supported.
RESULT
AppObject - a private structure to be pass to SCA_RemoveAppObject()
or NULL after failure
SEE ALSO
SCA_NewAddAppWindow(), SCA_NewAddAppMenuItem(), SCA_RemoveAppObject()
workbench.library/AddAppIconA()
NAME
SCA_NewAddAppWindow
SCA_NewAddAppWindowTags
SYNOPSIS
AppObject = SCA_NewAddAppWindow (ID, UserData, Window, MessagePort,
D0 D0 D1 A0 A1
Taglist)
A2
struct AppObject *SCA_NewAddAppWindow( ULONG ID, ULONG UserData,
struct Window *, struct MsgPort *,
const struct TagItem *Taglist);
struct AppObject *SCA_NewAddAppWindowTags( ULONG ID, ULONG UserData,
struct Window *, struct MsgPort *, ULONG FirstTag, ...);
FUNCTION
Same as workbench.library/AddAppWindowA(). See there for further
information.
INPUTS
ID, UserData - will be passed through the AppMessage
Window - Intuition Window
MessagePort - a MsgPort where you will receive the AppMessage
Taglist - pointer to a taglist.
TAGS
Currently no tags are defined.
RESULT
AppObject - a private structure to be pass to SCA_RemoveAppObject
or NULL on failure
SEE ALSO
SCA_NewAddAppIcon(), SCA_NewAddAppMenuItem(), SCA_RemoveAppObject()
workbench.library/AddAppWindowA()
NAME
SCA_NewAddAppMenuItem
SCA_NewAddAppMenuItemTags
SYNOPSIS
AppObject = SCA_NewAddAppMenuItem (ID, UserData, Text, MessagePort,
D0 D0 D1 A0 A1
Taglist)
A2
struct AppObject *SCA_NewAddAppMenuItem ( ULONG ID, ULONG UserData,
CONST_STRPTR Text, struct MsgPort *,
const struct TagItem *Taglist);
struct AppObject *SCA_NewAddAppMenuItemTags( ULONG ID,
ULONG UserData, CONST_STRPTR Text, struct MsgPort *,
ULONG FirstTag, ...);
FUNCTION
Same as workbench.library/AddAppMenuItemA(). See there for further
information.
INPUTS
ID, UserData - will be passed through the AppMessage
Text - a pointer to the menutext. Starting with V40, any menu
text consisting entirely of '-', '_' or '~' characters will
result in a separator bar to be added.
MessagePort - a MsgPort where you will receive the AppMessage
Taglist - pointer to a taglist.
TAGS
WBAPPMENUA_CommandKeyString (STRPTR) -- Command key to assign to
this AppMenu. This must be a NUL-terminated string. If the
string is empty, it will be ignored. Also, if the command key
is already in use by a different menu item it will be ignored,
too. In any case, only the first character of the string will
be used (V40).
This tag defaults to NULL.
WBAPPMENUA_GetKey (ULONG *) -- To add menus with sub menu items,
you need to add a menu item first which the sub items will
be added to later. In order to do this, add the item the sub items
should be attached to and use the WBAPPMENUA_GetKey tag to
obtain a key value. This key value is to be used later with the
WBAPPMENUA_UseKey tag (V40.20).
This feature was introduced in Scalos 40.20, it
does not work in any of the older Scalos releases.
This tag defaults to NULL.
WBAPPMENUA_GetTitleKey (ULONG *) -- To add new entries to the Scalos
menu strip you first need to create a new title to which the new
menu items can be attached later. To do this, first create a new
menu entry and use the WBAPPMENUA_GetTitleKey tag to obtain a key
value. This key value is to be used later with the
WBAPPMENUA_UseKey tag (V40.20).
This tag defaults to NULL.
WBAPPMENUA_UseKey (ULONG) -- When adding a menu item with the
WBAPPMENUA_UseKey tag, using a key value obtained by a previous
invocation of AddAppMenuItemA(), the new menu item will be
added as a sub item (V40.20).
If the key you provide was obtained via the WBAPPMENUA_GetTitleKey
tag, then the item you add will be attached to the respective
menu entry (V40.20).
This tag defaults to NULL.
RESULT
AppObject - a private structure to be pass to SCA_RemoveAppObject or
NULL on failure
Starting with V40, NULL will be returned if you attempt to
add an AppMenu item to a menu which already contains 63
menu items. Only a maximum of 15 sub items can be added
to a menu item.
SEE ALSO
SCA_NewAddAppIcon(), SCA_NewAddAppWindow(), SCA_RemoveAppObject()
workbench.library/AddAppMenuItemA()
NAME
SCA_RemoveAppObject
SYNOPSIS
succ = SCA_RemoveAppObject (AppObject)
D0 A0
BOOL SCA_RemoveAppObject (struct AppObject *);
FUNCTION
Removes an AppObject from Scalos. This could be an Icon, a Window or
a MenuItem.
INPUTS
AppObject - result from SCA_NewAddAppIcon(), SCA_NewAddAppWindow()
or SCA_NewAddAppMenuItem()
RESULT
succ - currently it always returns TRUE
SEE ALSO
SCA_NewAddAppIcon(), SCA_NewAddAppWindow(), SCA_NewAddAppMenuItem()
NAME
SCA_AllocStdNode
SYNOPSIS
Node = SCA_AllocStdNode (NodeList, NodeType)
D0 A0 D0
struct MinNode *SCA_AllocStdNode (struct ScalosNodeList *,
ULONG NodeType);
FUNCTION
Allocates a standard Scalos-node. It's the only compatible why to
allocate one of the standard nodes. NEVER allocate a node yourself and
pass it to Scalos! The scalos.library will use a memorypool for all
nodes to decrease the memoryfragmentation. The new node will be the
last in your NodeList and it is cleared public memory. Don't change
mln_succ and mln_pred yourself, use the node function instead.
See SCA_SortNodes() for information about the NodeList.
INPUTS
NodeList - Pointer to an APTR which is a pointer to the first node
NodeType - see scalos.(h|i)
RESULT
Node - Node at the end or the NodeList or NULL on failure.
NOTE
Node *MUST* be freed with SCA_FreeNode() or SCA_FreeAllNodes()
This function preserves all registers except D0.
SEE ALSO
SCA_AllocNode(), SCA_FreeNode(), SCA_FreeAllNodes(),
SCA_MoveNode(), SCA_SortNodes(), SCA_SwapNodes()
NAME
SCA_AllocNode
SYNOPSIS
Node = SCA_AllocNode (NodeList, Size)
D0 A0 D0
struct MinNode *SCA_AllocNode (struct ScalosNodeList *, ULONG Size);
FUNCTION
Allocates a node and inserts it at the end of the NodeList. Use this
function only for your own node-handling. Never allocate a standard
Scalos-node, use SCA_AllocStdNode() instead. Size is the number of
bytes that allocated after the the MinNode. This means the memsize
of node is size+MLN_SIZE.
See SCA_AllocStdNode() for further information.
INPUTS
NodeList - Pointer to an APTR which is a pointer to the first node
Size - bytes after MLN_SIZE
RESULT
Node - Node at the end or the NodeList or NULL on failure.
NOTE
Node *MUST* be freed with SCA_FreeNode() or SCA_FreeAllNodes() !
This function preserves all registers except D0.
SEE ALSO
SCA_AllocStdNode(), SCA_FreeNode(), SCA_FreeAllNodes(),
SCA_MoveNode(), SCA_SortNodes(), SCA_SwapNodes()
NAME
SCA_FreeNode
SYNOPSIS
SCA_FreeNode (NodeList, Node)
A0 A1
void SCA_FreeNode (struct ScalosNodeList *, struct MinNode *);
FUNCTION
Removes the Node out of the NodeList and Frees a node allocated with
SCA_AllocStdNode() or SCA_AllocNode().
INPUTS
NodeList - pointer to an APTR which is a pointer to the first node
Node - node to remove and free
NOTE
Node *MUST* be part of NodeList!
This function preserves all registers.
SEE ALSO
SCA_AllocStdNode(), SCA_AllocNode(), SCA_FreeAllNodes(),
SCA_MoveNode(), SCA_SortNodes(), SCA_SwapNodes()
NAME
SCA_FreeAllNodes
SYNOPSIS
SCA_FreeAllNodes (NodeList)
A0
void SCA_FreeAllNodes (struct ScalosNodeList *);
FUNCTION
Will free the whole list of nodes.
INPUTS
NodeList - pointer to an APTR which is a pointer to the first node
NOTE
This function preserves all registers.
SEE ALSO
SCA_AllocStdNode(), SCA_AllocNode(), SCA_FreeNode(),
SCA_MoveNode(), SCA_SortNodes(), SCA_SwapNodes()
NAME
SCA_MoveNode
SYNOPSIS
SCA_MoveNode (SrcNodeList, DestNodeList, Node)
A0 A1 D0
void SCA_MoveNode (struct ScalosNodeList *, struct ScalosNodeList *,
struct MinNode *);
FUNCTION
Will remove the Node from SrcNodeList and will insert the Node at
the end of DestNodeList.
INPUTS
SrcNodeList - pointer to an APTR which is a pointer to the first node
DestNodeList - pointer to an APTR which is a pointer to the first node
Node - MinNode
NOTE
This function preserves all registers.
WARNING: Node *MUST* be member of SrcNodeList or very nasty
things will happen !!
SEE ALSO
SCA_AllocStdNode(), SCA_AllocNode(), SCA_FreeNode(),
SCA_FreeAllNodes(), SCA_SortNodes(), SCA_SwapNodes()
NAME
SCA_SwapNodes
SYNOPSIS
SCA_SwapNodes ( SrcNode, DestNode, NodeList)
A0 A1 A2
void SCA_SwapNodes (struct MinNode *, struct MinNode *,
struct ScalosNodeList *);
FUNCTION
Swaps the positions of SrcNode and DestNode inside the NodeList.
INPUTS
SrcNode - MinNode
DestNode - MinNode
NodeList - pointer to an APTR which is a pointer to the first node
NOTE
SrcNode and DestNode *MUST* be part of NodeList!
SEE ALSO
SCA_AllocStdNode(), SCA_AllocNode(), SCA_FreeNode(),
SCA_FreeAllNodes(), SCA_MoveNode(), SCA_SortNodes()
NAME
SCA_OpenIconWindow
SCA_OpenIconWindowTags
SYNOPSIS
succ SCA_OpenIconWindow ( TagList )
D0 A0
BOOL SCA_OpenIconWindow ( const struct TagItem *TagList );
BOOL SCA_OpenIconWindowTags(ULONG, ...);
FUNCTION
opens a windowtask filled with icons. All information will be given
as tags, see below.
INPUTS
TagList - pointer to a taglist.
TAGS
SCA_IconNode (struct ScaIconNode *) - fullfilled ScaIconNode
SCA_IconObject (Object *) - iconobject.library - iconobject
SCA_Path (CONST_STRPTR) - the path to open
SCA_MessagePort (struct MsgPort *) - Message port for reply
to startup message of new icon window process, or NULL.
SCA_WindowTitle (CONST_STRPTR) - windowtitle parsestring
( take a look at the prefsprogram for info)
SCA_WindowRect (struct IBox *) - rectangle with window
dimensions (see diskobject.library).
SCA_XOffset,SCA_YOffset (LONG) - virtual position
SCA_PatternNumber (ULONG) - background pattern number which is
configured in "Scalos Pattern" prefs
SCA_ShowAllFiles (ULONG) - TRUE or FALSE
deprecated, use SCA_ShowAllMode instead!
SCA_ShowAllMode (ULONG) - DDFLAGS_SHOWDEFAULT,
DDFLAGS_SHOWICONS, or DDFLAGS_SHOWALL.
SCA_ViewModes (ULONG) - view modes for the window
SCAV_ViewModes_Icon
SCAV_ViewModes_Name
SCAV_ViewModes_Size
SCAV_ViewModes_Date
SCAV_ViewModes_Time
SCAV_ViewModes_Comment
SCAV_ViewModes_Protection
SCAV_ViewModes_Owner
SCAV_ViewModes_Group
SCA_Flags (ULONG) - none available yet
SCA_Iconify (ULONG) - TRUE or FALSE for open iconified
SCA_NoActivateWindow (ULONG) - TRUE or FALSE. The new window
will not be activated if this tag is set to TRUE.
Defaults to FALSE.
SCA_WindowStruct (struct ScaWindowStruct **) - The pointer to the
ScaWindowStruct of the new generated Scalos window will be
returned. If the new Scalos window couldn't be opened, NULL
is returned.
SCA_BrowserMode (ULONG) - TRUE or FALSE. The window will be
opened in browser mode if set to TRUE.
SCA_NoStatusBar (ULONG) - TRUE or FALSE. The status bar will not
be present in the new window if set to TRUE, overriding the
global setting for status bar.
SCA_CheckOverlappingIcons (ULONG) - TRUE or FALSE. Defines whether
icon windows check for overlapping icons. If enabled, an icon
overlapping any other is repositioned on directory scan.
Default value is TRUE for MorphOS, FALSE for all other platforms.
SCA_TransparencyActive (ULONG) - degree of opacity in active
window state, 0=transparent, 100=opaque.
Semi-transparent windows are not supported on all platforms.
SCA_TransparencyInactive (ULONG) - degree of opacity in inactive
window state, 0=transparent, 100=opaque
Semi-transparent windows are not supported on all platforms.
RESULT
succ - Success
NOTE
One of SCA_IconNode, SCA_IconObject or SCA_Path must be given!
SEE ALSO
NAME
SCA_LockDrag
SYNOPSIS
SCA_LockDrag ( draghandle )
D0
void SCA_LockDrag ( APTR draghandle );
FUNCTION
Locks the screen layer info that is connected to the draghandle.
Main purpose is to temporarily unlock and lock again the screen
layers during a dragging operiation, in order to allow some drawing to happen.
INPUTS
draghandle - That drag handle that is to be locked.
SEE ALSO
SCA_UnLockDrag(), SCA_InitDrag(), SCA_EndDrag(), SCA_DrawDrag()
NAME
SCA_LockWindowList
SYNOPSIS
Windowlist SCA_LockWindowList ( accessmode )
D0 D0
struct ScaWindowList *SCA_LockWindowList ( LONG accessmode );
FUNCTION
Locks the windowlist and returns. This function is a main interface of
the Scalos-API. The messageport should be used to comunicate with a
windowtask. No window can be closed while the windowlist is locked.
For more information take a look at the ScalosAPI documentation.
INPUTS
accessmode -
SCA_LockWindowList_Shared - locks the window list for a read-
only access. Shared access is sufficient if
you just want to traverse the window list,
and make sure nobody modifies the
list inbetween.
SCA_LockWindowList_Exclusiv - locks the window list
exclusively for read-write access. Exclusive
mode is required if windows are to be created
or removed.
SCA_LockWindowList_AttemptShared - tries to acquire a shared
lock on the window list for read-only access.
NULL is returned if the list cannot be locked,
e.g. because someone else holds an exclusive
lock on the list.
SCA_LockWindowList_AttemptExclusive - try to acquire an
exclusive lock on the window list.
NULL is returned if the list cannot be locked,
e.g. because someone else holds a lock on
the list.
RESULT
windowlist - a struct ScaWindowList * - With the
SCA_LockWindowList_Attempt*** values, it is
possible that NULL is returned if the window
list cannot be locked.
NOTE
Normally you should not use the SCA_LockWindowList_Exclusiv. If you
lock the windowlist exclusiv you should NEVER use intuition calls!
SEE ALSO
SCA_UnLockWindowList()
NAME
SCA_UnLockWindowList
SYNOPSIS
SCA_UnLockWindowList ()
void SCA_UnLockWindowList ( void );
FUNCTION
Unlocks a with SCA_LockWindowList() locked windowlist.
SEE ALSO
SCA_LockWindowList()
NAME
SCA_AllocMessage
SYNOPSIS
ScalosMessage SCA_AllocMessage( messagetype, additional_size)
D0 D0 D1
struct ScalosMessage *SCA_AllocMessage ( ULONG messagetype,
UWORD additional_size );
FUNCTION
Allocates a message which could be sent to Scalos. It's the only
future-compatible way to do this. The scalos message signature and the
the message type will be set and the returned memory is cleared.
INPUTS
messagetype - see ScalosAPI.doc
additional_size - number of bytes that will be added to the size of
the message. Normally this should be 0.
RESULT
ScalosMessage - a full-filled ScalosMessage of the selected type or NULL
NOTE
Never try to free a message yourself, it will cause a memory trashing!
Scalos uses fast memorypool functions for its messages.
SEE ALSO
SCA_FreeMessage()
NAME
SCA_FreeMessage
SYNOPSIS
SCA_FreeMessage( message )
A1
void SCA_FreeMessage ( struct ScalosMessage *);
FUNCTION
Frees a with SCA_AllocMessage() allocated message.
INPUTS
message - struct ScalosMessage (returned from SCA_AllocMessage())
SEE ALSO
SCA_AllocMessage()
NAME
SCA_InitDrag
SYNOPSIS
DragHandle SCA_InitDrag( Screen )
D0 A0
struct DragHandle *SCA_InitDrag ( struct Screen *);
FUNCTION
Inits special bobroutines. This routines are easy to use and
support 24bit bobs.
INPUTS
Screen - the screen to use for the bobs or NULL for the default
Scalos screen
RESULT
DragHandle - a private structure to pass it to the other Drag functions
or NULL on failure.
SEE ALSO
SCA_DrawDrag(), SCA_EndDrag(), SCA_LockDrag(), SCA_UnlockDrag()
NAME
SCA_EndDrag
SYNOPSIS
SCA_EndDrag( DragHandle )
A0
void SCA_EndDrag ( struct DragHandle *);
FUNCTION
Removes all bobs from screen and frees it, if nessesary it unlocks
the layers.
INPUTS
DragHandle - result from SCA_InitDrag()
SEE ALSO
SCA_DrawDrag(), SCA_InitDrag(), SCA_LockDrag(), SCA_UnlockDrag()
NAME
SCA_AddBob
SYNOPSIS
succ SCA_AddBob( DragHandle, Bitmap, Mask, Width, Height,
D0 A0 A1 A2 D0 D1
XOffset, YOffset )
D2 D3
BOOL SCA_AddBob ( struct DragHandle *, struct BitMap *, APTR Mask,
ULONG Width, ULONG Height, LONG XOffset, LONG YOffset );
FUNCTION
Addes a bitmap to the Boblist. Bitmap and Mask will be copied, it can
be freed after calling this function. Mask is a planar bitplane the
width divided by 8 and height. It must be in Chipram. X and Y offsets
are the offset from movepoint give in SCA_DrawDrag(). Normaly it's
the relative position to the mouse pointer.
INPUTS
DragHandle - result from SCA_InitDrag()
Bitmap - a standard bitmap structure, any depth allowed
Mask - width/8 * height mask for the bitmap
Width - width in pixels
Height - height in pixels
XOffset - relative x-position to the move point
YOffset - relative y-position to the move point
RESULT
succ - TRUE if anything went well, FALSE if some problem occured
SEE ALSO
NAME
SCA_DrawDrag
SYNOPSIS
SCA_DrawDrag( DragHandle, X, Y, Flags )
A0 D0 D1 D2
void SCA_DrawDrag ( struct DragHandle *, LONG X, LONG Y, ULONG Flags );
FUNCTION
Blits the bobs to the selected screen relative to the given position.
INPUTS
DragHandle - result from SCA_InitDrag()
X - movepoint x direction
Y - movepoint y direction
Flags -
SCAF_Drag_Transparent - draw all bobs transparent,
normally it's a raster ("ghosted")
SCAF_Drag_IndicateCopy - draw all bobs plus
"copy" indicator
SCAF_Drag_NoDropHere - draw all bobs plus
"no drop" indicator
SCAF_Drag_Hide - hide bobs
SCAF_Drag_IndicateMakeLink - draw all bobs plus "make link"
indicator
SCAF_Drag_NoDrawDrag - (internal use only)
NOTE
Transparent drawing only works with CyberGfx installed and a
workbench screen of more than 256 colors (depth > 8).
SEE ALSO
SCA_InitDrag(), SCA_EndDrag(), SCA_LockDrag(), SCA_UnlockDrag()
NAME
SCA_UpdateIcon
SYNOPSIS
SCA_UpdateIcon( WindowType, SCA_UpdateIcon, UpdateIcon_Size )
D0 A0 D1
void SCA_UpdateIcon ( UBYTE WindowType, struct ScaUpdateIcon_IW *,
ULONG ui_SIZE );
FUNCTION
Refreshes an icon specified in SCA_UpdateIcon structure. The icon
will be loaded, removed or reloaded. The SCA_UpdateIcon struct
depends on the windowtype.
INPUTS
WindowType - windowtype which should be updated
SCA_UpdateIcon - special information, depents on WindowType
UpdateIcon_Size - size of the SCA_UpdateIcon structure in bytes
SEE ALSO
NAME
SCA_MakeWBArgs
SYNOPSIS
number = SCA_MakeWBArgs( Buffer, Iconnode, ArgsSize )
A0 A1 D0
ULONG SCA_MakeWBArgs ( struct WBArg *Buffer,
struct ScaIconNode *Iconnode, ULONG ArgsSize);
FUNCTION
Generates a WBArgs Array from all selected icons except the
given Iconode.
It is recommended to determine the required buffer size
with SCA_CountWBArgs().
INPUTS
Buffer - Array of WBArg structures to save the Lock and
Name pointers
Iconnode - an iconnode to exclude or NULL
ArgsSize - Number of WBArg's the buffer has room for
RESULT
number - number of args generated
SEE ALSO
SCA_FreeWBArgs() SCA_CountWBArgs()
NAME
SCA_FreeWBArgs
SYNOPSIS
number = SCA_FreeWBArgs( Buffer, Number, Flags )
A0 D0 D1
void SCA_FreeWBArgs ( struct WBArg *Buffer, ULONG Number,
ULONG Flags);
FUNCTION
Frees a WBArg array generated with SCA_MakeWBArgs.
INPUTS
Buffer - Array with WBArg structures
Number - Number of WBArg's to free
Flags -
SCAB_FreeLocks - free the Locks
SCAB_FreeName - free the namefields
SEE ALSO
SCA_MakeWBArgs(); SCA_CountWBArgs();
NAME
SCA_CountWBArgs
SYNOPSIS
number = SCA_CountWBArgs( Iconnode )
A0
ULONG SCA_CountWBArgs( struct ScaIconNode *Iconnode );
FUNCTION
Determines required size for WBArgs Array from all
selected icons except the given Iconode.
The returned count can be used to allocate a WBArg
array for SCA_MakeWBArgs().
INPUTS
Iconnode - an iconnode to exclude or NULL
RESULT
number - number of args that will be generated
by SCA_MakeWBArgs().
SEE ALSO
SCA_FreeWBArgs() SCA_MakeWBArgs()
NAME
SCA_ScreenTitleMsg
SYNOPSIS
SCA_ScreenTitleMsg( Format, Args )
A0 A1
void SCA_ScreenTitleMsg ( CONST_STRPTR Format, APTR Args);
void SCA_ScreenTitleMsgArgs( CONST_STRPTR Format, ...);
FUNCTION
Show a message on ScreenTitle of all Scalos windows.
INPUTS
Format - FormatString. All RawDoFmt() args are allowed.
special values :
NULL to recover the standard title.
~0 to recover the last non-standard title (message).
Args - the arguments for the formatstring
SEE ALSO
exec.library/RawDoFmt
NAME
SCA_MakeScalosClass
SYNOPSIS
ScalosClass ( ClassName, SuperClassName, InstSize, DispFunc )
D0 A0 A1 D0 A2
struct ScalosClass *SCA_MakeScalosClass ( CONST_STRPTR ClassName,
CONST_STRPTR SuperClassName, UWORD InstSize, APTR DispFunc);
FUNCTION
Addes a new BOOPSI Class to the internal classlist. ClassName may be
a new name or a classname that's already available. In this case the
class will replace or enhance a known class.
INPUTS
ClassName - name of the new class or NULL for a private class
SuperClassName - name of the super class for the new class
InstSize - size of the instance variables
DispFunc - pointer to your Dispatcher function
RESULT
ScalosClass - a ScalosClass structure or NULL if it fails
NOTE
If you like a add a subclass to your private class then use the
intuition class functions.
SEE ALSO
SCA_FreeScalosClass(), intuition.library/MakeClass
NAME
SCA_FreeScalosClass
SYNOPSIS
scc SCA_FreeScalosClass( ScalosClass )
D0 A0
BOOL SCA_FreeScalosClass ( struct ScalosClass *);
FUNCTION
Removes a ScalosClass from the internal classlist.
INPUTS
ScalosClass - return value from SCA_MakeScalosClass()
RESULT
succ - FALSE if the class couldn't be removed, else TRUE
SEE ALSO
SCA_MakeScalosClass(), FreeClass()
NAME
SCA_NewScalosObject
SCA_NewScalosObjectTags
SYNOPSIS
Object SCA_NewScalosObject( ClassName, TagList )
D0 A0 A1
Object *SCA_NewScalosObject ( CONST_STRPTR ClassName,
const struct TagItem *TagList);
Object *SCA_NewScalosObjectTags( CONST_STRPTR ClassName,
ULONG FirstTag, ...);
FUNCTION
Allocates and inits a new BOOPSI Object.
INPUTS
ClassName - Scalos Classname
TagList - taglist (depends on the class)
RESULT
Object - new BOOPSI Object or NULL
SEE ALSO
SCA_DisposeScalosObject(), NewObject()
NAME
SCA_DisposeScalosObject
SYNOPSIS
SCA_DisposeScalosObject( Object )
A0
void SCA_DisposeScalosObject (Object *);
FUNCTION
Disposes a object created with SCA_NewScalosObject().
INPUTS
Object - BOOPSI Object
SEE ALSO
SCA_NewScalosObject(), DisposeObject()
NAME
SCA_ScalosControlA -- Query or modify Scalos options (V40)
SCA_ScalosControl
SYNOPSIS
ULONG SCA_ScalosControlA( Name, TagList )
D0 A0 A1
ULONG SCA_ScalosControlA( CONST_STRPTR Name,
const struct TagItem *TagList);
ULONG SCA_ScalosControl( CONST_STRPTR Name, ULONG FirstTag, ...);
FUNCTION
With this function you can query or modify global Scalos parameters.
INPUTS
name -- Name of an object to query or modify.
tags -- Additional options.
TAGS
SCALOSCTRLA_GetDefaultStackSize (ULONG *) -- Get the default stack
size used by Scalos when launching Shell programs
or programs without a valid stack size number.
The default stack size is 8192 bytes.
SCALOSCTRLA_SetDefaultStackSize (ULONG) -- Set the default stack
size used by Scalos when launching Shell programs
or programs without a valid stack size number. You cannot
set a stack size number smaller than 8192 bytes.
SCALOSCTRLA_GetProgramList (struct List **) -- You can obtain a list
of currently running Workbench programs; every entry of this
list will have the complete path to the program and the
program name in its Node->ln_Name. When you no longer need
the list, don't forget to free it again using the tag
WBCTRLA_FreeProgramList.
SCALOSCTRLA_FreeProgramList (struct List *) -- With this tag you can
free the list allocated by the SCALOSCTRLA_GetProgramList tag.
SCALOSCTRLA_GetCloseWBDisabled (ULONG *) -- Get the current disable
state for the intuition.library/CloseWorkBench() function.
If TRUE, intuition.library/CloseWorkBench() always returns FALSE
and Scalos will never close.
SCALOSCTRLA_SetCloseWBDisabled (ULONG) -- Set the disable
state for the intuition.library/CloseWorkBench() function.
If TRUE, intuition.library/CloseWorkBench() always returns FALSE
and Scalos will never close.
SCALOSCTRLA_GetSplashEnable (ULONG *) -- Get the current disable
state for the Scalos startup splash window. If TRUE, Scalos shows
its splash window on startup.
SCALOSCTRLA_SetSplashEnable (ULONG) -- Set the disable
state for the Scalos startup splash window. If TRUE, Scalos shows
its splash window on startup.
SCALOSCTRLA_GetToolTipEnable (ULONG *) -- Get the current enable
state for icon tool tips. If TRUE, icon tool tips will show up
if the mouse pointer kept over an icon for some seconds.
SCALOSCTRLA_SetToolTipEnable (ULONG) -- Set the enabled
state for icon tool tips. If TRUE, icon tool tips will show up
if the mouse pointer kept over an icon for some seconds.
SCALOSCTRLA_GetToolTipDelay (ULONG *) -- Set the delay time until
the icon tool tips pop up (in seconds).
SCALOSCTRLA_SetToolTipDelay (ULONG) -- Set the delay time until
the icon tool tips pop up (in seconds). You must specify a
number between 1 and 599 seconds. Default delay time is 2 seconds.
SCALOSCTRLA_GetOldDragIconMode (ULONG *) -- Enable old (workbench-
like) icon dragging mode, i.e. all icons are visibly dragged.
If turned OFF (=0), the new "icon stack" method is used.
Default value is OFF (0).
SCALOSCTRLA_SetOldDragIconMode (ULONG) -- Get the current icon
dragging mode.
0 New "icon stack" icon dragging method is used.
1 Old (workbench-like) icon dragging mode, i.e. all icons
are visibly dragged
SCALOSCTRLA_GetTypeRestartTime (ULONG *) -- Get the number of seconds
that have to pass before typing the next character in a drawer
window will restart with a new file name.
SCALOSCTRLA_SetTypeRestartTime (ULONG) -- Set the number of seconds
that have to pass before typing the next character in a drawer
window will restart with a new file name. You must specify a
number greater than 0. Default type restart time is 3 seconds.
SCALOSCTRLA_GetEmulationMode (ULONG *) -- get a BOOL variable telling
whether which mode Scalos is running in.
TRUE emulation mode
FALSE preview mode
SCALOSCTRLA_GetStatusBarEnable (ULONG *) -- get a BOOL variable
telling whether Scalos displays a status bar in every
non-backdrop window.
SCALOSCTRLA_SetStatusBarEnable (ULONG) -- Telling whether Scalos to
display a status bar in every non-backdrop window (any non-zero
value) or to display no status bars. Changes only apply to
windows opened thereafter.
TRUE show status bar
FALSE don't show status bar
NOTE: Changes only apply to windows opened thereafter.
SCALOSCTRLA_GetStripedTextWindows (ULONG *) -- get a BOOL variable
telling whether Scalos displays horizontally striped lines in
text windows.
SCALOSCTRLA_SetStripedTextWindows (ULONG) -- Tell whether Scalos to
display horizontally striped lines in text windows.
TRUE show stripes in text window
FALSE show standard background.
NOTE: Changes only apply to windows opened thereafter.
SCALOSCTRLA_GetDisplayDragCount (ULONG *) -- get a BOOL variable
telling whether Scalos shows the number of dragged objects
during Drag and Drop.
SCALOSCTRLA_SetDisplayDragCount (ULONG) -- Tell whether Scalos to
display the number of dragged objects during Drag and Drop.
TRUE show number of objects while dragging
FALSE don't show number of objects
SCALOSCTRLA_GetWindowDropMarkMode (ULONG *) - get a ULONG variable
telling when Scalos shows window drop marks during D&D
IDTV_WinDropMark_Never - never
IDTV_WinDropMark_WindowedOnly - only on non-backdrop windows
IDTV_WinDropMark_Always - always
SCALOSCTRLA_SetWindowDropMarkMode (ULONG) - Set when Scalos will
show window drop marks during D&D
IDTV_WinDropMark_Never - never
IDTV_WinDropMark_WindowedOnly - only on non-backdrop windows
IDTV_WinDropMark_Always - always
SCALOSCTRLA_GetCopyHook (struct Hook **) - Obtain the current hook
that will be invoked when Scalos starts copying files and
data (V40).
SCALOSCTRLA_SetCopyHook (struct Hook *) - Install a new hook that
will be invoked when Scalos starts copying files and data (V40).
The hook will be invoked exactly the same way as Workbench
does with its WBCTRLA_SetCopyHook hook.
SCALOSCTRLA_GetDeleteHook (struct Hook **) - Obtain the current hook
that will be invoked when Scalos deletes files and drawers or
empties the trashcan (V40).
SCALOSCTRLA_SetDeleteHook (struct Hook *) - Install a new hook that
will be invoked when Scalos deletes files and drawers or empties
the trashcan (V40).
The hook will be invoked exactly the same way as Workbench
does with its WBCTRLA_SetDeleteHook hook.
NOTE: this hook will take precedence over the
installed "Delete.module".
SCALOSCTRLA_GetTextInputHook (struct Hook **) - Obtain the current
hook that will be invoked when Scalos requests the user to enter
text, i.e. when a file is to be renamed or a new drawer is to
be created (V40).
SCALOSCTRLA_SetTextInputHook (struct Hook *) - Install a new hook
that will be invoked when Scalos requests the user to enter text,
i.e. when a file is to be renamed or a new drawer is to
be created (V40).
The hook will be invoked exactly the same way as Workbench
does with its WBCTRLA_SetTextInputHook hook.
NOTE: this hook will take precedence over the installed
"NewDrawer.module", "Execute.module" and "Rename.module".
SCALOSCTRLA_AddCloseWBHook (struct Hook *) - Add a hook that will
be invoked when Scalos is about to close (cleanup), and when
Scalos has opened again (setup) (V40).
The hook will be invoked exactly the same way as Workbench
does with its WBCTRLA_AddSetupCleanupHook hook.
SCALOSCTRLA_RemCloseWBHook (struct Hook *) - Remove a hook that has
been installed with the SCALOSCTRLA_AddCloseWBHook tag (V40).
SCALOSCTRLA_GetSupportedIconTypes (ULONG *) - Get bit mask
of all currently enabled icon types
IDTV_IconType_NewIcon - display NewIcons
IDTV_IconType_ColorIcon - display OS3.5 color icons
SCALOSCTRLA_SetSupportedIconTypes (ULONG) - Select which
icon types are enabled :
IDTV_IconType_NewIcon - display NewIcons
IDTV_IconType_ColorIcon - display OS3.5 color icons
SCALOSCTRLA_GetMenuCommandList (struct List **) -- You can obtain a list
of all supported menu command names. When you no longer need
the list, don't forget to free it again using the tag
WBCTRLA_FreeMenuCommandList.
SCALOSCTRLA_FreeMenuCommandList (struct List *) -- With this tag you can
free the list allocated by the SCALOSCTRLA_GetMenuCommandList tag.
SCALOSCTRLA_GetCopyBuffSize (ULONG *) -- Query the size of the buffer
used for moving and copying files.
SCALOSCTRLA_SetCopyBuffSize (ULONG) -- Set the size of the buffer used
for moving and copying files. The size can be changed
between 4 KBytes and 4 MBytes (40.30).
RESULT
Returns the number of tags successfully processed. If the returned
value is less than the number of tags supplied, you can query the error
code using dos.library/IoErr().
NOTES
This function may only be called by a Process.
SEE ALSO
dos.library/IoErr
<dos/dosextens.h>
NAME
SCA_GetDefIconObject
SCA_GetDefIconObjectA
SCA_GetDefIconObjectTags
SYNOPSIS
IconObject SCA_GetDefIconObject( dirLock, name )
D0 A0 A1
IconObject SCA_GetDefIconObjectA( dirLock, name, tagList )
D0 A0 A1 A2
Object *SCA_GetDefIconObject(BPTR dirLock, CONST_STRPTR name)
Object *SCA_GetDefIconObjectA(BPTR dirLock,
CONST_STRPTR name, struct TagItem *tagList)
Object *SCA_GetDefIconObjectTags(BPTR dirLock, CONST_STRPTR name, ...)
FUNCTION
Returns default IconObject for the file system object
(tool/project/drawer/device) described by dirLock and name.
A filetype-specific default icon is selected according
to the object type.
INPUTS
dirlock - Lock on the parent directory of the object.
name - Name of the object.
tagList - additional tags for creation of IconObject.
RESULT
IconObject - new IconObject or NULL
NAME
SCA_OpenDrawerByName
SCA_OpenDrawerByNameTags
SYNOPSIS
ScaWindow = SCA_OpenDrawerByName( path, tagList )
D0 A0 A1
struct ScaWindowStruct *SCA_OpenDrawerByName(CONST_STRPTR path,
struct TagItem *tagList);
struct ScaWindowStruct *SCA_OpenDrawerByNameTags(CONST_STRPTR path,
ULONG firstTag, ...);
FUNCTION
Tries to open the named drawer.
INPUTS
path - Full path name of the drawer to be opened.
TagList - taglist
RESULT
ScaWindow - ScaWindowStruct of the newly opened drawer window or NULL.
SEE ALSO
SCA_OpenIconWindow()
NAME
SCA_UnlockDrag
SYNOPSIS
wasLocked = SCA_UnlockDrag ( draghandle )
D0
ULONG SCA_LockDrag ( APTR draghandle );
FUNCTION
Unlocks the screen layer info that is connected to the draghandle.
Main purpose is to temporarily unlock and lock again the screen
layers during a dragging operiation, in order to allow some drawing to happen.
INPUTS
draghandle - That drag handle that is to be locked.
RESULT
wasLocked - Flag that indicated whether the screen layer was locked
before calling. The result can be used to decide if you need to
call SCA_LockDrag() when you are finished drawing.
SEE ALSO
SCA_LockDrag(), SCA_InitDrag(), SCA_EndDrag(), SCA_DrawDrag()
Scalos GFX
[edit | edit source]ScalosGfxCreateEmptySAC ScalosGfxCreateSAC ScalosGfxFreeSAC ScalosGfxCreateARGB ScalosGfxFreeARGB ScalosGfxARGBSetAlpha ScalosGfxARGBSetAlphaMask ScalosGfxCreateARGBFromBitMap ScalosGfxFillARGBFromBitMap ScalosGfxWriteARGBToBitMap ScalosGfxMedianCut ScalosGfxScaleARGBArray ScalosGfxScaleBitMap ScalosGfxCalculateScaleAspect ScalosGfxBlitARGB ScalosGfxFillRectARGB ScalosGfxSetARGB ScalosGfxNewColorMap ScalosGfxARGBRectMult ScalosGfxBlitARGBAlpha ScalosGfxBlitARGBAlphaTagList ScalosGfxBlitIcon
NAME
ScalosGfxCreateEmptySAC -- Allocate an empty ScalosBitMapAndColor
SYNOPSIS
sac = ScalosGfxCreateEmptySAC( )
D0
struct ScalosBitMapAndColor *ScalosGfxCreateEmptySAC( void );
FUNCTION
Allocates an empty ScalosBitMapAndColor structure, with NULL
sca_BitMap and sac_ColorTable.
INPUTS
none
RESULT
sac - new created ScalosBitMapAndColor, or NULL on failure
SEE ALSO
ScalosGfxFreeSAC(), ScalosGfxCreateSAC()
NAME
ScalosGfxCreateSAC -- Allocate ScalosBitMapAndColor
SYNOPSIS
sac = ScalosGfxCreateSAC(width, height, depth, friendBM, tagList);
D0 D0 D1 D2 A0 A1
struct ScalosBitMapAndColor *ScalosGfxCreateSAC(ULONG, ULONG, ULONG,
struct BitMap *, struct TagItem *)
struct ScalosBitMapAndColor *ScalosGfxCreateSACTags(ULONG, ULONG, ULONG,
struct BitMap *, ULONG, ...)
FUNCTION
Allocate a ScalosBitMapAndColor structure. sac_BitMap and sac_ColorTable
are allocated according to specified dimensions.
INPUTS
width - Desired width of new ScalosBitMapAndColor BitMap.
height - Desired height of new ScalosBitMapAndColor BitMap.
depth - Desired depth of new ScalosBitMapAndColor BitMap. Must be less
than 256. sac_ColorTable will be allocated to hold 2^depth entries.
friendBM - Friend BitMap to use for BitMap allocation.
tagList - pointer to list of Tags, or NULL.
TAGS
None defined yet.
RESULT
sac - new created ScalosBitMapAndColor, or NULL on failure
SEE ALSO
ScalosGfxFreeSAC(), ScalosGfxCreateEmptySAC()
NAME
ScalosGfxFreeSAC -- free a previously allocated ScalosBitMapAndColor
SYNOPSIS
ScalosGfxFreeSAC(sac);
A0
void ScalosGfxFreeSAC((struct ScalosBitMapAndColor *);
FUNCTION
Frees and deallocates a previously allocated ScalosBitMapAndColor,
including sac_BitMap and sac_ColorTable.
INPUTS
sac - previously allocated ScalosBitMapAndColor, or NULL
RESULT
nothing
SEE ALSO
ScalosGfxCreateSAC(), ScalosGfxCreateEmptySAC()
NAME
ScalosGfxCreateARGB -- Allocate a gfxARGB with specified size
SYNOPSIS
argb = ScalosGfxCreateARGB(width, height, tagList)
D0 D0 D1 A0
struct gfxARGB *ScalosGfxCreateARGB(ULONG, ULONG, struct TagItem *)
FUNCTION
Allocates an array of struct gfxARGB with sufficient size for
specified width and height.
INPUTS
width - width of gfxARGB array
height - height of gfxARGB array
tagList - pointer to list of Tags, or NULL.
TAGS
None defined yet.
RESULT
argb - new allocated gfxARGB, or NULL on failure.
SEE ALSO
NAME
ScalosGfxFreeARGB -- Free a previously allocated gfxARGB
SYNOPSIS
ScalosGfxFreeARGB(argb)
D0 A0
VOID ScalosGfxFreeARGB(struct gfxARGB **)
FUNCTION
INPUTS
argb - pointer to storage of previously allocated gfxARGB.
argb may point to NULL.
RESULT
nothing
SEE ALSO
ScalosGfxCreateARGB()
NAME
ScalosGfxARGBSetAlpha -- Set all pixels to specified Alpha value.
SYNOPSIS
ScalosGfxARGBSetAlpha(src, alpha);
A0 D0
VOID ScalosGfxARGBSetAlpha(struct ARGBHeader *, UBYTE)
FUNCTION
Alpha value of all pixels in the ARGBHeader and its previously
allocated gfxARGB array is set to the specified value.
INPUTS
src - Header of gfxARGB rectangle to modify.
alpha - Alpha (transparency) value to set.
RESULT
SEE ALSO
ScalosGfxARGBSetAlphaMask()
NAME
ScalosGfxARGBSetAlphaMask -- Set alpha value according to mask plane
SYNOPSIS
ScalosGfxARGBSetAlphaMask(argbh, maskPlane)
A0 A1
VOID ScalosGfxARGBSetAlphaMask(struct ARGBHeader *, PLANEPTR)
FUNCTION
Alpha values of all pixels in the ARGBHeader and its previously
allocated gfxARGB array are set according to mask plane, i.e. for
every bit set in mask plane, alpha is maximum (255), and for every
cleared bit, alpha is set to minimum (0).
INPUTS
argbh - Header of gfxARGB rectangle to modify.
maskPlane - Single bit mask plane. Dimensions must match size of argbh, with
width rounded up to next 16-bit.
RESULT
nothing
SEE ALSO
ScalosGfxARGBSetAlpha()
NAME
ScalosGfxCreateARGBFromBitMap -- Create gfxARGB array from a BitMap
SYNOPSIS
argb = ScalosGfxCreateARGBFromBitMap(bm, width, height, numberOfColors, colorTable, maskPlane
D0 A0 D0 D1 D2 A1 A2
struct gfxARGB *ScalosGfxCreateARGBFromBitMap(struct BitMap *, ULONG, ULONG, ULONG,
const ULONG *, PLANEPTR)
FUNCTION
Allocates and a gfxARGB array with specified dimensions, and fills it from
provided BitMap, with optional mask plane. Works only with standard BitMaps with
less than 256 colors.
INPUTS
bm - source BitMap to fill gfxARGB array from,
Depth must be less than 256 colors.
width - Width of gfxARGB array
height - Height of gfxARGB array
numberOfColors - number of entries in colorTable
colorTable - Color table to use for BitMap
maskPlane - Single bit mask plane. Dimensions must match width and
height, with width rounded up to next 16-bit. May be NULL.
RESULT
argb - allocated gfxARGB array or NULL on failure.
NOTES
Use ScalosGfxFillARGBFromBitMap() for high-color or true-color BitMaps.
SEE ALSO
ScalosGfxFillARGBFromBitMap()
NAME
ScalosGfxFillARGBFromBitMap -- Fill previously allocated gfxARGB array from CGFX BitMap
SYNOPSIS
ScalosGfxFillARGBFromBitMap(argbh, srcBM, maskPlane)
A0 A1 A2
VOID ScalosGfxFillARGBFromBitMap(struct ARGBHeader *, struct BitMap *, PLANEPTR)
FUNCTION
Fill a previously allocated gfxARGB array from a CyberGraphics BitMap. Can only
be used for high-color or true-color BitMaps.
If maskPlane if given, alpha information in argbh is created from maskPlane. If
maskPlane if NULL, alpha channel from source BitMap is used if available,
otherwise alpha is set to opaque.
INPUTS
argbh - completely initialized gfxARGB array
srcBM - source BitMap to use for filling, depth must be at least 65536 colors
maskPlane - Single bit mask plane. Dimensions must match width and height, with
width rounded up to next 16-bit. May be NULL.
RESULT
nothing
NOTES
Use ScalosGfxARGBSetAlpha() for standard BitMaps (i.e. less than 256 colors).
SEE ALSO
ScalosGfxCreateARGBFromBitMap()
NAME
ScalosGfxWriteARGBToBitMap -- Copy gfxARGB array to BitMap
SYNOPSIS
ScalosGfxWriteARGBToBitMap(argbh, bm, numberOfColors, colorTable)
A0 A1 D0 A2)
VOID ScalosGfxWriteARGBToBitMap(struct ARGBHeader *, struct BitMap *, ULONG, const ULONG *)
FUNCTION
Creates a copy of gfxARGB array in destination BitMap,
using pre-defined colorTable. Works only with standard BitMaps, i.e. with
less than 256 colors. No sophisticated color reduction is performed, but
bit-fit pens are decided via FindBestPen().
INPUTS
argbh - gfxARGB array to read from
bm - Standard BitMap to write to. BitMap must
have less than 256 colors.
numberOfColors - Number of entries in colorTable
colorTable - color table to use for BitMap.
RESULT
nothing
SEE ALSO
NAME
ScalosGfxMedianCut -- Create color-reduced BitMap from gfxARGB array
SYNOPSIS
sac = ScalosGfxMedianCut(argbh, depth, tagList)
D0 A0 D0 A1
struct ScalosBitMapAndColor *ScalosGfxMedianCut(struct ARGBHeader *, ULONG, struct TagItem *)
struct ScalosBitMapAndColor *ScalosGfxMedianCutTags(struct ARGBHeader *, ULONG, ULONG, ...)
FUNCTION
Allocate and fill a color-reduced BitMap and a best-match color table from gfxARGB array.
Either ordered dithering or Floyd-Steinberg dithering will be used for best results.
INPUTS
argbh - gfxARGB array to read from
depth - desired depth of generated BitMap, must be less than 256.
tagList - array of tagItems, as desribed below, or NULL.
TAGS
SCALOSGFX_MedianCutFlags - Flags as described below.
SCALOSGFX_MedianCutFriendBitMap - struct BitMap *, friend BitMap to use
for allocating result BitMap
SCALOSGFX_MedianCutReservedColors - ULONG, number of reserved (unused) color
entries at start of generated color table.
FLAGS
SCALOSGFXFLAGF_MedianCut_FloydSteinberg - If set, Floyd-Steinberg dithering
will be used for color reduction.
RESULT
sac - created ScalosBitMapAndColor pointer, or NULL on failure.
SEE ALSO
NAME
ScalosGfxScaleARGBArray -- Scale given gfxARGB array
SYNOPSIS
argb = ScalosGfxScaleARGBArray(src, destWidth, destHeight, tagList)
D0 A0 A1 A2 A3
struct gfxARGB *ScalosGfxScaleARGBArray(const struct ARGBHeader *, ULONG *,
ULONG *, struct TagItem *)
struct gfxARGB *ScalosGfxScaleARGBArrayTags(const struct ARGBHeader *, ULONG *,
ULONG *, ULONG, ...)
FUNCTION
Scales given gfxARGB array to a new size. Supports both enlarging and shrinking
gfxARGB arrays.
INPUTS
src - source gfxARGB array, will not be modified
destWidth - desired width, might be internally corrected
if SCALEFLAGF_CORRECTASPECT is set.
destHeight - desired height, might be internally corrected
if SCALEFLAGF_CORRECTASPECT is set.
tagList - pointer to list of Tags, or NULL.
TAGS
SCALOSGFX_ScaleARGBArrayFlags - ULONG, specify some operation flags as listed below.
FLAGS
SCALEFLAGF_BICUBIC - allow bicubic scaling
SCALEFLAGF_BILINEAR - allow bilinear scaling
SCALEFLAGF_AVERAGE - allow average scaling
SCALEFLAGF_DOUBLESIZE - allow intermediate step via double size, to improve quality
SCALEFLAGF_CORRECTASPECT - allow correction of destWidth and destHeight to
meet source aspect ratio.
RESULT
argb - Scaled copy of the source gfxARGB array
SEE ALSO
NAME
ScalosGfxScaleBitMap -- Scale given BitMap
SYNOPSIS
bm = ScalosGfxScaleBitMap(sbma, tagList)
D0 A0 A1
struct BitMap *ScalosGfxScaleBitMap(struct ScaleBitMapArg *, struct TagItem *)
struct BitMap *ScalosGfxScaleBitMapTags(struct ScaleBitMapArg *, ULONG, ...)
FUNCTION
Scales given gfxARGB array to a new size. Supports both enlarging and shrinking
gfxARGB arrays.
INPUTS
sbma - Structure with scaling parameters:
sbma_SourceBM - The original BitMap. This BitMap is not modified.
sbma_SourceWidth - Width of the source BitMap.
sbma_SourceHeight - Height of the source BitMap
sbma_DestWidth - Pointer to Width of resized BitMap, might be internally
corrected if SCALEFLAGF_CORRECTASPECT is set.
sbma_DestHeight - Pointer to Height of resized BitMap, might be internally
corrected if SCALEFLAGF_CORRECTASPECT is set.
sbma_NumberOfColors - number of entries in color table
sbma_ColorTable - Color table for both source and resized BitMap.
sbma_Flags - scaling flags:
SCALEFLAGF_BICUBIC - allow bicubic scaling
SCALEFLAGF_BILINEAR - allow bilinear scaling
SCALEFLAGF_AVERAGE - allow average scaling
SCALEFLAGF_DOUBLESIZE - allow intermediate scaling step with
double size, to improve quality
SCALEFLAGF_CORRECTASPECT - allow correction of destWidth and
destHeight to meet source aspect ratio.
sbma_ScreenBM - Firend BitMap used when allocating resized BitMap.
tagList - pointer to list of Tags, or NULL.
TAGS
none defined yet.
RESULT
bm - Scaled copy of the original BitMap
SEE ALSO
NAME
ScalosGfxCalculateScaleAspect -- Adjust scaling dimensions to source aspect
SYNOPSIS
ScalosGfxCalculateScaleAspect(sourceWidth, sourceHeight, *destWidth, *destHeight)
D0 D1 A0 A1
VOID ScalosGfxCalculateScaleAspect(ULONG, ULONG, ULONG *, ULONG *)
FUNCTION
Adjusts either destWidth or destHeight according to aspect ratio of
sourceWidth and soureHeight.
INPUTS
sourceWidth - Unscaled width.
sourceHeight - Unscaled Height;
destWidth - Pointer to desired scaled width.
destHeight - Pointer to desired scaled width.
RESULT
nothing
SEE ALSO
NAME
ScalosGfxBlitARGB -- Blit rectangle between two gfxARGB array rectangles.
SYNOPSIS
ScalosGfxBlitARGB(destARGB, srcARGB, destLeft, destTop, srcLeft, srcTop, width, height)
A0 A1 D0 D1 D2 D3 D4 D5
VOID ScalosGfxBlitARGB(struct ARGBHeader *, const struct ARGBHeader *,
LONG, LONG, LONG, LONG, LONG, LONG)
FUNCTION
Blits user-defined rectangle from srcARGB at specified position into destARGB.
No alpha handling is performed, destination pixel values are simply
replaced by source pixels.
INPUTS
destARGB - destination gfxARGB array
srcARGB - source gfxARGB array
destLeft - Left start position in destARGB.
destTop - Top start position in destARGB.
srcLeft - Left start position in srcARGB.
srcTop - Top start position in srcARGB.
width - Width of blitted rectangle.
height - Height of blitted rectangle.
RESULT
nothing
SEE ALSO
NAME
ScalosGfxFillRectARGB -- Blit two gfxARGB array rectangles
SYNOPSIS
ScalosGfxFillRectARGB(destARGB, fillARGB, left, top, width, height)
A0 A1 D0 D1 D2 D3
VOID ScalosGfxFillRectARGB(struct ARGBHeader *, const struct gfxARGB *,
LONG, LONG, LONG, LONG)
FUNCTION
Blits fillARGB at specified position into destARGB. No alpha handling is
performed, destination pixel values are just replaced by source pixels.
Blit always starts at (0,0) in fillARGB.
INPUTS
destARGB - destination gfxARGB array.
fillARGB - source gfxARGB array.
left - Left start position in destARGB.
top - Top start position in destARGB.
width - Width of blitted rectangle.
height - Height of blitted rectangle.
RESULT
nothing
SEE ALSO
NAME
ScalosGfxSetARGB -- Set entire gfxARGB array to given ARGB color
SYNOPSIS
ScalosGfxSetARGB(destARGB, fillARGB)
A0 A1
VOID ScalosGfxSetARGB(struct ARGBHeader *, const struct gfxARGB *)
FUNCTION
Set all pixels in entire gfxARGB array to the given ARGB color.
INPUTS
destARGB - gfxARGB array to be changed.
fillARGB - ARGB value to set pixels to.
RESULT
nothing
SEE ALSO
NAME
ScalosGfxNewColorMap -- Allocate new color table for ScalosBitMapAndColor
SYNOPSIS
success = ScalosGfxNewColorMap(sac, colorMap, colorEntries)
D0 A0 A1 D0
BOOL ScalosGfxNewColorMap(struct ScalosBitMapAndColor *, const ULONG *, ULONG)
FUNCTION
Allocates a new color table for ScalosBitMapAndColor. The new color table is
filled with the RGB values from colorMap.
Any previously color table in ScalosBitMapAndColor is freed.
INPUTS
sac - ScalosBitMapAndColor where to store new color table.
colorMap - RGB values for new color table
colorEntries - Desired number of entries in new color table
RESULT
success - TRUE if new color table was successfully allocated,
FALSE on failure.
SEE ALSO
NAME
ScalosGfxARGBRectMult -- Multiply RGB value with given factor
SYNOPSIS
ScalosGfxARGBRectMult(rp, numerator, denominator, xMin, yMin, xMax, yMax)
A0 A1 A2 D0 D1 D2 D3
VOID ScalosGfxARGBRectMult(struct RastPort *, const struct gfxARGB *,
const struct gfxARGB *, WORD, WORD, WORD, WORD)
FUNCTION
Multiplies RGB values of pixels within a specified rectangle
with (numerator/denominator). Overflow is clipped to maximum RGB value (255).
Works only with CyberGraphics generated, high-color or true-color BitMaps.
Takes Layers in RastPort into account.
INPUTS
rp - RastPort with the BitMap to be modified.
numerator - Scaling factor as numerator:denominator
denominator - Scaling factor as numerator:denominator
xMin - Left start of modified rectangle.
yMin - Top start of modified rectangle.
xMax - Right end of modified rectangle.
yMax - Bottom end of modified rectangle.
RESULT
nothing
SEE ALSO
NAME
ScalosGfxBlitARGBAlpha -- Alpha blit from gfxARGB array into RastPort
SYNOPSIS
ScalosGfxBlitARGBAlpha(rp, srcH, destLeft, destTop, srcLeft, srcTop, width, height)
A0 A1 D0 D1 D2 D3 D4 D5
VOID ScalosGfxBlitARGBAlpha (struct RastPort *, const struct ARGBHeader *,
ULONG, ULONG, ULONG, ULONG, ULONG, ULONG)
FUNCTION
Blit a rectangular area from source gfxARGB array into
destination RastPort. Alpha (transparency) information in
source gfxARGB array is fully accounted for.
Destination RastPort may have Layers.
INPUTS
rp - Destination, this RastPort is been drawn to.
srcH - Source gfxARGB array
destLeft - Left offset in destination RastPort.
destTop - Top offset in destination RastPort.
srcLeft - Left offset in source gfxARGB array.
srcTop - Left offset in source gfxARGB array.
width - Width of blit rectangle.
height - Height of blit rectangle.
RESULT
nothing
NOTES
SEE ALSO
ScalosGfxBlitARGBAlphaTagList()
NAME
ScalosGfxBlitARGBAlphaTagList -- Alpha blit from gfxARGB array into RastPort
SYNOPSIS
ScalosGfxBlitARGBAlphaTagList(rp, srcH, destLeft, destTop, srcSize, tagList)
A0 A1 D0 D1 A3 A2
VOID ScalosGfxBlitARGBAlphaTagList(struct RastPort *, const struct ARGBHeader *,
ULONG, ULONG, const struct IBox *, struct TagItem *)
VOID ScalosGfxBlitARGBAlphaTags(struct RastPort *, const struct ARGBHeader *,
ULONG, ULONG, const struct IBox *, ULONG, ...)
FUNCTION
INPUTS
rp - Destination, this RastPort is been drawn to.
srcH - Source gfxARGB array
destLeft - Left offset in destination RastPort.
destTop - Top offset in destination RastPort.
srcSize - IBox defining both left/top offset in source gfxARGB
array, and size of blit rectangle.
tagList - pointer to list of Tags, or NULL.
TAGS
SCALOSGFX_BlitIconHilight - const struct ARGB *, ARGB value to use
for highlighting.Its RGB values are added
to the destination pixels, with clipping
to 0..255 range.
SCALOSGFX_BlitIconAlpha - const UBYTE *, specify alpha array for icon.
SCALOSGFX_BlitIconTransparency - ULONG, specify alpha for icon, 0...255.
RESULT
nothing
SEE ALSO
ScalosGfxBlitARGBAlpha()
NAME
ScalosGfxBlitIcon -- Alpha blit from RastPort to RastPort
SYNOPSIS
ScalosGfxBlitIcon(rpBackground, rpIcon, left, top, width, height, tagList)
A0 A1 D0 D1 D2 D3 A2
VOID ScalosGfxBlitIcon(struct RastPort *, struct RastPort *,
ULONG, ULONG, ULONG, ULONG, struct TagItem *)
VOID ScalosGfxBlitIconTags(struct RastPort *, struct RastPort *,
ULONG, ULONG, ULONG, ULONG, ULONG, ...)
FUNCTION
Blit a rectangular area from rpIcon into rpBackground, with full
alpha (transparency) support.
This function supports RastPorts with Layers.
INPUTS
rpBackground - Target RastPort.
rpIcon - Source RastPort. The BitMap of this RastPort is
not modified.
left - left start of blit in rpBackground
top - top start of blit in rpBackground
width - width of the blitting rectangle
height - height of the blitting rectangle
tagList - pointer to list of Tags, or NULL.
TAGS
SCALOSGFX_BlitIconHilight - const struct ARGB *, ARGB value to use
for highlighting. Its RGB values are
added to the destination pixels, with
clipping to 0..255 range.
SCALOSGFX_BlitIconAlpha - const UBYTE *, specify alpha array for icon.
SCALOSGFX_BlitIconTransparency - ULONG, specify alpha for icon, 0...255.
RESULT
nothing
SEE ALSO
Scalos API
[edit | edit source]--background --Scalos_Message --Modules --PlugIn's --MenuPlugIn's SM_AddIcon SM_AppSleep SM_AppWakeup SM_CloseWindow SM_DeltaMove SM_DoPopupMenu SM_Iconify SM_NewPreferences SM_NewPattern SM_NewWindowPath SM_PrefsChanged SM_Redraw SM_RedrawIcon SM_RedrawIconObj SM_RemIcon SM_Requester SM_RunMenuCmd SM_RunProcess SM_SetThumbnailImage_ARGB SM_SetThumbnailImage_Remapped SM_ShowPopupMenu SM_ShowStatusBar SM_ShowTitle SM_Sleep SM_UnIconify SM_Update SM_UpdateIcon SM_Wakeup
NAME
--background
DESCRIPTION
This documentation gives you information how to communicate with
Scalos and its windowtasks. There are not many MessageTypes
currently available, but it will be more in future.
NAME
--Scalos_Message
DESCRIPTION
If you send a message to scalos you should use the SCA_AllocMessage()
and SCA_FreeMessage() calls from the scalos.library. The returned
message will look like this:
struct ScalosMessage
{
struct Message sm_Message;
ULONG sm_Signature; /* "IMSG" */
ULONG sm_MessageType;
};
The message ports where to sent the messages to are available via
the SCA_LockWindowList() / SCA_UnLockWindowList() calls from
scalos.library.
Additional data depends upon MessageType.
SYNOPSIS will give you information about this data. INPUTS means the
message for PutMsg() and RESULT the one that was replied.
NAME
--Modules
DESCRIPTION
Modules are programs with a standard wb-start enviroment. The
arguments are additional values (e.g. Execute_Command: the dir and
the filename as default value for the string-gadget).
NAME
--PlugIn's
DESCRIPTION
PlugIn's are external BOOPSI Classes that will enhance or replace
internal classes. The only thing you have to do is to write a little
shared library with only one offset. The library base should have at
least a structure of a Library structure followed by a longword
(four bytes). These four bytes are used to store an identifier so that
Scalos can know that it is a Scalos plugin. The value for these four
bytes should be 'PLUG' (which you should set in the initialisation
routine of your plugin, or the auto initialisation).
The one specific offset (it must be the first public function of your
library if you decide to have more functions) has to return a ScaClassInfo
struct. Your PlugIn can be added automatically on startup if you
add it to the PlugIn list in Scalos Prefs.
SYNOPSIS
ScaClassInfo SCAGetClassInfo()
D0
struct ScaClassInfo *SCAGetClassInfo( void );
NAME
--MenuPlugIn's
DESCRIPTION
A MenuPlugIn is a little library with one function. As with the standard
plugins, your plugin function must be the first public function of the
library. Menu plugins also require an identifier in the four bytes
following the Library structure of the library base. In the case of menu
plugins, the value for these four bytes should be 'OOPP'.
This functions have to be full reentrant. The windowtask is blocked until
your function returns. Never open a requester or block the task for a
long time use SCCM_AsyncRoutine instead.
SYNOPSIS
SCAMenuFunction( WindowTask, IconNode) A0 A1
void SCAMenuFunction( struct ScaWindowTask *, struct ScaIconNode *);
NOTES In order to get a pointer to the IconNode, your plugin must be called from an popup menu. When called from a screen menu, the IconNode pointer is always NULL.
NAME
SM_DeltaMove
SYNOPSIS
LONG smdm_DeltaX; LONG smdm_DeltaY; ULONG smdm_AdjustSlider;
FUNCTION
Moves window interior by (deltaX,deltaY) and adjusts scrollers accordingly.
INPUTS
smdm_DeltaX - number of pixels to scroll the window contents in horizontal direction. smdm_DeltaY - number of pixels to scroll the window contents in vertical direction. smdm_AdjustSlider - Flags to use for correction of virtual size SETVIRTF_AdjustRightSlider = adjust right (vertical) slider SETVIRTF_AdjustBottomSlider = set bottom (horizontal) slider
RESULT
nothing
SEE ALSO
IconWindow.sca/SCCM_IconWin_DeltaMove IconWindow.sca/SCCM_IconWin_SetVirtSize
NAME
SM_CloseWindow
SYNOPSIS
FUNCTION
Closes the window of the selected messageport.
INPUTS
none
RESULT
nothing
SEE ALSO
NAME
SM_DoPopupMenu
SYNOPSIS
FUNCTION
Trigger opening of a window or icon popup menu.
INPUTS
smdpm_InputEvent - InputEvent that triggered the popup menu. The mouse coordinates from the InputEvent are ignored, and the screen->MouseX, MouseY are used instead.
RESULT
nothing
SEE ALSO
NAME
SM_NewPattern
SYNOPSIS
APTR nmnp_PatternNode
FUNCTION
Sets a new pattern for the window
INPUTS
snmp_PatternNode - the new pattern or NULL for no pattern.
RESULT
nothing
SEE ALSO
NAME
SM_NewWindowPath
SYNOPSIS
FUNCTION
Change contents in existing window to display the given new path.
INPUTS
STRPTR smnwp_Path - Path of the new drawer to display in the window struct TagItem *smnwp_TagList - additional tags
Supported tags are: SCA_ShowAllMode - one of the workbench DDFLAGS_* values. SCA_ViewModes - one of the workbench DDVM_BY* values SCA_XOffset - (LONG) Window X offset SCA_YOffset - (LONG) Window Y offset SCA_IconList - (struct ScaIconNode *) pregenerated icon list
RESULT
nothing
SEE ALSO
IconWindow.sca/SCCM_IconWin_NewPath
NAME
SM_PrefsChanged
SYNOPSIS
ULONG Flags
FUNCTION
Inform existing window about changed preferences. The window is responsible to perform any required updating.
INPUTS
ULONG Flags - future flags. Set to 0 for upwards compatibility.
RESULT
nothing
SEE ALSO
NAME
SM_Sleep
SYNOPSIS
FUNCTION
The windowtask that receives this message will be sleep. Only the window will be closed, no icon will be displayed.
INPUTS
none
RESULT
nothing
NOTES Never send this message to a the main_messageport!
SEE ALSO
SM_Wakeup
NAME
SM_Wakeup
SYNOPSIS
ULONG smwu_ReLayout
FUNCTION
Wakeup the selected window_task. It's the opposite to SM_Sleep.
INPUTS
smwu_ReLayout - BOOL TRUE if all icons of the window should be relayouted. This is especially important when WorkBench screen has changed.
RESULT
nothing
NOTES Never send this message to a the main_messageport!
SEE ALSO
SM_Sleep
NAME
SM_AppSleep
SYNOPSIS
FUNCTION
All windowtasks and all ScalosApplications will fall asleep.
INPUTS
none
RESULT
nothing
NOTES This message must be sent to the main_messageport!
SEE ALSO
SM_AppWakeup
NAME
SM_AppWakeup
SYNOPSIS
ULONG smaw_ReLayout
FUNCTION
Wakeup all thing that sleeps since SM_AppSleep.
INPUTS
smaw_ReLayout - TRUE if all icons should be relayouted. This is especially important when WorkBench screen has changed.
RESULT
nothing
NOTES This message must be sent to the main_messageport!
SEE ALSO
SM_AppSleep
NAME
SM_Redraw
SYNOPSIS
ULONG smmr_Flags
FUNCTION
Redraws the icons inside of the window. This method could be uses to refresh the window after adding or selecting/deselecting icons.
INPUTS
smmr_Flags - REDRAWB_DontEraseWindow : don't erase window before redraw REDRAWB_ReLayoutIcons : relayout icons
RESULT
nothing
SEE ALSO
NAME
SM_RedrawIcon
SYNOPSIS
struct ScaIconObject *smri_Icon
FUNCTION
Redraws the specified icon inside of the window. The window icon list semaphore must not be kept locked for this message to work! Before actually trying to redraw, an explicit check is done whether the icon is really member of the window's icon list.
INPUTS
smri_Icon - the icvon to be redrawn
RESULT
nothing
SEE ALSO
NAME
SM_RedrawIconObj
SYNOPSIS
Object *smrio_IconObject ULONG smrio_Flags
FUNCTION
Redraws the specified iconobject inside of the window. The window icon list semaphore must not be kept locked for this message to work! Before actually trying to redraw, an explicit check is done whether the icon is really member of the window's icon list. Optionally, the icon can be explicitly erased before redrawing, and a new icon icon layout may be requested (IDTM_FreeLayout / IDTM_Layout).
INPUTS
smrio_IconObject - the iconobject to be redrawn smrio_Flags SMRIOFLAGF_EraseIcon - the iconobject is erased before redraw SMRIOFLAGF_FreeLayout - the iconobject is forced to refresh its layout (with IDTM_FreeLayout and IDTM_Layout). SMRIOFLAGF_Highlight - indicates that there is only a change in icon highlighting state. SMRIOFLAGF_IconListLocked - the window icon list is currently locked. SMRIOFLAGB_HightlightOn - set ICONOBJ_USERFLAGF_DrawHighlite before drawing. Useful in combination with SMRIOFLAGF_Highlight. SMRIOFLAGB_HightlightOff - clear ICONOBJ_USERFLAGF_DrawHighlite before drawing. Useful in combination with SMRIOFLAGF_Highlight.
RESULT
nothing
SEE ALSO
NAME
SM_SetThumbnailImage_ARGB
SYNOPSIS
Object *smtia_IconObject struct ARGBHeader smtia_NewImage
FUNCTION
Attach a new ARGB image to an existing icon. The sender of this message is responsible to make sure that destination icon is able to handle true-color ARGB images.
INPUTS
smtia_IconObject - the icon to attach the new image to. smtia_NewImage -- the new ARGB image. ARGBHeader contents (BitMap) is supposed to be freed by message receiver.
RESULT
nothing
SEE ALSO
NAME
SM_SetThumbnailImage_Remapped
SYNOPSIS
Object *smtir_IconObject; // the icon to attach the new image to struct ScalosBitMapAndColor *smtir_NewImage; // the new image. ScalosBitMapAndColor contents is freed by message handler
FUNCTION
Attach a new color-mapped image to an existing icon. The sender of this message is responsible to make sure that destination icon is able to handle the color-mapped image.
INPUTS
smtir_IconObject -- the icon to attach the new image to. smtir_NewImage -- the new image. ScalosBitMapAndColor contents is supposed to be freed by message receiver.
RESULT
nothing
SEE ALSO
NAME
SM_ShowPopupMenu
SYNOPSIS
struct PopupMenu *pm struct ScaIconNode *in ULONG Flags struct FileTypeDef *fType
FUNCTION
Show a popup menu and execute the user's menu command.
INPUTS
pm - Popup menu to display. in - Scalos icon node the popup menu should be associated to. Can be NULL for window popup menus. Flags - Show which items are still locked and HAVE TO BE UNLOCKED during processing. SHOWPOPUPFLGF_IconSemaLocked - wt_IconSemaphore is still locked SHOWPOPUPFLGF_WinListLocked - Scalos window list is still locked. fType - Private data structure for support of file type specific popup menus. Should be NULL if unused.
RESULT
nothing
SEE ALSO
NAME
SM_ShowStatusBar
SYNOPSIS
BOOL Visible
FUNCTION
Show or hide the status bar on a Scalos window.
INPUTS
Visible - TRUE to display the status bar, FALSE to hide it.
RESULT
nothing
SEE ALSO
NAME
SM_Update
SYNOPSIS
FUNCTION
Causes the window to reread its icons.
INPUTS
none
RESULT
nothing
SEE ALSO
NAME
SM_UpdateIcon
SYNOPSIS
BPTR smui_DirLock CONST_STRPTR smui_IconName
FUNCTION
Refresh a selected icon.
INPUTS
smui_DirLock - Lock to parent dir of icon. smui_IconName - Name of the icon.
RESULT
nothing
NOTES You must create copies of smui_DirLock and smui_IconName before sending this message. Those copies will be deleted by Scalos.
Example: smui_DirLock = DupLock(myLock); smui_IconName = AllocVec(1 + strlen(myName), MEMF_PUBLIC);
SEE ALSO
scalos.library/SCA_UpdateIcon()
NAME
SM_AddIcon
SYNOPSIS
UWORD smai_x UWORD smai_y BPTR smai_DirLock STRPTR smai_IconName
FUNCTION
Causes a window task to load a selected icon.
INPUTS
smai_x smai_y - the position where the icon should appear or 0x8000 for any smai_DirLock - Lock to parent dir of icon. smai_IconName - Name of the icon.
RESULT
nothing
SEE ALSO
NAME
SM_RemIcon
SYNOPSIS
BPTR smri_DirLock STRPTR smri_IconName
FUNCTION
Removes an icon from window.
INPUTS
smri_DirLock - Lock to parent dir of icon. smri_IconName - Name of the icon.
RESULT
nothing
SEE ALSO
NAME
SM_Iconify
SYNOPSIS
FUNCTION
Set the window to sleep and adds an icon to the main window.
INPUTS
none
NOTES Never send this message to the main window!
RESULT
nothing
SEE ALSO
SM_UnIconify
NAME
SM_UnIconify
SYNOPSIS
FUNCTION
Removes the appicon from main window and reopens the window.
INPUTS
none
RESULT
nothing
NOTES Never send this message to the main window!
SEE ALSO
SM_Iconify
NAME
SM_RunMenuCmd
SYNOPSIS
APTR smrm_MenuItem struct ScaIconNode *smrm_IconNode ULONG smrm_Flags
FUNCTION
This message is used to execute a Scalos menu command in some other window task's context.
INPUTS
smrm_MenuItem - internal Scalos menu item descriptor smrm_IconNode - Iconnode to execute the command with. smrm_Flags - none defined yet.
RESULT
nothing
SEE ALSO
NAME
SM_ShowTitle
SYNOPSIS
ULONG smst_showTitle
FUNCTION
This message is used to set the screen title bar display mode.
INPUTS
smst_showTitle - Screen title bar mode If TRUE, the screen's title bar will be shown in front of WFLG_BACKDROP windows. If FALSE, the title bar will be rendered behind all windows.
RESULT
nothing
SEE ALSO
NAME
SM_Requester
SYNOPSIS
union { ULONG smrq_ReqResult; struct Window *smrq_ParentWindow; }; APTR smrq_ArgList; struct EasyStruct smrq_ez; UBYTE smrq_ArgListBuffer[0];
FUNCTION
Asynchronously pops up a requester and returns the result.
INPUTS
smrq_ParentWindow - designates which screen to open the requester on. smrq_ReqResult - Here the result from EaysRequest() is returned. smrq_ArgList - pointer to ArgList for EasyRequestArgs(). smrq_ez - Contains information for EasyRequestArgs() smrq_ArgListBuffer - buffer for ArgList - allocated as large as needed. Put the required buffer length into the additional_size parameter of the SCA_AllocMessage() call.
RESULT
nothing
SEE ALSO
intuition.library/EasyRequestArgs() scalos/SCA_AllocMessage()
NAME
SM_NewPreferences
SYNOPSIS
ULONG smnp_PrefsFlags
FUNCTION
Triggers re-reading and checking of preferences files used by Scalos. Multiple invocations of SM_NewPreferences accumulate the bits for changes subsystems. When there are no more SM_NewPreferences for 0.5s, all marked preferences are re-read and check for changes. If changes are detected, Scalos reinitializes subsystems as required by the preferences changes.
INPUTS
smnp_PrefsFlags - Bitmask with one bit set for each changed preferences file. .
RESULT
nothing
SEE ALSO
Device List
[edit | edit source]--background SCCM_DeviceList_Generate SCCM_DeviceList_FreeDevNode SCCM_DeviceList_Filter
NAME
--background
DESCRIPTION
This class is used to generate a list of all currently available
devices. The list will be used to load or update diskicons. You may
use this class to filter the devices.
NAME
SCCM_DeviceList_Generate
SYNOPSIS
DoMethod(obj,SCCM_DeviceList_Generate,APTR NodeList);
FUNCTION
Generates the full list of devices.
Scans through the DosList and adds a ScaDeviceIcon to the
NodeList for every appropriate device/volume found.
When finished scanning, applies SCCM_DeviceList_Filter to the
NodeList of generated icons.
INPUTS
NodeList - pointer to an empty ScalosNodeList
SEE ALSO
NAME
SCCM_DeviceList_FreeDevNode
SYNOPSIS
DoMethod(obj,SCCM_DeviceList_FreeDevNode,APTR Node);
FUNCTION
Frees anything inside of this node, but not the node itself.
INPUTS
Node - DeviceNode
SEE ALSO
NAME
SCCM_DeviceList_Filter
SYNOPSIS
DoMethod(obj,SCCM_DeviceList_Filter,APTR NodeList);
FUNCTION
Filters the list of DeviceNodes. You can hide some devices or restore
the nodelist. Default: all DOS-Devices without a volume will be
filtered. Checkout the flags field in the DeviceNode structure.
INPUTS
NodeList - pointer to a ScalosNodeList
SEE ALSO
Device Windows
[edit | edit source]Content-Type: text/html DeviceWin.sca
--background SCCM_DeviceWin_ReadIcon SCCM_DeviceWin_RemIcon
NAME
--background
DESCRIPTION
This class implements the main Workbench (= root) window, which
shows the icons for the mounted devices and volumes.
NAME
SCCM_DeviceWin_ReadIcon
SYNOPSIS
void DoMethod(obj,SCCM_DeviceWin_ReadIcon,
struct ScaDeviceIcon *DeviceNode);
FUNCTION
Read icon for device (DeviceNode) into window. Depending on prefs
settings "DefIcons First", it tries to read :
DefIconsFirst enabled:
1. default volume icon "<DefIconPath>/def_<VolumeName>.info"
2. default device icon "<DefIconPath>/def_<DeviceName>.info"
3. disk icon "<VolumeName>:disk.info"
DefIconsFirst disabled:
1. disk icon "<VolumeName>:disk.info"
2. default volume icon "<DefIconPath>/def_<VolumeName>.info"
3. default device icon "<DefIconPath>/def_<DeviceName>.info"
If everything else fails, a default icon if type WBDISK is read.
INPUTS
DeviceNode - info about what device to read icon for.
RESULT
nothing
SEE ALSO
NAME
SCCM_DeviceWin_RemIcon
SYNOPSIS
void DoMethod(obj,SCCM_DeviceWin_RemIcon,struct ScaIconNode *icon);
FUNCTION
Remove specified icon from window
INPUTS
icon - Icon to remove from window
RESULT
nothing
SEE ALSO
filetrans
[edit | edit source]root
[edit | edit source]window
[edit | edit source]--background SCCM_Window_ChangeWindow SCCM_Window_Close SCCM_Window_DynamicResize SCCM_Window_GetIconFileType SCCM_Window_Iconify SCCM_Window_InitClipRegion SCCM_Window_LockUpdate SCCM_Window_NewPath SCCM_Window_RemClipRegion SCCM_Window_Open SCCM_Window_SetTitle SCCM_Window_SetInnerSize SCCM_Window_UnIconify SCCM_Window_UnlockUpdate
NAME
--background
DESCRIPTION
This class implements all common window functionality used for icon
windows, text windows and device windows.
All window methods are invoked with mt_WindowObject.
NAME
SCCM_Window_ChangeWindow
SYNOPSIS
DoMethod(obj,SCCM_Window_ChangeWindow);
FUNCTION
Notifies that a Scalos window may have changed either
position, or size, or both.
INPUTS
none
RESULT
nothing
SEE ALSO
NAME
SCCM_Window_Close
SYNOPSIS
DoMethod(obj,SCCM_Window_Close);
FUNCTION
Closes a scalos window
INPUTS
none
RESULT
nothing
SEE ALSO
NAME
SCCM_Window_DynamicResize
SYNOPSIS
DoMethod(obj,SCCM_Window_DynamicResize);
FUNCTION
Handles dynamic window resizing, including recalculation of window
inner size, and re-sorting of unpositioned icons (if enabled).
INPUTS
none
RESULT
nothing
SEE ALSO
NAME
SCCM_Window_GetIconFileType
SYNOPSIS
DoMethod(obj,SCCM_Window_GetIconFileType, struct ScaIconNode *in);
FUNCTION
Fills the in_FileType element of the Scalos icon with a TypeNode
according to the file type of the icon.
INPUTS
in - Scalos icon that gets its in_FileType updated.
RESULT
nothing
SEE ALSO
NAME
SCCM_Window_Iconify
SYNOPSIS
DoMethod(obj,SCCM_Window_Iconify);
FUNCTION
Iconifies a scalos window
INPUTS
none
RESULT
TRUE if window could be iconified successfully or
has already been iconified.
FALSE if something went wrong.
SEE ALSO
NAME
SCCM_Window_UnIconify
SYNOPSIS
DoMethod(obj,SCCM_Window_UnIconify);
FUNCTION
Uniconifies an iconified scalos window
INPUTS
none
RESULT
nothing
SEE ALSO
NAME
SCCM_Window_InitClipRegion
SYNOPSIS
struct Region *oldRegion = DoMethod(obj,SCCM_Window_InitClipRegion);
FUNCTION
Initializes window clip region so that all rendering is limited to
the window interior.
All window drawing - especially icon rendering - should be done
inside a SCCM_Window_InitClipRegion / SCCM_Window_RemClipRegion call.
INPUTS
none
RESULT
oldRegion - original clip region (to be supplied
to SCCM_Window_RemClipRegion)
SEE ALSO
SCCM_Window_RemClipRegion
NAME
SCCM_Window_LockUpdate
SYNOPSIS
void DoMethod(obj,SCCM_Window_LockUpdate)
FUNCTION
Holds all icon updates for that window.
INPUTS
none
RESULT
nothing
SEE ALSO
SCCM_Window_UnlockUpdate
NAME
SCCM_Window_NewPath
SYNOPSIS
void DoMethod(obj,SCCM_Window_NewPath,CONST_STRPTR path,ULONG tags,...);
FUNCTION
Inform window object about new path.
No-op in standard window classes.
INPUTS
path - command name
tags - tag list. Supported tags are:
SCA_ShowAllMode - one of the workbench DDFLAGS_* values.
SCA_ViewModes - one of the workbench DDVM_BY* values
SCA_XOffset - (LONG) Window X offset
SCA_YOffset - (LONG) Window Y offset
SCA_IconList - (struct ScaIconNode *) pregenerated icon list
RESULT
Success - FALSE on failure, TRUE to indiciate success.
SEE ALSO
scalosAPI/SM_NewWindowPath
IconWindow.sca/SCCM_IconWin_NewPath
NAME
SCCM_Window_RemClipRegion
SYNOPSIS
void DoMethod(obj,SCCM_Window_RemClipRegion,
struct Region *oldRegion);
FUNCTION
Resets window clip region to oldRegion.
INPUTS
oldRegion - original clip region
(Result from SCCM_Window_InitClipRegion)
RESULT
nothing
SEE ALSO
SCCM_Window_InitClipRegion
NAME
SCCM_Window_Open
SYNOPSIS
struct Window *win = DoMethod(obj,SCCM_Window_Open);
FUNCTION
Opens a scalos window
INPUTS
none
RESULT
win - Pointer to Intuition Window if window could be opened,
NULL if something went wrong.
SEE ALSO
NAME
SCCM_Window_SetTitle
SYNOPSIS
void DoMethod(obj,SCCM_Window_SetTitle, CONST_STRPTR title)
FUNCTION
Sets window title to (title).
INPUTS
title - window title string.
RESULT
nothing
SEE ALSO
NAME
SCCM_Window_SetInnerSize
SYNOPSIS
void DoMethod(obj,SCCM_Window_SetInnerSize)
FUNCTION
Update internal Scalos variables according to the current
window size and setup a new window clip region.
INPUTS
none
RESULT
nothing
SEE ALSO
NAME
SCCM_Window_UnlockUpdate
SYNOPSIS
void DoMethod(obj,SCCM_Window_UnlockUpdate)
FUNCTION
Enabled window updates stopped by SCCM_Window_LockUpdate.
INPUTS
none
RESULT
nothing
SEE ALSO
SCCM_Window_LockUpdate
iconwindow
[edit | edit source]--background SCCM_IconWin_ActivateIconDown SCCM_IconWin_ActivateIconLeft SCCM_IconWin_ActivateIconNext SCCM_IconWin_ActivateIconPrevious SCCM_IconWin_ActivateIconRight SCCM_IconWin_ActivateIconUp SCCM_IconWin_AddGadget SCCM_IconWin_AddIcon SCCM_IconWin_AddToControlBar SCCM_IconWin_AddToStatusBar SCCM_IconWin_Browse SCCM_IconWin_CleanUp SCCM_IconWin_CleanUpByDate SCCM_IconWin_CleanUpByName SCCM_IconWin_CleanUpBySize SCCM_IconWin_CleanUpByType SCCM_IconWin_ClearIconFileTypes SCCM_IconWin_CountWBArg SCCM_IconWin_DeltaMove SCCM_IconWin_DragDrop SCCM_IconWin_DragEnter SCCM_IconWin_DragQuery SCCM_IconWin_DragLeave SCCM_IconWin_DrawIcon SCCM_IconWin_GetDefIcon SCCM_IconWin_GetIconFileType SCCM_IconWin_History_Back SCCM_IconWin_History_Forward SCCM_IconWin_ImmediateCheckUpdate SCCM_IconWin_LayoutIcon SCCM_IconWin_MakeWBArg SCCM_IconWin_MenuCommand SCCM_IconWin_NewPath SCCM_IconWin_NewPatternNumber SCCM_IconWin_NewViewMode SCCM_IconWin_Open SCCM_IconWin_RawKey SCCM_IconWin_ReadIcon SCCM_IconWin_ReadIconList SCCM_IconWin_Redraw SCCM_IconWin_RemFromControlBar SCCM_IconWin_RemFromStatusBar SCCM_IconWin_RemIcon SCCM_IconWin_ScheduleUpdate SCCM_IconWin_SetVirtSize SCCM_IconWin_ShowGadgetToolTip SCCM_IconWin_ShowIconToolTip SCCM_IconWin_ShowPopupMenu SCCM_IconWin_Sleep SCCM_IconWin_StartNotify SCCM_IconWin_Update SCCM_IconWin_UpdateIcon SCCM_IconWin_UpdateControlBar SCCM_IconWin_UpdateStatusBar SCCM_IconWin_WakeUp
NAME
--background
DESCRIPTION
This class implements the functionality for the common workbench
icon windows.
ATTRIBUTES
SCCA_IconWin_Reading - (BOOL) [SG]
currently reading directory
SCCA_IconWin_SelectedCount - (ULONG) [SG]
number of selected icons in window
SCCA_IconWin_Typing - (BOOL) [SG]
user is currently tying icon name
SCCA_IconWin_ShowType - (ULONG) [SG]
DDFLAGS_SHOWDEFAULT, DDFLAGS_SHOWICONS, or DDFLAGS_SHOWALL
SCCA_IconWin_InnerWidth - (ULONG) [.G]
icon window inner width
SCCA_IconWin_InnerHeight - (ULONG) [.G]
icon window inner height
SCCA_IconWin_IconFont - (struct TextFont *) [.G]
icon window icon font
SCCA_IconWin_LayersLocked - (ULONG) [.G]
Flag: icon window has Layers locked
SCCA_IconWin_StatusBar - (BOOL) [SG]
Flag: Status bar is present
SCCA_IconWin_ThumbnailView - (ULONG) [SG]
Thumbnail display mode. One of THUMBNAILS_Never,
THUMBNAILS_Always, or THUMBNAILS_AsDefault.
Any other value makes the window use the default value,
as set in Scalos preferences.
NAME
SCCM_IconWin_ActivateIconDown
SYNOPSIS
DoMethod(obj,SCCM_IconWin_ActivateIconDown);
FUNCTION
Starting from the first icon currently selected, the icon located
directly below the selected will be activated.
If there is no icon selected, or the selected icon is located in
the bottommost row, the method is a no-op.
INPUTS
None
RESULT
nothing
SEE ALSO
SCCM_IconWin_ActivateIconUp
SCCM_IconWin_ActivateIconLeft
SCCM_IconWin_ActivateIconRight
NAME
SCCM_IconWin_ActivateIconLeft
SYNOPSIS
DoMethod(obj,SCCM_IconWin_ActivateIconLeft);
FUNCTION
Starting from the first icon currently selected, the icon located
directly left of the selected will be activated.
If there is no icon selected, or the selected icon is located in
the leftmost column, the method is a no-op.
INPUTS
None
RESULT
nothing
SEE ALSO
SCCM_IconWin_ActivateIconDown
SCCM_IconWin_ActivateIconUp
SCCM_IconWin_ActivateIconRight
NAME
SCCM_IconWin_ActivateIconNext
SYNOPSIS
DoMethod(obj,SCCM_IconWin_ActivateIconNext);
FUNCTION
Starting from the first icon currently selected, the icon which
alphabetically follows the name of the selected one
will be activated.
If there is no icon selected, the alphabetically first
icon will be selected.
If the currently activated icon is the alphabetically last one in
the window, this method will wrap around and activate the
alphabetically first one.
INPUTS
None
RESULT
nothing
SEE ALSO
SCCM_IconWin_ActivateIconPrevious
NAME
SCCM_IconWin_ActivateIconPrevious
SYNOPSIS
DoMethod(obj,SCCM_IconWin_ActivateIconPrevious);
FUNCTION
Starting from the first icon currently selected, the icon which
alphabetically precedes the name of the selected one
will be activated.
If there is no icon selected, the alphabetically last
icon will be selected.
If the currently activated icon is the alphabetically first one in
the window, this method will wrap around and activate the
alphabetically last one.
INPUTS
None
RESULT
nothing
SEE ALSO
SCCM_IconWin_ActivateIconNext
NAME
SCCM_IconWin_ActivateIconRight
SYNOPSIS
DoMethod(obj,SCCM_IconWin_ActivateIconRight);
FUNCTION
Starting from the first icon currently selected, the icon located
directly right of the selected will be activated.
If there is no icon selected, or the selected icon is located in
the rightmost column, the method is a no-op.
INPUTS
None
RESULT
nothing
SEE ALSO
SCCM_IconWin_ActivateIconDown
SCCM_IconWin_ActivateIconUp
SCCM_IconWin_ActivateIconLeft
NAME
SCCM_IconWin_ActivateIconUp
SYNOPSIS
DoMethod(obj,SCCM_IconWin_ActivateIconUp);
FUNCTION
Starting from the first icon currently selected, the icon located
directly above the selected will be activated.
If there is no icon selected, or the selected icon is located in
the topmost row, the method is a no-op.
INPUTS
None
RESULT
nothing
SEE ALSO
SCCM_IconWin_ActivateIconDown
SCCM_IconWin_ActivateIconLeft
SCCM_IconWin_ActivateIconRight
NAME
SCCM_IconWin_AddGadget
SYNOPSIS
DoMethod(obj,SCCM_IconWin_AddGadget,struct Gadget *g);
FUNCTION
Inserts a user-supplied Intuition Gadget at the front
of the internal Gadget list.
INPUTS
Gadget - User-supplied Gadget
SEE ALSO
NAME
SCCM_IconWin_AddIcon
SYNOPSIS
struct ScaIconNode *icon = DoMethod(obj,SCCM_IconWin_AddIcon,
WORD x,WORD y,BPTR Lock,CONST_STRPTR Name);
FUNCTION
Causes a window task to load the specified selected icon.
INPUTS
x - icon x position or $8000 for any position
y - icon y position
Lock - Lock on icon directory
Name - icon name
RESULT
icon - newly added ScaIconNode or NULL if something went wrong.
SEE ALSO
NAME
SCCM_IconWin_AddToControlBar
SYNOPSIS
DoMethod(obj,SCCM_IconWin_AddToControlBar,struct Gadget *g,
ULONG Tag, ...);
FUNCTION
Adds a new BOOPSI gadget to the window control bar.
INPUTS
g - new Gadget to be added
Tag - Taglist
RESULT
nothing
SEE ALSO
SCCM_IconWin_RemFromControlBar
NAME
SCCM_IconWin_AddToStatusBar
SYNOPSIS
DoMethod(obj,SCCM_IconWin_AddToStatusBar,struct Gadget *g,
ULONG Tag, ...);
FUNCTION
Adds a new BOOPSI gadget to the window status bar.
INPUTS
g - new Gadget to be added
Tag - Taglist
RESULT
nothing
SEE ALSO
SCCM_IconWin_RemFromStatusBar
NAME
SCCM_IconWin_Browse
SYNOPSIS
DoMethod(obj,SCCM_IconWin_Browse);
FUNCTION
Opens an ASL requester that allows selection of a new
path to display in the current window.
INPUTS
none
RESULT
nothing
SEE ALSO
NAME
SCCM_IconWin_ScheduleUpdate
SYNOPSIS
void DoMethod(obj,SCCM_IconWin_ScheduleUpdate);
FUNCTION
Schedule a check of the window for updated files and perform
updates, including adding and removing icons.
This real update check will be delayed for about 2 seconds in
order to avoid many rapidly repeated window updates, and is done
via the SCCM_IconWin_ImmediateCheckUpdate method.
These 2 seconds are restarted with each new
SCCM_IconWin_ScheduleUpdate invokation.
INPUTS
none
RESULT
nothing
SEE ALSO
SCCM_IconWin_ImmediateCheckUpdate
NAME
SCCM_IconWin_CleanUp
SYNOPSIS
void DoMethod(obj,SCCM_IconWin_CleanUp);
FUNCTION
Fits all window icons to free positions, including icons in
wt_LateIconList. Prevents icons from overlapping each other.
INPUTS
none
RESULT
nothing
SEE ALSO
NAME
SCCM_IconWin_CleanUpByDate
SYNOPSIS
void DoMethod(obj,SCCM_IconWin_CleanUpByDate);
FUNCTION
Sorts all window icons descending by date, and fits them to free
positions, including icons in wt_LateIconList.
Prevents icons from overlapping each other.
INPUTS
none
RESULT
nothing
SEE ALSO
SCCM_IconWin_CleanUpByName
SCCM_IconWin_CleanUpBySize
SCCM_IconWin_CleanUpByType
NAME
SCCM_IconWin_CleanUpByName
SYNOPSIS
void DoMethod(obj,SCCM_IconWin_CleanUpByName);
FUNCTION
Sorts all window icons ascending by name, and fits them to free
positions, including icons in wt_LateIconList.
Prevents icons from overlapping each other.
INPUTS
none
RESULT
nothing
SEE ALSO
SCCM_IconWin_CleanUpByDate
SCCM_IconWin_CleanUpBySize
SCCM_IconWin_CleanUpByType
NAME
SCCM_IconWin_CleanUpBySize
SYNOPSIS
void DoMethod(obj,SCCM_IconWin_CleanUpBySize);
FUNCTION
Sorts all window icons ascending by size, and fits them to free
positions, including icons in wt_LateIconList.
Prevents icons from overlapping each other.
INPUTS
none
RESULT
nothing
SEE ALSO
SCCM_IconWin_CleanUpByDate
SCCM_IconWin_CleanUpByName
SCCM_IconWin_CleanUpByType
NAME
SCCM_IconWin_CleanUpByType
SYNOPSIS
void DoMethod(obj,SCCM_IconWin_CleanUpByType);
FUNCTION
Sorts all window icons ascending by type, and fits them to free
positions, including icons in wt_LateIconList.
Prevents icons from overlapping each other.
INPUTS
none
RESULT
nothing
SEE ALSO
SCCM_IconWin_CleanUpByDate
SCCM_IconWin_CleanUpByName
SCCM_IconWin_CleanUpBySize
NAME
SCCM_IconWin_ClearIconFileTypes
SYNOPSIS
void DoMethod(obj,SCCM_IconWin_ClearIconFileTypes);
FUNCTION
Clears the filetype information for all windows in the icon
window. Useful if filetype information hasd changed
and has to be re-read.
INPUTS
none
RESULT
nothing
SEE ALSO
NAME
SCCM_IconWin_CountWBArg
SYNOPSIS
ULONG Count = DoMethod(obj,SCCM_IconWin_CountWBArg,
struct ScaIconNode *icon);
FUNCTION
Count arguments that will be crated by SCCM_IconWin_MakeWBArg.
Useful to allocate a WBArg buffer for SCCM_IconWin_MakeWBArg.
INPUTS
icon - icon to make WBArg from
if icon = NULL, return WBArg with wa_Lock = copy of
window lock and wa_Name = NULL
RESULT
Count - number of WBArg's that SCCM_IconWin_MakeWBArg will create
SEE ALSO
SCCM_IconWin_MakeWBArg
NAME
SCCM_IconWin_DeltaMove
SYNOPSIS
void DoMethod(obj,SCCM_IconWin_DeltaMove,LONG deltaX,LONG deltaY);
FUNCTION
Moves window interior by (deltaX,deltaY) and adjusts
scrollers accordingly.
INPUTS
deltaX - movement in horizontal direction
deltaY - movement in vertical direction
RESULT
nothing
SEE ALSO
NAME
SCCM_IconWin_DragDrop
SYNOPSIS
void DoMethod(obj,SCCM_IconWin_DragDrop,struct Window *dropWindow,
ULONG mouseX,ULONG mouseY,ULONG Qualifier);
FUNCTION
Drops all dragged icons into (dropWindow) at coordinates
(mouseX,MouseY).
INPUTS
dropWindow - Intuition window to drop in
mouseX - mouse x position from IntuiMessage
mouseY - mouse y position from IntuiMessage
Qualifier - qualifier position from IntuiMessage
RESULT
nothing
SEE ALSO
NAME
SCCM_IconWin_DragEnter
SYNOPSIS
void DoMethod(obj,SCCM_IconWin_DragEnter, struct ScaWindowStruct *StartWin,
struct ScaIconNode *Icon, ULONG MouseX, ULONG MouseY)
FUNCTION
Signals destination window that mouse pointer with attached
icons has entered the window area (drage_Icon = NULL) or
now points to icon (drage_Icon).
INPUTS
StartWin - scalos window from which dragging started
Icon -icon under mouse pointer
MouseX, MouseY - mouse coordinates.
RESULT
nothing
NOTE
It is VERY IMPORTANT that every SCCM_IconWin_DragEnter (icon
or window) is paired with a corresponding
SCCM_IconWin_DragLeave method (icon or window) call !!!
SEE ALSO
SCCM_IconWin_DragLeave
NAME
SCCM_IconWin_DragQuery
SYNOPSIS
BOOL DoMethod(obj,SCCM_IconWin_DragQuery, struct ScaWindowStruct *StartWin,
struct ScaIconNode *Icon, ULONG MouseX, ULONG MouseY)
FUNCTION
Check whether icons may be dropped into our window
or onto specified icon.
INPUTS
StartWin - scalos window from which dragging started
Icon -icon under mouse pointer
MouseX, MouseY - mouse coordinates.
RESULT
BOOL
TRUE yes, we may drop here
FALSE no, dropping not allowed
SEE ALSO
NAME
SCCM_IconWin_DragLeave
SYNOPSIS
void DoMethod(obj,SCCM_IconWin_DragLeave, struct ScaWindowStruct *StartWin,
struct ScaIconNode *Icon, ULONG MouseX, ULONG MouseY);
FUNCTION
Signals destination window that mouse pointer with attached
icons has left the window area (drage_Icon = NULL) or
now points no longer to icon (drage_Icon).
INPUTS
StartWin - scalos window from which dragging started
Icon -icon under mouse pointer
MouseX, MouseY - mouse coordinates.
RESULT
nothing
NOTE
It is VERY IMPORTANT that every SCCM_IconWin_DragEnter (icon
or window) is paired with a corresponding
SCCM_IconWin_DragLeaveDrag method (icon or window) call !!!
SEE ALSO
SCCM_IconWin_DragEnter
NAME
SCCM_IconWin_DrawIcon
SYNOPSIS
ULONG Result = DoMethod(obj,SCCM_IconWin_DrawIcon,Object *IconObject);
FUNCTION
Draws (IconObject) in window by invoking IDTM_Draw method with icon
INPUTS
IconObject - Icon to be drawn
RESULT
Result - result from IDTM_Draw
SEE ALSO
NAME
SCCM_IconWin_GetDefIcon
SYNOPSIS
Object *icon = DoMethod(obj,SCCM_IconWin_GetDefIcon,CONST_STRPTR Name,
LONG Type,ULONG Protection);
FUNCTION
Tries to get a default icon for the specified file. Calls
iconobject.library/GetDefIconObject and returns result.
INPUTS
Name - file name
Type - file type (fib_DirEntryType from FileInfoBlock)
Protection - file protection (fib_Protection from FileInfoBlock)
RESULT
icon - default Icon IconObject
SEE ALSO
iconobject.library/GetDefIconObject
NAME
SCCM_IconWin_GetIconFileType
SYNOPSIS
Object *icon = DoMethod(obj,SCCM_IconWin_GetIconFileType,
struct ScaIconNode *icon);
FUNCTION
Identifies object for icon, find the appropriate filetype
and setup the in_FileType member of ScaIconNode.
INPUTS
icon - icon to find filetype for.
RESULT
icon - default Icon IconObject
SEE ALSO
iconobject.library/GetDefIconObject
NAME
SCCM_IconWin_History_Back
SYNOPSIS
Object *icon = DoMethod(obj,SCCM_IconWin_History_Back);
FUNCTION
Move one step backwards in the history of the window contents,
and switch to display the contents of the path from the history
using the current view mode.
Does nothing if the current view is already the oldest one
in the window history.
INPUTS
None.
RESULT
None.
SEE ALSO
SCCM_IconWin_History_Forward
NAME
SCCM_IconWin_History_Forward
SYNOPSIS
Object *icon = DoMethod(obj,SCCM_IconWin_History_Forward);
FUNCTION
Move one step forward in the history of the window contents,
and switch to display the contents of the path from the history
using the current view mode.
Does nothing if the current view is already the most recent one
in the window history.
INPUTS
None.
RESULT
None.
SEE ALSO
SCCM_IconWin_History_Back
NAME
SCCM_IconWin_ImmediateCheckUpdate
SYNOPSIS
Object *icon = DoMethod(obj,SCCM_IconWin_ImmediateCheckUpdate);
FUNCTION
Scan directory associated to this window and check for any changes
between the display and the disk contents. If any changes are found,
icons are added, removed, or replaced as necessary.
INPUTS
None
SEE ALSO
SCCM_IconWin_ScheduleUpdate
NAME
SCCM_IconWin_LayoutIcon
SYNOPSIS
ULONG Result = DoMethod(obj,SCCM_IconWin_LayoutIcon,Object *IconObject,
ULONG LayoutFlags);
FUNCTION
Prepares an IconObject to be rendered.
INPUTS
IconObject - icon to be layouted
LayoutFlags
IOLAYOUTB_NormalImage // Layout normal Image
IOLAYOUTB_SelectedImage // Layout selected Image
RESULT
Result - result from IDTM_Layout
SEE ALSO
NAME
SCCM_IconWin_MakeWBArg
SYNOPSIS
ULONG Count = DoMethod(obj,SCCM_IconWin_MakeWBArg,
struct ScaIconNode *icon, struct WBArg *Buffer);
FUNCTION
Fill a WBArg structure (wa_Lock and wa_Name) from the given icon or
from the window.
INPUTS
icon - icon to make WBArg from
if icon = NULL, return WBArg with wa_Lock = copy of
window lock and wa_Name = NULL
Buffer - Result buffer with at least enough room for one WBArg.
RESULT
Count - number of successfully created WBArg's in (Buffer)
SEE ALSO
SCCM_IconWin_CountWBArg
NAME
SCCM_IconWin_MenuCommand
SYNOPSIS
void DoMethod(obj,SCCM_IconWin_MenuCommand,CONST_STRPTR CmdName,
struct ScaIconNode *icon, BOOL state);
FUNCTION
INPUTS
CmdName - command name
icon - icon to apply command to
state - ?
RESULT
nothing
SEE ALSO
NAME
SCCM_IconWin_NewPath
SYNOPSIS
void DoMethod(obj,SCCM_IconWin_NewPath,CONST_STRPTR path,ULONG tags,...);
FUNCTION
Change contents in existing window to display the given new path.
INPUTS
path - command name
tags - tag list. Supported tags are:
SCA_ShowAllMode - one of the workbench DDFLAGS_* values.
SCA_ViewModes - one of the workbench DDVM_BY* values
SCA_XOffset - (LONG) Window X offset
SCA_YOffset - (LONG) Window Y offset
SCA_IconList - (struct ScaIconNode *) pregenerated icon list
RESULT
Success - FALSE on failure, TRUE to indiciate success.
SEE ALSO
scalosAPI/SM_NewWindowPath
NAME
SCCM_IconWin_NewPatternNumber
SYNOPSIS
void DoMethod(obj,SCCM_IconWin_NewPatternNumber,ULONG NewPatternNumber);
FUNCTION
INPUTS
NewPatternNumber - Instruct Scalos to use a new background for the
current icon window. Special constant can be specified to
use one of the predefined default patterns:
PATTERNNR_WorkbenchDefault use default Workbench
window background.
PATTERNNR_IconWindowDefault use default icon window
background pattern.
PATTERNNR_TextWindowDefault use default text window
pattern.
RESULT
nothing
SEE ALSO
NAME
SCCM_IconWin_NewViewMode
SYNOPSIS
Object *WindowObj = DoMethod(obj,SCCM_IconWin_NewViewMode,
ULONG ViewMode);
FUNCTION
changes window view mode from text to icon and vice versa.
INPUTS
ViewMode - new window view mode
RESULT
WindowObj - IconWindow.sca subclass object if window class
changes from text to icon or vice versa
NULL if window class is not changed.
SEE ALSO
NAME
SCCM_IconWin_Open
SYNOPSIS
BOOL Success = DoMethod(obj, SCCM_IconWin_Open, struct ScaIconNode *icon, ULONG Flags);
FUNCTION
perform "open" function on (icon)
INPUTS
icon - icon to open
Flags - ICONWINOPENF_IgnoreFileTypes -- always OPEN icon, ignore
file type settings.
ICONWINOPENF_NewWindow -- open drawers in new window, regardless
of browser mode.
RESULT
Success - TRUE if new window could be opened
FALSE if anything went wrong
SEE ALSO
NAME
SCCM_IconWin_RawKey
SYNOPSIS
void DoMethod(obj,SCCM_IconWin_RawKey,struct IntuiMessage *iMsg);
FUNCTION
Processes Intuition IDCMP_RAWKEY events.
INPUTS
iMsg - IntuiMessage
RESULT
nothing
SEE ALSO
NAME
SCCM_IconWin_ReadIcon
SYNOPSIS
struct ScaIconNode *icon = DoMethod(obj,SCCM_IconWin_ReadIcon,
CONST_STRPTR name, struct ScaReadIconArg *ria);
FUNCTION
Read one icon, add it to the window icon list, and display it.
If an icon with the same name already exists it is replaced.
If no icon could be created, i.e. because the file system
object is no longer present, any existing icon is removed
from the window.
The intended use of this method is to update icon window after
change in file system, i.e. add file, remove file, or change file.
INPUTS
name - name of the icon
ria - pointer to struct ScaReadIconArg with information about x/y icon
position, and optional Lock on parent directory.
ria may be NULL.
RESULT
icon - newly created ScaIconNode or NULL if something went wrong.
SEE ALSO
NAME
SCCM_IconWin_ReadIconList
SYNOPSIS
BOOL Error = DoMethod(obj,SCCM_IconWin_ReadIconList,ULONG flags);
FUNCTION
Read all icons in directory into window.
INPUTS
flags - SCCV_IconWin_ReadIconList_ShowAll = show all files
RESULT
Error - non-zero value if anything went wrong
SEE ALSO
NAME
SCCM_IconWin_Redraw
SYNOPSIS
void DoMethod(obj,SCCM_IconWin_Redraw,ULONG flags);
FUNCTION
redraws window
INPUTS
flags
REDRAWB_DontEraseWindow : don't erase window before redraw
REDRAWB_ReLayoutIcons : relayout icons
REDRAWB_DontRefreshWindowFrame : do not refresh window frame
RESULT
nothing
SEE ALSO
NAME
SCCM_IconWin_RemIcon
SYNOPSIS
void DoMethod(obj,SCCM_IconWin_RemIcon,BPTR Lock, CONSTR_STRPTR Name);
FUNCTION
Remove specified icon from window
INPUTS
Lock - Lock on icon directory
Name - Name of icon to remove
RESULT
nothing
SEE ALSO
NAME
SCCM_IconWin_RemFromControlBar
SYNOPSIS
DoMethod(obj,SCCM_IconWin_RemFromControlBar,struct Gadget *g);
FUNCTION
Remove specified Gadget from window control bar, and disposes it.
INPUTS
g - Gadget to remove from control bar
SEE ALSO
SCCM_IconWin_AddToControlBar
NAME
SCCM_IconWin_RemFromStatusBar
SYNOPSIS
DoMethod(obj,SCCM_IconWin_RemFromStatusBar,struct Gadget *g);
FUNCTION
Remove specified Gadget from window status bar, and disposes it.
INPUTS
g - Gadget to remove from status bar
SEE ALSO
SCCM_IconWin_AddToStatusBar
NAME
SCCM_IconWin_SetVirtSize
SYNOPSIS
void DoMethod(obj,SCCM_IconWin_SetVirtSize,ULONG Flags);
FUNCTION
Calculate bounding rectangle of all icons in window and optionally
adjust window scrollers accordingly.
INPUTS
Flags
SETVIRTF_AdjustRightSlider = adjust right (vertical) slider
SETVIRTF_AdjustBottomSlider = set bottom (horizontal) slider
RESULT
nothing
SEE ALSO
NAME
SCCM_IconWin_ShowIconToolTip
SYNOPSIS
void DoMethod(obj,SCCM_IconWin_ShowGadgetToolTip, ULONG gadgetID);
FUNCTION
Display tool tip window for (gadgetID).
INPUTS
gadgetID - GadgetID of gadget to display tool tip for.
RESULT
nothing
SEE ALSO
NAME
SCCM_IconWin_ShowIconToolTip
SYNOPSIS
void DoMethod(obj,SCCM_IconWin_ShowIconToolTip,
struct ScaIconNode *icon);
FUNCTION
Display icon tool tip window for (icon).
INPUTS
icon - icon to display tool tip for.
RESULT
nothing
SEE ALSO
NAME
SCCM_IconWin_Sleep
SYNOPSIS
void DoMethod(obj,SCCM_IconWin_Sleep);
FUNCTION
Iconify window and add AppIcon to Workbench.
INPUTS
none
RESULT
nothing
SEE ALSO
NAME
SCCM_IconWin_StartNotify
SYNOPSIS
void DoMethod(obj,SCCM_IconWin_StartNotify);
FUNCTION
Cancel any existing drawer notification for this window,
and install a new notification.
INPUTS
none
RESULT
Success - TRUE if notification successfully started, FALSE on failure.
SEE ALSO
NAME
SCCM_IconWin_Update
SYNOPSIS
DoMethod(obj,SCCM_IconWin_Update);
FUNCTION
Re-read all icons into window and redraw window.
INPUTS
none
RESULT
?
SEE ALSO
NAME
SCCM_IconWin_UpdateIcon
SYNOPSIS
DoMethod(obj,SCCM_IconWin_UpdateIcon,BPTR Lock,CONST_STRPTR Name);
FUNCTION
Update and redisplay icon.
INPUTS
Lock - Lock to icon directory
Name - name of icon
RESULT
?
SEE ALSO
NAME
SCCM_IconWin_UpdateControlBar
SYNOPSIS
DoMethod(obj,SCCM_IconWin_UpdateControlBar,struct Gadget *g,ULONG Tags,...);
FUNCTION
Update window control bar member gadget. Applies OM_SET method with
the supplied taglist to member gadget.
INPUTS
g - Control bar member gadget to update
Tags - Taglist
SEE ALSO
NAME
SCCM_IconWin_UpdateStatusBar
SYNOPSIS
DoMethod(obj,SCCM_IconWin_UpdateStatusBar,struct Gadget *g,ULONG Tags,...);
FUNCTION
Update window status bar member gadget. Applies OM_SET method with
the supplied taglist to member gadget.
INPUTS
g - Status bar member gadget to update
Tags - Taglist
SEE ALSO
NAME
SCCM_IconWin_WakeUp
SYNOPSIS
void DoMethod(obj,SCCM_IconWin_WakeUp,ULONG ReLayout);
FUNCTION
Uniconify and open iconified window.
INPUTS
ReLayout - TRUE if all icons of the window should be relayouted
RESULT
nothing
SEE ALSO
NAME
SCCM_IconWin_ShowPopupMenu
SYNOPSIS
void DoMethod(obj,SCCM_IconWin_ShowPopupMenu,
struct PopupMenu *pm, struct ScaIconNode *in,
ULONG Flags, struct FileTypeDef *fType);
FUNCTION
Show a popup menu and execute the user's menu command.
INPUTS
pm - Popup menu to display.
in - Scalos icon node the popup menu should be associated to.
Can be NULL for window popup menus.
Flags - Show which items are still locked and HAVE TO BE UNLOCKED
during processing.
SHOWPOPUPFLGF_IconSemaLocked - wt_IconSemaphore is still locked
SHOWPOPUPFLGF_WinListLocked - Scalos window list is still locked.
fType - Private data structure for support of file type specific
popup menus. Should be NULL if unused.
RESULT
nothing
SEE ALSO
textwindow
[edit | edit source]--background SCCM_TextWin_BeginUpdate SCCM_TextWin_DrawColumnHeaders SCCM_TextWin_EndUpdate SCCM_TextWin_InsertIcon SCCM_TextWin_ReAdjust
NAME
--background
DESCRIPTION
This class implements the text-only Scalos windows. Most
functionality is derived from IconWindow.sca but there are
some special methods described below.
NAME
SCCM_TextWin_BeginUpdate
SYNOPSIS
DoMethod(obj,SCCM_TextWin_BeginUpdate);
FUNCTION
hold all visible updates until SCCM_TextWin_EndUpdate
INPUTS
none
RESULT
nothing
SEE ALSO
SCCM_TextWin_EndUpdate
NAME
SCCM_TextWin_DrawColumnHeaders
SYNOPSIS
DoMethod(obj,SCCM_TextWin_DrawColumnHeaders);
FUNCTION
Redraws text window column headers.
INPUTS
nothing
RESULT
nothing
SEE ALSO
NAME
SCCM_TextWin_EndUpdate
SYNOPSIS
DoMethod(obj,SCCM_TextWin_EndUpdate,ULONG RefreshFlag);
FUNCTION
Unlock window updates and optionally rebuild window contents.
INPUTS
RefreshFlag - if TRUE,
forces window to perform SCCM_TextWin_ReAdjust.
RESULT
nothing
SEE ALSO
SCCM_TextWin_BeginUpdate
NAME
SCCM_TextWin_InsertIcon
SYNOPSIS
DoMethod(obj,SCCM_TextWin_InsertIcon,struct ScaIconNode *in);
FUNCTION
The ScaIconNode is inserted into the text window icon list,
according to the current sorting order.
If an icon with the same name already exists, it is replaced.
INPUTS
in - ScaIconNode which is to inserted into the
sorted icon list if the text window.
RESULT
nothing
NAME
SCCM_TextWin_ReAdjust
SYNOPSIS
void DoMethod(obj,SCCM_TextWin_ReAdjust);
FUNCTION
Rebuilds text window. Entries are re-sorted, all column headers
and text gadgets are redrawn and the scrollers are adjusted.
INPUTS
none
RESULT
nothing
SEE ALSO
title
[edit | edit source]--background SCCM_Title_Generate SCCM_Title_Query SCCM_Title_QueryTitle SCCM_Title_Translate
NAME
--background
DESCRIPTION
This class implements the screen title and window title functionality.
TAGS
SCCA_Title_Format (CONST_STRPTR) -- Format string for the title.
This string is processed, replacing all the "%" variables
with their values.
Standard title variables:
"%os" Kickstart release (e.g. "3.1")
"%wb" Scalos release (e.g. "1.3")
"%ov" Kickstart version (e.g. "40.68")
"%wv" Scalos version (e.g. "40.6")
"%fc" * Free chip RAM in bytes
"%ff" * Free fast RAM in bytes
"%ft" * Total free RAM in bytes
"%pa" Window's path
"%df" * Free disk space in bytes
"%DF" Free disk space, displayed in GBytes/MBytes/KBytes
"%du" * Used disk space in bytes
"%DU" Used disk space, displayed in GBytes/MBytes/KBytes
"%d(" start: don't show if no disk inserted
"%d)" stop: don't show if no disk inserted
"%dp" percentage of disk space used
"%cs" Chip set
"%cp" Processor
"%pr" CoProzessor
"%nt" number of tasks
"%nl" number of libraries
"%np" number of message ports
"%nd" number of devices
"%ns" number of screens
Variables marked with "*" may optionally immediately be followed
by a scaling modifier "0" .. "6" :
0 Values is displayed in bytes.
1 Values is displayed in KBytes.
2 Values is displayed in MBytes.
3 Values is displayed in GBytes.
4 Values is displayed in TBytes.
5 Values is displayed in PBytes.
6 Values is displayed in HBytes.
Applicability is (IS).
SCCA_Title_Type (ULONG) -- type of title
SCCV_Title_Type_Screen -- Screen title (default)
SCCV_Title_Type_Window -- Window title
Applicability is (I).
NAME
SCCM_Title_Generate
SYNOPSIS
STRPTR GeneratedTitle = DoMethod(obj,SCCM_Title_Generate);
FUNCTION
Parses internal TitleFormat string and generates ready-to-use title
text in internal buffer.
INPUTS
-
RESULT
GeneratedTitle - String pointer to generated title
SEE ALSO
NAME
SCCM_Title_Query
SYNOPSIS
BOOL NeedRefresh = DoMethod(obj,SCCM_Title_Query, UWORD ParseID);
FUNCTION
Check whether variable text has changed and needs to be refreshed.
INPUTS
ParseID - contains the two-character variable name, e.g. "os"
RESULT
NeedRefresh - non-zero value if title string has changed, i.e.
needs to be refreshed.
SEE ALSO
NAME
SCCM_Title_QueryTitle
SYNOPSIS
BOOL NeedRefresh = DoMethod(obj,SCCM_Title_QueryTitle);
FUNCTION
Check whether title has changed and needs to bed refreshed.
INPUTS
-
RESULT
NeedRefresh - non-zero value if title string has changed, i.e.
needs to be refreshed.
SEE ALSO
NAME
SCCM_Title_Translate
SYNOPSIS
BOOL Success = DoMethod(obj,SCCM_Title_Translate, STRPTR Buffer,
CONST_STRPTR TitleFormat, UWORD ParseID, UWORD Length);
FUNCTION
Processes one title format variable and generates expanded text
into buffer provided by caller.
INPUTS
Buffer - Pointer to a buffer where the expanded text will be stored.
This pointer gets updated during method execution !!
TitleFormat - pointer into title format string, immediately after the
variable name.
This pointer gets updated during method execution !!
ParseID - contains the two-character variable name, e.g. "os"
Length - The number of bytes that fit into Buffer. Beware of writing
more than (Length) Bytes into Buffer!
RESULT
Success - a non-zero value indicates translation was successful.
a zero value signals some kind of error (e.g. unknown
ParseID or insufficient Length).
SEE ALSO
preferences.library
[edit | edit source]iconobject.library
[edit | edit source]iconobject.datatype
[edit | edit source]A technical overview of AROS
[edit | edit source]History
[edit | edit source]Additions/changes:
40.32 20040917 JL - Bugfix: simple-refresh window redraw failed when
issueing some menu commands, e.g. "open parent".
20040908 JL - Bugfix: renaming left-out icons sometimes caused random
memory to be trashed. fixed.
- Bugfix: renaming left-out icons caused Scalos processes
to hang due to semaphore deadlocks.
- Bugfix: cured semaphore deadlock that sometimes occured
when automatic window update collided with some user
action, e.g. opening a popup menu.
20040828 JL - Bugfix: with TrueType fonts, having one softlink in a
text window caused all entries to be displayed underlined.
- Added new internal commands "iconproperties" and
"windowproperties" (Requires iconproperties.module
and windowproperties.nodule).
- Bugfix: drag&drop left garbage on screen if custom bob
routines were used and "special" bob (e.g. "forbidden"
or "copying") was visible and was larger than main bob.
20040716 JL - Added new qualifier during D&D to force moving of
file system objects (instead of copying).
- Implemented the long-planned "Create link" on D&D feature.
- Bugfix: default icons were not shown transparent if
D&D "real transparency" wasn't turned on.
20040625 JL - When copying icons, the "replace all", "skip all",
and "abort" buttons of the overwrite request didn't work.
20040612 JL - Automatic update of windows caused enforcer hit and
crashes if the modified files containes special
pattern-matching characters in their names (e.g. "()[]#?|").
20040602 JL - Fixed long-standing bug that caused Scalos to lockup
when an icon was selected while a new window was
initially reading its icons.
- About dialog sometimes opened with maximum screen width,
but without any contents in the scrolling field. Fixed.
20040527 JL - Closing an icon window while it was initially reading
its directory caused Enforcer hits and crashed
Scalos. Fixed.
20040523 JL - Added TrueType font support. TT Fonts can be used for
icons, text windows, tooltips, and the "About" window.
20040519 JL - Menu selection "leave out" (not from popup menu)
caused enforcer hits when issued from "View all"
text window. Fixed.
20040425 JL - Added CRC checks over prefs files. Now writing
a prefs file only causes re-reading of prefs and
reinitialization if file contents has actually changed.
20040424 JL - Disk Read-Only status display is now updated when
disk is inserted.
20040419 JL - Icons without associated object were displayed
incorrectly after window update. Fixed.
- Bumped revision to 40.32.
40.31 20040322 JL - Default icons were not recognized on main window. This
bug could show up after dragging default icons from
some drawer window onto the desktop.
20040221 JL - Improved caching of filetype descriptors. With "env-handler",
all filetypes were flushed from cache whenever a new
filetype was loaded from ENVARC: to ENV:.
20040216 JL - Internal command "reset" didn't work correctly. Fixed.
20040214 JL - Icons were not updated correctly after change of file
comment of rename with change of case
only (e.g. "amiga" to "Amiga").
20040211 JL - Icon selection marks for popup menu could be drawn in
incorrect window when "Apply to every selected icon"
is enabled.
- Fixed various problems with left-out icons (different
icons with same name were not handled correctly,
left-out icons were not updated as intended).
20040210 JL - "Mac-like selection" was broken. Fixed.
20040206 JL - "Snapshot window" didn't work if there was no
icon present for window.
20040126 JL - Main window didn't allow multiple icons with same
name (e.g. left-out icons from different paths). Fixed.
- Bumped revision to 40.31.
40.30 20040123 JL - In "view all" text windows, "Leave out" icon "xxx" now
removes both "xxx" and "xxx.info" from text window, and
"Put away" causes both entries to reappear.
- Now text window SCCM_IconWin_ReadIcon method correctly
handles increase in column width.
- All "cleanup**" menu commands are now disabled
in text windows.
- Fixed enable/disable state of "leave out" and "put away"
menu commands for "view all" text windows.
- "selectall" menu command is now disabled if
all icons are selected.
- "clearselection" menu command is now disabled if no
icon is selected.
20040122 JL - Text windows now automatically update object associated
entries if an icon is removed or added.
20040118 JL - Fixed internal locking during reading and parsing
of Scalos filetypes descriptions.
- AppIcons no longer can get "Default Icon" attribute.
20040111 JL - Default icons may be drawn with adjustable
degree of transparency.
- Added support for MorphOS-style iconify gadgets. This
fixed any visual distortion of iconify Gadgets under MorphOS.
20040109 JL - When loading default icons, Scalos now adds information
about the original object (Path+Name) for usage by
the iconobject datatypes.
20040105 JL - Made icon dd_Flags handling more flexible, so OS3.9 CD
drawers open with correct viewmodes (WB handles
invalid values of "3" like DDFLAGS_SHOWALL).
- Scalos didn't handle default icons from icon drawer
(e.g. def_drawer.info) correctly. Without separate
DefIcons installed, only the icon.library built-in
icons were used.
20040104 JL - Added "skip all" gadget to standard copy/move
"replace" dialog.
- Fixed enforcer hits/crashes when starting Scalos
while Scalos is already running.
- Added new ScalosControlA() tags
SCALOSCTRLA_GetCopyBuffSize and
SCALOSCTRLA_SetCopyBuffSize.
20040101 JL - Added preferences item to set default stack size.
- FileTypes code assumed that popupmenu.library was open,
leading to crashes on machines where that library was
not installed.
- Bumped revision to 40.30.
40.29 20031230 JL - Added full support for alpha channel icon drawing,
including drag&drop ("Custom" bob routines only).
- Memory for default action in filetype descriptions was
freed while not in use. Fixed.
- Filetype descriptions are now cached, in order to
improve performance.
- Starting WB programs left 2 locks dangling. Fixed.
20031226 JL - updated "%os" title function to recognize OS 3.5
and OS 3.9.
- Made localizable string for "BUSY" disks.
- Popupmenu items now show default action (the action
that is taken upon double-click) in bold text.
20031222 JL - Optimization of Drag-and-Drop bobs was broken, leading
to very sluggish drawing of bobs when dragging
multiple icons.
20031208 JL - Changed directory for Scalos filetype descriptors
from "Scalos:FileTypes/" to "ENV:Scalos/FileTypes/". For
compatibility, Scalos still looks in the old place if the
new directory cannot be found.
20031202 JL - In Text window, icon update erroneously changed type
from "WBGARBAGE" to "WBDRAWER".
20031117 JL - Fixed incorrect update of icons in text windows
in "view all" mode.
20030727 JL - To provide a visual hint that popup menu commands only
apply to the icon under the pointer, all other selected
icons are temporarily deselected while the popup menu
is open.
- Added keyboard qualifier to apply popup menu commands to
every selected icon, instead of only the icon under
the mouse pointer.
20030711 JL - Fixed long delay upon startup when splash window was
turned off.
- Bugfix: selecting an icon in one window, then changing
to another window, and hitting "enter" caused Scalos
to crash with "invalid semaphore state" errors.
20030628 JL - Fixed several memory leaks associated with
filetype-dependent popup menus and tooltips.
20030618 JL - In Window popup menus, "view by text/name" never
displayed a checkmark.
20030616 JL - Drawers opened from text view windows did not correctly
inherit the "view all" attribute.
- Corrected minor typo in About window "100%" was lacking
the percent sign.
20030615 JL - Bumped revision to 40.29.
40.28 20030612 JL - Major improvement in text view window update - now works
the same way as icon window update, only the changed
items are redrawn.
20030531 JL - Bugfix; In text view windows, it was erronously
possible to "snapshot" and "unsnapshot" icons.
20030529 JL - Bugfix: In text view windows, no file comments
were displayed.
20030525 JL - In text view windows, Scalos had problems recognizing
default tool entries for project icons. Fixed.
20030517 JL - Text icon IDTA_Type returned wrong icon type
for WBGARBAGE (Trashcan) icons.
20030502 JL - Major improvements to SCA_OpenIconWindow(). Now Scalos
tries hard to find the appropriate icon for the window
to be opened. If an icon is to be found, the window
settings are taken from the icon.
20030423 JL - Text windows didn't recognize window resize events
during reading of icons. Fixed.
20030421 JL - Rewrote context-sensitive disabling of menu items.
20030420 JL - Added requester to ask user what to do when a project
icon without default tool is encountered.
- Added Polish catalog to developer archive, translation
by Paweî Szczodry.
20030418 JL - Fixed file count routine in filetransclass. The bug
caused incorrect calculation of total byte/item count
and lead to display of more than 100% completion with
nonsense values for "remaining time".
- Removed display of every single item copied in
filetrans copy/move requester. This optimization greatly
improved copying speed.
20030327 JL - Added new method "SCCM_FileTrans_OverwriteRequest"
for FileTrans.sca class.
20030301 JL - Bugfix: Filetype wasn't set correctly for trashcan.
- Bugfix: AsyncWB hook wasn't called correctly
for "Empty Trashcan".
20030218 JL - Bugfix: Program name wasn't handed over to
execute_command.module on icon double-click.
20030216 JL - Bugfix: Improved window clipping, now application-drawn
AppIcons no longer draw across non-backdrop Workbench
window border.
20030211 JL - Bugfix: When a drawer window was created in iconified
state, it could not be uniconified by double-clicking
its parent drawer.
20030208 JL - Bugfix: In 40.27, WBStartup execution of ARexx type
icons was broken. Fixed.
- Feature: Added display of estimated remaining
time to file copy/move progress dialog.
- Bumped revision to 40.28.
40.27 20030130 JL - Bugfix: Window backfill pattern re-layout didn't occur
when "backdrop" was turned on and off.
20030129 JL - Bugfix: fixed enforcer hits/crashes during window
zoom/resize when "always relayout" was enabled (code
tried to use ptn_bitmap after FreeBitMap()).
20030126 JL - Bugfix: added locking mechanism for asynchronous
backfill to avoid crashes when windows are closed while
async backfill process hasn't finished.
20030118 JL - Bugfix: fixed enforcer hits when CLI project icon
contained no default tool.
- Improvement: Program list now contains full path for
each program started instead of only program name.
- New feature: Added SCA_ScalosControl() subcommand to
get/free list of menu commands.
20030111 JL - Bugfix: Cut+Paste didn't work when AsyncWB was
installed. Fixed.
- New features: Added new FONT and VALIGN attributes
to TOOLTIP STRING.
- Bumped revision to 40.27.
40.26 20030104 JL - Bugfix: "about" produced 2 enforcer hits when no
Scalos logo found.
- Bugfix: Splash resizing / text positioning was broken
when no Scalos logo was found.
- Bugfix: window process hung when one of the standard
modules could not be started.
20030103 JL - Bugfix: Snapshotting a window which had no icon created
an ".info" instead of an icon with the drawer's name.
- Bugfix: Windows with virtual width or height > 32768
could produce problems from graphical screen
corruption to system crash.
20030102 JL - New feature: Icon tooltips can now be user-defined in
the file type description files. Scalos now supports
file type information plugins, e.g. to display size
information about image files.
20021221 JL - Bugfix: During file copy operations, icons could be
overwritten without warning.
20021209 JL - Bugfix: TextInputHook wasn't used to run program
without icon - instead always execute_command.module
was called.
- Bugfix: automatic disabling didn't work for some
main menu items (e.g. "sizetofit" didn't get disabled
in backdrop root window).
- Bumped revision to 40.26.
40.25 20021206 JL - Added "viewbytype", "cleanupbyname", "cleanupbydate",
"cleanupbysize", and "cleanupbytype" menu commands.
20021205 JL - Fixed Enforcer hits which occured when an ARexx program
ended that had been started from an icon window, and
the icon window had been closed.
20021130 JL - Added support for cyling through icons in window
via TAB key.
- Rebuilt about window code to make use of the
TT layout engine.
- Fixed bug in SCA_SortNode() - lists with less than
3 entries were not sorted.
20021116 JL - Fixed broken close-window abort recognition during
GenerateIcons() icon drawing in window.
20021019 JL - The user-defined path for default icons was never
used for iconified Scalos window icons. Now it is taken
as fall-back if there are no theme-specific icons.
20021018 JL - Changed sizing method for splash window.
20021014 JL - Added new methods SCCM_AddToClipboard and
SCCM_ClearClipboard to root class.
20021013 JL - Copy/paste didn't work for volumes/disks. Fixed.
- Fixed another source for erroneous error messages
during SCCM_FileTrans_Copy and SCCM_FileTrans_Move
operations.
20021009 JL - Changes in icon font were not recognized in desktop
window. Fixed.
- The menu "copy" and "paste" commands trashed the
destination file name. Fixed.
20021008 JL - Fixed some enforcer hits and crashed when selecting
some device icons, and then pressing "enter" twice.
20021006 JL - Changed location of icons for iconified Scalos window
from "ENV:Sys/def_iconify" to "THEME:window/def_iconify".
- LoadWB.scalos now waits until Scalos opens its first
window on the Workbench screen before exiting.
- Now Scalos first tries to load deficons from
"THEME:DefIcons/". If that fails, the standard
path "ENV:Sys/" is used.
20021003 JL - Now uses "titlebarimageclass" for iconify
image if available.
- changed all makefiles to work with GNU make.
- Bumped revision to 40.25.
40.24 20021003 JL - Fixed broken ARexx menu command support.
20021003 JL - Major improvement of Tooltip layout engine.
- Added tooltips for several Scalos gadgets, including
the status bar images.
20020929 JL - Fixed menu bug where every menu item got a hotkey
mark. Now only the menu items which have got hotkeys
are shown with hotkey marks.
- Icon positions were messed up during "cut", "copy"
and "paste" operations. Fixed.
- Changed file name for default device icons from
".info" to "def_.info" in
order to match OS3.9 behaviour.
- Changed file name for default volume icons from
".info" to "def_.info" in
order to match OS3.9 behaviour.
- Added missing SHADOWPEN vertical line to the left
of the window iconify image.
- The assign "THEME:" isn't touched any more if
it exists prior to Scalos startup.
- The assign "Scalos:" is created (pointing to PROGDIR:)
on startup if it doesn't exist.
- Tooltips are no longer displayed if ICandy == 0.
- Bumped revision to 40.24.
40.23 20020928 JL - Improved handling of "cut" icons (shadowed display got
corrupted). Needs iconobject.datatype 40.7 .
20020926 JL - Fixed bug that caused Scalos to crash when an icon
was removed during Drag&Drop (e.g. an AppIcon was
removed by its application).
20020923 JL - Changed default setting for icon frame type from
MF_FRAME_BUTTON to MF_FRAME_NONE.
20020921 JL - Moved special pointer icons ("forbidden", "copying",
"makelink") from ENV:Scalos/ to THEME:PointerIcons/.
20020915 JL - Environment variable "scalos/icandy" is recognized
if set before Scalos startup. ATM, icandy < 2 turns
off splash screen and window status bars.
If not set, "Scalos/icandy" gets set with a default
value of "2".
20020914 JL - Changing "Fullbench" and "Poptitle" now works
on-the-fly and doesn't require rebooting anymore.
- Locale (language) preferences can now be changed
on-the-fly, no reboot required anymore.
20020913 JL - Fixed erronous message "This drawer cannot be opened"
when trying to open a drawer which is already open.
20020831 JL - Icon position now always is set to NO_ICON_POSITION
for default icons loaded via DefIcons.
20020825 JL - Changed default for Workbench "backdrop" to TRUE.
- Changed tool tip placement - now tool tips are displayed
below mouse pointer if space allows.
20020822 JL - Added optional process priority field for filetype
specific popup menu commands.
20020817 JL - Bugfix in FileCommands.c: since ExNext() result
ERROR_NO_MORE_ENTRIES was erronously remembered as
error, an incorrect error reason could be displayed
when a "real" error occured.
- Bumped revision to 40.23.
40.22 20020812 JL - Bugfix with "Show All" windows: icon list was read
before window was opened, leading to problems with
icon layout (invisible icons).
20020803 JL - Fixed problems with file type-specific popup menus
and STACK parameter.
20020801 JL - Finished conversion of Scalos Pattern Prefs
from ASM to C.
20020720 JL - First implementation of new filetype-specific popup
menu system.
- Removed obsoleted scalos.library
function SCA_RemapBitmap().
20020711 JL - CheckMouseIcon() didn't take window borders into
account, i.e. clicking on window border could cause
icon to be selected.
20020703 JL - Text icon font changes now take effect immediately,
Reboot is not required anymore.
20020624 JL - Fixed problem in wbl.c - spawned processes incorrectly
inherited the ConsoleTask pointer.
20020623 JL - Now SCCM_IconWin_Redraw also refreshes window frame
and status bar.
20020622 JL - Added image "THEME:Window/StatusBar/ShowAll" to status
bar, which visualises the "Show All Files" window
setting.
20020612 JL - Fixed bug introduced by optimized pen allocation.
20020601 JL - Improved pen allocation in LockScalosPens() - pens
which are members of dri_Pens are no longer allocated
a second time.
- Upon startup, Scalos should give a warning Requester
if not all defined pens could be allocated.
20020529 dm - Finished converting cleanup code to C.
20020526 JL - Fixed bug in the scalos.library expunge code which was
trying to FreeMem() an incorrect library base pointer
when quitting Scalos.
- When "quit Scalos" is requested, memory is flushed
before checking scalos.library open count, so unused
libraries still resident in memory no longer prevent
Scalos from closing.
- Added optional background image for tooltips
"THEME:TooltipBackground".
- Added optional background image for window status bar
"THEME:Window/StatusBar/Background".
- Added forgotten "PDTA_DestMode, PMODE_V43" in about.c
and GadgetBarImageClass.c. Now the entries for the
Scalos processes in "PicTD" prefs are no longer required.
20020525 JL - Fixed a serious bug in the new C SCA_MoveNode() function
which caused Scalos to crash when trying to "cleanup" a
window which had already been cleaned up.
20020513 JL - Fixed an icon drag bug: When an icon was clicked with LMB
and the mouse button held for several seconds without
moving the icon, a DisplayBeep() was triggered when the
mouse button was released.
20020504 JL - Many minor changes to allow Scalos to cpiled with GCC.
- Replaced handmade CLI startup detaching code by standard
cback.o and detach.o mdoules.
20020414 JL - Corrected error in scalos_lib.sfd - order of parameters
for SCA_WBStartTags() was incorrect.
20020412 JL - When icons were selected purely via keyboard, the
"IconActive" variable was not updated and selected
icons could not be opened by pressing "return".
- When trying to open an disk/drawer icon via wb39/ARexx,
under certain circumstances the Scalos main task could
hang, waiting for a message reply. Fixed.
20020405 JL - When prefEnableSplash was turned off after splash window
has opened, the splash window never closed. Fixed.
- After removing an entry from the hidden device list,
that device used to appear multiple times on the Scalos
screen. Fixed.
20020404 JL - When AppIcon was replaced via AppChange, Scalos tried
to free invalid memory while removing AppIcon. Fixed.
20020403 JL - ScalosMain() was called with seglist in d1 instead of
d0, leading to enforcer hits or crash on exit when
started from workbench via icon double-click.
- Bumped revision to 40.22.
40.21 20020402 JL - Fixed lockup problem when a window opened or closed
during drag/drop operations.
20020329 JL - Fixed problem in scalos library code - Expunge() never
got called.
- Fixed init problem with prefTextModeTextAttr.ta_Name,
after unsuccessful startup, Scalos tried to
FreeVecPooled() static string.
- Added safeguard to AllocVecPooled() and FreeVecPooled()
against being called with MemPool of NULL.
20020309 JL - SCCM_DeviceList_Generate now works fully asynchronous way,
avoiding most sources of hangs connected to weird
file systems.
20020212 JL - Finished converting Scalos startup and shutdown code to C.
20020209 JL - DefIcons support now integrated into Scalos, including
automatic reload of DefIcons.prefs after
external changes. Filetypes.plugin and Deficons.plugin
are now obsolete.
20020204 JL - Programs started by Scalos were never removed from the
internal program list. Fixed.
20020203 JL - Now displays message on screen title when user tries to
double-click a drawer icon without associated directory.
20020202 JL - ToolTip sometimes didn't show used/total/percent
correctly for disk icons. Fixed.
- Bumped revision to 40.21.
40.20 20020201 JL - Dragged icons were corrupted on screens with
interleaved bitmaps. Fixed.
- Dragging icons with text didn't always work, depending
on icon text colour settings. Fixed.
20020127 JL - UnSnapshot function was thoroughly broken - Should now
again work as expected.
20020126 JL - Now supports adding submenus and new menus
via SCA_NewAddAppMenuItem().
- The Rename() patch now tries to update (i.e. remove)
the old object's icon.
- CopyCommand() now quietly returns OK if source of copy
operation cannot be found, so copying of orphan icons
(icons w/o associated objects) should work now.
20020125 JL - Plugged memory leak when reloading menu prefs.
- Bumped revision to 40.20.
40.19 20020121 JL - Snapshot/Unsnapshot didn't free Lock on icons. Fixed.
- Unsnapshot failed to move icon to wt_LateIconList. Fixed.
20020119 JL - ReLayoutIcons() forgot to update IDTA_TextPenShadow and
IDTA_TextPenOutline pens. Fixed.
- SCA_ScreenTitleMsg() was broken and couldn't display
the last message. Fixed.
20020115 JL - Fixed problem in DragDropBobs.c : newiconobject.library
didn't return image mask for special icons because
IDTM_Layout was only called for normal image and
IDTM_Mask_Selected was requested. Fixed.
20020114 JL - Fixed problem with MOS and SameLock() NULL Locks in
Functions.c. Now it should be possible to open SYS:
volume.
- Bumped revision to 40.19.
40.18 20020113 JL - Undid most changes in DragDropBobs.c from 40.17. Now
frames around icons work in a more compatible way,
together with 40.2 icon datatypes.
20020109 JL - Commands "rename", "execute", "newdrawer" now support
global TextInputHook.
20020107 JL - Built .sfd files for all Scalos components. All pragma
and proto includes and .fd files are now created
from those .sfd files.
20020106 JL - Several window backfill functions didn't check properly
for non-existing background images (FileTransfer,
Splash). Fixed.
- INF_File was not set for text icons when file system
returned non-standard fib_DirEntryType. Now INF_File is
always set if fib_DirEntryType < 0.
- The PenArray delivered by the workbench OpenScreen patch
always contained -1 in the first entry, rendering it
pretty useless. Fixed.
- Adapted to now (NDK3.9) officially supported Workbench
hooks (CopyHook, DeleteHook, SetupCleanupHook).
- Now requires includes Release 45.1 to compile.
- "Empty Trash" menu command now uses DeleteHook
if available.
- The PenArray delivered by the workbench OpenScreen patch
always contained -1 in the first entry, rendering it
pretty useless. Fixed.
20020105 JL - When changing icon attributes (e.g. border), AppIcons
didn't get refreshed properly. Fixed.
20020104 JL - Automatic icon update on file system notification didn't
work properly for left-out icons. Fixed.
- Bumped revision to 40.18.
40.17 20020101 JL - Added separate pens for selected icon text, icon text
outline, and icon text shadow.
20011231 JL - Several changes in DragDropBobs.c to enable frames
around masked icons. Requires latest icon datatypes!!!
20011229 JL - Device icons got a name of "" (empty string) when tool
type SCALOS_NOTEXT was found, whereas other
icons got NULL. Fixed.
20011228 JL - When Scalos tries to quit and there were still foreign
windows on WB screen, a retry requester occurs. After
clicking "Retry", Scalos tried to free PenShareMap more
than once. Fixed.
20011225 JL - Non-DOS disk icons are now ghosted (just like WB3.9).
- Many menu items (e.g. "Open", "Information") are now
disabled for non-DOS disks.
- Unreadable disks are now labeled as "DF0:Unreadable"
instead of "DF0:????".
20011221 JL - OpenWorkBench() return ULONG instead of Workbench screen
address in case of success. Fixed.
- Window status bar text now always uses text window font.
20011215 JL - Many changes and fixes in FileCommand.c (File
moving/copying code). Moving objects to a different
volume (copy-and-delete) now works.
20011214 JL - Added timeout (default=10s) to file transfer counting.
- Added Win***s-like "Copy", "Cut", "Paste" menu commands
to transfer files.
20011213 JL - Added workaround kludge for broken "delete.module"
implementations that rely on wa_Name being empty
for directories.
- Fixed a memory trashing bug in CLIStart(). Only occured
when file name was longer than default tool name.
20011212 JL - LeaveOutIcon() trashed the CurrentDir of the Scalos
window task. Fixed.
- Scalos window tasks now have their directory namess
appended to the task name,
e.g. "Scalos_Window_Task ".
- (old) SCA_RemoveAppObject() failed to remove icons in
wt_LateIconList, leading to crashes with MUI
applications on CloseWorkBench()/OpenWorkBench(). Fixed.
- Added new pen for status bar text.
20011208 JL - Popup menus now can also be opened by keyboard
(Right Alt +Right Amiga).
- SCCM_IconWin_CheckUpdate did not recognize changes
between default icon and non-default icon (e.g. an icon
associated to an object was deleted - display didn't
change). Fixed.
- Added optional THEME:FileTransBackground background
image to copy/move progress window.
- Display of window drop marks is now settable into 3
modes - none, non-backdrop windows only, always.
- Added GBTDTA_SoftStyle to set text style
for GadgetBarTextClass gadgets.
- Bumped revision to 40.17.
40.16 20011207 JL - Scalos.c/RefreshTextWindow didn't check if window
exists. Fixed.
- Scalos.c/ReportError didn't propagate RESULT_UserAborted
if the user clicked the "Abort" button. Should
be fixed now.
- Major rewrite of FileTransfer class. Redesigned
copy/move progress window with progress gauge and
cancel button.
20011205 JL - Fixed another bug in window backfilling - filled area
was exactly 1 pixel too small in x- and y-direction.
- With window scrollbar arrows, the detection of shift
key was reversed. Fixed.
- Changed scrolling step for window scrollbar arrows
to 10 pixel.
20011204 JL - Added SCCM_IconWin_AddToStatusBar,
SCCM_IconWin_RemFromStatusBar, and
SCCM_IconWin_UpdateStatusBar methods to make status bar
interfacing easier.
- More changes in OpenWorkBench() / CloseWorkBench(). Now
also uses icon.library V44+ ICONCTRLA_SetGlobalScreen
tag. Closing/reopening Scalos (e.g. via screen mode
change) should now work.
20011203 JL - Rewrote OpenWorkBench() / CloseWorkBench() patches in C.
Problems with wrong colors after OpenWorkBench() should
now be fixed.
20011202 JL - Added support for WB3.9-compatible (undocumented)
CloseWB hook. Now e.g. AmiDock iconifies automagically
on CloseWorkbench() and uniconifies afer OpenWorkBench().
- With status bar enabled, Scalos window heights grew
each time a window was iconified and re-opened. Fixed.
20011201 JL - Fixed broken FreePatternNode() - now reloading pattern
prefs should work again.
- Finally fixed long-standing bug in icon update code
that sometimes lead to duplicate icons.
20011130 JL - Disk without icons now get default icon of type WBDISK
instead of WBKICK.
- Fixed problem with removed nodes in
SCCM_DeviceList_Generate, leading to corrupted device
icon list.
20011129 JL - Added file version information to tooltips.
20011128 JL - Implemented global copy and delete hooks for
compatibility with AsyncWB.
- Fixed inverted NoRemap checking in backfill functions.
20011127 JL - Finished converting all menu functions to C.
20011124 JL - Fixed wrong SCA_FreeNode() parameter
in DevListClass_Generate().
- LockScalosPens() produces lots of enforcer hits when
no palette prefs could be found. Fixed.
20011123 JL - Finished converting all IDCMP handlers to C.
20011120 JL - Completed converting window background rendering
code to C.
20011117 JL - Menu command "backdrop" didn't work. Fixed.
20011116 JL - Fixed missing Argument for WaitReply() in A5. This
resulted in crashes when running modules with simple
refresh windows.
- Bumped revision to 40.16.
40.15 20011113 JL - INF_File was not set for backdrop icons. Fixed.
- Devices are now counted and displayed separately
during D&D.
20011112 JL - Changed screen pop-title algorithm so it should always
get switched on if necessary.
- Changed rendering of Logo in splash window back from
DTM_DRAW to blitting functions.
- Fixed error in DevListClass_Filter() - missing
parentheses lead to wrong exception calculation.
- Bumped revision to 40.15.
40.15 20011112 JL - Changed path for status bar images
to "THEME:Window/StatusBar/".
20011111 JL - Added SCA_NoStatusBar attribute to SCA_OpenWindow()
library function and SCALOS_NOSTATUSBAR tooltype to
suppress status bar display on a single window.
20011110 JL - Fixed most serious error : failed to reserve memory for
IconWindowClass instance data.
20011108 JL - Fixed wrong position for "iconify" gadget (overlapped
zip gadget).
- Horizontal scroller height was too small. Fixed.
- Added special detection of Screen titlebar to circumvent
problem with MagicMenu which lead to screen bar staying
visible in spite of cleared SHOWTITLE flag.
20011107 JL - Added "Typing" symbol to status bar.
- Icon selection by typing icon name didn't work for
AppIcons and device icons. Fixed.
- Removed LockIBase() in Window.c/QueryObjectUnderPointer(),
hopefully avoiding window lockups.
- Converted automatic Screen bar switching code to C (see
Scalos_Cx.c). Added additional checks for locked Layers
to avoid deadlocks.
20011106 DM - Added two new preference variables, prefWindowHScroll and
prefWindowVScroll for the default distances of scrolling
icon windows by the keyboard (main_prefs.s, variables.h,
imports.i, exports.i).
- Added parts of cleanup code converted to C to the source files
(cleanup.c, main_subroutines.s)
- Added two missing includes to scalos_structures.h file
(graphics/gels.h and workbench/startup.h)
- Can use shift+cursor keys in icon windows to scroll by a whole
page (well, inner height and width of icon window - IconWindowClass.c)
- Can also use Return to open active icon in icon windows
(IconWindowClass.c)
- Fixed problem with reading Workbench preferences and then showing
Scalos main window in wrong mode/sizes (WindowClass.c)
20011104 JL - Icon menu didn't get enabled when icon was selected via
keyboard input (first letter(s) of icon name). Fixed.
20011102 JL - Replaced blitting function in Splash.c by DTM_DRAW.
- Fixed old problems with pen allocations - ObtainPen()
didn't check for success.
20011101 JL - Bumped revision to 40.14.
40.13 20011020 JL - During D&D, window dropmarks are no longer erased when
mouse is over icon, but remain visible until mouse
leaves window.
- Added SCALOSCTRLA_GetEmulationMode tag
for ScalosControl().
20011013 JL - Now MenuItems get disabled if they have SubItems and
every SubItem is disabled.
- Since redrawing of partially overlapped icons seems to
work well, I disabled the strict icon overlap checking
while D&D.
20011012 JL - Added support for AppIcons sending select/unselect
notification messages and
WBAPPICONA_NotifySelectState tag.
- CLIStart() didn't work with WBPROJECT icons. Fixed.
20011011 JL - Icon window crashed after D&D when redrawing previously
obscured icons - Fixed.
- Sometimes IDCMP_INTUITICKS messages were not
replied. Fixed.
- Automatic change of default window patterns failed when
switching between icon and text mode. Pattern numbers
sometimes were treated as unsigned instead of signed
numbers. Fixed.
20011010 JL - Added new Tags SCALOSCTRLA_GetTypeRestartTime and
SCALOSCTRLA_SetTypeRestartTime for ScalosControl().
20011008 JL - Menu commands "snapshotwindow" and "snapshotall" stayed
disabled forever. Fixed name compare error
in Prefs.c/CompareCommand().
- Replaced remaining 64bit integer arithmetic code
by C version.
20011007 JL - Finished converting "Title.sca" to C.
- Updated SCA_Title" autodocs for "Title.sca" class.
20011006 JL - Finished converting "FileTransfer.sca" to C.
20011005 JL - Replaced fixed version/revision strings in about window
by text macros "%v" and "%r".
- Added feature: Icons may now be selected by typing the
first character(s) of their names, just as in WB 3.9.
- Added feature: Cursors key can be used to select icon
right/left/below/above the currently selected one.
- Finished converting "DeviceList.SCA" to C.
20011005 JL - Bumped revision to 40.13.
40.12 20011004 JL - When converting WindowClass to C, I somehow dropped one
line of code and forgot to clear a window's UserPort
before closing the window. So it could happen that
IntuiMessages in the wt_IconPort already had got freed
by Intuition on closing the corresponding window,
leading to corrupted messages.
20011001 JL - SCA_WBStart() didn't work for icons with "CLI" or
"REXX" tooltypes. Fixed.
20010930 JL - Wbstartup sometimes skiped icons with free
positions (Unshapshot). Fixed.
20010929 JL - Finished converting Root class to C.
20010928 JL - Now all window, menu and wbl processes inherit the
original workbench path.
20010926 JL - Added support for WBAPPMENUA_CommandKeyString (OS3.9)
and separator bars to SCA_NewAddAppMenuItem().
20010924 JL - Finished converting TextWindow class to C.
20010922 JL - Finished converting IconWindow class to C.
20010916 JL - Finally fixed long-standing problems with simultaneous
multiple window updates (Enforcer hits, icons
appearing twice, etc.).
20010910 JL - Fixed problem reading large directories containing icons with
both fixed and free positions. Icons with "free"
positions were placed at the end of each block read, and
could be overlapped by an icon read later with a fixed position.
20010908 JL - Bumped revision to 40.12.
40.11 20010907 JL - In Icon windows, icons without associated objects were not
displayed with "Show all files" setting. Fixed.
20010906 JL - Text windows now show "Trashcan" in size column for
trashcan drawers.
- Icons of type WBDISK are hidden in text windows with
"Show only icons".
20010904 JL - Major changes in text window directory scanning. Now
icons without associated object are displayed in text
windows with "Show only icons".
20010903 JL - Text windows now show "Drawer" in the size column for drawers.
20010902 JL - Changed number format for file sizes to "%lU", using localized
display format.
- Finished converting window class to C.
- Finished converting text icon class to C.
20010901 JL - Deleting left-out object now always updates ".backdrop" files.
- Left-out icons got the "put away" menu item disabled when
updated (e.g. by adding tooltypes). Fixed.
20010831 JL - Windows can now be scrolled with the arrow keys (only if no
icons are selected in window).
20010830 JL - Did some changes to the asm class macros to make the class
engine more "C-friendly".
20010828 JL - Moved Scalos .catalog files in archive from catalogs//
to catalogs//Scalos/.
- Now .catalog files are ignored if their version is <40, avoiding
trouble with wrong messages.
20010819 JL - Added distinct pens for the dragging info text.
- Additional checks on plugin initialization - Now erroneously
added menu plugins should no longer cause Scalos to crash on startup.
- CloseWorkBench() from VisualPrefs Task didn't work. Fixed.
- CloseWorkBench() will not close Scalos while there are
active "Scalos_Async_Backfill" processes.
- Bumped revision to 40.11.
40.10 20010817 JL - Repaired bug in updateicon which sometimes caused icons to
appear in incorrect windows.
20010815 JL - Duplicating/cloning items now pops up the file copying progress
window.
- Dragging multiple icons now shows one or two text lines under pointer
telling how many files and drawers are being dragged.
- Fixed severe bug in wbl.c : WBNode's were allocated with AllocVecPooled()
and freed with FreeVec().
20010814 JL - Added a varargs version of SCA_ScreenTitleMsg().
- Added flag to switch between Flag: old dragging (all
icons visible) and new "icon stack".
- Added new SCA_ScalosControl() tags
SCALOSCTRLA_GetOldDragIconMode
and SCALOSCTRLA_SetOldDragIconMode.
- IconWinCheckUpdate() now correctly updates INF_DefaultIcon
flag and INF_SupportsLeaveOut attribute.
20010811 JL - Missed a CurrentDir() when renaming objects, leading
to a directory lock getting never UnLock()ed.
- When D&D copying or moving icons, "Replace All" and
"Abort" now should work correctly.
- Message strings "xxx already exists" are now different
when moving and copying objects.
- When moving icons inside window and new position overlaps
other icon, the moved icons now jump back to their
original positions.
- Bumped revision to 40.10.
40.9 20010811 JL - THEME:SplashBackground was never freed, leaving a
Lock on it. Fixed.
- CLI and ARexx default tools icons didn't work
in text windows. fixed.
20010809 JL - Enabled deadlock detection for lasso operations.
20010808 JL - Additional check for NULL wt_LateIconList in cleanup().
- Text windows now again display "#?.info" files (icons).
- Forbid drag-copying or -moving icon into own sibling
window or on sibling icon to avoid move errors
or endless recursion.
20010807 JL - Fixed multiple problems with text window updates.
20010806 JL - Added semaphore locking to protect from two or more Scalos
tasks opening or closing windows at the same time.
- Fixed broken "copy by dragging on drawer icon".
- Added additional checking to prefs file notification.
- Bumped revision to 40.9.
40.8 20010804 JL - Worked around semaphore deadlock in SetIconMenuOnOff(). This
one occured when copying multiple directories between
text windows.
20010803 JL - Copying/moving of (left-out) drawers, tools, or projects
from main window to any drawer window didn't work. Fixed.
- Dragging a device icon into an icon window (copying device
into directory) no longer results in requester "DEVICE:
already exists ....".
- Bug #29 : Dragging a device icon into an icon window where
a drawer with the name of the device (w/o ":") already
existed: Nothing happened. Fixed.
- left-out icons no longer show up in text icon windows.
- "leave out" and "put away" now correctly update text windows.
- Increased size of text window + tooltip date and time fields
from 16 to 80 bytes.
- Added date/time string length checking to ScaFormatDate().
20010802 JL - Fixed a race condition between DrawDrag() and DragEnter() that
could block window when trying to auto-remove icons.
- Finally fixed icon masking problem with PAL Hires-Laced screen. When
"Auto Remove Icons" was turned on, dragged icons left garbage at their
original position until finally dropped.
Problem finally solved without setting friend BitMap to NULL.
20010731 JL - Added preferences selectable pens for ToolTip text and background.
- Due to an incompatibility in Palette.prefs, I renamed it to
"Palette13.prefs" . Scalos uses old "Palette.prefs" if
no "Palette13.prefs" found. To create new prefs file, either
copy old "Palette.prefs" to new "Palette13.prefs" or load
Palette prefs editor and use "Save" button to generate
new "Palette13.prefs".
20010729 JL - Added check for deleting files of an undefined DirEntryType.
- For SoftLinks, ToolTips showed name of link target
instead of link name. Fixed.
- Bumped revision to 40.8.
40.7 20010729 JL - Dropped Popupmenu.library for icon ToolTip display and added
own layouting and rendering code.
20010728 DM + Added check for copying files of a non-specific DirEntryType.
Copies files correctly across Samba network, deleting files
seems to work OK with the current code.
20010728 JL - Moved ToolTip display to separate task.
20010727 DM + Fixed corrupt logo and text in about and splash windows by setting
all allocated bitmaps to have no friend bitmap
20010726 JL - Added AttempLockLayerRom() around icon ToolTip display routine in
order to avoid deadlocks.
20010724 JL - Due to Mike's request, increased minimum window width by 20.
20010723 JL - Added "scalos/icandy" environment variable on startup and set contents to "2".
- Changed every copyright string to "© 1999-2001 The Scalos Team".
- Added "About" function to Menu and Palette preferences.
20010722 JL - Changing palette prefs now closes and reopens Scalos, no matter if
the "DisableCloseWorkbench" flag is set.
20010721 JL - "put away" command didn't work with icons without associated objects. Fixed.
- "Scalos Menu" : added new menu commands "viewbysize" and "viewbydate".
- "Disk.info" icons of type WBDISK will no longer appear inside drawer windows.
- Switching window view mode while window is reading icons no
longer causes window to close.
- SCCM_IconWin_RemIcon now updates window's virtual size and adjusts sliders.
20010720 JL - Bumped revision to 40.7.
40.6 20010718 JL - Double-clicking tool icons in text windows didn't start execute command.
Recognition of default icons in text windows didn't work when
starting programs. Fixed.
20010717 JL - Found a icon masking problem with PAL Hires-Laced screen. When
"auto remove icons" was turned on, dragged icons left garbage at their
original position until finally dropped.
Problem (mask BitMap and icon BitMap having different format,
recognizable by different "BytesPerRow" values for equeal width) at
least partially solved by setting friend BitMap to NULL if (Depth <= 8).
20010716 JL - Empty lines in ".backdrop" files should be ignored now.
- CloseWorkBench() from IPrefs Task didn't work. Fixed.
20010715 JL - Text windows sometimes swallowed first character of file comment. Fixed.
20010713 JL - "Replace All" now works when drag-copying multiple objects.
20010712 JL - "select contents" now deselects all icons in non-selected windows.
- "clear selection" now deselects all icons in all windows.
20010711 JL - Plugin libraries are now flushed on scalos exit.
- Fixed possible problem with missing ScaWindowTask parameter on FreeIconList().
- Bumped revision to 40.6.
40.5 20010708 JL - CheckMouseIcon() didn't work with negative coordinates. Fixed.
- text windows initially opened with do_CurrentX < 0 in icon displayed
icon text at incorrect position. Fixed.
20010707 JL - When reading a directory, icons are no longer checked if they overlap each other.
- converted SCA_OpenIconWindow() to C.
- Bumped revision to 40.5.
40.4 20010706 JL - Enabled "snapshot window" and "snapshot all" for root window again.
20010705 JL - Changed locking in DrawDrag() - first call. When "Auto remove icons" was enabled,
Icons sometimes didn't get ghosted properly due to DRAGFLAGF_WindowLocked set.
- Changed initial value for unused oldDir Locks from NULL to $ffffffff, to avoid
trouble with pr_CurrentDir = NULL (at the end of functions, CurrentDir() never
got reset to initial value when that value was NULL).
- AmigaDos menu commands failed to skip trailing '"' if command name is surrounded
by '"', e.g. "SYS:xyz" executed with '"' as first argument.
20010704 JL - AmigaDos menu commands now inherit the workbench path.
- Bumped revision to 40.4.
40.3 20010704 JL - ReadIcon() didn't respect the "show only icons" setting for text windows, so
all files appeared after automatic window update.
20010703 JL - changed detection for WMFLAG_IsVirtualSize (sizetofit menu command enabling),
now also enabled if window is larger than necessary to hold icons.
20010702 JL - Screen menu items are now enabled/disabled each time
SCCM_IconWin_SetVirtSize is applied (i.e. after any change in window size).
20010630 JL - Forgot to set Flag in ReadTextWindowIconList(),
so all text icons were treated as if on a write-protected disk.
- Bumped revision to 40.3.
40.2 20010629 JL - Fixed more problems run AmigaDOS menu commands without path.
20010628 JL - SnapshotWindow() sometimes wrote icon to wrong directory. Fixed.
- Added wt_UpdateSemaphore locking for "update" command.
- Bumped revision to 40.2.
40.1 20010627 JL - BltMaskBitMapRastPort() used incorrect MinTerm so Masking didn't work
correctly. (e.g. logos in splash and about window on non-cybergraphics screen).
20010626 JL - CheckMouseIcon() didn't work when "Non-masked click area" was checked. Fixed.
- Splash window didn't adjust logo when window was resized due to long message. Fixed.
- ReadDatatypesImage() returned the original BitMap (PDTA_BitMap) instead of
the remapped one (PDTA_DestBitMap).
20010624 JL - Due to extended library functions, bumped version to 40.1.
39.234 20010623 JL - Added SCA_ScalosControl() call to scalos.library. Only 3 tags supported
yet, documentation still missing.
20010620 JL - About and Splash window can may load different logo images
"THEME:ScalosSplashLogo" and "THEME:ScalosAboutLogo". If those
files are not found, both windows fall back to "THEME:ScalosLogo".
20010617 JL - Due to an incompatibility in menu.prefs, I renamed it to
"menu13.prefs" . Scalos uses old "menu.prefs" if no "menu13.prefs" found.
To create new prefs file, either copy old "menu.prefs" to new
"menu13.prefs" or load old "menu.prefs" in menu prefs editor
and use "Save" button to generate new "menu13.prefs".
20010616 JL - Added new popup menu class for AppIcons.
- "System Info" button in About window is disabled if sysinfo module cannot
be found.
- Opening new icon windows in iconified state could lead to each icon
appearing twice after uniconifying window - Fixed. Now wt_LateIconList is
cleared at the beginning of ReadIconList().
20010615 JL - Fixed enforcer hits in about window when no scalos logo could be loaded.
- RunMenuCommand() didn't work with CLI (=AmigaDos) commands without
path, i.e. only filename specified. Fixed.
- Icon tooltips no longer pop up when non-Scalos window is active.
- Icon position for iconified Scalos windows can be specified in
window icon with SCALOS_ICONIFIED_XPOS and SCALOS_ICONIFIED_YPOS.
- Bumped revision to 39.234.
39.233 20010614 JL - AppIcon menu commands now support all WB3.5+ AMCLASSICON_...
AppMessage class codes (e.g. Benchtrash information/snapshot/unsnapshot works).
20010613 JL - Due to common request, Bob functions now don't use chip memory
if port "FBlit" is available.
20010610 JL - AppIcons always got IDTV_TextMode_Normal (no outline, no shadow). Fixed.
20010609 JL - ARexx menu commands now may have selected items as arguments.
- Bumped revision to 39.233.
39.232 20010608 JL - Enabling/disabling popup menus now works correctly with nested sub-menus.
20010607 JL - Scalos now does a "Update all" instead of "Redraw" when
detecting changed main prefs.
20010606 JL - Softlink sometimes could not be copied due to incorrect parent directory - Fixed.
20010605 JL - Fixed nasty bug in AllocVecPooled()/FreeVecPooled() : a6 was overwritten.
- In text windows with "Show only Icons", non-existing objects (i.e. icons
without corresponding objects) are no longer displayed (e.g. "disk").
- Disabled "Leave Out" for default icons.
- Changed locking in TestPopup() to prevent deadlocks.
20010603 JL - Bug #4. Fixed crash when executing ARexx menu command.
20010602 JL - No tooltips are displayed for icon after clicking or double-clicking it.
- Menu command "sizetofit" now also shrinks windows if appropriate.
- Bumped revision to 39.232.
39.231 20010601 JL - Text windows with "Show only Icons" displayed data for icons
instead of objects. Fixed.
- Bug #13. Drawers inside of text windows no longer open always
in text mode, but use the drawer icon settings instead.
20010530 JL - checkmouseicon() and QueryObjectUnderPointer() now take
"Non-masked click area" setting into account.
20010529 JL - Fixed possible race condition with QueryObjectUnderPointer() by
extending window list and wt_IconSemaphore locking.
20010526 JL - AppIcons now have popup menus (currently the same as tool icons)
if is not 0.
- Tooltips now recognize iconified scalos windows.
20010525 JL - Iconified window appIcons get the "WBAPPICONA_SupportsOpen, TRUE" Attribute.
- Fixed error in SCA_NewAddAppIcon() - WBAPPICONA_Supports... tags didn't work.
- Bumped revision to 39.231.
39.230 20010524 JL - No icon tool tips are displayed if icon has tooltype "SCALOS_NOTOOLTIPS".
- Added new menu commands "sizetofit" and "clearselection".
20010523 JL - Scalos now passes a copy of the window lock as wa_Lock and wa_Name=NULL
when no icons are selected (now OS3.9 Find work just as with Workbench).
- Fixed a couple of problems with the new tooltip function.
20010519 JL - Bumped revision to 39.230.
39.229 20010519 JL - Fixed bug in QueryObjectUnderPointer() - did not work correctly if Workbench
screen wasn't frontmost screen.
20010517 JL - Added check for ST_LINKFILE, ST_LINKDIR, ST_SOFTLINK before calling isLink().
- (OLD) After updating left-out (backdrop) icon, updating the associated disk icon
created a new backdrop icon instead of refreshing the old one. Fixed.
20010515 JL - Replaced IDCMP_VANILLAKEY handling by IDCMP_RAWKEY in order to
receive "key up" events.
- Drag&Drag indicators (copy etc.) are now updated immediately when
pressing or releasing qualifier key.
20010512 JL - About window now supports optional background image "THEME:AboutBackground".
20010510 JL - Added support for wheel mouse (icon/text window scrolling).
20010509 JL - Text windows didn't get refreshed properly after deleting icons. Fixed.
20010508 JL - Icon tooltypes sometimes were not recognized correctly. Fixed.
- Bumped revision to 39.229.
39.228 20010507 JL - Changed method of soft link detection to a more system-friendly one.
- Bumped revision to 39.228.
39.227 20010506 JL - Scalos no longer tries to load appchange'd AppIcons when their
name contains invalid characters, i.e. ":/".
- Scalos now uses AddPart() to add the name of the AppIcon to the "Default icons"
path, to make sure there is always a "/" between path and file name.
- Converted WBLtask to C. The "unable to load your tool ..." Request now offers
to select a different tool via ASL requester.
20010504 JL - "Leave Out" didn't work for icons without associated files or drawers. Fixed.
20010501 JL - Icon menu items weren't enabled correctly in text windows. Fixed.
- "View All" wasn't recognized when initially opening text windows. Fixed.
20010430 JL - Softlinks are now displayed with underlined names. This feature
work only with iconobject.datatype 39.33 and later.
(I saw that feature at Workbench 3.9 (with BoingBag 1) and immediately liked it).
20010429 JL - Text windows now distinguish between "Show All Files" and "Show Only Icons".
- Bumped revision to 39.227.
39.226 20010428 JL - Splash window : added 10" timeout when waiting for update message reply.
20010427 JL - AppIcons now support the WBAPPICONA_Supports... tags.
- Icon menu items are now enabled/disabled according to the icons properties,
e.g. for icons on read-only media "delete" and "rename" is disabled.
- Splash window now supports optional background image "THEME:SplashBackground".
20010424 JL - Fixed Enforcer hit in file/directory copying code when
FileTransClassInstance was NULL.
- CopyCommand didn't work with DestName != NULL (to perform
"Copy As" function). Fixed.
- Objects can now get duplicated (cloned) via D&D into same window
with Control key held down.
20010422 JL - Window.c/QueryObjectUnderPointer() could crash if PtrLayer->Window was
empty (NULL). Fixed.
- Path Assign "THEME:" is set on program start to "Scalos:themes/default".
- Bumped revision to 39.226.
39.225 20010421 JL - Fixed enforcer hits/crash opening window popup menu with empty (NULL) ws_Name.
- MoveCommand() no longer complains when trying to move non-existing object.
- Bumped revision to 39.225.
39.224 20010420 JL - Dropped drop zone rendering in separate layers and returned to complement
drawing due to lack of performance.
20010417 JL - Logo gets loaded by datatypes.library from THEME:ScalosLogo
- Defined C names for all library bases.
20010415 JL - Region didn't get freed in class.c/SameWindow() if no icon was moved. Fixed.
- Additional check for NULL window pointer in Scalos.c/LassoInit().
- moving icons in same window with "AutoRemove Icons = Off" didn't work properly
because registers were trashed in main_subroutines.s/checkposition. Fixed.
- Bumped revision to 39.224.
39.223 20010415 JL - Due to Mike's request, bumped revision to 39.223.
222x26 - Removed locking with DragDropSemaphore due to deadlock problems.
- Changed rendering of window/icon drop zones from complement drawing
to separate layers (in Requesters), hopefully eliminating all problems
with garbage left in windows.
20010414 JL - Changed to utilize CatComp and its automatically generated locale header files.
All localized string are now in "Scalos.cd". Tested with CatComp 44.6.
20010413 JL - Bumped version to 222x26.
222x25 20010413 JL - Fixed crash when icon window was closed or iconified while reading icons
and drawer contained more than 20 icons.
20010412 JL - (OLD) Fixed another icon window cleanup bug - icons were incorrectly
positioned under certain conditions so that icon text could overlap
other icons.
20010411 JL - Lasso selection didn't respect window limits when selecting icons. Fixed.
20010410 JL - CLIStart() crashed with type WBTOOL icons. Fixed.
- (OLD) SCA_OpenIconWindow() didn't work with SCA_Iconify tag. Fixed.
20010409 JL - Lasso didn't correctly calculate window left and top offsets. Fixed.
- Popup menus now have two title lines, with the type of object in the
first line and the name of the object in the second one.
20010407 JL - File move and copy routiones rewritten from scratch. Extensive error checking
when moving/copying objects. Requester when trying to overwrite existing
objects while moving/copying.
- Created locking mechanism (via DragDropSemaphore) to prevent window updates
during D&D.
20010404 JL - Renaming left-out icons will no longer lose their position.
20010403 JL - Changed window refresh after file system notify : icon update is held back until
2s after last update request. Fixes lengthy repeated icon window updates after
changing many items (e.g. "Select All", then "UnShapshot").
- Implemented drag threshold, i.e. icons have to be moved more than 4 pixels until
drop zone indicator is drawn.
THE AMOUNT OF 4 PIXELS SHOULD BE MADE USER SELECTABLE IN PREFERENCES.
20010402 JL - When modifying icons, Icons used to disappear if no associated file existed. Fixed.
20010401 JL - Icon just left out did not disappear from desktop when volume (disk) was removed. Fixed.
- Icons could be "left out" multiple times, leaving several lines in ".backdrop". Fixed.
20010331 JL - Fixed bug #25 - D&D didn't copy to drawer icon left out on the desktop.
20010330 JL - Bumped version to 222x25.
222x24 20010329 JL - (OLD) ".backdrop" files are now updated when renaming objects. Fixed bug #22.
20010328 JL - Fixed OLD bug in root_handlemessages - stack could be corrupted if message without
handler routine was encountered. Possibly also fixes long-standing bug #21.
20010327 JL - Text mode windows used to show "#?.info" files when UseExAll was off. Fixed.
20010325 JL - (OLD) Fixed enforcer hits/Alerts with "leave out" and "put away".
- (OLD) Leave out didn't work if .backdrop had a length of 0 bytes. Fixed.
20010325 JL - Bumped version to 222x24.
222x23 20010324 JL - Rename.module, newdrawer.module and delete.module now trigger
window updates on completion.
- On completion of rename.module, objects are checked if they have been renamed
and window names are adjusted if necessary (bug #16 finally wiped out).
20010323 JL - Lasso selection now only affects visible icons (same behaviour as Scalos 2.1d)
20010321 JL - Hopefully fixed multiple text window refresh problems.
- Removed forced D&D source update.
20010320 JL - Window drop box was drawn incorrectly for text windows. Fixed.
- Added new text window methods : SCCM_TextWin_BeginUpdate, SCCM_TextWin_EndUpdate.
- Changed text window method SCCM_IconWin_RemIcon from no-op to working icon removal.
20010319 JL - Fixed serious bug in GetTextIcon_Fib() : Drop on text window icon caused
many enforcer hits.
- D&D onto text icon drawers didn't work. Fixed.
- IconWinCheckUpdate() now also works work text windows.
20010318 JL - Converted text window icon reading code to C.
- Text windows displayed date+time incorrectly : last digit was shown twice. Fixed.
- Text window columns now always are wide enough to show column title
(e.g. empty drawer in text mode only used to show the last column spanning all window width)
- IconActive flag didn't get updated corrected when lasso-selecting icons. Fixed.
- Left mousebutton click toggles icon selection state when shift pressed.
20010317 JL - Bumped version to 222x23.
222x22 20010317 JL - Text mode windows used incorrect font. Inserted missing SetFont() in DrawTextGadgets().
Special indicator bobs were broken with system bob routines. Fixed.
20010317 JL - Bumped version to 222x22.
222x21 20010317 JL - ReadIconList() failed when called from different WindowTask (e.g. activate
Window #1, RMB click Window #2, select "Update" via popup menu). Fixed.
- Icons in backdrop windows could be dragged to overlap each other. Fixed.
- At D&D operations, the first argument (file/drawer) didnþt get freed. Fixed.
20010316 JL - Prefs option "Hide hidden files" now hides files starting with "."
(only in functions converted to C yet).
- Drag/Drop copy/move forces check for update on source.
- Changed D&D special indicator handling:
* special bobs initially added to separate list instead of adding to srgh_boblist
and then moved to special bob list.
* drgh_boblist protected by semaphore to prevent DrawDrag() until InitDrag() finishes.
20010315 JL - Icon drop marks during menu popup didn't get erased properly
in simple-refresh windows. fixed.
20010314 JL - Fixed directory-reading bug with empty file names or files ".info".
- special D&D indicators are now always drawn solid.
20010313 JL - Fixed (self-introduced) Bug in DragDropBobs.c : BlitTrans()
handled masks incorrectly when width was a multiple of 16.
- Bob functions now don't use chip memory if CyberGfxBase is available.
20010312 JL - Squished Bug #17 : Text window column headers no longer flicker
when MMB is held down and mouse is moved.
20010310 JL - Removed layout bug in iconwindow cleanup (icons did overlap).
20010305 JL - Lasso() now always uses Screen->MouseX/MouseY coordinates.
No more offsets between mouse position and lasso corner !
222x20 20010303 JL - PopupMenu now visually indicates selected icon.
- Popup menus work without selecting window now (if any Scalos window is selected)
20010227 JL - finished converting main_dragdropbobs.s to C.
- During D&D, special indicators show if icon may not be dropped
or icons are going to be copied.
- During D&D, holding CTRL key forces copy (instead of move).
20010221 JL - During D&D, Icons leave a "shadow" at their original position if
"Auto remove icons" is enabled. This Shadow is truly transparent
if possible (CyberGfx + Screen depth > 8) and enabled
in preferences, else it is drawn "ghosted".
20010220 JL - Removed old bug in copyfiles - after a read error, Scalos didn't stop,
but tried to write 0xffffffff bytes to the destination.
222x17 20010217 JL - ported all xxxDrop() stuff to C.
Changed ScaBob and ScaBob2 member names to avoid conflicts with Gels Bobs.
20010216 JL - Fixed old bug in execomprog, formatdiskprog, shutdownprog, renameprog,
newdrawerprog, deleteprog, emptytrashprog : TagList for SBA_WBStart() wasn't set,
a1 contained garbage.
20010211 JL - Bug #30: Removed GM_HITTEST from TextIconClass. Now TextIcons can be selected
Bug #19: Text window cleanup now works.
- by clicking anywhere in the line, not only the name field.
20010209 JL - Fixed bug Scalos crashing on quit with drawer windows open
20010207 JL - Pulled nasty bug introduced by early plugin init in ReadDiskPlugin1
20010129 JL - Added new IconWindow methods SCCM_IconWin_DragEnter, SCCM_IconWin_DragLeave,
SCCM_IconWin_DragQuery.
- Added Qualifier to SCCM_IconWin_DragDrop.
- Added global Variable "Default_StackSize".
- Added Support for ToolType "DONOTPROMPT" in conjunction with old ToolType "CLI".
- Moved all datat structure definitions to file "scalos_structures.i".
- Created C header file "scalos_structures.h".
- Actual Plugin Data (e.g. instance size) is read before MakeClass()
- Changed view of dragging selected icons to dragging a "stack" of max. 3 icons
- When dragging, icons/windows indicate where things may be dropped.
- Lasso activates icons on the fly now.
- Popup menu titles reflect icon names.
20010113 JL - Ported to assemble with PhxAss. PhxAss doesn't like constructs like "iconnode\.node"
so I put a prefix on all structure members e.g. "in_node".
39.220 20010111 DM - Converted Juergen's fixes to values instead of constants, AsmOne seems to not like some of the included OS files - in various files
20001231 MC0002 - Added includes for various lvo/#?.i
20001230 MC0001 - Added exec/libraries.i for LIB_VERSION() macro
and OS3.5 asm includes for workbench.library, imageclass.i
20001217 DM000A - Removed include file main_about.s - all code now in C!
20001212 DM0009 - Added some code for calling debug startup/shutdown C functions
20001122 DM0007 - Removed about_pattern from main_tables.s and put into about.c (the only place that was using it)
All logo stuff moved from main_scalos.s to main_about.s (only place it is used)
2000 DM0006
2000 DM0005
20001114 DM0004 - started converting the about requester and related code to C as a test of how painful this is going to be :)
20001107 DM0003 - added the includes imports.i and exports.i. used for when combining with C code. Also added workaround for symbol export bug in AsmXXX
20000903 DM0002 - Bumped version and date to 39.220 (1.2c) and 3/9/00
- Fixed enforcer hit when there is no main menu prefs file on startup
- Noticed that main menu prefs aren't read in with prefslib!
39.219 20000726 DM0001 - Altered some lines in readmainprefs routine so that scratch registers are reloaded before use
19991130 CDH0001 - Added code for new "formatdisk" command from Menu Prefs
19991204 CDH0002 - Added code for "SystemInfo.module" from About requester
19991205 CDH0003 - Added code for new "shutdown" command from Menu Prefs
Scalos main Preferences
40.13 20040827 +jl+ - Added passing of tooltypes on to prefs plugins.
40.12 20040718 +jl+ - Added font preview for icon font, and text window font.
- In the "drag and drop" section, added new qualifier
input field for "Create links" and "Force move".
- On the "Miscellaneous" page, added a cycle gadget to
select the type of links Scalos generates.
40.11 20040516 +jl+ - Added new prefs page for TrueType font settings. TT Font
selection is available for icons, text windows and
tooltips and the "About" window ("Screen font").
- Added checking for custom MUI MCCs and MCC versions.
- Enabled "Multiple Lines" switch for icon text.
40.10 +jl+ - Rearranged prefs pages - created new prefs
group "Drag and Drop".
40.9
40.8 20040111 +jl+ - Added slider for degree of default icon
drawing transparency.
- Transparency settings and "Custom" bob routines
are now disabled when noo CyberGfx library found
or when Workbench screen has no more than 256 colours.
40.7 20040107 +jl+ - Several Datatypes images were no longer
visible after iconify/uniconify. Fixed.
- Added icon for iconified state.
40.6 20040101 +JL+ - Added gadget to adjust Scalos default stack size.
40.5 20031227 +jl+ - Replaced MUI NFloattext class by Floattext.
40.4 20031218 +jl+ - Updated Scalos URL to "scalos.noname.fr".
40.3 20031216 +jl+ - Added missing load/save functions for
Tooltip delay
40.2 20031117 +jl+ - "Add plugin" command erroneously cleared
internal plugin list.
- Changed module image display from
TransferAnimObject to DataTypesMCCObject.
40.1 20030104 +jl+ - Rewritten from scratch, based on code by Budda.
20030710 +JL+ - Initial release 40.1
Scalos FileTypes Preferences
40.6 20041111 +jl+ - Replaced Assembler library startup code by C.
No functional changes.
40.5 20040828 +jl+ - Added menu option and tooltype to hide all
empty filetype entries.
40.4 20040703 +jl+ - Added font preview to TTTFONT editing window.
40.3 20040222 +jl+ - Changing the "create icons" menu item had no effect.
- Added TrueType font support for ToolTips (new TTFONT
attribute for STRING).
40.2 20040108 +jl+ - Added icon for iconified state.
- Bugfix: Fixed handling of internal "modified" flag.
- Added lamp indicator for "modified" flags.
40.1 20031211 +JL+ - Initial release 40.1
Scalos Menu Preferences
40.12 20041111 +jl+ - Replaced Assembler library startup code by C.
No functional changes.
40.10 20040424 +jl+ - Bugfix: Fixed handling of internal "modified" flag.
- Added lamp indicator for "modified" flags.
- Menu command "Merge" erroneously cleared the existing
entries before importing the new ones. Fixed.
40.9 20040222 +jl+ - Changing the "create icons" menu item had no effect.
40.8 20040108 +jl+ - Added icon for iconified state.
40.7 20030831 +JL+ - Moved core functionaility to "MenuPrefs.prefsplugin".
40.6 20030712 JL - Bugfix: Removed memory leak in CLI startup code.
40.5 20030531 JL - Bugfix: Popup button for IconWindow command entries now
only accepts directories.
- Bugfix: Closing command popup ASL requester with "Ok"
button failed to enter filename into Listview element.
- Improvement: command popup ASL requester now defaults to
"Scalos:Plugins/Menu/" directory for menu plugins.
40.4 20030424 JL - Several bugfixes that affect renaming of menu items.
- for Workbench commands, stack size and priority are taken
from icon, if available.
40.2 20030223 JL - Added checking of menu level and number of menu items. It
is no longer possible to add a new menu to a SubMenu, or
to add more than 64 MenuItems to a menu, or to add more
than 32 Entries to a sub menu.
40.1 20021226 JL - Rewritten from scratch in C.
Scalos Palette Preferences
40.7 20041111 +jl+ - Replaced Assembler library startup code by C.
No functional changes.
40.6 20040424 +jl+ - Bugfix: Fixed handling of internal "modified" flag.
- Added lamp indicator for "modified" flags.
- Changing the "create icons" menu item had no effect.
40.5 20040121 +jl+ - Number of allocatable pens was too small by 1. Fixed.
40.4 20040108 +jl+ - Added icon for iconified state.
40.3 20030831 JL - Moved core functionaility to "PalettePrefs.prefsplugin".
40.2 20030712 JL - Bugfix: Removed memory leak in CLI startup code.
40.1 20020601 JL - Added display for number of currently allocated and
available pens.
20011225 JL - Rewritten from scratch in C.
- Added separate pens for selected icon text, icon text
outline, and icon text shadow.
Scalos Pattern Preferences
40.8 20041111 +jl+ - Replaced Assembler library startup code by C.
No functional changes.
40.6 20040426 +jl+ - Bugfix: Fixed handling of internal "modified" flag.
- Added lamp indicator for "modified" flags.
- Changing the "create icons" menu item had no effect.
40.5 20040108 +jl+ - Added icon for iconified state.
40.4 20030831 +JL+ - Moved core functionality to "PatternPrefs.prefsplugin".
40.3 20030712 +JL+ - Bugfix: Removed memory leak in CLI startup code.
40.2 20030129 +JL+ - Bugfix: Bubble for preview gadget was broken.
- Bugfix: switching between "tiled" and "fit size" didn't work.
- Rewritten from scratch in C.
Scalos LoadWB
1.4 20040108 jl - The functionality to wait until Scalos opens its first
Window on the workbench screen can now be
suppressed with NOWAIT.
1.3 20021005 JL - LoadWB now waits until Scalos opened its first Window on
the workbench screen. This is to avoid problems with
Birdie.
picturedimensions.plugin
40.3 20040117 +jl+ +Added localization for message strings.
40.2 20030628 +jl+ +Fixed several memory leaks.
40.1 20021231 +jl+ +Initial release
drawercontents.plugin
40.3 20040117 +jl+ +Added localization for message strings.
40.2 20030628 +jl+ +Fixed several memory leaks.
40.1 20030104 +jl+ +Initial release
amigaiconobj35.datatype
40.7 20031220 jl +changed library from "struct Library" to "struct ClassLibrary"
40.6 20030420 jl +Added support for "borderless" flag.
40.5 20021201 jl +Enhanced cleanup - now does RemLibrary() on iconobject.datatype.
40.4 20020815 jl +Fixed possible enforcer hits in Expunge()
40.3 20020131 jl +Object pointer in A2 might have been set incorrectly under
certain circumstances in OM_NEW/SetSuperImgBorders.
40.2 20020112 jl +Always sets IDTA_InnerLeft, IDTA_InnerTop, IDTA_InnerRight
and IDTA_InnerBottom to 0 if icon has a RenderHook.
40.1 20020101 jl +Removed IDTA_InnerLeft and IDTA_InnerTop checks to
enable frames around masked icons
+Added support for IDTA_SupportedIconTypes tag.
39.31 20010627 jl +Fixed wrong register for GetCyberMapAttr() Attribute parameter.
39.30 20010508 jl +some instance data is now longword aligned
39.29 20010207 jl +fixed 2 byte memory overwrite error in ClearMemory
39.28 20010128 jl +Added Semaphore protection for memory pools
39.27 20010117 jl +Begin revision history
amigaiconobject.datatype
40.5 20031220 +jl+ +changed library from "struct Library" to "struct ClassLibrary"
40.4 20021201 +jl+ +Enhanced cleanup - now does RemLibrary() on iconobject.datatype.
40.3 20020815 +jl+ +Fixed possible enforcer hits in Expunge()
40.2 20020113 +jl+ +More changes for enhanced compatibility for icons with borders.
40.1 20020101 +jl+ +Removed IDTA_InnerLeft and IDTA_InnerTop checks to
enable frames around masked icons
39.24 20010514 +jl+ +fixed mean bug in clLayout - somehow two lines had disappeared.
39.23 20010511 +jl+ +fixed serious bug in clWrite.
39.22 20010508 +jl+ +some instance data is now longword aligned
39.21 20010128 +jl+ +Added Semaphore protection for memory pools
39.20 20010117 +jl+ +All memory allocations are now being done via memory pools.
iconobject.datatype
40.12 20040814 +jl+ +Added support for new IODRAWF_NoEraseBg flag.
40.11 20040524 +jl+ +Added functionality to support TrueType fonts for icon text
20040611 +jl+ +Added support for splitting of icon text into multiple lines
20040611 +jl+ +Added support for transparent rendering of icon label shadow
and outline (TrueType fonts only).
40.10 20031220 +jl+ +changed library from "struct Library" to "struct ClassLibrary"
40.9 20030420 +jl+ +Added support for per-icon "borderless" flag
40.7 20020928 +jl+ +Added IDTA_UserFlags get/set tag.
40.6 20020815 +jl+ +Fixed possible enforcer hits in Expunge()
40.5 20020321 dm +Fixed crash when GM_HITTEST was invoked with icon mask of NULL.
40.4 20020320 +jl+ +GM_HITTEST was broken when icon borders were > 0.
40.3 20020201 +jl+ +Added attribute tags IDTA_MaskBM_Normal and IDTA_MaskBM_Selected.
40.2 20020113 +jl+ +More changes for enhanced compatibility for icons with borders.
40.1 20020101 +jl+ +Added separate pens for selected icon text, icon text
outline, and icon text shadow.
39.38 20011230 +jl+ +Major changes to support borders around os3.5 icons and NewIcons.
39.37 20010818 +jl+ +Added IDTA_Font attribute
39.36 20010617 +jl+ +SetAttr(IDTA_ToolTypes) now stores a COPY of the
provided tooltype array. Copy gets freed on Dispose.
39.35 20010613 +jl+ +checks for "FBlit" on OpenLibrary and doesn't use
any chip memory if found.
39.34 20010508 +jl+ +longword-aligned structure IconObjectInst.
39.33 20010429 +jl+ +Displays underlined text if IDTA_isLink is TRUE.
39.32 20010311 +jl+ +Uses no chip mem if cybergraphics is found.
39.31 20010209 +jl+ +Added missing "ret" in LibClose ...
fixes crash on Scalos closing.
39.30 20010128 +jl+ +Added Semaphore protection for memory pools
39.29 20010117 +jl+ +All memory allocations are now being done via memory pools.
39.28 20010114 +jl+ +fixed memory leak with iobj_name
newiconobject.datatype
40.5 20031220 +jl+ +changed library from "struct Library" to "struct ClassLibrary"
40.4 20021201 +jl+ +Enhanced cleanup - now does RemLibrary() on iconobject.datatype.
40.3 20020815 +jl+ +Fixed possible enforcer hits in Expunge()
40.2 20020113 +jl+ +More changes for enhanced compatibility for icons with borders.
40.1 20020101 +jl+ +Removed IDTA_InnerLeft and IDTA_InnerTop checks to
enable frames around masked icons
39.24 20011206 +jl+ +Fixed reversed check for IOFREELAYOUTB_ScreenAvailable
in idtm_freelayout.
39.23 20010714 +jl+ +Fixed bug in DTM_Write with IDTA_ToolTypes.
39.22 20010627 +jl+ +Fixed wrong register for GetCyberMapAttr() Attribute parameter.
39.21 20010508 +jl+ +some instance data is now longword aligned
39.20 20010128 +jl+ +Added Semaphore protection for memory pools
39.19 20010120 +jl+ +All memory allocations are now being done via memory pools.
pngiconobject.datatype
40.12 20041111 +jl+ +Replaced Assembler library startup code by C.
No functional changes.
40.11 20040915 +jl+ +Bugfix: icon mask generation clipped some pixels
at right border. Fixed.
40.10 20040801 +jl+ +Default icons were not saved to the correct path.
40.9 20040523 +jl+ +Fixed severe memory trashing. Datatype used to overwrite
random memory with some icons.
40.8 20040429 +jl+ +Datatype now correctly recognizes and renders
AppIcons generated by PowerIcons.
40.7 20040226 +jl+ +Plugged several memory holes.
40.6 20040111 +jl+ +Added support for default icons via IDTA_DefType tag.
40.5 20040109 +jl+ +Now supports extra information about original
object (Path+Name) for the determination
of icon type.
40.4 20040105 +jl+ +Iconobjects now use DrawerData defaults from
icon.library default icon of the same type.
40.3 20040104 +jl+ +Fixed severe bug that trashed random memory.
Only occured with icons without fixed position.
40.2 20040102 +jl+ +Added optimization in alpha-blending routines.
+Fixed trashing of icon image data
during IDTM_Write.
+Disk icons (WBDISK) were not recognized properly.
40.1 20011221 +jl+ +Initial version
iconobject.library
40.4 20041110 +jl+ - Removed Assembler library startup code.
No functional changes.
40.3 20021201 +jl+ - Improved cleanup code: FreeClassList() now calls
RemLibrary() for each datatype.
- Added capability to copy/cut/paste attributes.
40.2 20020815 +jl+ - Fixed possible Enforcer hit in Expunge()
40.1 20020101 +jl+ - Added new library function Convert2IconObjectA()
wbrexx.plugin
39.18 20041113 jl +Replaced Assembler library startup functions
by C code. No functional changes.
39.17 20031222 JL +Changed "OpenDrawerByName()" to make use of the
Scalos iconobject datatypes.
39.16 20030112 JL +Removed some dependencies on undocumented internal
Scalos data structures.
39.15 20021206 JL +Added "MENU INVOKE WINDOW.CLEANUPBY.NAME/DATE"
"/SIZE/TYPE" functions.
+Added "ICON MOVE IN/OUT" functions.
+Added "MENU INVOKE WINDOW.RESIZETOFIT" function.
39.14 20021130 JL +Added "ICON ACTIVATE UP/DOWN/LEFT/RIGHT" functions.
+Fixed order of which icons get select with
"ICON CYCLE NEXT/PREV" function.
39.13 20020927 JL +Fixed bug in AddMenuItem() and AddKeyboardCommand()
which could lead to crashed when trying to add items
with already exiting names.
39.12 20020131 JL +Now supports adding menu subitems and new menus. Using
this new features requires Scalos V40.20.
39.11 20011030 JL +Fixed serious initialisation problem in Scalos
preview mode, leading to crash on any keyboard input.
39.10 20011020 JL +No longer initializes if Scalos is running in
preview mode.
39.9 20011008 JL +Changed priority to -79 in order to make it work
for text windows.
+"ICON MAKEVISIBLE" didn't always work correctly for
text windows. Fixed.
39.8 20010927 JL +Added missing MENU and KEYBOARD functions.
+Fixed several bugs GETATTR function.
39.7 20010719 JL +Forgot to UnLock() lock in FindWindowByName(). Fixed.
39.6 20010718 JL +Changed matching algorithm in FindWindowByName(),
important for all WINDOW commands.
wb39.plugin
45.28 20041113 jl +Replaced Assembler library startup functions
by C code. No functional changes.
45.27 20040612 JL +Fixed enforcer hits when text window icons were
renamed with AsyncWB (Added translation of text icon
types in ChangeWorkbenchSelectionA() ).
45.26 20040103 JL +Added several undocumented WorkbenchControl() tags,
WBCtrl doesn't fail, however, not all values are used.
+MaxCopyMem can now be changed via
WorkbenchControlA() calls.
45.25 20031222 JL +Changed "OpenDrawerByName()" to make use of the
Scalos iconobject datatypes.
45.24 20030112 JL +Removed some dependencies on undocumented internal
Scalos data structures.
45.23 20020914 JL +Added support for V45 WBOPENA_Show and WBOPENA_ViewBy
tags to OpenWorkbenchObjectA emulation.
45.22 20020110 JL +The AMTYPE_APPWINDOW AppMessages generated in
AppWindow.c had wrong mn_Replyport. Fixed.
45.21 20011231 JL +Added support for "No Color Icons" and "No NewIcons"
workbench prefs settings.
45.20 20011223 JL +Avoid excessive Scalos root window updates
with AddHiddenDevice/RemHiddenDevice.
45.19 20011204 JL +Added support for (undocumented) CloseWB/OpenWB hook list.
+Added Support for (undocumented) set/clear icon.library
global screen.
45.18 20011129 JL +Added support for getting and setting delete, copy,
and text input hooks (undocumented).
45.17 20011116 JL +fVolumeGauge was not longer checked. Fixed.
+WB prefs are now checked each time a new device
window is opened.
45.16 20011020 JL +No longer installs patches if Scalos is running in
preview mode.
45.15 20011010 JL +Added proper handling for WorkbenchControl() tags
WBCTRLA_SetTypeRestartTime and WBCTRLA_GetTypeRestartTime.
20011008 JL +Changed priority to -89.
45.14 20010714 JL After WBCTRLA_AddHiddenDeviceName and
WBCTRLA_RemoveHiddenDeviceName, now does
SCCM_IconWin_Update on root window.
45.13 20010708 JL When opening drawer windows, DDVM_BYICON now gets
translated into IDTV_ViewModes_Icon.
20010623 JL Added full Support for WBCTRLA_GetDefaultStackSize and
WBCTRLA_GetProgramList, using new SCA_ScalosControl() call.
20010524 JL HiddenDeviceList entries now get ln_Type=0x67 so
Workbench prefs/IPrefs correctly removes old entries from list.
20010523 JL Added additional argument checking to myWorkbenchControlA()
Added Semaphore protection for HiddenDeviceList
20010520 DM Some other small fixes
20010518 DM Hidden device list completely supported (needs devicefilter.plugin
to actually hide devices).
Hidden devices read from workbench prefs file (scalos_helper.c)
20010124 JL Fixed Malfunction of AddAppWindowDropZoneA() with WBDZA_Box
persist.plugin
39.19 20041113 jl + Replaced Assembler library startup functions
by C code. No functional changes.
39.18 20031222 JL - Changed "OpenDrawerByName()" to make use of the
Scalos iconobject datatypes.
39.17 20020501 JL - "Persistant_Windows" file no longer is deleted during
initialization. The advantage is, if Scalos crashed before
the first window gets re-opened, the Persistant_Windows
file is untouched. As soon as the first window opens,
the Persistant_Windows file is rewritten.
- The re-opened windows won't get activated (works with
Scalos V40.22+).
39.16 20011228 JL - Disabled some Printf() calls.
39.15 20010803 JL - Reversed order in which windows are reopened.
39.14 20010730 JL - Changed name of prefs file from "ENVARC:Scalos/Persist.config"
to "ENV:Scalos/Persist.prefs".
- "Use_SCA_Iconify" now default to "1" if scalos.library
version is at least 40.
39.13 JL - Name of persistant windows status file is now configurable
in "ENVARC:Scalos/Persist.config".
39.12 JL - When re-opening drawer windows,
DDVM_BYICON now gets translated into IDTV_ViewModes_Icon.
39.11 JL - when re-opening window in iconified state, now immediately adds
entry in persist file (no SCCM_Window_Open will occur, so otherwise
no entry would be generated at all).
39.10 JL - prefs file may contain comment lines beginning with "#".
empty lines in prefs file will be ignored.
iconified windows are remembered and re-iconified on startup.
volumegauge.plugin
39.6 20041113 jl +Replaced Assembler library startup functions
by C code. No functional changes.
39.5 20030112 JL +Removed some dependencies on undocumented internal
Scalos data structures.
39.4 20011110 - some changes for compatibility with Scalos 40.14.
deficons.plugin
./. 20031231 JL - Depracated since functionality has been integrated
into Scalos main program.
45.6 20011230 JL - OpenLibraries was called twice. Fixed.
- Added support for individually enabled/disabled icon types.
xtwindows.plugin
40.5 20040102 JL - Adapted to changed OpenDrawerByName() function, now
uses iconobject.library instead of icon.library.
ScalosCtrl
40.16 20040104 JL + Added new CBS=COPYBUFFSIZE parameter.
20040102 - Added "QUERY" command line switch.
Content-Type: text/html scalosgfx.library
ScalosGfxCreateEmptySAC
ScalosGfxCreateSAC
ScalosGfxFreeSAC
ScalosGfxCreateARGB
ScalosGfxFreeARGB
ScalosGfxARGBSetAlpha
ScalosGfxARGBSetAlphaMask
ScalosGfxCreateARGBFromBitMap
ScalosGfxFillARGBFromBitMap
ScalosGfxWriteARGBToBitMap
ScalosGfxMedianCut
ScalosGfxScaleARGBArray
ScalosGfxScaleBitMap
ScalosGfxCalculateScaleAspect
ScalosGfxBlitARGB
ScalosGfxFillRectARGB
ScalosGfxSetARGB
ScalosGfxNewColorMap
ScalosGfxARGBRectMult
ScalosGfxBlitARGBAlpha
ScalosGfxBlitARGBAlphaTagList
ScalosGfxBlitIcon
NAME
ScalosGfxCreateEmptySAC -- Allocate an empty ScalosBitMapAndColor
SYNOPSIS
sac = ScalosGfxCreateEmptySAC( )
D0
struct ScalosBitMapAndColor *ScalosGfxCreateEmptySAC( void );
FUNCTION
Allocates an empty ScalosBitMapAndColor structure, with NULL
sca_BitMap and sac_ColorTable.
INPUTS
none
RESULT
sac - new created ScalosBitMapAndColor, or NULL on failure
SEE ALSO
ScalosGfxFreeSAC(), ScalosGfxCreateSAC()
NAME
ScalosGfxCreateSAC -- Allocate ScalosBitMapAndColor
SYNOPSIS
sac = ScalosGfxCreateSAC(width, height, depth, friendBM, tagList);
D0 D0 D1 D2 A0 A1
struct ScalosBitMapAndColor *ScalosGfxCreateSAC(ULONG, ULONG, ULONG,
struct BitMap *, struct TagItem *)
struct ScalosBitMapAndColor *ScalosGfxCreateSACTags(ULONG, ULONG, ULONG,
struct BitMap *, ULONG, ...)
FUNCTION
Allocate a ScalosBitMapAndColor structure. sac_BitMap and sac_ColorTable
are allocated according to specified dimensions.
INPUTS
width - Desired width of new ScalosBitMapAndColor BitMap.
height - Desired height of new ScalosBitMapAndColor BitMap.
depth - Desired depth of new ScalosBitMapAndColor BitMap. Must be less
than 256. sac_ColorTable will be allocated to hold 2^depth entries.
friendBM - Friend BitMap to use for BitMap allocation.
tagList - pointer to list of Tags, or NULL.
TAGS
None defined yet.
RESULT
sac - new created ScalosBitMapAndColor, or NULL on failure
SEE ALSO
ScalosGfxFreeSAC(), ScalosGfxCreateEmptySAC()
NAME
ScalosGfxFreeSAC -- free a previously allocated ScalosBitMapAndColor
SYNOPSIS
ScalosGfxFreeSAC(sac);
A0
void ScalosGfxFreeSAC((struct ScalosBitMapAndColor *);
FUNCTION
Frees and deallocates a previously allocated ScalosBitMapAndColor,
including sac_BitMap and sac_ColorTable.
INPUTS
sac - previously allocated ScalosBitMapAndColor, or NULL
RESULT
nothing
SEE ALSO
ScalosGfxCreateSAC(), ScalosGfxCreateEmptySAC()
NAME
ScalosGfxCreateARGB -- Allocate a gfxARGB with specified size
SYNOPSIS
argb = ScalosGfxCreateARGB(width, height, tagList)
D0 D0 D1 A0
struct gfxARGB *ScalosGfxCreateARGB(ULONG, ULONG, struct TagItem *)
FUNCTION
Allocates an array of struct gfxARGB with sufficient size for
specified width and height.
INPUTS
width - width of gfxARGB array
height - height of gfxARGB array
tagList - pointer to list of Tags, or NULL.
TAGS
None defined yet.
RESULT
argb - new allocated gfxARGB, or NULL on failure.
SEE ALSO
NAME
ScalosGfxFreeARGB -- Free a previously allocated gfxARGB
SYNOPSIS
ScalosGfxFreeARGB(argb)
D0 A0
VOID ScalosGfxFreeARGB(struct gfxARGB **)
FUNCTION
INPUTS
argb - pointer to storage of previously allocated gfxARGB.
argb may point to NULL.
RESULT
nothing
SEE ALSO
ScalosGfxCreateARGB()
NAME
ScalosGfxARGBSetAlpha -- Set all pixels to specified Alpha value.
SYNOPSIS
ScalosGfxARGBSetAlpha(src, alpha);
A0 D0
VOID ScalosGfxARGBSetAlpha(struct ARGBHeader *, UBYTE)
FUNCTION
Alpha value of all pixels in the ARGBHeader and its previously
allocated gfxARGB array is set to the specified value.
INPUTS
src - Header of gfxARGB rectangle to modify.
alpha - Alpha (transparency) value to set.
RESULT
SEE ALSO
ScalosGfxARGBSetAlphaMask()
NAME
ScalosGfxARGBSetAlphaMask -- Set alpha value according to mask plane
SYNOPSIS
ScalosGfxARGBSetAlphaMask(argbh, maskPlane)
A0 A1
VOID ScalosGfxARGBSetAlphaMask(struct ARGBHeader *, PLANEPTR)
FUNCTION
Alpha values of all pixels in the ARGBHeader and its previously
allocated gfxARGB array are set according to mask plane, i.e. for
every bit set in mask plane, alpha is maximum (255), and for every
cleared bit, alpha is set to minimum (0).
INPUTS
argbh - Header of gfxARGB rectangle to modify.
maskPlane - Single bit mask plane. Dimensions must match size of argbh, with
width rounded up to next 16-bit.
RESULT
nothing
SEE ALSO
ScalosGfxARGBSetAlpha()
NAME
ScalosGfxCreateARGBFromBitMap -- Create gfxARGB array from a BitMap
SYNOPSIS
argb = ScalosGfxCreateARGBFromBitMap(bm, width, height, numberOfColors, colorTable, maskPlane
D0 A0 D0 D1 D2 A1 A2
struct gfxARGB *ScalosGfxCreateARGBFromBitMap(struct BitMap *, ULONG, ULONG, ULONG,
const ULONG *, PLANEPTR)
FUNCTION
Allocates and a gfxARGB array with specified dimensions, and fills it from
provided BitMap, with optional mask plane. Works only with standard BitMaps with
less than 256 colors.
INPUTS
bm - source BitMap to fill gfxARGB array from,
Depth must be less than 256 colors.
width - Width of gfxARGB array
height - Height of gfxARGB array
numberOfColors - number of entries in colorTable
colorTable - Color table to use for BitMap
maskPlane - Single bit mask plane. Dimensions must match width and
height, with width rounded up to next 16-bit. May be NULL.
RESULT
argb - allocated gfxARGB array or NULL on failure.
NOTES
Use ScalosGfxFillARGBFromBitMap() for high-color or true-color BitMaps.
SEE ALSO
ScalosGfxFillARGBFromBitMap()
NAME
ScalosGfxFillARGBFromBitMap -- Fill previously allocated gfxARGB array from CGFX BitMap
SYNOPSIS
ScalosGfxFillARGBFromBitMap(argbh, srcBM, maskPlane)
A0 A1 A2
VOID ScalosGfxFillARGBFromBitMap(struct ARGBHeader *, struct BitMap *, PLANEPTR)
FUNCTION
Fill a previously allocated gfxARGB array from a CyberGraphics BitMap. Can only
be used for high-color or true-color BitMaps.
If maskPlane if given, alpha information in argbh is created from maskPlane. If
maskPlane if NULL, alpha channel from source BitMap is used if available,
otherwise alpha is set to opaque.
INPUTS
argbh - completely initialized gfxARGB array
srcBM - source BitMap to use for filling, depth must be at least 65536 colors
maskPlane - Single bit mask plane. Dimensions must match width and height, with
width rounded up to next 16-bit. May be NULL.
RESULT
nothing
NOTES
Use ScalosGfxARGBSetAlpha() for standard BitMaps (i.e. less than 256 colors).
SEE ALSO
ScalosGfxCreateARGBFromBitMap()
NAME
ScalosGfxWriteARGBToBitMap -- Copy gfxARGB array to BitMap
SYNOPSIS
ScalosGfxWriteARGBToBitMap(argbh, bm, numberOfColors, colorTable)
A0 A1 D0 A2)
VOID ScalosGfxWriteARGBToBitMap(struct ARGBHeader *, struct BitMap *, ULONG, const ULONG *)
FUNCTION
Creates a copy of gfxARGB array in destination BitMap,
using pre-defined colorTable. Works only with standard BitMaps, i.e. with
less than 256 colors. No sophisticated color reduction is performed, but
bit-fit pens are decided via FindBestPen().
INPUTS
argbh - gfxARGB array to read from
bm - Standard BitMap to write to. BitMap must
have less than 256 colors.
numberOfColors - Number of entries in colorTable
colorTable - color table to use for BitMap.
RESULT
nothing
SEE ALSO
NAME
ScalosGfxMedianCut -- Create color-reduced BitMap from gfxARGB array
SYNOPSIS
sac = ScalosGfxMedianCut(argbh, depth, tagList)
D0 A0 D0 A1
struct ScalosBitMapAndColor *ScalosGfxMedianCut(struct ARGBHeader *, ULONG, struct TagItem *)
struct ScalosBitMapAndColor *ScalosGfxMedianCutTags(struct ARGBHeader *, ULONG, ULONG, ...)
FUNCTION
Allocate and fill a color-reduced BitMap and a best-match color table from gfxARGB array.
Either ordered dithering or Floyd-Steinberg dithering will be used for best results.
INPUTS
argbh - gfxARGB array to read from
depth - desired depth of generated BitMap, must be less than 256.
tagList - array of tagItems, as desribed below, or NULL.
TAGS
SCALOSGFX_MedianCutFlags - Flags as described below.
SCALOSGFX_MedianCutFriendBitMap - struct BitMap *, friend BitMap to use
for allocating result BitMap
SCALOSGFX_MedianCutReservedColors - ULONG, number of reserved (unused) color
entries at start of generated color table.
FLAGS
SCALOSGFXFLAGF_MedianCut_FloydSteinberg - If set, Floyd-Steinberg dithering
will be used for color reduction.
RESULT
sac - created ScalosBitMapAndColor pointer, or NULL on failure.
SEE ALSO
NAME
ScalosGfxScaleARGBArray -- Scale given gfxARGB array
SYNOPSIS
argb = ScalosGfxScaleARGBArray(src, destWidth, destHeight, tagList)
D0 A0 A1 A2 A3
struct gfxARGB *ScalosGfxScaleARGBArray(const struct ARGBHeader *, ULONG *,
ULONG *, struct TagItem *)
struct gfxARGB *ScalosGfxScaleARGBArrayTags(const struct ARGBHeader *, ULONG *,
ULONG *, ULONG, ...)
FUNCTION
Scales given gfxARGB array to a new size. Supports both enlarging and shrinking
gfxARGB arrays.
INPUTS
src - source gfxARGB array, will not be modified
destWidth - desired width, might be internally corrected
if SCALEFLAGF_CORRECTASPECT is set.
destHeight - desired height, might be internally corrected
if SCALEFLAGF_CORRECTASPECT is set.
tagList - pointer to list of Tags, or NULL.
TAGS
SCALOSGFX_ScaleARGBArrayFlags - ULONG, specify some operation flags as listed below.
FLAGS
SCALEFLAGF_BICUBIC - allow bicubic scaling
SCALEFLAGF_BILINEAR - allow bilinear scaling
SCALEFLAGF_AVERAGE - allow average scaling
SCALEFLAGF_DOUBLESIZE - allow intermediate step via double size, to improve quality
SCALEFLAGF_CORRECTASPECT - allow correction of destWidth and destHeight to
meet source aspect ratio.
RESULT
argb - Scaled copy of the source gfxARGB array
SEE ALSO
NAME
ScalosGfxScaleBitMap -- Scale given BitMap
SYNOPSIS
bm = ScalosGfxScaleBitMap(sbma, tagList)
D0 A0 A1
struct BitMap *ScalosGfxScaleBitMap(struct ScaleBitMapArg *, struct TagItem *)
struct BitMap *ScalosGfxScaleBitMapTags(struct ScaleBitMapArg *, ULONG, ...)
FUNCTION
Scales given gfxARGB array to a new size. Supports both enlarging and shrinking
gfxARGB arrays.
INPUTS
sbma - Structure with scaling parameters:
sbma_SourceBM - The original BitMap. This BitMap is not modified.
sbma_SourceWidth - Width of the source BitMap.
sbma_SourceHeight - Height of the source BitMap
sbma_DestWidth - Pointer to Width of resized BitMap, might be internally
corrected if SCALEFLAGF_CORRECTASPECT is set.
sbma_DestHeight - Pointer to Height of resized BitMap, might be internally
corrected if SCALEFLAGF_CORRECTASPECT is set.
sbma_NumberOfColors - number of entries in color table
sbma_ColorTable - Color table for both source and resized BitMap.
sbma_Flags - scaling flags:
SCALEFLAGF_BICUBIC - allow bicubic scaling
SCALEFLAGF_BILINEAR - allow bilinear scaling
SCALEFLAGF_AVERAGE - allow average scaling
SCALEFLAGF_DOUBLESIZE - allow intermediate scaling step with
double size, to improve quality
SCALEFLAGF_CORRECTASPECT - allow correction of destWidth and
destHeight to meet source aspect ratio.
sbma_ScreenBM - Firend BitMap used when allocating resized BitMap.
tagList - pointer to list of Tags, or NULL.
TAGS
none defined yet.
RESULT
bm - Scaled copy of the original BitMap
SEE ALSO
NAME
ScalosGfxCalculateScaleAspect -- Adjust scaling dimensions to source aspect
SYNOPSIS
ScalosGfxCalculateScaleAspect(sourceWidth, sourceHeight, *destWidth, *destHeight)
D0 D1 A0 A1
VOID ScalosGfxCalculateScaleAspect(ULONG, ULONG, ULONG *, ULONG *)
FUNCTION
Adjusts either destWidth or destHeight according to aspect ratio of
sourceWidth and soureHeight.
INPUTS
sourceWidth - Unscaled width.
sourceHeight - Unscaled Height;
destWidth - Pointer to desired scaled width.
destHeight - Pointer to desired scaled width.
RESULT
nothing
SEE ALSO
NAME
ScalosGfxBlitARGB -- Blit rectangle between two gfxARGB array rectangles.
SYNOPSIS
ScalosGfxBlitARGB(destARGB, srcARGB, destLeft, destTop, srcLeft, srcTop, width, height)
A0 A1 D0 D1 D2 D3 D4 D5
VOID ScalosGfxBlitARGB(struct ARGBHeader *, const struct ARGBHeader *,
LONG, LONG, LONG, LONG, LONG, LONG)
FUNCTION
Blits user-defined rectangle from srcARGB at specified position into destARGB.
No alpha handling is performed, destination pixel values are simply
replaced by source pixels.
INPUTS
destARGB - destination gfxARGB array
srcARGB - source gfxARGB array
destLeft - Left start position in destARGB.
destTop - Top start position in destARGB.
srcLeft - Left start position in srcARGB.
srcTop - Top start position in srcARGB.
width - Width of blitted rectangle.
height - Height of blitted rectangle.
RESULT
nothing
SEE ALSO
NAME
ScalosGfxFillRectARGB -- Blit two gfxARGB array rectangles
SYNOPSIS
ScalosGfxFillRectARGB(destARGB, fillARGB, left, top, width, height)
A0 A1 D0 D1 D2 D3
VOID ScalosGfxFillRectARGB(struct ARGBHeader *, const struct gfxARGB *,
LONG, LONG, LONG, LONG)
FUNCTION
Blits fillARGB at specified position into destARGB. No alpha handling is
performed, destination pixel values are just replaced by source pixels.
Blit always starts at (0,0) in fillARGB.
INPUTS
destARGB - destination gfxARGB array.
fillARGB - source gfxARGB array.
left - Left start position in destARGB.
top - Top start position in destARGB.
width - Width of blitted rectangle.
height - Height of blitted rectangle.
RESULT
nothing
SEE ALSO
NAME
ScalosGfxSetARGB -- Set entire gfxARGB array to given ARGB color
SYNOPSIS
ScalosGfxSetARGB(destARGB, fillARGB)
A0 A1
VOID ScalosGfxSetARGB(struct ARGBHeader *, const struct gfxARGB *)
FUNCTION
Set all pixels in entire gfxARGB array to the given ARGB color.
INPUTS
destARGB - gfxARGB array to be changed.
fillARGB - ARGB value to set pixels to.
RESULT
nothing
SEE ALSO
NAME
ScalosGfxNewColorMap -- Allocate new color table for ScalosBitMapAndColor
SYNOPSIS
success = ScalosGfxNewColorMap(sac, colorMap, colorEntries)
D0 A0 A1 D0
BOOL ScalosGfxNewColorMap(struct ScalosBitMapAndColor *, const ULONG *, ULONG)
FUNCTION
Allocates a new color table for ScalosBitMapAndColor. The new color table is
filled with the RGB values from colorMap.
Any previously color table in ScalosBitMapAndColor is freed.
INPUTS
sac - ScalosBitMapAndColor where to store new color table.
colorMap - RGB values for new color table
colorEntries - Desired number of entries in new color table
RESULT
success - TRUE if new color table was successfully allocated,
FALSE on failure.
SEE ALSO
NAME
ScalosGfxARGBRectMult -- Multiply RGB value with given factor
SYNOPSIS
ScalosGfxARGBRectMult(rp, numerator, denominator, xMin, yMin, xMax, yMax)
A0 A1 A2 D0 D1 D2 D3
VOID ScalosGfxARGBRectMult(struct RastPort *, const struct gfxARGB *,
const struct gfxARGB *, WORD, WORD, WORD, WORD)
FUNCTION
Multiplies RGB values of pixels within a specified rectangle
with (numerator/denominator). Overflow is clipped to maximum RGB value (255).
Works only with CyberGraphics generated, high-color or true-color BitMaps.
Takes Layers in RastPort into account.
INPUTS
rp - RastPort with the BitMap to be modified.
numerator - Scaling factor as numerator:denominator
denominator - Scaling factor as numerator:denominator
xMin - Left start of modified rectangle.
yMin - Top start of modified rectangle.
xMax - Right end of modified rectangle.
yMax - Bottom end of modified rectangle.
RESULT
nothing
SEE ALSO
NAME
ScalosGfxBlitARGBAlpha -- Alpha blit from gfxARGB array into RastPort
SYNOPSIS
ScalosGfxBlitARGBAlpha(rp, srcH, destLeft, destTop, srcLeft, srcTop, width, height)
A0 A1 D0 D1 D2 D3 D4 D5
VOID ScalosGfxBlitARGBAlpha (struct RastPort *, const struct ARGBHeader *,
ULONG, ULONG, ULONG, ULONG, ULONG, ULONG)
FUNCTION
Blit a rectangular area from source gfxARGB array into
destination RastPort. Alpha (transparency) information in
source gfxARGB array is fully accounted for.
Destination RastPort may have Layers.
INPUTS
rp - Destination, this RastPort is been drawn to.
srcH - Source gfxARGB array
destLeft - Left offset in destination RastPort.
destTop - Top offset in destination RastPort.
srcLeft - Left offset in source gfxARGB array.
srcTop - Left offset in source gfxARGB array.
width - Width of blit rectangle.
height - Height of blit rectangle.
RESULT
nothing
NOTES
SEE ALSO
ScalosGfxBlitARGBAlphaTagList()
NAME
ScalosGfxBlitARGBAlphaTagList -- Alpha blit from gfxARGB array into RastPort
SYNOPSIS
ScalosGfxBlitARGBAlphaTagList(rp, srcH, destLeft, destTop, srcSize, tagList)
A0 A1 D0 D1 A3 A2
VOID ScalosGfxBlitARGBAlphaTagList(struct RastPort *, const struct ARGBHeader *,
ULONG, ULONG, const struct IBox *, struct TagItem *)
VOID ScalosGfxBlitARGBAlphaTags(struct RastPort *, const struct ARGBHeader *,
ULONG, ULONG, const struct IBox *, ULONG, ...)
FUNCTION
INPUTS
rp - Destination, this RastPort is been drawn to.
srcH - Source gfxARGB array
destLeft - Left offset in destination RastPort.
destTop - Top offset in destination RastPort.
srcSize - IBox defining both left/top offset in source gfxARGB
array, and size of blit rectangle.
tagList - pointer to list of Tags, or NULL.
TAGS
SCALOSGFX_BlitIconHilight - const struct ARGB *, ARGB value to use
for highlighting.Its RGB values are added
to the destination pixels, with clipping
to 0..255 range.
SCALOSGFX_BlitIconAlpha - const UBYTE *, specify alpha array for icon.
SCALOSGFX_BlitIconTransparency - ULONG, specify alpha for icon, 0...255.
RESULT
nothing
SEE ALSO
ScalosGfxBlitARGBAlpha()
NAME
ScalosGfxBlitIcon -- Alpha blit from RastPort to RastPort
SYNOPSIS
ScalosGfxBlitIcon(rpBackground, rpIcon, left, top, width, height, tagList)
A0 A1 D0 D1 D2 D3 A2
VOID ScalosGfxBlitIcon(struct RastPort *, struct RastPort *,
ULONG, ULONG, ULONG, ULONG, struct TagItem *)
VOID ScalosGfxBlitIconTags(struct RastPort *, struct RastPort *,
ULONG, ULONG, ULONG, ULONG, ULONG, ...)
FUNCTION
Blit a rectangular area from rpIcon into rpBackground, with full
alpha (transparency) support.
This function supports RastPorts with Layers.
INPUTS
rpBackground - Target RastPort.
rpIcon - Source RastPort. The BitMap of this RastPort is
not modified.
left - left start of blit in rpBackground
top - top start of blit in rpBackground
width - width of the blitting rectangle
height - height of the blitting rectangle
tagList - pointer to list of Tags, or NULL.
TAGS
SCALOSGFX_BlitIconHilight - const struct ARGB *, ARGB value to use
for highlighting. Its RGB values are
added to the destination pixels, with
clipping to 0..255 range.
SCALOSGFX_BlitIconAlpha - const UBYTE *, specify alpha array for icon.
SCALOSGFX_BlitIconTransparency - ULONG, specify alpha for icon, 0...255.
RESULT
nothing
SEE ALSO