RectHitSpritePixels

CollisionState = RectHitSpritePixels(X1, Y1, X2, Y2, SpriteIndex, Accuracy#)

Parameters:     X1 = The top left X coordinate of the rectangle     Y1 = The top left Y coordinate of the rectangle     X2 = The bottom right X coordinate of the rectangle     Y2 = The bottom right Y coordinate of the rectangle     SpriteIndex = The Sprite to check for collision against     Accuracy# = The level of accuracy that should be used.

Returns:     CollisionState = The result of the collision query (0= No collision ,1 = Collision)

The RectHitSpritePixels function detects if a collision occurs between a rectangle and the solid pixels (none transparent) of a sprite. Example Accuracy Values       0.25 = Reduce collision accuracy to 25%       0.50 = Reduce collision accuracy to 50%       0.75 = Reduce collision accuracy to 75%       1.00 = Set collision accuracy to 100%       2.00 = Set collision accuracy to 200% FACTS:       * The Accuracy parameter allows the user to fine tune the quality of the pixel level sprite collisions. Generally speaking the lower the quality the faster the comparison. On the flip side the higher the quality the more accurate, but slower the comparison. It's up to the user to choose an accuracy level that is appropriate for your images and the performance of your game.       * Pixels level collisions ignore the sprites transparent colour.       * See SpriteCollisionMode for more information about the available collision modes. Mini Tutorial:       This example creates a random image, creates 10 randomly positioned sprites on the screen using this image. The main loop rotates the sprites while scans them for collisions using RectHitSpritePixels    ; clear the screen to black   Cls RGB(0,0,0)    ; Limit the frame rate to 75 or less   SetFPS 75    ; Make an image with circles on it   For lp =0 To 100      CircleC Rnd(100),Rnd(100),RndRange(2,10),1,RndRGB()   Next   GetImage 1,0,0,100,100   PrepareFXImage 1       ; Make 10 sprites   For spr=1 To 10          ; postion the spriote randomly on the screen      x=Rnd(GetScreenWidth())      y=Rnd(GetScreenHeight())          ; Create the sprite using image #1      Spr=NewSprite(x,y,1)          ; center the sprite      CenterSpriteHandle spr         Next            Do      Cls RGB(0,0,0)          ; Check if the mouse  is over a sprite      x1#=MouseX()      y1#=MouseY()            x2#=x1#+100      y2#=y1#+50                ; start for/next loop from 1 to 10      For spr=1 To 10                ; Turn this sprite         TurnSprite spr,0.25                ; Check if a Rectangle hits any pixels in this sprite         If RectHitSpritePixels(x1#,y1#,x2#,y2#,spr,1)=true          ; if the mouse pointer over sprite          ; then make it flash            SpriteDrawMode Spr,2+4096         Else          ; Set it's draw mode to just rotated            SpriteDrawMode Spr,2         EndIf               Next                  DrawAllSprites          ; draw the test point      BoxC x1#,y1#,x2#,y2#,false,RGB(255,255,255)                  Sync   Loop

Related Info:	CircleHitSprite | PointHitSprite | PointHitSpritePixels | QuadHitSprite | RayHitSprite | RectHitSprite | ShapeHitSprite | ShapeHitSpritePixels | SpriteCollisionMode | SpriteHit | SpritesOverlap | TriangleHitSpritePixels :

(c) Copyright 2002 - 2024 - Kevin Picone - PlayBASIC.com