MSX Village forum

 
Extraits de MSX2 Technical Handbook (Konamiman.com)
 
* COLOR SPRITE (<sprite plane number>)=<colour>
StatementSets the colour to the sprite of <sprite plane
number> to the specified colour.
 
* COLOR SPRITE$ (<sprite plane number>)=<string expression>
StatementSets the colour of each horizontal line of the
sprite using <string expression>.
 
ON SPRITE GOSUB <linenumber>
StatementDefines the line to begin the piled-sprite interrupt
handling routine.
 
* PUT SPRITE <sprite plane number>[, {(X,Y) | STEP(X,Y)}[, <colour>[, <sprite
     pattern number>]]]
StatementDisplays the sprite pattern.
 
* SCREEN <screen mode>[, <sprite size>[, <key click switch>[, <cassette baud
 rate>[, <printer option>[, <interlace mode>]]]]]
StatementSets the screen mode and so on.
 
SPRITE {ON | OFF | STOP}
StatementAllows, supresses, or suspends the piled-sprite
interrupt.
 
SPRITE$ (<sprite pattern number>)
System variable Contains the sprite pattern.
 
* SCREEN <screen mode>[, <sprite size>[, <key click switch>[, <cassette baud
 rate>[, <printer option>[, <interlace mode>]]]]]
 
 
   Table 2.8  Correspondences between BASE set values and VRAM table
 
------------------------------------------------------
| Expression | Screen mode |     Table     |
|------------+-------------+-------------------------|
|     0      |    0   | Pattern name table      |
|     1      |    0   | N/A     |
|     2      |    0   | Pattern generator table |
|     3      |    0   | N/A     |
|     4      |    0   | N/A     |
|     5      |    1   | Pattern name table      |
|     6      |    1   | Colour table     |
|     7      |    1   | Pattern generator table |
|     8      |    1   | Sprite attribute table  |
|     9      |    1   | Sprite generator table  |
|    10      |    2   | Pattern name table      |
|    11      |    2   | Colour table     |
|    12      |    2   | Pattern generator table |
|     .      |    .   |.     |
      .     ..
      .     ..
|     |   |     |
|    43      |    8   | Sprite attribute table  |
|    44      |    8   | Sprite generator table  |
------------------------------------------------------
 
 
 
2.7 Additions or Modifications for Sprite
 
The sprites used in screen mode 4-8 of MSX2 are called sprite mode 2, which 
has upgraded a great deal as compared with MSX1. On MSX1, for example, one 
sprite could treat only one colour, while in this mode of MSX2 different 
colours can be specified for each horizontal line and so multi-coloured 
characters can be realised with one sprite. Additionally, it is a good idea 
to combine two sprites as though they were one sprite to paint each dot with 
different colours. And, on MSX1, when more than five sprites are arrayed on 
a horizontal line, the sprites after the fifth one were not displayed, but on 
MSX2 up to eight sprites can be displayed, so a higher flexibility is 
offered.
 
Colours which can be specified for sprites are shown in Table 2.4 (colour 
statement) except for screen mode 8. The sprite in screen mode 8, not capable 
of using the palette, uses the colour number for the specification, and only 
16 colours can be used (see Table 2.10).
 
 
 
   Table 2.10  Sprite colours in screen mode 8
 
-------------------------------------------------------------------------
| 0: Black  | 1: Deep Blue    | 2: Deep Red     | 3: Deep Purple|
|-----------------+-----------------+-----------------+-----------------|
| 4: Deep Green   | 5: Turquoise    | 6: Olive      | 7: Grey |
|-----------------+-----------------+-----------------+-----------------|
| 8: Light Orange | 9: Blue    | 10: Red      | 11: Purple|
|-----------------+-----------------+-----------------+-----------------|
| 12: Green  | 13: Light Blue  | 14: Yellow      | 15: White|
-------------------------------------------------------------------------
 
 
* PUT SPRITE <sprite plane number>[, {(X,Y) | STEP(X,Y)}[, <colour>[, <sprite
     pattern number>]]]
 
In screen modes 1 through 3, Y-coordinate was 209 for erasing the display of 
the specified sprite and was 208 for erasing the displays of the specified 
sprite and all sprites following it, but in screen modes 4 through 8, where 
the limit of Y-coordinate has been increased to 212 dots, the values to be 
specified are now 217 and 216, respectively.
 
 
* COLOR SPRITE$ (<sprite plane number>) = <string expression>
 
This statement specifies a colour for each horizontal line (see Figure 2.5).
 
<String expression> consists of one to sixteen characters. Bits 0 throgh 3 of 
the character's ASCII code are used for the colour specification, and bits 4 
throgh 7 are used to specify each function of the sprite (see Table 2.11). 
These specifications are valid only for screen modes 4 through 8.
 
COLOR SPRITE$ = CHR$ (colour of the first line) + CHR$ (colour of the second 
line) + ...... + CHR$ (colour of the eight line)
 
 
 
   Figure 2.5  Relation of the sprite and <string expression>
 
   ---------------------------------
Line 1 --> | * |   |   | * | * |   |   | * |
   |---+---+---+---+---+---+---+---|
Line 2 --> | * | * |   |   |   |   | * | * |
   |---+---+---+---+---+---+---+---|
   |   |   |   |   |   |   |   |   |
   |---+---+---+---+---+---+---+---|
   | * | * |   |   |   |   | * | * |
   |---+---+---+---+---+---+---+---|
   |   |   | * |   |   | * |   |   |
   |---+---+---+---+---+---+---+---|
   | * |   |   | * | * |   |   | * |
   |---+---+---+---+---+---+---+---|
   | * | * |   |   |   |   | * | * |
   |---+---+---+---+---+---+---+---|
Line 8 --> |   |   | * | * | * | * |   |   | The colour for each line
   --------------------------------- can be set.
 
 
   Table 2.11  Bitwise meanings of string expression
 
-------------------------------------------------------------------------
|    b7    | If 1, move the sprite to left by 32 dots.|
|----------+------------------------------------------------------------|
|   | If 1, move the sprites of the successive planes together.|
|    b6    | The priority and conflict of sprites are ignored, and when |
|   | sprites are piled up, they are displayed in the colour|
|   | which is OR-ed with their colour numbers. *|
|----------+------------------------------------------------------------|
|    b5    | If 1, the conflict of sprites are ignored. |
|----------+------------------------------------------------------------|
|    b4    | Unused.|
|----------+------------------------------------------------------------|
| b0 to b3 | Palette number.|
-------------------------------------------------------------------------
 
* For example, assuming that bit 6 of sprite plane 1 is "0" and bit 6 of 
sprite plane 2 is "1", only by moving sprite plane 1, will sprite plane 2 be 
displayed displayed to be piled at the same location.
 
 
* COLOR SPRITE (<sprite plane number>) = <expression>
 
This statement sets the whole sprite of the specified plane to the 
<expression>, this uses <expression> for colour specification. The format of 
the colour specification is the same as shown in Table 2.11, but the 
specification for b7 is disabled. These are valid for screen modes 4 through 
8.
 
 
 
   Table 2.20  List of intermediate codes
 
-------------------   -------------------   -------------------
| >  |    EE |   | ERR|    E2 |   | PAINT   |    BF |
| =  |    EF |   | ERROR|    A6 |   | PDL     | FF A4 |
| <  |    F0 |   | EXP| FF 8B |   | PEEK    | FF 97 |
| +  |    F1 |   | FIELD|    B1 |   | PLAY    |    C1 |
| -  |    F2 |   | FILES|    B7 |   | POINT   |    ED |
| *  |    F3 |   | FIX| FF A1 |   | POKE    |    98 |
| /  |    F4 |   | FN|    DE |   | POS     | FF 91 |
| ^  |    F5 |   | FOR|    82 |   | PRESET  |    C3 |
|   |    FC |   | FPOS| FF A7 |   | PRINT   |    91 |
| ABS  | FF 86 |   | FRE| FF 8F |   | PSET    |    C2 |
| AND  |    F6 |   | GET|    B2 |   | PUT     |    B3 |
| ASC  | FF 95 |   | GOSUB|    8D |   | READ    |    87 |
| ATN  | FF 8E |   | GOTO|    89 |   | REM     | 3A 8F |
| ATTR$   |    E9 |   | HEX$| FF 9B |   | RENUM   |    AA |
| AUTO  |    A9 |   | IF|    8B |   | RESTORE |    8C |
| BASE  |    C9 |   | IMP|    FA |   | RESUME  |    A7 |
| BEEP  |    C0 |   | INKEY$|    EC |   | RETURN  |    8E |
| BIN$  | FF 9D |   | INP| FF 90 |   | RIGHT$  | FF 82 |
| BLOAD   |    CF |   | INPUT|    85 |   | RND     | FF 88 |
| BSAVE   |    D0 |   | INSTR|    E5 |   | RSET    |    B9 |
| CALL  |    CA |   | INT| FF 85 |   | RUN     |    8A |
| CDBL  | FF A0 |   | IPL|    D5 |   | SAVE    |    BA |
| CHR$  | FF 96 |   | KEY|    CC |   | SCREEN  |    C5 |
| CINT  | FF 9E |   | KILL|    D4 |   | SET     |    D2 |
| CIRCLE  |    BC |   | LEFT$| FF 81 |   | SGN     | FF 84 |
| CLEAR   |    92 |   | LEN| FF 92 |   | SIN     | FF 89 |
| CLOAD   |    9B |   | LET|    88 |   | SOUND   |    C4 |
| CLOSE   |    B4 |   | LFILES|    BB |   | SPACE$  | FF 99 |
| CLS  |    9F |   | LINE|    AF |   | SPC(    |    DF |
| CMD  |    D7 |   | LIST|    93 |   | SPRITE  |    C7 |
| COLOR   |    BD |   | LLIST|    9E |   | SQR     | FF 87 |
| CONT  |    99 |   | LOAD|    B5 |   | STEP    |    DC |
| COPY  |    D6 |   | LOC| FF AC |   | STICK   | FF A2 |
| COS  | FF 8C |   | LOCATE|    D8 |   | STOP    |    90 |
| CSAVE   |    9A |   | LOF| FF AD |   | STR$    | FF 93 |
| CSNG  | FF 9F |   | LOG| FF 8A |   | STRIG   | FF A3 |
| CSRLIN  |    E8 |   | LPOS| FF 9C |   | STRING$ |    E3 |
| CVD  | FF AA |   | LPRINT|    9D |   | SWAP    |    A4 |
| CVI  | FF A8 |   | LSET|    B8 |   | TAB(    |    DB |
| CVS  | FF A9 |   | MAX|    CD |   | TAN     | FF 8D |
| DATA  |    84 |   | MERGE|    B6 |   | THEN    |    DA |
| DEF  |    97 |   | MID$| FF 83 |   | TIME    |    CB |
| DEFDBL  |    AE |   | MKD$| FF B0 |   | TO      |    D9 |
| DEFINT  |    AC |   | MKI$| FF AE |   | TROFF   |    A3 |
| DEFSNG  |    AD |   | MKS$| FF AF |   | TRON    |    A2 |
| DEFSTR  |    AB |   | MOD|    FB |   | USING   |    E4 |
| DELETE  |    A8 |   | MOTOR|    CE |   | USR     |    DD |
| DIM  |    86 |   | NAME|    D3 |   | VAL     | FF 94 |
| DRAW  |    BE |   | NEW|    94 |   | VARPTR  |    E7 |
| DSKF  | FF A6 |   | NEXT|    83 |   | VDP     |    C8 |
| DSKI$   |    EA |   | NOT|    E0 |   | VPEEK   | FF 98 |
| DSKO$   |    D1 |   | OCT$| FF 9A |   | VPOKE   |    C6 |
| ELSE  | 3A A1 |   | OFF|    EB |   | WAIT    |    96 |
| END  |    81 |   | ON|    95 |   | WIDTH   |    A0 |
| EOF  | FF AB |   | OPEN|    B0 |   | XOR     |    F8 |
| EQV  |    F9 |   | OR|    F7 |   -------------------
| ERASE   |    A5 |   | OUT|    9C |
| ERL  |    E1 |   | PAD| FF A5 |
-------------------   -------------------
 

 
501 PUTSPRITE0,(X,Y),11,0
 

 
506 IFSTRIG(0)THENPOKE&HCFFF,11:A=USR2(0):PUTSPRITE1,(X+50,Y),1,0
 

 
502 PUTSPRITE2,(-X+VDP(27),X-VDP(27)),9,0
503 PUTSPRITE3,(-X-VDP(27),-Y),15,0
504 PUTSPRITE4,(-Y,X-VDP(27)),8,0
505 PUTSPRITE5,(X+Y,VDP(27)),6,0
 

370  PUTSPRITE6,(150,100),1,0:PUTSPRITE7,(180,75),1,0:PUTSPRITE8,(180,125),1,0
380  PUTSPRITE9,(120,75),1,0:PUTSPRITE10,(120,125),1,0
 

 
490 X=X-4:IFX<1THENX=0
500 VDP(27)=VDP(27)+1AND255
 

 
507 S=STICK(0):ONS+1GOTO490,590,690,790,880,980,1080,1180,1270
 

 
340 '              Sprites ennemis rampants
350 '
360 'ONSPRITEGOSUB1090
370  PUTSPRITE6,(150,100),1,0:PUTSPRITE7,(180,75),1,0:PUTSPRITE8,(180,125),1,0
380  PUTSPRITE9,(120,75),1,0:PUTSPRITE10,(120,125),1,0
390 'SPRITE ON
400 '
410 '
460 '              SP gestion mouvement: HERO STATIQUE
470 '
480 '
490 X=X-4:IFX<1THENX=0
491 COPY(16+VDP(27),191)-(31+VDP(27),206),1TO(x,y),0
500 VDP(27)=VDP(27)+1AND255
501 PUTSPRITE0,(X,Y),11,0
502 PUTSPRITE2,(-X+VDP(27),X-VDP(27)),9,0
503 PUTSPRITE3,(-X-VDP(27),-Y),15,0
504 PUTSPRITE4,(-Y,X-VDP(27)),8,0
505 PUTSPRITE5,(X+Y,VDP(27)),6,0
506 IFSTRIG(0)THENPOKE&HCFFF,11:A=USR2(0):PUTSPRITE1,(X+50,Y),1,0
507 S=STICK(0):ONS+1GOTO490,590,690,790,880,980,1080,1180,1270
 

10 FORI=&H7800TO&H781F:VPOKEI,255:NEXTI:x=100
20 ONSPRITEGOSUB130:SPRITEON
30 X=X-4:IFX<1THENX=0
50 VDP(27)=VDP(27)+1AND255
60 C=CXOR32:PUTSPRITE5,(X+Y,VDP(27)),6+C,0:C=CXOR32
70 C=CXOR32:PUTSPRITE2,(-X+VDP(27),X-VDP(27)),6+C,0:C=CXOR32
80 C=CXOR32:PUTSPRITE3,(-X-VDP(27),-Y+VDP(27)),1+C,0:C=CXOR32
90 C=CXOR32:PUTSPRITE4,(-Y,X-VDP(27)),8+C,0:C=CXOR32
100 PUTSPRITE0,(X+80,Y+150),15OR32,0
110 IFSTRIG(0)THENPUTSPRITE1,(X+50,Y),1,0
120 S=STICK(0):ONS+1GOTO30,30,30,30,30,30,30,30,30
130 END