blob: d01541c4e1fdde6f342482fa8789a6867aa6933c [file] [log] [blame]
// Copyright 2016 The Cobalt Authors. All Rights Reserved.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
// The Starboard configuration for a stub implementation designed to be
// built on Desktop Linux. Other devices will have real Starboard
// implementations.
// Other source files should never include this header directly, but should
// include the generic "starboard/configuration.h" instead.
#ifndef STARBOARD_STUB_CONFIGURATION_PUBLIC_H_
#define STARBOARD_STUB_CONFIGURATION_PUBLIC_H_
#if SB_API_VERSION != SB_EXPERIMENTAL_API_VERSION
#error \
"This platform's sabi.json file is expected to track the experimental " \
"Starboard API version."
#endif // SB_API_VERSION != SB_EXPERIMENTAL_API_VERSION
// --- Architecture Configuration --------------------------------------------
// Configuration parameters that allow the application to make some general
// compile-time decisions with respect to the the number of cores likely to be
// available on this platform. For a definitive measure, the application should
// still call SbSystemGetNumberOfProcessors at runtime.
// Whether the current platform's thread scheduler will automatically balance
// threads between cores, as opposed to systems where threads will only ever run
// on the specifically pinned core.
#define SB_HAS_CROSS_CORE_SCHEDULER 1
// Some platforms will not align variables on the stack with an alignment
// greater than 16 bytes. Platforms where this is the case should define the
// following quirk.
#undef SB_HAS_QUIRK_DOES_NOT_STACK_ALIGN_OVER_16_BYTES
// Some platforms do not have thread affinity support. Platforms where this is
// the case should define the following quirk.
#undef SB_HAS_QUIRK_THREAD_AFFINITY_UNSUPPORTED
// Some platforms the mapped GL buffer memory is slow to read from. Platforms
// where this is the case should define the following quirk.
#undef SB_HAS_QUIRK_GL_MAP_BUFFER_MEMORY_IS_SLOW_TO_READ
// --- System Header Configuration -------------------------------------------
// Any system headers listed here that are not provided by the platform will be
// emulated in starboard/types.h.
// Whether the current platform provides the standard header stdarg.h.
#define SB_HAS_STDARG_H 1
// Whether the current platform provides the standard header stdbool.h.
#define SB_HAS_STDBOOL_H 1
// Whether the current platform provides the standard header stddef.h.
#define SB_HAS_STDDEF_H 1
// Whether the current platform provides the standard header stdint.h.
#define SB_HAS_STDINT_H 1
// Whether the current platform provides the standard header inttypes.h.
#define SB_HAS_INTTYPES_H 1
// Whether the current platform provides the standard header sys/types.h.
#define SB_HAS_SYS_TYPES_H 0
// Whether the current platform provides the standard header limits.h.
#define SB_HAS_LIMITS_H 1
// Whether the current platform provides the standard header float.h.
#define SB_HAS_FLOAT_H 1
// Whether the current platform provides ssize_t.
#define SB_HAS_SSIZE_T 1
// Type detection for wchar_t.
#if defined(__WCHAR_MAX__) && \
(__WCHAR_MAX__ == 0x7fffffff || __WCHAR_MAX__ == 0xffffffff)
#define SB_IS_WCHAR_T_UTF32 1
#elif defined(__WCHAR_MAX__) && \
(__WCHAR_MAX__ == 0x7fff || __WCHAR_MAX__ == 0xffff)
#define SB_IS_WCHAR_T_UTF16 1
#endif
// Chrome only defines these two if ARMEL or MIPSEL are defined.
#if defined(__ARMEL__)
// Chrome has an exclusion for iOS here, we should too when we support iOS.
#define SB_IS_WCHAR_T_UNSIGNED 1
#elif defined(__MIPSEL__)
#define SB_IS_WCHAR_T_SIGNED 1
#endif
// Some platforms have memset predefined in system headers. Platforms where this
// is the case should define the following quirk.
#undef SB_HAS_QUIRK_MEMSET_IN_SYSTEM_HEADERS
// This quirk is used to switch the headers included in
// starboard/shared/linux/socket_get_interface_address.cc for darwin system
// headers. It may be removed at some point in favor of a different solution.
#undef SB_HAS_QUIRK_SOCKET_BSD_HEADERS
// Some platforms don't support gmtime_r. Platforms where this is the case
// should define the following quirk.
#undef SB_HAS_QUIRK_NO_GMTIME_R
// --- Compiler Configuration ------------------------------------------------
// The platform's annotation for forcing a C function to be inlined.
#define SB_C_FORCE_INLINE __inline__ __attribute__((always_inline))
// The platform's annotation for marking a C function as suggested to be
// inlined.
#define SB_C_INLINE inline
// The platform's annotation for marking a C function as forcibly not
// inlined.
#define SB_C_NOINLINE __attribute__((noinline))
// The platform's annotation for marking a symbol as exported outside of the
// current shared library.
#define SB_EXPORT_PLATFORM __attribute__((visibility("default")))
// The platform's annotation for marking a symbol as imported from outside of
// the current linking unit.
#define SB_IMPORT_PLATFORM
// On some platforms the __GNUC__ is defined even though parts of the
// functionality are missing. Setting this to non-zero allows disabling missing
// functionality encountered.
#undef SB_HAS_QUIRK_COMPILER_SAYS_GNUC_BUT_ISNT
// On some compilers, the frontend has a quirk such that #ifdef cannot
// correctly detect __has_feature is defined, and an example error you get is:
#undef SB_HAS_QUIRK_HASFEATURE_NOT_DEFINED_BUT_IT_IS
// --- Extensions Configuration ----------------------------------------------
// Do not use <unordered_map> and <unordered_set> for the hash table types.
#define SB_HAS_STD_UNORDERED_HASH 0
// GCC/Clang doesn't define a long long hash function, except for Android and
// Game consoles.
#define SB_HAS_LONG_LONG_HASH 0
// GCC/Clang doesn't define a string hash function, except for Game Consoles.
#define SB_HAS_STRING_HASH 0
// Desktop Linux needs a using statement for the hash functions.
#define SB_HAS_HASH_USING 0
// Set this to 1 if hash functions for custom types can be defined as a
// hash_value() function. Otherwise, they need to be placed inside a
// partially-specified hash struct template with an operator().
#define SB_HAS_HASH_VALUE 0
// Set this to 1 if use of hash_map or hash_set causes a deprecation warning
// (which then breaks the build).
#define SB_HAS_HASH_WARNING 1
// The location to include hash_map on this platform.
#define SB_HASH_MAP_INCLUDE <ext/hash_map>
// C++'s hash_map and hash_set are often found in different namespaces depending
// on the compiler.
#define SB_HASH_NAMESPACE __gnu_cxx
// The location to include hash_set on this platform.
#define SB_HASH_SET_INCLUDE <ext/hash_set>
// Define this to how this platform copies varargs blocks.
#define SB_VA_COPY(dest, source) va_copy(dest, source)
// --- Filesystem Configuration ----------------------------------------------
// Some operating systems constantly return zero values for creation, access
// and modification time for files and directories. When this quirk is defined,
// we need to ignore corresponded time values in applications as well as take
// this fact into account in unit tests.
#undef SB_HAS_QUIRK_FILESYSTEM_ZERO_FILEINFO_TIME
// On some platforms the file system stores access times at a coarser
// granularity than other times. When this quirk is defined, we assume the
// access time is of 1 day precision.
#undef SB_HAS_QUIRK_FILESYSTEM_COARSE_ACCESS_TIME
// On some platforms the file system cannot access extremely long file names.
// We do not need this feature on stub.
#undef SB_HAS_QUIRK_HASH_FILE_NAME
// --- Graphics Configuration ------------------------------------------------
// Specifies whether this platform supports a performant accelerated blitter
// API. The basic requirement is a scaled, clipped, alpha-blended blit.
#define SB_HAS_BLITTER 0
// Indicates whether or not the given platform supports bilinear filtering.
// This can be checked to enable/disable renderer tests that verify that this is
// working properly.
#define SB_HAS_BILINEAR_FILTERING_SUPPORT 1
// Indicates whether or not the given platform supports rendering of NV12
// textures. These textures typically originate from video decoders.
#define SB_HAS_NV12_TEXTURE_SUPPORT 0
#define SB_HAS_VIRTUAL_REALITY 1
// --- I/O Configuration -----------------------------------------------------
// Whether the current platform implements the on screen keyboard interface.
#define SB_HAS_ON_SCREEN_KEYBOARD 0
// Whether the current platform has speech recognizer.
#define SB_HAS_SPEECH_RECOGNIZER 1
// Whether the current platform has speech synthesis.
#define SB_HAS_SPEECH_SYNTHESIS 1
// --- Media Configuration ---------------------------------------------------
// After a seek is triggerred, the default behavior is to append video frames
// from the last key frame before the seek time and append audio frames from the
// seek time because usually all audio frames are key frames. On platforms that
// cannot decode video frames without displaying them, this will cause the video
// being played without audio for several seconds after seeking. When the
// following macro is defined, the app will append audio frames start from the
// timestamp that is before the timestamp of the video key frame being appended.
#undef SB_HAS_QUIRK_SEEK_TO_KEYFRAME
// The implementation is allowed to support kSbMediaAudioSampleTypeInt16 only
// when this macro is defined.
#undef SB_HAS_QUIRK_SUPPORT_INT16_AUDIO_SAMPLES
// dlmalloc will use the ffs intrinsic if available. Platforms on which this is
// not available should define the following quirk.
#undef SB_HAS_QUIRK_NO_FFS
// --- Decoder-only Params ---
// --- Memory Configuration --------------------------------------------------
// Whether this platform has and should use an MMAP function to map physical
// memory to the virtual address space.
#if SB_API_VERSION < 12
#define SB_HAS_MMAP 1
#endif
// Whether this platform can map executable memory. Implies SB_HAS_MMAP. This is
// required for platforms that want to JIT.
#define SB_CAN_MAP_EXECUTABLE_MEMORY 1
// --- Network Configuration -------------------------------------------------
// Specifies whether this platform supports IPV6.
#define SB_HAS_IPV6 1
// Specifies whether this platform supports pipe.
#define SB_HAS_PIPE 1
// --- Thread Configuration --------------------------------------------------
// --- Timing API ------------------------------------------------------------
// Whether this platform has an API to retrieve how long the current thread
// has spent in the executing state.
#define SB_HAS_TIME_THREAD_NOW 1
// --- Tuneable Parameters ---------------------------------------------------
// --- User Configuration ----------------------------------------------------
// --- Platform Specific Audits ----------------------------------------------
#if !defined(__GNUC__)
#error "Stub builds need a GCC-like compiler (for the moment)."
#endif
#endif // STARBOARD_STUB_CONFIGURATION_PUBLIC_H_