QcChunkSaveState Class

Member Function Documentation

bool QcChunkSaveState::differsFromGenerated(QcChunkPos pos) const

Returns whether the blocks of the loaded chunk pos differ from what the generator makes (changed while loaded or read from storage).

bool QcChunkSaveState::hasStored(QcChunkPos pos) const

Returns whether the storage holds data of the chunk pos (none without a storage).

bool QcChunkSaveState::isQuarantined(QcChunkPos pos) const

Returns whether the stored data of the chunk pos is damaged.

void QcChunkSaveState::noteArrived(QcChunkPos pos)

The chunk pos entered the world: it differs from the generated one when its stored blocks were read.

void QcChunkSaveState::noteChanged(QcChunkPos pos)

The blocks of the loaded chunk pos changed (a block was set, the chunk was put in as changed).

void QcChunkSaveState::noteKept(const QcChunkIo::Departure &departure)

departure was handed to the storage for a chunk (keeps stored() up to date).

bool QcChunkSaveState::noteLeft(QcChunkPos pos)

The chunk pos left the world. Returns true when its blocks changed since they were last kept and may be kept (not quarantined).

void QcChunkSaveState::noteRegenerated(QcChunkPos pos)

The loaded chunk pos was generated again: its damaged data is given up, and what plays now replaces the stored copy in the next save.

void QcChunkSaveState::quarantine(QcChunkPos pos, const QString &error)

The stored data of the chunk pos cannot be read (error): logged, and the chunk plays as generated.

void QcChunkSaveState::setStorage(QcChunkIo *io, QHash<QcChunkPos, QcChunkSaveState::Stored> catalog)

Reads and writes stored chunks through io (none: chunks are only generated); catalog is what the storage holds. Does not own io.

See also storage().

QcChunkIo *QcChunkSaveState::storage() const

Returns the storage; nullptr when chunks are only generated.

See also setStorage().

std::optional<QcChunkSaveState::Stored> QcChunkSaveState::stored(QcChunkPos pos) const

Returns what the storage holds of the chunk pos, as far as the server knows (kept up to date by noteKept()).

qsizetype QcChunkSaveState::storedChunkCount() const

Returns the number of stored chunks.

QList<QcChunkPos> QcChunkSaveState::storedChunks() const

Returns the stored chunks.

quint16 QcChunkSaveState::storedMarks(QcChunkPos pos) const

Returns the circuit marks of the stored chunk pos (zero for one never stored).

bool QcChunkSaveState::takeChanged(QcChunkPos pos)

Takes the changed mark of the chunk pos that is kept now (a save). Returns false when there is nothing to keep (unchanged or quarantined).

QList<QcChunkPos> QcChunkSaveState::takeNewlyQuarantined()

Returns the chunks found damaged since the last call (the server tells the operators).