FFmpeg  3.2.10
Macros | Functions
cpu.h File Reference
#include "attributes.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. 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. More...
 
#define AV_CPU_FLAG_SSSE3   0x0080
 Conroe SSSE3 functions. 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_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)
 

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...
 
attribute_deprecated void av_set_cpu_flags_mask (int mask)
 Set a mask on flags returned by av_get_cpu_flags(). More...
 
attribute_deprecated int av_parse_cpu_flags (const char *s)
 Parse CPU flags from a string. 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)
 

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 35 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 39 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_ATOM

#define AV_CPU_FLAG_ATOM   0x10000000

Atom processor, some SSSE3 instructions are slower.

Definition at line 42 of file cpu.h.

◆ AV_CPU_FLAG_SSE4

#define AV_CPU_FLAG_SSE4   0x0100

Penryn SSE4.1 functions.

Definition at line 43 of file cpu.h.

◆ AV_CPU_FLAG_SSE42

#define AV_CPU_FLAG_SSE42   0x0200

Nehalem SSE4.2 functions.

Definition at line 44 of file cpu.h.

◆ AV_CPU_FLAG_AESNI

#define AV_CPU_FLAG_AESNI   0x80000

Advanced Encryption Standard functions.

Definition at line 45 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 46 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 47 of file cpu.h.

◆ AV_CPU_FLAG_XOP

#define AV_CPU_FLAG_XOP   0x0400

Bulldozer XOP functions.

Definition at line 48 of file cpu.h.

◆ AV_CPU_FLAG_FMA4

#define AV_CPU_FLAG_FMA4   0x0800

Bulldozer FMA4 functions.

Definition at line 49 of file cpu.h.

◆ AV_CPU_FLAG_CMOV

#define AV_CPU_FLAG_CMOV   0x1000

supports cmov instruction

Definition at line 50 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 51 of file cpu.h.

◆ AV_CPU_FLAG_FMA3

#define AV_CPU_FLAG_FMA3   0x10000

Haswell FMA3 functions.

Definition at line 52 of file cpu.h.

◆ AV_CPU_FLAG_BMI1

#define AV_CPU_FLAG_BMI1   0x20000

Bit Manipulation Instruction Set 1.

Definition at line 53 of file cpu.h.

◆ AV_CPU_FLAG_BMI2

#define AV_CPU_FLAG_BMI2   0x40000

Bit Manipulation Instruction Set 2.

Definition at line 54 of file cpu.h.

◆ AV_CPU_FLAG_ALTIVEC

#define AV_CPU_FLAG_ALTIVEC   0x0001

standard

Definition at line 56 of file cpu.h.

◆ AV_CPU_FLAG_VSX

#define AV_CPU_FLAG_VSX   0x0002

ISA 2.06.

Definition at line 57 of file cpu.h.

◆ AV_CPU_FLAG_POWER8

#define AV_CPU_FLAG_POWER8   0x0004

ISA 2.07.

Definition at line 58 of file cpu.h.

◆ AV_CPU_FLAG_ARMV5TE

#define AV_CPU_FLAG_ARMV5TE   (1 << 0)

Definition at line 60 of file cpu.h.

◆ AV_CPU_FLAG_ARMV6

#define AV_CPU_FLAG_ARMV6   (1 << 1)

Definition at line 61 of file cpu.h.

◆ AV_CPU_FLAG_ARMV6T2

#define AV_CPU_FLAG_ARMV6T2   (1 << 2)

Definition at line 62 of file cpu.h.

◆ AV_CPU_FLAG_VFP

#define AV_CPU_FLAG_VFP   (1 << 3)

Definition at line 63 of file cpu.h.

◆ AV_CPU_FLAG_VFPV3

#define AV_CPU_FLAG_VFPV3   (1 << 4)

Definition at line 64 of file cpu.h.

◆ AV_CPU_FLAG_NEON

#define AV_CPU_FLAG_NEON   (1 << 5)

Definition at line 65 of file cpu.h.

◆ AV_CPU_FLAG_ARMV8

#define AV_CPU_FLAG_ARMV8   (1 << 6)

Definition at line 66 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 67 of file cpu.h.

◆ AV_CPU_FLAG_SETEND

#define AV_CPU_FLAG_SETEND   (1 <<16)

Definition at line 68 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_set_cpu_flags_mask()

attribute_deprecated void av_set_cpu_flags_mask ( int  mask)

Set a mask on flags returned by av_get_cpu_flags().

This function is mainly useful for testing. Please use av_force_cpu_flags() and av_get_cpu_flags() instead which are more flexible

Warning
this function is not thread safe.

◆ av_parse_cpu_flags()

attribute_deprecated int av_parse_cpu_flags ( const char *  s)

Parse CPU flags from a string.

The returned flags contain the specified flags as well as related unspecified flags.

This function exists only for compatibility with libav. Please use av_parse_cpu_caps() when possible.

Returns
a combination of AV_CPU_* flags, negative on error.

◆ 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.