Apparently-To: john.smith@gravis.com


GUS Programmer's Digest     Tue, 16 Nov 93  4:43         Volume 6: Issue   8  

Today's Topics:
                     SDK answer, and Pascal stuff
                            Using the SDK

Standard Info:
	- Meta-info about the GUS can be found at the end of the Digest.
	- Before you ask a question, please READ THE FAQ.

----------------------------------------------------------------------

Date: Tue, 16 Nov 93 0:24:35 GMT
From: "Bjarni R. Einarsson" <bre@os.is>
Subject: SDK answer, and Pascal stuff

Jurassic Mark wrote... 
> 
> 	I finally got Borland C++ 3.1 (I'll have BC++ 4.0 later) and I 
> installed the GUS SDK.  Now I have a litttle problem and I'm sure I'm not 
> the first to ask that.  How do I use those LIB files?  Do I have to use 
> IMPLIB.EXE to import them?  And why is that question not in the FAQ?  
> I've seen that question several times.
> 
You need to change all the inpb()'s to inportb()'s, outpb()'s to outportb()'s
and so on (or vice versa..) there may be a #define somewhere that does this 
for you.  Then recompile and enjoy!  That worked for me anyway.

BTW, it is bad manners to cross-post things like this to gus-general, 
programming stuff goes here :)


And on to other things.... is anybody out there programming Turbo/Borland
Pascal for the GUS?  I am working on a GusPlay/Ultradox interface unit that
should enable Pascal proggers to add nice music to games/whatevers they are
writing.  I lack code for DMA up/downloads, and a .MID play-back routine 
would be nice.. anybody wanna swap code?

Also, since I now have .MODs playing via Pascal, I'm gonna be needing a 
composer pretty soon :-)  Anbody?  You'll get your name in the credits..
(I'm workin on a game)

OOPS!  This message shoulda gone to the gus-sdk-general-composing list!
:-)
  ______________________________________________   ___________________
 /                                              \ /                   \
( "Shee, you guys are so unhip its a wonder your O Bjarni R. Einarsson )
(  bums don't fall off!" -- Zaphod Beeblebrox    O  - - bre@os.is - -  )
 \______________________________________________/ \___________________/

------------------------------

Date: Mon, 15 Nov 93 22:10:16 CST
From: Jay Stelly <claris!jay%csccat.cs.com@apple.com>
Subject: Re: Using the SDK

> Date: Mon, 15 Nov 1993 00:09:37 -0400 (AST)
> From: Jurassic Mark <markus@Info.UMoncton.ca>
> Subject: Need help installing SDK
> 
> 	I finally got Borland C++ 3.1 (I'll have BC++ 4.0 later) and I 
> installed the GUS SDK.  Now I have a litttle problem and I'm sure I'm not 
> the first to ask that.  How do I use those LIB files?  Do I have to use 
> IMPLIB.EXE to import them?  And why is that question not in the FAQ?  
> I've seen that question several times.
> 
If you haven't figured out how to use the .LIB files, then the gravis SDK
isn't the only 'little problem' you'll have 8-)  Anyway, the reason this isn't
in the FAQ is that it's more of a basic C question than a GUS question.
However, .LIB files are just a collection of .OBJ files that you can link
to your program.  You will need to include the gravis header files 
containing the prototypes for the functions you'll be using in each source
file that calls the library.  Then you will need to add one or more 
of the .LIB files to your project (depending on what functions you're calling)
But, for a basic sample player in large memory model, you need to add
ULTRA0LB.LIB and ULTRA1LB.LIB to your project.  BC's IDE will automatically
link them to your executable.  The last two letters of each library indicate
which memory model and compiler they're for (L = large, S=small) (B=Borland,
M=Microsoft).
IMPLIB.EXE is a totally different animal altogether.  This is used to create
a .LIB file from a .DLL file when compiling a Windows program.  If you
are compiling a Windows program, however, you won't be able to use the
SDK as Windows is in control of the GUS.  You'll need to use the MCI 
commands to output sound.

That ought to get you started.
Good luck,

Jay Stelly
jay@cs.com

------------------------------

End of GUS Programmer's Digest V6 #8
************************************

To post to tomorrow's digest:                    <gus-sdk@dsd.es.com>
To (un)subscribe or get help:            <gus-sdk-request@dsd.es.com>
To contact a human (last resort):          <gus-sdk-owner@dsd.es.com>

FTP sites:           archive.epas.utoronto.ca              /pub/pc/ultrasound
                     wuarchive.wustl.edu            /systems/msdos/ultrasound
                     archive.orst.edu                    /pub/packages/gravis
                     theoris.rz.uni-konstanz.de                /pub/sound/gus
FTP mail server:     mail-server@nike.rz.uni-konstanz.de

Hints:
      - Get the FAQ from the FTP sites or the request server.
      - Mail to <gus-sdk-request@dsd.es.com> for info about other GUS
	related mailing lists (general use, musician's, etc.).



