frameRecorder.h

Go to the documentation of this file.

//
// Copyright 2019 Pixar
//
// Licensed under the terms set forth in the LICENSE.txt file available at
// https://openusd.org/license.
//
#ifndef PXR_USD_IMAGING_USD_APP_UTILS_FRAME_RECORDER_H
#define PXR_USD_IMAGING_USD_APP_UTILS_FRAME_RECORDER_H
 
 
#include "pxr/pxr.h"
#include "pxr/usdImaging/usdAppUtils/api.h"
 
#include "pxr/base/tf/diagnostic.h"
#include "pxr/base/tf/token.h"
#include "pxr/usd/usd/stage.h"
#include "pxr/usd/usd/timeCode.h"
#include "pxr/usd/usdGeom/camera.h"
#include "pxr/usdImaging/usdImagingGL/engine.h"
 
#include <string>
 
 
PXR_NAMESPACE_OPEN_SCOPE
 
 
class UsdAppUtilsFrameRecorder
{
public:
    USDAPPUTILS_API
    UsdAppUtilsFrameRecorder(
        const TfToken& rendererPluginId = TfToken(),
        bool gpuEnabled = true,
        bool enableUsdDrawModes = true);
 
    TfToken GetCurrentRendererId() const {
        return _imagingEngine.GetCurrentRendererId();
    }
 
    bool SetRendererPlugin(const TfToken& id) {
        const bool succeeded = _imagingEngine.SetRendererPlugin(id);
        _imagingEngine.SetEnablePresentation(false);
 
        return succeeded;
    }
 
    USDAPPUTILS_API
    void SetActiveRenderPassPrimPath(SdfPath const& path);
 
    USDAPPUTILS_API
    void SetActiveRenderSettingsPrimPath(SdfPath const& path);
 
    void SetImageWidth(const size_t imageWidth) {
        if (imageWidth == 0u) {
            TF_CODING_ERROR("Image width cannot be zero");
            return;
        }
        _imageWidth = imageWidth;
    }
 
    void SetComplexity(const float complexity) {
        _complexity = complexity;
    }
 
    USDAPPUTILS_API
    void SetColorCorrectionMode(const TfToken& colorCorrectionMode);
 
    USDAPPUTILS_API
    void SetCameraLightEnabled(bool cameraLightEnabled);
 
    USDAPPUTILS_API
    void SetDomeLightVisibility(bool domeLightsVisible);
 
    USDAPPUTILS_API
    void SetIncludedPurposes(const TfTokenVector& purposes);
 
    USDAPPUTILS_API
    void SetPrimaryCameraPrimPath(const SdfPath& cameraPath);
 
    USDAPPUTILS_API
    bool Record(
            const UsdStagePtr& stage,
            const UsdGeomCamera& usdCamera,
            const UsdTimeCode timeCode,
            const std::string& outputImagePath);
 
private:
    UsdImagingGLEngine _imagingEngine;
    size_t _imageWidth;
    float _complexity;
    TfToken _colorCorrectionMode;
    TfTokenVector _purposes;
    SdfPath _renderPassPrimPath;
    SdfPath _renderSettingsPrimPath;
    bool _cameraLightEnabled;
    bool _domeLightsVisible;
};
 
 
PXR_NAMESPACE_CLOSE_SCOPE
 
 
#endif