RAM API Reference Utility

Utility

Summary

This page shows some useful class e.g. pick node by clicking, save/load motion data by code, and store camera settings.

table of content

• ramNodeFinder
• ramNodeIdentifer
• ramCameraSettings
• ramTSVCoder

ramNodeFinder

ramNodeFinder searches node(s) from nodearrays managed by ramActorManager.
If you want to manipulate not ramNodeArray but specific nodes, it is more easier than using for-loop. Probably ramNodeFinder is used not in drawActor(), drawRigid() but in draw().

---

ramNodeFinder()

Constructor.

ramNodeFinder nf;
nf1.setTargetName("Yoko");
nf1.setJointID(ramActor::JOINT_HEAD);

---

ramNodeFinder(const ramNodeIdentifer& copy)

Constructor.

ramNodeIdentifer cyril_head("Cyril", ramActor::JOINT_HEAD);
ramNodeFinder nf(cyril_head);

---

void setTargetName(string name_)

Sets target name.

---

void setJointID(int index_)

Sets target joint id.

---

bool ramNodeFinder::findOne(ramNode &node)

Returns true if ramActorManager has ramNodeArray whose name is same to ramNodeFinder::name, and the ramNodeArray has node which has id same to ramNodeFinder::index. If it's true, search result node is set to ramNode &node.

---

vector findAll()

Return all nodes which matches to target name and target joint id.

---

vector findByID()

Return all nodes which matches to target joint id.

---

ramNodeIdentifer

A tiny class to identify node.
Generally it's used for ramNodeFinder.

---

ramNodeIdentifer()

Constructor.

---

ramNodeIdentifer(int index)

Constructor.

---

ramNodeIdentifer(const string &name)

Constructor.

---

ramNodeIdentifer(const string &name, int index)

Constructor.

---

ramNodeIdentifer(const ramNodeIdentifer& copy)

Constructor.

---

ramNodeIdentifer& operator=(const ramNodeIdentifer& copy)

Name and id are copied from right hand side.

---

void set(const string &name, int index)

Sets target name and target id.

---

void set(const string &name)

Sets target name.

---

void set(int index)

Sets target id.

---

void clear()

Clears target name and target id.

---

bool isValid() const

Checks target name and target id are set.

---

friend ostream& operator<<(ostream &os, const ramNodeIdentifer& o)

Puts name and id to stream.

---

ramCameraSettings

ramCameraSettings stores some settings used for control ofCamera.

string name, ofVec3f pos, ofVec3f look_at, float fov, unsigned int moving_type, bool bMoving, ofVec3f moving_from, ofVec3f moving_to, float moving_duration, float moving_start_time, float moving_end_time, ofVec3f moving_axis_pos, ofVec3f moving_axis_up_vector, float moving_radius, float moving_speed, float moving_deg,

Sample XML format is in RAMDanceToolkit/resources/Settings/cam.moving.xml

---

ramCameraSettings(ofxXmlSettings& setting)

Loads one setting from XML

---

static vector loadSettings(ofxXmlSettings& setting)

Loads settings from XML.

---

ramTSVCoder

bool load(const string filePath)

Returns true if load const string filePath succeeded.

#ramCommunicationManager ramCommunicationManager is communication tools with other applications on OSC.

you can check how to details on examples/example-communicationManager

###Setup //communicationManager setup ramCommunicationManager::instance().addSender("localhost", 8000);

###Send for another app //Send from communicationManager ramCommunicationManager::instance().sendCC("rightHand", handPos, 3);

###Receive and use it //Receive from communicationManager

//[Send format]
//Port    : same as the port passed to ramInitialize( ... )
//Address : /ram/communicate/cc
//Args    : string(Instrument name), float(cc value), float(cc value), ...

float scale = 10 + ramCommunicationManager::instance().getCC("someInst", 0) * 50.0;

ofEnableDepthTest();
ramEnableShadow();
ramBeginCamera();

ofDrawBox(0, 100, 0, scale);

ramEndCamera();

#ramOscReceiveTag ramOscReceiveTag is OSC receiver class for each scenes. ###Setup ofxOscReceiveTag receiver;

receiver.addAddress("/Signals");
ramOscManager::instance().addReceiverTag(&receiver);

###Receive while (receiver.hasWaitingMessages()){

	ofxOscMessage m;
	receiver.getNextMessage(&m);

	if (m.getAddress() == "/Signals/bang"){
		cout << "Receive bang" << endl;
	}
	if (m.getAddress() == "/Signals/control"){
		cout << "Control :" << m.getArgAsInt32(0) << endl;
	}
	
}

---

This Document by YCAM InterLab, Yoshito Onishi, Satoru Higa, Motoi Shimizu, and Kyle McDonald is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.