renderDelegate.h

//
// Copyright 2017 Pixar
//
// Licensed under the Apache License, Version 2.0 (the "Apache License")
// with the following modification; you may not use this file except in
// compliance with the Apache License and the following modification to it:
// Section 6. Trademarks. is deleted and replaced with:
//
// 6. Trademarks. This License does not grant permission to use the trade
//    names, trademarks, service marks, or product names of the Licensor
//    and its affiliates, except as required to comply with Section 4(c) of
//    the License and to reproduce the content of the NOTICE file.
//
// You may obtain a copy of the Apache License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the Apache License with the above modification is
// distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
// KIND, either express or implied. See the Apache License for the specific
// language governing permissions and limitations under the Apache License.
//
#ifndef PXR_IMAGING_PLUGIN_HD_EMBREE_RENDER_DELEGATE_H
#define PXR_IMAGING_PLUGIN_HD_EMBREE_RENDER_DELEGATE_H
 
#include "pxr/pxr.h"
#include "pxr/imaging/hd/renderDelegate.h"
#include "pxr/imaging/hd/renderThread.h"
#include "pxr/imaging/plugin/hdEmbree/renderer.h"
#include "pxr/base/tf/staticTokens.h"
 
#include <mutex>
#include <embree3/rtcore.h>
 
PXR_NAMESPACE_OPEN_SCOPE
 
class HdEmbreeRenderParam;
 
#define HDEMBREE_RENDER_SETTINGS_TOKENS \
    (enableAmbientOcclusion)            \
    (enableSceneColors)                 \
    (ambientOcclusionSamples)
 
// Also: HdRenderSettingsTokens->convergedSamplesPerPixel
 
TF_DECLARE_PUBLIC_TOKENS(HdEmbreeRenderSettingsTokens, HDEMBREE_RENDER_SETTINGS_TOKENS);
 
class HdEmbreeRenderDelegate final : public HdRenderDelegate
{
public:
    HdEmbreeRenderDelegate();
    HdEmbreeRenderDelegate(HdRenderSettingsMap const& settingsMap);
    ~HdEmbreeRenderDelegate() override;
 
    HdRenderParam *GetRenderParam() const override;
 
    const TfTokenVector &GetSupportedRprimTypes() const override;
    const TfTokenVector &GetSupportedSprimTypes() const override;
    const TfTokenVector &GetSupportedBprimTypes() const override;
 
    HdResourceRegistrySharedPtr GetResourceRegistry() const override;
 
    HdRenderSettingDescriptorList
        GetRenderSettingDescriptors() const override;
 
    bool IsPauseSupported() const override;
 
    bool Pause() override;
 
    bool Resume() override;
 
    HdRenderPassSharedPtr CreateRenderPass(HdRenderIndex *index,
                HdRprimCollection const& collection) override;
 
    HdInstancer *CreateInstancer(HdSceneDelegate *delegate,
                                 SdfPath const& id) override;
 
    void DestroyInstancer(HdInstancer *instancer) override;
 
    HdRprim *CreateRprim(TfToken const& typeId,
                         SdfPath const& rprimId) override;
 
    void DestroyRprim(HdRprim *rPrim) override;
 
    HdSprim *CreateSprim(TfToken const& typeId,
                         SdfPath const& sprimId) override;
 
    HdSprim *CreateFallbackSprim(TfToken const& typeId) override;
 
    void DestroySprim(HdSprim *sPrim) override;
 
    HdBprim *CreateBprim(TfToken const& typeId,
                         SdfPath const& bprimId) override;
 
    HdBprim *CreateFallbackBprim(TfToken const& typeId) override;
 
    void DestroyBprim(HdBprim *bPrim) override;
 
    void CommitResources(HdChangeTracker *tracker) override;
 
    TfToken GetMaterialBindingPurpose() const override {
        return HdTokens->full;
    }
 
    HdAovDescriptor
        GetDefaultAovDescriptor(TfToken const& name) const override;
 
    VtDictionary GetRenderStats() const override;
 
private:
    static const TfTokenVector SUPPORTED_RPRIM_TYPES;
    static const TfTokenVector SUPPORTED_SPRIM_TYPES;
    static const TfTokenVector SUPPORTED_BPRIM_TYPES;
 
    static std::mutex _mutexResourceRegistry;
    static std::atomic_int _counterResourceRegistry;
    static HdResourceRegistrySharedPtr _resourceRegistry;
 
    // This class does not support copying.
    HdEmbreeRenderDelegate(const HdEmbreeRenderDelegate &)             = delete;
    HdEmbreeRenderDelegate &operator =(const HdEmbreeRenderDelegate &) = delete;
 
    // Embree initialization routine.
    void _Initialize();
 
    // Handle for an embree "device", or library state.
    RTCDevice _rtcDevice;
 
    // Handle for the top-level embree scene, mirroring the Hydra scene.
    RTCScene _rtcScene;
 
    // A version counter for edits to _scene.
    std::atomic<int> _sceneVersion;
 
    // A shared HdEmbreeRenderParam object that stores top-level embree state;
    // passed to prims during Sync().
    std::shared_ptr<HdEmbreeRenderParam> _renderParam;
 
    // A background render thread for running the actual renders in. The
    // render thread object manages synchronization between the scene data
    // and the background-threaded renderer.
    HdRenderThread _renderThread;
 
    // An embree renderer object, to perform the actual raytracing.
    HdEmbreeRenderer _renderer;
 
    // A list of render setting exports.
    HdRenderSettingDescriptorList _settingDescriptors;
 
    // A callback that interprets embree error codes and injects them into
    // the hydra logging system.
    static void HandleRtcError(void* userPtr, RTCError code, const char *msg);
};
 
 
PXR_NAMESPACE_CLOSE_SCOPE
 
#endif // PXR_IMAGING_PLUGIN_HD_EMBREE_RENDER_DELEGATE_H