This commit is contained in:
milad nazeri 2018-04-23 21:47:53 -07:00
parent e25c871a52
commit 1121fe8da0
17 changed files with 297 additions and 298 deletions

View file

@ -48,10 +48,10 @@ protected:
bool _isMenuSorted; bool _isMenuSorted;
protected slots: protected slots:
/**jsdoc /**jsdoc
* Delete * Delete
* @function AvatarBookmarks.deleteBookmark * @function AvatarBookmarks.deleteBookmark
*/ */
void deleteBookmark(); void deleteBookmark();
private: private:

View file

@ -44,7 +44,7 @@ class LODManager : public QObject, public Dependency {
SINGLETON_DEPENDENCY SINGLETON_DEPENDENCY
public: public:
/**jsdoc /**jsdoc
* @function LODManager.setAutomaticLODAdjust * @function LODManager.setAutomaticLODAdjust
* @param {boolean} value * @param {boolean} value
@ -54,14 +54,14 @@ public:
/**jsdoc /**jsdoc
* @function LODManager.getAutomaticLODAdjust * @function LODManager.getAutomaticLODAdjust
* @returns {boolean} * @returns {boolean}
*/ */
Q_INVOKABLE bool getAutomaticLODAdjust() const { return _automaticLODAdjust; } Q_INVOKABLE bool getAutomaticLODAdjust() const { return _automaticLODAdjust; }
/**jsdoc /**jsdoc
* @function LODManager.setDesktopLODDecreaseFPS * @function LODManager.setDesktopLODDecreaseFPS
* @param {float} value * @param {float} value
*/ */
Q_INVOKABLE void setDesktopLODDecreaseFPS(float value); Q_INVOKABLE void setDesktopLODDecreaseFPS(float value);
@ -125,7 +125,7 @@ public:
/**jsdoc /**jsdoc
* @function LODManager.setBoundaryLevelAdjust * @function LODManager.setBoundaryLevelAdjust
* @param {number} boundaryLevelAdjust * @param {number} boundaryLevelAdjust
*/ */
Q_INVOKABLE void setBoundaryLevelAdjust(int boundaryLevelAdjust); Q_INVOKABLE void setBoundaryLevelAdjust(int boundaryLevelAdjust);
@ -152,8 +152,8 @@ public:
Q_INVOKABLE float getLODIncreaseFPS() const; Q_INVOKABLE float getLODIncreaseFPS() const;
/**jsdoc /**jsdoc
* @namespace LODManager * @namespace LODManager
* @property presentTime {number} * @property presentTime {number}
* @property engineRunTime {number} * @property engineRunTime {number}
* @property gpuTime {number} * @property gpuTime {number}
* @property avgRenderTime {number} * @property avgRenderTime {number}

View file

@ -25,10 +25,10 @@ class AudioScope : public QObject, public Dependency {
Q_OBJECT Q_OBJECT
SINGLETON_DEPENDENCY SINGLETON_DEPENDENCY
/**jsdoc /**jsdoc
* The AudioScope API helps control the Audio Scope features in Interface * The AudioScope API helps control the Audio Scope features in Interface
* @namespace AudioScope * @namespace AudioScope
* @property {int} scopeInput * @property {int} scopeInput
* @property {int} scopeOutputLeft * @property {int} scopeOutputLeft
* @property {int} scopeOutputRight * @property {int} scopeOutputRight
* @property {int} triggerInput * @property {int} triggerInput
@ -52,15 +52,15 @@ public:
public slots: public slots:
/**jsdoc /**jsdoc
* @function AudioScope.toggle * @function AudioScope.toggle
*/ */
void toggle() { setVisible(!_isEnabled); } void toggle() { setVisible(!_isEnabled); }
/**jsdoc /**jsdoc
* @function AudioScope.setVisible * @function AudioScope.setVisible
* @param {boolean} visible * @param {boolean} visible
*/ */
void setVisible(bool visible); void setVisible(bool visible);
@ -68,7 +68,7 @@ public slots:
/**jsdoc /**jsdoc
* @function AudioScope.getVisible * @function AudioScope.getVisible
* @param {boolean} visible * @param {boolean} visible
* @returns {boolean} * @returns {boolean}
*/ */
bool getVisible() const { return _isEnabled; } bool getVisible() const { return _isEnabled; }
@ -88,7 +88,7 @@ public slots:
/**jsdoc /**jsdoc
* @function AudioScope.getPause * @function AudioScope.getPause
* @returns {boolean} * @returns {boolean}
*/ */
bool getPause() { return _isPaused; } bool getPause() { return _isPaused; }
@ -101,14 +101,14 @@ public slots:
/**jsdoc /**jsdoc
* @function AudioScope.getAutoTrigger * @function AudioScope.getAutoTrigger
* @returns {boolean} * @returns {boolean}
*/ */
bool getAutoTrigger() { return _autoTrigger; } bool getAutoTrigger() { return _autoTrigger; }
/**jsdoc /**jsdoc
* @function AudioScope.setAutoTrigger * @function AudioScope.setAutoTrigger
* @param {boolean} autoTrigger * @param {boolean} autoTrigger
*/ */
void setAutoTrigger(bool autoTrigger) { _isTriggered = false; _autoTrigger = autoTrigger; } void setAutoTrigger(bool autoTrigger) { _isTriggered = false; _autoTrigger = autoTrigger; }
@ -169,7 +169,7 @@ public slots:
/**jsdoc /**jsdoc
* @function AudioScope.getScopeInput * @function AudioScope.getScopeInput
* @returns {number} * @returns {number}
*/ */
QVector<int> getScopeInput() { return _scopeInputData; }; QVector<int> getScopeInput() { return _scopeInputData; };
@ -227,7 +227,7 @@ signals:
/**jsdoc /**jsdoc
* @function AudioScope.pauseChanged * @function AudioScope.pauseChanged
* @returns {Signal} * @returns {Signal}
*/ */
void pauseChanged(); void pauseChanged();

View file

@ -117,10 +117,10 @@ public:
std::shared_ptr<MyAvatar> getMyAvatar() { return _myAvatar; } std::shared_ptr<MyAvatar> getMyAvatar() { return _myAvatar; }
glm::vec3 getMyAvatarPosition() const { return _myAvatar->getWorldPosition(); } glm::vec3 getMyAvatarPosition() const { return _myAvatar->getWorldPosition(); }
/**jsdoc /**jsdoc
* @function AvatarManager.getAvatar * @function AvatarManager.getAvatar
* @param {string} avatarID * @param {string} avatarID
* @returns {} * @returns {}
*/ */
// Null/Default-constructed QUuids will return MyAvatar // Null/Default-constructed QUuids will return MyAvatar
@ -207,9 +207,9 @@ public:
Q_INVOKABLE float getAvatarSortCoefficient(const QString& name); Q_INVOKABLE float getAvatarSortCoefficient(const QString& name);
/**jsdoc /**jsdoc
* @function AvatarManager.setAvatarSortCoefficient * @function AvatarManager.setAvatarSortCoefficient
* @param {string} name * @param {string} name
* @param {string} value * @param {string} value
*/ */
Q_INVOKABLE void setAvatarSortCoefficient(const QString& name, const QScriptValue& value); Q_INVOKABLE void setAvatarSortCoefficient(const QString& name, const QScriptValue& value);
@ -218,10 +218,10 @@ public:
public slots: public slots:
/**jsdoc /**jsdoc
* @function AvatarManager.updateAvatarRenderStatus * @function AvatarManager.updateAvatarRenderStatus
* @param {boolean} shouldRenderAvatars * @param {boolean} shouldRenderAvatars
*/ */
void updateAvatarRenderStatus(bool shouldRenderAvatars); void updateAvatarRenderStatus(bool shouldRenderAvatars);

View file

@ -63,9 +63,9 @@ public:
public slots: public slots:
/**jsdoc /**jsdoc
* @function FaceTracker.setEnabled * @function FaceTracker.setEnabled
* @param {boolean} enabled * @param {boolean} enabled
*/ */
void setEnabled(bool enabled) override; void setEnabled(bool enabled) override;

View file

@ -59,10 +59,10 @@ public:
public slots: public slots:
/**jsdoc /**jsdoc
* @function AccountServices.getDownloadInfo * @function AccountServices.getDownloadInfo
* @returns {DownloadInfoResult} * @returns {DownloadInfoResult}
*/ */
DownloadInfoResult getDownloadInfo(); DownloadInfoResult getDownloadInfo();

View file

@ -86,7 +86,7 @@ public:
Q_INVOKABLE void setReverb(bool enable); Q_INVOKABLE void setReverb(bool enable);
/**jsdoc /**jsdoc
* @function Audio.setReverbOptions * @function Audio.setReverbOptions
* @param {} options * @param {} options
*/ */
@ -94,21 +94,20 @@ public:
Q_INVOKABLE void setReverbOptions(const AudioEffectOptions* options); Q_INVOKABLE void setReverbOptions(const AudioEffectOptions* options);
/**jsdoc /**jsdoc
* @function Audio.setReverbOptions * @function Audio.setReverbOptions
* @param {string} filename * @param {string} filename
*/ */
Q_INVOKABLE bool startRecording(const QString& filename); Q_INVOKABLE bool startRecording(const QString& filename);
/**jsdoc /**jsdoc
* @function Audio.stopRecording * @function Audio.stopRecording
*/ */
Q_INVOKABLE void stopRecording(); Q_INVOKABLE void stopRecording();
/**jsdoc /**jsdoc
* To Be Completed * @function Audio.getRecording
* @function Audio.getRecording
*/ */
Q_INVOKABLE bool getRecording(); Q_INVOKABLE bool getRecording();

View file

@ -28,9 +28,9 @@ public:
public slots: public slots:
/**jsdoc /**jsdoc
* @function GooglePoly.setAPIKey * @function GooglePoly.setAPIKey
* @param {string} key * @param {string} key
*/ */
void setAPIKey(const QString& key); void setAPIKey(const QString& key);
@ -40,7 +40,7 @@ public slots:
* @param {string} keyword * @param {string} keyword
* @param {string} category * @param {string} category
* @param {string} format * @param {string} format
* @returns {string} * @returns {string}
*/ */
QString getAssetList(const QString& keyword, const QString& category, const QString& format); QString getAssetList(const QString& keyword, const QString& category, const QString& format);

View file

@ -23,14 +23,14 @@ class AvatarInputs : public QObject {
Q_OBJECT Q_OBJECT
HIFI_QML_DECL HIFI_QML_DECL
/**jsdoc /**jsdoc
* API to help manage your Avatar's input * API to help manage your Avatar's input
* @namespace AvatarInputs * @namespace AvatarInputs
* @param {boolean} cameraEnabled * @param {boolean} cameraEnabled
* @param {boolean} cameraMuted * @param {boolean} cameraMuted
* @param {boolean} isHMD * @param {boolean} isHMD
* @param {boolean} showAudioTools * @param {boolean} showAudioTools
*/ */
AI_PROPERTY(bool, cameraEnabled, false) AI_PROPERTY(bool, cameraEnabled, false)
AI_PROPERTY(bool, cameraMuted, false) AI_PROPERTY(bool, cameraMuted, false)
@ -44,7 +44,7 @@ public:
/**jsdoc /**jsdoc
* @function AvatarInputs.loudnessToAudioLevel * @function AvatarInputs.loudnessToAudioLevel
* @param {number} loudness * @param {number} loudness
* @returns {number} * @returns {number}
*/ */
Q_INVOKABLE float loudnessToAudioLevel(float loudness); Q_INVOKABLE float loudnessToAudioLevel(float loudness);
@ -54,10 +54,10 @@ public:
public slots: public slots:
/**jsdoc /**jsdoc
* @function AvatarInputs.setShowAudioTools * @function AvatarInputs.setShowAudioTools
* @param {boolean} showAudioTools * @param {boolean} showAudioTools
*/ */
void setShowAudioTools(bool showAudioTools); void setShowAudioTools(bool showAudioTools);
@ -65,7 +65,7 @@ signals:
/**jsdoc /**jsdoc
* @function AvatarInputs.cameraEnabledChanged * @function AvatarInputs.cameraEnabledChanged
* @returns {Signal} * @returns {Signal}
*/ */
void cameraEnabledChanged(); void cameraEnabledChanged();
@ -86,7 +86,7 @@ signals:
/**jsdoc /**jsdoc
* @function AvatarInputs.showAudioToolsChanged * @function AvatarInputs.showAudioToolsChanged
* @param {boolean} show * @param {boolean} show
* @returns {Signal} * @returns {Signal}
*/ */

View file

@ -35,7 +35,7 @@ class AnimationCache : public ResourceCache, public Dependency {
SINGLETON_DEPENDENCY SINGLETON_DEPENDENCY
public: public:
// Copied over from ResourceCache (see ResourceCache.h for reason) // Copied over from ResourceCache (see ResourceCache.h for reason)
/**jsdoc /**jsdoc
* @namespace AnimationCache * @namespace AnimationCache
@ -82,7 +82,7 @@ public:
* @function AnimationCache.getResource * @function AnimationCache.getResource
* @returns {Resource} * @returns {Resource}
*/ */
/**jsdoc /**jsdoc
* Prefetches a resource. * Prefetches a resource.
* @param url {string} url of resource to load * @param url {string} url of resource to load

View file

@ -39,47 +39,47 @@ class MixedProcessedAudioStream;
class AudioStreamStatsInterface : public QObject { class AudioStreamStatsInterface : public QObject {
Q_OBJECT Q_OBJECT
/**jsdoc /**jsdoc
* Audio stats from the Audio Mixer * Audio stats from the Audio Mixer
* @namespace AudioStats.mixerStream * @namespace AudioStats.mixerStream
* @param {number} lossRate * @param {number} lossRate
* @param {number} lossCount * @param {number} lossCount
* @param {number} lossRateWindow * @param {number} lossRateWindow
* @param {number} lossCountWindow * @param {number} lossCountWindow
* @param {number} framesDesired * @param {number} framesDesired
* @param {number} framesAvailable * @param {number} framesAvailable
* @param {number} framesAvailableAvg * @param {number} framesAvailableAvg
* @param {number} unplayedMsMax * @param {number} unplayedMsMax
* @param {number} starveCount * @param {number} starveCount
* @param {number} lastStarveDurationCount * @param {number} lastStarveDurationCount
* @param {number} dropCount * @param {number} dropCount
* @param {number} overflowCount * @param {number} overflowCount
* @param {number} timegapMsMax * @param {number} timegapMsMax
* @param {number} timegapMsAvg * @param {number} timegapMsAvg
* @param {number} timegapMsMaxWindow * @param {number} timegapMsMaxWindow
* @param {number} timegapMsAvgWindow * @param {number} timegapMsAvgWindow
*/ */
/**jsdoc /**jsdoc
* Audio stats from the Client Mixer * Audio stats from the Client Mixer
* @namespace AudioStats.clientMixer * @namespace AudioStats.clientMixer
* @param {number} lossRate * @param {number} lossRate
* @param {number} lossCount * @param {number} lossCount
* @param {number} lossRateWindow * @param {number} lossRateWindow
* @param {number} lossCountWindow * @param {number} lossCountWindow
* @param {number} framesDesired * @param {number} framesDesired
* @param {number} framesAvailable * @param {number} framesAvailable
* @param {number} framesAvailableAvg * @param {number} framesAvailableAvg
* @param {number} unplayedMsMax * @param {number} unplayedMsMax
* @param {number} starveCount * @param {number} starveCount
* @param {number} lastStarveDurationCount * @param {number} lastStarveDurationCount
* @param {number} dropCount * @param {number} dropCount
* @param {number} overflowCount * @param {number} overflowCount
* @param {number} timegapMsMax * @param {number} timegapMsMax
* @param {number} timegapMsAvg * @param {number} timegapMsAvg
* @param {number} timegapMsMaxWindow * @param {number} timegapMsMaxWindow
* @param {number} timegapMsAvgWindow * @param {number} timegapMsAvgWindow
*/ */
AUDIO_PROPERTY(float, lossRate) AUDIO_PROPERTY(float, lossRate)
AUDIO_PROPERTY(float, lossCount) AUDIO_PROPERTY(float, lossCount)
@ -112,18 +112,18 @@ private:
class AudioStatsInterface : public QObject { class AudioStatsInterface : public QObject {
Q_OBJECT Q_OBJECT
/**jsdoc /**jsdoc
* Audio stats from the client * Audio stats from the client
* @namespace AudioStats * @namespace AudioStats
* @param {number} pingMs * @param {number} pingMs
* @param {number} inputReadMsMax * @param {number} inputReadMsMax
* @param {number} inputUnplayedMsMax * @param {number} inputUnplayedMsMax
* @param {number} outputUnplayedMsMax * @param {number} outputUnplayedMsMax
* @param {number} sentTimegapMsMax * @param {number} sentTimegapMsMax
* @param {number} sentTimegapMsAvg * @param {number} sentTimegapMsAvg
* @param {number} sentTimegapMsMaxWindow * @param {number} sentTimegapMsMaxWindow
* @param {number} sentTimegapMsAvgWindow * @param {number} sentTimegapMsAvgWindow
*/ */
AUDIO_PROPERTY(float, pingMs); AUDIO_PROPERTY(float, pingMs);
@ -155,24 +155,24 @@ public:
signals: signals:
/**jsdoc /**jsdoc
* @function AudioStats.mixerStreamChanged * @function AudioStats.mixerStreamChanged
* @returns {Signal} * @returns {Signal}
*/ */
void mixerStreamChanged(); void mixerStreamChanged();
/**jsdoc /**jsdoc
* @function AudioStats.clientStreamChanged * @function AudioStats.clientStreamChanged
* @returns {Signal} * @returns {Signal}
*/ */
void clientStreamChanged(); void clientStreamChanged();
/**jsdoc /**jsdoc
* @function AudioStats.injectorStreamsChanged * @function AudioStats.injectorStreamsChanged
* @returns {Signal} * @returns {Signal}
*/ */
void injectorStreamsChanged(); void injectorStreamsChanged();

View file

@ -28,85 +28,85 @@ class SoundCache : public ResourceCache, public Dependency {
SINGLETON_DEPENDENCY SINGLETON_DEPENDENCY
public: public:
// Copied over from ResourceCache (see ResourceCache.h for reason) // Copied over from ResourceCache (see ResourceCache.h for reason)
/**jsdoc /**jsdoc
* @namespace SoundCache * @namespace SoundCache
* @property numTotal {number} total number of total resources * @property numTotal {number} total number of total resources
* @property numCached {number} total number of cached resource * @property numCached {number} total number of cached resource
* @property sizeTotal {number} size in bytes of all resources * @property sizeTotal {number} size in bytes of all resources
* @property sizeCached {number} size in bytes of all cached resources * @property sizeCached {number} size in bytes of all cached resources
*/ */
/**jsdoc /**jsdoc
* Returns the total number of resources * Returns the total number of resources
* @function SoundCache.getNumTotalResources * @function SoundCache.getNumTotalResources
* @returns {number} * @returns {number}
*/ */
/**jsdoc /**jsdoc
* Returns the total size in bytes of all resources * Returns the total size in bytes of all resources
* @function SoundCache.getSizeTotalResources * @function SoundCache.getSizeTotalResources
* @returns {number} * @returns {number}
*/ */
/**jsdoc /**jsdoc
* Returns the total number of cached resources * Returns the total number of cached resources
* @function SoundCache.getNumCachedResources * @function SoundCache.getNumCachedResources
* @returns {number} * @returns {number}
*/ */
/**jsdoc /**jsdoc
* Returns the total size in bytes of cached resources * Returns the total size in bytes of cached resources
* @function SoundCache.getSizeCachedResources * @function SoundCache.getSizeCachedResources
* @returns {number} * @returns {number}
*/ */
/**jsdoc /**jsdoc
* Returns list of all resource urls * Returns list of all resource urls
* @function SoundCache.getResourceList * @function SoundCache.getResourceList
* @returns {string[]} * @returns {string[]}
*/ */
/**jsdoc /**jsdoc
* Returns animation resource for particular animation * Returns animation resource for particular animation
* @function SoundCache.getAnimation * @function SoundCache.getAnimation
* @param url {string} url to load * @param url {string} url to load
* @returns {Resource} animation * @returns {Resource} animation
*/ */
/**jsdoc /**jsdoc
* Asynchronously loads a resource from the spedified URL and returns it. * Asynchronously loads a resource from the spedified URL and returns it.
* @param url {string} url of resource to load * @param url {string} url of resource to load
* @param fallback {string} fallback URL if load of the desired url fails * @param fallback {string} fallback URL if load of the desired url fails
* @function SoundCache.getResource * @function SoundCache.getResource
* @returns {Resource} * @returns {Resource}
*/ */
/**jsdoc /**jsdoc
* Prefetches a resource. * Prefetches a resource.
* @param url {string} url of resource to load * @param url {string} url of resource to load
* @function SoundCache.prefetch * @function SoundCache.prefetch
* @returns {Resource} * @returns {Resource}
*/ */
/**jsdoc /**jsdoc
* To Be Completed * To Be Completed
* @param {number} deltaSize * @param {number} deltaSize
* @function SoundCache.updateTotalSize * @function SoundCache.updateTotalSize
* @returns {Resource} * @returns {Resource}
*/ */
/**jsdoc /**jsdoc
* @function SoundCache.dirty * @function SoundCache.dirty
* @returns {Signal} * @returns {Signal}
*/ */
/**jsdoc /**jsdoc
* @function SoundCache.getSound * @function SoundCache.getSound
* @param {string} url * @param {string} url
* @returns {} * @returns {}
*/ */
Q_INVOKABLE SharedSoundPointer getSound(const QUrl& url); Q_INVOKABLE SharedSoundPointer getSound(const QUrl& url);
protected: protected:

View file

@ -49,18 +49,18 @@ public:
int size() { return _avatarHash.size(); } int size() { return _avatarHash.size(); }
// Currently, your own avatar will be included as the null avatar id. // Currently, your own avatar will be included as the null avatar id.
/**jsdoc /**jsdoc
* @function AvatarHashMap.getAvatarIdentifiers * @function AvatarHashMap.getAvatarIdentifiers
*/ */
Q_INVOKABLE QVector<QUuid> getAvatarIdentifiers(); Q_INVOKABLE QVector<QUuid> getAvatarIdentifiers();
/**jsdoc /**jsdoc
* @function AvatarHashMap.getAvatarsInRange * @function AvatarHashMap.getAvatarsInRange
* @param {Vec3} position * @param {Vec3} position
* @param {float} rangeMeters * @param {float} rangeMeters
* @returns {string[]} * @returns {string[]}
*/ */
Q_INVOKABLE QVector<QUuid> getAvatarsInRange(const glm::vec3& position, float rangeMeters) const; Q_INVOKABLE QVector<QUuid> getAvatarsInRange(const glm::vec3& position, float rangeMeters) const;
@ -68,7 +68,7 @@ public:
/**jsdoc /**jsdoc
* @function AvatarHashMap.getAvatar * @function AvatarHashMap.getAvatar
* @param {string} avatarID * @param {string} avatarID
* @returns {ScriptAvatarData} * @returns {ScriptAvatarData}
*/ */
// Null/Default-constructed QUuids will return MyAvatar // Null/Default-constructed QUuids will return MyAvatar
@ -82,7 +82,7 @@ signals:
/**jsdoc /**jsdoc
* @function AvatarHashMap.avatarAddedEvent * @function AvatarHashMap.avatarAddedEvent
* @param {string} sessionUUID * @param {string} sessionUUID
* @returns {Signal} * @returns {Signal}
*/ */
void avatarAddedEvent(const QUuid& sessionUUID); void avatarAddedEvent(const QUuid& sessionUUID);
@ -117,11 +117,11 @@ public slots:
protected slots: protected slots:
/**jsdoc /**jsdoc
* @function AvatarHashMap.sessionUUIDChanged * @function AvatarHashMap.sessionUUIDChanged
* @param {string} sessionUUID * @param {string} sessionUUID
* @param {string} oldUUID * @param {string} oldUUID
*/ */
void sessionUUIDChanged(const QUuid& sessionUUID, const QUuid& oldUUID); void sessionUUIDChanged(const QUuid& sessionUUID, const QUuid& oldUUID);

View file

@ -258,9 +258,9 @@ public:
static const int DEFAULT_SPECTATOR_CAM_HEIGHT { 1024 }; static const int DEFAULT_SPECTATOR_CAM_HEIGHT { 1024 };
signals: signals:
/**jsdoc /**jsdoc
* @function TextureCache.spectatorCameraFramebufferReset * @function TextureCache.spectatorCameraFramebufferReset
* @returns {Signal} * @returns {Signal}
*/ */
void spectatorCameraFramebufferReset(); void spectatorCameraFramebufferReset();

View file

@ -139,20 +139,20 @@ public:
signals: signals:
/**jsdoc /**jsdoc
* Signaled when download progress for this resource has changed * Signaled when download progress for this resource has changed
* @function Resource#progressChanged * @function Resource#progressChanged
* @param bytesReceived {int} bytes downloaded so far * @param bytesReceived {int} bytes downloaded so far
* @param bytesTotal {int} total number of bytes in the resource * @param bytesTotal {int} total number of bytes in the resource
* @returns {Signal} * @returns {Signal}
*/ */
void progressChanged(uint64_t bytesReceived, uint64_t bytesTotal); void progressChanged(uint64_t bytesReceived, uint64_t bytesTotal);
/**jsdoc /**jsdoc
* Signaled when resource loading state has changed * Signaled when resource loading state has changed
* @function Resource#stateChanged * @function Resource#stateChanged
* @param bytesReceived {Resource.State} new state * @param bytesReceived {Resource.State} new state
* @returns {Signal} * @returns {Signal}
*/ */
void stateChanged(int state); void stateChanged(int state);
protected: protected:
@ -188,11 +188,11 @@ class ResourceCache : public QObject {
// JSDoc 3.5.5 doesn't augment @property definitions. // JSDoc 3.5.5 doesn't augment @property definitions.
// These functions are being copied into the different exposed cache classes // These functions are being copied into the different exposed cache classes
/**jsdoc /**jsdoc
* @namespace ResourceCache * @namespace ResourceCache
* @property numTotal {number} total number of total resources * @property numTotal {number} total number of total resources
* @property numCached {number} total number of cached resource * @property numCached {number} total number of cached resource
* @property sizeTotal {number} size in bytes of all resources * @property sizeTotal {number} size in bytes of all resources
* @property sizeCached {number} size in bytes of all cached resources * @property sizeCached {number} size in bytes of all cached resources
*/ */
Q_PROPERTY(size_t numTotal READ getNumTotalResources NOTIFY dirty) Q_PROPERTY(size_t numTotal READ getNumTotalResources NOTIFY dirty)
Q_PROPERTY(size_t numCached READ getNumCachedResources NOTIFY dirty) Q_PROPERTY(size_t numCached READ getNumCachedResources NOTIFY dirty)
@ -201,38 +201,38 @@ class ResourceCache : public QObject {
public: public:
/**jsdoc /**jsdoc
* Returns the total number of resources * Returns the total number of resources
* @function ResourceCache.getNumTotalResources * @function ResourceCache.getNumTotalResources
* @return {number} * @return {number}
*/ */
size_t getNumTotalResources() const { return _numTotalResources; } size_t getNumTotalResources() const { return _numTotalResources; }
/**jsdoc /**jsdoc
* Returns the total size in bytes of all resources * Returns the total size in bytes of all resources
* @function ResourceCache.getSizeTotalResources * @function ResourceCache.getSizeTotalResources
* @return {number} * @return {number}
*/ */
size_t getSizeTotalResources() const { return _totalResourcesSize; } size_t getSizeTotalResources() const { return _totalResourcesSize; }
/**jsdoc /**jsdoc
* Returns the total number of cached resources * Returns the total number of cached resources
* @function ResourceCache.getNumCachedResources * @function ResourceCache.getNumCachedResources
* @return {number} * @return {number}
*/ */
size_t getNumCachedResources() const { return _numUnusedResources; } size_t getNumCachedResources() const { return _numUnusedResources; }
/**jsdoc /**jsdoc
* Returns the total size in bytes of cached resources * Returns the total size in bytes of cached resources
* @function ResourceCache.getSizeCachedResources * @function ResourceCache.getSizeCachedResources
* @return {number} * @return {number}
*/ */
size_t getSizeCachedResources() const { return _unusedResourcesSize; } size_t getSizeCachedResources() const { return _unusedResourcesSize; }
/**jsdoc /**jsdoc
* Returns list of all resource urls * Returns list of all resource urls
* @function ResourceCache.getResourceList * @function ResourceCache.getResourceList
* @return {string[]} * @return {string[]}
*/ */
Q_INVOKABLE QVariantList getResourceList(); Q_INVOKABLE QVariantList getResourceList();
static void setRequestLimit(int limit); static void setRequestLimit(int limit);
@ -273,12 +273,12 @@ protected slots:
/// \param fallback a fallback URL to load if the desired one is unavailable /// \param fallback a fallback URL to load if the desired one is unavailable
/// \param extra extra data to pass to the creator, if appropriate /// \param extra extra data to pass to the creator, if appropriate
/**jsdoc /**jsdoc
* Asynchronously loads a resource from the spedified URL and returns it. * Asynchronously loads a resource from the spedified URL and returns it.
* @param url {string} url of resource to load * @param url {string} url of resource to load
* @param fallback {string} fallback URL if load of the desired url fails * @param fallback {string} fallback URL if load of the desired url fails
* @function ResourceCache.getResource * @function ResourceCache.getResource
* @return {Resource} * @return {Resource}
*/ */
QSharedPointer<Resource> getResource(const QUrl& url, const QUrl& fallback = QUrl(), QSharedPointer<Resource> getResource(const QUrl& url, const QUrl& fallback = QUrl(),
void* extra = NULL); void* extra = NULL);
@ -291,11 +291,11 @@ protected:
// which should be a QScriptEngine with ScriptableResource registered, so that // which should be a QScriptEngine with ScriptableResource registered, so that
// the QScriptEngine will delete the pointer when it is garbage collected. // the QScriptEngine will delete the pointer when it is garbage collected.
/**jsdoc /**jsdoc
* Prefetches a resource. * Prefetches a resource.
* @param url {string} url of resource to load * @param url {string} url of resource to load
* @function ResourceCache.prefetch * @function ResourceCache.prefetch
* @return {Resource} * @return {Resource}
*/ */
Q_INVOKABLE ScriptableResource* prefetch(const QUrl& url) { return prefetch(url, nullptr); } Q_INVOKABLE ScriptableResource* prefetch(const QUrl& url) { return prefetch(url, nullptr); }
/// Creates a new resource. /// Creates a new resource.

View file

@ -118,40 +118,40 @@ public:
Q_INVOKABLE void sendFakedHandshake(); Q_INVOKABLE void sendFakedHandshake();
#endif #endif
/**jsdoc /**jsdoc
* Request Asset data from the ATP Server * Request Asset data from the ATP Server
* @function Assets.getAsset * @function Assets.getAsset
* @param {URL|Assets.GetOptions} options An atp: style URL, hash, or relative mapped path; or an {@link Assets.GetOptions} object with request parameters * @param {URL|Assets.GetOptions} options An atp: style URL, hash, or relative mapped path; or an {@link Assets.GetOptions} object with request parameters
* @param {Assets~getAssetCallback} scope[callback] A scope callback function to receive (error, results) values * @param {Assets~getAssetCallback} scope[callback] A scope callback function to receive (error, results) values
*/ */
/**jsdoc /**jsdoc
* A set of properties that can be passed to {@link Assets.getAsset}. * A set of properties that can be passed to {@link Assets.getAsset}.
* @typedef {Object} Assets.GetOptions * @typedef {Object} Assets.GetOptions
* @property {URL} [url] an "atp:" style URL, hash, or relative mapped path to fetch * @property {URL} [url] an "atp:" style URL, hash, or relative mapped path to fetch
* @property {string} [responseType=text] the desired reponse type (text | arraybuffer | json) * @property {string} [responseType=text] the desired reponse type (text | arraybuffer | json)
* @property {boolean} [decompress=false] whether to attempt gunzip decompression on the fetched data * @property {boolean} [decompress=false] whether to attempt gunzip decompression on the fetched data
* See: {@link Assets.putAsset} and its .compress=true option * See: {@link Assets.putAsset} and its .compress=true option
*/ */
/**jsdoc /**jsdoc
* Called when Assets.getAsset is complete. * Called when Assets.getAsset is complete.
* @callback Assets~getAssetCallback * @callback Assets~getAssetCallback
* @param {string} error - contains error message or null value if no error occured fetching the asset * @param {string} error - contains error message or null value if no error occured fetching the asset
* @param {Asset~getAssetResult} result - result object containing, on success containing asset metadata and contents * @param {Asset~getAssetResult} result - result object containing, on success containing asset metadata and contents
*/ */
/**jsdoc /**jsdoc
* Result value returned by {@link Assets.getAsset}. * Result value returned by {@link Assets.getAsset}.
* @typedef {Object} Assets~getAssetResult * @typedef {Object} Assets~getAssetResult
* @property {url} [url] the resolved "atp:" style URL for the fetched asset * @property {url} [url] the resolved "atp:" style URL for the fetched asset
* @property {string} [hash] the resolved hash for the fetched asset * @property {string} [hash] the resolved hash for the fetched asset
* @property {string|ArrayBuffer|Object} [response] response data (possibly converted per .responseType value) * @property {string|ArrayBuffer|Object} [response] response data (possibly converted per .responseType value)
* @property {string} [responseType] response type (text | arraybuffer | json) * @property {string} [responseType] response type (text | arraybuffer | json)
* @property {string} [contentType] detected asset mime-type (autodetected) * @property {string} [contentType] detected asset mime-type (autodetected)
* @property {number} [byteLength] response data size in bytes * @property {number} [byteLength] response data size in bytes
* @property {number} [decompressed] flag indicating whether data was decompressed * @property {number} [decompressed] flag indicating whether data was decompressed
*/ */
Q_INVOKABLE void getAsset(QScriptValue options, QScriptValue scope, QScriptValue callback = QScriptValue()); Q_INVOKABLE void getAsset(QScriptValue options, QScriptValue scope, QScriptValue callback = QScriptValue());
@ -162,13 +162,13 @@ public:
* @param {Assets~putAssetCallback} scope[callback] A scoped callback function invoked with (error, results) * @param {Assets~putAssetCallback} scope[callback] A scoped callback function invoked with (error, results)
*/ */
/**jsdoc /**jsdoc
* A set of properties that can be passed to {@link Assets.putAsset}. * A set of properties that can be passed to {@link Assets.putAsset}.
* @typedef {Object} Assets.PutOptions * @typedef {Object} Assets.PutOptions
* @property {ArrayBuffer|string} [data] byte buffer or string value representing the new asset's content * @property {ArrayBuffer|string} [data] byte buffer or string value representing the new asset's content
* @property {string} [path=null] ATP path mapping to automatically create (upon successful upload to hash) * @property {string} [path=null] ATP path mapping to automatically create (upon successful upload to hash)
* @property {boolean} [compress=false] whether to gzip compress data before uploading * @property {boolean} [compress=false] whether to gzip compress data before uploading
*/ */
/**jsdoc /**jsdoc
* Called when Assets.putAsset is complete. * Called when Assets.putAsset is complete.

View file

@ -61,9 +61,9 @@ public:
signals: signals:
/**jsdoc /**jsdoc
* @function FaceTracker.muteToggled * @function FaceTracker.muteToggled
* @returns {Signal} * @returns {Signal}
*/ */
void muteToggled(); void muteToggled();
@ -75,17 +75,17 @@ public slots:
*/ */
virtual void setEnabled(bool enabled) = 0; virtual void setEnabled(bool enabled) = 0;
/**jsdoc /**jsdoc
* @function FaceTracker.toggleMute * @function FaceTracker.toggleMute
*/ */
void toggleMute(); void toggleMute();
/**jsdoc /**jsdoc
* @function FaceTracker.getMuted * @function FaceTracker.getMuted
* @returns {boolean} * @returns {boolean}
*/ */
bool getMuted() { return _isMuted; } bool getMuted() { return _isMuted; }