Program Listing for File Frame.h

↰ Return to documentation for file (include/Karana/Frame/Frame.h)

/*
*Copyright(c)2024-2025KaranaDynamicsPtyLtd.Allrightsreserved.
*
*NOTICETOUSER:
*
*Thissourcecodeand/ordocumentation(the"LicensedMaterials")is
*theconfidentialandproprietaryinformationofKaranaDynamicsInc.
*UseoftheseLicensedMaterialsisgovernedbythetermsandconditions
*ofaseparatesoftwarelicenseagreementbetweenKaranaDynamicsandthe
*Licensee("LicenseAgreement").Unlessexpresslypermittedunderthat
*agreement,anyreproduction,modification,distribution,ordisclosure
*oftheLicensedMaterials,inwholeorinpart,toanythirdparty
*withoutthepriorwrittenconsentofKaranaDynamicsisstrictlyprohibited.
*
*THELICENSEDMATERIALSAREPROVIDED"ASIS"WITHOUTWARRANTYOFANYKIND.
*KARANADYNAMICSDISCLAIMSALLWARRANTIES,EXPRESSORIMPLIED,INCLUDING
*BUTNOTLIMITEDTOWARRANTIESOFMERCHANTABILITY,NON-INFRINGEMENT,AND
*FITNESSFORAPARTICULARPURPOSE.
*
*INNOEVENTSHALLKARANADYNAMICSBELIABLEFORANYDAMAGESWHATSOEVER,
*INCLUDINGBUTNOTLIMITEDTOLOSSOFPROFITS,DATA,ORUSE,EVENIF
*ADVISEDOFTHEPOSSIBILITYOFSUCHDAMAGES,WHETHERINCONTRACT,TORT,
*OROTHERWISEARISINGOUTOFORINCONNECTIONWITHTHELICENSEDMATERIALS.
*
*U.S.GovernmentEndUsers:TheLicensedMaterialsarea"commercialitem"
*asdefinedat48C.F.R.2.101,andareprovidedtotheU.S.Government
*onlyasacommercialenditemunderthetermsofthislicense.
*
*AnyuseoftheLicensedMaterialsinindividualorcommercialsoftwaremust
*include,intheuserdocumentationandinternalsourcecodecomments,
*thisNotice,Disclaimer,andU.S.GovernmentUseProvision.
*/


#pragmaonce

#include"Karana/KCore/LockingBase.h"
#include"Karana/KCore/RegistryList.h"
#include"Karana/Math/Defs.h"
#include<memory>
#include<string>
#include<vector>

namespaceKarana::Frame{

namespacekc=Karana::Core;
namespacekm=Karana::Math;

classFrameContainer;
classEdgeFrame2Frame;
classChainedFrame2Frame;
classOrientedChainedFrame2Frame;

classFrame:publickc::Base{
friendFrameContainer;
//Foraccessto_edgeand_children
friendEdgeFrame2Frame;

public:
statickc::ks_ptr<Frame>create(std::string_viewname,kc::ks_ptr<FrameContainer>fc);

voiddiscard(kc::ks_ptr<Frame>&frame);

virtual~Frame();

virtualconststd::string&typeString()constnoexceptoverride;

//conststd::string&name()constnoexcept;

constkc::ks_ptr<Frame>&parent()const;

constkc::ks_ptr<EdgeFrame2Frame>&edge()const;

//std::iterator<kc::ks_ptr<Frame>>childIterator();

FrameContainer&container()const;

constkc::ks_ptr<FrameContainer>&containerPtr()const;

constkc::ks_ptr<ChainedFrame2Frame>&frame2Frame(constkc::ks_ptr<Frame>&frame)const;

constkc::ks_ptr<ChainedFrame2Frame>&frame2FrameRef(constFrame&frame)const;

constkc::ks_ptr<OrientedChainedFrame2Frame>&
orientedFrame2Frame(constkc::ks_ptr<Frame>&frame)const;

constkc::ks_ptr<OrientedChainedFrame2Frame>&
orientedFrame2FrameRef(constFrame&frame)const;

boolisAncestorOf(constFrame&other,boolstrict)const;

constkc::ks_ptr<Frame>&getAncestor(constFrame&other)const;

//FIXME:makeprotectedandmarkallocatorfunctionusedbyFrameContainerasfriend
public:
Frame(std::string_viewname,kc::ks_ptr<FrameContainer>frame_container);

std::stringdumpString(conststd::string&prefix="",
constBase::dumpOptions*options=nullptr)constoverride;

structdumpFrameTreeOptions{
booltypeString=true;
booledgeType=false;
boollockStatus=false;
boolrefCount=false;
booledgeRefCount=false;
boolid=false;
};

voiddumpFrameTree(conststd::string&prefix="",
constdumpFrameTreeOptionsoptions=
dumpFrameTreeOptions(true,false,false,false,false,false))const;

protected:
void_discard(kc::ks_ptr<Base>&base)override;

private:
//FrameContainer*_frame_container;///<Pointertotheframecontainer.
kc::ks_ptr<FrameContainer>_frame_container;
kc::ks_ptr<EdgeFrame2Frame>_edge;
kc::RegistryList<Frame>_children;
};
}//namespaceKarana::Frame