Add the ability to query DCM capability from Python.

Myst V didn't have this function either. That's interesting because, in
theory, we may be presented with a video card that doesn't support the
Direct3D caps needed to perform the effect. At this stage in the game,
everyone should support DCMs, so this is just an exercise in technical
correctness.

Scripts/Python/plasma/Plasma.py

@@ -827,6 +827,10 @@ def PtStartScreenCapture(selfKey,width=800,height=600):
     """Starts a capture of the screen"""
     pass
 
+def PtSupportsPlanarReflections() -> bool:
+    """Returns if planar reflections are supported"""
+    ...
+
 def PtToggleAvatarClickability(on):
     """Turns on and off our avatar's clickability"""
     pass

Sources/Plasma/FeatureLib/pfPython/cyMisc.cpp

@@ -2541,6 +2541,11 @@ void cyMisc::EnablePlanarReflections(bool enable)
     plDynamicCamMap::SetEnabled(enable);
 }
 
+bool cyMisc::ArePlanarReflectionsSupported()
+{
+    return plDynamicCamMap::GetCapable();
+}
+
 void cyMisc::GetSupportedDisplayModes(std::vector<plDisplayMode> *res)
 {
     fPipeline->GetSupportedDisplayModes(res);

Sources/Plasma/FeatureLib/pfPython/cyMisc.h

@@ -898,6 +898,7 @@ class cyMisc
     static ST::string GetLocalizedString(const ST::string& name, const std::vector<ST::string> & arguments);
 
     static void EnablePlanarReflections(bool enable = true);
+    static bool ArePlanarReflectionsSupported();
     static void SetGraphicsOptions(int Width, int Height, int ColorDepth, bool Windowed, int NumAASamples, int MaxAnisotropicSamples, bool VSync);
     static void GetSupportedDisplayModes(std::vector<plDisplayMode> *res);
     static int GetDesktopWidth();

Sources/Plasma/FeatureLib/pfPython/cyMiscGlue4.cpp

@@ -610,6 +610,11 @@ PYTHON_GLOBAL_METHOD_DEFINITION(PtEnablePlanarReflections, args, "Params: on\nEn
     PYTHON_RETURN_NONE;
 }
 
+PYTHON_GLOBAL_METHOD_DEFINITION_NOARGS(PtSupportsPlanarReflections, "Returns if planar reflections are supported")
+{
+    return PyBool_FromLong(cyMisc::ArePlanarReflectionsSupported() ? 1 : 0);
+}
+
 PYTHON_GLOBAL_METHOD_DEFINITION_NOARGS(PtGetSupportedDisplayModes, "Returns a list of supported resolutions")
 {
     std::vector<plDisplayMode> res;
@@ -818,6 +823,7 @@ void cyMisc::AddPlasmaMethods4(PyObject* m)
         PYTHON_GLOBAL_METHOD_NOARGS(PtCheckVisLOSFromCursor)
 
         PYTHON_GLOBAL_METHOD(PtEnablePlanarReflections)
+        PYTHON_GLOBAL_METHOD_NOARGS(PtSupportsPlanarReflections)
         PYTHON_GLOBAL_METHOD_NOARGS(PtGetSupportedDisplayModes)
         PYTHON_GLOBAL_METHOD_NOARGS(PtGetDesktopWidth)
         PYTHON_GLOBAL_METHOD_NOARGS(PtGetDesktopHeight)