MovieSceneByteChannel.h

Go to the documentation of this file.

// Copyright Epic Games, Inc. All Rights Reserved.
 
#pragma once
 
#include "Channels/MovieSceneChannelEditorData.h"
#include "Containers/Array.h"
#include "Containers/ArrayView.h"
#include "HAL/Platform.h"
#include "HAL/PlatformCrt.h"
#include "Math/Range.h"
#include "Misc/FrameNumber.h"
#include "Misc/FrameTime.h"
#include "Misc/Optional.h"
#include "MovieSceneChannel.h"
#include "MovieSceneChannelData.h"
#include "MovieSceneChannelTraits.h"
#include "Serialization/StructuredArchive.h"
#include "Templates/UnrealTemplate.h"
#include "UObject/Class.h"
#include "UObject/ObjectMacros.h"
#include "UObject/ObjectPtr.h"
#include "Curves/RealCurve.h"
 
#include "MovieSceneByteChannel.generated.h"
 
struct FFrameRate;
struct FKeyHandle;
struct FPropertyTag;
 
 
USTRUCT()
struct FMovieSceneByteChannel : public FMovieSceneChannel
{
    GENERATED_BODY()
 
    typedef uint8 CurveValueType;
 
    FMovieSceneByteChannel()
        : PreInfinityExtrap(RCCE_Constant)
        , PostInfinityExtrap(RCCE_Constant)
        , DefaultValue(0)
        , bHasDefaultValue(false)
        , Enum(nullptr)
        , KeyHandles()
    {}
 
    MOVIESCENE_API bool SerializeFromMismatchedTag(const FPropertyTag& Tag, FStructuredArchive::FSlot Slot);
 
    inline TMovieSceneChannelData<uint8> GetData()
    {
        return TMovieSceneChannelData<uint8>(&Times, &Values, this, &KeyHandles);
    }
 
    inline TMovieSceneChannelData<const uint8> GetData() const
    {
        return TMovieSceneChannelData<const uint8>(&Times, &Values);
    }
 
    inline TArrayView<const FFrameNumber> GetTimes() const
    {
        return Times;
    }
 
    inline TArrayView<const uint8> GetValues() const
    {
        return Values;
    }
 
    inline bool HasAnyData() const
    {
        return Times.Num() != 0 || bHasDefaultValue == true;
    }
 
    MOVIESCENE_API bool Evaluate(FFrameTime InTime, uint8& OutValue) const;
 
    inline void AddKeys(const TArray<FFrameNumber>& InTimes, const TArray<uint8>& InValues)
    {
        check(InTimes.Num() == InValues.Num());
        Times.Append(InTimes);
        Values.Append(InValues);
    }
 
public:
 
    // ~ FMovieSceneChannel Interface
    MOVIESCENE_API virtual void GetKeys(const TRange<FFrameNumber>& WithinRange, TArray<FFrameNumber>* OutKeyTimes, TArray<FKeyHandle>* OutKeyHandles) override;
    MOVIESCENE_API virtual void GetKeyTimes(TArrayView<const FKeyHandle> InHandles, TArrayView<FFrameNumber> OutKeyTimes) override;
    MOVIESCENE_API virtual void SetKeyTimes(TArrayView<const FKeyHandle> InHandles, TArrayView<const FFrameNumber> InKeyTimes) override;
    MOVIESCENE_API virtual void DuplicateKeys(TArrayView<const FKeyHandle> InHandles, TArrayView<FKeyHandle> OutNewHandles) override;
    MOVIESCENE_API virtual void DeleteKeys(TArrayView<const FKeyHandle> InHandles) override;
    MOVIESCENE_API virtual void DeleteKeysFrom(FFrameNumber InTime, bool bDeleteKeysBefore) override;
    MOVIESCENE_API virtual void RemapTimes(const UE::MovieScene::IRetimingInterface& Retimer) override;
    MOVIESCENE_API virtual TRange<FFrameNumber> ComputeEffectiveRange() const override;
    MOVIESCENE_API virtual int32 GetNumKeys() const override;
    MOVIESCENE_API virtual void Reset() override;
    MOVIESCENE_API virtual void Offset(FFrameNumber DeltaPosition) override;
    MOVIESCENE_API virtual void Optimize(const FKeyDataOptimizationParams& InParameters) override;
    MOVIESCENE_API virtual void ClearDefault() override;
 
public:
 
    inline void SetDefault(uint8 InDefaultValue)
    {
        bHasDefaultValue = true;
        DefaultValue = InDefaultValue;
    }
 
    inline TOptional<uint8> GetDefault() const
    {
        return bHasDefaultValue ? TOptional<uint8>(DefaultValue) : TOptional<uint8>();
    }
 
    inline void RemoveDefault()
    {
        bHasDefaultValue = false;
    }
 
 
public:
 
    UEnum* GetEnum() const
    {
        return Enum;
    }
 
    void SetEnum(UEnum* InEnum)
    {
        Enum = InEnum;
    }
 
public:
    UPROPERTY()
    TEnumAsByte<ERichCurveExtrapolation> PreInfinityExtrap;
 
    UPROPERTY()
    TEnumAsByte<ERichCurveExtrapolation> PostInfinityExtrap;
 
private:
 
    UPROPERTY(meta=(KeyTimes))
    TArray<FFrameNumber> Times;
 
    UPROPERTY()
    uint8 DefaultValue;
 
    UPROPERTY()
    bool bHasDefaultValue;
 
    UPROPERTY(meta=(KeyValues))
    TArray<uint8> Values;
 
    UPROPERTY()
    TObjectPtr<UEnum> Enum;
 
    UPROPERTY(Transient)
    FMovieSceneKeyHandleMap KeyHandles;
};
 
template<>
struct TStructOpsTypeTraits<FMovieSceneByteChannel> : public TStructOpsTypeTraitsBase2<FMovieSceneByteChannel>
{
    enum { WithStructuredSerializeFromMismatchedTag = true };
};
 
template<>
struct TMovieSceneChannelTraits<FMovieSceneByteChannel> : TMovieSceneChannelTraitsBase<FMovieSceneByteChannel>
{
#if WITH_EDITOR
 
    typedef TMovieSceneExternalValue<uint8> ExtendedEditorDataType;
 
#endif
};