flaw-dx11/Flaw/Graphics/DXGI.hs

Summary

Maintainability
Test Coverage
{-|
Module: Flaw.Graphics.DXGI
Description: Internals of graphics implementation for DXGI.
License: MIT
-}

{-# LANGUAGE TypeFamilies #-}

module Flaw.Graphics.DXGI
  ( DXGISystem(..)
  , dxgiCreateSystem
  , DeviceId(..)
  , DisplayId(..)
  , DisplayModeId(..)
  , getDXGIDisplayModeDesc
  , getDXGIFormat
  ) where

import Control.Exception
import Data.Ratio
import qualified Data.Text as T
import Foreign.Marshal.Alloc
import Foreign.Marshal.Array
import Foreign.Marshal.Utils
import Foreign.Ptr
import Foreign.Storable

import Flaw.Book
import Flaw.Exception
import Flaw.FFI
import Flaw.FFI.COM
import Flaw.FFI.Win32
import Flaw.Graphics
import Flaw.Graphics.DXGI.FFI
import Flaw.Graphics.Texture

-- | DXGI graphics system.
newtype DXGISystem = DXGISystem
  { dxgiSystemFactory :: IDXGIFactory
  }

dxgiCreateSystem :: IO (DXGISystem, IO ())
dxgiCreateSystem = describeException "failed to create DXGI system" $ do
  (factoryInterface, releaseFactoryInterface) <- allocateCOMObject createDXGIFactory
  return (DXGISystem
    { dxgiSystemFactory = factoryInterface
    }, releaseFactoryInterface)

instance System DXGISystem where
  data DeviceId DXGISystem = DXGIDeviceId DXGISystem IDXGIAdapter
  data DisplayId DXGISystem = DXGIDisplayId (DeviceId DXGISystem) IDXGIOutput
  newtype DisplayModeId DXGISystem = DXGIDisplayModeId DXGI_MODE_DESC deriving Show
  getInstalledDevices system@DXGISystem
    { dxgiSystemFactory = factoryInterface
    } = describeException "failed to get installed DirectX11 devices" $ do
    bk <- newBook
    -- enumerate adapters
    let
      enumerateAdapter i = handle (\(FailedHRESULT _hr) -> return []) $ do
        adapter <- book bk $ allocateCOMObject $ createCOMObjectViaPtr $ m_IDXGIFactory_EnumAdapters factoryInterface i
        rest <- enumerateAdapter $ i + 1
        return $ adapter : rest
    -- make id-info adapter pairs
      makeAdapterIdInfo adapter = do
        -- device id
        let deviceId = DXGIDeviceId system adapter
        -- get adapter desc
        adapterDesc <- createCOMValueViaPtr $ m_IDXGIAdapter_GetDesc adapter
        let
          -- enumerate outputs
          enumerateOutput i = handle (\(FailedHRESULT _hr) -> return []) $ do
            output <- book bk $ allocateCOMObject $ createCOMObjectViaPtr $ m_IDXGIAdapter_EnumOutputs adapter i
            rest <- enumerateOutput $ i + 1
            return $ output : rest
          -- make id-info output pairs
          makeOutputIdInfo output = do
            -- get output desc
            outputDesc <- createCOMValueViaPtr $ m_IDXGIOutput_GetDesc output
            -- enumerate modes
            modeDescs <- alloca $ \modesCountPtr -> do
              hresultCheck =<< m_IDXGIOutput_GetDisplayModeList output (wrapEnum DXGI_FORMAT_R8G8B8A8_UNORM) 0 modesCountPtr nullPtr
              modesCount <- fromIntegral <$> peek modesCountPtr
              allocaArray modesCount $ \modeDescsPtr -> do
                hresultCheck =<< m_IDXGIOutput_GetDisplayModeList output (wrapEnum DXGI_FORMAT_R8G8B8A8_UNORM) 0 modesCountPtr modeDescsPtr
                peekArray modesCount modeDescsPtr
            -- return output pair
            return (DXGIDisplayId deviceId output, DisplayInfo
              { displayName = winUTF16ToText $ f_DXGI_OUTPUT_DESC_DeviceName outputDesc
              , displayModes = map displayModeIdInfoFromDesc modeDescs
              })
        outputs <- mapM makeOutputIdInfo =<< enumerateOutput 0
        -- return adapter pair
        return (deviceId, DeviceInfo
          { deviceName = winUTF16ToText $ f_DXGI_ADAPTER_DESC_Description adapterDesc
          , deviceDisplays = outputs
          })
    adapters <- mapM makeAdapterIdInfo =<< enumerateAdapter 0
    return (adapters, freeBook bk)
  createDisplayMode _system (DXGIDisplayId _adapter output) width height = describeException "failed to try create DirectX11 display mode" $ do
    let
      desc = DXGI_MODE_DESC
        { f_DXGI_MODE_DESC_Width = fromIntegral width
        , f_DXGI_MODE_DESC_Height = fromIntegral height
        , f_DXGI_MODE_DESC_RefreshRate = DXGI_RATIONAL
          { f_DXGI_RATIONAL_Numerator = 0
          , f_DXGI_RATIONAL_Denominator = 0
          }
        , f_DXGI_MODE_DESC_Format = DXGI_FORMAT_R8G8B8A8_UNORM
        , f_DXGI_MODE_DESC_ScanlineOrdering = DXGI_MODE_SCANLINE_ORDER_UNSPECIFIED
        , f_DXGI_MODE_DESC_Scaling = DXGI_MODE_SCALING_UNSPECIFIED
        }
    closestDesc <- with desc $ \descPtr -> createCOMValueViaPtr $ \closestDescPtr -> m_IDXGIOutput_FindClosestMatchingMode output descPtr closestDescPtr nullPtr
    return (displayModeIdInfoFromDesc closestDesc, return ())

-- | Convert DXGI_MODE_DESC to DisplayModeInfo.
displayModeIdInfoFromDesc :: DXGI_MODE_DESC -> (DisplayModeId DXGISystem, DisplayModeInfo)
displayModeIdInfoFromDesc desc@DXGI_MODE_DESC
  { f_DXGI_MODE_DESC_Width = width
  , f_DXGI_MODE_DESC_Height = height
  , f_DXGI_MODE_DESC_RefreshRate = DXGI_RATIONAL
    { f_DXGI_RATIONAL_Numerator = refreshRateNumerator
    , f_DXGI_RATIONAL_Denominator = refreshRateDenominator
    }
  , f_DXGI_MODE_DESC_Format = format
  } = (DXGIDisplayModeId backBufferDesc, info) where
  backBufferDesc = desc
  -- use SRGB back buffer
  -- according to MSDN, this is the right way
  -- https://msdn.microsoft.com/en-us/library/windows/desktop/bb173064
    { f_DXGI_MODE_DESC_Format = case format of
      DXGI_FORMAT_R8G8B8A8_UNORM -> DXGI_FORMAT_R8G8B8A8_UNORM_SRGB
      DXGI_FORMAT_B8G8R8A8_UNORM -> DXGI_FORMAT_B8G8R8A8_UNORM_SRGB
      _ -> format
    }
  info = DisplayModeInfo
    { displayModeName = T.pack $ show desc
    , displayModeWidth = fromIntegral width
    , displayModeHeight = fromIntegral height
    , displayModeRefreshRate = fromIntegral refreshRateNumerator % fromIntegral refreshRateDenominator
    }

-- | Get DXGI_MODE_DESC for back buffer from optional display mode desc.
getDXGIDisplayModeDesc :: Maybe (DisplayModeId DXGISystem) -> Int -> Int -> DXGI_MODE_DESC
getDXGIDisplayModeDesc maybeDisplayMode width height = case maybeDisplayMode of
  Just (DXGIDisplayModeId displayModeDesc) -> displayModeDesc
  Nothing -> DXGI_MODE_DESC
    { f_DXGI_MODE_DESC_Width = fromIntegral width
    , f_DXGI_MODE_DESC_Height = fromIntegral height
    , f_DXGI_MODE_DESC_RefreshRate = DXGI_RATIONAL
      { f_DXGI_RATIONAL_Numerator = 0
      , f_DXGI_RATIONAL_Denominator = 0
      }
    , f_DXGI_MODE_DESC_Format = DXGI_FORMAT_R8G8B8A8_UNORM_SRGB
    , f_DXGI_MODE_DESC_ScanlineOrdering = DXGI_MODE_SCANLINE_ORDER_UNSPECIFIED
    , f_DXGI_MODE_DESC_Scaling = DXGI_MODE_SCALING_UNSPECIFIED
    }

-- | Convert TextureFormat to DXGI_FORMAT.
getDXGIFormat :: TextureFormat -> DXGI_FORMAT
getDXGIFormat t = case t of
  UncompressedTextureFormat
    { textureFormatComponents = components
    , textureFormatValueType = valueType
    , textureFormatPixelSize = pixelSize
    , textureFormatColorSpace = colorSpace
    } -> case components of
      PixelR -> case valueType of
        PixelUntyped -> case pixelSize of
          Pixel8bit -> DXGI_FORMAT_R8_TYPELESS
          Pixel16bit -> DXGI_FORMAT_R16_TYPELESS
          Pixel32bit -> DXGI_FORMAT_R32_TYPELESS
          _ -> DXGI_FORMAT_UNKNOWN
        PixelUint -> case pixelSize of
          Pixel8bit -> DXGI_FORMAT_R8_UNORM
          Pixel16bit -> DXGI_FORMAT_R16_UNORM
          _ -> DXGI_FORMAT_UNKNOWN
        PixelFloat -> case pixelSize of
          Pixel16bit -> DXGI_FORMAT_R16_FLOAT
          Pixel32bit -> DXGI_FORMAT_R32_FLOAT
          _ -> DXGI_FORMAT_UNKNOWN
      PixelRG -> case valueType of
        PixelUntyped -> case pixelSize of
          Pixel16bit -> DXGI_FORMAT_R8G8_TYPELESS
          Pixel32bit -> DXGI_FORMAT_R16G16_TYPELESS
          _ -> DXGI_FORMAT_UNKNOWN
        PixelUint -> case pixelSize of
          Pixel16bit -> DXGI_FORMAT_R8G8_UNORM
          Pixel32bit -> DXGI_FORMAT_R16G16_UNORM
          _ -> DXGI_FORMAT_UNKNOWN
        PixelFloat -> case pixelSize of
          Pixel32bit -> DXGI_FORMAT_R16G16_FLOAT
          Pixel64bit -> DXGI_FORMAT_R32G32_FLOAT
          _ -> DXGI_FORMAT_UNKNOWN
      PixelRGB -> case valueType of
        PixelUntyped -> DXGI_FORMAT_UNKNOWN
        PixelUint -> DXGI_FORMAT_UNKNOWN
        PixelFloat -> case pixelSize of
          Pixel32bit -> DXGI_FORMAT_R11G11B10_FLOAT
          Pixel96bit -> DXGI_FORMAT_R32G32B32_FLOAT
          _ -> DXGI_FORMAT_UNKNOWN
      PixelRGBA -> case valueType of
        PixelUntyped -> case pixelSize of
          Pixel32bit -> DXGI_FORMAT_R10G10B10A2_TYPELESS
          Pixel64bit -> DXGI_FORMAT_R16G16B16A16_TYPELESS
          Pixel128bit -> DXGI_FORMAT_R32G32B32A32_TYPELESS
          _ -> DXGI_FORMAT_UNKNOWN
        PixelUint -> case pixelSize of
          Pixel32bit -> case colorSpace of
            LinearColorSpace -> DXGI_FORMAT_R8G8B8A8_UNORM
            StandardColorSpace -> DXGI_FORMAT_R8G8B8A8_UNORM_SRGB
          Pixel64bit -> DXGI_FORMAT_R16G16B16A16_UNORM
          _ -> DXGI_FORMAT_UNKNOWN
        PixelFloat -> case pixelSize of
          Pixel64bit -> DXGI_FORMAT_R16G16B16A16_FLOAT
          Pixel128bit -> DXGI_FORMAT_R32G32B32A32_FLOAT
          _ -> DXGI_FORMAT_UNKNOWN
  CompressedTextureFormat
    { textureFormatCompression = compression
    , textureFormatColorSpace = colorSpace
    } -> case compression of
      TextureCompressionBC1 -> case colorSpace of
        LinearColorSpace -> DXGI_FORMAT_BC1_UNORM
        StandardColorSpace -> DXGI_FORMAT_BC1_UNORM_SRGB
      TextureCompressionBC1Alpha -> DXGI_FORMAT_UNKNOWN
      TextureCompressionBC2 -> case colorSpace of
        LinearColorSpace -> DXGI_FORMAT_BC2_UNORM
        StandardColorSpace -> DXGI_FORMAT_BC2_UNORM_SRGB
      TextureCompressionBC3 -> case colorSpace of
        LinearColorSpace -> DXGI_FORMAT_BC3_UNORM
        StandardColorSpace -> DXGI_FORMAT_BC3_UNORM_SRGB
      TextureCompressionBC4 -> DXGI_FORMAT_BC4_UNORM
      TextureCompressionBC4Signed -> DXGI_FORMAT_BC4_SNORM
      TextureCompressionBC5 -> DXGI_FORMAT_BC5_UNORM
      TextureCompressionBC5Signed -> DXGI_FORMAT_BC5_SNORM