Loading...
Searching...
No Matches
spatialAudio.h
Go to the documentation of this file.
1//
2// Copyright 2016 Pixar
3//
4// Licensed under the Apache License, Version 2.0 (the "Apache License")
5// with the following modification; you may not use this file except in
6// compliance with the Apache License and the following modification to it:
7// Section 6. Trademarks. is deleted and replaced with:
8//
9// 6. Trademarks. This License does not grant permission to use the trade
10// names, trademarks, service marks, or product names of the Licensor
11// and its affiliates, except as required to comply with Section 4(c) of
12// the License and to reproduce the content of the NOTICE file.
13//
14// You may obtain a copy of the Apache License at
15//
16// http://www.apache.org/licenses/LICENSE-2.0
17//
18// Unless required by applicable law or agreed to in writing, software
19// distributed under the Apache License with the above modification is
20// distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
21// KIND, either express or implied. See the Apache License for the specific
22// language governing permissions and limitations under the Apache License.
23//
24#ifndef USDMEDIA_GENERATED_SPATIALAUDIO_H
25#define USDMEDIA_GENERATED_SPATIALAUDIO_H
26
28
29#include "pxr/pxr.h"
30#include "pxr/usd/usdMedia/api.h"
32#include "pxr/usd/usd/prim.h"
33#include "pxr/usd/usd/stage.h"
35
36#include "pxr/base/vt/value.h"
37
38#include "pxr/base/gf/vec3d.h"
39#include "pxr/base/gf/vec3f.h"
41
42#include "pxr/base/tf/token.h"
43#include "pxr/base/tf/type.h"
44
45PXR_NAMESPACE_OPEN_SCOPE
46
47class SdfAssetPath;
48
49// -------------------------------------------------------------------------- //
50// SPATIALAUDIO //
51// -------------------------------------------------------------------------- //
52
109{
110public:
114 static const UsdSchemaKind schemaKind = UsdSchemaKind::ConcreteTyped;
115
120 explicit UsdMediaSpatialAudio(const UsdPrim& prim=UsdPrim())
121 : UsdGeomXformable(prim)
122 {
123 }
124
128 explicit UsdMediaSpatialAudio(const UsdSchemaBase& schemaObj)
129 : UsdGeomXformable(schemaObj)
130 {
131 }
132
134 USDMEDIA_API
136
140 USDMEDIA_API
141 static const TfTokenVector &
142 GetSchemaAttributeNames(bool includeInherited=true);
143
153 USDMEDIA_API
155 Get(const UsdStagePtr &stage, const SdfPath &path);
156
179 USDMEDIA_API
181 Define(const UsdStagePtr &stage, const SdfPath &path);
182
183protected:
187 USDMEDIA_API
189
190private:
191 // needs to invoke _GetStaticTfType.
192 friend class UsdSchemaRegistry;
193 USDMEDIA_API
194 static const TfType &_GetStaticTfType();
195
196 static bool _IsTypedSchema();
197
198 // override SchemaBase virtuals.
199 USDMEDIA_API
200 const TfType &_GetTfType() const override;
201
202public:
203 // --------------------------------------------------------------------- //
204 // FILEPATH
205 // --------------------------------------------------------------------- //
221 USDMEDIA_API
223
229 USDMEDIA_API
230 UsdAttribute CreateFilePathAttr(VtValue const &defaultValue = VtValue(), bool writeSparsely=false) const;
231
232public:
233 // --------------------------------------------------------------------- //
234 // AURALMODE
235 // --------------------------------------------------------------------- //
255 USDMEDIA_API
257
263 USDMEDIA_API
264 UsdAttribute CreateAuralModeAttr(VtValue const &defaultValue = VtValue(), bool writeSparsely=false) const;
265
266public:
267 // --------------------------------------------------------------------- //
268 // PLAYBACKMODE
269 // --------------------------------------------------------------------- //
296 USDMEDIA_API
298
304 USDMEDIA_API
305 UsdAttribute CreatePlaybackModeAttr(VtValue const &defaultValue = VtValue(), bool writeSparsely=false) const;
306
307public:
308 // --------------------------------------------------------------------- //
309 // STARTTIME
310 // --------------------------------------------------------------------- //
327 USDMEDIA_API
329
335 USDMEDIA_API
336 UsdAttribute CreateStartTimeAttr(VtValue const &defaultValue = VtValue(), bool writeSparsely=false) const;
337
338public:
339 // --------------------------------------------------------------------- //
340 // ENDTIME
341 // --------------------------------------------------------------------- //
361 USDMEDIA_API
363
369 USDMEDIA_API
370 UsdAttribute CreateEndTimeAttr(VtValue const &defaultValue = VtValue(), bool writeSparsely=false) const;
371
372public:
373 // --------------------------------------------------------------------- //
374 // MEDIAOFFSET
375 // --------------------------------------------------------------------- //
390 USDMEDIA_API
392
398 USDMEDIA_API
399 UsdAttribute CreateMediaOffsetAttr(VtValue const &defaultValue = VtValue(), bool writeSparsely=false) const;
400
401public:
402 // --------------------------------------------------------------------- //
403 // GAIN
404 // --------------------------------------------------------------------- //
414 USDMEDIA_API
416
422 USDMEDIA_API
423 UsdAttribute CreateGainAttr(VtValue const &defaultValue = VtValue(), bool writeSparsely=false) const;
424
425public:
426 // ===================================================================== //
427 // Feel free to add custom code below this line, it will be preserved by
428 // the code generator.
429 //
430 // Just remember to:
431 // - Close the class declaration with };
432 // - Close the namespace with PXR_NAMESPACE_CLOSE_SCOPE
433 // - Close the include guard with #endif
434 // ===================================================================== //
435 // --(BEGIN CUSTOM CODE)--
436};
437
438PXR_NAMESPACE_CLOSE_SCOPE
439
440#endif
Contains an asset path and an optional resolved path.
Definition: assetPath.h:47
A path value used to locate objects in layers or scenegraphs.
Definition: path.h:291
TfType represents a dynamic runtime type.
Definition: type.h:65
Scenegraph object for authoring and retrieving numeric, string, and array valued data,...
Definition: attribute.h:176
Base class for all transformable prims, which allows arbitrary sequences of component affine transfor...
Definition: xformable.h:253
The SpatialAudio primitive defines basic properties for encoding playback of an audio file or stream ...
Definition: spatialAudio.h:109
USDMEDIA_API UsdAttribute GetMediaOffsetAttr() const
Expressed in seconds, mediaOffset specifies the offset from the referenced audio file's beginning at ...
static const UsdSchemaKind schemaKind
Compile time constant representing what kind of schema this class is.
Definition: spatialAudio.h:114
USDMEDIA_API UsdSchemaKind _GetSchemaKind() const override
Returns the kind of schema this class belongs to.
USDMEDIA_API UsdAttribute GetAuralModeAttr() const
Determines how audio should be played.
USDMEDIA_API UsdAttribute CreateMediaOffsetAttr(VtValue const &defaultValue=VtValue(), bool writeSparsely=false) const
See GetMediaOffsetAttr(), and also Create vs Get Property Methods for when to use Get vs Create.
static USDMEDIA_API UsdMediaSpatialAudio Get(const UsdStagePtr &stage, const SdfPath &path)
Return a UsdMediaSpatialAudio holding the prim adhering to this schema at path on stage.
static USDMEDIA_API const TfTokenVector & GetSchemaAttributeNames(bool includeInherited=true)
Return a vector of names of all pre-declared attributes for this schema class and all its ancestor cl...
USDMEDIA_API UsdAttribute GetFilePathAttr() const
Path to the audio file.
USDMEDIA_API UsdAttribute GetGainAttr() const
Multiplier on the incoming audio signal.
USDMEDIA_API UsdAttribute GetEndTimeAttr() const
Expressed in the timeCodesPerSecond of the containing stage, endTime specifies when the audio stream ...
USDMEDIA_API UsdAttribute CreateEndTimeAttr(VtValue const &defaultValue=VtValue(), bool writeSparsely=false) const
See GetEndTimeAttr(), and also Create vs Get Property Methods for when to use Get vs Create.
USDMEDIA_API UsdAttribute CreateAuralModeAttr(VtValue const &defaultValue=VtValue(), bool writeSparsely=false) const
See GetAuralModeAttr(), and also Create vs Get Property Methods for when to use Get vs Create.
UsdMediaSpatialAudio(const UsdSchemaBase &schemaObj)
Construct a UsdMediaSpatialAudio on the prim held by schemaObj .
Definition: spatialAudio.h:128
USDMEDIA_API UsdAttribute GetStartTimeAttr() const
Expressed in the timeCodesPerSecond of the containing stage, startTime specifies when the audio strea...
USDMEDIA_API UsdAttribute CreateFilePathAttr(VtValue const &defaultValue=VtValue(), bool writeSparsely=false) const
See GetFilePathAttr(), and also Create vs Get Property Methods for when to use Get vs Create.
UsdMediaSpatialAudio(const UsdPrim &prim=UsdPrim())
Construct a UsdMediaSpatialAudio on UsdPrim prim .
Definition: spatialAudio.h:120
USDMEDIA_API UsdAttribute CreateGainAttr(VtValue const &defaultValue=VtValue(), bool writeSparsely=false) const
See GetGainAttr(), and also Create vs Get Property Methods for when to use Get vs Create.
USDMEDIA_API UsdAttribute CreateStartTimeAttr(VtValue const &defaultValue=VtValue(), bool writeSparsely=false) const
See GetStartTimeAttr(), and also Create vs Get Property Methods for when to use Get vs Create.
USDMEDIA_API UsdAttribute GetPlaybackModeAttr() const
Along with startTime and endTime, determines when the audio playback should start and stop during the...
virtual USDMEDIA_API ~UsdMediaSpatialAudio()
Destructor.
static USDMEDIA_API UsdMediaSpatialAudio Define(const UsdStagePtr &stage, const SdfPath &path)
Attempt to ensure a UsdPrim adhering to this schema at path is defined (according to UsdPrim::IsDefin...
USDMEDIA_API UsdAttribute CreatePlaybackModeAttr(VtValue const &defaultValue=VtValue(), bool writeSparsely=false) const
See GetPlaybackModeAttr(), and also Create vs Get Property Methods for when to use Get vs Create.
UsdPrim is the sole persistent scenegraph object on a UsdStage, and is the embodiment of a "Prim" as ...
Definition: prim.h:134
The base class for all schema types in Usd.
Definition: schemaBase.h:56
Singleton registry that provides access to schema type information and the prim definitions for regis...
Provides a container which may hold any type, and provides introspection and iteration over array typ...
Definition: value.h:165
UsdSchemaKind
An enum representing which kind of schema a given schema class belongs to.
Definition: common.h:129
TfToken class for efficient string referencing and hashing, plus conversions to and from stl string c...
std::vector< TfToken > TfTokenVector
Convenience types.
Definition: token.h:457