2019-11-23 20:27:39 +08:00
|
|
|
/****************************************************************************
|
|
|
|
Copyright (c) 2018-2019 Xiamen Yaji Software Co., Ltd.
|
|
|
|
|
2022-10-01 16:24:52 +08:00
|
|
|
https://axmolengine.github.io/
|
2019-11-23 20:27:39 +08:00
|
|
|
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
|
|
of this software and associated documentation files (the "Software"), to deal
|
|
|
|
in the Software without restriction, including without limitation the rights
|
|
|
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
|
|
copies of the Software, and to permit persons to whom the Software is
|
|
|
|
furnished to do so, subject to the following conditions:
|
|
|
|
|
|
|
|
The above copyright notice and this permission notice shall be included in
|
|
|
|
all copies or substantial portions of the Software.
|
|
|
|
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
|
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
|
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
|
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
|
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
|
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
|
|
THE SOFTWARE.
|
|
|
|
****************************************************************************/
|
2021-12-25 10:04:45 +08:00
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
#pragma once
|
|
|
|
|
|
|
|
#include <string>
|
2023-07-15 19:06:54 +08:00
|
|
|
#include <stdint.h>
|
2019-11-23 20:27:39 +08:00
|
|
|
|
|
|
|
#include "Macros.h"
|
|
|
|
|
2022-07-11 17:50:21 +08:00
|
|
|
NS_AX_BACKEND_BEGIN
|
2019-11-23 20:27:39 +08:00
|
|
|
|
|
|
|
enum class FeatureType : uint32_t
|
|
|
|
{
|
|
|
|
ETC1,
|
2020-08-31 21:04:47 +08:00
|
|
|
ETC2,
|
2019-11-23 20:27:39 +08:00
|
|
|
S3TC,
|
|
|
|
AMD_COMPRESSED_ATC,
|
|
|
|
PVRTC,
|
|
|
|
IMG_FORMAT_BGRA8888,
|
|
|
|
DISCARD_FRAMEBUFFER,
|
|
|
|
PACKED_DEPTH_STENCIL,
|
|
|
|
VAO,
|
|
|
|
MAPBUFFER,
|
|
|
|
DEPTH24,
|
|
|
|
ASTC
|
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @addtogroup _backend
|
|
|
|
* @{
|
|
|
|
*/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Used to query features and implementation limits
|
|
|
|
*/
|
|
|
|
class DeviceInfo
|
|
|
|
{
|
|
|
|
public:
|
|
|
|
virtual ~DeviceInfo() = default;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Gather features and implementation limits
|
|
|
|
*/
|
|
|
|
virtual bool init() = 0;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get vendor device name.
|
|
|
|
* @return Vendor device name.
|
|
|
|
*/
|
|
|
|
virtual const char* getVendor() const = 0;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get the full name of the vendor device.
|
|
|
|
* @return The full name of the vendor device.
|
|
|
|
*/
|
|
|
|
virtual const char* getRenderer() const = 0;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get version name.
|
|
|
|
* @return Version name.
|
|
|
|
*/
|
|
|
|
virtual const char* getVersion() const = 0;
|
|
|
|
|
2023-08-25 16:57:54 +08:00
|
|
|
virtual const char* getShaderVersion() const { return ""; }
|
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
/**
|
2023-08-25 16:57:54 +08:00
|
|
|
* Check does device has extension.
|
2019-11-23 20:27:39 +08:00
|
|
|
*/
|
2023-08-25 16:57:54 +08:00
|
|
|
virtual bool hasExtension(std::string_view /*extName*/) const { return false; };
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Dump all extensions to string
|
|
|
|
*/
|
|
|
|
virtual std::string dumpExtensions() const { return {}; };
|
2019-11-23 20:27:39 +08:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Check if feature supported by device.
|
|
|
|
* @param feature Specify feature to be query.
|
|
|
|
* @return true if the feature is supported, false otherwise.
|
|
|
|
*/
|
|
|
|
virtual bool checkForFeatureSupported(FeatureType feature) = 0;
|
2021-12-25 10:04:45 +08:00
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
/**
|
|
|
|
* Get maximum texture size.
|
|
|
|
* @return Maximum texture size.
|
|
|
|
*/
|
|
|
|
inline int getMaxTextureSize() const { return _maxTextureSize; }
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get maximum attribute counts.
|
|
|
|
* @return Maximum attribute counts.
|
|
|
|
*/
|
|
|
|
inline int getMaxAttributes() const { return _maxAttributes; }
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get maximum texture unit.
|
|
|
|
* @return Maximum texture unit.
|
|
|
|
*/
|
|
|
|
inline int getMaxTextureUnits() const { return _maxTextureUnits; }
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get maximum sampler count.
|
|
|
|
* @return Maximum sampler count.
|
|
|
|
*/
|
|
|
|
inline int getMaxSamplesAllowed() const { return _maxSamplesAllowed; }
|
2021-12-25 10:04:45 +08:00
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
protected:
|
|
|
|
DeviceInfo() = default;
|
2021-12-25 10:04:45 +08:00
|
|
|
|
|
|
|
int _maxAttributes = 0; ///< Maximum attribute count.
|
|
|
|
int _maxTextureSize = 0; ///< Maximum texture size.
|
|
|
|
int _maxTextureUnits = 0; ///< Maximum texture unit.
|
|
|
|
int _maxSamplesAllowed = 0; ///< Maximum sampler count.
|
2019-11-23 20:27:39 +08:00
|
|
|
};
|
|
|
|
|
2021-12-25 10:04:45 +08:00
|
|
|
// end of _backend group
|
2019-11-23 20:27:39 +08:00
|
|
|
/// @}
|
2022-07-11 17:50:21 +08:00
|
|
|
NS_AX_BACKEND_END
|