/* ======================================================================== * Copyright (c) 2005-2026 The OPC Foundation, Inc. All rights reserved. * * OPC Foundation MIT License 1.00 * * Permission is hereby granted, free of charge, to any person * obtaining a copy of this software and associated documentation * files (the "Software"), to deal in the Software without * restriction, including without limitation the rights to use, * copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the * Software is furnished to do so, subject to the following * conditions: * * The above copyright notice and this permission notice shall be * included in all copies or substantial portions of the Software. * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR * OTHER DEALINGS IN THE SOFTWARE. * * The complete license agreement can be found here: * http://opcfoundation.org/License/MIT/1.00/ * ======================================================================*/ using System; using System.Collections.Generic; using System.Globalization; using System.IO; using System.Security.Cryptography; using Opc.Ua; using Opc.Ua.Vision; namespace Vision.VisualInspectionCell { /// /// Coordinates fixture selection, image measurement and deterministic recipe judging. /// internal sealed class VisualInspectionAnalysisService { public VisualInspectionAnalysisService(FixtureImageAnalyzer analyzer, InspectionVerdictPolicy policy) { m_analyzer = analyzer ?? throw new ArgumentNullException(nameof(analyzer)); m_policy = policy ?? throw new ArgumentNullException(nameof(policy)); } public IReadOnlyList FixtureNames { get; } = [ "bracket-ok.png", "bracket-not-ok.png", "bracket-ambiguous.png" ]; public string FixtureDirectory { get { string output = Path.Combine(AppContext.BaseDirectory, "Fixtures"); if (Directory.Exists(output)) { return output; } string project = Path.GetFullPath(Path.Combine( AppContext.BaseDirectory, "..", "..", "..", "..", "Fixtures")); if (Directory.Exists(project)) { return project; } return Path.Combine( Environment.CurrentDirectory, "samples", "Vision", "VisualInspectionCell", "Fixtures"); } } public InspectionAnalysis AnalyzeByName(string fixtureName) { string selected = ResolveFixtureName(fixtureName); return m_policy.Judge(selected, MeasureByName(selected)); } public InspectionAnalysis AnalyzeForCycle(DateTimeUtc timestamp) { long cycle = timestamp.IsNull ? DateTimeUtc.From(DateTime.UnixEpoch).Value : timestamp.Value; int index = (int)(Math.Abs(cycle) % FixtureNames.Count); return AnalyzeByName(FixtureNames[index % FixtureNames.Count]); } public IReadOnlyList MeasureByName(string fixtureName) { string selected = ResolveFixtureName(fixtureName); string path = Path.Combine(FixtureDirectory, selected); return m_analyzer.Measure(path); } public VisionImageReferenceDataType CreateImageReference(string fixtureName, DateTimeUtc timestamp) { string selected = ResolveFixtureName(fixtureName); string path = Path.Combine(FixtureDirectory, selected); ByteString png = ByteString.From(File.ReadAllBytes(path)); return new VisionImageReferenceDataType { Uri = FormattableString.Invariant($"opcua-inline://visual-inspection-cell/fixtures/{selected}"), Digest = ByteString.From(SHA256.HashData(png.Span)), DigestAlgorithm = "SHA-256", Format = VisionClipFormatEnum.Png, PixelFormat = VisualInspectionMediaProvider.PixelFormat, Width = VisualInspectionMediaProvider.Width, Height = VisualInspectionMediaProvider.Height, SizeBytes = (uint)png.Length, Timestamp = timestamp }; } public bool TryResolveFixtureName(string? requested, out string fixtureName) { if (!string.IsNullOrWhiteSpace(requested)) { string candidate = requested.EndsWith(".png", StringComparison.OrdinalIgnoreCase) ? requested : string.Create(CultureInfo.InvariantCulture, $"{requested}.png"); foreach (string fixture in FixtureNames) { if (string.Equals(candidate, fixture, StringComparison.OrdinalIgnoreCase) || string.Equals(requested, Path.GetFileNameWithoutExtension(fixture), StringComparison.OrdinalIgnoreCase)) { fixtureName = fixture; return true; } } } fixtureName = string.Empty; return false; } public bool TryResolveFixtureFromUri(string? uri, out string fixtureName) { if (string.IsNullOrWhiteSpace(uri)) { fixtureName = string.Empty; return false; } return TryResolveFixtureName(Path.GetFileName(uri), out fixtureName); } public string ResolveFixtureName(string? requested) { if (TryResolveFixtureName(requested, out string fixtureName)) { return fixtureName; } throw new FileNotFoundException( string.Create(CultureInfo.InvariantCulture, $"Unknown visual-inspection fixture '{requested}'.")); } private readonly FixtureImageAnalyzer m_analyzer; private readonly InspectionVerdictPolicy m_policy; } }