Describes the parameters of an Illustrator live effect.
More...
#include <hdicoreLiveEffect.h>
Describes the parameters of an Illustrator live effect.
◆ Parameters() [1/2]
hdi::core::LiveEffect::Parameters::Parameters |
( |
| ) |
|
Constructs an empty Parameters object.
- Author
- GW
- Date
- 08/2014
- Note
- To test if a Parameters object is empty, call isEmpty() on it
-
Empty Parameters objects do not relate to any actual Illustrator live effect parameters; they are designed to be "receivers" of some other Parameters object via the overloaded assignment operator. Empty Parameters objects are useless until such time (though it is safe to call any of their methods)
◆ Parameters() [2/2]
hdi::core::LiveEffect::Parameters::Parameters |
( |
const Parameters & |
p_ | ) |
|
Constructs a new Parameters object from an existing Parameters object (copy ctor)
- Author
- GW
- Date
- 08/2014
- Parameters
-
◆ ~Parameters()
virtual hdi::core::LiveEffect::Parameters::~Parameters |
( |
| ) |
|
|
virtual |
Parameters object destructor.
- Author
- GW
- Date
- 08/2014
◆ aiLiveEffectParams()
virtual AILiveEffectParameters hdi::core::LiveEffect::Parameters::aiLiveEffectParams |
( |
| ) |
const |
|
virtual |
Gets the live effect param ref around which the target object is wrapped.
- Author
- GW
- Date
- 08/2014
- Returns
- AILiveEffectParameters for this object
- Note
- Generally, you shouldn't need to call this method. Only use it if you know what you're doing. If a specific piece of functionality provided by Illustrator is not handled by this class (or related classes), then it should probably be added to the hdi_core library.
◆ displayString()
virtual std::string hdi::core::LiveEffect::Parameters::displayString |
( |
| ) |
const |
|
virtual |
Gets the string that is displayed by the panel in reference to the filter name, if it is set.
- Author
- GW
- Date
- 08/2014
- Returns
- The display string, as UTF-8
◆ evenOdd()
virtual bool hdi::core::LiveEffect::Parameters::evenOdd |
( |
| ) |
const |
|
virtual |
Gets the even-odd fill rule for the target param.
- Author
- GW
- Date
- 08/2014
- Returns
- true if the even-odd rule is used to determine path insideness
◆ extraString()
virtual std::string hdi::core::LiveEffect::Parameters::extraString |
( |
| ) |
const |
|
virtual |
Gets the string that gives extra information for the panel to display for this filter, e.g. as a tool tip.
- Author
- GW
- Date
- 08/2014
- Returns
- The extra string, as UTF-8
◆ fillStyle()
virtual bool hdi::core::LiveEffect::Parameters::fillStyle |
( |
FillStyle & |
fs__ | ) |
const |
|
virtual |
Gets the fill style for the target param.
- Author
- GW
- Date
- 08/2014
- Parameters
-
fs__ | Return-by-reference for the fill style |
- Returns
- true if the fill style could be acquired, false otherwise
◆ fillStyleMatrix()
virtual bool hdi::core::LiveEffect::Parameters::fillStyleMatrix |
( |
TransformMatrix & |
m__ | ) |
const |
|
virtual |
Gets the fill transform for the target param.
- Author
- GW
- Date
- 08/2014
- Parameters
-
m__ | Return-by-reference for the matrix |
- Returns
- true if the matrix could be acquired, false otherwise
- Note
- If the object's fill style matrix is not identity, this will be set in the instance info. The matrix will also be factored into the transformed fill style, but it contains information that is not available in the gradient fields, such as whether there is a reflection.
◆ isEmpty()
virtual bool hdi::core::LiveEffect::Parameters::isEmpty |
( |
| ) |
const |
|
virtual |
Gets whether the target Parameters object is empty (constructed with the default ctor)
- Author
- GW
- Date
- 08/2014
- Returns
- true if the target Parameters object is empty, false otherwise
◆ operator!=()
virtual bool hdi::core::LiveEffect::Parameters::operator!= |
( |
const Parameters & |
rhs_ | ) |
const |
|
virtual |
Tests whether a given Parameters object is not the same as another.
- Author
- GW
- Date
- 08/2014
- Parameters
-
rhs_ | Parameters to compare against (righthand side of inequality operator) |
- Returns
- true for the target and rhs_ being different live effect parameters, false otherwise
◆ operator=()
Assigns one Parameters object to another.
- Author
- GW
- Date
- 08/2014
- Parameters
-
rhs_ | Existing Parameters object to copy values from |
- Returns
- The target Parameters object, but with its values updated to match that of the rhs_ argument
◆ operator==()
virtual bool hdi::core::LiveEffect::Parameters::operator== |
( |
const Parameters & |
rhs_ | ) |
const |
|
virtual |
Tests whether a given Parameters object is the same as another.
- Author
- GW
- Date
- 08/2014
- Parameters
-
rhs_ | Parameters to compare against (righthand side of equality operator) |
- Returns
- true for the target and rhs_ being the same live effect parameters, false otherwise
◆ scaleFactor()
virtual double hdi::core::LiveEffect::Parameters::scaleFactor |
( |
| ) |
const |
|
virtual |
Gets the scale factor for the target param.
- Author
- GW
- Date
- 08/2014
- Returns
- The scale factor
◆ strokeStyle()
virtual bool hdi::core::LiveEffect::Parameters::strokeStyle |
( |
StrokeStyle & |
ss__ | ) |
const |
|
virtual |
Gets the stroke style for the target param.
- Author
- GW
- Date
- 08/2014
- Parameters
-
ss__ | Return-by-reference for the stroke style |
- Returns
- true if the stroke style could be acquired, false otherwise
◆ strokeStyleMatrix()
virtual bool hdi::core::LiveEffect::Parameters::strokeStyleMatrix |
( |
TransformMatrix & |
m__ | ) |
const |
|
virtual |
Gets the stroke transform for the target param.
- Author
- GW
- Date
- 08/2014
- Parameters
-
m__ | Return-by-reference for the matrix |
- Returns
- true if the matrix could be acquired, false otherwise
- Note
- If the object's stroke style matrix is not identity, this will be set in the instance info. The matrix will also be factored into the transformed stroke style, but it contains information that is not available in the gradient fields, such as whether there is a reflection.
◆ xformedFillStyle()
virtual bool hdi::core::LiveEffect::Parameters::xformedFillStyle |
( |
FillStyle & |
fs__ | ) |
const |
|
virtual |
Gets the fill style for the target param, but with the object's style matrix multiplied in for gradient fills.
- Author
- GW
- Date
- 08/2014
- Parameters
-
fs__ | Return-by-reference for the fill style |
- Returns
- true if the fill style could be acquired, false otherwise
◆ xformedStrokeStyle()
virtual bool hdi::core::LiveEffect::Parameters::xformedStrokeStyle |
( |
StrokeStyle & |
ss__ | ) |
const |
|
virtual |
Gets the stroke style for the target param, but with the object's style matrix multiplied in for gradient stroke.
- Author
- GW
- Date
- 08/2014
- Parameters
-
fs__ | Return-by-reference for the stroke style |
- Returns
- true if the fill style could be acquired, false otherwise