AvatarDocumentEditor.h

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
#include "avatar/editing/AvatarTarget.h"
#include "editor/EditorAuthority.h"
#include "editor/EditorSelection.h"
#include "editor/EditorTransactionService.h"
#include "editor/EditorWorkspace.h"
 
#include <cstdint>
#include <string>
#include <vector>
 
namespace eve::avatar_editor {
 
class EVENGINE_API_EDITORS AvatarDocumentEditor {
public:
    explicit AvatarDocumentEditor(std::string targetId);
 
    AvatarDocumentEditor(const AvatarDocumentEditor&)            = delete;
    AvatarDocumentEditor& operator=(const AvatarDocumentEditor&) = delete;
 
    const avatar_editing::AvatarDocumentTarget& target() const noexcept { return target_; }
 
    [[nodiscard]] avatar_editing::Result<void> configureWorkspace(editor::EditorWorkspace& workspace) const;
 
    [[nodiscard]] avatar_editing::Result<void> selectLayer(std::string id);
    [[nodiscard]] avatar_editing::Result<void> selectParameter(std::string id);
    [[nodiscard]] avatar_editing::Result<void> selectExpression(std::string id);
    [[nodiscard]] avatar_editing::Result<void> pointerDown(float x, float y);
 
    [[nodiscard]] avatar_editing::Result<void> setLayerVisible(bool visible);
    [[nodiscard]] avatar_editing::Result<void> setLayerZ(int zIndex);
    [[nodiscard]] avatar_editing::Result<void> setParameterValue(double value);
    [[nodiscard]] avatar_editing::Result<void> createLayer(std::string id, std::string name);
    [[nodiscard]] avatar_editing::Result<void> deleteSelectedLayer();
    [[nodiscard]] avatar_editing::Result<void> createParameter(std::string id, std::string name);
    [[nodiscard]] avatar_editing::Result<void> deleteSelectedParameter();
    [[nodiscard]] avatar_editing::Result<void> createExpression(std::string id, std::string name);
    [[nodiscard]] avatar_editing::Result<void> deleteSelectedExpression();
 
    [[nodiscard]] avatar_editing::Result<editor::TransactionReceipt> undo();
    [[nodiscard]] avatar_editing::Result<editor::TransactionReceipt> redo();
 
    bool          canUndo() const noexcept { return transactions_.canUndo(); }
    bool          canRedo() const noexcept { return transactions_.canRedo(); }
    std::uint64_t revision() const noexcept { return target_.revision(); }
    std::uint64_t previewRevision() const noexcept { return previewRevision_; }
    std::string   kind() const { return target_.kind(); }
    std::string   selectedId() const { return selectedId_; }
    std::string   selectedType() const { return selectedType_; }
 
    int         layerCount() const { return static_cast<int>(target_.layers().size()); }
    std::string layerId(int index) const;
    std::string layerName(int index) const;
    bool        layerVisible(int index) const;
    int         layerZ(int index) const;
    bool        isLayerSelected(int index) const;
 
    int         previewLayerCount() const { return static_cast<int>(preview_.size()); }
    float       previewX(int index) const;
    float       previewY(int index) const;
    float       previewW(int index) const;
    float       previewH(int index) const;
    float       previewR(int index) const;
    float       previewG(int index) const;
    float       previewB(int index) const;
    float       previewA(int index) const;
    bool        isPreviewSelected(int index) const;
    std::string previewName(int index) const;
 
    int         parameterCount() const { return static_cast<int>(target_.parameters().size()); }
    std::string parameterId(int index) const;
    std::string parameterName(int index) const;
    float       parameterValue(int index) const;
    float       parameterMinimum(int index) const;
    float       parameterMaximum(int index) const;
    bool        isParameterSelected(int index) const;
 
    int         expressionCount() const { return static_cast<int>(target_.expressions().size()); }
    std::string expressionId(int index) const;
    std::string expressionName(int index) const;
    bool        isExpressionSelected(int index) const;
    int         expressionChannelCount(int index) const;
    std::string expressionChannelName(int expression, int channel) const;
 
private:
    struct PreviewRect {
        std::string id;
        std::string name;
        float       x = 0, y = 0, w = 0, h = 0;
        float       r = 1, g = 1, b = 1, a = 1;
        bool        selected = false;
    };
 
    [[nodiscard]] avatar_editing::Result<void> commit(
        avatar_editing::Result<avatar_editing::DomainOperation> operation, std::string label);
    [[nodiscard]] avatar_editing::Result<void> refreshPreview();
    void                                             seedPreviewDocument();
    editor::SelectionSnapshot                        selection() const;
    const PreviewRect*                               previewAt(int index) const;
    const avatar_editing::AvatarLayerValue*          layerAt(int index) const;
    const avatar_editing::AvatarParameterValue*      parameterAt(int index) const;
    const avatar_editing::AvatarExpressionValue*     expressionAt(int index) const;
    float                                            smileAmount() const;
 
    avatar_editing::AvatarDocumentTarget target_;
    editor::LocalWorldAuthority          authority_;
    editor::LocalTransactionBackend      transactions_;
    std::vector<PreviewRect>             preview_;
    std::string                          selectedId_   = "eyes";
    std::string                          selectedType_ = "avatar.layer";
    std::uint64_t                        txSequence_   = 0;
    std::uint64_t                        previewRevision_ = 0;
};
 
}  // namespace eve::avatar_editor