summaryrefslogtreecommitdiffstats
path: root/dom/media/platforms/ffmpeg/ffmpeg59/include/libavutil/cpu.h
blob: 1c383f3b06c07c9f9c0f0adc354e2b0a9c68b522 (plain)
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
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
/*
 * Copyright (c) 2000, 2001, 2002 Fabrice Bellard
 *
 * This file is part of FFmpeg.
 *
 * FFmpeg is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * FFmpeg is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with FFmpeg; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
 */

#ifndef AVUTIL_CPU_H
#define AVUTIL_CPU_H

#include <stddef.h>

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

/* lower 16 bits - CPU features */
#define AV_CPU_FLAG_MMX 0x0001     ///< standard MMX
#define AV_CPU_FLAG_MMXEXT 0x0002  ///< SSE integer functions or AMD MMX ext
#define AV_CPU_FLAG_MMX2 0x0002    ///< SSE integer functions or AMD MMX ext
#define AV_CPU_FLAG_3DNOW 0x0004   ///< AMD 3DNOW
#define AV_CPU_FLAG_SSE 0x0008     ///< SSE functions
#define AV_CPU_FLAG_SSE2 0x0010    ///< PIV SSE2 functions
#define AV_CPU_FLAG_SSE2SLOW \
  0x40000000                         ///< SSE2 supported, but usually not faster
                                     ///< than regular MMX/SSE (e.g. Core1)
#define AV_CPU_FLAG_3DNOWEXT 0x0020  ///< AMD 3DNowExt
#define AV_CPU_FLAG_SSE3 0x0040      ///< Prescott SSE3 functions
#define AV_CPU_FLAG_SSE3SLOW \
  0x20000000                      ///< SSE3 supported, but usually not faster
                                  ///< than regular MMX/SSE (e.g. Core1)
#define AV_CPU_FLAG_SSSE3 0x0080  ///< Conroe SSSE3 functions
#define AV_CPU_FLAG_SSSE3SLOW \
  0x4000000  ///< SSSE3 supported, but usually not faster
#define AV_CPU_FLAG_ATOM \
  0x10000000  ///< Atom processor, some SSSE3 instructions are slower
#define AV_CPU_FLAG_SSE4 0x0100    ///< Penryn SSE4.1 functions
#define AV_CPU_FLAG_SSE42 0x0200   ///< Nehalem SSE4.2 functions
#define AV_CPU_FLAG_AESNI 0x80000  ///< Advanced Encryption Standard functions
#define AV_CPU_FLAG_AVX \
  0x4000  ///< AVX functions: requires OS support even if YMM registers aren't
          ///< used
#define AV_CPU_FLAG_AVXSLOW \
  0x8000000  ///< AVX supported, but slow when using YMM registers (e.g.
             ///< Bulldozer)
#define AV_CPU_FLAG_XOP 0x0400   ///< Bulldozer XOP functions
#define AV_CPU_FLAG_FMA4 0x0800  ///< Bulldozer FMA4 functions
#define AV_CPU_FLAG_CMOV 0x1000  ///< supports cmov instruction
#define AV_CPU_FLAG_AVX2 \
  0x8000  ///< AVX2 functions: requires OS support even if YMM registers aren't
          ///< used
#define AV_CPU_FLAG_FMA3 0x10000  ///< Haswell FMA3 functions
#define AV_CPU_FLAG_BMI1 0x20000  ///< Bit Manipulation Instruction Set 1
#define AV_CPU_FLAG_BMI2 0x40000  ///< Bit Manipulation Instruction Set 2
#define AV_CPU_FLAG_AVX512 \
  0x100000  ///< AVX-512 functions: requires OS support even if YMM/ZMM
            ///< registers aren't used
#define AV_CPU_FLAG_SLOW_GATHER 0x2000000  ///< CPU has slow gathers.

#define AV_CPU_FLAG_ALTIVEC 0x0001  ///< standard
#define AV_CPU_FLAG_VSX 0x0002      ///< ISA 2.06
#define AV_CPU_FLAG_POWER8 0x0004   ///< ISA 2.07

#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
#define AV_CPU_FLAG_SETEND (1 << 16)

#define AV_CPU_FLAG_MMI (1 << 0)
#define AV_CPU_FLAG_MSA (1 << 1)

// Loongarch SIMD extension.
#define AV_CPU_FLAG_LSX (1 << 0)
#define AV_CPU_FLAG_LASX (1 << 1)

/**
 * 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.
 */
int av_get_cpu_flags(void);

/**
 * Disables cpu detection and forces the specified flags.
 * -1 is a special case that disables forcing of specific flags.
 */
void av_force_cpu_flags(int flags);

/**
 * Parse CPU caps from a string and update the given AV_CPU_* flags based on
 * that.
 *
 * @return negative on error.
 */
int av_parse_cpu_caps(unsigned* flags, const char* s);

/**
 * @return the number of logical CPU cores present.
 */
int av_cpu_count(void);

/**
 * Overrides cpu count detection and forces the specified count.
 * Count < 1 disables forcing of specific count.
 */
void av_cpu_force_count(int count);

/**
 * 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.
 */
size_t av_cpu_max_align(void);

#endif /* AVUTIL_CPU_H */