HUSD_ConfigureLayer.h

Go to the documentation of this file.

/*
 * Copyright 2019 Side Effects Software Inc.
 * 
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 * 
 *     http://www.apache.org/licenses/LICENSE-2.0
 * 
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
 */

#ifndef __HUSD_ConfigureLayer_h__
#define __HUSD_ConfigureLayer_h__

#include "HUSD_API.h"
#include "HUSD_DataHandle.h"
#include <UT/UT_StringHolder.h>

class HUSD_API HUSD_ConfigureLayer
{
public:
                         HUSD_ConfigureLayer(HUSD_AutoWriteLock &lock);
                        ~HUSD_ConfigureLayer();

    // This flag controls whether all future calls to this object should
    // just affect the active layer, or should also be applied to the stage
    // root layer.
    void                 setModifyRootLayer(bool modifyrootlayer);

    // Sets Houdini-specific custom data to control the save location and
    // save behavior for this layer.
    bool                 setSavePath(const UT_StringRef &save_path,
                                bool save_path_is_time_dependent) const;
    bool                 setSaveControl(const UT_StringRef &save_control) const;

    // Sets standard layer metadata items.
    bool                 setStartTime(fpreal64 start_time) const;
    bool                 setEndTime(fpreal64 end_time) const;
    bool                 setTimeCodesPerSecond(fpreal64 time_per_second) const;
    bool                 setFramesPerSecond(fpreal64 frames_per_second) const;
    bool                 setDefaultPrim(const UT_StringRef &primpath) const;
    bool                 setComment(const UT_StringRef &comment) const;

    // Stage level metrics.
    bool                 setUpAxis(const UT_StringRef &upaxis) const;
    bool                 setMetersPerUnit(fpreal metersperunit) const;

    // Stage level color configuration defaults.
    bool                 setColorConfig(const UT_StringRef &color_config) const;
    bool                 setColorManagementSystem(
                                const UT_StringRef &color_system) const;

    // Render settings metadata
    bool                 setRenderSettings(const UT_StringRef &primpath) const;

    // This function sets a stage variable on the layer.
    // Supported UT_ValueTypes can be found in HUSD_CustomData.h.
    // Make sure to explicitly cast to one of these data types, even if
    // implicit conversions exist.
    template<typename UtValueType>
    bool                 setStageVariable(const UT_StringRef &key,
                                const UtValueType &value) const;

private:
    HUSD_AutoWriteLock  &myWriteLock;
    bool                 myModifyRootLayer;
};

#endif