From f25bf900e84a6cf60bd4a939cdfff358d794bc3a Mon Sep 17 00:00:00 2001 From: Dagen Brock Date: Fri, 13 Sep 2024 22:03:37 -0500 Subject: [PATCH] more misc tools --- toolbox-ref/toolcalls.json | 118 +++++++++++++++++++++++++++++++++---- 1 file changed, 107 insertions(+), 11 deletions(-) diff --git a/toolbox-ref/toolcalls.json b/toolbox-ref/toolcalls.json index 0c46b9b..b479c78 100644 --- a/toolbox-ref/toolcalls.json +++ b/toolbox-ref/toolcalls.json @@ -1340,70 +1340,166 @@ "toolnum": "03", "toolname": "Misc Tools", "callname": "InitMouse", - "description": "Initializes mouse clamp values to $000 min & $3FF max & clears mouse mode & status" + "description": "Initializes mouse clamp values to $000 min & $3FF max & clears mouse mode & status", + "parameters": { + "input": [ + { "size": "word", "name": "mouseSlot", "description": "Requests search for mouse ($0000) or slot for mouse ($0001-7)" } + ] + }, + "errors": ["mt0302"], + "c": { "call": "extern pascal void InitMouse()" }, + "docs": [{ "ref": "tbv1", "page": "14-32" }] }, { "toolcall": "19", "toolnum": "03", "toolname": "Misc Tools", "callname": "SetMouse", - "description": "Sets the mouse mode" + "description": "Sets the mouse mode", + "parameters": { + "input": [ + { "size": "word", "name": "mouseMode", "description": "Mouse mode, low-order byte only (see Toolbox Ref V1, Table 14-7)" } + ] + }, + "errors": ["none"], + "c": { "call": "extern pascal void SetMouse(mouseMode)" }, + "docs": [{ "ref": "tbv1", "page": "14-36" }] }, { "toolcall": "1A", "toolnum": "03", "toolname": "Misc Tools", "callname": "HomeMouse", - "description": "Positions the mouse at the minimum clamp position" + "description": "Positions the mouse at the minimum clamp position", + "parameters": { "none": true }, + "errors": ["none"], + "c": { "call": false }, + "docs": [{ "ref": "tbv1", "page": "14-32" }] }, { "toolcall": "1B", "toolnum": "03", "toolname": "Misc Tools", "callname": "ClearMouse", - "description": "Sets X & Y axis to $0000 if min clamps are negative or to the min clamp pos if positive" + "description": "Sets X & Y axis to $0000 if min clamps are negative or to the min clamp pos if positive", + "parameters": { "none": true }, + "errors": ["none"], + "c": { "call": "extern pascal void ClearMouse()" }, + "docs": [{ "ref": "tbv1", "page": "14-31" }] }, { "toolcall": "1C", "toolnum": "03", "toolname": "Misc Tools", "callname": "ClampMouse", - "description": "Sets new clamp values & then sets the mouse position to the minimum clamp values" + "description": "Sets new clamp values & then sets the mouse position to the minimum clamp values", + "parameters": { + "input": [ + { "size": "word", "name": "xMinClamp", "description": "Minimum clamp value for the X axis" }, + { "size": "word", "name": "xMaxClamp", "description": "Maximum clamp value for the X axis" }, + { "size": "word", "name": "yMinClamp", "description": "Minimum clamp value for the Y axis" }, + { "size": "word", "name": "yMaxClamp", "description": "Maximum clamp value for the Y axis" } + ] + }, + "errors": ["none"], + "c": { "call": "extern pascal void ClampMouse(xMinClamp, xMaxClamp, yMinClamp, yMaxClamp)" }, + "docs": [{ "ref": "tbv1", "page": "14-30" }] }, { "toolcall": "1D", "toolnum": "03", "toolname": "Misc Tools", "callname": "GetMouseClamp", - "description": "Returns the current mouse clamp values" + "description": "Returns the current mouse clamp values", + "parameters": { + "input": [ + { "size": "word", "name": "wordspace", "description": "Space for result" }, + { "size": "word", "name": "wordspace", "description": "Space for result" }, + { "size": "word", "name": "wordspace", "description": "Space for result" }, + { "size": "word", "name": "wordspace", "description": "Space for result" } + ], + "output": [ + { "size": "word", "name": "xMinClamp", "description": "Minimum clamp value for the X axis" }, + { "size": "word", "name": "xMaxClamp", "description": "Maximum clamp value for the X axis" }, + { "size": "word", "name": "yMinClamp", "description": "Minimum clamp value for the Y axis" }, + { "size": "word", "name": "yMaxClamp", "description": "Maximum clamp value for the Y axis" } + ] + }, + "errors": ["none"], + "c": { "call": "extern pascal ClampRec GetMouseClamp()" }, + "docs": [{ "ref": "tbv1", "page": "14-31" }] }, { "toolcall": "1E", "toolnum": "03", "toolname": "Misc Tools", "callname": "PosMouse", - "description": "Positions the mouse at specified coordinates" + "description": "Positions the mouse at specified coordinates", + "parameters": { + "input": [ + { "size": "word", "name": "xPos", "description": "X axis (horizontal) position of mouse" }, + { "size": "word", "name": "yPos", "description": "Y axis (vertical) position of mouse" } + ] + }, + "errors": ["none"], + "c": { "call": "extern pascal void PosMouse(xPos,yPos)" }, + "docs": [{ "ref": "tbv1", "page": "14-33" }] }, { "toolcall": "1F", "toolnum": "03", "toolname": "Misc Tools", "callname": "ServeMouse", - "description": "Returns the mouse interrupt status" + "description": "Returns the mouse interrupt status", + "parameters": { + "input": [ + { "size": "word", "name": "wordspace", "description": "Space for result" } + ], + "output": [ + { "size": "word", "name": "intStatus", "description": "Mouse interrupt status (see Toolbox Ref Vol1 Figure 14-2)" } + ] + }, + "errors": ["none"], + "c": { "call": "extern pascal Word ServeMouse()" }, + "docs": [{ "ref": "tbv1", "page": "14-35" }] }, { "toolcall": "20", "toolnum": "03", "toolname": "Misc Tools", "callname": "GetNewID", - "description": "Creates a new user ID" + "description": "Creates a new user ID", + "parameters": { + "input": [ + { "size": "word", "name": "wordspace", "description": "Space for result" }, + { "size": "word", "name": "idTag", "description": "High-order byte = type and auxID fields; low-order byte = $0000" } + + ], + "output": [ + { "size": "word", "name": "userID", "description": "Complete user ID" } + ] + }, + "errors": ["mt0301","mt030B"], + "c": { "call": "extern pascal Word GetNewID(idTag)" }, + "docs": [ + { "ref": "tbv1", "page": "14-57" }, + { "ref": "tbv3", "page": "39-2" } + ] }, { "toolcall": "21", "toolnum": "03", "toolname": "Misc Tools", "callname": "DeleteID", - "description": "Deletes all references to a specified user ID" + "description": "Deletes all references to a specified user ID", + "parameters": { + "input": [ + { "size": "word", "name": "idTag", "description": "The type and mainID fields of the user ID to delete" } + ] + }, + "errors": ["none"], + "c": { "call": "extern pascal void DeleteID(idTag)" }, + "docs": [{ "ref": "tbv1", "page": "14-59" }] }, { "toolcall": "22", @@ -9603,7 +9699,7 @@ "mm0207": { "source": "Memory Manager", "code": "0207", "name": "idErr", "description": "Invalid user ID" }, "mm0208": { "source": "Memory Manager", "code": "0208", "name": "attrErr", "description": "Illegal operation for the specified attributes" }, - "mt0301": { "source": "Miscellaneous Tool Set", "code": "0301", "name": "FIXME?????", "description":"Bad input parameter" }, + "mt0301": { "source": "Miscellaneous Tool Set", "code": "0301", "name": "badInputErr", "description":"Bad input parameter" }, "mt0302": { "source": "Miscellaneous Tool Set", "code": "0302", "name": "noDevParamErr", "description": "device for the input parameter" }, "mt0303": { "source": "Miscellaneous Tool Set", "code": "0303", "name": "taskInstlErr", "description": "Specified task already in heartbeat queue" }, "mt0304": { "source": "Miscellaneous Tool Set", "code": "0304", "name": "noSigTaskErr ", "description": "No signature detected in the task header" },