#pragma once #import "DYModel.h" #include "MaskCore/DYMaskOperator.h" enum { DYToolsParameterID=9002, DYCanvasSessionParameterID=9003, DYToolLimit=32, DYToolMaskLimit=16, DYToolKeyLimit=16384, DYSharedMaskLimit=64 }; // Immutable property-list author state. Host float IDs and the legacy ABI stay fixed. @interface DYToolDocument : NSObject @property(nonatomic,copy) NSDictionary *document; @end NSArray *DYToolTypes(void); NSArray *DYBaseToolDescriptors(NSString *type); BOOL DYBaseToolRemoved(NSDictionary *document,NSString *type); BOOL DYSetBaseToolRemoved(NSMutableDictionary *document,NSString *type,BOOL removed); void DYApplyRemovedBaseTools(DYUniforms *uniforms,NSDictionary *document); NSDictionary *DYVisibleBaseToolPaths(NSDictionary *paths,NSDictionary *document); BOOL DYResetToolParameters(id host,NSArray *descriptors,CMTime time,NSError **error); NSDictionary *DYToolSection(NSString *type); NSDictionary *DYNewTool(NSString *type); // New documents splice a UUID after the clicked base/extra tool. Schema 1 // layers without an anchor retain their historical end-of-chain semantics. NSDictionary *DYInsertTool(NSMutableDictionary *document,NSString *type,NSString *afterID); BOOL DYRemoveTool(NSMutableDictionary *document,NSString *nodeID); NSArray *DYToolDisplayOrder(NSDictionary *document); NSString *DYToolRootAnchor(NSDictionary *document,NSString *nodeID); NSDictionary *DYNewMask(NSInteger kind); BOOL DYValidToolDocument(NSDictionary *document); BOOL DYValidToolMask(NSDictionary *mask); NSMutableDictionary *DYMutablePlist(NSDictionary *value); DYToolDocument *DYReadTools(id manager,CMTime time); BOOL DYWriteTools(id manager,NSDictionary *document,CMTime time); NSArray *DYMasksForTool(NSDictionary *document,NSString *nodeID); NSDictionary *DYToolWithID(NSDictionary *document,NSString *nodeID); BOOL DYSetToolMasks(NSMutableDictionary *document,NSString *nodeID,NSArray *masks); // Schema 3 owns each shared mask once. Tool arrays store {sharedID: UUID}; // nodeID "shared" selects the library even before any tool is assigned. NSArray *DYSharedMasks(NSDictionary *document); NSDictionary *DYSharedMaskWithID(NSDictionary *document,NSString *maskID); NSDictionary *DYAddSharedMask(NSMutableDictionary *document,NSInteger kind); BOOL DYSetSharedMaskAssigned(NSMutableDictionary *document,NSString *maskID,NSString *nodeID,BOOL assigned); NSArray *DYToolIDsForSharedMask(NSDictionary *document,NSString *maskID); BOOL DYRemoveSharedMask(NSMutableDictionary *document,NSString *maskID); NSDictionary *DYShareToolMask(NSMutableDictionary *document,NSString *nodeID,NSString *maskID); // Disposable render document. References become stable per-binding UUIDs; // editing must always use the original author document, never this expansion. NSDictionary *DYResolvedToolDocument(NSDictionary *document); DYMaskParameters DYMaskAtTime(NSDictionary *mask,CMTime time); NSDictionary *DYMaskKey(CMTime time,DYMaskParameters parameters,BOOL manual,float confidence); struct DYStampMotion { float sourceOffsetX=0,sourceOffsetY=0; float sourceScaleX=1,sourceScaleY=1,targetScaleX=1,targetScaleY=1; bool active=false; }; DYStampMotion DYStampMotionAtTime(NSDictionary *stamp,CMTime time); NSArray *DYStampSourceAtTime(NSDictionary *stamp,CMTime time); NSArray *DYStampSamplingScaleAtTime(NSDictionary *stamp,CMTime time); NSDictionary *DYStampKey(CMTime time,DYMaskParameters parameters,BOOL manual,float confidence,DYStampMotion motion); BOOL DYMergeTracking(NSMutableDictionary *mask,NSArray *samples); NSDictionary *DYToolRenderSnapshot(NSDictionary *document,CMTime time); DYUniforms DYToolUniforms(NSDictionary *node); BOOL DYToolIsNeutral(NSDictionary *node); // Routes an existing native panel to a UUID, batching edits into one host write. @interface DYToolManager : NSObject @property(nonatomic,readonly) id host; @property(nonatomic,readonly) NSString *nodeID,*type; - (instancetype)initWithHost:(id)host node:(NSDictionary *)node; @end