On this page

elba.h

The standalone vector engine: paths, paints, scenes, groups, clips and masks, rendered on the cpu. No gfx, ui or kit type crosses this header.

#include "elba/elba.h". The guide starts at Vector engine (elba).

Values and colours

Explained in Vector engine (elba).

elba_versionelba_statuselba_okelba_invalidelba_no_memoryelba_unsupportedelba_not_implementedelba_status_textelba_affineelba_rectelba_colorelba_identityelba_translateelba_scaleelba_mulelba_rotateelba_invertelba_rgba8

Paths and path queries

Explained in Vector engine (elba).

elba_fill_ruleelba_fill_nonzeroelba_fill_evenoddelba_fill_nonzero_inverseelba_fill_evenodd_inverseelba_verbelba_verb_moveelba_verb_lineelba_verb_quadelba_verb_cubicelba_verb_closeelba_path_viewelba_pathelba_path_createelba_path_destroyelba_path_resetelba_path_emptyelba_path_dataelba_move_toelba_line_toelba_quad_toelba_cubic_toelba_arc_toelba_arcelba_closeelba_add_rectelba_add_round_rectelba_add_ellipseelba_add_pathelba_add_viewelba_path_boundselba_path_containselba_path_length

Strokes and path ops

Explained in Vector engine (elba).

elba_capelba_cap_buttelba_cap_roundelba_cap_squareelba_joinelba_join_miterelba_join_roundelba_join_bevelelba_join_miter_clipelba_stroke_flagelba_stroke_hairlineelba_stroke_non_scalingelba_stroke_styleelba_stroke_defaultelba_stroke_containselba_trimelba_trim_wholeelba_trim_eachelba_path_trimelba_path_strokeelba_bool_opelba_bool_unionelba_bool_intersectelba_bool_subtractelba_bool_xorelba_path_offsetelba_path_boolean

Images

Explained in Vector engine (elba).

elba_formatelba_format_rgba8_premulelba_format_bgra8_premulelba_format_rgba8elba_format_bgra8elba_format_a8elba_format_rgba32f_premulelba_image_flagelba_image_borrowelba_imageelba_image_createelba_image_destroyelba_image_writeelba_image_size

Paints

Explained in Vector engine (elba).

elba_paint_kindelba_paint_solidelba_paint_linearelba_paint_radialelba_paint_sweepelba_paint_imageelba_spreadelba_spread_padelba_spread_repeatelba_spread_reflectelba_spread_noneelba_filterelba_filter_bilinearelba_filter_nearestelba_filter_bicubicelba_paint_flagelba_paint_premul_stopselba_paint_ditherelba_stopelba_paintelba_solidelba_linearelba_radialelba_sweepelba_pattern

Blends, groups and masks

Explained in Vector engine (elba).

elba_blendelba_blend_normalelba_blend_multiplyelba_blend_screenelba_blend_overlayelba_blend_darkenelba_blend_lightenelba_blend_color_dodgeelba_blend_color_burnelba_blend_hard_lightelba_blend_soft_lightelba_blend_differenceelba_blend_exclusionelba_blend_hueelba_blend_saturationelba_blend_colorelba_blend_luminosityelba_blend_addelba_blend_clearelba_blend_srcelba_blend_dstelba_blend_dst_overelba_blend_src_inelba_blend_dst_inelba_blend_src_outelba_blend_dst_outelba_blend_src_atopelba_blend_dst_atopelba_blend_xorelba_blend_countelba_group_flagelba_group_luma_to_alphaelba_groupelba_group_defaultelba_mask_modeelba_mask_alphaelba_mask_alpha_invertedelba_mask_lumaelba_mask_luma_invertedelba_mask_opelba_mask_addelba_mask_subtractelba_mask_intersectelba_mask_differenceelba_mask_lightenelba_mask_darken

Scenes and draw calls

Explained in Vector engine (elba).

elba_sceneelba_scene_createelba_scene_destroyelba_scene_resetelba_scene_boundselba_fillelba_strokeelba_fill_rectelba_draw_imageelba_draw_sceneelba_push_groupelba_push_clipelba_push_maskelba_mask_contentelba_mask_pathelba_pop

Contexts and rendering

Explained in Vector engine (elba).

elba_policyelba_policy_autoelba_policy_minimalelba_policy_immediateelba_policy_retainedelba_backendelba_backend_autoelba_backend_cpuelba_backend_gpuelba_jobelba_runnerelba_releaseelba_descelba_desc_defaultelba_contextelba_context_createelba_context_destroyelba_context_trimelba_qualityelba_quality_exactelba_quality_fastelba_precisionelba_precision_fixedelba_precision_floatelba_spaceelba_space_srgbelba_space_linearelba_render_flagelba_render_clearelba_targetelba_renderelba_render_defaultelba_render_cpuelba_statselba_stats_get

Example

badge.cpp
#include "elba/elba.h"

#include <stdint.h>
#include <stdlib.h>

// record a scene once, then render it into memory the caller owns
static bool badge_png_pixels(uint32_t w, uint32_t h, uint32_t* out)
{
    elba_path* round = elba_path_create();
    elba_add_round_rect(round, 8.0f, 8.0f, float(w) - 16.0f, float(h) - 16.0f, 18.0f, 18.0f);

    elba_path* tick = elba_path_create();
    elba_move_to(tick, 40.0f, 64.0f);
    elba_line_to(tick, 60.0f, 84.0f);
    elba_line_to(tick, 96.0f, 44.0f);

    const elba_stop stops[2] = { { 0.0f, elba_rgba8(0xffe5648au) }, { 1.0f, elba_rgba8(0xffcc986du) } };
    const elba_paint fill = elba_linear(0.0f, 0.0f, float(w), float(h), stops, 2u, elba_spread_pad);
    const elba_paint white = elba_solid(elba_rgba8(0xffffffffu));

    elba_stroke_style line = elba_stroke_default();
    line.width = 10.0f;
    line.cap = elba_cap_round;
    line.join = elba_join_round;

    elba_scene* scene = elba_scene_create();
    elba_fill(scene, round, nullptr, elba_fill_nonzero, &fill);
    elba_stroke(scene, tick, nullptr, &line, &white);

    elba_context* ctx = elba_context_create(nullptr);
    const elba_target target = { out, w, h, w * 4u, elba_format_rgba8_premul };
    const elba_status st = elba_render_cpu(ctx, scene, &target, nullptr);

    elba_context_destroy(ctx);
    elba_scene_destroy(scene);
    elba_path_destroy(tick);
    elba_path_destroy(round);
    return st == elba_ok;
}

Last updated 23 October 2026