nn::nex::DataSet::SetLocalCorrection Member Function

Syntax

void SetLocalCorrection(
     PHBDRVar_qReal & v,
     qReal dValue,
     qReal dRateOfChange,
     qReal dAcceleration,
     Time tTimestamp = GetTimestamp()
);

void SetLocalCorrection(
     PHBDRVar_qReal & v,
     qReal dValue,
     qReal dRateOfChange,
     qReal dAcceleration,
     Time tTimestamp = GetTimestamp()
);

void SetLocalCorrection(
     PHBDRVar_qInt32 & v,
     qReal dValue,
     qReal dRateOfChange,
     qReal dAcceleration,
     Time tTimestamp = GetTimestamp()
);

Overloaded Member Functions

SetLocalCorrection ( PHBDRVar_qReal &, qReal, qReal, qReal, Time ) Sets a new supplementation model for the duplica on the local station.
SetLocalCorrection ( PHBDRVar_qReal &, qReal, qReal, qReal, Time ) Sets a new supplementation model for the duplica on the local station.
SetLocalCorrection ( PHBDRVar_qInt32 &, qReal, qReal, qReal, Time ) Sets a new supplementation model for the duplica on the local station.

Description of SetLocalCorrection ( PHBDRVar_qReal &, qReal, qReal, qReal, Time )

Note: This function is not provided by the DataSet class. The data definition language (DDL) compiler generates the code for this function only when the dataset in question is indicated as holding an extrapolation_filter property in the DDL declaration.

This function can execute only on an individual duplica. (To verify, use the DuplicatedObject::IsADuplica function.) This function can be used to temporarily correct inaccurate supplemental information. For example, if a ball in a game strikes a wall and bounces off, it may be rendered inside the wall due to inaccurate supplementation of the ball's position caused by network latency. The SetLocalCorrection function can be used to adjust the supplementation model to temporarily apply the effects of collision detection calculation on the individual duplica.

Ignoring update data from the duplication master, the function supplements the data required based on the local supplementation model until the next two update signals have been received from the duplication master. Once two updates from the duplication master have been received, system-based supplementation resumes.

This function may signal the following errors.

SYSTEMERROR_GEN_INVALID_OPERATION is signaled when supplementation is not enabled for this dataset.
SYSTEMERROR_OBJDUP_INVALID_ON_MASTER is signaled when this function is executed on the duplication master. (To verify, use the DuplicatedObject::IsADuplicationMaster function.)

Description of SetLocalCorrection ( PHBDRVar_qReal &, qReal, qReal, qReal, Time )

Note: This function is not provided by the DataSet class. The data definition language (DDL) compiler generates the code for this function only when the dataset in question is indicated as holding an extrapolation_filter property in the DDL declaration.

This function can execute only on an individual duplica. (To verify, use the DuplicatedObject::IsADuplica function.) This function can be used to temporarily correct inaccurate supplemental information. For example, if a ball in a game strikes a wall and bounces off, it may be rendered inside the wall due to inaccurate supplementation of the ball's position caused by network latency. The SetLocalCorrection function can be used to adjust the supplementation model to temporarily apply the effects of collision detection calculation on the individual duplica.

Ignoring update data from the duplication master, the function supplements the data required based on the local supplementation model until the next two update signals have been received from the duplication master. Once two updates from the duplication master have been received, system-based supplementation resumes.

This function may signal the following errors.

SYSTEMERROR_GEN_INVALID_OPERATION is signaled when supplementation is not enabled for this dataset.
SYSTEMERROR_OBJDUP_INVALID_ON_MASTER is signaled when this function is executed on the duplication master. (To verify, use the DuplicatedObject::IsADuplicationMaster function.)

Description of SetLocalCorrection ( PHBDRVar_qInt32 &, qReal, qReal, qReal, Time )

Note: This function is not provided by the DataSet class. The data definition language (DDL) compiler generates the code for this function only when the dataset in question is indicated as holding an extrapolation_filter property in the DDL declaration.

This function can execute only on an individual duplica. (To verify, use the DuplicatedObject::IsADuplica function.) This function can be used to temporarily correct inaccurate supplemental information. For example, if a ball in a game strikes a wall and bounces off, it may be rendered inside the wall due to inaccurate supplementation of the ball's position caused by network latency. The SetLocalCorrection function can be used to adjust the supplementation model to temporarily apply the effects of collision detection calculation on the individual duplica.

Ignoring update data from the duplication master, the function supplements the data required based on the local supplementation model until the next two update signals have been received from the duplication master. Once two updates from the duplication master have been received, system-based supplementation resumes.

This function may signal the following errors.

SYSTEMERROR_GEN_INVALID_OPERATION is signaled when supplementation is not enabled for this dataset.
SYSTEMERROR_OBJDUP_INVALID_ON_MASTER is signaled when this function is executed on the duplication master. (To verify, use the DuplicatedObject::IsADuplicationMaster function.)


CONFIDENTIAL