|
HDK
|
#include <STY_Target.h>
Inheritance diagram for STY_Target:Public Member Functions | |
| STY_Target (const UT_JSONValue *json, bool is_selftarget) | |
| STY_Target (const UT_StringHolder &label, const STY_TargetType &type, const STY_TargetHandle &sub_target, const STY_ConstantMap &requirements, const UT_Array< STY_BindingHandle > *pre_bind) | |
| Construct from requirements and a subtarget. More... | |
| ~STY_Target () | |
| bool | isEquivalentToNoTarget () const |
| const UT_StringHolder & | getLabel () const |
| Returns the label given to this target. More... | |
| const STY_TargetType & | getType () const |
| const STY_ConstantMap & | getTargetRequirements () const |
| const char * | getRequirement (const UT_StringHolder &key) const |
| const UT_Array < STY_BindingHandle > * | getPreBindings () const |
| const STY_TargetHandle & | getSubTarget () const |
| void | saveStyleSheet (UT_JSONValueMap *map, const STY_TargetMatchClosureHandle &closure) const |
| Creates a JSON value map for saving to a style sheet. More... | |
| Public Member Functions inherited from UT_IntrusiveRefCounter< STY_Target > | |
| SYS_FORCE_INLINE | UT_IntrusiveRefCounter () noexcept |
| Default constructor: Sets counter to 0. More... | |
| SYS_FORCE_INLINE | UT_IntrusiveRefCounter (const UT_IntrusiveRefCounter &) noexcept |
| Copy constructor: Sets counter to 0. More... | |
| UT_IntrusiveRefCounter & | operator= (const UT_IntrusiveRefCounter &) noexcept |
| Assignment operator: Does not modify counter. More... | |
| SYS_FORCE_INLINE uint32 | use_count () const noexcept |
| Return current counter. More... | |
| SYS_FORCE_INLINE bool | conditionalAddRef () noexcept |
Additional Inherited Members | |
| Protected Member Functions inherited from UT_NonCopyableNS::UT_NonCopyable | |
| UT_NonCopyable ()=default | |
| ~UT_NonCopyable ()=default | |
| UT_NonCopyable (const UT_NonCopyable &)=delete | |
| UT_NonCopyable & | operator= (const UT_NonCopyable &)=delete |
| Protected Member Functions inherited from UT_IntrusiveRefCounter< STY_Target > | |
| SYS_FORCE_INLINE | ~UT_IntrusiveRefCounter () |
| Destructor: Only derived classes can destruct this. More... | |
The style target represents an abstract description of a style subject to which the overrides should be applied. When a style sheet entry is tested whether its overrides should be applied to a style subject, it asks the given style subject to test its target for a match. Thus, it is up to the style subject to interpret the target's requirement data and decide if it satisfies them or not.
The style target is purposely generic, because if it were specific then each usecase of the targets would need to implement own specific target meeting its needs, and it's hard to write own custom target class because it needs to load from JSON into our style sheet class. In the future, we may provide style target factory registration that uses targetType to choose specific implementation class, but now there is no such mechanism.
The style subject, on the other hand, is easy to subclass from, and thus it is style subject's responsibility to perform the matching and processing of style targets.
Definition at line 42 of file STY_Target.h.
| STY_Target::STY_Target | ( | const UT_JSONValue * | json, |
| bool | is_selftarget | ||
| ) |
Constructor of a target based on JSON encoding. The 'is_selftarget' flag is true for targets that refer to the subjects that provided the style sheet definition (it's false for most cases).
| STY_Target::STY_Target | ( | const UT_StringHolder & | label, |
| const STY_TargetType & | type, | ||
| const STY_TargetHandle & | sub_target, | ||
| const STY_ConstantMap & | requirements, | ||
| const UT_Array< STY_BindingHandle > * | pre_bind | ||
| ) |
Construct from requirements and a subtarget.
| STY_Target::~STY_Target | ( | ) |
|
inline |
Returns the label given to this target.
Definition at line 67 of file STY_Target.h.
|
inline |
Returns an array of pre-binding, which contain names of the data that should be retrieved from the subject that match this target. The data (source) is usually stored in a match closure object, and is used for input arguments of override scripts.
Definition at line 91 of file STY_Target.h.
| const char* STY_Target::getRequirement | ( | const UT_StringHolder & | key | ) | const |
Convenience getter for requirement string. Returns NULL if the key is not in the requirements. See the STY_REQUIREMENT constants defined in STY_Types.h for the most common cases.
|
inline |
Returns this target's sub-target than needs to be matched by subsequent styling subject. Usually, styling subjects are arranged in a hiearchy (eg, crowd geometry object > agent primitive > agent's shape), and it is useful for the style target to mimic this hierarchy so that each subject in the hierarchy has a corresponding target, with its own set of requirements.
Definition at line 100 of file STY_Target.h.
|
inline |
Returns the target requirements in the form of key-value dictionary. Subjects query data in this dictionary to retrieve the values they deem to necessary to match.
Definition at line 78 of file STY_Target.h.
|
inline |
Returns the target type. It's a basic constraint that many style subjects test before proceeding with further tests.
Definition at line 72 of file STY_Target.h.
| bool STY_Target::isEquivalentToNoTarget | ( | ) | const |
Returns true if this target is a completely default target specification (equivalent to no target specification at all in JSON). This means a self target with no conditions, no bindings, and no sub-target.
| void STY_Target::saveStyleSheet | ( | UT_JSONValueMap * | map, |
| const STY_TargetMatchClosureHandle & | closure | ||
| ) | const |
Creates a JSON value map for saving to a style sheet.
1.8.6 
