File: environment_variables.md

package info (click to toggle)
libyuv 0.0.1904.20250204-1
  • links: PTS, VCS
  • area: main
  • in suites: trixie
  • size: 6,172 kB
  • sloc: cpp: 105,368; ansic: 17,125; python: 851; sh: 123; makefile: 30
file content (68 lines) | stat: -rw-r--r-- 1,735 bytes parent folder | download | duplicates (19)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
# Introduction

For test purposes, environment variables can be set to control libyuv behavior.  These should only be used for testing, to narrow down bugs or to test performance.

# CPU

By default the cpu is detected and the most advanced form of SIMD is used.  But you can disable instruction sets selectively, or completely, falling back on C code.  Set the variable to 1 to disable the specified instruction set.

## All CPUs

    LIBYUV_DISABLE_ASM

## Intel CPUs

    LIBYUV_DISABLE_X86
    LIBYUV_DISABLE_SSE2
    LIBYUV_DISABLE_SSSE3
    LIBYUV_DISABLE_SSE41
    LIBYUV_DISABLE_SSE42
    LIBYUV_DISABLE_AVX
    LIBYUV_DISABLE_AVX2
    LIBYUV_DISABLE_ERMS
    LIBYUV_DISABLE_FMA3
    LIBYUV_DISABLE_F16C
    LIBYUV_DISABLE_AVX512BW
    LIBYUV_DISABLE_AVX512VL
    LIBYUV_DISABLE_AVX512VNNI
    LIBYUV_DISABLE_AVX512VBMI
    LIBYUV_DISABLE_AVX512VBMI2
    LIBYUV_DISABLE_AVX512VBITALG
    LIBYUV_DISABLE_AVX10
    LIBYUV_DISABLE_AVX10_2
    LIBYUV_DISABLE_AVXVNNI
    LIBYUV_DISABLE_AVXVNNIINT8
    LIBYUV_DISABLE_AMXINT8

## Arm CPUs

    LIBYUV_DISABLE_NEON
    LIBYUV_DISABLE_NEON_DOTPROD
    LIBYUV_DISABLE_NEON_I8MM
    LIBYUV_DISABLE_SVE
    LIBYUV_DISABLE_SVE2
    LIBYUV_DISABLE_SME

## MIPS CPUs

    LIBYUV_DISABLE_MSA

## LOONGARCH CPUs

    LIBYUV_DISABLE_LSX
    LIBYUV_DISABLE_LASX

## RISCV CPUs

    LIBYUV_DISABLE_RVV

# Test Width/Height/Repeat

The unittests default to a small image (128x72) to run fast.  This can be set by environment variable to test a specific resolutions.
You can also repeat the test a specified number of iterations, allowing benchmarking and profiling.

    set LIBYUV_WIDTH=1280
    set LIBYUV_HEIGHT=720
    set LIBYUV_REPEAT=999
    set LIBYUV_FLAGS=-1
    set LIBYUV_CPU_INFO=-1