FFmpeg 5.1.6
Macros | Functions
cpu.h File Reference
#include <stddef.h>

Go to the source code of this file.

Macros

#define AV_CPU_FLAG_FORCE   0x80000000 /* force usage of selected flags (OR) */
 
#define AV_CPU_FLAG_MMX   0x0001
 standard MMX More...
 
#define AV_CPU_FLAG_MMXEXT   0x0002
 SSE integer functions or AMD MMX ext. More...
 
#define AV_CPU_FLAG_MMX2   0x0002
 SSE integer functions or AMD MMX ext. More...
 
#define AV_CPU_FLAG_3DNOW   0x0004
 AMD 3DNOW. More...
 
#define AV_CPU_FLAG_SSE   0x0008
 SSE functions. More...
 
#define AV_CPU_FLAG_SSE2   0x0010
 PIV SSE2 functions. More...
 
#define AV_CPU_FLAG_SSE2SLOW   0x40000000
 SSE2 supported, but usually not faster than regular MMX/SSE (e.g. More...
 
#define AV_CPU_FLAG_3DNOWEXT   0x0020
 AMD 3DNowExt. More...
 
#define AV_CPU_FLAG_SSE3   0x0040
 Prescott SSE3 functions. More...
 
#define AV_CPU_FLAG_SSE3SLOW   0x20000000
 SSE3 supported, but usually not faster than regular MMX/SSE (e.g. More...
 
#define AV_CPU_FLAG_SSSE3   0x0080
 Conroe SSSE3 functions. More...
 
#define AV_CPU_FLAG_SSSE3SLOW   0x4000000
 SSSE3 supported, but usually not faster. More...
 
#define AV_CPU_FLAG_ATOM   0x10000000
 Atom processor, some SSSE3 instructions are slower. More...
 
#define AV_CPU_FLAG_SSE4   0x0100
 Penryn SSE4.1 functions. More...
 
#define AV_CPU_FLAG_SSE42   0x0200
 Nehalem SSE4.2 functions. More...
 
#define AV_CPU_FLAG_AESNI   0x80000
 Advanced Encryption Standard functions. More...
 
#define AV_CPU_FLAG_AVX   0x4000
 AVX functions: requires OS support even if YMM registers aren't used. More...
 
#define AV_CPU_FLAG_AVXSLOW   0x8000000
 AVX supported, but slow when using YMM registers (e.g. Bulldozer) More...
 
#define AV_CPU_FLAG_XOP   0x0400
 Bulldozer XOP functions. More...
 
#define AV_CPU_FLAG_FMA4   0x0800
 Bulldozer FMA4 functions. More...
 
#define AV_CPU_FLAG_CMOV   0x1000
 supports cmov instruction More...
 
#define AV_CPU_FLAG_AVX2   0x8000
 AVX2 functions: requires OS support even if YMM registers aren't used. More...
 
#define AV_CPU_FLAG_FMA3   0x10000
 Haswell FMA3 functions. More...
 
#define AV_CPU_FLAG_BMI1   0x20000
 Bit Manipulation Instruction Set 1. More...
 
#define AV_CPU_FLAG_BMI2   0x40000
 Bit Manipulation Instruction Set 2. More...
 
#define AV_CPU_FLAG_AVX512   0x100000
 AVX-512 functions: requires OS support even if YMM/ZMM registers aren't used. More...
 
#define AV_CPU_FLAG_AVX512ICL   0x200000
 F/CD/BW/DQ/VL/VNNI/IFMA/VBMI/VBMI2/VPOPCNTDQ/BITALG/GFNI/VAES/VPCLMULQDQ. More...
 
#define AV_CPU_FLAG_SLOW_GATHER   0x2000000
 CPU has slow gathers. More...
 
#define AV_CPU_FLAG_ALTIVEC   0x0001
 standard More...
 
#define AV_CPU_FLAG_VSX   0x0002
 ISA 2.06. More...
 
#define AV_CPU_FLAG_POWER8   0x0004
 ISA 2.07. More...
 
#define AV_CPU_FLAG_ARMV5TE   (1 << 0)
 
#define AV_CPU_FLAG_ARMV6   (1 << 1)
 
#define AV_CPU_FLAG_ARMV6T2   (1 << 2)
 
#define AV_CPU_FLAG_VFP   (1 << 3)
 
#define AV_CPU_FLAG_VFPV3   (1 << 4)
 
#define AV_CPU_FLAG_NEON   (1 << 5)
 
#define AV_CPU_FLAG_ARMV8   (1 << 6)
 
#define AV_CPU_FLAG_VFP_VM   (1 << 7)
 VFPv2 vector mode, deprecated in ARMv7-A and unavailable in various CPUs implementations. More...
 
#define AV_CPU_FLAG_SETEND   (1 <<16)
 
#define AV_CPU_FLAG_MMI   (1 << 0)
 
#define AV_CPU_FLAG_MSA   (1 << 1)
 
#define AV_CPU_FLAG_LSX   (1 << 0)
 
#define AV_CPU_FLAG_LASX   (1 << 1)
 

Functions

int av_get_cpu_flags (void)
 Return the flags which specify extensions supported by the CPU. More...
 
void av_force_cpu_flags (int flags)
 Disables cpu detection and forces the specified flags. More...
 
int av_parse_cpu_caps (unsigned *flags, const char *s)
 Parse CPU caps from a string and update the given AV_CPU_* flags based on that. More...
 
int av_cpu_count (void)
 
void av_cpu_force_count (int count)
 Overrides cpu count detection and forces the specified count. More...
 
size_t av_cpu_max_align (void)
 Get the maximum data alignment that may be required by FFmpeg. More...
 

Macro Definition Documentation

◆ AV_CPU_FLAG_FORCE

#define AV_CPU_FLAG_FORCE   0x80000000 /* force usage of selected flags (OR) */

Definition at line 26 of file cpu.h.

◆ AV_CPU_FLAG_MMX

#define AV_CPU_FLAG_MMX   0x0001

standard MMX

Definition at line 29 of file cpu.h.

◆ AV_CPU_FLAG_MMXEXT

#define AV_CPU_FLAG_MMXEXT   0x0002

SSE integer functions or AMD MMX ext.

Definition at line 30 of file cpu.h.

◆ AV_CPU_FLAG_MMX2

#define AV_CPU_FLAG_MMX2   0x0002

SSE integer functions or AMD MMX ext.

Definition at line 31 of file cpu.h.

◆ AV_CPU_FLAG_3DNOW

#define AV_CPU_FLAG_3DNOW   0x0004

AMD 3DNOW.

Definition at line 32 of file cpu.h.

◆ AV_CPU_FLAG_SSE

#define AV_CPU_FLAG_SSE   0x0008

SSE functions.

Definition at line 33 of file cpu.h.

◆ AV_CPU_FLAG_SSE2

#define AV_CPU_FLAG_SSE2   0x0010

PIV SSE2 functions.

Definition at line 34 of file cpu.h.

◆ AV_CPU_FLAG_SSE2SLOW

#define AV_CPU_FLAG_SSE2SLOW   0x40000000

SSE2 supported, but usually not faster than regular MMX/SSE (e.g.

Core1)

Definition at line 36 of file cpu.h.

◆ AV_CPU_FLAG_3DNOWEXT

#define AV_CPU_FLAG_3DNOWEXT   0x0020

AMD 3DNowExt.

Definition at line 37 of file cpu.h.

◆ AV_CPU_FLAG_SSE3

#define AV_CPU_FLAG_SSE3   0x0040

Prescott SSE3 functions.

Definition at line 38 of file cpu.h.

◆ AV_CPU_FLAG_SSE3SLOW

#define AV_CPU_FLAG_SSE3SLOW   0x20000000

SSE3 supported, but usually not faster than regular MMX/SSE (e.g.

Core1)

Definition at line 40 of file cpu.h.

◆ AV_CPU_FLAG_SSSE3

#define AV_CPU_FLAG_SSSE3   0x0080

Conroe SSSE3 functions.

Definition at line 41 of file cpu.h.

◆ AV_CPU_FLAG_SSSE3SLOW

#define AV_CPU_FLAG_SSSE3SLOW   0x4000000

SSSE3 supported, but usually not faster.

Definition at line 42 of file cpu.h.

◆ AV_CPU_FLAG_ATOM

#define AV_CPU_FLAG_ATOM   0x10000000

Atom processor, some SSSE3 instructions are slower.

Definition at line 43 of file cpu.h.

◆ AV_CPU_FLAG_SSE4

#define AV_CPU_FLAG_SSE4   0x0100

Penryn SSE4.1 functions.

Definition at line 44 of file cpu.h.

◆ AV_CPU_FLAG_SSE42

#define AV_CPU_FLAG_SSE42   0x0200

Nehalem SSE4.2 functions.

Definition at line 45 of file cpu.h.

◆ AV_CPU_FLAG_AESNI

#define AV_CPU_FLAG_AESNI   0x80000

Advanced Encryption Standard functions.

Definition at line 46 of file cpu.h.

◆ AV_CPU_FLAG_AVX

#define AV_CPU_FLAG_AVX   0x4000

AVX functions: requires OS support even if YMM registers aren't used.

Definition at line 47 of file cpu.h.

◆ AV_CPU_FLAG_AVXSLOW

#define AV_CPU_FLAG_AVXSLOW   0x8000000

AVX supported, but slow when using YMM registers (e.g. Bulldozer)

Definition at line 48 of file cpu.h.

◆ AV_CPU_FLAG_XOP

#define AV_CPU_FLAG_XOP   0x0400

Bulldozer XOP functions.

Definition at line 49 of file cpu.h.

◆ AV_CPU_FLAG_FMA4

#define AV_CPU_FLAG_FMA4   0x0800

Bulldozer FMA4 functions.

Definition at line 50 of file cpu.h.

◆ AV_CPU_FLAG_CMOV

#define AV_CPU_FLAG_CMOV   0x1000

supports cmov instruction

Definition at line 51 of file cpu.h.

◆ AV_CPU_FLAG_AVX2

#define AV_CPU_FLAG_AVX2   0x8000

AVX2 functions: requires OS support even if YMM registers aren't used.

Definition at line 52 of file cpu.h.

◆ AV_CPU_FLAG_FMA3

#define AV_CPU_FLAG_FMA3   0x10000

Haswell FMA3 functions.

Definition at line 53 of file cpu.h.

◆ AV_CPU_FLAG_BMI1

#define AV_CPU_FLAG_BMI1   0x20000

Bit Manipulation Instruction Set 1.

Definition at line 54 of file cpu.h.

◆ AV_CPU_FLAG_BMI2

#define AV_CPU_FLAG_BMI2   0x40000

Bit Manipulation Instruction Set 2.

Definition at line 55 of file cpu.h.

◆ AV_CPU_FLAG_AVX512

#define AV_CPU_FLAG_AVX512   0x100000

AVX-512 functions: requires OS support even if YMM/ZMM registers aren't used.

Definition at line 56 of file cpu.h.

◆ AV_CPU_FLAG_AVX512ICL

#define AV_CPU_FLAG_AVX512ICL   0x200000

F/CD/BW/DQ/VL/VNNI/IFMA/VBMI/VBMI2/VPOPCNTDQ/BITALG/GFNI/VAES/VPCLMULQDQ.

Definition at line 57 of file cpu.h.

◆ AV_CPU_FLAG_SLOW_GATHER

#define AV_CPU_FLAG_SLOW_GATHER   0x2000000

CPU has slow gathers.

Definition at line 58 of file cpu.h.

◆ AV_CPU_FLAG_ALTIVEC

#define AV_CPU_FLAG_ALTIVEC   0x0001

standard

Definition at line 60 of file cpu.h.

◆ AV_CPU_FLAG_VSX

#define AV_CPU_FLAG_VSX   0x0002

ISA 2.06.

Definition at line 61 of file cpu.h.

◆ AV_CPU_FLAG_POWER8

#define AV_CPU_FLAG_POWER8   0x0004

ISA 2.07.

Definition at line 62 of file cpu.h.

◆ AV_CPU_FLAG_ARMV5TE

#define AV_CPU_FLAG_ARMV5TE   (1 << 0)

Definition at line 64 of file cpu.h.

◆ AV_CPU_FLAG_ARMV6

#define AV_CPU_FLAG_ARMV6   (1 << 1)

Definition at line 65 of file cpu.h.

◆ AV_CPU_FLAG_ARMV6T2

#define AV_CPU_FLAG_ARMV6T2   (1 << 2)

Definition at line 66 of file cpu.h.

◆ AV_CPU_FLAG_VFP

#define AV_CPU_FLAG_VFP   (1 << 3)

Definition at line 67 of file cpu.h.

◆ AV_CPU_FLAG_VFPV3

#define AV_CPU_FLAG_VFPV3   (1 << 4)

Definition at line 68 of file cpu.h.

◆ AV_CPU_FLAG_NEON

#define AV_CPU_FLAG_NEON   (1 << 5)

Definition at line 69 of file cpu.h.

◆ AV_CPU_FLAG_ARMV8

#define AV_CPU_FLAG_ARMV8   (1 << 6)

Definition at line 70 of file cpu.h.

◆ AV_CPU_FLAG_VFP_VM

#define AV_CPU_FLAG_VFP_VM   (1 << 7)

VFPv2 vector mode, deprecated in ARMv7-A and unavailable in various CPUs implementations.

Definition at line 71 of file cpu.h.

◆ AV_CPU_FLAG_SETEND

#define AV_CPU_FLAG_SETEND   (1 <<16)

Definition at line 72 of file cpu.h.

◆ AV_CPU_FLAG_MMI

#define AV_CPU_FLAG_MMI   (1 << 0)

Definition at line 74 of file cpu.h.

◆ AV_CPU_FLAG_MSA

#define AV_CPU_FLAG_MSA   (1 << 1)

Definition at line 75 of file cpu.h.

◆ AV_CPU_FLAG_LSX

#define AV_CPU_FLAG_LSX   (1 << 0)

Definition at line 78 of file cpu.h.

◆ AV_CPU_FLAG_LASX

#define AV_CPU_FLAG_LASX   (1 << 1)

Definition at line 79 of file cpu.h.

Function Documentation

◆ av_get_cpu_flags()

int av_get_cpu_flags ( void  )

Return the flags which specify extensions supported by the CPU.

The returned value is affected by av_force_cpu_flags() if that was used before. So av_get_cpu_flags() can easily be used in an application to detect the enabled cpu flags.

◆ av_force_cpu_flags()

void av_force_cpu_flags ( int  flags)

Disables cpu detection and forces the specified flags.

-1 is a special case that disables forcing of specific flags.

◆ av_parse_cpu_caps()

int av_parse_cpu_caps ( unsigned *  flags,
const char *  s 
)

Parse CPU caps from a string and update the given AV_CPU_* flags based on that.

Returns
negative on error.

◆ av_cpu_count()

int av_cpu_count ( void  )
Returns
the number of logical CPU cores present.

◆ av_cpu_force_count()

void av_cpu_force_count ( int  count)

Overrides cpu count detection and forces the specified count.

Count < 1 disables forcing of specific count.

◆ av_cpu_max_align()

size_t av_cpu_max_align ( void  )

Get the maximum data alignment that may be required by FFmpeg.

Note that this is affected by the build configuration and the CPU flags mask, so e.g. if the CPU supports AVX, but libavutil has been built with –disable-avx or the AV_CPU_FLAG_AVX flag has been disabled through av_set_cpu_flags_mask(), then this function will behave as if AVX is not present.