VoxelCatalogEditor.h

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
 
#include "editor/EditorAuthority.h"
#include "editor/EditorSelection.h"
#include "editor/EditorTransactionService.h"
#include "editor/EditorWorkspace.h"
#include "voxel/editing/VoxelCatalog.h"
 
#include <cstdint>
#include <string>
#include <vector>
 
namespace eve::voxel_editor {
 
enum class VoxelSculptTool { Attach, Erase };
 
class EVENGINE_API_EDITORS VoxelCatalogEditor {
public:
    explicit VoxelCatalogEditor(std::string targetId);
 
    VoxelCatalogEditor(const VoxelCatalogEditor&)            = delete;
    VoxelCatalogEditor& operator=(const VoxelCatalogEditor&) = delete;
 
    const voxel_editing::VoxelCatalogTarget& target() const noexcept { return target_; }
 
    [[nodiscard]] voxel_editing::Result<void> configureWorkspace(editor::EditorWorkspace& workspace) const;
 
    [[nodiscard]] voxel_editing::Result<void> selectModel(std::string id);
    [[nodiscard]] voxel_editing::Result<void> setTool(std::string tool);
    [[nodiscard]] voxel_editing::Result<void> setViewport(float width, float height);
    [[nodiscard]] voxel_editing::Result<void> orbit(float yawDelta, float pitchDelta);
    [[nodiscard]] voxel_editing::Result<void> pointerDown(float x, float y);
    [[nodiscard]] voxel_editing::Result<void> pointerWorldRay(float ox, float oy, float oz, float dx, float dy,
                                                                    float dz);
    [[nodiscard]] voxel_editing::Result<void> setVoxel(int x, int y, int z, bool occupied);
    [[nodiscard]] voxel_editing::Result<void> setSelectedSocket(std::string tag, std::string kind);
    [[nodiscard]] voxel_editing::Result<void> selectFace(int face);
    [[nodiscard]] voxel_editing::Result<void> createModel(std::string id, std::string name, int sizeX, int sizeY,
                                                                int sizeZ);
    [[nodiscard]] voxel_editing::Result<void> deleteSelectedModel();
 
    [[nodiscard]] voxel_editing::Result<editor::TransactionReceipt> undo();
    [[nodiscard]] voxel_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   selectedId() const { return selectedId_; }
    std::string   toolName() const;
    int           selectedFace() const noexcept { return selectedFace_; }
    float         orbitYaw() const noexcept { return yaw_; }
    float         orbitPitch() const noexcept { return pitch_; }
 
    int         modelCount() const { return static_cast<int>(target_.models().size()); }
    std::string modelId(int index) const;
    std::string modelName(int index) const;
    std::string modelFill(int index) const;
    bool        isModelSelected(int index) const;
 
    int voxelCount() const;
    int voxelX(int index) const;
    int voxelY(int index) const;
    int voxelZ(int index) const;
    int modelSizeX() const;
    int modelSizeY() const;
    int modelSizeZ() const;
 
    int   screenVoxelCount() const { return static_cast<int>(screen_.size()); }
    float screenVoxelX(int index) const;
    float screenVoxelY(int index) const;
    float screenVoxelW(int index) const;
    float screenVoxelH(int index) const;
 
    std::string selectedSocketTag() const;
    std::string selectedSocketKind() const;
    int         joinPartnerCount() const { return static_cast<int>(joinPartners_.size()); }
    std::string joinPartnerId(int index) const;
 
private:
    struct ScreenVoxel {
        float x = 0;
        float y = 0;
        float w = 0;
        float h = 0;
        float depth = 0;
    };
 
    [[nodiscard]] voxel_editing::Result<void> commit(
        voxel_editing::Result<voxel_editing::DomainOperation> operation, std::string label);
    [[nodiscard]] voxel_editing::Result<void> refreshPreview();
    void                                            seedProject();
    void                                            rebuildScreen();
    [[nodiscard]] voxel_editing::Result<void> applyPick(const voxel_editing::VoxelPick& pick);
    void                                            cameraAxes(float& fx, float& fy, float& fz, float& rx, float& ry,
                                                               float& rz, float& ux, float& uy, float& uz) const;
    editor::SelectionSnapshot                       selection() const;
    const voxel_editing::VoxelModelValue* selectedModel() const;
    static const char* fillName(voxel_editing::VoxelCellFill fill);
 
    voxel_editing::VoxelCatalogTarget    target_;
    editor::LocalWorldAuthority          authority_;
    editor::LocalTransactionBackend      transactions_;
    std::vector<ScreenVoxel>             screen_;
    std::vector<voxel_editing::ObjectId> joinPartners_;
    std::string                          selectedId_      = "cube";
    VoxelSculptTool                      tool_            = VoxelSculptTool::Attach;
    int                                  selectedFace_    = 0;
    float                                viewportW_       = 640.0f;
    float                                viewportH_       = 400.0f;
    float                                yaw_             = 0.7f;
    float                                pitch_           = 0.45f;
    float                                distance_        = 18.0f;
    std::uint64_t                        txSequence_      = 0;
    std::uint64_t                        previewRevision_ = 0;
};
 
}  // namespace eve::voxel_editor