• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * Copyright 2022 Google LLC
3  *
4  * Use of this source code is governed by a BSD-style license that can be
5  * found in the LICENSE file.
6  */
7 
8 #ifndef SkAPI_DEFINED
9 #define SkAPI_DEFINED
10 
11 #include "include/private/base/SkLoadUserConfig.h" // IWYU pragma: keep
12 
13 // If SKIA_IMPLEMENTATION is defined as 1, that signals we are building Skia and should
14 // export our symbols. If it is not set (or set to 0), then Skia is being used by a client
15 // and we should not export our symbols.
16 #if !defined(SKIA_IMPLEMENTATION)
17     #define SKIA_IMPLEMENTATION 0
18 #endif
19 
20 // If we are compiling Skia is being as a DLL, we need to be sure to export all of our public
21 // APIs to that DLL. If a client is using Skia which was compiled as a DLL, we need to instruct
22 // the linker to use the symbols from that DLL. This is the goal of the SK_API define.
23 #if !defined(SK_API)
24     #if defined(SKIA_DLL)
25         #if defined(_MSC_VER)
26             #if SKIA_IMPLEMENTATION
27                 #define SK_API __declspec(dllexport)
28             #else
29                 #define SK_API __declspec(dllimport)
30             #endif
31         #else
32             #define SK_API __attribute__((visibility("default")))
33         #endif
34     #else
35         #define SK_API
36     #endif
37 #endif
38 
39 // SK_SPI is functionally identical to SK_API, but used within src to clarify that it's less stable
40 #if !defined(SK_SPI)
41     #define SK_SPI SK_API
42 #endif
43 
44 // See https://clang.llvm.org/docs/AttributeReference.html#availability
45 // The API_AVAILABLE macro comes from <os/availability.h> on MacOS
46 #if defined(SK_ENABLE_API_AVAILABLE)
47 #   define SK_API_AVAILABLE API_AVAILABLE
48 #else
49 #   define SK_API_AVAILABLE(...)
50 #endif
51 
52 #endif
53