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