Mike-Solar
244d5e860f
CI / Build & test (Windows) (push) Failing after 7s
All crates take the oak-* kebab-case naming (oak-audio, oak-codec, oak-common, oak-core, oak-ffmpeg-link, oak-node, oak-otio, oak-plugin, oak-render, oak-storage, oak-task, oak-timeline, oak-undo), with the lib identifiers rewritten (oakrender:: -> oak_render::, oakcore_rs:: -> oak_core::, ...) across all 226 referencing files. The GUI application moves from the workspace root into crates/oak-app/: src/, build.rs (paths fixed for the new location) and tests/ travel with it, the root Cargo.toml becomes workspace-only ([workspace] + workspace.package + profiles), and the app package inherits the workspace version. The screenshots example becomes a standalone crate examples/simple_player/ with its own Cargo.toml. Every crate now inherits the single workspace version (version.workspace = true), and the workflows' crate paths and the build docs follow the renames. Validated with a clean cargo check --workspace.
322 lines
11 KiB
C
322 lines
11 KiB
C
|
|
|
|
#ifndef _ofxPropertyHost_h_
|
|
#define _ofxPropertyHost_h_
|
|
|
|
// Copyright OpenFX and contributors to the OpenFX project.
|
|
// SPDX-License-Identifier: BSD-3-Clause
|
|
|
|
|
|
#include "ofxCore.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/** @file ofxProperty.h
|
|
Contains the API for manipulating generic properties. For more details see \ref PropertiesPage.
|
|
*/
|
|
|
|
#define kOfxPropertySuite "OfxPropertySuite"
|
|
|
|
/** @brief The OFX suite used to access properties on OFX objects.
|
|
|
|
*/
|
|
typedef struct OfxPropertySuiteV1 {
|
|
/** @brief Set a single value in a pointer property
|
|
|
|
\arg \c properties handle of the thing holding the property
|
|
\arg \c property string labelling the property
|
|
\arg \c index for multidimenstional properties and is dimension of the one we are setting
|
|
\arg \c value value of the property we are setting
|
|
|
|
@returns
|
|
- ::kOfxStatOK
|
|
- ::kOfxStatErrBadHandle
|
|
- ::kOfxStatErrUnknown
|
|
- ::kOfxStatErrBadIndex
|
|
- ::kOfxStatErrValue
|
|
*/
|
|
OfxStatus (*propSetPointer)(OfxPropertySetHandle properties, const char *property, int index, void *value);
|
|
|
|
/** @brief Set a single value in a string property
|
|
|
|
\arg \c properties handle of the thing holding the property
|
|
\arg \c property string labelling the property
|
|
\arg \c index for multidimenstional properties and is dimension of the one we are setting
|
|
\arg \c value value of the property we are setting
|
|
|
|
@returns
|
|
- ::kOfxStatOK
|
|
- ::kOfxStatErrBadHandle
|
|
- ::kOfxStatErrUnknown
|
|
- ::kOfxStatErrBadIndex
|
|
- ::kOfxStatErrValue
|
|
*/
|
|
OfxStatus (*propSetString) (OfxPropertySetHandle properties, const char *property, int index, const char *value);
|
|
|
|
/** @brief Set a single value in a double property
|
|
|
|
\arg \c properties handle of the thing holding the property
|
|
\arg \c property string labelling the property
|
|
\arg \c index for multidimenstional properties and is dimension of the one we are setting
|
|
\arg \c value value of the property we are setting
|
|
|
|
@returns
|
|
- ::kOfxStatOK
|
|
- ::kOfxStatErrBadHandle
|
|
- ::kOfxStatErrUnknown
|
|
- ::kOfxStatErrBadIndex
|
|
- ::kOfxStatErrValue
|
|
*/
|
|
OfxStatus (*propSetDouble) (OfxPropertySetHandle properties, const char *property, int index, double value);
|
|
|
|
/** @brief Set a single value in an int property
|
|
|
|
\arg \c properties handle of the thing holding the property
|
|
\arg \c property string labelling the property
|
|
\arg \c index for multidimenstional properties and is dimension of the one we are setting
|
|
\arg \c value value of the property we are setting
|
|
|
|
@returns
|
|
- ::kOfxStatOK
|
|
- ::kOfxStatErrBadHandle
|
|
- ::kOfxStatErrUnknown
|
|
- ::kOfxStatErrBadIndex
|
|
- ::kOfxStatErrValue
|
|
*/
|
|
OfxStatus (*propSetInt) (OfxPropertySetHandle properties, const char *property, int index, int value);
|
|
|
|
/** @brief Set multiple values of the pointer property
|
|
|
|
\arg \c properties handle of the thing holding the property
|
|
\arg \c property string labelling the property
|
|
\arg \c count number of values we are setting in that property (ie: indicies 0..count-1)
|
|
\arg \c value pointer to an array of property values
|
|
|
|
@returns
|
|
- ::kOfxStatOK
|
|
- ::kOfxStatErrBadHandle
|
|
- ::kOfxStatErrUnknown
|
|
- ::kOfxStatErrBadIndex
|
|
- ::kOfxStatErrValue
|
|
*/
|
|
OfxStatus (*propSetPointerN)(OfxPropertySetHandle properties, const char *property, int count, void *const*value);
|
|
|
|
/** @brief Set multiple values of a string property
|
|
|
|
\arg \c properties handle of the thing holding the property
|
|
\arg \c property string labelling the property
|
|
\arg \c count number of values we are setting in that property (ie: indicies 0..count-1)
|
|
\arg \c value pointer to an array of property values
|
|
|
|
@returns
|
|
- ::kOfxStatOK
|
|
- ::kOfxStatErrBadHandle
|
|
- ::kOfxStatErrUnknown
|
|
- ::kOfxStatErrBadIndex
|
|
- ::kOfxStatErrValue
|
|
*/
|
|
OfxStatus (*propSetStringN) (OfxPropertySetHandle properties, const char *property, int count, const char *const*value);
|
|
|
|
/** @brief Set multiple values of a double property
|
|
|
|
\arg \c properties handle of the thing holding the property
|
|
\arg \c property string labelling the property
|
|
\arg \c count number of values we are setting in that property (ie: indicies 0..count-1)
|
|
\arg \c value pointer to an array of property values
|
|
|
|
@returns
|
|
- ::kOfxStatOK
|
|
- ::kOfxStatErrBadHandle
|
|
- ::kOfxStatErrUnknown
|
|
- ::kOfxStatErrBadIndex
|
|
- ::kOfxStatErrValue
|
|
|
|
*/
|
|
OfxStatus (*propSetDoubleN) (OfxPropertySetHandle properties, const char *property, int count, const double *value);
|
|
|
|
/** @brief Set multiple values of an int property
|
|
|
|
\arg \c properties handle of the thing holding the property
|
|
\arg \c property string labelling the property
|
|
\arg \c count number of values we are setting in that property (ie: indicies 0..count-1)
|
|
\arg \c value pointer to an array of property values
|
|
|
|
@returns
|
|
- ::kOfxStatOK
|
|
- ::kOfxStatErrBadHandle
|
|
- ::kOfxStatErrUnknown
|
|
- ::kOfxStatErrBadIndex
|
|
- ::kOfxStatErrValue
|
|
|
|
*/
|
|
OfxStatus (*propSetIntN) (OfxPropertySetHandle properties, const char *property, int count, const int *value);
|
|
|
|
/** @brief Get a single value from a pointer property
|
|
|
|
\arg \c properties handle of the thing holding the property
|
|
\arg \c property string labelling the property
|
|
\arg \c index refers to the index of a multi-dimensional property
|
|
\arg \c value pointer the return location
|
|
|
|
@returns
|
|
- ::kOfxStatOK
|
|
- ::kOfxStatErrBadHandle
|
|
- ::kOfxStatErrUnknown
|
|
- ::kOfxStatErrBadIndex
|
|
*/
|
|
OfxStatus (*propGetPointer)(OfxPropertySetHandle properties, const char *property, int index, void **value);
|
|
|
|
/** @brief Get a single value of a string property
|
|
|
|
\arg \c properties handle of the thing holding the property
|
|
\arg \c property string labelling the property
|
|
\arg \c index refers to the index of a multi-dimensional property
|
|
\arg \c value pointer the return location
|
|
|
|
@returns
|
|
- ::kOfxStatOK
|
|
- ::kOfxStatErrBadHandle
|
|
- ::kOfxStatErrUnknown
|
|
- ::kOfxStatErrBadIndex
|
|
*/
|
|
OfxStatus (*propGetString) (OfxPropertySetHandle properties, const char *property, int index, char **value);
|
|
|
|
/** @brief Get a single value of a double property
|
|
|
|
\arg \c properties handle of the thing holding the property
|
|
\arg \c property string labelling the property
|
|
\arg \c index refers to the index of a multi-dimensional property
|
|
\arg \c value pointer the return location
|
|
|
|
See the note \ref ArchitectureStrings for how to deal with strings.
|
|
|
|
@returns
|
|
- ::kOfxStatOK
|
|
- ::kOfxStatErrBadHandle
|
|
- ::kOfxStatErrUnknown
|
|
- ::kOfxStatErrBadIndex
|
|
*/
|
|
OfxStatus (*propGetDouble) (OfxPropertySetHandle properties, const char *property, int index, double *value);
|
|
|
|
/** @brief Get a single value of an int property
|
|
|
|
\arg \c properties handle of the thing holding the property
|
|
\arg \c property string labelling the property
|
|
\arg \c index refers to the index of a multi-dimensional property
|
|
\arg \c value pointer the return location
|
|
|
|
@returns
|
|
- ::kOfxStatOK
|
|
- ::kOfxStatErrBadHandle
|
|
- ::kOfxStatErrUnknown
|
|
- ::kOfxStatErrBadIndex
|
|
*/
|
|
OfxStatus (*propGetInt) (OfxPropertySetHandle properties, const char *property, int index, int *value);
|
|
|
|
/** @brief Get multiple values of a pointer property
|
|
|
|
\arg \c properties handle of the thing holding the property
|
|
\arg \c property string labelling the property
|
|
\arg \c count number of values we are getting of that property (ie: indicies 0..count-1)
|
|
\arg \c value pointer to an array of where we will return the property values
|
|
|
|
@returns
|
|
- ::kOfxStatOK
|
|
- ::kOfxStatErrBadHandle
|
|
- ::kOfxStatErrUnknown
|
|
- ::kOfxStatErrBadIndex
|
|
*/
|
|
OfxStatus (*propGetPointerN)(OfxPropertySetHandle properties, const char *property, int count, void **value);
|
|
|
|
/** @brief Get multiple values of a string property
|
|
|
|
\arg \c properties handle of the thing holding the property
|
|
\arg \c property string labelling the property
|
|
\arg \c count number of values we are getting of that property (ie: indicies 0..count-1)
|
|
\arg \c value pointer to an array of where we will return the property values
|
|
|
|
See the note \ref ArchitectureStrings for how to deal with strings.
|
|
|
|
@returns
|
|
- ::kOfxStatOK
|
|
- ::kOfxStatErrBadHandle
|
|
- ::kOfxStatErrUnknown
|
|
- ::kOfxStatErrBadIndex
|
|
*/
|
|
OfxStatus (*propGetStringN) (OfxPropertySetHandle properties, const char *property, int count, char **value);
|
|
|
|
/** @brief Get multiple values of a double property
|
|
|
|
\arg \c properties handle of the thing holding the property
|
|
\arg \c property string labelling the property
|
|
\arg \c count number of values we are getting of that property (ie: indicies 0..count-1)
|
|
\arg \c value pointer to an array of where we will return the property values
|
|
|
|
@returns
|
|
- ::kOfxStatOK
|
|
- ::kOfxStatErrBadHandle
|
|
- ::kOfxStatErrUnknown
|
|
- ::kOfxStatErrBadIndex
|
|
*/
|
|
OfxStatus (*propGetDoubleN) (OfxPropertySetHandle properties, const char *property, int count, double *value);
|
|
|
|
/** @brief Get multiple values of an int property
|
|
|
|
\arg \c properties handle of the thing holding the property
|
|
\arg \c property string labelling the property
|
|
\arg \c count number of values we are getting of that property (ie: indicies 0..count-1)
|
|
\arg \c value pointer to an array of where we will return the property values
|
|
|
|
@returns
|
|
- ::kOfxStatOK
|
|
- ::kOfxStatErrBadHandle
|
|
- ::kOfxStatErrUnknown
|
|
- ::kOfxStatErrBadIndex
|
|
*/
|
|
OfxStatus (*propGetIntN) (OfxPropertySetHandle properties, const char *property, int count, int *value);
|
|
|
|
/** @brief Resets all dimensions of a property to its default value
|
|
|
|
\arg \c properties handle of the thing holding the property
|
|
\arg \c property string labelling the property we are resetting
|
|
|
|
@returns
|
|
- ::kOfxStatOK
|
|
- ::kOfxStatErrBadHandle
|
|
- ::kOfxStatErrUnknown
|
|
*/
|
|
OfxStatus (*propReset) (OfxPropertySetHandle properties, const char *property);
|
|
|
|
/** @brief Gets the dimension of the property
|
|
|
|
\arg \c properties handle of the thing holding the property
|
|
\arg \c property string labelling the property we are resetting
|
|
\arg \c count pointer to an integer where the value is returned
|
|
|
|
@returns
|
|
- ::kOfxStatOK
|
|
- ::kOfxStatErrBadHandle
|
|
- ::kOfxStatErrUnknown
|
|
*/
|
|
OfxStatus (*propGetDimension) (OfxPropertySetHandle properties, const char *property, int *count);
|
|
} OfxPropertySuiteV1;
|
|
|
|
/**
|
|
\addtogroup ErrorCodes
|
|
*/
|
|
/*@{*/
|
|
|
|
|
|
/*@}*/
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
|
|
#endif
|