API of lcdbioslibmanu(c)



screen      ...  LCD/screen mode setting for graphics 

***** Format *****
        int   screen( mode ) {}

***** Parameter *****
        int  mode ;  0:LCD mode setting
                     1:Graphics mode setting

***** Return value *****
        int  ret ;   0: Normal
                    -1: Parameter error

***** Feature description *****
 Specify a display screen mode.  For more information about LCD mode and graphics mode, refer to "LCD-BIOS screen mode".
 Since the previous settings in this mode and the display contents are kept even if this function is executed, you need to clear the screen by using an appliction.

***** Information *****
 Filer display uses the area of the graphics mode coordinate (0,0)~ (101,63).


***** LCD-BIOS data table format *****
           b15                        b0
           +--------------------------+
           |             0            |      Feature number
           |--------------------------|
           |           mode           |      Mode
           +--------------------------+



Lib-Index   API-Index

getscreen   ...  Acquire the current screen mode. 

***** Format *****
        int   getscreen( void ) {}

***** Parameter *****
        None

***** Return value *****
        int  ret ;  0: LCD mode
                    1: Graphics mode

***** Feature description *****
 Return the screen mode set by screen function.  Since the screen mode set by screen function is kept in the management information table, this value is returned.


***** LCD-BIOS data table format *****
           b15                        b0
           +--------------------------+
           |             1            |       Feature number
           +--------------------------+



Lib-Index   API-Index

cls         ...  LCD panel/Clear GVRAM 

***** Format *****
        int   cls( mode ) {}

***** Parameter *****
        int  mode ;   b0: 1=Clear the work screen
                      b2: 1=Clear GVRAM

***** Return value *****
        int  ret ;  0: Terminate normally
                   -1: Parameter error

***** Feature description *****
 Clear the work screen/GVRAM by using mode parameter.
 If you specify to clear the work screen, 0 clear the entire work screen and redraw the physical LCD screen.
 The clear of GVRAM conducts 0 clear of the entire GVRAM and redraw of the physical LCD screen.


***** LCD-BIOS data table format *****
           b15                        b0
           +--------------------------+
           |             2            |        Feature number
           |--------------------------|
           |           mode           |        Mode
           +--------------------------+



Lib-Index   API-Index

lcdon       ...  LCD driver embed power ON/OFF control 

***** Format *****
        int   lcdon( power ) {}

***** Parameter *****
        int  power ;  0:Setting of the embed power OFF&Power saving
                      1:Canceling of the embed power ON&Power saving

***** Return value *****
        int  ret ;  0: Normal
                   -1: Parameter error

***** Feature description *****
 If power=0:  execute the power saving sequence of LCD driver
 If power=1:  execute the power saving canceling sequence of LCD driver

  No process is taken to the internal screen.


***** LCD-BIOS data table format *****
           b15                        b0
           +--------------------------+
           |             3            |        Feature number
           |--------------------------|
           |           power          |        Power mode
           +--------------------------+



Lib-Index   API-Index

getlcdon    ...  Acquire the current LCD driver embed power control condition 

***** Format *****
        int   getlcdon( void ) {}

***** Parameter *****
        None

***** Return value *****
        int  ret ;  0: Setting of the embed power OFF&Power saving
                    1: Canceling of the embed power ON&Power saving

***** Feature description *****
 Return the LCD driver embed power control condition by lcdon function.


***** LCD-BIOS data table format *****
           b15                        b0
           +--------------------------+
           |             4            |        Feature number
           +--------------------------+



Lib-Index   API-Index

mpread      ...  Read the contents of mono map format file into SRAM 

***** Format *****
        int   mpread( buf, name ) {}

***** Parameter *****
        char *buf  ;  Liner memory (SRAM) address
        char *name ;  Mono map format file name

***** Return value *****
        int  ret ;  0: Terminate normally
                   -1: Error

***** Feature description *****
 Read the specified mono map format file in the flash memory to the data array specified by buf.
 This data array is stored as the mono map format (width dot, height dot and image data of graphics pattern).

           b15                        b0
           +--------------------------+
           |          X width         |      Width dot of image data
           |--------------------------|
           |          Y width         |      Height dot of image data
           |--------------------------|
           |                          |
           |                          |
           |     Image data           |
           |                          |
           |                          |
           +--------------------------+

 The data that is read can be used by gv_put or lc_put function.

 Since there is the system limitation that this function does not allow the file I/O from the internal of BIOS, it is handled within the user provided library.  It is handled by the flash memory file I/O functions such as dos_open, dos_read and dos_close.

 *For information about mono map format, refer to Mono map store format in .



Lib-Index   API-Index

mojisize    ...  Acquisition of character width dot, character height dot and liner address 

***** Format *****
        struct moji  *mojisize( s_code ) {}

***** Parameter *****
        unsigned short    s_code ; Font code

***** Return value *****
        struct moji       *minf ; Character information table address
                                        (0 is returned when an error occurs)

***** Feature description *****
 Set the character width, height and liner address of the specified character (font code) to the internal character information table area and return its address.



        struct moji {
                int        w ;     /*Character width dot  */
                int        h ;     /*Character height dott*/
                long     add ;     /*Liner address  */
        } ;

 Since the character width and height information is not included in its font data that correspond to the specified character code, there is the character width and height information table that correspond to the font type in the internal LCD-BIOS.
 Therefore, you need to examine the font type for the specified character, then acquire the dot for each character by searching the type number in the character width and height internal information table.
 The liner address can be calculated by a character code.
 Since only one character information table in LCD-BIOS is returned by this function, if you use mojisize function again, the contents have been changed.
 When you need to use this again, copy this to the internal buffer of the application.


***** LCD-BIOS data table format *****
           b15                        b0
           +--------------------------+
           |             6            |        Feature number
           |--------------------------|
           |          s_code          |        SII shift JIS code
           +--------------------------+

 *For information about font codes, refer to SII code in .



Lib-Index   API-Index

getbufsize/pgetbufsize   ...   Acquire the required byte for graphic pattern on LCD

***** Format *****
        int   getbufsize( x1, y1, x2, y2 ) {}

        int   pgetbufsize( RECT *rct ) {}

      typedef struct {
            int    x1 ;
            int    y1 ;
            int    x2 ;
            int    y2 ;
        } RECT ;

***** Parameter *****
        int  x1, y1 ; Left upper corner of the byte calculation area by LCD coordinate (x,y)
        int  x2, y2 ; Right bottom corner of the byte calculation area by LCD coordinate (x,y)

***** Return value *****
        int  ret ;  The required byte for graphic pattern

***** Feature description *****
 Return the byte of the required data array in order to display the graphic pattern on the area of LCD coordinate (x1,y1)-(x2,y2)(the size calculation of mono map format)

 The required byte is calculated by the following formula.

                  X width = abs((x2-x1)+1)
                  Y width = abs((y2-y1)+1)
                  Image data size = ((Y width+7)/8)*X width byte
                  Information area size   = 4 byte

                The required byte =  Image data size  +  Information area size


***** LCD-BIOS data table format *****
           b15                        b0
           +--------------------------+
           |             7            |       Feature number
           |--------------------------|
           |            x1            |       Left upper corner X coordinate
           |--------------------------|
           |            y1            |       Left upper corner Y coordinate
           |--------------------------|
           |            x2            |       Right bottom corner X coordinate
           |--------------------------|
           |            y2            |       Right bottom corner Y coordinate
           +--------------------------+

 *For information about mono map format, refer to Mono map store format in .



Lib-Index   API-Index

reverse/preverse    ...  Reverse specification of LCD specified area 

***** Format *****
        int   reverse( x1, y1, x2, y2 ) {}

        int   preverse( RECT *rct ) {}

      typedef struct {
            int    x1 ;
            int    y1 ;
            int    x2 ;
            int    y2 ;
        } RECT ;

***** Parameter *****
        int  x1, y1 ; Specify the left upper corner of the reverse area by coordinate (x,y) on LCD panel that the left upper corner is specified at (0,0).
        int  x2, y2 ; Specify the right bottom corner by LCD coordinate (x,y).

***** Return value *****
        int   ret ;     Other than -1: Reverse area number (0~ 15)
                                   -1: Parameter error

***** Feature description *****
 Specify the specified area (x1,y1)-(x2,y2) on the physical LCD screen to Black/White reverse status.  Up to 16 places of the reverse area can be specified by this function.
 This function reverses the display contents on the physical LCD screen regardless of the LCD mode/Graphics mode.  It does not reverse the contents on the internal screen.

    Example
        int r0,r1,r2;
         :
        r0=reverse(...); /* r0 */
        r1=reverse(...); /* r1 */
        revstop(r1);     /* r1 is stopped temporarily */
        r2=reverse(...); /* r2 */
        revdraw();       /* Reverse and draw only for reverse drawing r0,r2 */
        revstart(r1);    /* r1 resume */
        revdraw();       /* Reverse drawing r0,r1,r2 */
         :


***** LCD-BIOS data table format *****
           b15                        b0
           +--------------------------+
           |             8            |      Feature number
           |--------------------------|
           |            x1            |      Left upper corner X coordinate
           |--------------------------|
           |            y1            |      Left upper corner Y coordinate
           |--------------------------|
           |            x2            |      Right bottom corner X coordinate
           |--------------------------|
           |            y2            |      Right bottom corner Y coordinate
           +--------------------------+



Lib-Index   API-Index

revstart    ...  Resume the reverse feature of the temporary stopped reverse area by using revstop function 

***** Format *****
        int   revstart( no ) {}

***** Parameter *****
        int  no ;  Reverse area number (the number returned by reverse function)

***** Return value *****
        int  ret ;    0: Terminate normally
                     -1: Parameter error

***** Feature description *****
 Resume the blink of reverse feature area of the temporary stopped by using revstop function 


***** LCD-BIOS data table format *****
           b15                        b0
           +--------------------------+
           |             9            |       Feature number
           |--------------------------|
           |            no            |       Reverse area number
           +--------------------------+



Lib-Index   API-Index

revstop     ...  Temporary reverse stop of the reverse area specified by reverse function 

***** Format *****
        int   revstop( no ) {}

***** Parameter *****
        int  no ;  Reverse area number (the number returned by reverse function)

***** Return value *****
        int  ret ;    0: Terminate normally
                     -1: Parameter error

***** Feature description *****
 Stop the reverse of the reverse area temporarily by specifying reverse function.
 The reverse feature of the temporary stopped reverse area can be resumed by using revstart function.


***** LCD-BIOS data table format *****
           b15                        b0
           +--------------------------+
           |            10            |       Feature number
           |--------------------------|
           |            no            |       Reverse area number
           +--------------------------+



Lib-Index   API-Index

revend      ...  Terminate the reverse feature of the reverse area specified by reverse function 

***** Format *****
        int   revend( no ) {}

***** Parameter *****
        int  no ;  Reverse area number (the number returned by reverse function)

***** Return value *****
        int  ret ;    0: Terminate normally
                     -1: Parameter error

***** Feature description *****
 Terminate the reverse feature of the reverse area specified by reverse function.
 The reverse area number that the reverse feature is terminated is internally managed by an empty number.  If reverse function is executed again, this number is used again.


***** LCD-BIOS data table format *****
           b15                        b0
           +--------------------------+
           |            11            |       Feature number
           |--------------------------|
           |            no            |       Reberse area number
           +--------------------------+



Lib-Index   API-Index

revdraw     ...  Redraw the all reverse area specified by reverse function. 

***** Format *****
        int   revdraw( void ) {}

***** Parameter *****
        None

***** Return value *****
        int  ret ;    0: Terminate normally
                     -1: No reverse area

***** Feature description *****
 Redraw the reverse of all reverse area specified by reverse function.
 Since reverse function reverses the internal screen contents and transfers it to the physical LCD screen, the reverse feature may be functioned correctly if you add a character table in the reverse area or clear the screen.
 Revdraw is used such conditions.  If you execture this function, all reverse area are redrawn.  Therefore, you can obtain the original normal display screen.


***** LCD-BIOS data table format *****
           b15                        b0
           +--------------------------+
           |            12            |        Feature number
           |--------------------------|
           |            no            |        Reverse area number
           +--------------------------+



Lib-Index   API-Index

blink/pblink    ...  Blink specification of LCD specified area. 

***** Format *****
        int   blink( x1, y1, x2, y2, color ) {}

        int   pblink( BLINK_DRAW *blk ) {}

        typedef struct {
            RECT    rect ;
            int    color ;
         } BLINK_DRAW ;

         typedef struct {
            int    x1 ;
            int    y1 ;
            int    x2 ;
            int    y2 ;
         } RECT ;

***** Parameter *****
        int  x1, y1 ; Specify the left upper corner of the blink area by coordinate (x,y) on LCD panel that the left upper corner is specified at (0,0).
        int  x2, y2 ; Specify the right bottom corner of blink area by LCD coordinate (x,y)
        int  color  ; Blink method specification

***** Return value *****
        int   ret ;  Other than -1: Blink area number (0~ 15)
                                -1: Parameter error

***** Feature description *****
 Blink the specified area (x1,y1)-(x2,y2) on the physical LCD screen as the Blink Type/Period shown in color.  Up to 16 places of the blink area can be specified by this function.
 This function blinks the display contents on the physical LCD screen regardless of the LCD mode/Graphics mode.

  The details of a parameter color is as follows.

              b15 b14 b13 b12 b11 b10  b9  b8  b7  b6  b5  b4  b3  b2  b1  b0
             +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
             |   |   |   |   |   |   |   |   |   |   |   |   |   |   |   |   |
             +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
              |-----------------------------| |-----| |-----|     |---------| 
                            |                    |       |             |
                            |                    |       |   color specification
                            |                    |     blink
                            |               blink period
                        additional

              b0~ b2  color specification (not supported)
                            0:Black   1:Blue   2:Green   3:Sky blue
                            4:Red   5:Purple   6:Yellw  7:White
              b4~ b5  Blink specification
                            0:No blink
                            1:Black/White reverse blink
                            2:ON/OFF blink
                            3:Not used
              b6~ b7  Blink cycle
                            0:1/2Hz(1.5 second ON,0.5 second OFF)
                            1:  1Hz(0.5 second ON,0.5 second OFF)
                            2:  2Hz(0.25 second ON,0.25 second OFF)


***** LCD-BIOS data table format *****
           b15                        b0
           +--------------------------+
           |            13            |        Feature number
           |--------------------------|
           |            x1            |        Left upper corner X coordinate
           |--------------------------|
           |            y1            |        Left upper corner Y coordinate
           |--------------------------|
           |            x2            |        Right bottom corner X coordinate
           |--------------------------|
           |            y2            |        Right bottom corner Y coordinate
           |--------------------------|
           |          color           |        Blink method specification
           +--------------------------+



Lib-Index   API-Index

blstop      ...  Temporarily stop blinking of the blink area specified by blink function. 

***** Format *****
        int   blstop( no ) {}

***** Parameter *****
        int  no ;  Blink area number (the number returned by blink function)

***** Return value *****
        int  ret ;   0: Terminate normally
                    -1: Parameter error

***** Feature description *****
 Stop the blink of the blink area temporarily by specifying blink function.
 The blink feature of the temporary stopped blink area can be resumed by using blstart function.


***** LCD-BIOS data table format *****
           b15                        b0
           +--------------------------+
           |            14            |        Feature number
           |--------------------------|
           |            no            |        Blink area number
           +--------------------------+



Lib-Index   API-Index

blstart     ...  Resume blinking of blink area that is stopped temporarily by blstop function. 

***** Format *****
        int   blstart( no ) {}

***** Parameter *****
        int  no ;  Blink area number (the number returned by blink function)

***** Return value *****
        int  ret ;    0: Terminate normally 
                     -1: Parameter error

***** Feature description *****
 Resume blinking of blink area that is stopped temporarily by blstop function.


***** LCD-BIOS data table format *****

           b15                        b0
           +--------------------------+
           |            15            |        Feature number
           |--------------------------|
           |            no            |        Blink area number
           +--------------------------+



Lib-Index   API-Index

blend       ...  Terminate blinking of blink area specified by blink function. 

***** Format *****
        int   blend( no ) {}

***** Parameter *****
        int  no ;  Blink area number (the number returned by blink function)

***** Return value *****
        int  ret ;  0: Terminate normally 
                   -1: Parameter error 

***** Feature description *****
 Terminate blinking of blink area specified by blink function.  The blink area number that the blink feature is terminated is internally managed by an empty number.  If blink function is executed again, this number is used again.


***** LCD-BIOS data table format *****

           b15                        b0
           +--------------------------+
           |            16            |        Feature number
           |--------------------------|
           |            no            |        Blink area number
           +--------------------------+



Lib-Index   API-Index

lcdfreeze       ...  Freeze/Freeze Cancel of the physical LCD screen 

***** Format *****
        int   lcdfreeze( mode ) {}

***** Parameter *****
        int  mode ;  0: Screen Freeze Cancel
                     1: Screen Freeze

***** Return value *****
        int  ret ;     0: Terminate normally 
                      -1: Error

***** Feature description *****
 The screen freeze is the condition that the transfer (display) to the physical LCD screen is not done when any drawing is executed to the internal screen (Work screen and GVRAM).

 Since a drawing is done to the internal screen only during the screen freeze, no display change is made on the physical LCD screen.  In addition, the screen blink is intermitted during the freeze state.

 When you cancel the screen freeze, the transfer is executed to the physical LCD screen according to the current mode.  Therefore, the drawing during the screen freeze state is reflected to the physical LCD screen.

 This feature is useful when you want to display consecutive screens.  By using the screen freeze and screen freeze cancel before and after the drawing and redrawing functions, you can execute these functions smoothly.

     

    +--------------+         +----------+         +--------+ 3 times +--------------+ 
    |              | Drawing |          | Overlap |        | Transfer|              |
    |  gv_kput()   |   -->   |          |   -->   |        |   -->   |              |
    |  gv_kput()   |   -->   | Internal |   -->   |  Work  |   -->   | Physical LCD |
    |  gv_kput()   |   -->   |  screen  |   -->   | screen |   -->   |  screen      |
    |              |         |          |         |        |         |              |
    +--------------+         +----------+         +--------+         +--------------+ 

     

    +--------------+         +----------+         +--------+         +-------------+ 
    | lcdfreeze(1) | Drawing |          | Overlap |        | 1 time  |             |
    | gv_kput()    |   -->   |          |   -->   |        | Transfer|             |
    | gv_kput()    |   -->   | Internal |   -->   |  Work  |         | Pysical LCD |
    | gv_kput()    |   -->   |  screen  |   -->   | screen |         |  screen     |
    | lcdfreeze(0) |         |          |         |        |   -->   |             |
    +--------------+         +----------+         +--------+         +-------------+ 


***** LCD-BIOS data table format *****

           b15                        b0
           +--------------------------+
           |            17            |       Feature number
           |--------------------------|
           |           mode           |       Freeze/Freeze Chancel 
           +--------------------------+



Lib-Index   API-Index

lcdvol      ...  LCD electrical volume amount setting 

***** Format *****
        int   lcdvol( vol ) {}

***** Parameter *****
        int  vol ;   LCD electrical volume amount (0~ 31)

***** Return value *****
        int  ret ;   0: Terminate normally 
                    -1: Error

***** Feature description *****
 Set the electrical volume amount that controls the light and shade of the entire LCD screen.
The setting rage is 0 (light) - 31 (shade).


***** LCD-BIOS data table format *****

           b15                        b0
           +--------------------------+
           |            18            |       Feature number
           |--------------------------|
           |            vol           |       Electrical volume amount
           +--------------------------+



Lib-Index   API-Index

getlcdvol       ...  Acquisition of LCD electrical volume amount 

***** Format *****
        int   getlcdvol( void ) {}

***** Parameter *****
        None

***** Return value *****
        int  ret ;  Current electrical volume amount (0~ 31)

***** Feature description *****
 Acquire the current setting value that controls the light and shade of the entire LCD screen.  The setting rage is 0 (light) - 31 (shade).

***** LCD-BIOS data table format *****

           b15                        b0
           +--------------------------+
           |            19            |       Feature number
           +--------------------------+



Lib-Index   API-Index

gv_place/pv_place   ...  Correspond the left upper margin of the physical LCD panel to the GVRAM coordinate. 

***** Format *****
        int   gv_place( x, y ) {}

        int   pv_place( POINT *ppt ) {}

        typedef struct {
            int    x ;
            int    y ;
        } POINT ;

***** Parameter *****
        int  x, y ; GVRAM coordinate (x,y) that the left upper corner is specified at (0,0).

***** Return value *****
        int  ret ;   0: Terminate normally
                    -1: Parameter error 

***** Feature description *****
 Correspond the left upper corner of the physical LCD panel (LCD coordinate (0,0)) to (W)320 x (H)240 dot GVRAM space coordinate (x,y).
 This function only changes the correspondence between GVRAM screen and LCD screen.  Although the contents of GVRAM is not changed, the display on the physical LCD screen is changed because the correspondence condition is altered.

         Physical LCD screen
        +--------------+
        |   /\  /      |
        |  /  \/  /    |       (0,0)            GVRAM
        | /      /     |         +---------------------------------------+
        +--------------+         |             /                         |
                                 |   +--------/-----+                    |
                                 |   |   /\  /      |                    |
                                 |   |  /  \/  /    |                    |
                                 |   | /      /     |                    |
                                 |   +/------/------+                    |
                                 |   /      /                            |
                                 |         /                             |
                                 +---------------------------------------+
                                                                     (319,239)


***** LCD-BIOS data table format *****
           b15                        b0
           +--------------------------+
           |            60            |        Feature number
           |--------------------------|
           |             x            |        GVRAM screen X coordinate
           |--------------------------|
           |             y            |        GVRAM screen Y coordinate
           +--------------------------+



Lib-Index   API-Index

gv_kput/pv_kput     ...  Draw the specified string on GVRAM screen as the specified size and character interval. 

***** Format *****
        int   gv_kput( x, y, str, font, gap, lop ) {}

        int   pv_kput( KANJI_PUT *kpt) {}

        typedef struct {
            POINT  pos ;
            char   *str ;
            int    font ;
            int    gap ;
            int    lop ;
        } KANJI_PUT ;

      typedef struct {
        int    x ;
        int    y ;
      } POINT ;

***** Parameter *****
        int  x, y ; Specify the left upper corner of the drawing string by GVRAM coordinate (x,y) that the left upper corner of GVRAM is specified at (0,0).
        char *str ; Drawing string
        int  font ; Drawing character size.  Refer to the following character size table.
        int  gap  ; Drawing character interval dot
        int  lop  ; Logical operation specification

***** Return value *****
        int   ret ;   0: Normal
                     -1: Parameter error

***** Feature description *****
 Display the specification string to GVRAM screen coordinate (x,y) as the specified size and character interval.
 Parameter font specifies the drawing character size.  However, if a character that cannot display the specified font in the drawing string is included, that character is not displayed on the screen.

  The following is a list of font code (font) that specifies the drawing character size.

+----------+----------------+----------------------------------+ 
|   font   | Character size |        Contents                  |
|----------+----------------+----------------------------------|
|     0    |     6 x 12     | ASCII                            |
|----------+----------------+----------------------------------|
|     1    |     6 x 12     | ASCII                            |
|----------+----------------+----------------------------------|
|     2    |     6 x 10     | ASCII                            |
+----------+----------------+----------------------------------+ 


+----------+----------------+----------------------------------+ 
|   font   | Character size |        Contents                  |
|----------+----------------+----------------------------------|
|     5    | Variable x 12  | Proportional ASCII               |
|----------+----------------+----------------------------------|
|     6    | Variable x 10  | Proportional ASCII               |
|----------+----------------+----------------------------------|
|     7    | Variable x  8  | Proportional ASCII               |
|----------+----------------+----------------------------------|
|     8    |     3 x 5      | SCOSII(Standard Code Of SII)     |
|----------+----------------+----------------------------------|
|     9    |     3 x 7      | SCOSII                           |
|----------+----------------+----------------------------------|
|    10    |     3 x 9      | SCOSII                           |
|----------+----------------+----------------------------------|
|    11    |     4 x 9      | SCOSII Standard                  |
|----------+----------------+----------------------------------|
|    12    |     5 x 7      | SCOSII                           |
|----------+----------------+----------------------------------|
|    13    |     Empty      |                                  |
|----------+----------------+----------------------------------|
| 14 ~  15 |    Not used    |                                  |
|----------+----------------+----------------------------------|
|    16    |     5 x 9(A)   | SCOSII A type                    |
|----------+----------------+----------------------------------|
|    17    |     5 x 9(B)   | SCOSII B type standard           |
|----------+----------------+----------------------------------|
|    18    |      Empty     |                                  |
|----------+----------------+----------------------------------|
|    19    |     5 x 10     | SCOSII standard                  |
|----------+----------------+----------------------------------|
|    20    |     6 x 11     | SCOSII Digital                   |
|----------+----------------+----------------------------------|
|    21    |     Empty      |                                  |
|----------+----------------+----------------------------------|
| 22 ~  23 |    Not used    |                                  |
|----------+----------------+----------------------------------|
|    24    |    6 x 13(A)   | SCOSII Stop watch type (light)   |
|----------+----------------+----------------------------------|
|    25    |    6 x 13(B)   | SCOSII Stop watch type (heavy)   |
|----------+----------------+----------------------------------|
|    26    |    6 x 13(C))  | SCOSII Digital                   |
|----------+----------------+----------------------------------|
| 27 ~  29 |      Empty     |                                  |
|----------+----------------+----------------------------------|
| 30 ~  31 |    Not used    |                                  |
|----------+----------------+----------------------------------|
|    32    |    7 x 13(A)   | SCOSII Stop watch type           |
|----------+----------------+----------------------------------|
|    33    |    7 x 13(B)   | SCOSII Digital                   |
|----------+----------------+----------------------------------|
| 34 ~  37 |      Empty     |                                  |
|----------+----------------+----------------------------------|
| 38 ~  39 |    Not used    |                                  |
|----------+----------------+----------------------------------|
|    40    |    9 x 16(A)   | SCOSII Standard (AM,PM excluded) |
|----------+----------------+----------------------------------|
|    41    |    9 x 16(B)   | SCOSII Script type               |
|----------+----------------+----------------------------------|
| 42 ~  45 |      Empty     |                                  |
|----------+----------------+----------------------------------|
| 46 ~  47 |   Not used     |                                  |
|----------+----------------+----------------------------------|
|    48    |   11 x 17(A)   | SCOSII Stop watch type           |
|----------+----------------+----------------------------------|
|    49    |   11 x 17(B)   | SCOSII                           |
|----------+----------------+----------------------------------|
|    50    |   11 x 17(C)   | SCOSII Digital                   |
|----------+----------------+----------------------------------|
| 51 ~  53 |      Empty     |                                  |
|----------+----------------+----------------------------------|
| 54 ~  55 |    Not used    |                                  |
|----------+----------------+----------------------------------|
|    56    |   13 x 19(A)   | SCOSII                           |
|----------+----------------+----------------------------------|
|    57    |   13 x 19(B)   | SCOSII                           |
|----------+----------------+----------------------------------|
|    58    |   13 x 19(C)   | SCOSII                           |
|----------+----------------+----------------------------------|
|    59    |   13 x 19(D)   | SCOSII                           |
|----------+----------------+----------------------------------|
|    60    |   13 x 24      | SCOSII  watch.exf                |
+----------+----------------+----------------------------------+ 




SCOSII(Standard Code Of SII) List

+-----------+---------+-----------+---------+-----------+---------+-----------+---------+
|SCOSII code|Character|SCOSII code|Character|SCOSII code|Character|SCOSII code|Character|
|-----------+---------+-----------+---------+-----------+---------+-----------+---------|
|    30h    |    0    |    34h    |    4    |    38h    |    8    |    3Ch    |    A    |
|-----------+---------+-----------+---------+-----------+---------+-----------+---------|
|    31h    |    1    |    35h    |    5    |    39h    |    9    |    3Dh    |    M    |
|-----------+---------+-----------+---------+-----------+---------+-----------+---------|
|    32h    |    2    |    36h    |    6    |    3Ah    |    :    |    3Eh    |    P    |
|-----------+---------+-----------+---------+-----------+---------+-----------+---------|
|    33h    |    3    |    37h    |    7    |    3Bh    |    -    |    3Fh    |  space  |
+-----------+---------+-----------+---------+-----------+---------+-----------+---------+
  SCOSII code: Standard Code Of SII


 Logical operator font specifies the method of logical operation by b0-b1.

              b15 b14 b13 b12 b11 b10  b9  b8  b7  b6  b5  b4  b3  b2  b1  b0
             +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
             |   |   |   |   |   |   |   |   |   |   |   |   |   |   |   |   |
             +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
                                                                      |-----|
                                                             Operation specification
            b0    0:Overwrite  1:OR Write
            b1    0:No reverse 1:Reverse




***** LCD-BIOS data table format *****
           b15                        b0
           +--------------------------+
           |            61            |        Feature number     
           |--------------------------|
           |             x            |        GVRAM screen X coordinate
           |--------------------------|
           |             y            |        GVRAM screen Y coordinate
           |--------------------------|
           |                          |
           |--         *str         --|        Drawing string buffer address
           |                          |
           |--------------------------|
           |           font           |        Size code
           |--------------------------|
           |           dot            |        Character interval dot
           |--------------------------|
           |           lop            |        Logical operation
           +--------------------------+



Lib-Index   API-Index

gv_sput/pv_sput     ...  Draw SII image character on GVRAM screen coordinate. 

***** Format *****
        int   gv_sput( x, y, code, lop) {}

        int   pv_sput( SIICODE_PUT *spt) {}

        typedef struct {
            POINT          pos ;
            unisgned short code ;
            int            lop ;
        } SIICODE_PUT ;

        typedef struct {
            int    x ;
            int    y ;
        } POINT ;

***** Parameter *****
        int   x, y          ; Specify the left upper corner of the drawing string by GVRAM coordinate (x,y) that the left upper corner of GVRAM is specified at (0,0).
        unsigned short code ; SII image character code (2 byte)
        int   lop           ; Logical operation specification

***** Return value *****
        int   ret ;  0: Normal
                    -1: Parameter error

***** Feature description *****
 Draw a character that is shown by SII image character code (2 byte) on GVRAM screen coordinate (x,y).
 The character width dot, height dot and font data store address of the drawing character is calculated by searching the font information table.  Draw a character to GVRAM screen coordinate (x,y) according to these conditions.
 Logical operator lop specifies the method of logical operation by b0-b1.

              b15 b14 b13 b12 b11 b10  b9  b8  b7  b6  b5  b4  b3  b2  b1  b0
             +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
             |   |   |   |   |   |   |   |   |   |   |   |   |   |   |   |   |
             +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
                                                                      |-----|
                                                         Operation specification
            b0    0:Overwrite  1:OR Write
            b1    0:No reverse 1:Reverse


***** LCD-BIOS data table format *****
           b15                        b0
           +--------------------------+
           |            62            |        Feature number     
           |--------------------------|
           |             x            |        GVRAM screen X coordinate
           |--------------------------|
           |             y            |        GVRAM screen Y coordinate
           |--------------------------|
           |           code           |        SII code
           |--------------------------|
           |           lop            |        Logical operation
           +--------------------------+

 *For information about SII image character, refer to SII code in .



Lib-Index   API-Index

gv_aput/pv_aput ...  Draw the font data of the specified address on GVRAM screen coordinate as the specified character width dot and height dot. 

***** Format *****
        int   gv_aput( x, y, w, h, addr, lop) {}

        int   pv_aput( FONT_PUT *apt) {}

        typedef struct {
            POINT         pos ;
            int           w ;
            int           h ;
            unsigned long addr ;
            int           lop ;
        } FONT_PUT ;

        typedef struct {
            int    x ;
            int    y ;
        } POINT ;

***** Parameter *****
        int   x, y ;  Specify the left upper corner of the drawing string by GVRAM coordinate (x,y) that the left upper corner of GVRAM is specified at (0,0).
        int   w            ;  Character width dot
        int   h            ;  Character height dot
        unsigned long addr ;  Font data address (liner address)
        int   lop          ;  Logical operation specification

***** Return value *****
        int   ret ;  0: Normal
                    -1: Parameter error

***** Feature description *****
 Draw the font data that is shown by the specified address on GVRAM screen coordinate (x,y) as the specified character width dot and height dot.
 If the specified font data does not match with the character width dot and height dot, the character is not displayed correctly.

  Logical operator logic specifies the method of logical operation by b0-b1.

              b15 b14 b13 b12 b11 b10  b9  b8  b7  b6  b5  b4  b3  b2  b1  b0
             +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
             |   |   |   |   |   |   |   |   |   |   |   |   |   |   |   |   |
             +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
                                                                      |-----|
                                                         Operation specification
            b0    0:Overwrite  1:OR Write
            b1    0:No reverse 1:Reverse


***** LCD-BIOS data table format *****
           b15                        b0
           +--------------------------+
           |            63            |        Feature number     
           |--------------------------|
           |            x             |        GVRAM screen X coordinate
           |--------------------------|
           |            y             |        GVRAM screen Y coordinate
           |--------------------------|
           |            w             |        Character width dot
           |--------------------------|
           |            h             |        Character height dot
           |--------------------------|
           |                          |
           |--         addr         --|        Font data address
           |                          |
           |--------------------------|
           |           lop            |        Logical operation
           +--------------------------+



Lib-Index   API-Index

gv_mmap/pv_mmap ...  Draw the contents of mono map format file in the flash memory to GVRAM screen coordinate. 

***** Format *****
        int   gv_mmap( x, y, name, lop) {}

        int   pv_mmap( MMAP_PUT *mpt) {}

        typedef struct {
            POINT  pos ;
            char   *name ;
            int    lop ;
        } MMAP_PUT ;

        typedef struct {
            int    x ;
            int    y ;
        } POINT ;

***** Parameter *****
        int   x, y ; Specify the left upper corner of the drawing data by GVRAM coordinate (x,y) that the left upper corner of GVRAM is specified at (0,0).
        char *name ; Mono map format file name in the flash memory
        int  lop   ; Logical operation specification

***** Return value *****
        int   ret ;  0: Normal
                    -1: Parameter error

***** Feature description *****
 Draw the mono map format file in the flash memory to GVRAM screen coordinate (x,y).

  Logical operator logic specifies the method of logical operation by b0-b1.

              b15 b14 b13 b12 b11 b10  b9  b8  b7  b6  b5  b4  b3  b2  b1  b0
             +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
             |   |   |   |   |   |   |   |   |   |   |   |   |   |   |   |   |
             +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
                                                                      |-----|
                                                         Operation specification
            b0    0:Overwrite  1:OR Write
            b1    0:No reverse 1:Reverse

 Since there is the system limitation that this function does not allow the file I/O from BIOS, it is combined with mpread function which is mono map file read function and gv_aput function which is font display function, then handled within the user provided library.



Lib-Index   API-Index

gv_line/pv_line ...  Draw a straight line between two points specified on the GVRAM screen coordinate. 

***** Format *****
        int   gv_line( x1, y1, x2, y2, lop, style ) {}

        int   pv_line( LINE_DRAW *lpt) {}

        typedef struct {
            POINT  st ;
            POINT  ed ;
            int    lop ;
            unsigned char style ;
        } LINE_DRAW ;

        typedef struct {
            int    x ;
            int    y ;
        } POINT ;

***** Parameter *****

        int    x1, y1       ; Specify the start point of a straight line by GVRAM coordinate (x,y) that the left upper corner of GVRAM is specified at (0,0).
        int    x2, y2       ; Specify the end point of the straight line on the GVRAM screen coordinate (x,y).
        int    lop          ; Logical operation
        unsigned char style ; Line style

***** Return value *****
        int  ret ;    0: Terminate normally
                     -1: Parameter error

***** Feature description *****
 Draw a straight line between GVRAM screen coordinate (x1,y1)-(x2,y2) by using the specification logical operation and line style.

       (x1,y2)
            \
              \
                \
                (x2,y2)

  Logical operator lop specifies the method of logical operation by b0-b1.

              b15 b14 b13 b12 b11 b10  b9  b8  b7  b6  b5  b4  b3  b2  b1  b0
             +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
             |   |   |   |   |   |   |   |   |   |   |   |   |   |   |   |   |
             +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
                                                                      |-----|
                                                         Operation specification
            b1,b0
                    00: Overwrite  01:XOR,10:OR,11:AND

  Line style "style" represents the drawing format of the line by 8 bit.  When the bit is ON, the part of line is black and the part of OFF is white.
 Therefore, gv_line function draws a line according to this line style by 8 bit.


***** LCD-BIOS data table format *****

           b15                        b0
           +--------------------------+
           |            65            |        Feature number     
           |--------------------------|
           |            x1            |        Start point X coordinate        
           |--------------------------|
           |            y1            |        Start point Y coordinate        
           |--------------------------|
           |            x2            |        End point X coordinate        
           |--------------------------|
           |            y2            |        End point Y coordinate        
           |--------------------------|
           |            lop           |        Logical operation
           |------------+-------------|
           |      0     |   style     |        Line style
           +------------+-------------+



Lib-Index   API-Index

gv_square/pv_square ...  Draw a rectangle with two points specified on the GVRAM screen coordinate as the opposite angle. 

***** Format *****
        int   gv_square( x1, y1, x2, y2, lop, style ) {}

        int   pv_square( SQUARE_DRAW *spt) {}

        typedef struct {
            RECT  rect ;
            int   lop ;
            unsigned long style ;
        } SQUARE_DRAW ;

        typedef struct {
            int    x1 ;
            int    y1 ;
            int    x2 ;
            int    y2 ;
        } RECT ;

***** Parameter *****
        int     x1, y1       ; Specify the left upper corner of the rectangle by GVRAM coordinate (x,y) that the left upper corner of GVRAM is specified at (0,0).
        int     x2, y2       ; Specify the right bottom corner of the rectangle on the GVRAM screen coordinate (x,y)
        int     lop          ; Logical operation
        unsigned long  style ; Line style and tile pattern

***** Return value *****
        int  ret ;    0: Terminate normally
                     -1: Parameter error

***** Feature description *****
 Draw a rectangle with the GVRAM screen coordinate (x1,y1)-(x2,y2) as the opposite angle by using the specification logical operation and line style (tile pattern).

       (x1,y2)
         +--------------------------+
         |                          |
         |                          |
         |                          |
         |                          |
         +--------------------------+
                                   (x2,y2)



 Logical operator lop specifies the method of logical operation by b0-b1 and the presence of paint by b2.

              b15 b14 b13 b12 b11 b10  b9  b8  b7  b6  b5  b4  b3  b2  b1  b0
             +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
             |   |   |   |   |   |   |   |   |   |   |   |   |   |   |   |   |
             +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
                                                                  |-| |-----|
                                     presence of paint-------------+     |
                                                        Operation specification 
            b1,b0
                    00: Overwrite  01:XOR,10:OR,11:AND
            b2      0: Not paint 1: Paint

 Line style/Tile pattern "style" has different meaning depending on b2 (specification of the presence of paint) of lop.
 If you set b2=0 (Not paint), the draw format of the line is shown by the low level 8 bit of style.  When the bit is ON, the part of line is black and the part of OFF is white.
 Therefore, gv_line function draws a line according to this line style by 8 bit.
 If you set b2=1 (Paint), all bit (32 bit) of style is used as a tile pattern and the inside of the rectangle is painted.


***** LCD-BIOS data table format *****

           b15                        b0
           +--------------------------+
           |            66            |        Feature number
           |--------------------------|
           |            x1            |        Left upper corner X coordinate
           |--------------------------|
           |            y1            |        Left upper corner Y coordinate
           |--------------------------|
           |            x2            |        Right bottom corner X coordinate
           |--------------------------|
           |            y2            |        Right bottom corner Y coordinate
           |--------------------------|
           |           lop            |        Logical operation
           |--------------------------|
           |                          |
           |--        style         --|        Line style/Tile pattern
           |                          |
           +--------------------------+



Lib-Index   API-Index

gv_circle/pv_circle ...  Display a circle, oval, circular arc, oval arc, fan, oval fan on the GVARM screen. 

***** Format *****
        int   gv_circle( x, y, xr, yr, d1, d2, lop, style, buf) {}

        int   pv_circle( CIRCLE_DRAW *cpt) {}

        typedef struct {
            POINT  pos ;
            RADS   rad ;
            DEGR   deg ;
            int    lop ;
            unsigned long style ;
            unsigned char *buf ;
        } CIRCLE_DRAW ;

        typedef struct {
            int    x ;
            int    y ;
        } POINT ;

        typedef struct {
            int    xr ;
            int    yr ;
        } RADS ;

        typedef struct {
            int    d1 ;
            int    d2 ;
        } DEGR ;

***** Parameter *****

        int  x, y           ; Specify the center of a circle by GVRAM coordinate (x,y) that the left upper corner of GVRAM is specified at (0,0).
        int  xr, yr         ; Specify the radius dot for X and Y direction of a circle.
        int  d1, d2         ; Start angle of a circular arc (d1) and end angle (d2)
        int  lop            ; Logical operation
        unsigned long style ; Line style and tile pattern
        unsigned char *buf  ; Work buffer address for fan paint

***** Return value *****
        int  ret ;    0: Terminate normally
                     -1: Parameter error


***** Feature description *****
 Draw a circle, oval, circular arc, oval arc, fan, oval fan with GVARM coordinate (x,y) as a center, xr,yr as a radius, start angle d1 and end angle d2 by using the specification logical operation/line style (tile pattern).



                                                      d1       d2
                  |                                     \  |  /  
                  |yr                                    \ | /   
            xr    |                                       \|/    
        ----------+------------                0 ----------+------------
                  |(x,y)                                   |     
                  |                                        |     
                  |                                        |     



  Logical operator lop specifies the method of logical operation by b0-b1, the presence of paint by b2 and the type of a circle by b3~ b4.

              b15 b14 b13 b12 b11 b10  b9  b8  b7  b6  b5  b4  b3  b2  b1  b0
             +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
             |   |   |   |   |   |   |   |   |   |   |   |   |   |   |   |   |
             +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
                                                          |-----| |-| |-----|
                                                             |     |     |
                                             Type of circle--+     |   Operation specification
                                             Presence of paint-----+
            b1,b0
                    00: Overwrite 01:XOR,10:OR,11:AND
                    (For circular arc, oval arc, fan and oval fan, the drawing result is not guaranteed by XOR.)
            b2      0: Not paint  1: Paint
            b4,b3
                    0*: Circle/oval 10:circular arc/oval arc  11:fan/oval fan
                                     (For circle/oval, d1 and d2 are ignored)

 Line style/Tile pattern "style" has different meaning depending on b2 (specification of the presence of paint) of lop.

 If you set b2=0 (Not paint), the draw format of the line is shown by the low level 8 bit of style.  When the bit is ON, the part of line is black and the part of OFF is white.

 If you set b2=1 (Paint), all bit (32 bit) of style is used as a tile pattern and the inside of the rectangle is painted.
 In this case, it is drawn as fan/oval fan even if you specify the circular arc/oval arc (=10) by b3-b4.

 For circular arc/ oval arc and fan/oval fan, the drawing result is not guaranteed by XOR.

 Work buffer "buf" specifies the work area address for fan/oval fan paint.  The required buffer size is 8000 byte.  This area is not used other than the fan/oval fan paint.


***** LCD-BIOS data table format *****

           b15                        b0
           +--------------------------+
           |            67            |        Feature number
           |--------------------------|
           |            x             |        Center point X coordinate
           |--------------------------|
           |            y             |        Center point Y coordinate 
           |--------------------------|
           |            xr            |        X direction radius
           |--------------------------|
           |            yr            |        Y direction radius 
           |--------------------------|
           |            d1            |        Start angle
           |--------------------------|
           |            d2            |        End angle
           |--------------------------|
           |           lop            |        Logical operation
           |--------------------------|
           |                          |
           |--        style         --|       Line style/Tile pattern
           |                          |
           +--------------------------+



Lib-Index   API-Index

gv_pset/pv_pset ...  Draw a point to the specified GVRAM screen coordinate. 

***** Format *****
        int   gv_pset( x, y, lop ) {}

        int   pv_pset( POINT_DRAW *ppt) {}

        typedef struct {
            POINT  pos ;
            int    lop ;
        } POINT_DRAW ;

        typedef struct {
            int    x ;
            int    y ;
        } POINT ;

***** Parameter *****
        int   x, y ; Specify the position of the drawing a point by GVRAM coordinate (x,y) that the left upper corner of GVRAM is specified at (0,0).
        int   lop  ; Logical operation

***** Return value *****
        int  ret ;    0: Terminate normally
                     -1: Parameter error

***** Feature description *****
 Draw a point on GVRAM screen coordinate (x,y) by white or black.

 Logical operator lop specifies the method of logical operation by b0-b1 and black/white by b2.

              b15 b14 b13 b12 b11 b10  b9  b8  b7  b6  b5  b4  b3  b2  b1  b0
             +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
             |   |   |   |   |   |   |   |   |   |   |   |   |   |   |   |   |
             +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
                                                                  |-| |-----|
                                                                   |     |
                                        Black/White specification--+  Operation specification
            b1,b0
                    00:Overwrite  01:XOR,10:OR,11:AND
            b2       0:White 1:Black
                        (White clears a point (OFF) and Black draws a point (ON))


***** LCD-BIOS data table format *****

           b15                        b0
           +--------------------------+
           |            68            |        Feature number     
           |--------------------------|
           |             x            |        GVRAM screen X coordinate
           |--------------------------|
           |             y            |        GVRAM screen Y coordinate
           |--------------------------|
           |           logic          |        Logical operation
           +--------------------------+



Lib-Index   API-Index

gv_point/pv_point   ...  Acquire a color (Black/White) of the specified GVRAM screen coordinate. 

***** Format *****
        int   gv_point( x, y ) {}

        int   pv_point( POINT *ppt ) {}

        typedef struct {
            int    x ;
            int    y ;
        } POINT ;

***** Parameter *****
        int    x, y ; Specify the position of a point to be acquired by GVRAM coordinate (x,y) that the left upper corner of GVRAM is specified at (0,0).

***** Return value *****
        int  ret ;  0 or 1: Terminate normally (0=White  1=Black)
                        -1: Parameter error

***** Feature description *****
 Acquire a color (Black or white) of the GVRAM screen coordinate (x,y).
 Actually, examine the internal GVRAM screen and return ON/OFF state of dot.

***** LCD-BIOS data table format *****
           b15                        b0
           +--------------------------+
           |            69            |        Feature number     
           |--------------------------|
           |             x            |        GVRAM screen X coordinate
           |--------------------------|
           |             y            |        GVRAM screen Y coordinate
           +--------------------------+



Lib-Index   API-Index

gv_get/pv_get   ...  Store the graphic pattern on the GVRAM screen to a memory. 

***** Format *****
        int   gv_get( x1, y1, x2, y2, buf) {}

        int   pv_get( GVRAM_GET *gpt) {}

        typedef struct {
            RECT    rect ;
            char    *buf ;
        } GVRAM_GET ;

        typedef struct {
            int    x1 ;
            int    y1 ;
            int    x2 ;
            int    y2 ;
        } RECT ;

***** Parameter *****
        int  x1, y1 ; Specify the left upper corner of the acquired area by GVRAM coordinate (x,y) that the left upper corner of GVRAM is specified at (0,0).
        int  x2, y2 ; Specify the right upper corner of the acquired area by GVRAM coordinate (x,y) that the left upper corner of GVRAM is specified at (0,0).
        char   *buf ; Buffer address that stores a pattern.

***** Return value *****
        int  ret ;    0: Terminate normally
                     -1: Parameter error

***** Feature description *****
 Store the graphic pattern on the area of the GVRAM screen coordinate (x1,y1)-(x2,y2) to the buffer bur.
 The graphic pattern is stored as a mono map format that contains X and Y width information.

           b15                      b0
           +------------------------+
           |          X width       |      Horizontal dot of graphic pattern
           |------------------------|
           |          Y width       |      Vertical dot of graphic pattern
           |------------------------|
           |                        |
           |                        |
           |     Graphic pattern    |
           |                        |
           |                        |
           +------------------------+




***** LCD-BIOS data table format *****
           b15                        b0
           +--------------------------+
           |            70            |        Feature number     
           |--------------------------|
           |             x            |        GVRAM screen X coordinate
           |--------------------------|
           |             y            |        GVRAM screen Y coordinate
           |--------------------------|
           |                          | 
           |--         *buf         --|        Store buffer address
           |                          | 
           +--------------------------+

 *For information about mono map format, refer to Mono map store format in .



Lib-Index   API-Index

gv_put/pc_put   ...  Display the graphic pattern on the GVRAM screen. 

***** Format *****
        int   gv_put( x, y, buf, logic) {}

        int   pv_put( GVRAM_PUT *gpt) {}

        typedef struct {
            POINT  pos ;
            char   *buf ;
            int    lop ;
        } GVRAM_PUT ;

        typedef struct {
            int    x ;
            int    y ;
        } POINT ;

***** Parameter *****
        int  x, y ; Specify the left upper corner of graphic pattern display by GVRAM coordinate (x,y) that the left upper corner of GVRAM is specified at (0,0).
        char *buf ; Buffer address that stores a graphic pattern
        int  lop  ; Logical operation

***** Return value *****
        int  ret ;    0: Terminate normally
                     -1: Parameter error

***** Feature description *****
 Draw the graphic pattern shown in the buffer buf on the GVRAM screen as the GVRAM screen coordinate (x,y) is located in the left upper corner.  The buffer bur must be the format that is obtained by gv_get().
 Logical operator logic specifies the method of logical operation by b0-b1.

              b15 b14 b13 b12 b11 b10  b9  b8  b7  b6  b5  b4  b3  b2  b1  b0
             +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
             |   |   |   |   |   |   |   |   |   |   |   |   |   |   |   |   |
             +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
                                                                      |-----|
                                                         Operation specification
            b1,b0
                    00:Overwrite  01:XOR,10:OR,11:AND


***** LCD-BIOS data table format *****

           b15                        b0
           +--------------------------+
           |            71            |        Feature number     
           |--------------------------|
           |             x            |        GVRAM screen X coordinate
           |--------------------------|
           |             y            |        GVRAM screen Y coordinate
           |--------------------------|
           |                          |
           |--         *buf         --|        Store buffer address
           |                          |
           +--------------------------+



Lib-Index   API-Index

gv_scroll       ...  Scroll GVRAM. 

***** Format *****
        int   gv_scroll( lines ) {}

***** Parameter *****
        int  lines ;  Scroll line number on GVRAM (dot)

***** Return value *****
        int  ret ;    0: Terminate normally
                     -1: Parameter error

***** Feature description *****
 Scroll the entire GVRAM for the part of the specified line number (dot) to the upward direction.
 After the scroll, the specified line number is o cleared from the lowest line of GVRAM.

***** LCD-BIOS data table format *****
           b15                        b0
           +--------------------------+
           |            72            |        Feature number     
           |--------------------------|
           |          lines           |        Scroll line number
           +--------------------------+



Lib-Index   API-Index

gv_reverse/pv_reverse   ...  Reverse the specified area of GVRAM. 

***** Format *****
        int   gv_reverse( x1, y1, x2, y2) {}

        int   pv_reverse( RECT *rpt) {}

        typedef struct {
            int    x1 ;
            int    y1 ;
            int    x2 ;
            int    y2 ;
        } RECT ;

***** Parameter *****
        int  x1, y1 ;  Specify the left upper corner of reverse area by GVRAM coordinate (x,y) that the left upper corner of GVRAM is specified at (0,0).
        int  x2, y2 ;  Specify the right bottom corner of display area by GVRAM coordinate (x,y) that the left upper corner of GVRAM is specified at (0,0).

***** Return value *****
        int  ret ;    0: Terminate normally
                     -1: Parameter error

***** Feature description *****
 The contents of the GVRAM area specified by (x1,y1)-(x2,y2) is reversed by Black/White.
 This function is different form reverse function.  It reverses the GVRAM content itself by Black/White.


***** LCD-BIOS data table format *****
           b15                        b0
           +--------------------------+
           |            73            |        Feature number
           |--------------------------|
           |            x1            |        Left upper corner X coordinate
           |--------------------------|
           |            y1            |        Left upper corner Y coordinate 
           |--------------------------|
           |            x2            |        Right bottom cornerX coordinate 
           |--------------------------|
           |            y2            |        Right bottom corner Y coordinate
           +--------------------------+



Lib-Index   API-Index

gv_clear/pv_clear   ...  0 clear the specified area of GVRAM. 

***** Format *****
        int   gv_clear( x1, y1, x2, y2) {}

        int   pv_clear( RECT *cpt) {}

        typedef struct {
            int    x1 ;
            int    y1 ;
            int    x2 ;
            int    y2 ;
        } RECT ;

***** Parameter *****
        int  x1, y1 ; Specify the position of the left upper corner to be cleared by GVRAM coordinate (x,y) that the left upper corner of GVRAM is specified at (0,0).
        int  x2, y2 ; Specify the position of the right bottom corner to be cleared by GVRAM coordinate (x,y) that the left upper corner of GVRAM is specified at (0,0).

***** Return value *****
        int  ret ;    0: Terminate normally
                     -1: Parameter error

***** Feature description *****
  0 clear the contents of the GVRAM area specified by (x1,y1)-(x2,y2).


***** LCD-BIOS data table format *****
           b15                        b0
           +--------------------------+
           |            74            |        Feature number
           |--------------------------|
           |            x1            |        Left upper corner X coordinate
           |--------------------------|
           |            y1            |        Left upper corner Y coordinate 
           |--------------------------|
           |            x2            |        Left bottom corner X coordinate 
           |--------------------------|
           |            y2            |        Left bottom corner Y coordinate 
           +--------------------------+




-----------------------------------------------------------------------------------------
*About a set of functions correspondence of the LCD direct drawing

 The following is the correspondence in terms of function convention.

 Graphics mode -> LCD mode
     gv_***( )           lc_***( )
     pv_***( )           pc_***( )


We do not explain about some drawing processes that have the same functions with the exception of different display subjected screen.
For functions correspond to the LCD direct drawing, refer to the line 395 of ***** LCD direct drawing function *****.

===============================================================================
 Copyright (c) 1998-1999.  Seiko Instruments Inc.  All rights reserved. 
===============================================================================
Lib-Index   API-Index