accessibilityAPI.h
Go to the documentation of this file.
1 //
2 // Copyright 2016 Pixar
3 //
4 // Licensed under the terms set forth in the LICENSE.txt file available at
5 // https://openusd.org/license.
6 //
7 #ifndef USDUI_GENERATED_ACCESSIBILITYAPI_H
8 #define USDUI_GENERATED_ACCESSIBILITYAPI_H
9 
11 
12 #include "pxr/pxr.h"
13 #include "pxr/usd/usdUI/api.h"
15 #include "pxr/usd/usd/prim.h"
16 #include "pxr/usd/usd/stage.h"
17 #include "pxr/usd/usdUI/tokens.h"
18 
19 #include "pxr/base/vt/value.h"
20 
21 #include "pxr/base/gf/vec3d.h"
22 #include "pxr/base/gf/vec3f.h"
23 #include "pxr/base/gf/matrix4d.h"
24 
25 #include "pxr/base/tf/token.h"
26 #include "pxr/base/tf/type.h"
27 
28 PXR_NAMESPACE_OPEN_SCOPE
29 
30 class SdfAssetPath;
31 
32 // -------------------------------------------------------------------------- //
33 // ACCESSIBILITYAPI //
34 // -------------------------------------------------------------------------- //
35 
84 {
85 public:
90 
101  const UsdPrim& prim=UsdPrim(), const TfToken &name=TfToken())
102  : UsdAPISchemaBase(prim, /*instanceName*/ name)
103  { }
104 
110  const UsdSchemaBase& schemaObj, const TfToken &name)
111  : UsdAPISchemaBase(schemaObj, /*instanceName*/ name)
112  { }
113 
115  USDUI_API
116  virtual ~UsdUIAccessibilityAPI();
117 
121  USDUI_API
122  static const TfTokenVector &
123  GetSchemaAttributeNames(bool includeInherited=true);
124 
130  USDUI_API
131  static TfTokenVector
132  GetSchemaAttributeNames(bool includeInherited, const TfToken &instanceName);
133 
135  TfToken GetName() const {
136  return _GetInstanceName();
137  }
138 
153  USDUI_API
154  static UsdUIAccessibilityAPI
155  Get(const UsdStagePtr &stage, const SdfPath &path);
156 
159  USDUI_API
160  static UsdUIAccessibilityAPI
161  Get(const UsdPrim &prim, const TfToken &name);
162 
165  USDUI_API
166  static std::vector<UsdUIAccessibilityAPI>
167  GetAll(const UsdPrim &prim);
168 
171  USDUI_API
172  static bool
173  IsSchemaPropertyBaseName(const TfToken &baseName);
174 
178  USDUI_API
179  static bool
180  IsAccessibilityAPIPath(const SdfPath &path, TfToken *name);
181 
198  USDUI_API
199  static bool
200  CanApply(const UsdPrim &prim, const TfToken &name,
201  std::string *whyNot=nullptr);
202 
222  USDUI_API
223  static UsdUIAccessibilityAPI
224  Apply(const UsdPrim &prim, const TfToken &name);
225 
226 protected:
230  USDUI_API
231  UsdSchemaKind _GetSchemaKind() const override;
232 
233 private:
234  // needs to invoke _GetStaticTfType.
235  friend class UsdSchemaRegistry;
236  USDUI_API
237  static const TfType &_GetStaticTfType();
238 
239  static bool _IsTypedSchema();
240 
241  // override SchemaBase virtuals.
242  USDUI_API
243  const TfType &_GetTfType() const override;
244 
245 public:
246  // --------------------------------------------------------------------- //
247  // LABEL
248  // --------------------------------------------------------------------- //
261  USDUI_API
262  UsdAttribute GetLabelAttr() const;
263 
269  USDUI_API
270  UsdAttribute CreateLabelAttr(VtValue const &defaultValue = VtValue(), bool writeSparsely=false) const;
271 
272 public:
273  // --------------------------------------------------------------------- //
274  // DESCRIPTION
275  // --------------------------------------------------------------------- //
291  USDUI_API
293 
299  USDUI_API
300  UsdAttribute CreateDescriptionAttr(VtValue const &defaultValue = VtValue(), bool writeSparsely=false) const;
301 
302 public:
303  // --------------------------------------------------------------------- //
304  // PRIORITY
305  // --------------------------------------------------------------------- //
320  USDUI_API
322 
328  USDUI_API
329  UsdAttribute CreatePriorityAttr(VtValue const &defaultValue = VtValue(), bool writeSparsely=false) const;
330 
331 public:
332  // ===================================================================== //
333  // Feel free to add custom code below this line, it will be preserved by
334  // the code generator.
335  //
336  // Just remember to:
337  // - Close the class declaration with };
338  // - Close the namespace with PXR_NAMESPACE_CLOSE_SCOPE
339  // - Close the include guard with #endif
340  // ===================================================================== //
341  // --(BEGIN CUSTOM CODE)--
342 
345  USDUI_API
346  static UsdUIAccessibilityAPI CreateDefaultAPI(const UsdPrim& prim);
347 
350  USDUI_API
351  static UsdUIAccessibilityAPI CreateDefaultAPI(const UsdSchemaBase& schemaObj);
352 
355  USDUI_API
356  static UsdUIAccessibilityAPI ApplyDefaultAPI(const UsdPrim& prim);
357 };
358 
359 PXR_NAMESPACE_CLOSE_SCOPE
360 
361 #endif
static USDUI_API std::vector< UsdUIAccessibilityAPI > GetAll(const UsdPrim &prim)
Return a vector of all named instances of UsdUIAccessibilityAPI on the given prim.
USDUI_API UsdAttribute CreateDescriptionAttr(VtValue const &defaultValue=VtValue(), bool writeSparsely=false) const
See GetDescriptionAttr(), and also Create vs Get Property Methods for when to use Get vs Create.
static USDUI_API UsdUIAccessibilityAPI Get(const UsdStagePtr &stage, const SdfPath &path)
Return a UsdUIAccessibilityAPI holding the prim adhering to this schema at path on stage.
This API describes Accessibility information on a Prim that may be surfaced to a given runtime's acce...
USDUI_API UsdSchemaKind _GetSchemaKind() const override
Returns the kind of schema this class belongs to.
static USDUI_API bool IsSchemaPropertyBaseName(const TfToken &baseName)
Checks if the given name baseName is the base name of a property of AccessibilityAPI.
The base class for all API schemas.
Definition: apiSchemaBase.h:94
Scenegraph object for authoring and retrieving numeric, string, and array valued data,...
Definition: attribute.h:183
UsdSchemaKind
An enum representing which kind of schema a given schema class belongs to.
Definition: common.h:112
static USDUI_API UsdUIAccessibilityAPI Apply(const UsdPrim &prim, const TfToken &name)
Applies this multiple-apply API schema to the given prim along with the given instance name,...
Token for efficient comparison, assignment, and hashing of known strings.
Definition: token.h:80
static USDUI_API UsdUIAccessibilityAPI CreateDefaultAPI(const UsdPrim &prim)
Creates an instance of the API with the default instance name.
virtual USDUI_API ~UsdUIAccessibilityAPI()
Destructor.
USDUI_API UsdAttribute CreatePriorityAttr(VtValue const &defaultValue=VtValue(), bool writeSparsely=false) const
See GetPriorityAttr(), 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:116
std::vector< TfToken > TfTokenVector
Convenience types.
Definition: token.h:489
USDUI_API UsdAttribute GetPriorityAttr() const
A hint to the accessibility runtime of how to prioritize this instance's label and description,...
A path value used to locate objects in layers or scenegraphs.
Definition: path.h:280
static const UsdSchemaKind schemaKind
Compile time constant representing what kind of schema this class is.
USDUI_API UsdAttribute GetDescriptionAttr() const
An extended description of the prim to provide more details.
Contains an asset path and optional evaluated and resolved paths.
Definition: assetPath.h:78
Multiple Apply API Schema.
TfToken GetName() const
Returns the name of this multiple-apply schema instance.
USDUI_API UsdAttribute GetLabelAttr() const
A short label to concisely describe the prim.
static USDUI_API bool CanApply(const UsdPrim &prim, const TfToken &name, std::string *whyNot=nullptr)
Returns true if this multiple-apply API schema can be applied, with the given instance name,...
TfType represents a dynamic runtime type.
Definition: type.h:47
Singleton registry that provides access to schema type information and the prim definitions for regis...
UsdUIAccessibilityAPI(const UsdPrim &prim=UsdPrim(), const TfToken &name=TfToken())
Construct a UsdUIAccessibilityAPI on UsdPrim prim with name name .
USDUI_API UsdAttribute CreateLabelAttr(VtValue const &defaultValue=VtValue(), bool writeSparsely=false) const
See GetLabelAttr(), and also Create vs Get Property Methods for when to use Get vs Create.
static USDUI_API UsdUIAccessibilityAPI ApplyDefaultAPI(const UsdPrim &prim)
Applies an instance of the API with the default instance name.
The base class for all schema types in Usd.
Definition: schemaBase.h:39
const TfToken & _GetInstanceName() const
Returns the instance name of the API schema object belonging to a multiple-apply API schema.
static USDUI_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...
Provides a container which may hold any type, and provides introspection and iteration over array typ...
Definition: value.h:89
UsdUIAccessibilityAPI(const UsdSchemaBase &schemaObj, const TfToken &name)
Construct a UsdUIAccessibilityAPI on the prim held by schemaObj with name name.
static USDUI_API bool IsAccessibilityAPIPath(const SdfPath &path, TfToken *name)
Checks if the given path path is of an API schema of type AccessibilityAPI.
TfToken class for efficient string referencing and hashing, plus conversions to and from stl string c...