findsm-0.1
------------

---

'findsm' allows to find screenmode in the system, it is not just another
toy that has been written to annoy ppl, it is incredibly useful when
making "intelligent" startups.

---

NOTES:

Requires 68020(no FPU)+, OS 2.04, 4096+ bytes of memory

By default proggy returns last screenmode on the list.

Program returns 'FFFFFFFF' and $RC = 5 if screenmode wasnt found.

If you use 'bootcontrol' then 'DblNTSC' will be doubled, if you dont
like that use '0x0000FFFF-0xFFFFFFFF' as a [range] string.

---

HELP:

 *** template: findsm [modeid=res] [range] [dec/s] [names/s] [count/s]

             [modeid=res]  -  decimal or hexadecimal screenmode id,
                              or desired resolution(xXy, 640X480) -
                              when 0xFFFFFFFF or no arg is passed will 
                              return last screenmode on the list
                              (in case of resolution it is important
                               to specify both parameters and 'X' must
                               be upper case, you may also use [range])

                  [range]  -  decimal or hexadecimal range values, like
                              0x000AFFFF-0xFFFFFFFF - this will search 
                              in graphics board modes most probably
                              (it is important to specify both params)

                  [dec/s]  -  outputs value in decimal rather than hex.

                [names/s]  -  dumps names of all loaded drivers, you
                              may use [range] with this switch

                [count/s]  -  [names/s] companion, will output number
                              of entries instead of names

---

EXAMPLES:

   ; check for screenmode, standard
   FAILAT 21
   findsm >NIL: 0x00099004
   IF warn
     ECHO "error, screenmode not found!"
   ELSE
     ECHO "all okay!"
   ENDIF

   ; check for screenmode by comparing
   ; (the advantage over the first method is that you wont
   ;  see any error message, even if command does not exist,
   ;  so perhaps more 'startup-sequence' friendly)
   FAILAT 21
   IF "`findsm 0x00099004`" not eq "00099004"
     ECHO "error, screenmode not found!"
   ELSE
     ECHO "all okay!"
   ENDIF

   ; check if 'monitor-driver' actually works
   FAILAT 21
   SET lastmonstate `findsm names count`
   SET driverrun `monitor-driver`
   IF "`findsm names count`" eq "$lastmonstate"
     ECHO "error, driver doesnt work!"
   ELSE
     ECHO "driver initialised."
   ENDIF

   ; check for nearest 640x480 res. in nat. screenmodes only
   findsm 640X480 0x0-0xAFFFF

   ; check for overscanned 704x480 res. in nat. screenmodes only
   findsm 704X480 0x0-0xAFFFF

   ; check for nearest 640x480 res. in graphics board(s) modes
   findsm 640X480 0xAFFFF-0xFFFFFFFF

---
megacz@usa.com

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                  998    1360  73.4% -lh5- 77ac Mar 21 17:43 findsm-0.1/findsm
[generic]                 1996    7048  28.3% -lh5- 9dc3 Mar 21 17:29 findsm-0.1/findsm.c
[generic]                 1139    2829  40.3% -lh5- 580d Mar 25 23:02 findsm-0.1/findsm.readme
[generic]                  286     487  58.7% -lh5- 85fe Mar 21 03:32 findsm-0.1/SMakefile
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total         4 files    4419   11724  37.7%            Mar 26 10:58