man SoTranSender () - sends database changes for transcription

NAME

SoTranSender - sends database changes for transcription

INHERITS FROM

SoTranSender

SYNOPSIS

#include <Inventor/misc/SoTranscribe.h> Methods from class SoTranSender: c } c } SoTranSender(SoOutput *output)

c } c } ~SoTranSender()

c } c } getOutput() const

c } c } insert(SoNode *node)

c } c } insert(SoNode *node, SoNode *parent, int n)

c } c } remove(SoNode *parent, int n)

c } c } replace(SoNode *parent, int n, SoNode *newNode)

c } c } modify(SoNode *node)

c } c } prepareToSend()

DESCRIPTION

This class is used for transcribing Inventor data. Transcription is the process of packaging changes to a database and sending them over a "wire" to another database. The SoTranSender class is used on the sending side of transcription. It packages up changes to a Inventor database into a file or memory area defined by an SoOutput instance. It supports a limited set of changes to a database; each change is stored as a command in the transcription area. The SoTranReceiver class can be used at the other end to interpret the transcribed commands.

METHODS

c } c } SoTranSender(SoOutput *output)

The constructor takes a pointer to an SoOutput instance that determines what the transcription area is (file or memory). c } c } ~SoTranSender()

Destructor. c } c } getOutput() const

Returns pointer to current SoOutput instance. c } c } insert(SoNode *node)

Adds an INSERT command to the transcription area. The given node will be added as the last child of the root node on the receiving end. c } c } insert(SoNode *node, SoNode *parent, int n)

Adds an INSERT command to the transcription area. The given node will be added as the nth child of the given parent node on the receiving end. A NULL parent node causes the node to be added to the receiving end's root node. c } c } remove(SoNode *parent, int n)

Adds a REMOVE command to the transcription area. The nth child of the given (non-NULL) parent node on the receiving end will be removed. c } c } replace(SoNode *parent, int n, SoNode *newNode)

Adds a REPLACE command to the transcription area. The nth child of the given (non-NULL) parent node on the receiving end will be replaced with newNode. c } c } modify(SoNode *node)

Adds a MODIFY command to the transcription area. Updates the field data for the given node to the new contents. Note that this changes only field data; children of groups are not affected, nor is any non-field instance data. c } c } prepareToSend()

Prepares a SoTranSender instance for transcription, making sure the transcription area is complete and all packaged to go. This must be called before the transcription can be performed.

SEE ALSO

SoOutput, SoTranReceiver