/usr/include/collada-dom2.4/dae/daeMetaCMPolicy.h is in libcollada-dom2.4-dp-dev 2.4.4+ds1-2build3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 | /*
* Copyright 2006 Sony Computer Entertainment Inc.
*
* Licensed under the MIT Open Source License, for details please see license.txt or the website
* http://www.opensource.org/licenses/mit-license.php
*
*/
#ifndef __DAE_META_CM_POLICY_H__
#define __DAE_META_CM_POLICY_H__
#include <dae/daeTypes.h>
#include <dae/daeElement.h>
//class daeElement;
class daeMetaElement;
/**
* The daeMetaCMPolicy class is the base class for the content model policy classes which are used to
* describe the availability and ordering of an element's children.
*/
class daeMetaCMPolicy
{
public:
/**
* Places an element into the parent element based on this content model policy object.
* @param parent The parent element for which the child element will be placed.
* @param child The new child element.
* @param ordinal A reference to a daeUInt which holds the ordinal return value for a placed child. Used
* to maintain proper ording of child elements.
* @param offset The offset to used when attempting to place this element. Affects comparison against
* minOccurs and maxOccurs.
* @param before The element that the child should appear before. Optional.
* @param after The element that the child should appear after. Optional.
* @return Returns The child element that was placed within this content model object or any of its
* children. NULL if placement failed.
*/
virtual daeElement *placeElement( daeElement *parent, daeElement *child, daeUInt &ordinal, daeInt offset = 0, daeElement* before = NULL, daeElement *after = NULL ) = 0;
/**
* Removes an element from the parent based on this content model object.
* @param parent The parent element for which child you want to remove.
* @param child The child that will be removed from the parent.
* @return Returns true if the child was successfully removed from this content model object or any of
* its children. False otherwise.
*/
virtual daeBool removeElement(daeElement* parent, daeElement* child ) = 0;
/**
* Gets the daeMetaElement of an acceptable child of this content model object.
* @param elementName The name of the element whos metaElement information you are interested in.
* @return Returns a pointer to a daeMetaElement class that describes the element interested in.
* Returns NULL if the element is not valid in this content model.
*/
virtual daeMetaElement *findChild( daeString elementName ) = 0;
/**
* Populates an array with the children of parent based on this content model object.
* @param parent The parent element whos children you want.
* @param array The array where you the children will be appended to.
*/
virtual void getChildren( daeElement* parent, daeElementRefArray &array ) = 0;
/**
* Adds a child to this content model object.
* @param p The child content model policy object.
*/
void appendChild( daeMetaCMPolicy *p ) { _children.append( p ); }
/**
* Gets the parent of this content model policy object.
* @return Returns a pointer to the parent node.
*/
daeMetaCMPolicy *getParent() { return _parent; }
/**
* Sets the maximum ordinal value of this policy objects children. Used to keep proper ordering for
* cm objects that may appear multiple times.
* @param ord The maximum ordinal value for this content model object.
*/
void setMaxOrdinal( daeUInt ord ) { _maxOrdinal = ord; }
protected:
/**
* Constructor.
* @param container The daeMetaElement that this policy object belongs to.
* @param parent The daeMetaCMPolicy parent of this policy object.
* @param odinal The ordinal value offset of this specific policy object. Used for maintaining the
* correct order of child elements.
* @param minO The minimum number of times this CMPolicy object must appear. This value comes from the COLLADA schema.
* @param maxO The maximum number of times this CMPolicy object may appear. This value comes from the COLLADA schema.
*/
daeMetaCMPolicy( daeMetaElement *container ,daeMetaCMPolicy *parent, daeUInt ordinal,
daeInt minO, daeInt maxO ) : _container( container ), _parent( parent ), _minOccurs( minO ),
_maxOccurs( maxO ), _maxOrdinal( 0 ), _ordinalOffset( ordinal ) {}
public:
/**
* Destructor.
*/
virtual ~daeMetaCMPolicy();
protected:
daeMetaElement * _container;
daeMetaCMPolicy * _parent;
daeTArray<daeMetaCMPolicy*> _children;
/** Minimum number of times this meta element can occur. */
daeInt _minOccurs;
/** Maximum number of times this meta element can occur. -1 for unbounded */
daeInt _maxOccurs;
daeUInt _maxOrdinal;
daeUInt _ordinalOffset;
};
#endif
|