starboard/stub/configuration_public.h - cobalt - Git at Google

 // 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_

 // --- Architecture Configuration --------------------------------------------

 // 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

 // --- 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 sys/types.h.
 #define SB_HAS_SYS_TYPES_H 0

 // 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 this for ARMEL.
 #if defined(__ARMEL__)
 // Chrome has an exclusion for iOS here, we should too when we support iOS.
 #define SB_IS_WCHAR_T_UNSIGNED 1
 #endif

 // 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

 // --- 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>

 // --- 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 synthesis.
 #define SB_HAS_SPEECH_SYNTHESIS 1

 // --- Media Configuration ---------------------------------------------------

 // After a seek is triggered, 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.
 //
 // This quirk has been deprecated in Starboard version 12 or later.  Please see
 // `configuration_public.md` for more details.
 #if SB_API_VERSION < 12
 #undef SB_HAS_QUIRK_SEEK_TO_KEYFRAME
 #endif  // SB_API_VERSION < 12

 // The implementation is allowed to support kSbMediaAudioSampleTypeInt16 only
 // when this macro is defined.
 #undef SB_HAS_QUIRK_SUPPORT_INT16_AUDIO_SAMPLES

 // --- 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_
	// 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_

	// --- Architecture Configuration --------------------------------------------

	// 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

	// --- 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 sys/types.h.
	#define SB_HAS_SYS_TYPES_H 0

	// 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 this for ARMEL.
	#if defined(__ARMEL__)
	// Chrome has an exclusion for iOS here, we should too when we support iOS.
	#define SB_IS_WCHAR_T_UNSIGNED 1
	#endif

	// 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

	// --- 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>

	// --- 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 synthesis.
	#define SB_HAS_SPEECH_SYNTHESIS 1

	// --- Media Configuration ---------------------------------------------------

	// After a seek is triggered, 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.
	//
	// This quirk has been deprecated in Starboard version 12 or later. Please see
	// `configuration_public.md` for more details.
	#if SB_API_VERSION < 12
	#undef SB_HAS_QUIRK_SEEK_TO_KEYFRAME
	#endif // SB_API_VERSION < 12

	// The implementation is allowed to support kSbMediaAudioSampleTypeInt16 only
	// when this macro is defined.
	#undef SB_HAS_QUIRK_SUPPORT_INT16_AUDIO_SAMPLES

	// --- 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_