VisioMove SDK (iOS)  2.1.22
Vg3DModule::VgPointDescriptor Struct Reference
Inheritance diagram for Vg3DModule::VgPointDescriptor:
Inheritance graph

Public Types

typedef VgPoint Described
 

Static Public Member Functions

static VgEngine::VgRefPtr< Vg3DModule::VgPointDescriptorcreate ()
 
static VgEngine::VgRefPtr< Vg3DModule::VgPointDescriptorcreate (VgEngine::VgRefPtr< Vg3DModule::VgPointDescriptor >const &pOther)
 

Public Attributes

VgEngine::VgPosition mPosition
 
VgEngine::VgAltitudeMode mAltitudeMode
 
VgEngine::VgAnchorMode mAnchorPosition
 
float mGeometryConstantSizeDistance
 
float mHeading
 
float mPitch
 
float mRoll
 
bool mForceFrontFace
 
VgEngine::VgOrientationType mHeadingOrientationType
 
VgEngine::VgOrientationType mPitchOrientationType
 
VgEngine::VgOrientationType mRollOrientationType
 
std::vector< VgEngine::VgRefPtr< VgMarkerDescriptor > > mMarkerDescriptors
 
std::string mID
 
VgEngine::VgSizePolicy mSizePolicy
 
float mRectangleWidth
 
float mRectangleHeight
 
- Public Attributes inherited from Vg3DModule::VgGeometryDescriptor
double mVisibilityRampStartVisible
 
double mVisibilityRampFullyVisible
 
double mVisibilityRampStartInvisible
 
double mVisibilityRampFullyInvisible
 
int mZIndex
 
bool mDrawOnTop
 
float mScale
 
bool mNotifyPOISelectedOnClick
 

Protected Member Functions

 VgPointDescriptor ()
 
 VgPointDescriptor (const VgPointDescriptor &pDescriptor)
 
virtual ~VgPointDescriptor ()
 
- Protected Member Functions inherited from Vg3DModule::VgGeometryDescriptor
 VgGeometryDescriptor ()
 
virtual ~VgGeometryDescriptor ()
 

Friends

template<typename >
class VgEngine::VgRefPtr
 

Additional Inherited Members

- Public Member Functions inherited from VgEngine::VgReferenced
 VgReferenced ()
 
 VgReferenced (const VgReferenced &pThis)
 
virtual ~VgReferenced ()
 
VgReferencedoperator= (const VgReferenced &pThis)
 
void ref () const
 
int unref () const
 
int getNbReferences () const
 
- Protected Attributes inherited from VgEngine::VgReferenced
int mNbReferences
 

Detailed Description

This structure encapsulates the point description parameters.

The VgPointDescriptor contains the all the attributes that are useful for describing the behaviour of a VgPoint object.

Below is a code snippet showing how an allocated VgPointDescriptor can be configured:

...
Vg3DModule::VgIconMarkerDescriptor lIconMarkerDesc;
...
// Allocate a VgPointDescriptor object
Vg3DModule::VgPointDescriptor lPointDesc;
// Configure the object
//
// Set the point's position anchor.
// Set the points position
lPointDesc.mPosition = lPos;
// Associate the marker with VgPointDescriptor.
// Note: It's possible to associate several markers with a single point.
lPointDesc.mMarkerDescriptors.push_back(&lIconMarkerDesc);
...
Version
2.0

Member Typedef Documentation

Constructor & Destructor Documentation

Vg3DModule::VgPointDescriptor::VgPointDescriptor ( )
inlineprotected

Constructor.

Vg3DModule::VgPointDescriptor::VgPointDescriptor ( const VgPointDescriptor pDescriptor)
inlineprotected

Copy Constructor.

virtual Vg3DModule::VgPointDescriptor::~VgPointDescriptor ( )
protectedvirtual

Destructor.

Member Function Documentation

static VgEngine::VgRefPtr< Vg3DModule::VgPointDescriptor > Vg3DModule::VgPointDescriptor::create ( )
static

This static method returns a new heap-allocated descriptor. It is the only method that should be used to instantiate new descriptors. It is a way to make sure no one will delete it, except the last VgRefPtr pointing to it.

static VgEngine::VgRefPtr< Vg3DModule::VgPointDescriptor > Vg3DModule::VgPointDescriptor::create ( VgEngine::VgRefPtr< Vg3DModule::VgPointDescriptor >const &  pOther)
static

This static method returns a new heap-allocated descriptor. It is the only method that should be used to instantiate new descriptors. It is a way to make sure no one will delete it, except the last VgRefPtr pointing to it.

Friends And Related Function Documentation

template<typename >
friend class VgEngine::VgRefPtr
friend

Member Data Documentation

VgEngine::VgAltitudeMode Vg3DModule::VgPointDescriptor::mAltitudeMode

The altitude mode tells how to interpret the VgPointDescriptor::mPosition::mZOrAltitude member. Default is eAbsolute.

VgEngine::VgAnchorMode Vg3DModule::VgPointDescriptor::mAnchorPosition

Controls the anchoring of the point's bounding box with its position. Default is VgEngine::eVgBottomCenter.

Version
1.1.6796
bool Vg3DModule::VgPointDescriptor::mForceFrontFace

In cases where the camera can view the poi from behind, our engine will not display the label. For example this will happen if the VgPoint has a fixed orientation (it will not happen if it is always camera facing). Default value is false. Setting this to true will allow to view fixed VgPoints from behind.

float Vg3DModule::VgPointDescriptor::mGeometryConstantSizeDistance

Controls the distance at which the VgPoint does not become bigger as you approach it. When the camera is within this distance of the VgPoint, the visible size of the VgPoint on the screen will be the same as what it looked like when it was mGeometryConstantSizeDistance meters away. If set to 0.0, the size of the POI will be determined by mScale, regardless of it's distance from the camera.

Version
2.0.9263
2.1.0 default value changed to 0.0 from 700.0
Remarks
on version 2.1.0 the default value was changed from 700.0 to 0, thus all VgPoints will not have their scale clamped.
float Vg3DModule::VgPointDescriptor::mHeading

Controls the scale of the VgPoint when viewed from a distance equal to mGeometryConstantSizeDistance. The default value of this property is 1.0.

Version
2.0.9263
Deprecated:
2.1.0, use mScale instead, it will have the same effect float mGeometryConstantSizeMaxScale;

Controls the heading of the VgPoint. Default value is 0.0.

Note
This value is only used if VgPointDescriptor::mHeadingOrientationType takes into account heading.
VgEngine::VgOrientationType Vg3DModule::VgPointDescriptor::mHeadingOrientationType

Controls the orientation type of the Heading. By default is eVgOrientationCameraFacing.

std::string Vg3DModule::VgPointDescriptor::mID

The Point's identifier. Default value is empty string ("").

Version
2.0.9334
2.1.3 Changed default to be empty string.
See also
VgEngine::VgQuery
std::vector< VgEngine::VgRefPtr< VgMarkerDescriptor > > Vg3DModule::VgPointDescriptor::mMarkerDescriptors

A vector of VgMarkerDescriptors which determine what markers and how many of them are associated with this VgPoint. See Vg3DModule::VgMarkerType for a list of available markers.

Note
It is the responsability of the caller to release the VgMarkerDescriptor objects.
Version
2.0
float Vg3DModule::VgPointDescriptor::mPitch

Controls the pitch of the VgPoint. The valid range is between -90.0 and 90.0. A value of 0, means the VgPoint is facing the horizon. Default value is 0.0.

Note
This value is only used if VgPointDescriptor::mPitchOrientationType takes into account pitch.
VgEngine::VgOrientationType Vg3DModule::VgPointDescriptor::mPitchOrientationType

Controls the orientation type of the Heading. By default is eVgOrientationCameraFacing.

VgEngine::VgPosition Vg3DModule::VgPointDescriptor::mPosition

The point's position.

float Vg3DModule::VgPointDescriptor::mRectangleHeight

Rectangle Height. Only useful if mSizePolicy is equal to VgEngine::eVgSizePolicyFitRectangle. Default value is -1.

Version
2.1.0
float Vg3DModule::VgPointDescriptor::mRectangleWidth

Rectangle Width. Only useful if mSizePolicy is equal to VgEngine::eVgSizePolicyFitRectangle. Default value is -1.

Version
2.1.0
float Vg3DModule::VgPointDescriptor::mRoll

Controls the roll of the VgPoint. The valid range is between -90.0 and 90.0. A value of 0, means the VgPoint is straight. Default value is 0.0.

Note
This value is only used if VgPointDescriptor::mRollOrientationType takes into account roll.
VgEngine::VgOrientationType Vg3DModule::VgPointDescriptor::mRollOrientationType

Controls the orientation type of the Roll. By default is eVgOrientationFixedModulo180degrees.

VgEngine::VgSizePolicy Vg3DModule::VgPointDescriptor::mSizePolicy

Size Policy, it Markers should have a constant scale, or be rescaled to fit inside a rectangle, this is most interesting for VgTextMarkers to make sure they stay within a certain region.

Version
2.1.0

The documentation for this struct was generated from the following file:
VisioMove 2.1.22, Visioglobe® 2016