home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 2 / fishmore-publicdomainlibraryvol.ii1991xetec.iso / fish / code_examples / cmanual_456 / acm3.lzh / LowLevelGraphics / Example3.c < prev    next >
C/C++ Source or Header  |  1991-01-12  |  7KB  |  220 lines
  1. /* Example 3                                                          */
  2. /* This example shows how to create a display that covers the entire  */
  3. /* display. This method is called "Overscan", and is primarly used in */
  4. /* video and graphics programs, but can also be used in games etc to  */
  5. /* make the display more interesting.                                 */
  6.  
  7. /* EXTRA INFORMATION                                                  */
  8. /* If you want your programs to work on both American (NTSC) and      */
  9. /* European (PAL) machines you must either:                           */
  10. /* 1. Not make the display taller than 200 lines. The program will    */
  11. /*    then run perfectly on both types of machines, BUT the European  */
  12. /*    user would be very annoyed since the last 56 lines could not    */
  13. /*    be used.                                                        */
  14. /* 2. Look at the GfxBase structure and see if the program is running */
  15. /*    on an American machine, set the height to max 200 lines, or if  */
  16. /*    the program is running on a European machine, set the height    */
  17. /*    to max 256 lines. (For interlaced displays: 400 or 512 lines)   */
  18. /*    Example:  if( GfxBase->DisplayFlags & NTSC )                    */
  19. /*                Height=200;                                         */
  20. /*              if( GfxBase->DisplayFlags & PAL )                     */
  21. /*                Height=256;                                         */
  22.  
  23.  
  24. #include <intuition/intuition.h>
  25. #include <graphics/gfxbase.h>
  26.  
  27.  
  28. #define WIDTH       352 /* Display 352 pixels wide. [Overscan]       */ 
  29. #define NTSC_HEIGHT 262 /* Display 262 lines high. [NTSC - Overscan] */
  30. #define PAL_HEIGHT  287 /* Display 287 lines high. [PAL - Overscan]  */
  31.  
  32. /* The ViewPort should be placed above and more to the    */
  33. /* left than what is normally used:                       */
  34. #define DXOFFSET -16 /* DxOffset -16 pixels.              */
  35. #define DYOFFSET -31 /* DyOffset -31 lines.               */
  36.  
  37. #define DEPTH      2 /* 2 BitPlanes should be used, gives four colours. */
  38. #define COLOURS    8 /* 2^2 = 4                                         */
  39.  
  40.  
  41. struct IntuitionBase *IntuitionBase;
  42. struct GfxBase *GfxBase;
  43.  
  44.  
  45. struct View my_view;
  46. struct View *my_old_view;
  47. struct ViewPort my_view_port;
  48. struct RasInfo my_ras_info;
  49. struct BitMap my_bit_map;
  50. struct RastPort my_rast_port;
  51.  
  52.  
  53. UWORD my_color_table[] =
  54. {
  55.   0x000, /* Colour 0, Black */
  56.   0xF00, /* Colour 1, Red   */
  57.   0x0F0, /* Colour 2, Green */
  58.   0x00F, /* Colour 3, Blue  */
  59. };
  60.  
  61.  
  62. SHORT height;  
  63.  
  64.  
  65. void clean_up();
  66. void main();
  67.  
  68.  
  69. void main()
  70. {
  71.   UWORD *pointer;
  72.   int loop;
  73.  
  74.  
  75.   /* Open the Intuition library: */
  76.   IntuitionBase = (struct IntuitionBase *)
  77.     OpenLibrary( "intuition.library", 0 );
  78.   if( !IntuitionBase )
  79.     clean_up( "Could NOT open the Intuition library!" );
  80.  
  81.   /* Open the Graphics library: */
  82.   GfxBase = (struct GfxBase *)
  83.     OpenLibrary( "graphics.library", 0 );
  84.   if( !GfxBase )
  85.     clean_up( "Could NOT open the Graphics library!" );
  86.  
  87.  
  88.   /* Check if the program is running on a PAL or NTSC machine: */
  89.   if( GfxBase->DisplayFlags & PAL )
  90.   {
  91.     height = PAL_HEIGHT;
  92.     printf( "You have an European (PAL) machine!\n" );
  93.   }
  94.   else
  95.   {
  96.     height = NTSC_HEIGHT;
  97.     printf( "You have an American (NTSC) machine!\n" );
  98.   }
  99.  
  100.  
  101.   /* Save the current View, so we can restore it later: */
  102.   my_old_view = GfxBase->ActiView;
  103.  
  104.  
  105.   /* 1. Prepare the View structure, and give it a pointer to */
  106.   /*    the first ViewPort:                                  */
  107.   InitView( &my_view );
  108.   my_view.ViewPort = &my_view_port;
  109.  
  110.  
  111.   /* 2. Prepare the ViewPort structure, and set some important values:   */
  112.   InitVPort( &my_view_port );
  113.   my_view_port.DWidth = WIDTH;         /* Set the width.                */
  114.   my_view_port.DHeight = height;       /* Set the height.               */
  115.   my_view_port.DxOffset = DXOFFSET;    /* Set the display X offset.     */
  116.   my_view_port.DyOffset = DYOFFSET;    /* Set the display Y offset.     */
  117.   my_view_port.RasInfo = &my_ras_info; /* Give it a pointer to RasInfo. */
  118.   my_view_port.Modes = NULL;           /* Low resolution.               */
  119.  
  120.  
  121.   /* 3. Get a colour map, link it to the ViewPort, and prepare it: */
  122.   my_view_port.ColorMap = (struct ColorMap *) GetColorMap( COLOURS );
  123.   if( my_view_port.ColorMap == NULL )
  124.     clean_up( "Could NOT get a ColorMap!" );
  125.  
  126.   /* Get a pointer to the colour map: */
  127.   pointer = (UWORD *) my_view_port.ColorMap->ColorTable;
  128.  
  129.   /* Set the colours: */
  130.   for( loop = 0; loop < COLOURS; loop++ )
  131.     *pointer++ = my_color_table[ loop ];
  132.  
  133.  
  134.   /* 4. Prepare the BitMap: */
  135.   InitBitMap( &my_bit_map, DEPTH, WIDTH, height );
  136.  
  137.   /* Allocate memory for the Raster: */ 
  138.   for( loop = 0; loop < DEPTH; loop++ )
  139.   {
  140.     my_bit_map.Planes[ loop ] = (PLANEPTR) AllocRaster( WIDTH, height );
  141.     if( my_bit_map.Planes[ loop ] == NULL )
  142.       clean_up( "Could NOT allocate enough memory for the raster!" );
  143.  
  144.     /* Clear the display memory with help of the Blitter: */
  145.     BltClear( my_bit_map.Planes[ loop ], RASSIZE( WIDTH, height ), 0 );
  146.   }
  147.  
  148.   
  149.   /* 5. Prepare the RasInfo structure: */
  150.   my_ras_info.BitMap = &my_bit_map; /* Pointer to the BitMap structure.  */
  151.   my_ras_info.RxOffset = 0;         /* The top left corner of the Raster */
  152.   my_ras_info.RyOffset = 0;         /* should be at the top left corner  */
  153.                                     /* of the display.                   */
  154.   my_ras_info.Next = NULL;          /* Single playfield - only one       */
  155.                                     /* RasInfo structure is necessary.   */
  156.  
  157.   /* 6. Create the display: */
  158.   MakeVPort( &my_view, &my_view_port );
  159.   MrgCop( &my_view );
  160.  
  161.  
  162.   /* 7. Prepare the RastPort, and give it a pointer to the BitMap. */
  163.   InitRastPort( &my_rast_port );
  164.   my_rast_port.BitMap = &my_bit_map;
  165.   
  166.  
  167.   /* 8. Show the new View: */
  168.   LoadView( &my_view );
  169.  
  170.  
  171.   /* Set the draw mode to JAM1. FgPen's colour will be used. */
  172.   SetDrMd( &my_rast_port, JAM1 );
  173.   /* Draw 10000 pixels in seven different colours, randomly. */ 
  174.   for( loop = 0; loop < 10000; loop++ )
  175.   {
  176.     /* Set FgPen's colour (1-7, 0 used for the the background). */
  177.     SetAPen( &my_rast_port, rand() % (COLOURS-1) + 1 );
  178.     /* Write a pixel somewere on the display: */
  179.     WritePixel( &my_rast_port, rand() % WIDTH, rand() % height );
  180.   }
  181.  
  182.  
  183.   /* 9. Restore the old View: */
  184.   LoadView( my_old_view );
  185.  
  186.  
  187.   /* Free all allocated resources and leave. */
  188.   clean_up( "THE END" );
  189. }
  190.  
  191.  
  192. /* Returns all allocated resources: */
  193. void clean_up( message )
  194. STRPTR message;
  195. {
  196.   int loop;
  197.  
  198.   /* Free automatically allocated display structures: */
  199.   FreeVPortCopLists( &my_view_port );
  200.   FreeCprList( my_view.LOFCprList );
  201.   
  202.   /* Deallocate the display memory, BitPlane for BitPlane: */
  203.   for( loop = 0; loop < DEPTH; loop++ )
  204.     if( my_bit_map.Planes[ loop ] )
  205.       FreeRaster( my_bit_map.Planes[ loop ], WIDTH, height );
  206.  
  207.   /* Deallocate the ColorMap: */
  208.   if( my_view_port.ColorMap ) FreeColorMap( my_view_port.ColorMap );
  209.  
  210.   /* Close the Graphics library: */
  211.   if( GfxBase ) CloseLibrary( GfxBase );
  212.  
  213.   /* Close the Intuition library: */
  214.   if( IntuitionBase ) CloseLibrary( IntuitionBase );
  215.  
  216.   /* Print the message and leave: */
  217.   printf( "%s\n", message ); 
  218.   exit();
  219. }
  220.