Bliting Primitives
[Advances methods for bliting directly to the screen without using entities. It uses IND_Render methods (recommended only for advanced IndieLib users)]

Bliting primitives (you can also use IND_Entity2d instead this methods)
void	IND_Render::BlitPixel (int pX, int pY, byte pR, byte pG, byte pB, byte pA)
void	IND_Render::BlitLine (int pX1, int pY1, int pX2, int pY2, byte pR, byte pG, byte pB, byte pA)
void	IND_Render::BlitRectangle (int pX1, int pY1, int pX2, int pY2, byte pR, byte pG, byte pB, byte pA)
void	IND_Render::BlitFillRectangle (int pX1, int pY1, int pX2, int pY2, byte pR, byte pG, byte pB, byte pA)
void	IND_Render::BlitColoredTriangle (int pX1, int pY1, int pX2, int pY2, int pX3, int pY3, byte pR1, byte pG1, byte pB1, byte pR2, byte pG2, byte pB2, byte pR3, byte pG3, byte pB3, byte pA)
bool	IND_Render::BlitPoly2d (IND_Point *pPixel, int pNumLines, byte pR, byte pG, byte pB, byte pA)
bool	IND_Render::BlitRegularPoly (int pX, int pY, int pRadius, int pN, float pAngle, byte pR, byte pG, byte pB, byte pA)

---

Detailed Description

With these methods you can directly blit to the screen primitives using IND_Render class. Remember that you can also use IND_Entity2d with primitives joint to this object, in order to draw primitives.

---

Function Documentation

void IND_Render::BlitPixel	(	int	pX,
		int	pY,
		byte	pR,
		byte	pG,
		byte	pB,
		byte	pA
	)			[inline, inherited]

Parameters:

• pX, pY Position in the screen
• pR, pG, pB R, G, B components of the color
• pA Level of transparency. (255 = completly opaque)

Operation:

This function draws a pixel into the screen. This is a really slow method when the number of pixels is big.

This method is equivalent to use a combination of these methods:

• IND_Entity2d::SetPrimitive2d()
• IND_Entity2d::SetLine()
• IND_Entity2d::SetTint()
• IND_Entity2d::SetTransparency()

void IND_Render::BlitLine	(	int	pX1,
		int	pY1,
		int	pX2,
		int	pY2,
		byte	pR,
		byte	pG,
		byte	pB,
		byte	pA
	)			[inline, inherited]

Parameters:

• pX1, pY1 Origin point
• pX2, pY2 Destiny point
• pR, pG, pB R, G, B components of the color
• pA Level of transparency. (255 = completly opaque)

Operation:

This function draws a line into the screen

This method is equivalent to use a combination of these methods:

• IND_Entity2d::SetPrimitive2d()
• IND_Entity2d::SetLine()
• IND_Entity2d::SetTint()
• IND_Entity2d::SetTransparency()

void IND_Render::BlitRectangle	(	int	pX1,
		int	pY1,
		int	pX2,
		int	pY2,
		byte	pR,
		byte	pG,
		byte	pB,
		byte	pA
	)			[inline, inherited]

Parameters:

• pX1, pY1 Upper left corner of the rectangle
• pX2, pY2 Lower right corner of the rectangle
• pR, pG, pB R, G, B components of the color
• pA Level of transparency. (255 = completly opaque)

Operation:

This function draws a rectangle into the screen

This method is equivalent to use a combination of these methods:

• IND_Entity2d::SetPrimitive2d()
• IND_Entity2d::SetRectangle()
• IND_Entity2d::SetTint()
• IND_Entity2d::SetTransparency()

void IND_Render::BlitFillRectangle	(	int	pX1,
		int	pY1,
		int	pX2,
		int	pY2,
		byte	pR,
		byte	pG,
		byte	pB,
		byte	pA
	)			[inline, inherited]

Parameters:

• pX1, pY1 Upper left corner of the rectangle
• pX2, pY2 Lower right corner of the rectangle
• pR, pG, pB R, G, B components of the color
• pA Level of transparency. (255 = completly opaque)

Operation:

This function draws a rectangle filled with a color into the screen. The A component is the transparency level (255 = complety opaque).

This method is equivalent to use a combination of these methods:

• IND_Entity2d::SetPrimitive2d()
• IND_Entity2d::SetRectangle()
• IND_Entity2d::SetTint()
• IND_Entity2d::SetTransparency()

void IND_Render::BlitColoredTriangle	(	int	pX1,
		int	pY1,
		int	pX2,
		int	pY2,
		int	pX3,
		int	pY3,
		byte	pR1,
		byte	pG1,
		byte	pB1,
		byte	pR2,
		byte	pG2,
		byte	pB2,
		byte	pR3,
		byte	pG3,
		byte	pB3,
		byte	pA
	)			[inline, inherited]

Parameters:

• pX1, pY1 Triangle corner #1
• pX2, pY2 Triangle corner #2
• pX3, pY3 Triangle corner #3
• pR1, pG1, pB1 R, G, B components of the color for ther corner #1
• pR2, pG2, pB2 R, G, B components of the color for ther corner #2
• pR3, pG3, pB3 R, G, B components of the color for ther corner #3
• pA Level of transparency. (255 = completly opaque)

Operation:

This function draws a triangle filled with a color given in three corners. The A component is the transparency level (255 = complety opaque).

This method is equivalent to use a combination of these methods:

• IND_Entity2d::SetPrimitive2d()
• IND_Entity2d::SetRectangle()
• IND_Entity2d::SetTint()
• IND_Entity2d::SetTransparency()

bool IND_Render::BlitPoly2d	(	IND_Point *	pPolyPoints,
		int	pNumLines,
		byte	pR,
		byte	pG,
		byte	pB,
		byte	pA
	)			[inline, inherited]

Parameters:

• pPixel Pointer to a points array IND_Point. Example: IND_Point mPoly3 [ ] = { {60, 10}, {20, 15}, {50, 90}, {170, 190} } => Sets 3 points (each one with x and y coordinates).
• pNumLines Number of edges to draw
• pR, pG, pB R, G, B components of the color
• pA Level of transparency. (255 = completly opaque)

Operation:

This function draws 2d poly

This method is equivalent to use a combination of these methods:

• IND_Entity2d::SetPrimitive2d()
• IND_Entity2d::SetPolyPoints()
• IND_Entity2d::SetNumSides()
• IND_Entity2d::SetTint()
• IND_Entity2d::SetTransparency()

bool IND_Render::BlitRegularPoly	(	int	pX,
		int	pY,
		int	pRadius,
		int	pN,
		float	pAngle,
		byte	pR,
		byte	pG,
		byte	pB,
		byte	pA
	)			[inline, inherited]

Parameters:

• pX, pY Position in the screen
• pRadius Radius
• pN Number of sides
• pAngle Angle in degrees (if you change this parameter the polygon will rotate)
• pR, pG, pB R, G, B components of the color
• pA Level of transparency. (255 = completly opaque)

Operation:

This function draws 2d regunr poly of n sides. If you need to draw circles you can use this method using 30 or more sides.

This method is equivalent to use a combination of these methods:

• IND_Entity2d::SetPrimitive2d()
• IND_Entity2d::SetRadius()
• IND_Entity2d::SetPosition()
• IND_Entity2d::SetTint()
• IND_Entity2d::SetTransparency()

---