home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / GrafikenKartenSoft / CYBERPIC.LHA / cybergfx / developer / autodoc / cybergraphics.doc
Encoding:
Text File  |  1994-12-31  |  21.0 KB  |  673 lines
  1. TABLE OF CONTENTS
  2.  
  3. cybergraphics.library/AllocModeList
  4. cybergraphics.library/BestCModeIDTagList
  5. cybergraphics.library/CModeRequestTagList
  6. cybergraphics.library/DoCDrawMethodTagList
  7. cybergraphics.library/FillPixelArray
  8. cybergraphics.library/FreeModeList
  9. cybergraphics.library/GetCyberMapAttr
  10. cybergraphics.library/GetCyberIDAttr
  11. cybergraphics.library/IsCyberModeID
  12. cybergraphics.library/MovePixelArray
  13. cybergraphics.library/ReadPixelArray
  14. cybergraphics.library/ReadRGBPixel
  15. cybergraphics.library/SwapPixelArray
  16. cybergraphics.library/WritePixelArray
  17. cybergraphics.library/WriteRGBPixel
  18. cybergraphics.library/BestCyberModeID   cybergraphics.library/BestCyberModeID
  19.  
  20.  
  21.    NAME
  22.     BestCModeIDTagList  -- calculate the best ModeID with given parameters
  23.  
  24.    SYNOPSIS
  25.     ID = BestCModeIDTagList(TagItems)
  26.     d0                     a0
  27.  
  28.     ID = BestCModeIDTagList(Tag1, ...)
  29.  
  30.    FUNCTION
  31.     To determine the best cybergraphics ModeID to fit the parameters set
  32.     in the TagList.
  33.  
  34.    INPUTS
  35.     TagItems - A pointer to an array of TagItems.
  36.  
  37.    TAGS
  38.  
  39.         CYBRBIDTG_Depth (ULONG) - depth the returned ModeID must support
  40.                                   Default is 8
  41.  
  42.         CYBRBIDTG_NominalWidth (UWORD),
  43.         CYBRBIDTAG_NominalHeight (UWORD) - desired width and height the ModeID
  44.                                            should have
  45.  
  46.         CYBRBIDTG_MonitorID (ULONG) - if multiple graphics boards are
  47.                                       installed in the system, you can choose
  48.                                       the desired one with this tag
  49.  
  50.    RESULT
  51.     ID      - ID of the best mode to use, or INVALID_ID if a match could
  52.               not be found.
  53.  
  54. cybergraphics.lib/CModeRequestTagList    cybergraphics.lib/CModeRequestTagList
  55.  
  56.  
  57.    NAME
  58.     CModeRequestTagList -- get screenmode from user using a requester.
  59.  
  60.    SYNOPSIS
  61.     result = CModeRequestTagList(requester,tags);
  62.     D0                            A0        A1
  63.  
  64.     LONG CModeRequestTagList(APTR,struct TagItem *);
  65.  
  66.    FUNCTION
  67.     Prompts the user for input by showing all available cybergraphics
  68.     screenmodes in a requester.
  69.     If the user cancels or the system aborts the request, FALSE is returned,
  70.     otherwise the displaymode id of the selected screenmode.
  71.  
  72.    INPUTS
  73.     requester - not used currently. you have to set it to 0 !
  74.     tags - pointer to an optional tag list which may be used to
  75.            control features of the requester.
  76.  
  77.    TAGS
  78.  
  79.     Tags used for the screen mode requester
  80.  
  81.     CYBRMREQ_Screen (struct Screen *) - Screen on which to open the requester.
  82.             default locale will be used.
  83.  
  84.     CYBRMREQ_WinTitle (STRPTR) - Title to use for the requesting window.
  85.  
  86.     CYBRMREQ_OKText (STRPTR) - Label of the positive gadget in the
  87.             requester. English default is "OK".
  88.  
  89.     CYBRMREQ_CancelText (STRPTR) - Label of the negative gadget in the
  90.             requester. English default is "Cancel".
  91.  
  92.     CYBRMREQ_MinWidth (ULONG) - The minimum display width to let the user
  93.             choose. Default is 320.
  94.  
  95.     CYBRMREQ_MaxWidth (ULONG) - The maximum display width to let the user
  96.             choose. Default is 1600.
  97.  
  98.     CYBRMREQ_MinHeight (ULONG) - The minimum display height to let the user
  99.             choose. Default is 240.
  100.  
  101.     CYBRMREQ_MaxHeight (ULONG) - The maximum display height to let the user
  102.             choose. Default is 1200.
  103.  
  104.     CYBRMREQ_MinDepth (UWORD) - The minimum display depth to let the user
  105.             choose. Default is 8.
  106.  
  107.     CYBRMREQ_MaxDepth (UWORD) - The maximum display depth to let the user
  108.             choose. Default is 32.
  109.  
  110.     CYBRMREQ_CModelArray (UWORD *) - Array of color models which should be
  111.             available for screenmode selection. Currently supported
  112.             colormodels are:
  113.  
  114.             PIXFMT_LUT8
  115.             PIXFMT_RGB15
  116.             PIXFMT_BGR15
  117.             PIXFMT_RGB15PC
  118.             PIXFMT_BGR15PC
  119.             PIXFMT_RGB16
  120.             PIXFMT_BGR16
  121.             PIXFMT_RGB16PC
  122.             PIXFMT_BGR16PC
  123.             PIXFMT_RGB24
  124.             PIXFMT_BGR24
  125.             PIXFMT_ARGB32
  126.             PIXFMT_BGRA32
  127.  
  128.             default is all colormodels available, nothing filtered
  129.  
  130.    RESULT
  131.     result - 0 if the user cancelled the requester or if something
  132.          prevented the requester from opening. If != 0 the displaymode
  133.          id of the selected screenmode is returned.
  134.  
  135.    BUGS
  136.     The requester structure is not supported in (v40)
  137. cybergraphics.lib/DoCDrawMethodTagList cybergraphics.lib/DoCDrawMethodTagList
  138.  
  139.  
  140.    NAME
  141.     DoCDrawMethodTagList - Do the given hook for the supplied rastport
  142.  
  143.    SYNOPSIS
  144.     DoCDrawMethodTagList(hook,rport,taglist)
  145.                           a0   a1    a2
  146.  
  147.     void DoCDrawMethodTagList(struct Hook *,struct RastPort *,
  148.                 struct TagItem *)
  149.  
  150.    FUNCTION
  151.     This function will call the given hook for the given rastport. Is is
  152.     mainly used to do direct bitmap modifications in a locked graphics
  153.     environment. You have to support ALL known color models, so only use
  154.     this call if you really need it !!
  155.     
  156.  
  157.    INPUTS
  158.  
  159.     hook - pointer to callback hook which will be called
  160.            with object == (struct RastPort *)
  161.            and message == [ (APTR) memptr,
  162.                             (ULONG) offsetx, (ULONG) offsety,
  163.                 (ULONG) xsize, (ULONG) ysize,
  164.                 (ULONG) bytesperrow, (UWORD) bytesperpix,
  165.                 (UWORD) colormodel]
  166.  
  167.            Where colormodel is one of the following:
  168.  
  169.             PIXFMT_LUT8
  170.             PIXFMT_RGB15
  171.             PIXFMT_BGR15
  172.             PIXFMT_RGB15PC
  173.             PIXFMT_BGR15PC
  174.             PIXFMT_RGB16
  175.             PIXFMT_BGR16
  176.             PIXFMT_RGB16PC
  177.             PIXFMT_BGR16PC
  178.             PIXFMT_RGB24
  179.             PIXFMT_BGR24
  180.             PIXFMT_ARGB32
  181.             PIXFMT_BGRA32
  182.  
  183.     rport- A pointer to a cybergraphics RastPort
  184.  
  185.     tags - optional taglist, currently not used. Set it to NULL
  186.  
  187.     NOTES
  188.     Use this call only if you want high speed. Remember that you have to
  189.     handle all color models ! Do not use ANY os functions in your hook.
  190.     They would cause unpredictable results.
  191.  
  192.  
  193.     BUGS
  194.     In the current release this function only works on screen rastports.
  195.     Because of this limitation clipping is not supported.
  196. cybergraphics.library/GetCyberMapAttr    cybergraphics.library/GetCyberMapAttr
  197.  
  198.  
  199.    NAME
  200.     GetCyberMapAttr -- Returns information about a cybergraphics bitmap
  201.  
  202.    SYNOPSIS
  203.      value=GetCyberMapAttr(bitmap,attribute_number);
  204.     d0                     a0       d1
  205.  
  206.     ULONG GetCyberMapAttr(struct BitMap *,ULONG);
  207.  
  208.    FUNCTION
  209.         Determines information about a extended cybergraphics bitmap.
  210.     This function should be used instead of making any assumptions about
  211.     fields in the bitmap. This will    provide future compatibility.
  212.  
  213.    INPUTS
  214.     bitmap - pointer to a cybergraphics bitmap structure
  215.  
  216.     attribute_number - A number telling cybergraphics which attribute
  217.                of the bitmap should be returned:
  218.  
  219.         CYBRMATTR_XMOD returns BytesPerRow of the supplied bitmap
  220.  
  221.         CYBRMATTR_BPPIX returns number of bytes per pixel
  222.  
  223.         CYBRMATTR_PIXFMT return the pixel format of the bitmap
  224.  
  225.         CYBRMATTR_WIDTH return width of the bitmap in pixels
  226.  
  227.         CYBRMATTR_HEIGHT return the height in lines
  228.  
  229.         CYBRMATTR_DEPTH returns bits per pixel
  230.  
  231.    BUGS
  232.  
  233.    NOTES
  234.  
  235.     Unknown attributes are reserved for future use, and return (-1L).
  236.  
  237.     You should know what you are doing if you call this function !
  238.     Don't apply it on a non cybergraphics bitmap !
  239.  
  240. cybergraphics.library/GetCyberIDAttr    cybergraphics.library/GetCyberIDAttr
  241.  
  242.  
  243.    NAME
  244.     GetCyberIDAttr -- Returns information about a cybergraphics id
  245.  
  246.    SYNOPSIS
  247.      value=GetCyberIDAttr(CyberIDAttr,CyberDisplayModeID);
  248.     d0                     d0           d1
  249.  
  250.     ULONG GetCyberIDAttr(ULONG,ULONG);
  251.  
  252.    FUNCTION
  253.         Determines information about a specified displaymode id.
  254.  
  255.    INPUTS
  256.     CyberDisplayModeID - cybergraphics mode id
  257.  
  258.     attribute_number - A number telling cybergraphics which attribute
  259.                of the displaymode id should be returned:
  260.  
  261.         CYBRIDATTR_PIXFMT return the pixel format of the supplied
  262.                 screenmode id
  263.  
  264.         CYBRIDATTR_WIDTH returns visible width in pixels
  265.         CYBRIDATTR_HEIGHT returns visible height in lines
  266.         CYBRIDATTR_DEPTH returns bits per pixel
  267.         CYBRIDATTR_BPPIX should return BytesPerPixel
  268.  
  269.    BUGS
  270.  
  271.    NOTES
  272.  
  273.     Unknown attributes are reserved for future use, and return (-1L).
  274.  
  275.     You should know what you are doing if you call this function !
  276.     Don't apply it on a non cybergraphics displaymode !
  277.  
  278.  
  279. cybergraphics.library/IsCyberModeID       cybergraphics.library/IsCyberModeID
  280.  
  281.  
  282.    NAME
  283.     IsCyberModeID -- returns whether supplied ModeID is a cybergraphics id
  284.  
  285.    SYNOPSIS
  286.     result = IsCyberModeID(modeID)
  287.     D0                       D0
  288.  
  289.     BOOL IsCyberModeID(ULONG)
  290.  
  291.    FUNCTION
  292.     Returns whether the supplied ModeID is a cybergraphics.library mode
  293.     identifier.
  294.  
  295.    INPUTS
  296.     modeID -- a 32 bit display identifier.
  297.  
  298.    RESULT
  299.     result - Flag to indicate if modeID is a cybergraphics ID
  300.  
  301. cybergraphics.library/FillPixelArray     cybergraphics.library/FillPixelArray
  302.  
  303.  
  304.    NAME
  305.         FillPixelArray -- fill a rectangular area with the supplied ARGB value
  306.     starting at a specified x,y location and continuing through to another
  307.     x,y location within a certain RastPort
  308.  
  309.    SYNOPSIS
  310.     count = FillPixelArray(RastPort,DestX, DestY,SizeX,SizeY,ARGB)
  311.     D0             A1     D0:16  D1:16 D2:16 D3:16 D4:32
  312.             
  313.  
  314.     LONG FillPixelArray(struct RastPort *,UWORD,UWORD,UWORD,UWORD,ULONG)
  315.  
  316.    FUNCTION
  317.     For each pixel in a rectangular region, write the supplied color value
  318.     into the bitmap used to describe a particular rastport.
  319.  
  320.    INPUTS
  321.     RastPort -  pointer to a RastPort structure
  322.     (DestX,DestY) - starting point in the RastPort
  323.     (SizeX,SizeY) - size of the rectangle that should be transfered
  324.         ARGB  - the desired color in AARRGGBB format. Every component
  325.         allocates 8 bits of the returned longword. The coding is as
  326.         follows:
  327.  
  328.                  AA - 8-bit alpha channel component
  329.               (set it to 00 if you do not use it !)
  330.                  RR - 8-bit red component of the pixel
  331.                  GG - 8-bit green component
  332.                  BB - 8-bit blue component
  333.  
  334.    RESULT
  335.     count will be set to the number of pixels plotted
  336.  
  337.    NOTES
  338.     This function should only be used on screens depths > 8 bits.
  339.  
  340.    BUGS
  341.     In the current release this function only works on screen rastports.
  342.     Because of this limitation clipping is not supported.
  343.  
  344.  
  345. cybergraphics.library/InvertPixelArray     cybergraphics.library/InvertPixelArray
  346.  
  347.  
  348.    NAME
  349.         InvertPixelArray -- invert a rectangular area tarting at a specified x,y
  350.     location and continuing through to another x,y location within a certain
  351.     RastPort
  352.  
  353.    SYNOPSIS
  354.     count = InvertPixelArray(RastPort,DestX, DestY,SizeX,SizeY)
  355.     D0               A1     D0:16  D1:16 D2:16 D3:16
  356.             
  357.  
  358.     LONG InvertPixelArray(struct RastPort *,UWORD,UWORD,UWORD,UWORD)
  359.  
  360.    FUNCTION
  361.     Invert each pixel in a rectangular region.
  362.  
  363.    INPUTS
  364.     RastPort -  pointer to a RastPort structure
  365.     (DestX,DestY) - starting point in the RastPort
  366.     (SizeX,SizeY) - size of the rectangle that should be transfered
  367.  
  368.    RESULT
  369.     count will be set to the number of pixels plotted
  370.  
  371.    NOTES
  372.     This function should only be used on screens depths > 8 bits.
  373.  
  374.    BUGS
  375.     In the current release this function only works on screen rastports.
  376.     Because of this limitation clipping is not supported.
  377.  
  378.  
  379. cybergraphics.library/MovePixelArray     cybergraphics.library/MovePixelArray
  380.  
  381.  
  382.    NAME
  383.         MovePixelArray -- move the color values of a rectangular area of
  384.     pixels starting at a specified x,y location and continuing through
  385.     to another x,y location within a certain RastPort
  386.  
  387.    SYNOPSIS
  388.     count = MovePixelArray(SrcX, SrcY, RastPort,SrcX , SrcY ,SizeX, SizeY)
  389.     D0               D0:16 D1:16  A1      D2:16  D3:16 D4:16  D5:16
  390.  
  391.     LONG MovePixelArray(UWORD,UWORD,struct RastPort *,UWORD,UWORD,UWORD,
  392.                 UWORD)
  393.  
  394.    FUNCTION
  395.     For each pixel in a rectangular region, move the pixel value from a
  396.     specified source to a specified destination
  397.  
  398.    INPUTS
  399.     (SrcX,SrcY) - starting point in the destination rectangle
  400.     RastPort -  pointer to a RastPort structure
  401.     (DestX,DestY) - starting point in the destination rectangle
  402.     (SizeX,SizeY) - size of the rectangle that should be transfered
  403.  
  404.    RESULT
  405.     count will be set to the number of pixels moved
  406.  
  407.    NOTES
  408.     This function should only be used on screens depths > 8 bits.
  409.     The blitter can be used to move the data if the bitmap is in display
  410.     memory. This is way you should use this call.
  411.  
  412.    BUGS
  413.     In the current release this function only works on screen rastports.
  414.     Because of that limitation clipping is not supported.
  415.  
  416. cybergraphics.library/ReadPixelArray     cybergraphics.library/ReadPixelArray
  417.  
  418.  
  419.    NAME
  420.         ReadPixelArray -- Read the color values of a rectangular array of
  421.     pixels starting at a specified x,y location and continuing through
  422.     to another x,y location within a certain RastPort
  423.  
  424.    SYNOPSIS
  425.     count = ReadPixelArray(destRect,DestX,DestY,DestMod,RastPort,SrcX ,
  426.     D0              A0    D0:16 D1:16 D2:16     A1     D3:16
  427.                 SrcY ,SizeX,SizeY,DestFormat)
  428.                 D4:16 D5:16 D6:16    D7
  429.  
  430.     LONG ReadPixelArray(APTR *,UWORD,UWORD,UWORD,struct RastPort *,UWORD,
  431.                 UWORD,UWORD,UWORD,UBYTE)
  432.  
  433.    FUNCTION
  434.     For each pixel in a rectangular region, write the color value to a
  435.     linear array of color values from the bitmap used to describe a
  436.     particular rastport.
  437.  
  438.    INPUTS
  439.     destRect - pointer to an array of pixels where to write the pixel
  440.                data to. The pixel format is specified in DestFormat
  441.     (DestX,DestY) - starting point in the destination rectangle
  442.     DestMod - The number of bytes per row in the destination rectangle.
  443.     RastPort -  pointer to a RastPort structure
  444.     (SrcX,SrcY) - starting point in the RastPort
  445.     (SizeX,SizeY) - size of the rectangle that should be transfered
  446.     DestFormat - pixel format in the destination rectangle
  447.                 Currently supported formats are:
  448.  
  449.                 RECTFMT_RGB  3 bytes per pixel, one byte red, one blue
  450.                              and one byte green component
  451.  
  452.                 RECTFMT_RGBA 4 bytes per pixel, one byte red, one blue,
  453.                              one byte green component and the last
  454.                                  byte is alpha channel information which
  455.                          is 0 if the board does not support alpha
  456.                                  channel
  457.  
  458.                 RECTFMT_ARGB 4 bytes per pixel, one byte red, one blue,
  459.                              one byte green component and the first
  460.                                  byte is alpha channel information. If the
  461.                                  board does not support alpha channel a 
  462.                          0 is returned for alpha channel information
  463.  
  464.    RESULT
  465.     count will be set to the number of pixels read
  466.  
  467.    NOTES
  468.     This function should only be used on screens depths > 8 bits.
  469.  
  470.    BUGS
  471.     In the current release this function only works on screen rastports.
  472.     Because of that limitation clipping is not supported.
  473.  
  474. cybergraphics.library/SwapPixelArray     cybergraphics.library/SwapPixelArray
  475.  
  476.  
  477.    NAME
  478.         ReadPixelArray -- Swap the color values of a rectangular array of
  479.     pixels starting at a specified x,y location and continuing through
  480.     to another x,y location within a certain RastPort
  481.  
  482.    SYNOPSIS
  483.     count = SwapPixelArray(MemRect,MemX  ,MemY,MemMod,RastPort, RastX ,
  484.     D0              A0   D0:16 D1:16 D2:16     A1     D3:16
  485.                 RastY ,SizeX,SizeY,MemFormat)
  486.                 D4:16 D5:16 D6:16    D7
  487.  
  488.     LONG ReadPixelArray(APTR *,UWORD,UWORD,UWORD,struct RastPort *,UWORD,
  489.                 UWORD,UWORD,UWORD,UBYTE)
  490.  
  491.    FUNCTION
  492.     For each pixel in a rectangular region, swap the color values of a
  493.     linear array of color values and a bitmap used to describe a
  494.     particular rastport.
  495.  
  496.    INPUTS
  497.     MemRect - pointer to an array of pixels where to write the pixel
  498.               data of the bitmapto. The pixel format is specified in
  499.           MemFormat
  500.     (MemX,MemY) - starting point in the memory rectangle
  501.     MemMod - The number of bytes per row in the memory rectangle.
  502.     RastPort -  pointer to a RastPort structure
  503.     (RastX,RastY) - starting point in the RastPort rectangle
  504.     (SizeX,SizeY) - size of the rectangle that should be transfered
  505.     MemFormat - pixel format in the memory rectangle
  506.                 Currently supported formats are:
  507.  
  508.                 RECTFMT_RGB  3 bytes per pixel, one byte red, one blue
  509.                              and one byte green component
  510.  
  511.                 RECTFMT_RGBA 4 bytes per pixel, one byte red, one blue,
  512.                              one byte green component and the last
  513.                                  byte is alpha channel information which
  514.                          is 0 if the board does not support alpha
  515.                                  channel
  516.  
  517.                 RECTFMT_ARGB 4 bytes per pixel, one byte red, one blue,
  518.                              one byte green component and the first
  519.                                  byte is alpha channel information. If the
  520.                                  board does not support alpha channel a 
  521.                          0 is returned for alpha channel information
  522.  
  523.    RESULT
  524.     count will be set to the number of pixels swapped
  525.  
  526.    NOTES
  527.     This function should only be used on screens depths > 8 bits.
  528.  
  529.    BUGS
  530.     In the current release this function only works on screen rastports.
  531.     Because of that limitation clipping is not supported.
  532.  
  533. cybergraphics.library/ReadRGBPixel          cybergraphics.library/ReadRGBPixel
  534.  
  535.  
  536.    NAME
  537.         ReadRGBPixel -- Reads a pixel from a specified location
  538.  
  539.    SYNOPSIS
  540.         color = ReadRGBPixel(RastPort,x ,y )
  541.         D0                     A0     D0 D1
  542.  
  543.         ULONG ReadRGBPixel(struct RastPort *,UWORD,UWORD);
  544.  
  545.    FUNCTION
  546.     Read the Alpha,Red,Green & Blue 8-bit color value of the pixel at a
  547.     specified x,y location within a certain RastPort
  548.  
  549.    INPUTS
  550.     rp -  pointer to a RastPort structure
  551.         x,y    - the coordinates of the pixel
  552.  
  553.    RESULT
  554.         color  - the desired color in AARRGGBB format. Every component
  555.          allocates 8 bits of the returned longword. The coding is as
  556.          follows:
  557.  
  558.                  AA - 8-bit alpha channel component
  559.               (boards which do not have an alpha channel return 00)
  560.                  RR - 8-bit red component of the pixel
  561.                  GG - 8-bit green component
  562.                  BB - 8-bit blue component
  563.  
  564.   NOTES
  565.     This function should only be used on screens depths > 8 bits. Use
  566.     ReadPixel() on 8 bit screens !
  567.  
  568.   BUGS
  569.     In the current release this function only works on screen rastports.
  570.     Because of that limitation clipping is not supported.
  571.  
  572. cybergraphics.library/WritePixelArray   cybergraphics.library/WritePixelArray
  573.  
  574.  
  575.    NAME
  576.         WritePixelArray -- write the color value of a rectangular array of
  577.     pixels starting at a specified x,y location and continuing through
  578.     to another x,y location within a certain RastPort
  579.  
  580.    SYNOPSIS
  581.     count = WritePixelArray(srcRect,SrcX ,SrcY ,SrcMod,RastPort,DestX,
  582.     D0               A0   D0:16 D1:16 D2:16     A1    D3:16
  583.                 DestY,SizeX,SizeY,SrcFormat)
  584.                 D4:16 D5:16 D6:16    D7
  585.  
  586.     LONG WritePixelArray(APTR *,UWORD,UWORD,UWORD,struct RastPort *,UWORD,
  587.                  UWORD,UWORD,UWORD,UBYTE)
  588.  
  589.    FUNCTION
  590.     For each pixel in a rectangular region, write the color value from a
  591.     linear array of color values into the bitmap used to describe a
  592.     particular rastport.
  593.  
  594.    INPUTS
  595.     srcRect - pointer to an array of pixels from which to fetch the
  596.               pixel data. The pixel format is specified in SrcFormat
  597.     (SrcX,SrcY) - starting point in the source rectangle
  598.     SrcMod - The number of bytes per row in the source rectangle.
  599.     RastPort -  pointer to a RastPort structure
  600.     (DestX,DestY) - starting point in the RastPort
  601.     (SizeX,SizeY) - size of the rectangle that should be transfered
  602.     SrcFormat - pixel format in the source rectangle
  603.                 Currently supported formats are:
  604.  
  605.                 RECTFMT_RGB  3 bytes per pixel, one byte red, one blue
  606.                              and one byte green component
  607.  
  608.                 RECTFMT_RGBA 4 bytes per pixel, one byte red, one blue,
  609.                              one byte green component and the last
  610.                                  byte is alpha channel information. If you
  611.                                  do not use alpha channel set this byte to
  612.                          0 !!!
  613.  
  614.                 RECTFMT_ARGB 4 bytes per pixel, one byte red, one blue,
  615.                              one byte green component and the first
  616.                                  byte is alpha channel information. If you
  617.                                  do not use alpha channel set this byte to
  618.                          0 !!!
  619.  
  620.    RESULT
  621.     count will be set to the number of pixels plotted
  622.  
  623.    NOTES
  624.     This function should only be used on screens depths > 8 bits. Use
  625.     WritePixelArray8() on 8 bit screens !
  626.  
  627.    BUGS
  628.     In the current release this function only works on screen rastports.
  629.     Because of that limitation clipping is not supported.
  630.  
  631.  
  632. cybergraphics.library/WriteRGBPixel        cybergraphics.library/WriteRGBPixel
  633.  
  634.  
  635.    NAME
  636.         WriteRGBPixel -- Writes a pixel to a specified location
  637.  
  638.    SYNOPSIS
  639.         error = WriteRGBPixel(RastPort,x ,y ,color)
  640.         D0                      A0     D0 D1 d2
  641.  
  642.         ULONG WriteRGBPixel(struct RastPort *,UWORD,UWORD,ULONG);
  643.  
  644.    FUNCTION
  645.     Write the Alpha,Red,Green & Blue 8-bit color value of the given color
  646.     to a specified x,y location within a certain RastPort
  647.  
  648.    INPUTS
  649.     rp     - pointer to a RastPort structure
  650.         x,y    - the coordinates of the pixel
  651.         color  - the desired color in AARRGGBB format. Every component
  652.          allocates 8 bits of the returned longword. The coding is as
  653.          follows:
  654.  
  655.                  AA - 8-bit alpha channel component
  656.               (set it to 00 if you dont want to use it !)
  657.                  RR - 8-bit red component of the pixel
  658.                  GG - 8-bit green component
  659.                  BB - 8-bit blue component
  660.  
  661.    RESULT
  662.     error = 0 if pixel succesfully changed
  663.           = -1 if (x,y) is outside the rastport
  664.  
  665.    NOTES
  666.     This function should only be used on screens depths > 8 bits. Use
  667.     WritePixel() on 8 bit screens !
  668.  
  669.    BUGS
  670.     In the current release this function only works on screen rastports.
  671.     Because of that limitation clipping is not supported.
  672.  
  673.