XMLTypes

type ActivationGroup struct {
	Name string `xml:",attr"`
}

type AnimationSystem struct {
	P1      []float32 `xml:",attr"`
	P2      []float32 `xml:",attr"`
	P3      []float32 `xml:",attr"`
	Radiues float32   `xml:",attr"`
}

type ArtNet struct {
	Maps []Map `xml:"Map"`
}

type Attribute struct {
	Name             string            `xml:",attr"`
	Pretty           string            `xml:",attr"`
	ActivationGroup  XMLNodeReference  `xml:",attr"` // ActivationGroup
	Feature          XMLNodeReference  `xml:",attr"` // Feature
	MainAttribute    XMLNodeReference  `xml:",attr"` // Attribute
	PhysicalUnit     string            `xml:",attr"`
	Color            ColorCIE          `xml:",attr"`
	SubPhysicalUnits []SubPhysicalUnit `xml:"SubPhysicalUnits"`
}

type AttributeDefinitions struct {
	ActivationGroups []ActivationGroup `xml:"ActivationGroups>ActivationGroup"`
	FeatureGroups    []FeatureGroup    `xml:"FeatureGroups>FeatureGroup"`
	Attributes       []Attribute       `xml:"Attributes>Attribute"`
}

type Axis struct {
	Name     string `xml:",attr"`
	Model    string `xml:",attr"`
	Position Matrix `xml:",attr"`
	Geometries
}

type Beam struct {
	Name             string           `xml:",attr"`
	Model            string           `xml:",attr"`
	Position         Matrix           `xml:",attr"`
	LampType         string           `xml:",attr"`
	PowerConsumption float32          `xml:",attr"`
	LuminousFlux     float32          `xml:",attr"`
	ColorTemperature float32          `xml:",attr"`
	BeamAngle        float32          `xml:",attr"`
	FieldAngle       float32          `xml:",attr"`
	ThrowRatio       float32          `xml:",attr"`
	RectangleRatio   float32          `xml:",attr"`
	BeamRadius       float32          `xml:",attr"`
	BeamType         string           `xml:",attr"`
	CRI              uint             `xml:"ColorRenderingIndex,attr"`
	EmitterSpectrum  XMLNodeReference `xml:",attr"`
	Geometries
}

type Break struct {
	DMXOffset DMXAddress `xml:",attr"`
	DMXBreak  uint       `xml:",attr"`
}

type CITP struct {
}

type CRI struct {
	CES string `xml:",attr"`
	CRI uint   `xml:",attr"`
}

type CRIGroup struct {
	ColorTemperature float32 `xml:",attr"`
	CRIs             *[]CRI  `xml:"CRI"`
}

type ChannelFunction struct {
	Name              string           `xml:",attr"`
	Attribute         XMLNodeReference `xml:",attr"`
	OriginalAttribute string           `xml:",attr"`
	DMXFrom           XMLDMXValue      `xml:",attr"`
	Default           XMLDMXValue      `xml:",attr"`
	PhysicalFrom      float32          `xml:",attr"`
	PhysicalTo        float32          `xml:",attr"`
	RealFade          float32          `xml:",attr"`
	RealAcceleration  float32          `xml:",attr"`
	Wheel             XMLNodeReference `xml:",attr"`
	Emitter           XMLNodeReference `xml:",attr"`
	Filter            XMLNodeReference `xml:",attr"`
	ColorSpace        XMLNodeReference `xml:",attr"`
	Gamut             XMLNodeReference `xml:",attr"`
	ModeMaster        XMLNodeReference `xml:",attr"`
	ModeFrom          XMLDMXValue      `xml:",attr"`
	ModeTo            XMLDMXValue      `xml:",attr"`
	DMXProfile        XMLNodeReference `xml:",attr"`
	Min               float32          `xml:",attr"` // Fallback to PhysicalFrom if 0.0
	Max               float32          `xml:",attr"` // Fallback to PhysicalTo if 0.0
	CustomName        string           `xml:",attr"` // Default: Node Name of the Channel function Example: Head_Dimmer.Dimmer.Dimmer
	ChannelSets       []ChannelSet     `xml:"ChannelSet"`
	SubChannelSets    []SubChannelSet  `xml:"SubChannelSet"`
}

type ChannelSet struct {
	Name           string      `xml:",attr"`
	DMXFrom        XMLDMXValue `xml:",attr"`
	PhysicalFrom   float32     `xml:",attr"`
	PhysicalTo     float32     `xml:",attr"`
	WheelSlotIndex int         `xml:",attr"`
}

type ColorCIE struct {
	X  float32
	Y  float32
	Y2 float32
}

type ColorSpace struct {
	Name       string   `xml:",attr"`
	Mode       string   `xml:",attr"` //enum + TODO: default data (see https://www.gdtf.eu/gdtf/file-spec/physical-descriptions/#table-20-color-space-attributes)
	Red        ColorCIE `xml:",attr"`
	Green      ColorCIE `xml:",attr"`
	Blue       ColorCIE `xml:",attr"`
	WhitePoint ColorCIE `xml:",attr"`
}

type Connector struct {
	Name     string  `xml:",attr"`
	Type     string  `xml:",attr"`
	DMXBreak uint    `xml:",attr"` // obsolete (see https://www.gdtf.eu/gdtf/file-spec/physical-descriptions/#table-27-connector-attributes)
	Gender   int     `xml:",attr"` // obsolete
	Length   float32 `xml:",attr"` // obsolete
}

type ConvertToDestinationMapStruct[T any] interface {
	ConvertToDestinationStruct[T]
	ParseKey() string
}

type ConvertToDestinationStruct[T any] interface {
	Parse() T
}

type DMXAddress struct {
	Address  int16 // 0 indexed
	Universe int   // 0 indexed
}

type DMXChannel struct {
	DMXBreak        int              `xml:",attr"`
	Offset          IntList          `xml:",attr"`
	InitialFunction XMLNodeReference `xml:",attr"`
	Highlight       XMLDMXValue      `xml:",attr"`
	Geometry        XMLNodeReference `xml:",attr"`
	LogicalChannels []LogicalChannel `xml:"LogicalChannel"`
}

type DMXMode struct {
	Name        string           `xml:",attr"`
	Description string           `xml:",attr"`
	Geometry    XMLNodeReference `xml:",attr"`
	DMXChannels []DMXChannel     `xml:"DMXChannels>DMXChannel"`
	Relations   []Relation       `xml:"Relations>Relation"`
	FTMacros    []FTMacro        `xml:"FTMacros>FTMacro"`
}

type DMXProfile struct {
	Name   string  `xml:",attr"`
	Points []Point `xml:"Point"`
}

type Display struct {
	Name     string        `xml:",attr"`
	Model    string        `xml:",attr"`
	Position Matrix        `xml:",attr"`
	Texture  FileReference `xml:",attr"`
	Geometries
}

type Emitter struct {
	Name               string        `xml:",attr"`
	Color              ColorCIE      `xml:",attr"`
	DominantWaveLength float32       `xml:",attr"`
	DiodePart          string        `xml:",attr"`
	Measurements       []Measurement `xml:"Measurement"`
}

type FTMacro struct {
	Name            string            `xml:",attr"`
	ChannelFunction *XMLNodeReference `xml:",attr"`
	MacroDMXs       []MacroDMX        `xml:"MacroDMX"`
}

type Feature struct {
	Name string `xml:",attr"`
}

type FeatureGroup struct {
	Name     string    `xml:",attr"`
	Pretty   string    `xml:",attr"`
	Features []Feature `xml:"Feature"`
}

type FileReference = string // without extension and without path

type Filter struct {
	Name         string        `xml:",attr"`
	Color        ColorCIE      `xml:",attr"`
	Measurements []Measurement `xml:"Measurement"`
}

type FilterBeam struct {
	Name     string `xml:",attr"`
	Model    string `xml:",attr"`
	Position Matrix `xml:",attr"`
	Geometries
}

type FilterColor struct {
	Name     string `xml:",attr"`
	Model    string `xml:",attr"`
	Position Matrix `xml:",attr"`
	Geometries
}

type FilterGobo struct {
	Name     string `xml:",attr"`
	Model    string `xml:",attr"`
	Position Matrix `xml:",attr"`
	Geometries
}

type FilterShaper struct {
	Name     string `xml:",attr"`
	Model    string `xml:",attr"`
	Position Matrix `xml:",attr"`
	Geometries
}

type FixtureType struct {
	FixtureTypeID    string    `xml:",attr"`
	Name             string    `xml:",attr"`
	ShortName        string    `xml:",attr"`
	LongName         string    `xml:",attr"`
	Manufacturer     string    `xml:",attr"`
	Description      string    `xml:",attr"`
	Thumbnail        string    `xml:",attr"`
	ThumbnailOffsetX int       `xml:",attr"`
	ThumbnailOffsetY int       `xml:",attr"`
	CanHaveChildren  YesNoBool `xml:",attr"`
	RefFT            *string   `xml:",attr"`

	AttributeDefinitions AttributeDefinitions  `xml:"AttributeDefinitions"`
	Wheels               []Wheel               `xml:"Wheels>Wheel"`
	PhysicalDescriptions []PhysicalDescription `xml:"PhysicalDescriptions"`
	Models               []Model               `xml:"Models>Model"`
	Geometries           Geometries            `xml:"Geometries"`
	DMXModes             []DMXMode             `xml:"DMXModes>DMXMode"`
	Revisions            []Revision            `xml:"Revisions>Revision"`
	FTPresets            []string              `xml:"FTPresets"`
	Protocols            Protocol              `xml:"Protocols"`
}

type GDTF struct {
	DataVersion string `xml:",attr"`
	FixtureType FixtureType
}

type Gamut struct {
	Name   string     `xml:",attr"`
	Points []ColorCIE `xml:",attr"`
}

type Geometries struct {
	GeometryList          []Geometry          `xml:"Geometry"`
	AxisList              []Axis              `xml:"Axis"`
	FilterBeamList        []FilterBeam        `xml:"FilterBeam"`
	FilterColorList       []FilterColor       `xml:"FilterColor"`
	FilterGoboList        []FilterGobo        `xml:"FilterGobo"`
	FilterShaperList      []FilterShaper      `xml:"FilterShaper"`
	BeamList              []Beam              `xml:"Beam"`
	MediaServerLayerList  []MediaServerLayer  `xml:"MediaServerLayer"`
	MediaServerCameraList []MediaServerCamera `xml:"MediaServerCamera"`
	MediaServerMasterList []MediaServerMaster `xml:"MediaServerMaster"`
	DisplayList           []Display           `xml:"Display"`
	LaserList             []Laser             `xml:"Laser"`
	GeometryReferenceList []GeometryReference `xml:"GeometryReference"`
	WiringObjectList      []WiringObject      `xml:"WiringObject"`
	InventoryList         []Inventory         `xml:"Inventory"`
	StructureList         []Structure         `xml:"Structure"`
	SupportList           []Support           `xml:"Support"`
	MagnetList            []Magnet            `xml:"Magnet"`
}

type Geometry struct {
	Name     string `xml:",attr"`
	Model    string `xml:",attr"`
	Position Matrix `xml:",attr"`
	Geometries
}

type GeometryReference struct {
	Name        string  `xml:",attr"`
	Model       string  `xml:",attr"`
	Position    Matrix  `xml:",attr"`
	GeometryRef string  `xml:"Geometry,attr"` // only top level geometries allowed to be referenced
	Breaks      []Break `xml:"Break"`
}

type Hex int

type IntList []int

type Inventory struct {
	Name     string `xml:",attr"`
	Model    string `xml:",attr"`
	Position Matrix `xml:",attr"`
	Count    int    `xml:",attr"`
	Geometries
}

type Laser struct {
	Name              string           `xml:",attr"`
	Model             string           `xml:",attr"`
	Position          Matrix           `xml:",attr"`
	ColorType         string           `xml:",attr"` // enum
	Color             float32          `xml:",attr"` // Required if ColorType is “SingleWaveLength”; Unit:nm (nanometers)
	OutputStrength    float32          `xml:",attr"`
	Emitter           XMLNodeReference `xml:",attr"`
	BeamDiameter      float32          `xml:",attr"`
	BeamDivergenceMin float32          `xml:",attr"`
	BeamDivergenceMax float32          `xml:",attr"`
	ScanAnglePan      float32          `xml:",attr"`
	ScanAngleTilt     float32          `xml:",attr"`
	ScanSpeed         float32          `xml:",attr"`
	Protocols         []LaserProtocol  `xml:"Protocol"`
	Geometries
}

type LaserProtocol struct {
	Name string `xml:",attr"`
}

type LegHeight struct {
	Value float32 `xml:",attr"`
}

type LogicalChannel struct {
	Attribute          XMLNodeReference  `xml:",attr"`
	Snap               string            `xml:",attr"` // enum
	Master             string            `xml:",attr"` // enum
	MibFade            float32           `xml:",attr"`
	DMXChangeTimeLimit float32           `xml:",attr"`
	ChannelFunctions   []ChannelFunction `xml:"ChannelFunction"`
}

type MacroDMX struct {
	Steps []MacroDMXStep `xml:"MacroDMXStep"`
}

type MacroDMXStep struct {
	Duration  float32         `xml:",attr"`
	DMXValues []MacroDMXValue `xml:"DMXValue"`
}

type MacroDMXValue struct {
	Value      XMLDMXValue      `xml:",attr"`
	DMXChannel XMLNodeReference `xml:",attr"`
}

type Magnet struct {
	Name     string `xml:",attr"`
	Model    string `xml:",attr"`
	Position Matrix `xml:",attr"`
	Geometries
}

type Map struct {
	Key   uint `xml:",attr"` // Art-Net value
	Value uint `xml:",attr"` // DMX value
}

type Matrix [4][4]float64

type Measurement struct {
	Physical          float32             `xml:",attr"`
	LuminousIntensity float32             `xml:",attr"`
	Transmission      float32             `xml:",attr"`
	InterpolationTo   string              `xml:",attr"`
	MeasurementPoints *[]MeasurementPoint `xml:"MeasurementPoint"`
}

type MeasurementPoint struct {
	WaveLength float32 `xml:",attr"`
	Energy     float32 `xml:",attr"`
}

type MediaServerCamera struct {
	Name     string `xml:",attr"`
	Model    string `xml:",attr"`
	Position Matrix `xml:",attr"`
	Geometries
}

type MediaServerLayer struct {
	Name     string `xml:",attr"`
	Model    string `xml:",attr"`
	Position Matrix `xml:",attr"`
	Geometries
}

type MediaServerMaster struct {
	Name     string `xml:",attr"`
	Model    string `xml:",attr"`
	Position Matrix `xml:",attr"`
	Geometries
}

type Model struct {
	Name            string  `xml:",attr"`
	Length          float32 `xml:",attr"`
	Width           float32 `xml:",attr"`
	Height          float32 `xml:",attr"`
	PrimitiveType   string  `xml:",attr"` // enum
	File            *string `xml:",attr"`
	SVGOffsetX      float32 `xml:",attr"`
	SVGOffsetY      float32 `xml:",attr"`
	SVGSideOffsetX  float32 `xml:",attr"`
	SVGSideOffsetY  float32 `xml:",attr"`
	SVGFrontOffsetX float32 `xml:",attr"`
	SVGFrontOffsetY float32 `xml:",attr"`
}

type OpenSoundControl struct {
}

type OperatingTemperature struct {
	Low  float32 `xml:",attr"`
	High float32 `xml:",attr"`
}

type PhysicalDescription struct {
	Emitters              []Emitter    `xml:"Emitters>Emitter"`
	Filters               []Filter     `xml:"Filters>Filter"`
	ColorSpace            ColorSpace   `xml:"ColorSpace"`
	AdditionalColorSpaces []ColorSpace `xml:"AdditionalColorSpaces>ColorSpace"`
	Gamuts                []Gamut      `xml:"Gamuts>Gamut"`
	DMXProfiles           []DMXProfile `xml:"DMXProfiles>DMXProfile"`
	CRIs                  []CRIGroup   `xml:"CRIs>CRIGroup"`
	Connectors            []Connector  `xml:"Connectors>Connector"`
	Properties            Properties   `xml:"Properties"`
}

type PinPatch struct {
	ToWiringObject XMLNodeReference `xml:",attr"`
	FromPin        int              `xml:",attr"`
	ToPin          int              `xml:",attr"`
}

type Point struct {
	DMXPercentage float32 `xml:",attr"`
	CFC0          float32 `xml:",attr"`
	CFC1          float32 `xml:",attr"`
	CFC2          float32 `xml:",attr"`
	CFC3          float32 `xml:",attr"`
}

type PosiStageNet struct {
}

type Preset struct {
}

type PrismFacet struct {
	Color    ColorCIE `xml:",attr"`
	Rotation Rotation `xml:",attr"`
}

type Properties struct {
	OperatingTemperature *OperatingTemperature `xml:"OperatingTemperature"`
	Weight               *Weight               `xml:"Weight"`
	PowerConsumption     any                   `xml:"PowerConsumption"`
	LegHeight            *LegHeight            `xml:"LegHeight"`
}

type Protocol struct {
	RDM              []RDM              `xml:"FTRDM"`
	ArtNet           []ArtNet           `xml:"Art-Net"`
	SACN             []SACN             `xml:"sACN"`
	PosiStageNet     []PosiStageNet     `xml:"PosiStageNet"`
	OpenSoundControl []OpenSoundControl `xml:"OpenSoundControl"`
	CITP             []CITP             `xml:"CITP"`
}

type RDM struct {
	ManufacturerID   Hex                  `xml:",attr"`
	DeviceModelID    Hex                  `xml:",attr"`
	SoftwareVersions []RDMSoftwareVersion `xml:"SoftwareVersionID"`
}

type RDMDMXPersonality struct {
	Value   Hex              `xml:",attr"`
	DMXMode XMLNodeReference `xml:",attr"` // reference to DMX Mode
}

type RDMSoftwareVersion struct {
	Value            Hex                 `xml:",attr"`
	DMXPersonalities []RDMDMXPersonality `xml:"DMXPersonality"`
}

type Relation struct {
	Name     string           `xml:",attr"`
	Master   XMLNodeReference `xml:",attr"`
	Follower XMLNodeReference `xml:",attr"`
	Type     string           `xml:",attr"` //enum with "Multiply" or "Override"
}

type Revision struct {
	Text       string  `xml:",attr"`
	Date       XMLTime `xml:",attr"`
	UserID     uint    `xml:",attr"`
	ModifiedBy string  `xml:",attr"`
}

type Rotation [3][3]float32

type SACN struct {
	Maps []Map `xml:"Map"`
}

type Structure struct {
	Name                      string           `xml:",attr"`
	Model                     string           `xml:",attr"`
	Position                  Matrix           `xml:",attr"`
	LinkedGeometry            XMLNodeReference `xml:",attr"`
	StructureType             string           `xml:",attr"` // enum
	CrossSectionType          string           `xml:",attr"` // enum
	CrossSectionHeight        float32          `xml:",attr"`
	CrossSectionWallThickness float32          `xml:",attr"`
	TrussCrossSection         string           `xml:",attr"`
	Geometries
}

type SubChannelSet struct {
	Name            string           `xml:",attr"`
	PhysicalFrom    float32          `xml:",attr"`
	PhysicalTo      float32          `xml:",attr"`
	SubPhysicalUnit XMLNodeReference `xml:",attr"`
	DMXProfile      XMLNodeReference `xml:",attr"`
}

type SubPhysicalUnit struct {
	Type         string  `xml:",attr"`
	PhysicalUnit string  `xml:",attr"`
	PhysicalFrom float32 `xml:",attr"`
	PhysicalTo   float32 `xml:",attr"`
}

type Support struct {
	Name             string  `xml:",attr"`
	Model            string  `xml:",attr"`
	Position         Matrix  `xml:",attr"`
	SupportType      string  `xml:",attr"` //enum
	RopeCrossSection string  `xml:",attr"`
	RopeOffset       Vector3 `xml:",attr"`
	CapacityX        float32 `xml:",attr"`
	CapacityY        float32 `xml:",attr"`
	CapacityZ        float32 `xml:",attr"`
	CapacityXX       float32 `xml:",attr"`
	CapacityYY       float32 `xml:",attr"`
	CapacityZZ       float32 `xml:",attr"`
	ResistanceX      float32 `xml:",attr"`
	ResistanceY      float32 `xml:",attr"`
	ResistanceZ      float32 `xml:",attr"`
	ResistanceXX     float32 `xml:",attr"`
	ResistanceYY     float32 `xml:",attr"`
	ResistanceZZ     float32 `xml:",attr"`
	Geometries
}

type Vector3 struct {
	X float32
	Y float32
	Z float32
}

type Weight struct {
	Value float32 `xml:",attr"`
}

type Wheel struct {
	Name       string      `xml:",attr"`
	WheelSlots []WheelSlot `xml:"Slot"`
}

type WheelSlot struct {
	Name             string            `xml:",attr"`
	Color            *ColorCIE         `xml:",attr,omitempty"`
	Filter           *XMLNodeReference `xml:",attr,omitempty"` // ref to Physical/Filter
	MediaFileName    *string           `xml:",attr,omitempty"`
	PrismFacets      []PrismFacet      `xml:"Facet"`
	AnimationSystems []AnimationSystem `xml:"AnimationSystem"`
}

type WiringObject struct {
	Name              string     `xml:",attr"`
	Model             string     `xml:",attr"`
	ConnectorType     string     `xml:",attr"`
	Position          Matrix     `xml:",attr"`
	ComponentType     string     `xml:",attr"` //enum
	SignalType        string     `xml:",attr"`
	PinCount          int        `xml:",attr"`
	ElectricalPayLoad float32    `xml:",attr"`
	VoltageRangeMax   float32    `xml:",attr"`
	VoltageRangeMin   float32    `xml:",attr"`
	FrequencyRangeMax float32    `xml:",attr"`
	FrequencyRangeMin float32    `xml:",attr"`
	MaxPayLoad        float32    `xml:",attr"`
	Voltage           float32    `xml:",attr"`
	SignalLayer       int        `xml:",attr"`
	CosPhi            float32    `xml:",attr"`
	FuseCurrent       float32    `xml:",attr"` // in ampere
	FuseRating        string     `xml:",attr"` //enum
	Orientation       string     `xml:",attr"` //enum
	WireGroup         string     `xml:",attr"`
	PinPatches        []PinPatch `xml:"PinPatch"`
	Geometries
}

type XMLDMXValue = string

type XMLNodeReference = string

type XMLTime struct {
	time.Time
}

type YesNoBool bool