Cora at 22:12, 27 June 2012

2012-06-27T22:12:17Z

← Older revision		Revision as of 22:12, 27 June 2012
Line 1:		Line 1:
	[[Category:~~Introduction Pages~~]]		[[Category:Overview]]
	==General Overview==		==General Overview==

Cora at 22:09, 27 June 2012

2012-06-27T22:09:32Z

← Older revision		Revision as of 22:09, 27 June 2012
Line 1:		Line 1:
			[[Category:Introduction Pages]]
	==General Overview==		==General Overview==

Cora: Created page with "==General Overview== The Phidget Manager is a software object that lets you access all of the Phidgets attached to your system. If you want to 'search for all attached Phidg..."

2012-06-20T21:22:28Z

Created page with "==General Overview== The Phidget Manager is a software object that lets you access all of the Phidgets attached to your system. If you want to 'search for all attached Phidg..."

New page

==General Overview==

The Phidget Manager is a software object that lets you access all of the Phidgets attached to your system. If you want to 'search for all attached Phidgets', in your code the Manager is the tool you would use.

==Object Structure==

You are probably already used to Phidget software objects, where a single set of functions for a board - say, an Interface Kit:

[[Image:Manag-singleobject.png|300px|link=|alt=]]

....Is actually embedded into an object that also uses the Phidget Common library to open, close, and delete:

[[Image:Manag-inheritedobject.png|300px|link=|alt=]]

And this common set of functions does not vary from Phidget device to Phidget device:

[[Image:Manag-inheritedobjectII.png|300px|link=|alt=]]

This is '''not''' true for the Manager. The Manager is an object like other Phidget objects, but with a distinct difference - all of its functions are Manager functions:

[[Image:Manag-managerobject.png|300px|link=|alt=]]

For some languages, such as C, this means you do not have to change between a {{Code|Phidget}} type and your specific device type when opening, closing, etc. All manager functions take a Phidget Manager type object.

You can find the API for the Phidget Manager in the API on [[Software Overview#Language Support|the page for your language]].

==Usefulness==

Perhaps the most useful function of the Manager is the {{Code|getAttachedDevices()}} function. This is the tool that returns all attached Phidget devices, as its name implies. The returned devices are returned as an array:

[[Image:Manag-array.png|400px|link=|alt=]]

This works due to the fact that all software objects for Phidget devices are Phidget software objects. So you get a whole array back of Phidget objects, upon which you can use the Phidget Common API - such as getSerialNumber(), or getDeviceName() - to determine what they are and then '''cast''' the array item into the Phidget device that it actually is:

[[Image:Manag-array-expanded.png|600px|link=|alt=]]

This way, you can use the whole API for your device.

When using the Manager expressly for the {{Code|getAttachedDevices()}} function, you must allow time for the PhidgetManager to detect for any Phidgets attached to the system. This can be achieved by allowing the program to wait a short while before attempting to get the attached devices. Another method would be to get the attached devices once the PhidgetManager's attach event triggers.

==Using the Phidget Manager==

As with any other Phidget software object, the Phidget Manager must be [[General Phidget Programming#Opening the Phidget|opened]], then [[General Phidget Programming#Attaching the Phidget|attached]] within your code. These and other concepts are discussed on the [[General Phidget Programming]] page.

We even have a specific section of code snippets on using the Manager, in the [[General Phidget Programming#Using the Manager|Using the Manager section of General Phidget Programming]].

Finally, all of our HelloWorld programming examples - available for most of [[Software Overview#Language Support|the languages we support]] - use the Manager to work with any Phidget.

Phidget Manager - Revision history

Cora at 22:12, 27 June 2012

Cora at 22:09, 27 June 2012

Cora: Created page with "==General Overview== The Phidget Manager is a software object that lets you access all of the Phidgets attached to your system. If you want to 'search for all attached Phidg..."