Inviwo 0.9.12-pre
Inviwo documentation
Loading...
Searching...
No Matches
inviwo::CameraProperty Class Reference

#include <inviwo/core/properties/cameraproperty.h>

Inheritance diagram for inviwo::CameraProperty:

Public Types

using value_type = Camera
Public Types inherited from inviwo::CompositeProperty
enum class  CollapseAction { Collapse , Expand }
enum class  CollapseTarget { Current , Recursive , Children , Siblings }
Public Types inherited from inviwo::PropertyOwner
using const_iterator = std::vector<Property*>::const_iterator
using iterator = std::vector<Property*>::iterator

Public Member Functions

void addCamerapProperty (std::unique_ptr< Property > camprop)
 CameraProperty (const CameraProperty &rhs)
 CameraProperty (std::string_view identifier, std::string_view displayName, Document help, std::function< std::optional< mat4 >()> getBoundingBox, vec3 eye=vec3(0.0f, 0.0f, 2.0f), vec3 center=vec3(0.0f), vec3 lookUp=vec3(0.0f, 1.0f, 0.0f), InvalidationLevel invalidationLevel=InvalidationLevel::InvalidResources, PropertySemantics semantics=PropertySemantics::Default)
 CameraProperty (std::string_view identifier, std::string_view displayName, std::function< std::optional< mat4 >()> getBoundingBox, vec3 eye=vec3(0.0f, 0.0f, 2.0f), vec3 center=vec3(0.0f), vec3 lookUp=vec3(0.0f, 1.0f, 0.0f), InvalidationLevel invalidationLevel=InvalidationLevel::InvalidResources, PropertySemantics semantics=PropertySemantics::Default)
 CameraProperty (std::string_view identifier, std::string_view displayName, vec3 eye=vec3(0.0f, 0.0f, 2.0f), vec3 center=vec3(0.0f), vec3 lookUp=vec3(0.0f, 1.0f, 0.0f), Inport *inport=nullptr, InvalidationLevel invalidationLevel=InvalidationLevel::InvalidResources, PropertySemantics semantics=PropertySemantics::Default)
virtual CameraProperty * clone () const override
virtual void deserialize (Deserializer &d) override
void fitData ()
void flipUp ()
virtual Cameraget ()
virtual const Cameraget () const
float getAspectRatio () const
PropertygetCameraProperty (const std::string &identifier) const
virtual std::string_view getClassIdentifier () const override
vec4 getClipPosFromNormalizedDeviceCoords (const vec3 &ndcCoords) const
 Convert from normalized device coordinates (xyz in [-1 1]) to clip coordinates.
virtual float getFarPlaneDist () const override
virtual vec3 getLookFrom () const override
virtual vec3 getLookFromMaxValue () const override
virtual vec3 getLookFromMinValue () const override
vec3 getLookRight () const
virtual vec3 getLookTo () const override
virtual vec3 getLookToMaxValue () const override
virtual vec3 getLookToMinValue () const override
virtual vec3 getLookUp () const override
virtual float getNearPlaneDist () const override
virtual vec3 getNormalizedDeviceFromNormalizedScreenAtFocusPointDepth (const vec2 &normalizedScreenCoord) const override
virtual vec3 getWorldPosFromNormalizedDeviceCoords (const vec3 &ndcCoords) const override
 Convert from normalized device coordinates (xyz in [-1 1]) to world coordinates.
const mat4 & inverseProjectionMatrix () const
const mat4 & inverseViewMatrix () const
void invokeEvent (Event *event) override
virtual bool isDefaultState () const override
virtual bool needsSerialization () const override
 operator const Camera & () const
const mat4 & projectionMatrix () const
virtual CameraProperty & resetToDefaultState () override
virtual void serialize (Serializer &s) const override
virtual void set (const Property *srcProperty) override
CameraProperty & setAspectRatio (float aspectRatio)
CameraProperty & setCamera (std::string_view cameraIdentifier)
CameraProperty & setCamera (std::unique_ptr< Camera > camera)
virtual CameraProperty & setCurrentStateAsDefault () override
CameraProperty & setFarPlaneDist (float v)
virtual TrackballObjectsetLook (vec3 lookFrom, vec3 lookTo, vec3 lookUp) override
virtual TrackballObjectsetLookFrom (vec3 lookFrom) override
void setLookRange ()
virtual TrackballObjectsetLookTo (vec3 lookTo) override
virtual TrackballObjectsetLookUp (vec3 lookUp) override
void setNearFar ()
CameraProperty & setNearFarPlaneDist (float nearPlaneDist, float farPlaneDist, float minMaxRatio=10.f)
CameraProperty & setNearPlaneDist (float v)
void setView (camerautil::Side side)
const mat4 & viewMatrix () const
virtual void zoom (const ZoomOptions &opts) override
Public Member Functions inherited from inviwo::CompositeProperty
virtual void accept (NetworkVisitor &visitor) override
 Accept a NetworkVisitor, the visitor will visit this and then each Property of the CompositeProperty in an undefined order. The Visitor will then visit each Properties's properties and so on.
 CompositeProperty (CompositeProperty &&rhs)=default
 CompositeProperty (const CompositeProperty &rhs)=default
 CompositeProperty (std::string_view identifier, std::string_view displayName, Document help, InvalidationLevel invalidationLevel=InvalidationLevel::InvalidResources, PropertySemantics semantics=PropertySemantics::Default)
 CompositeProperty (std::string_view identifier, std::string_view displayName, InvalidationLevel invalidationLevel=InvalidationLevel::InvalidResources, PropertySemantics semantics=PropertySemantics::Default)
virtual std::string_view getClassIdentifierForWidget () const override
 Returns which property's widget should be used when the WidgetFactory tries to create a widget. Defaults to getClassIdentifier(), should only be overridden if a subclass want to reuse another property's widget.
virtual const std::string & getIdentifier () const override
virtual InvalidationLevel getInvalidationLevel () const override
virtual InviwoApplicationgetInviwoApplication () override
virtual const PropertyOwner * getOwner () const override
virtual PropertyOwner * getOwner () override
virtual const ProcessorgetProcessor () const override
virtual ProcessorgetProcessor () override
virtual void invalidate (InvalidationLevel invalidationLevel, Property *modifiedProperty=0) override
virtual bool isCollapsed () const
CompositeProperty & operator= (CompositeProperty &&rhs)=default
CompositeProperty & operator= (const CompositeProperty &rhs)=delete
void set (const CompositeProperty *src)
virtual CompositeProperty & setCollapsed (bool value)
CompositeProperty & setCollapsed (CollapseAction action, CollapseTarget target)
virtual void setOwner (PropertyOwner *owner) override
virtual CompositeProperty & setReadOnly (bool value) override
 Enable or disable editing of property.
virtual void setValid () override
Public Member Functions inherited from inviwo::Property
template<typename P>
Property & autoLinkToProperty (std::string_view propertyPath)
void clearInitiatingWidget ()
void deregisterWidget (PropertyWidget *propertyWidget)
const std::vector< std::pair< std::string, std::string > > & getAutoLinkToProperty () const
virtual Document getDescription () const
virtual const std::string & getDisplayName () const
DocumentgetHelp ()
const DocumentgetHelp () const
PropertyOwnergetOwner ()
const PropertyOwnergetOwner () const
const std::string & getPath () const
 Get the property path as string.
void getPath (std::pmr::string &out) const
virtual bool getReadOnly () const
virtual PropertySemantics getSemantics () const
virtual PropertySerializationMode getSerializationMode () const
virtual bool getVisible () const
const std::vector< PropertyWidget * > & getWidgets () const
bool hasWidgets () const
virtual bool isModified () const
const BaseCallBack * onChange (std::function< void()> callback)
std::shared_ptr< std::function< void()> > onChangeScoped (std::function< void()> callback)
 Property (std::string_view identifier, std::string_view displayName, InvalidationLevel invalidationLevel, PropertySemantics semantics=PropertySemantics::Default)
 Property (std::string_view identifier="", std::string_view displayName="", Document help={}, InvalidationLevel invalidationLevel=InvalidationLevel::InvalidOutput, PropertySemantics semantics=PropertySemantics::Default, ReadOnly readOnly=ReadOnly::No)
virtual Property & propertyModified ()
template<typename P, typename DecisionFunc>
Property & readonlyDependsOn (P &prop, DecisionFunc callback)
void registerWidget (PropertyWidget *propertyWidget)
void removeOnChange (const BaseCallBack *callback)
virtual Property & setDisplayName (std::string_view displayName)
 A property's name displayed to the user.
Property & setHelp (Document help)
virtual Property & setIdentifier (std::string_view identifier)
void setInitiatingWidget (PropertyWidget *propertyWidget)
virtual Property & setInvalidationLevel (InvalidationLevel invalidationLevel)
virtual Property & setModified ()
virtual Property & setSemantics (const PropertySemantics &semantics)
virtual Property & setSerializationMode (PropertySerializationMode mode)
virtual Property & setVisible (bool val)
void updateWidgets ()
template<typename P, typename DecisionFunc>
Property & visibilityDependsOn (P &prop, DecisionFunc callback)
virtual ~Property ()
 Removes itself from its PropertyOwner.
Public Member Functions inherited from inviwo::Observable< PropertyObserver >
void addObserver (PropertyObserver *observer)
bool isObservedBy (PropertyObserver *observer) const
Observable< PropertyObserver > & operator= (const Observable< PropertyObserver > &other)
void removeObserver (PropertyObserver *observer)
virtual void startBlockingNotifications () override final
virtual void stopBlockingNotifications () override final
Public Member Functions inherited from inviwo::MetaDataOwner
void copyMetaDataFrom (const MetaDataOwner &src)
void copyMetaDataTo (MetaDataOwner &dst)
template<typename T>
requires std::derived_from<T, MetaData>
T * createMetaData (std::string_view key)
void deserialize (Deserializer &d)
template<typename T>
requires std::derived_from<T, MetaData>
T * getMetaData (std::string_view key)
template<typename T>
requires std::derived_from<T, MetaData>
const T * getMetaData (std::string_view key) const
template<typename T, typename U>
requires std::derived_from<T, MetaData> && Gettable<T, U>
getMetaData (std::string_view key, U val) const
MetaDataMapgetMetaDataMap ()
const MetaDataMapgetMetaDataMap () const
template<typename T>
requires std::derived_from<T, MetaData>
bool hasMetaData (std::string_view key) const
bool hasMetaData (std::string_view key) const
 MetaDataOwner (const MetaDataOwner &rhs)=default
 MetaDataOwner (MetaDataOwner &rhs)=default
MetaDataOwner & operator= (const MetaDataOwner &rhs)=default
MetaDataOwner & operator= (MetaDataOwner &)=default
void serialize (Serializer &s) const
template<typename T, typename U>
requires std::derived_from<T, MetaData> && Settable<T, U>
void setMetaData (std::string_view key, U value)
template<typename T>
requires std::derived_from<T, MetaData>
bool unsetMetaData (std::string_view key)
 unset, i.e. remove the metadata entry matching the given key and type
Public Member Functions inherited from inviwo::PropertyOwner
template<typename... Ts>
void addProperties (Ts &... properties)
void addProperty (Property &property)
void addProperty (Property *property, bool owner=true)
PropertyaddProperty (std::unique_ptr< Property > property)
iterator begin ()
const_iterator begin () const
const_iterator cbegin () const
const_iterator cend () const
virtual void clear ()
 Remove all properties; Owned properties will be deleted.
bool empty () const
iterator end ()
const_iterator end () const
const_iterator find (Property *property) const
const std::vector< CompositeProperty * > & getCompositeProperties () const
InvalidationLevel getInvalidationLevel () const
const std::vector< Property * > & getProperties () const
template<class T>
std::vector< T * > getPropertiesByType (bool recursiveSearch=false) const
std::vector< Property * > getPropertiesRecursive () const
std::vector< Property * > & getPropertiesRecursive (std::vector< Property * > &destination) const
template<std::derived_from< Property > T = Property>
T * getProperty (std::string_view identifier)
PropertygetPropertyByIdentifier (std::string_view identifier, bool recursiveSearch=false) const
PropertygetPropertyByPath (std::string_view path) const
void insertProperty (size_t index, Property &property)
 insert property property at position index If index is not valid, the property is appended.
virtual void insertProperty (size_t index, Property *property, bool owner=true)
 insert property property at position index If index is not valid, the property is appended.
PropertyinsertProperty (size_t index, std::unique_ptr< Property > property)
 insert property property at position index If index is not valid, the property is appended.
virtual bool isValid () const
virtual bool move (Property *property, size_t newIndex)
PropertyOwner & operator= (const PropertyOwner &that)=delete
Propertyoperator[] (size_t)
const Propertyoperator[] (size_t) const
virtual PropertyremoveProperty (iterator it)
PropertyremoveProperty (Property &property)
PropertyremoveProperty (Property *property)
PropertyremoveProperty (size_t index)
 remove property referred to by index
PropertyremoveProperty (std::string_view identifier)
virtual void resetAllProperties ()
virtual void setAllPropertiesCurrentStateAsDefault ()
size_t size () const
virtual ~PropertyOwner ()
 Removes all properties and notifies its observers of the removal.
Public Member Functions inherited from inviwo::PropertyOwnerObservable
void notifyObserversDidAddProperty (Property *property, size_t index)
void notifyObserversDidRemoveProperty (PropertyOwner *owner, Property *property, size_t index)
void notifyObserversWillAddProperty (PropertyOwner *owner, Property *property, size_t index)
void notifyObserversWillRemoveProperty (Property *property, size_t index)
Public Member Functions inherited from inviwo::Observable< PropertyOwnerObserver >
void addObserver (PropertyOwnerObserver *observer)
bool isObservedBy (PropertyOwnerObserver *observer) const
Observable< PropertyOwnerObserver > & operator= (const Observable< PropertyOwnerObserver > &other)
void removeObserver (PropertyOwnerObserver *observer)
virtual void startBlockingNotifications () override final
virtual void stopBlockingNotifications () override final
Public Member Functions inherited from inviwo::Observable< CompositePropertyObserver >
void addObserver (CompositePropertyObserver *observer)
bool isObservedBy (CompositePropertyObserver *observer) const
Observable< CompositePropertyObserver > & operator= (const Observable< CompositePropertyObserver > &other)
void removeObserver (CompositePropertyObserver *observer)
virtual void startBlockingNotifications () override final
virtual void stopBlockingNotifications () override final

Public Attributes

FloatRefProperty aspectRatio_
FloatRefProperty farPlane_
FloatVec3RefProperty lookFrom_
FloatVec3RefProperty lookTo_
FloatVec3RefProperty lookUp_
FloatRefProperty nearPlane_

Static Public Attributes

static constexpr std::string_view classIdentifier {"org.inviwo.CameraProperty"}
Static Public Attributes inherited from inviwo::CompositeProperty
static constexpr std::string_view classIdentifier {"org.inviwo.CompositeProperty"}

Additional Inherited Members

Static Public Member Functions inherited from inviwo::Property
template<typename T, typename U>
static void setStateAsDefault (T &property, const U &state)
Protected Member Functions inherited from inviwo::Property
void notifyAboutChange ()
Property & operator= (const Property &that)=delete
Property & operator= (Property &&that)
 Property (const Property &rhs)
 Property (Property &&rhs)
Protected Member Functions inherited from inviwo::PropertyObservable
void notifyObserversOnSetDisplayName (Property *property, const std::string &displayName)
void notifyObserversOnSetIdentifier (Property *property, const std::string &identifier)
void notifyObserversOnSetReadOnly (Property *property, bool readonly)
void notifyObserversOnSetSemantics (Property *property, const PropertySemantics &semantics)
void notifyObserversOnSetVisible (Property *property, bool visible)
Protected Member Functions inherited from inviwo::Observable< PropertyObserver >
void forEachObserver (C callback)
Protected Member Functions inherited from inviwo::ObservableInterface
void addObservationHelper (Observer *observer)
virtual void addObserver (Observer *observer)=0
void removeObservationHelper (Observer *observer)
virtual void removeObserver (Observer *observer)=0
Protected Member Functions inherited from inviwo::PropertyOwner
void forEachProperty (std::function< void(Property &)> callback, bool recursiveSearch=false) const
PropertyOwner & operator= (PropertyOwner &&that)
 PropertyOwner (const PropertyOwner &rhs)
 PropertyOwner (PropertyOwner &&rhs)
Protected Member Functions inherited from inviwo::Observable< PropertyOwnerObserver >
void forEachObserver (C callback)
Protected Member Functions inherited from inviwo::CompositePropertyObservable
void notifyObserversOnSetCollapsed (bool collapsed)
Protected Member Functions inherited from inviwo::Observable< CompositePropertyObserver >
void forEachObserver (C callback)
Protected Attributes inherited from inviwo::Property
CallBackList onChangeCallback_
PropertySerializationMode serializationMode_
Protected Attributes inherited from inviwo::MetaDataOwner
MetaDataMap metaData_
Protected Attributes inherited from inviwo::PropertyOwner
std::vector< CompositeProperty * > compositeProperties_
std::vector< EventProperty * > eventProperties_
std::vector< std::unique_ptr< Property > > ownedProperties_
std::vector< Property * > properties_

Detailed Description

A property wrapping the Camera data structure

See also
Camera

Member Function Documentation

◆ clone()

virtual CameraProperty * inviwo::CameraProperty::clone ( ) const
overridevirtual

Creates a clone of this property. The clone will have the same identifier, hence the identifier must be changed if the clone should be added to the same owner as this. The new clone does not have any owner set.

Reimplemented from inviwo::CompositeProperty.

◆ deserialize()

virtual void inviwo::CameraProperty::deserialize ( Deserializer & d)
overridevirtual

Reimplemented from inviwo::CompositeProperty.

◆ fitData()

void inviwo::CameraProperty::fitData ( )

Fit the current bounding box into view, keeping the view direction If updateNearFar is set it will also adjust near and far. If updateLookRanges is set it will also adjust the range of look from

See also
camerautil::setCameraView
Precondition
There must be a bounding box set

◆ flipUp()

void inviwo::CameraProperty::flipUp ( )

Flip the direction of the up vector

◆ getClassIdentifier()

virtual std::string_view inviwo::CameraProperty::getClassIdentifier ( ) const
overridevirtual

Reimplemented from inviwo::CompositeProperty.

◆ getClipPosFromNormalizedDeviceCoords()

vec4 inviwo::CameraProperty::getClipPosFromNormalizedDeviceCoords ( const vec3 & ndcCoords) const

Convert from normalized device coordinates (xyz in [-1 1]) to clip coordinates.

Parameters
ndcCoordsxyz clip-coordinates in [-1 1]^3, and the clip w-coordinate used for perspective division.
Returns
Clip space position

◆ getFarPlaneDist()

virtual float inviwo::CameraProperty::getFarPlaneDist ( ) const
overridevirtual

◆ getLookFrom()

virtual vec3 inviwo::CameraProperty::getLookFrom ( ) const
overridevirtual

◆ getLookFromMaxValue()

virtual vec3 inviwo::CameraProperty::getLookFromMaxValue ( ) const
overridevirtual

◆ getLookFromMinValue()

virtual vec3 inviwo::CameraProperty::getLookFromMinValue ( ) const
overridevirtual

◆ getLookTo()

virtual vec3 inviwo::CameraProperty::getLookTo ( ) const
overridevirtual

◆ getLookToMaxValue()

virtual vec3 inviwo::CameraProperty::getLookToMaxValue ( ) const
overridevirtual

◆ getLookToMinValue()

virtual vec3 inviwo::CameraProperty::getLookToMinValue ( ) const
overridevirtual

◆ getLookUp()

virtual vec3 inviwo::CameraProperty::getLookUp ( ) const
overridevirtual

◆ getNearPlaneDist()

virtual float inviwo::CameraProperty::getNearPlaneDist ( ) const
overridevirtual

◆ getNormalizedDeviceFromNormalizedScreenAtFocusPointDepth()

virtual vec3 inviwo::CameraProperty::getNormalizedDeviceFromNormalizedScreenAtFocusPointDepth ( const vec2 & normalizedScreenCoord) const
overridevirtual

◆ getWorldPosFromNormalizedDeviceCoords()

virtual vec3 inviwo::CameraProperty::getWorldPosFromNormalizedDeviceCoords ( const vec3 & ndcCoords) const
overridevirtual

Convert from normalized device coordinates (xyz in [-1 1]) to world coordinates.

Parameters
ndcCoordsCoordinates in [-1 1]
Returns
World space position

Implements inviwo::TrackballObject.

◆ invokeEvent()

void inviwo::CameraProperty::invokeEvent ( Event * event)
overridevirtual

Reimplemented from inviwo::PropertyOwner.

◆ isDefaultState()

virtual bool inviwo::CameraProperty::isDefaultState ( ) const
overridevirtual

Check if the property is in it's default state, i.e. resetToDefaultState would do nothing

See also
setCurrentStateAsDefault
resetToDefaultState

Reimplemented from inviwo::CompositeProperty.

◆ needsSerialization()

virtual bool inviwo::CameraProperty::needsSerialization ( ) const
overridevirtual

Determinate if the property should be included in the serialization Depends on the PropertySerializationMode and if the property is in the default state. If the mode is All it always return true, None always returns false, and default delegates to isDefaultState()

Reimplemented from inviwo::CompositeProperty.

◆ resetToDefaultState()

virtual CameraProperty & inviwo::CameraProperty::resetToDefaultState ( )
overridevirtual

Reset the state of the property back to it's default value. It is important that all overriding properties make sure to call the base class implementation.

Reimplemented from inviwo::CompositeProperty.

◆ serialize()

virtual void inviwo::CameraProperty::serialize ( Serializer & s) const
overridevirtual

Reimplemented from inviwo::CompositeProperty.

◆ set()

virtual void inviwo::CameraProperty::set ( const Property * src)
overridevirtual

Set the value of this to that of src. The "value" is in this case considered to be for example the string in a StringProperty or the float value in a FloatProperty. But not things like the identifier of display name.

Reimplemented from inviwo::CompositeProperty.

◆ setCurrentStateAsDefault()

virtual CameraProperty & inviwo::CameraProperty::setCurrentStateAsDefault ( )
overridevirtual

Save the current state of the property as the default. This state will then be used as a reference when serializing, only state different from the default will be serialized. This method should usually only be called once directly after construction in the processor constructor after setting property specific state. It is important that all overriding properties make sure to call the base class implementation.

Reimplemented from inviwo::CompositeProperty.

◆ setLook()

virtual TrackballObject & inviwo::CameraProperty::setLook ( vec3 lookFrom,
vec3 lookTo,
vec3 lookUp )
overridevirtual

Sets given camera properties while respecting their min/max ranges. Locks and unlocks processor network before and after changing property values.

Note
Parameters will be capped by their min/max.

Implements inviwo::TrackballObject.

◆ setLookFrom()

virtual TrackballObject & inviwo::CameraProperty::setLookFrom ( vec3 lookFrom)
overridevirtual

◆ setLookRange()

void inviwo::CameraProperty::setLookRange ( )

Adjust the look from ranges for the current bounding box

Precondition
There must be a bounding box set

◆ setLookTo()

virtual TrackballObject & inviwo::CameraProperty::setLookTo ( vec3 lookTo)
overridevirtual

◆ setLookUp()

virtual TrackballObject & inviwo::CameraProperty::setLookUp ( vec3 lookUp)
overridevirtual

◆ setNearFar()

void inviwo::CameraProperty::setNearFar ( )

Adjust the near and far values for the current bounding box

Precondition
There must be a bounding box set

◆ setNearFarPlaneDist()

CameraProperty & inviwo::CameraProperty::setNearFarPlaneDist ( float nearPlaneDist,
float farPlaneDist,
float minMaxRatio = 10.f )

Set near and far plane distance values and adjust their min/max ranges. Adjusts the min/max ranges of the properties to e.g. 0.1/10 times the given value. Locks and unlocks processor network before and after changing property values.

◆ setView()

void inviwo::CameraProperty::setView ( camerautil::Side side)

Fit the current bounding box into view and set the view direction to the specified side If updateNearFar is set it will also adjust near and far. If updateLookRanges is set it will also adjust the range of look from

See also
camerautil::setCameraView
Precondition
There must be a bounding box set

◆ zoom()

virtual void inviwo::CameraProperty::zoom ( const ZoomOptions & opts)
overridevirtual

The documentation for this class was generated from the following file:
  • include/inviwo/core/properties/cameraproperty.h