Locate OS

Synopsis

Header: fxcg/display.h
Syscall index: 0x1863
Function signature: int locate_OS(int x, int y)

Sets the cursor position for Print_OS.

Parameters

• x Must be in range of [1,21]
• y Must be in range of [1,8]
  

Returns

0 on failure, 1 on success.

Comments

This function does bounds checking; if x or y are out of range, it does nothing, otherwise, it calls Cursor_SetPosition. As the latter function also does bounds checking, it is best to use it directly in order to avoid duplicate checks, achieving better performance.

locate_OS:
	mov     #1, r2
	cmp/ge  r2, r4          ! Is r4 >= 1? If so set T=1
	bf      locate_OS_exit  ! If R4 is less than one do not set the cursor position
	mov     #21, r6
	cmp/gt  r6, r4
	bt      locate_OS_exit  ! Don't set the cursor position if x>21
	cmp/ge  r2, r5
	bf      locate_OS_exit  ! Don't set the cursor position if y<1
	mov     #8, r2
	cmp/gt  r2, r5
	bt      locate_OS_exit  ! Don't set the cursor position if y>8
	mov.l   #Cursor_SetPosition, r2
	add     #-1, r5
	jmp     @r2 ! Cursor_SetPosition
	add     #-1, r4
! ---------------------------------------------------------------------------

locate_OS_exit:
	rts
	nop
! End of function locate_OS