Difference between revisions of "SCI Kernel Documentation/Graphic Screen Functions"

From SCI Wiki
Jump to navigationJump to search
(Created page with "Official SCI Documentation<br /> <div align="center"> Chapter: 1 | 2 | SCI...")
 
 
(3 intermediate revisions by the same user not shown)
Line 10: Line 10:
 
[[SCI Kernel Documentation/String Functions|6]] |  
 
[[SCI Kernel Documentation/String Functions|6]] |  
 
[[SCI Kernel Documentation/Picture Functions|7]] |  
 
[[SCI Kernel Documentation/Picture Functions|7]] |  
[[SCI Kernel Documentation/Save/Restore Game Functions|8]] |  
+
[[SCI Kernel Documentation/Save-Restore Game Functions|8]] |  
 
[[SCI Kernel Documentation/Animation Functions|9]] |  
 
[[SCI Kernel Documentation/Animation Functions|9]] |  
 
[[SCI Kernel Documentation/Graphic Screen Functions|10]] |  
 
[[SCI Kernel Documentation/Graphic Screen Functions|10]] |  
Line 23: Line 23:
 
</div><br />
 
</div><br />
  
<div align="center"><span style="font-size: 22pt"></span><br />
+
<div align="center"><span style="font-size: 22pt">Graphic Screen Functions</span><br />
 
''Author: [[Jeff Stephenson]]''<br />
 
''Author: [[Jeff Stephenson]]''<br />
 
''Revision by: David Slayback''</div>
 
''Revision by: David Slayback''</div>
Line 29: Line 29:
 
&nbsp;
 
&nbsp;
  
xxxxxxx body xxxxxxxx
+
==<br /> Graphic Screen Functions ==
 +
 
 +
<blockquote>
 +
The following kernel functions are direct calls to the graphic code used to draw the pictures and views.
 +
 
 +
mapSet is used below to refer to a word that has its bits set for a combination of showing on the Visual, Priority, and/or Control screen.</blockquote>
 +
 
 +
===<br /> (Graph GLoadBits bitMap) ===
 +
 
 +
<blockquote>
 +
Load the given bitMap number, and display on screen. This function does NOT work for 16-color SCI.
 +
</blockquote>
 +
 
 +
===<br /> (Graph GDetect) ===
 +
 
 +
<blockquote>
 +
Return the number of colors supported by the video hardware. EGA=16, CGA B/W=2, CGA Color=4, VGA=256.
 +
</blockquote>
 +
 
 +
===<br /> (Graph GSetPalette paletteNum) ===
 +
 
 +
<blockquote>
 +
Not implemented yet -- for 256-color SCI.
 +
 
 +
;; changed 4-2-90 j.m.h. /m.w.
 +
</blockquote>
 +
 
 +
===<br /> (Graph GDrawLine    t l b r vColor pColor cColor) ===
 +
 
 +
<blockquote>
 +
Draw a line from (l, t) to (r, b) in the the given colors. A color value of -1 specifies that the line should  not be drawn into that map.
 +
</blockquote>
 +
 
 +
===<br /> (Graph GFillArea    x  y mapSet [vColor] [pColor [cColor]) ===
 +
 
 +
<blockquote>
 +
Do a fill at (x,y) in the mapSet screens in the given colors.
 +
</blockquote>
 +
 
 +
===<br /> (Graph GDrawBrush  x  y size randomSeed mapSet [vColor] [pColor [cColor]) ===
 +
 
 +
<blockquote>
 +
Not implemented yet.
 +
</blockquote>
 +
 
 +
===<br /> (Graph GSaveBits    top left bottom right mapSet saveID) ===
 +
 
 +
<blockquote>
 +
Return a pointer to the saved bits of the rectangle (top,left, bottom, right) on the given screen(s) in mapset.
 +
</blockquote>
 +
 
 +
===<br /> (Graph GRestoreBits saveID) ===
 +
 
 +
<blockquote>
 +
Restore to the screen the bits that are pointed to by saveID.
 +
</blockquote>
 +
 
 +
===<br /> (Graph GEraseRect  top left bottom right) ===
 +
 
 +
<blockquote>
 +
Draws visual in background color.
 +
</blockquote>
 +
 
 +
===<br /> (Graph GPaintRect  top left bottom right) ===
 +
 
 +
<blockquote>
 +
Draws visual in foreground color.
 +
</blockquote>
 +
 
 +
===<br /> (Graph GFillRect    top left bottom right mapset vColor pColor cColor)  ===
 +
 
 +
<blockquote>
 +
Fill a given rectangle(top,left,bottom,right) in the given screen(s) and color(s).
 +
</blockquote>
 +
 
 +
===<br /> (Graph GShowBits    top left bottom right mapSet) ===
 +
 
 +
<blockquote>
 +
Not implemented yet.
 +
</blockquote>
 +
 
 +
===<br /> (Graph GReAnimate  top left bottom right) ===
 +
 
 +
<blockquote>
 +
This has the same affect as a ShowBits, BUT re-animates the cast members that are inside the shown rectangle.
 +
</blockquote>
 +
 
 +
===<br /> (Graph GInitPri horizon foreground) ===
 +
 
 +
<blockquote>
 +
This sets the point at which animated characters change priority as they move up and down the screen. The horizon is the coordinate in the picture where their priority is 0. The foreground is the point  where the priority will be 14. These values can be set in the picture editor, but are not saved. Default is hor=42, fore=190.
 +
</blockquote>
  
 
&nbsp;
 
&nbsp;
Line 42: Line 133:
 
&nbsp;
 
&nbsp;
  
<span style="float: left">[[SCI Kernel Documentation/|&lt; Previous: ]]</span><span style="float: right">[[SCI Kernel Documentation/|Next: &gt;]]</span>
+
<span style="float: left">[[SCI Kernel Documentation/Animation Functions|&lt; Previous: Animation Functions]]</span>
 +
<span style="float: right">[[SCI Kernel Documentation/Input Functions|Next: Input Functions &gt;]]</span>
  
 
&nbsp;
 
&nbsp;
  
 
[[Category:SCI Documentation]]
 
[[Category:SCI Documentation]]
[[Category:Scripting]]
 
 
[[Category:Kernel Functions]]
 
[[Category:Kernel Functions]]
 +
[[Category:Graphics]]
 +
[[Category:Graphic Screen]]
 +
[[Category:Graphic Screen Functions]]

Latest revision as of 13:27, 3 December 2015

Official SCI Documentation

Chapter: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | Index


Graphic Screen Functions

Author: Jeff Stephenson

Revision by: David Slayback

 


Graphic Screen Functions

The following kernel functions are direct calls to the graphic code used to draw the pictures and views.

mapSet is used below to refer to a word that has its bits set for a combination of showing on the Visual, Priority, and/or Control screen.


(Graph GLoadBits bitMap)

Load the given bitMap number, and display on screen. This function does NOT work for 16-color SCI.


(Graph GDetect)

Return the number of colors supported by the video hardware. EGA=16, CGA B/W=2, CGA Color=4, VGA=256.


(Graph GSetPalette paletteNum)

Not implemented yet -- for 256-color SCI.

changed 4-2-90 j.m.h. /m.w.


(Graph GDrawLine t l b r vColor pColor cColor)

Draw a line from (l, t) to (r, b) in the the given colors. A color value of -1 specifies that the line should not be drawn into that map.


(Graph GFillArea x y mapSet [vColor] [pColor [cColor])

Do a fill at (x,y) in the mapSet screens in the given colors.


(Graph GDrawBrush x y size randomSeed mapSet [vColor] [pColor [cColor])

Not implemented yet.


(Graph GSaveBits top left bottom right mapSet saveID)

Return a pointer to the saved bits of the rectangle (top,left, bottom, right) on the given screen(s) in mapset.


(Graph GRestoreBits saveID)

Restore to the screen the bits that are pointed to by saveID.


(Graph GEraseRect top left bottom right)

Draws visual in background color.


(Graph GPaintRect top left bottom right)

Draws visual in foreground color.


(Graph GFillRect top left bottom right mapset vColor pColor cColor)

Fill a given rectangle(top,left,bottom,right) in the given screen(s) and color(s).


(Graph GShowBits top left bottom right mapSet)

Not implemented yet.


(Graph GReAnimate top left bottom right)

This has the same affect as a ShowBits, BUT re-animates the cast members that are inside the shown rectangle.


(Graph GInitPri horizon foreground)

This sets the point at which animated characters change priority as they move up and down the screen. The horizon is the coordinate in the picture where their priority is 0. The foreground is the point where the priority will be 14. These values can be set in the picture editor, but are not saved. Default is hor=42, fore=190.

 

Notes


 

Table of Contents

 

< Previous: Animation Functions Next: Input Functions >