AcornSearch - Acorn and RISC OS information searching
RISC OS Search
containing
"Nutty quip goes here!"
Home  |  About  |  Filebase Archive  |  StrongHelp Manuals  |  Newsgroups  |  Module Database
Operations concerning icon borders.

Reason     Action
0     Get border number
1     Get border width
2     Get bounding box in registers
3     Get bounding box in block
4     Get border parameters
5     Read async button state
6     Get selected async button

Provided by 3DIcons
Get border number
Entry
     R0 = 0
     R1 -> icon block
Exit
     R0 = border number, or -1 if the icon has no 3D border

Returns the number of the 3D border of the specified icon. -1 is returned if the icon has no 3D border.
Get border width
Entry
     R0 = 1
     R2 = border number (0-6)
Exit
     R0 = width in OS units, or 0 if R2 did not contain a valid border number

Returns the width of the 3D border outside the icon‘s bounding box. 0 is returned if an invalid border type is specified.
Get bounding box in registers
Entry
     R0 = 2
     R1 -> icon block
Exit
     R2 = XMin
     R3 = YMin
     R4 = XMax
     R5 = YMax

Returns the bounding box of the icon, including the 3D border if present.
Get bounding box in block
Entry
     R0 = 3
     R1 -> pointer to icon block
     R2 -> pointer to 16-byte block to receive bounding box
Exit
     R2 +  0 = XMin
     R2 +  4 = YMin
     R2 +  8 = XMax
     R2 + 12 = YMax

Returns the bounding box of the icon, including the 3D border if present.
Get border parameters
Entry
     R0 = 4
     R1 -> icon block
Exit
     R0 = slabbed-out colour + slabbed-in colour * 16 or -1 for bad validation
     R2 = border-1 colour + border-2 colour * 16
     R3 = channel colour + slabbing time * 16

Returns the parameters of the border command, substituting defaults for unspecified parameters.
Read async button state
Entry
     R0 = 5
     R2 = window handle
     R3 = icon handle
Exit
     R0 = current state of icon (0 for popped out, 1 for popped in)
Get selected async button
Entry
     R0 = 6
     R2 = window handle
     R3 = ESG group
Exit
     R0 = Async icon number that is popped in, or -1 for none

Checks the specified window and returns which icon in the ESG is currently popped in using the async list.

[sh-index] Back to list of manuals