cee::pt::VtpDatasetReader

class VtpDatasetReader : public ParticleDatasetReader

ParticleDatasetReader implementation for VTK PolyData XML (.vtp) particle datasets.

See also

ParticleDatasetReader, PtfxDatasetReader, createParticleDatasetReader

Public Functions

VtpDatasetReader()

bool open(const Str &filePath, Error *error = nullptr) override

Opens a VTP dataset from the given file or directory path.

Note

The dataset opens in positions-only mode - no scalar field is auto-activated. After a successful open(), call setActiveScalarField() to enable scalar coloring. The available field names can be queried with header().scalarFieldNames.

bool setActiveScalarField(const Str &fieldName) override

Sets the active scalar field to fieldName.

See also

clearActiveScalarField()

std::vector<Str> framePaths() const

Returns the discovered frame file paths in natural sort order.

std::unique_ptr<MultiScalarFrameData> readMultiScalarFrame(size_t frameIndex, const std::vector<Str> &scalarFieldNames, Error *error = nullptr) const

Reads a single VTP frame at frameIndex with all specified scalar fields in one pass.

Protected Functions

std::unique_ptr<FrameData> readFrame(size_t frameIndex, const Str &activeScalar) override

Reads a single VTP frame at frameIndex and returns it as FrameData.

This method is called without holding mutex(). m_pimpl->m_framePaths is set once in open() and never modified while isReaderOpen() is true.

void resetDerivedState() override

Resets VTP-specific state (called by base class close())