environment_variables.md 1.38 KB
Newer Older
1 2 3 4 5 6 7 8
# 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.

9
## All CPUs
10
    LIBYUV_DISABLE_ASM
11 12

## Intel CPUs
13 14 15 16 17 18 19 20 21
    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
22 23 24 25 26 27 28 29 30 31 32
    LIBYUV_DISABLE_F16C
    LIBYUV_DISABLE_AVX512BW
    LIBYUV_DISABLE_AVX512VL
    LIBYUV_DISABLE_AVX512VBMI
    LIBYUV_DISABLE_AVX512VBMI2
    LIBYUV_DISABLE_AVX512VBITALG
    LIBYUV_DISABLE_AVX512VPOPCNTDQ
    LIBYUV_DISABLE_GFNI

## ARM CPUs

33 34
    LIBYUV_DISABLE_NEON

35 36 37 38
## MIPS CPUs
    LIBYUV_DISABLE_MSA
    LIBYUV_DISABLE_MMI

39 40
# Test Width/Height/Repeat

41
The unittests default to a small image (128x72) to run fast.  This can be set by environment variable to test a specific resolutions.
42 43 44 45 46 47 48
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