Added jsdoc to TestScriptingInterface.

This commit is contained in:
NissimHadar 2018-05-29 09:45:03 -07:00
parent 658c0e329f
commit 0af1599b53

View file

@ -27,55 +27,96 @@ public slots:
/**jsdoc /**jsdoc
* Exits the application * Exits the application
* @function Test.quit
*/ */
void quit(); void quit();
/**jsdoc /**jsdoc
* Waits for all texture transfers to be complete * Waits for all texture transfers to be complete
* @function Test.waitForTextureIdle
*/ */
void waitForTextureIdle(); void waitForTextureIdle();
/**jsdoc /**jsdoc
* Waits for all pending downloads to be complete * Waits for all pending downloads to be complete
* @function Test.waitForDownloadIdle
*/ */
void waitForDownloadIdle(); void waitForDownloadIdle();
/**jsdoc /**jsdoc
* Waits for all file parsing operations to be complete * Waits for all file parsing operations to be complete
* @function Test.waitForProcessingIdle
*/ */
void waitForProcessingIdle(); void waitForProcessingIdle();
/**jsdoc /**jsdoc
* Waits for all pending downloads, parsing and texture transfers to be complete * Waits for all pending downloads, parsing and texture transfers to be complete
* @function Test.waitIdle
*/ */
void waitIdle(); void waitIdle();
/**jsdoc
* Waits for establishment of connection to server
* @function Test.waitForConnection
*/
bool waitForConnection(qint64 maxWaitMs = 10000); bool waitForConnection(qint64 maxWaitMs = 10000);
/**jsdoc
* Waits a specific number of milliseconds
* @function Test.wait
* @param {int} milliseconds - Number of milliseconds to wait
*/
void wait(int milliseconds); void wait(int milliseconds);
/**jsdoc
* Waits for all pending downloads, parsing and texture transfers to be complete
* @function Test.loadTestScene
* @param {string} sceneFile - URL of scene to load
*/
bool loadTestScene(QString sceneFile); bool loadTestScene(QString sceneFile);
/**jsdoc
* Clears all caches
* @function Test.clear
*/
void clear(); void clear();
/**jsdoc /**jsdoc
* Start recording Chrome compatible tracing events * Start recording Chrome compatible tracing events
* logRules can be used to specify a set of logging category rules to limit what gets captured * logRules can be used to specify a set of logging category rules to limit what gets captured
* @function Test.startTracing
* @param {string} logrules [defaultValue=""] - See implementation for explanation
*/ */
bool startTracing(QString logrules = ""); bool startTracing(QString logrules = "");
/**jsdoc /**jsdoc
* Stop recording Chrome compatible tracing events and serialize recorded events to a file * Stop recording Chrome compatible tracing events and serialize recorded events to a file
* Using a filename with a .gz extension will automatically compress the output file * Using a filename with a .gz extension will automatically compress the output file
* @function Test.stopTracing
* @param {string} filename - Name of file to save to
* @returns {bool} True if successful.
*/ */
bool stopTracing(QString filename); bool stopTracing(QString filename);
/**jsdoc
* Starts a specific trace event
* @function Test.startTraceEvent
* @param {string} name - Name of event
*/
void startTraceEvent(QString name); void startTraceEvent(QString name);
/**jsdoc
* Stop a specific name event
* Using a filename with a .gz extension will automatically compress the output file
* @function Test.endTraceEvent
* @param {string} filename - Name of event
*/
void endTraceEvent(QString name); void endTraceEvent(QString name);
/**jsdoc /**jsdoc
* Write detailed timing stats of next physics stepSimulation() to filename * Write detailed timing stats of next physics stepSimulation() to filename
* @function Test.savePhysicsSimulationStats
* @param {string} filename - Name of file to save to
*/ */
void savePhysicsSimulationStats(QString filename); void savePhysicsSimulationStats(QString filename);
@ -83,16 +124,19 @@ public slots:
/**jsdoc /**jsdoc
* Clear all caches (menu command Reload Content) * Clear all caches (menu command Reload Content)
* @function Test.clearCaches
*/ */
void clearCaches(); void clearCaches();
/**jsdoc /**jsdoc
* Save a JSON object to a file in the test results location * Save a JSON object to a file in the test results location
* @function Test.saveObject
*/ */
void saveObject(QVariant v, const QString& filename); void saveObject(QVariant v, const QString& filename);
/**jsdoc /**jsdoc
* Maximizes the window * Maximizes the window
* @function Test.showMaximized
*/ */
void showMaximized(); void showMaximized();