home *** CD-ROM | disk | FTP | other *** search
/ No Fragments Archive 12: Textmags & Docs / nf_archive_12.iso / MAGS / DOCS / DEVELOP.ZIP / DEVELOP.TXT
Encoding:
Text File  |  1997-06-21  |  13.6 KB  |  301 lines

  1. 0660103030566
  2. 9[....................................................]
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.          -----------------------------------------------------------------
  11.          |                                                               |
  12.          |   AAA  TTTTT  AAA  RRRR   III        ****         SSS  TTTTT  |
  13.          |  A   A   T   A   A R   R   I         ****        S   S   T    |
  14.          |  A   A   T   A   A R   R   I         ****        S       T    |
  15.          |  AAAAA   T   AAAAA RRRR    I        ******        SSS    T    |
  16.          |  A   A   T   A   A R   R   I       ** ** **          S   T    |
  17.          |  A   A   T   A   A R   R   I      **  **  **     S   S   T    |
  18.          |  A   A   T   A   A R   R  III   **    **    **    SSS    T    |
  19.          |                                                               |
  20.          |  DDDD  EEEEE V   V EEEEE L      OOO  PPPP  EEEEE RRRR   SSS   |
  21.          |  D   D E     V   V E     L     O   O P   P E     R   R S   S  |
  22.          |  D   D E     V   V E     L     O   O P   P E     R   R S      |
  23.          |  D   D EEEE  V   V EEEE  L     O   O PPPP  EEEE  RRRR   SSS   |
  24.          |  D   D E     V   V E     L     O   O P     E     R   R     S  |
  25.          |  D   D E      V V  E     L     O   O P     E     R   R S   S  |
  26.          |  DDDD  EEEEE   V   EEEEE LLLLL  OOO  P     EEEEE R   R  SSS   |
  27.          |                                                               |
  28.          -----------------------------------------------------------------
  29.          Question and Answer Bulletin                           June  1986
  30.          Copyright (C) 1986 by Atari Corp.           "all rights reserved"
  31.          1196 Borregas Ave.,          Sunnyvale, Ca.                 94086
  32.          -----------------------------------------------------------------
  33.  
  34.          Here  are  the latest questions from the Atari developers mailbag
  35.          as  answered  by  John Feagans, Director of Software Technology.
  36.          Leave  questions on Compuserve for PIN 70007,1072 or GO PCS57 for
  37.          Atari developer SIG information.
  38.  
  39.  
  40.          1.  Discussion
  41.  
  42.          We  would  like  to clear up a bit of the confusion on the use of
  43.          the  Alcyon  version  4.14  C  compiler.   The programs which are
  44.          actually  new  in  the  system  are cp, c0, and c1, the as68, and
  45.          ar68.  The Motorola FFP (libf) and the double precision math pack
  46.          (libm)  are  upgraded  and  a new addition respectively.  All the
  47.          other  tools  and programs on the disks are the standard issue in
  48.          the  regular  developer's  kit.   GEMLIB was modified slightly by
  49.          Alcyon  to  include procedures needed by the new math libraries.
  50.          In the future, everyone will be updated with a new linker.
  51.  
  52.          The  files  on the disks have been organized in a two disk system
  53.          for  C-  development.  There is some redundancy on the linker and
  54.          compiler  disks  with  regard  to  batch.ttp,  wait, and rm.  The
  55.          header  files  for  the  AES  and  VDI are not included since you
  56.          already  have  them  on  the standard kit.  You may configure the
  57.          .bat files any way you wish, but be especially vigilant to cf.bat
  58.          and  linkf.bat  which are intended to work as a pair.  cf.bat has
  59.          the  -f  option  which  is  telling the new c-compiler to use the
  60.          Motorola  fast  floating point.  If you mix cf.bat with link.bat,
  61.          the first symptom you will see is "printf.o multiply defined."  I
  62.          have  done  this  accidently with my keyboard that has a sticking
  63.          "k"  key.   If  you  want to be safe, just make a batch file that
  64.          compiles  and  links  your  file in one operation.  Remember also
  65.  
  66.  
  67.          _________________________________________________________________
  68.          ATARI ST DEVELOPERS              -1-                    June 1986
  69.  
  70.  
  71.  
  72.          Question and Answer Bulletin
  73.          _________________________________________________________________
  74.  
  75.  
  76.          that  you must add stdio.h and ctype.h as before if you use those
  77.          functions.
  78.          -----------------------------------------------------------------
  79.  
  80.  
  81.          2.  BIOS
  82.  
  83.          Q: How can you initiate a screen dump from the keyboard?
  84.  
  85.          A:  Hold down the <Alternate> key  and press <Help>.  Be sure you
  86.          have  done  the  correct  printer installation if you are using a
  87.          non-Atari  printer capable of doing raster dumps.  Repeat the key
  88.          sequence  to  halt  the print at any time.  The best part of this
  89.          feature  is  that you can activate it from any program even if it
  90.          does not use GEM.
  91.  
  92.          Q: How do you turn off the cursor in a TOS application?
  93.  
  94.          A:  Send  the  VT-52  escape to turn off the cursor.  Look in the
  95.          Hitchhiker's  Guide to the BIOS for a complete description of all
  96.          the escape codes.
  97.  
  98.          -----------------------------------------------------------------
  99.  
  100.  
  101.          3.  DOS
  102.  
  103.          Q:  How do I install partitions I have created with the hard disk
  104.          format program?
  105.  
  106.          A:   Select one of the drive icons on the desktop. Move the mouse
  107.          to  the  Options menu and select Install drive.  Change the drive
  108.          identifier  to  your  choice and select OK.  Be sure to do a Save
  109.          desktop  so  that  the  installed drive will appear each time you
  110.          boot.
  111.  
  112.          Q:  How can I recover some files I accidently trashed?
  113.  
  114.          A:  There is hope -- but not much.  If you have not created a new
  115.          file  since  your accident, you may be able to use a disk utility
  116.          to  view  sectors  and  piece  it  back together.  However, those
  117.          sectors  may  be scattered all over your disk.  The best medicine
  118.          is prevention.  Leave the confirm deletes option connected.
  119.          -----------------------------------------------------------------
  120.  
  121.  
  122.          4.  VDI
  123.  
  124.          Q:  Looking  into the VDIBIND library, I saw that there were many
  125.          functions  which couldn't be found in VDIBIND.H.  e.g. vro_cpyfm,
  126.          vs_clip.   What  is the rason for not including these in VDIBIND.
  127.          Can we include them or don't they work well?
  128.  
  129.          A:  VDIBIND.H  is  not  necessary because all functions return an
  130.          integer  value--if  ever.  All these functions are in the VDIBIND
  131.  
  132.  
  133.          _________________________________________________________________
  134.          ATARI ST DEVELOPERS              -2-                    June 1986
  135.  
  136.  
  137.  
  138.          Question and Answer Bulletin
  139.          _________________________________________________________________
  140.  
  141.  
  142.          object library.
  143.  
  144.          Q:  I  was  using vg_text to output a string.  When I switched to
  145.          line-a  to output the characters of the string one character at a
  146.          time it was slower -- why?
  147.  
  148.          A:  When you pass a string to the VDI you are performing only one
  149.          Trap or software interrupt.  If you use line-a, you do a software
  150.          interrupt--and all of the overhead--on each character you output.
  151.          In  the  end, the same code outputs the pixels to the video RAM.
  152.          In some cases, like this, VDI can exceed line-a.
  153.  
  154.          Q: What is the standard address of screen memory?
  155.  
  156.          A:  Unlike  older  systems,  the ST can have video display memory
  157.          located  anywhere  as  long  as  it is on 1k boundaries.  Various
  158.          device  drivers may be loaded in at boot time so it is impossible
  159.          to  say  that  video  memory has a fixed address.  The only thing
  160.          that  can  be  said  for  sure  about  the location is that it is
  161.          usually the high end of RAM.
  162.  
  163.          -----------------------------------------------------------------
  164.  
  165.  
  166.          5.  AES
  167.  
  168.          Q:  Is it possible to track the mouse through the process of menu
  169.          item  selection?  I need to change the appearance of items on the
  170.          fly.
  171.  
  172.          A:  No,  this is not an option of the AES.  The usual scenario is
  173.          to   stay  in  the  evnt_multi  until  a  menu_event  message  is
  174.          returned.
  175.  
  176.          Q:  How many parameters does the objc_edit command have?
  177.  
  178.          A: The correct number is five.  The AES manual incorrectly states
  179.          six.
  180.  
  181.          -----------------------------------------------------------------
  182.  
  183.  
  184.          6.  Desktop
  185.  
  186.          Q:   I  would like to know if information from the desktop.inf is
  187.          available  to  normal  applications.   I  have  noticed  that the
  188.          control  panel and VT 52 emulator accessories have access to this
  189.          information.
  190.  
  191.          A:   It  is the responsibility of every application in the system
  192.          to  save  and  restore  changes  to  system variables.  We do not
  193.          recommend   an  application  going  in  to  directly  change  the
  194.          desktop.inf.   There  is  a constant danger of user modifications
  195.          causing  damage to the system that cannot be supported.  The best
  196.          way  to change colors is through the vdi.  Modifying the hardware
  197.  
  198.  
  199.          _________________________________________________________________
  200.          ATARI ST DEVELOPERS              -3-                    June 1986
  201.  
  202.  
  203.  
  204.          Question and Answer Bulletin
  205.          _________________________________________________________________
  206.  
  207.  
  208.          registers directly is also discouraged since you are locking your
  209.          application  to one version of ST hardware.  There are also xbios
  210.          entries for changing and inquiring printer and rs-232 data.
  211.          -----------------------------------------------------------------
  212.  
  213.  
  214.          7.  BASIC
  215.  
  216.          Q: How can I access the RS-232 from BASIC?
  217.  
  218.          A:  Where X is a character:  For output use OUT 1,X and for input
  219.          use X = INP(1).
  220.  
  221.          -----------------------------------------------------------------
  222.  
  223.  
  224.          8. Development Tools
  225.  
  226.          Q:   The  function  itoa is not in the C-runtime libraries.  What
  227.          can I use for this function?
  228.  
  229.          A:   If  you have a special case where you need a small number of
  230.          digits in a hurry, you can write a quick C function to convert an
  231.          integer to ASCII characters.  Another way is if you have included
  232.          stdio, you can use sprintf to output an integer to a string.
  233.  
  234.          Q:  We are having serious troubles with C.  The functions getchar
  235.          and  stream  reading  does  not  work properly.  In fact a German
  236.          version has modified "stdio.h" definitions, (sic) though it works
  237.          better has still problems.
  238.  
  239.          A:   There  is  another version of stdio.h floating around Europe
  240.          which  uses  a #define of getchar to be a BIOS Bconin(CON).  This
  241.          does not help the scanf function however.  There is also a danger
  242.          in  using  this version because when you mix Gem DOS calls (which
  243.          the  C  run-time  uses),  and direct BIOS calls to get characters
  244.          from  the  keyboard.   A  symptom  of  this has been noted as "10
  245.          characters  disappearing"  as the DOS bufferes them up whenever a
  246.          printf  is called.  The safest replacements for getchar and scanf
  247.          are using Cconin and Cconrs+sscanf respectively.
  248.  
  249.          -----------------------------------------------------------------
  250.  
  251.  
  252.          9. New On Compuserve
  253.  
  254.          In  data  library 7 (for registered Atari Developers only) in the
  255.          Atari  Developers  SIG on Compuserve, the following files are new
  256.          this month:
  257.  
  258.          gemlib             Works with both Alcyon versions.
  259.          test.c             Example using stdio to lst: and con:.
  260.          qa4.doc            May Q/A newsletter.
  261.  
  262.  
  263.  
  264.  
  265.          _________________________________________________________________
  266.          ATARI ST DEVELOPERS              -4-                    June 1986
  267.  
  268.  
  269.  
  270.  
  271. Press <CR> to continue !øútנ¼ßXI1913©♪ «Ñh ò_P¢∙j❎ⁿMWל+p©1
  272. Ü⑤j¢   i✓àULÕ£Γsך∙S¼ÑR¼sõHFxùîלµ≤û③VOVףÜVןS⑧'89T≈vƒ!Yr
  273.  
  274.                 Bugs in the ST Resource Construction Set
  275.  
  276. The RCS originally shipped with the Atari Developers' Kit did not receive
  277. adequate testing, and as a result contains a number of bugs, two of which
  278. are show stoppers.  Due to numerous questions on the SIG, and Tom Hudson's
  279. suggestion, I am documenting them here.  (The statements here are my
  280. own, and have nothing to with Atari or DRI.  Use them at your own risk.)
  281.  
  282. Bug #1)  The RCS does not work properly with color systems.  The character
  283. size used is incorrect, resulting in objects which are twice as high as
  284. intended.  The only solution is to use the RCS with a monochrome system only.
  285.  
  286. Bug #2)  When using icons or bit images, the RCS may produce a resource file
  287. which causes an address error on the 68000.  This occurs because the RCS
  288. is not forcing the images to an even byte boundary.  Since the images are
  289. written immediately after strings, any resource with an odd number of bytes
  290. in the string will suffer from this problem (if it contains images as well).
  291. To work around: make a copy of the resource BEFORE adding ANY images.
  292. Then add the images and attempt to save the resource from the RCS.  If you
  293. get an error, restore from your backup, add one byte to any string, and try
  294. again.  Whenever editing ANY string, do the same thing.  ALWAYS keep a
  295. backup copy!  By the time the RCS bombs, your resource is history!
  296.  
  297. "Feature" #3)  The icon format expected by the RCS is rather obscure,
  298. shall we say.  This happened because the RCS expects to find icons written
  299. by the GEM IconEditor, which was never ported to the ST.  If you want to
  300. "roll your own", an example of the correc
  301.