C
SafeWindowException Class
class SafeRenderer::SafeWindowExceptionThe SafeWindowException class is an exception class for SafeWindow. More...
| Header: | #include <SafeWindowException> |
| Since: | QtSafeRenderer 1.2 |
| Inherits: | SafeRenderer::QSafeException |
Public Types
| enum class | WindowException { FailureToOpen, DumbFbNotSupported, FailureToGetResources, ConnectorNotConfigured, FrameBufferNotCreated, …, FailedToEnableWindowSurface } |
Public Functions
| SafeWindowException(const SafeRenderer::SafeWindowException::WindowException exceptionIdArg, const SafeRenderer::qchar *const reasonArg, const SafeRenderer::qchar *const additionalInformationArg = nullptr) | |
| SafeWindowException(const SafeRenderer::SafeWindowException &other) | |
| virtual const SafeRenderer::qchar * | additionalInformation() const |
| SafeRenderer::SafeWindowException::WindowException | exceptionId() const |
Reimplemented Public Functions
| virtual SafeRenderer::QSafeException::ExceptionType | type() const override |
Detailed Description
The SafeWindowException is thrown in case of any errors are detected during initialization or runtime in the implemented graphics adaptation.
Member Type Documentation
enum class SafeWindowException::WindowException
This enum describes possible reasons for a thrown SafeRenderer::SafeWindowException. The adaptation that throws the exception with the described id, is marked after the description in parenthesis. If no parenthesis are given, the exception id is not adaptation specific and may be used in multiple adaptations.
New adaptations and changes to current adaptations can use these exception ids freely, but in such case this table should be updated to reflect that the specific exception id is used in more than one adaptation.
| Constant | Value | Description |
|---|---|---|
SafeRenderer::SafeWindowException::WindowException::FailureToOpen | 0 | Failed to open the frame buffer device (DRM) |
SafeRenderer::SafeWindowException::WindowException::DumbFbNotSupported | 1 | Dumb frame buffer is not supported (DRM) |
SafeRenderer::SafeWindowException::WindowException::FailureToGetResources | 2 | Failed to get resources (DRM) |
SafeRenderer::SafeWindowException::WindowException::ConnectorNotConfigured | 3 | Failed to configure a connector (DRM) |
SafeRenderer::SafeWindowException::WindowException::FrameBufferNotCreated | 4 | Failed to create the frame buffer (DRM) |
SafeRenderer::SafeWindowException::WindowException::FailedToSetMode | 5 | Failed to set mode (DRM) |
SafeRenderer::SafeWindowException::WindowException::FailedToInitPlane | 6 | Failed to set plane (DRM) |
SafeRenderer::SafeWindowException::WindowException::FailedToInitialize | 7 | Any part that has no specific failure reason in initialization has failed |
SafeRenderer::SafeWindowException::WindowException::FailedToInitializePixmap | 8 | Failed to initialize pixmap (QNXSCREEN) |
SafeRenderer::SafeWindowException::WindowException::FailedToInitializeScreen | 9 | Failed to initialize screen (QNXSCREEN) |
SafeRenderer::SafeWindowException::WindowException::FbNotMapped | 10 | Failed to map dumb frame buffer (DRM) |
SafeRenderer::SafeWindowException::WindowException::FbNotAdded | 11 | Failed to add format for dumb frame buffer (DRM) |
SafeRenderer::SafeWindowException::WindowException::FbNotCreated | 12 | Failed to create dumb frame buffer (DRM) |
SafeRenderer::SafeWindowException::WindowException::FailedToInitializeDevice | 13 | Failed to initialize device (RCAR3) |
SafeRenderer::SafeWindowException::WindowException::FailedToSetScreenBackground | 14 | Failed to set screen background (RCAR3) |
SafeRenderer::SafeWindowException::WindowException::FailedToEnableScreen | 15 | Failed to enable screen (RCAR3) |
SafeRenderer::SafeWindowException::WindowException::FailedToCreateWindowLayer | 16 | Failed to create window layer (RCAR3) |
SafeRenderer::SafeWindowException::WindowException::FailedToRegisterVsyncEvent | 17 | Failed to register vsync event (RCAR3) |
SafeRenderer::SafeWindowException::WindowException::FailedToEnableWindowSurface | 18 | Failed to enable window surface (RCAR3) |
Member Function Documentation
SafeWindowException::SafeWindowException(const SafeRenderer::SafeWindowException::WindowException exceptionIdArg, const SafeRenderer::qchar *const reasonArg, const SafeRenderer::qchar *const additionalInformationArg = nullptr)
Constructs SafeWindowException. exceptionIdArg Exception id for this exception reasonArg Description of the exception in readable format additionalInformationArg Any additional information that the system can provide for this exception
SafeWindowException::SafeWindowException(const SafeRenderer::SafeWindowException &other)
Constructs SafeWindowException from another SafeWindowException instance. other The other SafeWindowException to copy the information from.
[virtual] const SafeRenderer::qchar *SafeWindowException::additionalInformation() const
Certain exceptions can include additional information to the basic what() and exception id information. For example in file system exceptions the additional information could contain filename of the file that caused an error.
Returns Additional information provided by the system for this exception
SafeRenderer::SafeWindowException::WindowException SafeWindowException::exceptionId() const
Getter for exception id for this exception.
Returns Id of this exception describing the type of error encountered
[override virtual] SafeRenderer::QSafeException::ExceptionType SafeWindowException::type() const
Getter for the type of this exception. Overwrites the base QSafeException class method to return proper type for SafeWindowException.
Returns Type of this exception.
Note: If any class inherits SafeWindowException, it should add a new QSafeException::ExceptionType enum entry instead of using the same QSafeException::ExceptionType::WindowException.
Available under certain Qt licenses.
Find out more.
