render

Rendering primitives. Most of the functions can only be called from render callback.

screen_size

render.screen_size() vector

camera_angles

render.camera_angles([angles: qangle]) qangle

Get or set camera angles, if angles argument is passed.

camera_position

render.camera_position() vector

world_to_screen

render.world_to_screen(coord: vector) vector

Transforms world 3D coordinate to screen 2D coordinate. Returns nil if result is invalid.

add_font

render.add_font(buffer: string)

Allows to load font from memory if it is not installed in system. After this you can normally use render.load_font function.

load_font

render.load_font(name: string, size: number[, flags: string]) Font

Initialized font that can be used in render.text function. You don't need to load font every frame.

Name	Type	Description
name	string	Name of the font
size	number	Font size
flags	string	a for anti-aliasing, b for bold font

load_image

render.load_image(buffer: string, size: vector) Image

Loads image texture from the buffer, can be used to load images from network, or small inlined pictures.

Name	Type	Description
buffer	string	Raw image file contents
size	vector	Size of the image in pixels

struct Image

Field	Type	Description
width	number	Image width in pixels.
height	number	Image height in pixels.
texture	IDirect3DTexture9	Internal image texture buffer.

get_weapon_icon

render.get_weapon_icon(weapon_index: number) Image

measure_text

render.measure_text(font: Font, text: string) vector

Name	Type	Description
font	Font	Font object or number: 1 for Verdana, 2 for Small Font, 3 for Verdana Bold, 4 for Calibri Bold
text	string	Text

text

render.text(font: Font, pos: vector, col: color, flags: string, text: string)

Name	Type	Description
font	Font	Font object or number: 1 for Verdana, 2 for Small Font, 3 for Verdana Bold, 4 for Calibri Bold
pos	vector	Text position
col	color	Text color
flags	string	Render flags: d for dropshadow, o for outline, c for center.

line

render.line(point1: vector, point2: vector, col: color)

poly

render.poly(col: color, points: vector, ...)

poly_line

render.poly_line(col: color, points: vector, ...)

Name	Type	Description
col	color	Color of polygon / line
points	vector	Comma separated points

rect

render.rect(position_1: vector, position_2: vector, col: color)

rect_outline

render.rect_outline(position_1: vector, position_2: vector, col: color)

gradient

render.gradient(position_1: vector, position_2: vector, top_left: color, top_right: color, bottom_left, bottom_right)

Name	Type	Description
position_1	vector	Start position of rect (top left)
position_2	vector	End position of rect (bottom right)
top_left	color	Color in top left corner
top_right	color	Color in top right corner
bottom_left	color	Color in bottom left corner
bottom_right	color	Color in bottom right corner

circle

render.circle(center: vector, col: color, radius: number)

circle_outline

render.circle_outline(center: vector, col: color, radius: number)

circle_gradient

render.circle_gradient(center: vector, col_outer: color, col_inner: color, radius: number)

circle_3d

render.circle_3d(center: vector, col: color, radius: number)

Renders circle in 3d space.

circle_3d_outline

render.circle_3d_outline(center: vector, col: color, radius: number)

Renders outlined circle in 3d space.

texture

render.texture(texture: Image, pos: vector[, col: color])

Name	Type	Description
texture	Image	Texture to render
pos	vector	Top left position of image
col	color	Optional. Color modulation of image.

vertex

render.vertex(draw_type: number, verts: vertex, ...)

Lowest rendering function, you can render custom gradients using this.

Name	Type	Description
draw_type	number	How GPU will render vertecies.
verts	vertex	Comma seprated vertecies.

Draw types and usage example

Draw types description you can find here.

vertex is a pair of vector and color.

local draw_type = {
  pointlist      = 1,
  linelist       = 2,
  linestrip      = 3,
  trianglelist   = 4,
  trianglestrip  = 5,
  trianglefan    = 6,
}

client.add_callback("render", function()
  -- Render gradient triangle
  
  local vertecies = {
    vertex(vector(150, 100), color(255, 0, 0)),
    vertex(vector(100, 150), color(0, 255, 0)),
    vertex(vector(200, 150), color(0, 0, 255))
  }
  render.vertex(draw_type.trianglelist, table.unpack(vertecies))
end)

push_clip_rect

render.push_clip_rect(start: vector, end: vector)

Sets render clip region.

pop_clip_rect

render.pop_clip_rect()

Removes clip region.