SoTranSender(3IV)

NAME
SoTranSender — sends database changes for transcription

INHERITS FROM
SoTranSender

SYNOPSIS
#include <Inventor/misc/SoTranscribe.h>

Methods from class SoTranSender:

SoTranSender(SoOutput *output)

~SoTranSender()
SoOutput *
getOutput() const
void
insert(SoNode *node)
void
insert(SoNode *node, SoNode *parent, int n)
void
remove(SoNode *parent, int n)
void
replace(SoNode *parent, int n, SoNode *newNode)
void
modify(SoNode *node)
void
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

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

~SoTranSender()
Destructor.

SoOutput *
getOutput() const
Returns pointer to current SoOutput instance.

void
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.

void
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.

void
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.

void
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.

void
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.

void
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