ParaView
Classes | Public Types | Public Member Functions | Static Public Member Functions | Protected Member Functions | Protected Attributes | Static Protected Attributes | Friends | List of all members
vtkSMProxyProperty Class Reference

property representing pointer(s) to vtkObject(s) More...

#include <vtkSMProxyProperty.h>

Inheritance diagram for vtkSMProxyProperty:
Inheritance graph
[legend]
Collaboration diagram for vtkSMProxyProperty:
Collaboration graph
[legend]

Classes

class  vtkPPInternals
 This class is used by vtkSMProxyProperty to keep track of the proxies. More...
 

Public Types

typedef vtkSMProperty Superclass
 
- Public Types inherited from vtkSMProperty
typedef vtkSMObject Superclass
 
- Public Types inherited from vtkSMObject
typedef vtkObject Superclass
 

Public Member Functions

virtual const char * GetClassName ()
 
virtual int IsA (const char *type)
 
void PrintSelf (ostream &os, vtkIndent indent)
 
virtual void SetProxies (unsigned int numElements, vtkSMProxy *proxies[])
 Sets the value of the property to the list of proxies specified. More...
 
bool IsProxyAdded (vtkSMProxy *proxy)
 Returns if the given proxy is already added to the property. More...
 
virtual void RemoveAllUncheckedProxies ()
 Removes all unchecked proxies. More...
 
virtual void ClearUncheckedElements ()
 Use this method to clear unchecked values set of this property. More...
 
unsigned int GetNumberOfProxies ()
 Returns the number of proxies. More...
 
unsigned int GetNumberOfUncheckedProxies ()
 Returns the number of unchecked proxies. More...
 
vtkSMProxyGetProxy (unsigned int idx)
 Return a proxy. More...
 
vtkSMProxyGetUncheckedProxy (unsigned int idx)
 Return a proxy. More...
 
virtual void Copy (vtkSMProperty *src)
 Copy all property values. More...
 
virtual void UpdateAllInputs ()
 Update all proxies referred by this property (if any). More...
 
virtual bool IsValueDefault ()
 Returns true if the property's value is different from the default value. More...
 
virtual void ResetToXMLDefaults ()
 For properties that support specifying defaults in XML configuration, this method will reset the property value to the default values specified in the XML. More...
 
virtual void AddProxy (vtkSMProxy *proxy)
 Add/remove/set a proxy to the list of proxies. More...
 
virtual void SetProxy (unsigned int idx, vtkSMProxy *proxy)
 Add/remove/set a proxy to the list of proxies. More...
 
virtual void RemoveProxy (vtkSMProxy *proxy)
 Add/remove/set a proxy to the list of proxies. More...
 
virtual void RemoveAllProxies ()
 Add/remove/set a proxy to the list of proxies. More...
 
virtual void AddUncheckedProxy (vtkSMProxy *proxy)
 Add an unchecked proxy. More...
 
virtual void SetUncheckedProxy (unsigned int idx, vtkSMProxy *proxy)
 Add an unchecked proxy. More...
 
void SetNumberOfProxies (unsigned int count)
 Set the number of proxies. More...
 
void SetNumberOfUncheckedProxies (unsigned int count)
 Set the number of proxies. More...
 
virtual bool GetSkipDependency ()
 Returns whether the "skip_dependency" attribute is set. More...
 
- Public Member Functions inherited from vtkSMProperty
void PrintSelf (ostream &os, vtkIndent indent)
 
int IsInDomains ()
 Returns true if all values are in all domains, false otherwise. More...
 
int IsInDomains (vtkSMDomain **domain)
 Overload of IsInDomains() that provides a mechanism to return the first domain that fails the check. More...
 
virtual void UnRegister (vtkObjectBase *obj)
 Overloaded to break the reference loop caused by the internal domain iterator. More...
 
vtkSMDomainIteratorNewDomainIterator ()
 Creates, initializes and returns a new domain iterator. More...
 
vtkSMDomainGetDomain (const char *name)
 Returns a domain give a name. More...
 
vtkSMDomainFindDomain (const char *classname)
 Returns the first domain which is of the specified type. More...
 
unsigned int GetNumberOfDomains ()
 Returns the number of domains this property has. More...
 
void UpdateDependentDomains ()
 Calls Update() on all domains contained by the property as well as all dependant domains. More...
 
void AddDomain (const char *name, vtkSMDomain *dom)
 Properties can have one or more domains. More...
 
virtual void AddLinkedProperty (vtkSMProperty *targetProperty)
 Add a link to a property whose value should be synchronized with this property value. More...
 
virtual void RemoveLinkedProperty (vtkSMProperty *targetProperty)
 Remove a link to a property added with AddLinkedProperty() More...
 
virtual void RemoveFromSourceLink ()
 Remove a link from the source property. More...
 
void ResetToDefault ()
 Simply calls this->ResetToDomainDefaults() and if that returns false, calls this->ResetToXMLDefaults(). More...
 
virtual bool ResetToDomainDefaults (bool use_unchecked_values=false)
 Iterates over all domains and call SetDefaultValues() on each domain until the first one returns true i.e. More...
 
vtkSMProxyGetParent ()
 Get the proxy to which this property belongs. More...
 
virtual bool IsStateIgnored ()
 
bool HasDomainsWithRequiredProperties ()
 Returns true if the property has a domain with required properties. More...
 
virtual void SetCommand (const char *)
 The command name used to set the value on the server object. More...
 
virtual char * GetCommand ()
 The command name used to set the value on the server object. More...
 
virtual void SetImmediateUpdate (int)
 If ImmediateUpdate is true, the value of the property will be pushed to the server as soon as it is modified. More...
 
virtual int GetImmediateUpdate ()
 If ImmediateUpdate is true, the value of the property will be pushed to the server as soon as it is modified. More...
 
virtual int GetInformationOnly ()
 Is InformationOnly is set to true, this property is used to get information from server instead of setting values. More...
 
virtual int GetIgnoreSynchronization ()
 If IgnoreSynchronization is set to true, this property is used to prevent that property from beeing updated when changed remotely by another collaborative client. More...
 
virtual vtkSMPropertyGetInformationProperty ()
 Get the associated information property. More...
 
virtual void SetAnimateable (int)
 Get/Set if the property is animateable. More...
 
virtual int GetAnimateable ()
 Get/Set if the property is animateable. More...
 
virtual void SetIsInternal (int)
 Get/Set if the property is internal to server manager. More...
 
virtual int GetIsInternal ()
 Get/Set if the property is internal to server manager. More...
 
virtual void SetNoCustomDefault (int)
 Sets whether the property should ignore custom default settings. More...
 
virtual int GetNoCustomDefault ()
 Gets whether the property should ignore custom default settings. More...
 
virtual void SetPanelVisibility (const char *)
 Sets the panel visibility for the property. More...
 
virtual char * GetPanelVisibility ()
 Returns the panel visibility for the property. More...
 
virtual void SetPanelVisibilityDefaultForRepresentation (const char *)
 Sets the panel visibility to default if the current representation type matches representation. More...
 
virtual char * GetPanelVisibilityDefaultForRepresentation ()
 Returns which representation type the property will be shown by default for. More...
 
virtual void SetPanelWidget (const char *)
 Sets the name of the custom panel widget to use for the property. More...
 
virtual char * GetPanelWidget ()
 Returns name of the panel widget for the property. More...
 
virtual vtkSMDocumentationGetDocumentation ()
 Returns the documentation for this proxy. More...
 
virtual char * GetXMLLabel ()
 The label assigned by the xml parser. More...
 
virtual char * GetXMLName ()
 The name assigned by the xml parser. More...
 
virtual int GetRepeatable ()
 If repeatable, a property can have 1 or more values of the same kind. More...
 
virtual vtkPVXMLElementGetHints ()
 The server manager configuration XML may define <Hints> element for a property. More...
 
void SetHints (vtkPVXMLElement *hints)
 The server manager configuration XML may define <Hints> element for a property. More...
 
virtual void Modified ()
 Overridden to support blocking of modified events. More...
 
- Public Member Functions inherited from vtkSMObject
void PrintSelf (ostream &os, vtkIndent indent)
 

Static Public Member Functions

static vtkSMProxyPropertyNew ()
 
static int IsTypeOf (const char *type)
 
static vtkSMProxyPropertySafeDownCast (vtkObject *o)
 
static void EnableProxyCreation ()
 When we load ProxyManager state we want Proxy/InputProperty to be able to create the corresponding missing proxy. More...
 
static void DisableProxyCreation ()
 When we load ProxyManager state we want Proxy/InputProperty to be able to create the corresponding missing proxy. More...
 
static bool CanCreateProxy ()
 When we load ProxyManager state we want Proxy/InputProperty to be able to create the corresponding missing proxy. More...
 
- Static Public Member Functions inherited from vtkSMProperty
static vtkSMPropertyNew ()
 
static int IsTypeOf (const char *type)
 
static vtkSMPropertySafeDownCast (vtkObject *o)
 
- Static Public Member Functions inherited from vtkSMObject
static vtkSMObjectNew ()
 
static int IsTypeOf (const char *type)
 
static vtkSMObjectSafeDownCast (vtkObject *o)
 

Protected Member Functions

 vtkSMProxyProperty ()
 
 ~vtkSMProxyProperty ()
 
virtual void WriteTo (vtkSMMessage *msg)
 Let the property write its content into the stream. More...
 
virtual void ReadFrom (const vtkSMMessage *msg, int msg_offset, vtkSMProxyLocator *)
 Let the property read and set its content from the stream. More...
 
virtual int ReadXMLAttributes (vtkSMProxy *parent, vtkPVXMLElement *element)
 Set the appropriate ivars from the xml element. More...
 
virtual void SaveStateValues (vtkPVXMLElement *propertyElement)
 Generic method used to generate XML state. More...
 
virtual vtkPVXMLElementAddProxyElementState (vtkPVXMLElement *prop, unsigned int idx)
 Fill state property/proxy XML element with proxy info. More...
 
virtual int LoadState (vtkPVXMLElement *element, vtkSMProxyLocator *loader)
 Updates state from an XML element. More...
 
void OnUpdateDataEvent ()
 Called when a producer fires the vtkCommand::UpdateDataEvent. More...
 
- Protected Member Functions inherited from vtkSMProperty
 vtkSMProperty ()
 
 ~vtkSMProperty ()
 
virtual void ReadFrom (const vtkSMMessage *, int vtkNotUsed(message_offset), vtkSMProxyLocator *)
 Let the property read and set its content from the stream. More...
 
vtkSMPropertyNewProperty (const char *name)
 Internal. More...
 
void AddDependent (vtkSMDomain *dom)
 Internal. More...
 
void RemoveAllDependents ()
 Removes all dependents. More...
 
void UpdateDomains ()
 Calls Update() on all domains contained by the property as well as all dependant domains. More...
 
virtual void SaveState (vtkPVXMLElement *parent, const char *property_name, const char *uid, int saveDomains=1)
 Save the property state in XML. More...
 
virtual void SaveDomainState (vtkPVXMLElement *propertyElement, const char *uid)
 Save property domain. More...
 
virtual void SetXMLLabel (const char *)
 
virtual void SetInformationOnly (int)
 
virtual void SetIgnoreSynchronization (int)
 
void SetInformationProperty (vtkSMProperty *ip)
 
void SetDocumentation (vtkSMDocumentation *)
 
void SetParent (vtkSMProxy *proxy)
 
virtual void SetStateIgnored (bool)
 
virtual void StateIgnoredOn ()
 
virtual void StateIgnoredOff ()
 
virtual void SetXMLName (const char *)
 The name assigned by the xml parser. More...
 
bool SetBlockModifiedEvents (bool block)
 Block/unblock modified events, returns the current state of the block flag. More...
 
virtual bool GetPendingModifiedEvents ()
 Returns if any modified evetns are pending. More...
 
- Protected Member Functions inherited from vtkSMObject
 vtkSMObject ()
 
 ~vtkSMObject ()
 

Protected Attributes

bool SkipDependency
 
vtkPPInternalsPPInternals
 
- Protected Attributes inherited from vtkSMProperty
vtkPVXMLElementHints
 
char * Command
 
vtkSMPropertyInternalsPInternals
 
int ImmediateUpdate
 
int Animateable
 
int IsInternal
 
int NoCustomDefault
 
char * XMLName
 
char * XMLLabel
 
char * PanelVisibility
 
char * PanelVisibilityDefaultForRepresentation
 
char * PanelWidget
 
vtkSMDomainIteratorDomainIterator
 
int InformationOnly
 
int IgnoreSynchronization
 
vtkSMInformationHelper * InformationHelper
 
vtkSMPropertyInformationProperty
 
vtkSMDocumentationDocumentation
 
int Repeatable
 
vtkWeakPointer< vtkSMProxyProxy
 
bool StateIgnored
 
vtkSMPropertyLinkLinks
 

Static Protected Attributes

static bool CreateProxyAllowed
 

Friends

class vtkSMProxy
 
class vtkPPInternals
 

Detailed Description

property representing pointer(s) to vtkObject(s)

vtkSMProxyProperty is a concrete sub-class of vtkSMProperty representing pointer(s) to vtkObject(s) (through vtkSMProxy).

vtkSMProperty::UpdateDomains() is called by vtkSMProperty itself whenever its unchecked values are modified. In case of proxy-properties, the dependent domains typically tend to depend on the data information provided by the source-proxies added to the property. Thus, to ensure that the domains get updated if the data information changes, vtkSMProxyProperty ensures that vtkSMProperty::UpdateDomains() is called whenever any of the added proxies fires the vtkCommand::UpdateDataEvent (which is fired whenever the pipeline us updated through the ServerManager indicating that the data-information last used may have been invalidated).

Besides the standard set of attributes, the following XML attributes are supported:

Definition at line 72 of file vtkSMProxyProperty.h.

Member Typedef Documentation

§ Superclass

Definition at line 88 of file vtkSMProxyProperty.h.

Constructor & Destructor Documentation

§ vtkSMProxyProperty()

vtkSMProxyProperty::vtkSMProxyProperty ( )
protected

§ ~vtkSMProxyProperty()

vtkSMProxyProperty::~vtkSMProxyProperty ( )
protected

Member Function Documentation

§ EnableProxyCreation()

static void vtkSMProxyProperty::EnableProxyCreation ( )
static

When we load ProxyManager state we want Proxy/InputProperty to be able to create the corresponding missing proxy.

Although when the goal is to load a state on any standard proxy, we do not want that proxy property be able to create new proxy based on some previous state.

§ DisableProxyCreation()

static void vtkSMProxyProperty::DisableProxyCreation ( )
static

When we load ProxyManager state we want Proxy/InputProperty to be able to create the corresponding missing proxy.

Although when the goal is to load a state on any standard proxy, we do not want that proxy property be able to create new proxy based on some previous state.

§ CanCreateProxy()

static bool vtkSMProxyProperty::CanCreateProxy ( )
static

When we load ProxyManager state we want Proxy/InputProperty to be able to create the corresponding missing proxy.

Although when the goal is to load a state on any standard proxy, we do not want that proxy property be able to create new proxy based on some previous state.

§ New()

static vtkSMProxyProperty* vtkSMProxyProperty::New ( )
static

§ GetClassName()

virtual const char* vtkSMProxyProperty::GetClassName ( )
virtual

Reimplemented from vtkSMProperty.

Reimplemented in vtkSMInputProperty.

§ IsTypeOf()

static int vtkSMProxyProperty::IsTypeOf ( const char *  type)
static

§ IsA()

virtual int vtkSMProxyProperty::IsA ( const char *  type)
virtual

Reimplemented from vtkSMProperty.

Reimplemented in vtkSMInputProperty.

§ SafeDownCast()

static vtkSMProxyProperty* vtkSMProxyProperty::SafeDownCast ( vtkObject *  o)
static

§ PrintSelf()

void vtkSMProxyProperty::PrintSelf ( ostream &  os,
vtkIndent  indent 
)

§ AddProxy()

virtual void vtkSMProxyProperty::AddProxy ( vtkSMProxy proxy)
virtual

Add/remove/set a proxy to the list of proxies.

For SetProxy, the property automatically resizes to accommodate the index specified.

§ SetProxy()

virtual void vtkSMProxyProperty::SetProxy ( unsigned int  idx,
vtkSMProxy proxy 
)
virtual

Add/remove/set a proxy to the list of proxies.

For SetProxy, the property automatically resizes to accommodate the index specified.

§ RemoveProxy()

virtual void vtkSMProxyProperty::RemoveProxy ( vtkSMProxy proxy)
virtual

Add/remove/set a proxy to the list of proxies.

For SetProxy, the property automatically resizes to accommodate the index specified.

§ RemoveAllProxies()

virtual void vtkSMProxyProperty::RemoveAllProxies ( )
virtual

Add/remove/set a proxy to the list of proxies.

For SetProxy, the property automatically resizes to accommodate the index specified.

§ SetProxies()

virtual void vtkSMProxyProperty::SetProxies ( unsigned int  numElements,
vtkSMProxy proxies[] 
)
virtual

Sets the value of the property to the list of proxies specified.

§ IsProxyAdded()

bool vtkSMProxyProperty::IsProxyAdded ( vtkSMProxy proxy)

Returns if the given proxy is already added to the property.

§ AddUncheckedProxy()

virtual void vtkSMProxyProperty::AddUncheckedProxy ( vtkSMProxy proxy)
virtual

Add an unchecked proxy.

Does not modify the property. Unchecked proxies are used by domains when verifying whether a value is acceptable. To check if a value is in the domains, you can do the following:

* - RemoveAllUncheckedProxies()
* - AddUncheckedProxy(proxy)
* - IsInDomains()
* 

§ SetUncheckedProxy()

virtual void vtkSMProxyProperty::SetUncheckedProxy ( unsigned int  idx,
vtkSMProxy proxy 
)
virtual

Add an unchecked proxy.

Does not modify the property. Unchecked proxies are used by domains when verifying whether a value is acceptable. To check if a value is in the domains, you can do the following:

* - RemoveAllUncheckedProxies()
* - AddUncheckedProxy(proxy)
* - IsInDomains()
* 

§ RemoveAllUncheckedProxies()

virtual void vtkSMProxyProperty::RemoveAllUncheckedProxies ( )
virtual

Removes all unchecked proxies.

§ ClearUncheckedElements()

virtual void vtkSMProxyProperty::ClearUncheckedElements ( )
inlinevirtual

Use this method to clear unchecked values set of this property.

Reimplemented from vtkSMProperty.

Definition at line 132 of file vtkSMProxyProperty.h.

§ GetNumberOfProxies()

unsigned int vtkSMProxyProperty::GetNumberOfProxies ( )

Returns the number of proxies.

§ GetNumberOfUncheckedProxies()

unsigned int vtkSMProxyProperty::GetNumberOfUncheckedProxies ( )

Returns the number of unchecked proxies.

§ SetNumberOfProxies()

void vtkSMProxyProperty::SetNumberOfProxies ( unsigned int  count)

Set the number of proxies.

§ SetNumberOfUncheckedProxies()

void vtkSMProxyProperty::SetNumberOfUncheckedProxies ( unsigned int  count)

Set the number of proxies.

§ GetProxy()

vtkSMProxy* vtkSMProxyProperty::GetProxy ( unsigned int  idx)

Return a proxy.

No bounds check is performed.

§ GetUncheckedProxy()

vtkSMProxy* vtkSMProxyProperty::GetUncheckedProxy ( unsigned int  idx)

Return a proxy.

No bounds check is performed.

§ Copy()

virtual void vtkSMProxyProperty::Copy ( vtkSMProperty src)
virtual

Copy all property values.

Reimplemented from vtkSMProperty.

§ GetSkipDependency()

virtual bool vtkSMProxyProperty::GetSkipDependency ( )
virtual

Returns whether the "skip_dependency" attribute is set.

§ UpdateAllInputs()

virtual void vtkSMProxyProperty::UpdateAllInputs ( )
virtual

Update all proxies referred by this property (if any).

Reimplemented from vtkSMProperty.

§ IsValueDefault()

virtual bool vtkSMProxyProperty::IsValueDefault ( )
virtual

Returns true if the property's value is different from the default value.

This is used as a hint by the state saving code to determine if the value should be written to the file or if the defaults are sufficient.

Reimplemented from vtkSMProperty.

§ ResetToXMLDefaults()

virtual void vtkSMProxyProperty::ResetToXMLDefaults ( )
virtual

For properties that support specifying defaults in XML configuration, this method will reset the property value to the default values specified in the XML.

Simply clears the property.

Reimplemented from vtkSMProperty.

§ WriteTo()

virtual void vtkSMProxyProperty::WriteTo ( vtkSMMessage msg)
protectedvirtual

Let the property write its content into the stream.

Reimplemented from vtkSMProperty.

§ ReadFrom()

virtual void vtkSMProxyProperty::ReadFrom ( const vtkSMMessage msg,
int  msg_offset,
vtkSMProxyLocator  
)
protectedvirtual

Let the property read and set its content from the stream.

§ ReadXMLAttributes()

virtual int vtkSMProxyProperty::ReadXMLAttributes ( vtkSMProxy parent,
vtkPVXMLElement element 
)
protectedvirtual

Set the appropriate ivars from the xml element.

Should be overwritten by subclass if adding ivars.

Reimplemented from vtkSMProperty.

Reimplemented in vtkSMInputProperty.

§ SaveStateValues()

virtual void vtkSMProxyProperty::SaveStateValues ( vtkPVXMLElement propertyElement)
protectedvirtual

Generic method used to generate XML state.

Reimplemented from vtkSMProperty.

§ AddProxyElementState()

virtual vtkPVXMLElement* vtkSMProxyProperty::AddProxyElementState ( vtkPVXMLElement prop,
unsigned int  idx 
)
protectedvirtual

Fill state property/proxy XML element with proxy info.

Return the created proxy XML element that has been added as a child in the property definition. If prop == NULL, you must Delete yourself the result otherwise prop is olding a reference to the proxy element

Reimplemented in vtkSMInputProperty.

§ LoadState()

virtual int vtkSMProxyProperty::LoadState ( vtkPVXMLElement element,
vtkSMProxyLocator loader 
)
protectedvirtual

Updates state from an XML element.

Returns 0 on failure.

Reimplemented from vtkSMProperty.

§ OnUpdateDataEvent()

void vtkSMProxyProperty::OnUpdateDataEvent ( )
inlineprotected

Called when a producer fires the vtkCommand::UpdateDataEvent.

We update all dependent domains since the data-information may have changed.

Definition at line 232 of file vtkSMProxyProperty.h.

Friends And Related Function Documentation

§ vtkSMProxy

friend class vtkSMProxy
friend

Definition at line 203 of file vtkSMProxyProperty.h.

§ vtkPPInternals

friend class vtkPPInternals
friend

Definition at line 240 of file vtkSMProxyProperty.h.

Member Data Documentation

§ CreateProxyAllowed

bool vtkSMProxyProperty::CreateProxyAllowed
staticprotected

Definition at line 236 of file vtkSMProxyProperty.h.

§ SkipDependency

bool vtkSMProxyProperty::SkipDependency
protected

Definition at line 238 of file vtkSMProxyProperty.h.

§ PPInternals

vtkPPInternals* vtkSMProxyProperty::PPInternals
protected

Definition at line 242 of file vtkSMProxyProperty.h.


The documentation for this class was generated from the following file: