29.12.2012 Views

The Programmer's Guide to TRSDOS Version 6 - Tim Mann's Home ...

The Programmer's Guide to TRSDOS Version 6 - Tim Mann's Home ...

The Programmer's Guide to TRSDOS Version 6 - Tim Mann's Home ...

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

Exit:<br />

A Error return code, if any.<br />

Z Set if the operation was successful.<br />

7.6.87 @TIME SVC-19<br />

This SVC will return the time of day in display format (HH:MM:SS). It also will recover a<br />

pointer <strong>to</strong> the binary time s<strong>to</strong>rage which may be useful for those implementing hardware<br />

clocks.<br />

Registers Affected: AF, BC, DE.<br />

Entry:<br />

HL A pointer <strong>to</strong> the 8-character buffer <strong>to</strong> receive the time string.<br />

Exit:<br />

DE Returns a pointer <strong>to</strong> the binary time s<strong>to</strong>rage, TIME$. <strong>The</strong> 3-byte region<br />

contains seconds, minutes, and hours. TIME$-1 s<strong>to</strong>res the 30 Hertz rate<br />

system timer.<br />

7.6.88 @VDCTL SVC-15<br />

This SVC performs various video control functions depending on the function code passed<br />

in register B. It is very useful for handling direct video access. <strong>The</strong> functions are as<br />

follows:<br />

VIDEO "PEEK"<br />

Registers Affected: AF, BC, DE.<br />

Entry:<br />

B 1; Gets the character at the position identified by HL.<br />

HL Contains the row (0-23) in register H, and column (0-79) in L.<br />

Exit:<br />

A Will be returned with the character at "HL".<br />

Z Set if the operation was successful.<br />

VIDEO "POKE"<br />

Registers Affected: AF, BC, DE.<br />

Entry:<br />

B 2; Puts the character at the position identified by HL.<br />

HL Contains the row (0-23) in register H, and column (0-79) in L.<br />

C Contains the character <strong>to</strong> put at "HL".<br />

Exit:<br />

Z Set if the operation was successful.<br />

SET CURSOR POSITION<br />

Registers Affected: AF, B, DE.<br />

Entry:<br />

B 3; Moves the cursor <strong>to</strong> the position identified by HL.<br />

7-40

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!