BlitImageAlphaPostMultColour - Learn To Code - PlayBASIC Documentation

BlitImageAlphaPostMultColour

BlitImageAlphaPostMultColour ThisImage, Xpos, Ypos, BlendColour

Parameters:

    ThisImage = The Index of the image you wish to draw
    Xpos = The X coordinate to draw this image
    Ypos = The Y coordinate to draw this image
    BlendColour = The RGB Colour to blend this surface after it's been drawn

Returns: NONE

BlitImageAlphaPostMultColour is similar to the DrawImage function, except it has post processing. What it does, is it draws your selected image, but it also performs a Alpha Colour Multiply on the image with your selected colour. So it's the equivalent using DrawImage to first draw the image as is, then going back and drawing a BOX with an AlphaMult InkMode over it.

The combined processing is not just to save you a few lines of code, it's actually a more optimal way of performing this action.

FACTS:

     * BlitImageAlphaPostMultColour alters the source image.

     * BlitImageAlphaPostMultColour is only intend for drawing FX or AFX formatted surfaces.

     * BlitImageAlphaPostMultColour doesn't support mask & alpha channel transparency.

Example Source: Download This Example

; Inlude the Blit Image functions
  #Include "BlitImage"


; Create an FX image the size of the screen
  MyImage=NewFXImage(GetScreenWidth(),GetScreenHeight())



; Set Fps of the program
  SetFPS 30

; enable Vsync to remove any tearing from the refresh
  ScreenVsync on

; Start of Demo loop
  Do

   ; redirect all drawing to this image
     RenderToImage MyImage


   ;Change the pen's ink mode to Alpha ADD
     InkMode 1+64

   ; draw a circle at the mouses current position
     CircleC MouseX(),MouseY(),100, true,$803080

   ; redirect all drawing to screen back buffer
     RenderToScreen

   ; To do combined Blit (copy) our Image, with combined CLS of image.
   ; to the PB screen
     BlitImageAlphaSubColour(MyImage,0,0,RGB(8,8,8))



   ; Display Message
     Text 0,0,"Using BlitImageAlphaSubColour to fade image out"

   ; flip the back buffer to the front, so the user can see it
     Sync

  Loop


Related Info:	BlitImageAlpha50Colour \| BlitImageAlphaAddColour \| BlitImageAlphaMultColour \| BlitImageAlphaMultImage \| BlitImageAlphaSubColour \| BlitImageClear \| Box \| DrawAlphaImage \| DrawImage \| InkMode :