Functions/GenXdev.AI.Queries/Find-Image.ps1
|
############################################################################### <# .SYNOPSIS Searches for image files and metadata in specified directories with filtering capabilities and optional browser-based gallery display. .DESCRIPTION Searches for image files (jpg, jpeg, png, gif, bmp, webp, tiff, tif) in the specified directory and its subdirectories. For each image, checks associated description.json, keywords.json, people.json, and objects.json files for metadata. Can filter images based on keyword matches, people recognition, and object detection, then return the results as objects. Use -ShowInBrowser to display results in a browser-based masonry layout. Parameter Logic: - Within each parameter type (Keywords, People, Objects, etc.): Uses OR logic Example: -Keywords "cat","dog" finds images with EITHER cat OR dog - Between different parameter types: Uses AND logic Example: -Keywords "cat" -People "John" finds images with cat AND John - EXIF range parameters: Provide [min, max] values for filtering ranges - String parameters: Support wildcard matching with * and ? The function searches through image directories and examines alternate data streams containing metadata in JSON format. It can match keywords using wildcard patterns, filter for specific people, and search for detected objects. By default, returns image data objects. Use -ShowInBrowser to display in a web browser. .PARAMETER Any Will match any of all the possible meta data types. .PARAMETER DatabaseFilePath The path to the image database file. If not specified, a default path is used. .PARAMETER ImageDirectories Array of directory paths to search for images. Each directory is searched recursively for jpg, jpeg, png, gif, bmp, webp, tiff, and tif files. Relative paths are converted to absolute paths automatically. .PARAMETER PathLike Array of directory path-like search strings to filter images by path (SQL LIKE patterns, e.g. '%\\2024\\%'). .PARAMETER Language The language for retrieving descriptions and keywords. Will try to find metadata in the specified language first, then fall back to English if not available. This allows you to have metadata in multiple languages for the same images. .PARAMETER FacesDirectory The directory containing face images organized by person folders. If not specified, uses the configured faces directory preference. .PARAMETER EmbedImages Switch to embed images as base64 data URLs instead of file:// URLs. This makes the generated HTML file completely self-contained and portable, but results in larger file sizes. Useful when the HTML needs to be shared or viewed on different systems where the original image files may not be accessible. .PARAMETER ForceIndexRebuild Force rebuild of the image index database. .PARAMETER NoFallback Switch to disable fallback behavior. .PARAMETER NeverRebuild Switch to skip database initialization and rebuilding. .PARAMETER DescriptionSearch The description text to look for, wildcards allowed. .PARAMETER Keywords Array of keywords to search for in image metadata. Supports wildcards. If empty, returns all images with any metadata. Keywords are matched against both the description content and keywords arrays in metadata files. .PARAMETER People Array of people names to search for in image metadata. Supports wildcards. Used to filter images based on face recognition metadata stored in people.json files. .PARAMETER Objects Array of object names to search for in image metadata. Supports wildcards. Used to filter images based on object detection metadata stored in objects.json files. .PARAMETER Scenes Array of scene categories to search for in image metadata. Supports wildcards. Used to filter images based on scene classification metadata stored in scenes.json files. .PARAMETER InputObject Accepts search results from a previous -PassThru call to regenerate the view. .PARAMETER PictureType Array of picture types to filter by (e.g., 'daylight', 'evening', 'indoor', 'outdoor'). Supports wildcards. Matches against the picture_type property in description metadata. .PARAMETER StyleType Array of style types to filter by (e.g., 'casual', 'formal'). Supports wildcards. Matches against the style_type property in description metadata. .PARAMETER OverallMood Array of overall moods to filter by (e.g., 'calm', 'cheerful', 'sad', 'energetic'). Supports wildcards. Matches against the overall_mood_of_image property in description metadata. .PARAMETER Title The title to display at the top of the image gallery. .PARAMETER Description The description text to display in the image gallery. .PARAMETER FocusWindow Focus the browser window after opening. .PARAMETER SetForeground Set the browser window to foreground after opening. .PARAMETER Maximize Maximize the browser window after positioning. .PARAMETER AcceptLang Set the browser accept-lang http header. .PARAMETER Monitor The monitor to use, 0 = default, -1 is discard, -2 = Configured secondary monitor, defaults to Global:DefaultSecondaryMonitor or 2 if not found. .PARAMETER FocusWindow Focus the browser window after opening. .PARAMETER SetForeground Set the browser window to foreground after opening. .PARAMETER KeysToSend Send specified keys to the browser window after opening. .PARAMETER SendKeyEscape When specified, escapes special characters so they are sent as literal text instead of being interpreted as control sequences. .PARAMETER SendKeyHoldKeyboardFocus Prevents returning keyboard focus to PowerShell after sending keys. .PARAMETER SendKeyUseShiftEnter Sends Shift+Enter instead of regular Enter for line breaks. .PARAMETER SendKeyDelayMilliSeconds Adds delay between sending different key sequences. Useful for slower apps. .PARAMETER Width The initial width of the webbrowser window. .PARAMETER Height The initial height of the webbrowser window. .PARAMETER X The initial X position of the webbrowser window. .PARAMETER Y The initial Y position of the webbrowser window. .PARAMETER HasNudity Switch to filter for images that contain nudity. Only returns images where the has_nudity property is true in the metadata. .PARAMETER NoNudity Switch to filter for images that do NOT contain nudity. Only returns images where the has_nudity property is false in the metadata. .PARAMETER HasExplicitContent Switch to filter for images that contain explicit content. Only returns images where the has_explicit_content property is true in the metadata. .PARAMETER NoExplicitContent Switch to filter for images that do NOT contain explicit content. Only returns images where the has_explicit_content property is false in the metadata. .PARAMETER ShowInBrowser Switch to display the search results in a browser-based masonry layout gallery. When used, the results are shown in an interactive web view. Can be combined with -PassThru to also return the objects. .PARAMETER PassThru Switch to return image data as objects. When used with -ShowInBrowser, both displays the gallery and returns the objects. When used alone with -ShowInBrowser, only displays the gallery without returning objects. .PARAMETER NoBorders Remove window borders and title bar for a cleaner appearance. .PARAMETER SideBySide Place browser window side by side with PowerShell on the same monitor. .PARAMETER Interactive Connects to browser and adds additional buttons like Edit and Delete. .PARAMETER Private Opens in incognito/private browsing mode. .PARAMETER Force Force enable debugging port, stopping existing browsers if needed. .PARAMETER Edge Opens in Microsoft Edge. .PARAMETER Chrome Opens in Google Chrome. .PARAMETER Chromium Opens in Microsoft Edge or Google Chrome, depending on what the default browser is. .PARAMETER Firefox Opens in Firefox. .PARAMETER All Opens in all registered modern browsers. .PARAMETER FullScreen Opens in fullscreen mode. .PARAMETER Left Place browser window on the left side of the screen. .PARAMETER Right Place browser window on the right side of the screen. .PARAMETER Top Place browser window on the top side of the screen. .PARAMETER Bottom Place browser window on the bottom side of the screen. .PARAMETER Centered Place browser window in the center of the screen. .PARAMETER ApplicationMode Hide the browser controls. .PARAMETER NoBrowserExtensions Prevent loading of browser extensions. .PARAMETER DisablePopupBlocker Disable the popup blocker. .PARAMETER RestoreFocus Restore PowerShell window focus. .PARAMETER NewWindow Don't re-use existing browser window, instead, create a new one. .PARAMETER OnlyReturnHtml Only return the generated HTML instead of displaying it in a browser. .PARAMETER ShowOnlyPictures Show only pictures in a rounded rectangle, no text below. .PARAMETER MetaCameraMake Filter by camera make in image EXIF metadata. Supports wildcards. Multiple values use OR logic within this parameter. .PARAMETER MetaCameraModel Filter by camera model in image EXIF metadata. Supports wildcards. Multiple values use OR logic within this parameter. .PARAMETER MetaGPSLatitude Filter by GPS latitude range in image EXIF metadata. Provide two values for range filtering [min, max]. .PARAMETER MetaGPSLongitude Filter by GPS longitude range in image EXIF metadata. Provide two values for range filtering [min, max]. .PARAMETER MetaGPSAltitude Filter by GPS altitude range in image EXIF metadata (in meters). Provide two values for range filtering [min, max]. .PARAMETER GeoLocation Geographic coordinates [latitude, longitude] to search near. .PARAMETER GeoDistanceInMeters Maximum distance in meters from GeoLocation to search for images. .PARAMETER MetaExposureTime Filter by exposure time range in image EXIF metadata (in seconds). Provide two values for range filtering [min, max]. .PARAMETER MetaFNumber Filter by F-number (aperture) range in image EXIF metadata. Provide two values for range filtering [min, max]. .PARAMETER MetaISO Filter by ISO sensitivity range in image EXIF metadata. Provide two values for range filtering [min, max]. .PARAMETER MetaFocalLength Filter by focal length range in image EXIF metadata (in mm). Provide two values for range filtering [min, max]. .PARAMETER MetaWidth Filter by image width range in pixels from EXIF metadata. Provide two values for range filtering [min, max]. .PARAMETER MetaHeight Filter by image height range in pixels from EXIF metadata. Provide two values for range filtering [min, max]. .PARAMETER MetaDateTaken Filter by date taken from EXIF metadata. Can be a date range. Provide two DateTime values for range filtering [start, end]. .PARAMETER SessionOnly Use alternative settings stored in session for AI preferences like Language, Image collections, etc. .PARAMETER ClearSession Clear alternative settings stored in session for AI preferences like Language, Image collections, etc. .PARAMETER PreferencesDatabasePath Database path for preference data files. .PARAMETER SkipSession Dont use alternative settings stored in session for AI preferences like Language, Image collections, etc. .PARAMETER MinConfidenceRatio Minimum confidence ratio (0.0-1.0) for filtering people, scenes, and objects by confidence. Only returns data for people, scenes, and objects with confidence greater than or equal to this value. When specified, filters out low-confidence detection results from people, scenes, and objects data while keeping the image. .PARAMETER Append When used with InputObject, first outputs all InputObject content, then processes as if InputObject was not set. Allows appending search results to existing collections. .EXAMPLE Find-Image -Keywords "cat","dog" -ImageDirectories "C:\Photos" Searches for images containing 'cat' OR 'dog' keywords and returns the image objects. .EXAMPLE findimages cat,dog "C:\Photos" Same as above using the alias and positional parameters. .EXAMPLE Find-Image -People "John","Jane" -ImageDirectories "C:\Family" -ShowInBrowser Searches for photos containing John OR Jane and displays them in a web gallery. .EXAMPLE Find-Image -Keywords "vacation" -People "John" -Objects "beach" -ImageDirectories "C:\Photos" Searches for images that contain vacation keywords AND John as a person AND beach objects. All three criteria must be met (AND logic between parameter types). .EXAMPLE Find-Image -MetaISO 100,800 -MetaFNumber 1.4,2.8 -ImageDirectories "C:\Photos" Finds images with ISO between 100-800 AND aperture (F-number) between f/1.4-f/2.8. EXIF parameters use range filtering with [min, max] values. .EXAMPLE Find-Image -Objects "car","bicycle" -ImageDirectories "C:\Photos" -ShowInBrowser -PassThru Searches for images containing detected cars or bicycles, displays them in a gallery, and also returns the objects. .EXAMPLE findimages -Language "Spanish" -Keywords "playa","sol" -ImageDirectories "C:\Vacations" -ShowInBrowser Searches for images with Spanish metadata containing the keywords "playa" (beach) or "sol" (sun) and displays in gallery. .EXAMPLE Find-Image -Keywords "vacation" -People "John" -Objects "beach*" -ImageDirectories "C:\Photos" Searches for vacation photos with John in them that also contain beach-related objects and returns the data objects. .EXAMPLE Find-Image -Scenes "beach","forest","mountain*" -ImageDirectories "C:\Nature" -ShowInBrowser Searches for images classified as beach, forest, or mountain scenes and displays them in a gallery. .EXAMPLE Find-Image -NoNudity -NoExplicitContent -ImageDirectories "C:\Family" -ShowInBrowser Searches for family-safe images (no nudity or explicit content) and displays them in a gallery. .EXAMPLE Find-Image -PictureType "daylight" -OverallMood "calm" -ImageDirectories "C:\Photos" Searches for daylight photos with a calm/peaceful mood and returns the image objects. .EXAMPLE findimages -StyleType "casual" -HasNudity -ImageDirectories "C:\Art" Searches for casual style images that contain nudity and returns the data objects. .EXAMPLE Find-Image -Scenes "beach" -MinConfidenceRatio 0.75 -ImageDirectories "C:\Photos" Searches for beach scenes with confidence level of 75% or higher and filters people, scenes, and objects data by confidence. #> ############################################################################### function Find-Image { [CmdletBinding()] [OutputType([Object[]], [System.Collections.Generic.List[Object]], [string])] [Alias('findimages', 'li')] param( ############################################################################### [Parameter( Position = 0, Mandatory = $false, HelpMessage = 'Will match any of all the possible meta data types.' )] [string[]] $Any = @(), ############################################################################### [Parameter( Position = 1, Mandatory = $false, HelpMessage = ('The path to the image database file. If not ' + 'specified, a default path is used.') )] [string] $DatabaseFilePath, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Array of directory paths to search for images' )] [ValidateNotNullOrEmpty()] [Alias('imagespath', 'directories', 'imgdirs', 'imagedirectory')] [string[]] $ImageDirectories = @('.\'), ############################################################################### [Parameter( Mandatory = $false, HelpMessage = ('Array of directory path-like search strings to ' + "filter images by path (SQL LIKE patterns, e.g. '%\\2024\\%')") )] [string[]] $PathLike = @(), ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Language for descriptions and keywords.' )] [ValidateSet( 'Afrikaans', 'Akan', 'Albanian', 'Amharic', 'Arabic', 'Armenian', 'Azerbaijani', 'Basque', 'Belarusian', 'Bemba', 'Bengali', 'Bihari', 'Bork, bork, bork!', 'Bosnian', 'Breton', 'Bulgarian', 'Cambodian', 'Catalan', 'Cherokee', 'Chichewa', 'Chinese (Simplified)', 'Chinese (Traditional)', 'Corsican', 'Croatian', 'Czech', 'Danish', 'Dutch', 'Elmer Fudd', 'English', 'Esperanto', 'Estonian', 'Ewe', 'Faroese', 'Filipino', 'Finnish', 'French', 'Frisian', 'Ga', 'Galician', 'Georgian', 'German', 'Greek', 'Guarani', 'Gujarati', 'Hacker', 'Haitian Creole', 'Hausa', 'Hawaiian', 'Hebrew', 'Hindi', 'Hungarian', 'Icelandic', 'Igbo', 'Indonesian', 'Interlingua', 'Irish', 'Italian', 'Japanese', 'Javanese', 'Kannada', 'Kazakh', 'Kinyarwanda', 'Kirundi', 'Klingon', 'Kongo', 'Korean', 'Krio (Sierra Leone)', 'Kurdish', 'Kurdish (Soranî)', 'Kyrgyz', 'Laothian', 'Latin', 'Latvian', 'Lingala', 'Lithuanian', 'Lozi', 'Luganda', 'Luo', 'Macedonian', 'Malagasy', 'Malay', 'Malayalam', 'Maltese', 'Maori', 'Marathi', 'Mauritian Creole', 'Moldavian', 'Mongolian', 'Montenegrin', 'Nepali', 'Nigerian Pidgin', 'Northern Sotho', 'Norwegian', 'Norwegian (Nynorsk)', 'Occitan', 'Oriya', 'Oromo', 'Pashto', 'Persian', 'Pirate', 'Polish', 'Portuguese (Brazil)', 'Portuguese (Portugal)', 'Punjabi', 'Quechua', 'Romanian', 'Romansh', 'Runyakitara', 'Russian', 'Scots Gaelic', 'Serbian', 'Serbo-Croatian', 'Sesotho', 'Setswana', 'Seychellois Creole', 'Shona', 'Sindhi', 'Sinhalese', 'Slovak', 'Slovenian', 'Somali', 'Spanish', 'Spanish (Latin American)', 'Sundanese', 'Swahili', 'Swedish', 'Tajik', 'Tamil', 'Tatar', 'Telugu', 'Thai', 'Tigrinya', 'Tonga', 'Tshiluba', 'Tumbuka', 'Turkish', 'Turkmen', 'Twi', 'Uighur', 'Ukrainian', 'Urdu', 'Uzbek', 'Vietnamese', 'Welsh', 'Wolof', 'Xhosa', 'Yiddish', 'Yoruba', 'Zulu' )] [string] $Language, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = ('The directory containing face images organized by ' + 'person folders. If not specified, uses the configured faces ' + 'directory preference.') )] [string] $FacesDirectory, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = ('The description text to look for, wildcards ' + 'allowed.') )] [string[]] $DescriptionSearch = @(), ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'The keywords to look for, wildcards allowed.' )] [string[]] $Keywords = @(), ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'People to look for, wildcards allowed.' )] [string[]] $People = @(), ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Objects to look for, wildcards allowed.' )] [string[]] $Objects = @(), ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Scene categories to look for, wildcards allowed.' )] [string[]] $Scenes = @(), ############################################################################### [Parameter( Mandatory = $false, ValueFromPipeline = $true, HelpMessage = ('Accepts search results from a previous -PassThru ' + 'call to regenerate the view.') )] [System.Object[]] $InputObject, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = ("Picture type to filter by (e.g., 'daylight', " + "'evening', 'indoor', etc). Supports wildcards.") )] [string[]] $PictureType = @(), ############################################################################### [Parameter( Mandatory = $false, HelpMessage = ("Style type to filter by (e.g., 'casual', 'formal', " + 'etc). Supports wildcards.') )] [string[]] $StyleType = @(), ############################################################################### [Parameter( Mandatory = $false, HelpMessage = ("Overall mood to filter by (e.g., 'calm', " + "'cheerful', 'sad', etc). Supports wildcards.") )] [string[]] $OverallMood = @(), ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Filter by camera make in image EXIF metadata. Supports wildcards.' )] [string[]] $MetaCameraMake = @(), ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Filter by camera model in image EXIF metadata. Supports wildcards.' )] [string[]] $MetaCameraModel = @(), ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Filter by GPS latitude range in image EXIF metadata.' )] [double[]] $MetaGPSLatitude, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Filter by GPS longitude range in image EXIF metadata.' )] [double[]] $MetaGPSLongitude, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Filter by GPS altitude range in image EXIF metadata (in meters).' )] [double[]] $MetaGPSAltitude, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Geographic coordinates [latitude, longitude] to search near.' )] [double[]] $GeoLocation, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Maximum distance in meters from GeoLocation to search for images.' )] [double] $GeoDistanceInMeters = 1000, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Filter by exposure time range in image EXIF metadata (in seconds).' )] [double[]] $MetaExposureTime, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Filter by F-number (aperture) range in image EXIF metadata.' )] [double[]] $MetaFNumber, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Filter by ISO sensitivity range in image EXIF metadata.' )] [int[]] $MetaISO, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Filter by focal length range in image EXIF metadata (in mm).' )] [double[]] $MetaFocalLength, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Filter by image width range in pixels from EXIF metadata.' )] [int[]] $MetaWidth, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Filter by image height range in pixels from EXIF metadata.' )] [int[]] $MetaHeight, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Filter by date taken from EXIF metadata. Can be a date range.' )] [DateTime[]] $MetaDateTaken, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Title for the gallery' )] [string] $Title = 'Photo Gallery', ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Description for the gallery' )] [string] $Description = ('Hover over images to see face recognition ' + 'and object detection data'), ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Set the browser accept-lang http header' )] [Alias('lang', 'locale')] [string] $AcceptLang = $null, ########################################################################### [Parameter( Mandatory = $false, HelpMessage = ('Keystrokes to send to the Browser window, ' + 'see documentation for cmdlet GenXdev.Windows\Send-Key') )] [string[]] $KeysToSend, ######################################################################## [Parameter( Mandatory = $false, HelpMessage = ('Escape control characters and modifiers when ' + 'sending keys') )] [Alias('Escape')] [switch] $SendKeyEscape, ######################################################################## [Parameter( Mandatory = $false, HelpMessage = ('Prevent returning keyboard focus to PowerShell ' + 'after sending keys') )] [Alias('HoldKeyboardFocus')] [switch] $SendKeyHoldKeyboardFocus, ######################################################################## [Parameter( Mandatory = $false, HelpMessage = ('Use Shift+Enter instead of Enter when sending ' + 'keys') )] [Alias('UseShiftEnter')] [switch] $SendKeyUseShiftEnter, ######################################################################## [Parameter( Mandatory = $false, HelpMessage = ('Delay between different input strings in ' + 'milliseconds when sending keys') )] [Alias('DelayMilliSeconds')] [int] $SendKeyDelayMilliSeconds, ######################################################################## [Parameter( Mandatory = $false, HelpMessage = 'Focus the browser window after opening' )] [Alias('fw','focus')] [switch] $FocusWindow, ######################################################################## [Parameter( Mandatory = $false, HelpMessage = 'Set the browser window to foreground after opening' )] [Alias('fg')] [switch] $SetForeground, ######################################################################## [Parameter( Mandatory = $false, HelpMessage = 'Maximize the window after positioning' )] [switch] $Maximize, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = ('The monitor to use, 0 = default, -1 is discard, ' + '-2 = Configured secondary monitor, defaults to ' + "`Global:DefaultSecondaryMonitor or 2 if not found") )] [Alias('m', 'mon')] [int] $Monitor = -2, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'The initial width of the webbrowser window' )] [int] $Width = -1, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'The initial height of the webbrowser window' )] [int] $Height = -1, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'The initial X position of the webbrowser window' )] [int] $X = -999999, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'The initial Y position of the webbrowser window' )] [int] $Y = -999999, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Database path for preference data files' )] [Alias('DatabasePath')] [string] $PreferencesDatabasePath, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Embed images as base64.' )] [switch] $EmbedImages, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Force rebuild of the image index database.' )] [switch] $ForceIndexRebuild, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Switch to disable fallback behavior.' )] [switch] $NoFallback, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Switch to skip database initialization and rebuilding.' )] [switch] $NeverRebuild, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Filter images that contain nudity.' )] [switch] $HasNudity, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Filter images that do NOT contain nudity.' )] [switch] $NoNudity, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Filter images that contain explicit content.' )] [switch] $HasExplicitContent, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Filter images that do NOT contain explicit content.' )] [switch] $NoExplicitContent, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = ('Display the search results in a browser-based ' + 'image gallery.') )] [Alias('show', 's')] [switch] $ShowInBrowser, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = ('Return image data as objects. When used with ' + '-ShowInBrowser, both displays the gallery and returns ' + 'the objects.') )] [Alias('pt')] [switch]$PassThru, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Remove window borders and title bar for a cleaner appearance' )] [Alias('nb')] [switch] $NoBorders, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Place browser window side by side with PowerShell on the same monitor' )] [Alias('sbs')] [switch]$SideBySide, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = ('Will connect to browser and adds additional ' + 'buttons like Edit and Delete. Only effective when used with ' + '-ShowInBrowser.') )] [Alias('i', 'editimages')] [switch] $Interactive, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Opens in incognito/private browsing mode' )] [Alias('incognito', 'inprivate')] [switch] $Private, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = ('Force enable debugging port, stopping existing ' + 'browsers if needed') )] [switch] $Force, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Opens in Microsoft Edge' )] [Alias('e')] [switch] $Edge, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Opens in Google Chrome' )] [Alias('ch')] [switch] $Chrome, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = ('Opens in Microsoft Edge or Google Chrome, ' + 'depending on what the default browser is') )] [Alias('c')] [switch] $Chromium, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Opens in Firefox' )] [Alias('ff')] [switch] $Firefox, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Opens in all registered modern browsers' )] [switch] $All, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Opens in fullscreen mode' )] [Alias('fs', 'f')] [switch] $FullScreen, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Place browser window on the left side of the screen' )] [switch] $Left, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Place browser window on the right side of the screen' )] [switch] $Right, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Place browser window on the top side of the screen' )] [switch] $Top, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Place browser window on the bottom side of the screen' )] [switch] $Bottom, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Place browser window in the center of the screen' )] [switch] $Centered, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Hide the browser controls' )] [Alias('a', 'app', 'appmode')] [switch] $ApplicationMode, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Prevent loading of browser extensions' )] [Alias('de', 'ne', 'NoExtensions')] [switch] $NoBrowserExtensions, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Disable the popup blocker' )] [Alias('allowpopups')] [switch] $DisablePopupBlocker, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Restore PowerShell window focus' )] [Alias('rf', 'bg')] [switch] $RestoreFocus, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = ("Don't re-use existing browser window, instead, " + 'create a new one') )] [Alias('nw', 'new')] [switch] $NewWindow, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = ('Only return the generated HTML instead of ' + 'displaying it in a browser.') )] [switch] $OnlyReturnHtml, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = ('Show only pictures in a rounded rectangle, no ' + 'text below.') )] [Alias('NoMetadata', 'OnlyPictures')] [switch] $ShowOnlyPictures, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = ('Use alternative settings stored in session for AI ' + 'preferences like Language, Image collections, etc') )] [switch] $SessionOnly, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = ('Clear alternative settings stored in session for ' + 'AI preferences like Language, Image collections, etc') )] [switch] $ClearSession, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = ('Dont use alternative settings stored in session ' + 'for AI preferences like Language, Image collections, etc') )] [Alias('FromPreferences')] [switch] $SkipSession, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Auto-scroll the page by this many pixels per second (null to disable)' )] [int]$AutoScrollPixelsPerSecond = $null, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Animate rectangles (objects/faces) in visible range, cycling every 300ms' )] [switch]$AutoAnimateRectangles, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Force single column layout (centered, 1/3 screen width)' )] [switch]$SingleColumnMode = $false, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = 'Prefix to prepend to each image path (e.g. for remote URLs)' )] [string]$ImageUrlPrefix = '', ############################################################################### <# .PARAMETER AllDrives Search across all available drives. #> [Parameter( Mandatory = $false, HelpMessage = 'Search across all available drives' )] [switch] $AllDrives, ############################################################################### <# .PARAMETER NoRecurse Do not recurse into subdirectories. #> [Parameter( Mandatory = $false, HelpMessage = 'Do not recurse into subdirectories' )] [switch] $NoRecurse, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = ('Minimum confidence ratio (0.0-1.0) for filtering ' + 'people, scenes, and objects by confidence. Only returns data for ' + 'people, scenes, and objects with confidence greater than or equal ' + 'to this value.') )] [ValidateRange(0.0, 1.0)] [double] $MinConfidenceRatio, ############################################################################### [Parameter( Mandatory = $false, HelpMessage = ('When used with InputObject, first outputs all ' + 'InputObject content, then processes as if InputObject was not set. ' + 'Allows appending search results to existing collections.') )] [switch] $Append ############################################################################### ) begin { # configure html return mode if requested if ($OnlyReturnHtml) { $Interactive = $false $ShowInBrowser = $true } # get language preference using helper function with parameter copying $params = GenXdev.Helpers\Copy-IdenticalParamValues ` -BoundParameters $PSBoundParameters ` -FunctionName 'GenXdev.AI\Get-AIMetaLanguage' ` -DefaultValues (Microsoft.PowerShell.Utility\Get-Variable ` -Scope Local ` -ErrorAction SilentlyContinue) # retrieve the language preference from ai meta language function $language = GenXdev.AI\Get-AIMetaLanguage @params # enable interactive mode when interactive switch is used if ($Interactive) { $ShowInBrowser = $true } # copy parameters for resolving input object file names $params = GenXdev.Helpers\Copy-IdenticalParamValues ` -BoundParameters $PSBoundParameters ` -FunctionName 'GenXdev.FileSystem\ResolveInputObjectFileNames' ` -DefaultValues (Microsoft.PowerShell.Utility\Get-Variable -Scope Local -ErrorAction SilentlyContinue) # resolve input object file names and convert to full path array $fileNames = @(@(GenXdev.FileSystem\ResolveInputObjectFileNames @params -InputObject $InputObject -PassThru) + @(GenXdev.FileSystem\ResolveInputObjectFileNames @params -InputObject $Any -PassThru) | Microsoft.PowerShell.Core\ForEach-Object FullName) # filter input objects to exclude already processed file names $InputObject = $null -eq $InputObject ? $InputObject : (@($InputObject | Microsoft.PowerShell.Core\Where-Object { $fileNames.IndexOf((GenXdev.FileSystem\Expand-Path $_)) -lt 0 } -ErrorAction SilentlyContinue)); # filter any parameter to exclude already processed file names $Any = $null -eq $Any ? $null : (@($Any | Microsoft.PowerShell.Core\Where-Object { $fileNames.IndexOf((GenXdev.FileSystem\Expand-Path $_)) -lt 0 } -ErrorAction SilentlyContinue)); # initialize results collection for all found images $results = [System.Collections.Generic.List[Object]] @() # copy parameters for getting ai image collection directories $params = GenXdev.Helpers\Copy-IdenticalParamValues ` -BoundParameters $PSBoundParameters ` -FunctionName 'GenXdev.AI\Get-AIImageCollection' ` -DefaultValues (Microsoft.PowerShell.Utility\Get-Variable ` -Scope Local ` -ErrorAction SilentlyContinue) # get configured image directories from ai configuration $directories = GenXdev.AI\Get-AIImageCollection @params # process any parameter - prepare for OR-based matching across metadata types $anySearchTerms = @() if ($null -ne $Any -and $Any.Length -gt 0) { # add wildcards to entries that don't already have them for flexible matching $anySearchTerms = @($Any | Microsoft.PowerShell.Core\ForEach-Object { # trim whitespace from each entry $entry = $_.Trim() # check if entry already has wildcard characters if ($entry.IndexOfAny([char[]]@('*', '?')) -lt 0) { # add wildcard wrapping for broader matching "*$entry*" } else { # return entry as-is if wildcards already present $_ } }) } $done = @{} } process { # define internal function to process individual image files function processImageFile { param($item) # get full path of current image file being processed $image = $PSItem.FullName # output current image being processed for debugging purposes Microsoft.PowerShell.Utility\Write-Verbose ( "Processing image: $image") # initialize metadata containers for this image with empty defaults $keywordsFound = @() # initialize description container $descriptionFound = $null # initialize metadata file path variable $metadataFile = $null # try to load description metadata in requested language if not english if ($language -ne 'English' -and [System.IO.File]::Exists( "$($image):description.$language.json")) { # log that language-specific metadata was found Microsoft.PowerShell.Utility\Write-Verbose ( "Found $language metadata for $image") # set path to language-specific description file $metadataFile = "$($image):description.$language.json" } # fallback to english if language-specific file doesn't exist elseif ([System.IO.File]::Exists("$($image):description.json")) { # log that english fallback metadata was found Microsoft.PowerShell.Utility\Write-Verbose ( "Found English metadata for $image") # set path to english description file $metadataFile = "$($image):description.json" } # try to load description metadata if any file was found if ($metadataFile) { try { # read and parse description json from alternate data stream $descriptionFound = [System.IO.File]::ReadAllText( $metadataFile) | Microsoft.PowerShell.Utility\ConvertFrom-Json # extract keywords from description if they exist in metadata $keywordsFound = ($null -eq $descriptionFound.keywords) ? @() : $descriptionFound.keywords } catch { # reset description if json parsing fails $descriptionFound = $null # log parsing failure for debugging purposes Microsoft.PowerShell.Utility\Write-Verbose ( "Failed to parse metadata from $metadataFile") } } # initialize people metadata container with default structure $peopleFound = @{count = 0; faces = @() } # try to load people metadata if alternate data stream exists if ([System.IO.File]::Exists("$($image):people.json")) { try { # read and parse people json from alternate data stream $peopleFound = [System.IO.File]::ReadAllText( "$($image):people.json") | Microsoft.PowerShell.Utility\ConvertFrom-Json # ensure people data has proper structure or reset to default $peopleFound = (($null -eq $peopleFound) -or ($peopleFound.count -eq 0)) ? @{count = 0; faces = @() } : $peopleFound } catch { # reset people data if json parsing fails $peopleFound = @{count = 0; faces = @() } } } # initialize objects metadata container with default structure $objectsFound = @{ count = 0; objects = @(); object_counts = @{} } # try to load objects metadata if alternate data stream exists if ([System.IO.File]::Exists("$($image):objects.json")) { try { # read and parse objects json from alternate data stream $parsedObjects = [System.IO.File]::ReadAllText( "$($image):objects.json") | Microsoft.PowerShell.Utility\ConvertFrom-Json # if parsed data is not null and has predictions if ($null -ne $parsedObjects -and $null -ne $parsedObjects.predictions) { # remap to the structure the script expects $objectsFound = @{ count = $parsedObjects.predictions.Count objects = $parsedObjects.predictions object_counts = $parsedObjects.object_counts } } } catch { # reset objects data if json parsing fails $objectsFound = @{ count = 0; objects = @(); object_counts = @{} } } } # initialize scenes metadata container with default structure $scenesFound = @{ success = $false; scene = 'unknown'; confidence = 0.0 } # try to load scenes metadata if alternate data stream exists if ([System.IO.File]::Exists("$($image):scenes.json")) { try { # read and parse scenes json from alternate data stream $parsedScenes = [System.IO.File]::ReadAllText( "$($image):scenes.json") | Microsoft.PowerShell.Utility\ConvertFrom-Json # if parsed data is not null and has scene data if ($null -ne $parsedScenes -and $null -ne $parsedScenes.scene) { $scenesFound = $parsedScenes } } catch { # reset scenes data if json parsing fails $scenesFound = @{ success = $false; scene = 'unknown'; confidence = 0.0 } } } # determine if image has search criteria or metadata for filtering $hasSearchCriteria = (($null -ne $Keywords) -and ($Keywords.Length -gt 0)) -or (($null -ne $People) -and ($People.Count -gt 0)) -or (($null -ne $Objects) -and ($Objects.Count -gt 0)) -or (($null -ne $Scenes) -and ($Scenes.Count -gt 0)) -or $HasNudity -or $NoNudity -or $HasExplicitContent -or $NoExplicitContent -or (($null -ne $PictureType) -and ($PictureType.Count -gt 0)) -or (($null -ne $StyleType) -and ($StyleType.Count -gt 0)) -or (($null -ne $OverallMood) -and ($OverallMood.Count -gt 0)) -or (($null -ne $DescriptionSearch) -and ($DescriptionSearch.Count -gt 0)) -or (($null -ne $MetaCameraMake) -and ($MetaCameraMake.Count -gt 0)) -or (($null -ne $MetaCameraModel) -and ($MetaCameraModel.Count -gt 0)) -or (($null -ne $MetaWidth) -and ($MetaWidth.Count -gt 0)) -or (($null -ne $MetaHeight) -and ($MetaHeight.Count -gt 0)) -or (($null -ne $MetaGPSLatitude) -and ($MetaGPSLatitude.Count -gt 0)) -or (($null -ne $MetaGPSLongitude) -and ($MetaGPSLongitude.Count -gt 0)) -or (($null -ne $MetaGPSAltitude) -and ($MetaGPSAltitude.Count -gt 0)) -or (($null -ne $MetaExposureTime) -and ($MetaExposureTime.Count -gt 0)) -or (($null -ne $MetaFNumber) -and ($MetaFNumber.Count -gt 0)) -or (($null -ne $MetaISO) -and ($MetaISO.Count -gt 0)) -or (($null -ne $MetaFocalLength) -and ($MetaFocalLength.Count -gt 0)) -or (($null -ne $MetaDateTaken) -and ($MetaDateTaken.Count -gt 0)) -or (($null -ne $GeoLocation) -and ($GeoLocation.Count -eq 2)) -or ($null -ne $MinConfidenceRatio) # assume match if no search criteria specified (return all images with metadata) # if we have search criteria, start with true and set to false if any criteria fails (AND logic) $found = $true # initialize individual criteria match results for proper AND logic between parameter types $keywordMatch = $true $peopleMatch = $true $objectMatch = $true $sceneMatch = $true $descriptionMatch = $true $pictureTypeMatch = $true $styleTypeMatch = $true $moodMatch = $true $contentMatch = $true $exifMatch = $true $anyMatch = $true $confidenceMatch = $true # check basic content filtering criteria (nudity and explicit content) if ($HasNudity -or $NoNudity -or $HasExplicitContent -or $NoExplicitContent) { $contentMatch = $false # Start with false, set true if any content criteria matches # check if nudity is required and image has nudity flag set to true if ($HasNudity -and ($null -ne $descriptionFound) -and ($descriptionFound.has_nudity -eq $true)) { $contentMatch = $true } # check if no nudity is required and image has nudity flag not set to true if ($NoNudity -and ($null -ne $descriptionFound) -and ($descriptionFound.has_nudity -ne $true)) { $contentMatch = $true } # check if explicit content is required and image has explicit content flag set to true if ($HasExplicitContent -and ($null -ne $descriptionFound) -and ($descriptionFound.has_explicit_content -eq $true)) { $contentMatch = $true } # check if no explicit content is required and image has explicit content flag not set to true if ($NoExplicitContent -and ($null -ne $descriptionFound) -and ($descriptionFound.has_explicit_content -ne $true)) { $contentMatch = $true } } # check description search criteria against image description metadata if ($null -ne $DescriptionSearch -and $DescriptionSearch.Count -gt 0) { $descriptionMatch = $false # Start with false, set true if any description matches if ($null -ne $descriptionFound -and $null -ne $descriptionFound.description) { # check each required keyword against description content foreach ($requiredDescriptionPhrase in $DescriptionSearch) { # use wildcard matching for flexible description search against both long and short descriptions if ($descriptionFound.description.long_description -like $requiredDescriptionPhrase -or $descriptionFound.description.short_description -like $requiredDescriptionPhrase) { $descriptionMatch = $true break } } } } # perform picture type filtering against image metadata if ($null -ne $PictureType -and $PictureType.Count -gt 0) { $pictureTypeMatch = $false # Start with false, set true if any picture type matches if ($null -ne $descriptionFound) { # check each required picture type against image metadata foreach ($requiredPictureType in $PictureType) { # use wildcard matching for flexible picture type filtering if ($descriptionFound.picture_type -like $requiredPictureType) { $pictureTypeMatch = $true break } } } } # perform style type filtering against image metadata if ($null -ne $StyleType -and $StyleType.Count -gt 0) { $styleTypeMatch = $false # Start with false, set true if any style type matches if ($null -ne $descriptionFound) { # check each required style type against image metadata foreach ($requiredStyleType in $StyleType) { # use wildcard matching for flexible style type filtering if ($descriptionFound.style_type -like $requiredStyleType) { $styleTypeMatch = $true break } } } } # perform overall mood filtering against image metadata if ($null -ne $OverallMood -and $OverallMood.Count -gt 0) { $moodMatch = $false # Start with false, set true if any mood matches if ($null -ne $descriptionFound) { # check each required mood against image metadata foreach ($requiredMood in $OverallMood) { # use wildcard matching for flexible mood filtering if ($descriptionFound.overall_mood_of_image -like $requiredMood) { $moodMatch = $true break } } } } # perform keywords filtering if keywords criteria specified if ($null -ne $Keywords -and $Keywords.Length -gt 0) { $keywordMatch = $false # Start with false, set true if any keyword matches (OR within parameter) # check each found keyword against search criteria using nested loops foreach ($foundKeyword in $keywordsFound) { # check each searched keywords against found keyword with wildcard matching foreach ($searchedForKeyword in $Keywords) { # use wildcard matching for flexible keyword search if ($foundKeyword -like $searchedForKeyword) { $keywordMatch = $true break } } # exit early if any keyword matches to improve performance if ($keywordMatch) { break } } } # perform people filtering if people criteria specified if ($null -ne $People -and $People.Length -gt 0) { $peopleMatch = $false # Start with false, set true if any person matches (OR within parameter) # check each found person against search criteria using nested loops foreach ($foundPerson in $peopleFound.faces) { # check each searched person against found person with wildcard matching foreach ($searchedForPerson in $People) { # use wildcard matching for flexible people search if ($foundPerson -like $searchedForPerson) { $peopleMatch = $true break } } # exit early if any person matches to improve performance if ($peopleMatch) { break } } } # perform objects filtering if objects criteria specified if ($null -ne $Objects -and $Objects.Length -gt 0) { $objectMatch = $false # Start with false, set true if any object matches (OR within parameter) # check each found object against search criteria using nested loops foreach ($foundObject in $objectsFound.objects) { # check each searched object against found object with wildcard matching foreach ($searchedForObject in $Objects) { # use wildcard matching for flexible objects search if ($foundObject.label -like $searchedForObject) { $objectMatch = $true break } } # exit early if any object matches to improve performance if ($objectMatch) { break } } } # perform scenes filtering if scenes criteria specified if ($null -ne $Scenes -and $Scenes.Count -gt 0) { $sceneMatch = $false # Start with false, set true if any scene matches (OR within parameter) # output debug information for scene filtering when verbose mode is enabled if ($VerbosePreference -eq 'Continue') { Microsoft.PowerShell.Utility\Write-Verbose ( 'Scene filtering - Searching for: ' + "$($Scenes -join ', ')") Microsoft.PowerShell.Utility\Write-Verbose ( "Scene filtering - Found scene: $($scenesFound.scene)") Microsoft.PowerShell.Utility\Write-Verbose ( 'Scene filtering - Scene success: ' + "$($scenesFound.success)") } # check if the found scene matches any of the search criteria with wildcard support foreach ($searchedForScene in $Scenes) { # use wildcard matching for flexible scene search if ($scenesFound.scene -like $searchedForScene) { $sceneMatch = $true # output match confirmation when verbose mode is enabled if ($VerbosePreference -eq 'Continue') { Microsoft.PowerShell.Utility\Write-Verbose ( 'Scene filtering - Match found: ' + "'$($scenesFound.scene)' matches " + "'$searchedForScene'") } break } } # output no match message when verbose mode is enabled and no matches found if (-not $sceneMatch -and $VerbosePreference -eq 'Continue') { Microsoft.PowerShell.Utility\Write-Verbose ( 'Scene filtering - No match found for scene: ' + "$($scenesFound.scene)") } } # perform confidence filtering if minimum confidence ratio is specified if ($null -ne $MinConfidenceRatio) { $confidenceMatch = $false # Start with false, set true if any confidence meets minimum threshold # filter scenes by confidence - remove scenes below minimum threshold if ($null -ne $scenesFound -and $null -ne $scenesFound.confidence) { if ($scenesFound.confidence -ge $MinConfidenceRatio) { $confidenceMatch = $true # output scene confidence match for debugging purposes Microsoft.PowerShell.Utility\Write-Verbose ( "Confidence filtering - Scene match: " + "scene confidence $($scenesFound.confidence) >= " + "minimum $MinConfidenceRatio for image $image") } else { # filter out the scene data by setting it to default $scenesFound = @{ success = $false scene = 'unknown' label = 'unknown' confidence = 0.0 } # output scene confidence rejection for debugging purposes Microsoft.PowerShell.Utility\Write-Verbose ( "Confidence filtering - Scene filtered out: " + "scene confidence below minimum $MinConfidenceRatio for image $image") } } # filter people by confidence - remove people predictions below minimum threshold if ($null -ne $peopleFound -and $null -ne $peopleFound.predictions -and $peopleFound.predictions.Count -gt 0) { $filteredPredictions = @() foreach ($prediction in $peopleFound.predictions) { if ($null -ne $prediction.confidence -and $prediction.confidence -ge $MinConfidenceRatio) { $filteredPredictions += $prediction $confidenceMatch = $true # output people confidence match for debugging purposes Microsoft.PowerShell.Utility\Write-Verbose ( "Confidence filtering - People match: " + "person '$($prediction.label)' confidence $($prediction.confidence) >= " + "minimum $MinConfidenceRatio for image $image") } else { # output people confidence rejection for debugging purposes Microsoft.PowerShell.Utility\Write-Verbose ( "Confidence filtering - Person filtered out: " + "'$($prediction.label)' confidence below minimum $MinConfidenceRatio for image $image") } } $peopleFound.predictions = $filteredPredictions $peopleFound.count = $filteredPredictions.Count # update faces array to match filtered predictions $peopleFound.faces = $filteredPredictions | Microsoft.PowerShell.Core\ForEach-Object { $_.label } } # filter objects by confidence - remove object predictions below minimum threshold if ($null -ne $objectsFound -and $null -ne $objectsFound.objects -and $objectsFound.objects.Count -gt 0) { $filteredObjects = @() $filteredCounts = @{} foreach ($obj in $objectsFound.objects) { if ($null -ne $obj.confidence -and $obj.confidence -ge $MinConfidenceRatio) { $filteredObjects += $obj $confidenceMatch = $true # update object counts for filtered objects if ($filteredCounts.ContainsKey($obj.label)) { $filteredCounts[$obj.label]++ } else { $filteredCounts[$obj.label] = 1 } # output object confidence match for debugging purposes Microsoft.PowerShell.Utility\Write-Verbose ( "Confidence filtering - Object match: " + "object '$($obj.label)' confidence $($obj.confidence) >= " + "minimum $MinConfidenceRatio for image $image") } else { # output object confidence rejection for debugging purposes Microsoft.PowerShell.Utility\Write-Verbose ( "Confidence filtering - Object filtered out: " + "'$($obj.label)' confidence below minimum $MinConfidenceRatio for image $image") } } $objectsFound.objects = $filteredObjects $objectsFound.count = $filteredObjects.Count $objectsFound.object_counts = $filteredCounts } # if no confidence match was found and MinConfidenceRatio is specified, skip this image if (-not $confidenceMatch) { # output no confidence match for debugging purposes Microsoft.PowerShell.Utility\Write-Verbose ( "Confidence filtering - No confidence data meets minimum threshold " + "$MinConfidenceRatio for image $image") } } # perform EXIF metadata filtering if criteria specified $width = $null $height = $null $metadata = $null if ($hasSearchCriteria -and (($null -ne $MetaCameraMake -and $MetaCameraMake.Count -gt 0) -or ($null -ne $MetaCameraModel -and $MetaCameraModel.Count -gt 0) -or ($null -ne $MetaWidth -and $MetaWidth.Count -gt 0) -or ($null -ne $MetaHeight -and $MetaHeight.Count -gt 0) -or ($null -ne $MetaGPSLatitude -and $MetaGPSLatitude.Count -gt 0) -or ($null -ne $MetaGPSLongitude -and $MetaGPSLongitude.Count -gt 0) -or ($null -ne $MetaGPSAltitude -and $MetaGPSAltitude.Count -gt 0) -or ($null -ne $MetaExposureTime -and $MetaExposureTime.Count -gt 0) -or ($null -ne $MetaFNumber -and $MetaFNumber.Count -gt 0) -or ($null -ne $MetaISO -and $MetaISO.Count -gt 0) -or ($null -ne $MetaFocalLength -and $MetaFocalLength.Count -gt 0) -or ($null -ne $MetaDateTaken -and $MetaDateTaken.Count -gt 0) -or ($null -ne $GeoLocation -and $GeoLocation.Count -eq 2))) { $exifMatch = $false # Start with false, will be set true if EXIF criteria match try { # get metadata for EXIF filtering $metadataStream = "${image}:EXIF.json" if (Microsoft.PowerShell.Management\Test-Path -LiteralPath $metadataStream -ErrorAction SilentlyContinue) { try { $cachedMetadata = Microsoft.PowerShell.Management\Get-Content -LiteralPath $metadataStream -Raw -ErrorAction SilentlyContinue if ($cachedMetadata) { $metadata = $cachedMetadata | Microsoft.PowerShell.Utility\ConvertFrom-Json -AsHashtable -ErrorAction Stop } } catch { Microsoft.PowerShell.Utility\Write-Verbose "Failed to read cached metadata: $_" $metadata = GenXdev.Helpers\Get-ImageMetadata -ImagePath $image } } else { $metadata = GenXdev.Helpers\Get-ImageMetadata -ImagePath $image } if ($null -ne $metadata) { $width = $metadata.Basic.Width $height = $metadata.Basic.Height $exifMatch = $true # Start with true for AND logic between EXIF criteria # check camera make filter (OR within parameter, AND with other EXIF) if ($null -ne $MetaCameraMake -and $MetaCameraMake.Count -gt 0) { $makeMatch = $false foreach ($make in $MetaCameraMake) { if ($null -ne $metadata.Camera.Make -and $metadata.Camera.Make -like $make) { $makeMatch = $true break } } $exifMatch = $exifMatch -and $makeMatch } # check camera model filter (OR within parameter, AND with other EXIF) if ($exifMatch -and $null -ne $MetaCameraModel -and $MetaCameraModel.Count -gt 0) { $modelMatch = $false foreach ($model in $MetaCameraModel) { if ($null -ne $metadata.Camera.Model -and $metadata.Camera.Model -like $model) { $modelMatch = $true break } } $exifMatch = $exifMatch -and $modelMatch } # Width filter (exact or range) if ($exifMatch -and $null -ne $MetaWidth -and $MetaWidth.Count -gt 0) { $widthMatch = $false if ($MetaWidth.Count -eq 1) { $widthMatch = $width -eq $MetaWidth[0] } elseif ($MetaWidth.Count -eq 2) { $widthMatch = $width -ge $MetaWidth[0] -and $width -le $MetaWidth[1] } $exifMatch = $exifMatch -and $widthMatch } # Height filter (exact or range) if ($exifMatch -and $null -ne $MetaHeight -and $MetaHeight.Count -gt 0) { $heightMatch = $false if ($MetaHeight.Count -eq 1) { $heightMatch = $height -eq $MetaHeight[0] } elseif ($MetaHeight.Count -eq 2) { $heightMatch = $height -ge $MetaHeight[0] -and $height -le $MetaHeight[1] } $exifMatch = $exifMatch -and $heightMatch } # GPS filtering - exclude images without GPS data when GPS parameters are specified if ($exifMatch -and (($null -ne $MetaGPSLatitude -and $MetaGPSLatitude.Count -gt 0) -or ($null -ne $MetaGPSLongitude -and $MetaGPSLongitude.Count -gt 0) -or ($null -ne $MetaGPSAltitude -and $MetaGPSAltitude.Count -gt 0) -or ($null -ne $GeoLocation -and $GeoLocation.Count -eq 2))) { $gpsMatch = $false # Check if image has GPS coordinates in metadata if ($null -ne $metadata.GPS -and $null -ne $metadata.GPS.Latitude -and $null -ne $metadata.GPS.Longitude) { $imageLatitude = $metadata.GPS.Latitude $imageLongitude = $metadata.GPS.Longitude $imageAltitude = $metadata.GPS.Altitude # GPS Latitude filter (exact or range) if ($null -ne $MetaGPSLatitude -and $MetaGPSLatitude.Count -gt 0) { if ($MetaGPSLatitude.Count -eq 1) { $gpsMatch = $imageLatitude -eq $MetaGPSLatitude[0] } elseif ($MetaGPSLatitude.Count -eq 2) { $gpsMatch = $imageLatitude -ge $MetaGPSLatitude[0] -and $imageLatitude -le $MetaGPSLatitude[1] } } # GPS Longitude filter (exact or range) - AND with latitude if both specified if ($gpsMatch -and $null -ne $MetaGPSLongitude -and $MetaGPSLongitude.Count -gt 0) { $longitudeMatch = $false if ($MetaGPSLongitude.Count -eq 1) { $longitudeMatch = $imageLongitude -eq $MetaGPSLongitude[0] } elseif ($MetaGPSLongitude.Count -eq 2) { $longitudeMatch = $imageLongitude -ge $MetaGPSLongitude[0] -and $imageLongitude -le $MetaGPSLongitude[1] } $gpsMatch = $gpsMatch -and $longitudeMatch } elseif ($null -ne $MetaGPSLongitude -and $MetaGPSLongitude.Count -gt 0) { # Only longitude specified, no latitude filter if ($MetaGPSLongitude.Count -eq 1) { $gpsMatch = $imageLongitude -eq $MetaGPSLongitude[0] } elseif ($MetaGPSLongitude.Count -eq 2) { $gpsMatch = $imageLongitude -ge $MetaGPSLongitude[0] -and $imageLongitude -le $MetaGPSLongitude[1] } } # GPS Altitude filter (exact or range) - AND with other GPS criteria if ($gpsMatch -and $null -ne $MetaGPSAltitude -and $MetaGPSAltitude.Count -gt 0 -and $null -ne $imageAltitude) { $altitudeMatch = $false if ($MetaGPSAltitude.Count -eq 1) { $altitudeMatch = $imageAltitude -eq $MetaGPSAltitude[0] } elseif ($MetaGPSAltitude.Count -eq 2) { $altitudeMatch = $imageAltitude -ge $MetaGPSAltitude[0] -and $imageAltitude -le $MetaGPSAltitude[1] } $gpsMatch = $gpsMatch -and $altitudeMatch } elseif ($null -ne $MetaGPSAltitude -and $MetaGPSAltitude.Count -gt 0 -and $null -ne $imageAltitude) { # Only altitude specified if ($MetaGPSAltitude.Count -eq 1) { $gpsMatch = $imageAltitude -eq $MetaGPSAltitude[0] } elseif ($MetaGPSAltitude.Count -eq 2) { $gpsMatch = $imageAltitude -ge $MetaGPSAltitude[0] -and $imageAltitude -le $MetaGPSAltitude[1] } } elseif ($null -ne $MetaGPSAltitude -and $MetaGPSAltitude.Count -gt 0) { # Altitude filter specified but image has no altitude data $gpsMatch = $false } # GeoLocation proximity filter - AND with other GPS criteria if ($gpsMatch -and $null -ne $GeoLocation -and $GeoLocation.Count -eq 2) { $targetLatitude = $GeoLocation[0] $targetLongitude = $GeoLocation[1] $maxDistance = $null -ne $MaxDistanceInMeters ? $MaxDistanceInMeters : 1000 # Default 1km # Calculate distance using Haversine formula $earthRadius = 6371000 # Earth's radius in meters $lat1Rad = [Math]::PI * $imageLatitude / 180 $lat2Rad = [Math]::PI * $targetLatitude / 180 $deltaLatRad = [Math]::PI * ($targetLatitude - $imageLatitude) / 180 $deltaLonRad = [Math]::PI * ($targetLongitude - $imageLongitude) / 180 $a = [Math]::Sin($deltaLatRad / 2) * [Math]::Sin($deltaLatRad / 2) + [Math]::Cos($lat1Rad) * [Math]::Cos($lat2Rad) * [Math]::Sin($deltaLonRad / 2) * [Math]::Sin($deltaLonRad / 2) $c = 2 * [Math]::Atan2([Math]::Sqrt($a), [Math]::Sqrt(1 - $a)) $distance = $earthRadius * $c $proximityMatch = $distance -le $maxDistance $gpsMatch = $gpsMatch -and $proximityMatch } elseif ($null -ne $GeoLocation -and $GeoLocation.Count -eq 2) { # Only GeoLocation specified (no other GPS filters) $targetLatitude = $GeoLocation[0] $targetLongitude = $GeoLocation[1] $maxDistance = $null -ne $MaxDistanceInMeters ? $MaxDistanceInMeters : 1000 # Calculate distance using Haversine formula $earthRadius = 6371000 $lat1Rad = [Math]::PI * $imageLatitude / 180 $lat2Rad = [Math]::PI * $targetLatitude / 180 $deltaLatRad = [Math]::PI * ($targetLatitude - $imageLatitude) / 180 $deltaLonRad = [Math]::PI * ($targetLongitude - $imageLongitude) / 180 $a = [Math]::Sin($deltaLatRad / 2) * [Math]::Sin($deltaLatRad / 2) + [Math]::Cos($lat1Rad) * [Math]::Cos($lat2Rad) * [Math]::Sin($deltaLonRad / 2) * [Math]::Sin($deltaLonRad / 2) $c = 2 * [Math]::Atan2([Math]::Sqrt($a), [Math]::Sqrt(1 - $a)) $distance = $earthRadius * $c $gpsMatch = $distance -le $maxDistance } } # If GPS parameters are specified but image has no GPS data, exclude it # $gpsMatch remains $false, which will make $exifMatch false $exifMatch = $exifMatch -and $gpsMatch } } } catch { Microsoft.PowerShell.Utility\Write-Warning ("Could not process EXIF metadata for ${image}: $_") $exifMatch = $false } } # check Any parameter - match against any metadata type (OR logic within Any) if ($anySearchTerms.Length -gt 0) { $anyMatch = $false # Start with false, set true if any criteria matches foreach ($anyTerm in $anySearchTerms) { # Check file path and filename if ($image -like $anyTerm) { $anyMatch = $true break } # Check filename only (without path) $filename = Microsoft.PowerShell.Management\Split-Path -Leaf $image if ($filename -like $anyTerm) { $anyMatch = $true break } # Check description search if ($null -ne $descriptionFound -and $null -ne $descriptionFound.description) { if ($descriptionFound.description.long_description -like $anyTerm -or $descriptionFound.description.short_description -like $anyTerm) { $anyMatch = $true break } # Check ImageFilename from description metadata if ($descriptionFound.description.ImageFilename -like $anyTerm) { $anyMatch = $true break } # Check ImageCollection from description metadata if ($descriptionFound.description.ImageCollection -like $anyTerm) { $anyMatch = $true break } } # Check keywords foreach ($foundKeyword in $keywordsFound) { if ($foundKeyword -like $anyTerm) { $anyMatch = $true break } } if ($anyMatch) { break } # Check people foreach ($foundPerson in $peopleFound.faces) { if ($foundPerson -like $anyTerm) { $anyMatch = $true break } } if ($anyMatch) { break } # Check objects foreach ($foundObject in $objectsFound.objects) { if ($foundObject.label -like $anyTerm) { $anyMatch = $true break } } if ($anyMatch) { break } # Check scenes if ($scenesFound.scene -like $anyTerm -or $scenesFound.label -like $anyTerm) { $anyMatch = $true break } # Check picture type if ($null -ne $descriptionFound -and $descriptionFound.picture_type -like $anyTerm) { $anyMatch = $true break } # Check style type if ($null -ne $descriptionFound -and $descriptionFound.style_type -like $anyTerm) { $anyMatch = $true break } # Check overall mood if ($null -ne $descriptionFound -and $descriptionFound.overall_mood_of_image -like $anyTerm) { $anyMatch = $true break } # Check EXIF metadata if available if ($null -ne $metadata) { # Check camera make and model if ($metadata.Camera.Make -like $anyTerm -or $metadata.Camera.Model -like $anyTerm) { $anyMatch = $true break } # Check software used if ($metadata.Other.Software -like $anyTerm) { $anyMatch = $true break } # Check basic file information if ($metadata.Basic.FileName -like $anyTerm -or $metadata.Basic.Format -like $anyTerm -or $metadata.Basic.FileExtension -like $anyTerm) { $anyMatch = $true break } } } } # combine all criteria using proper AND logic between parameter types # if no search criteria specified, return all images with metadata if (-not $hasSearchCriteria) { $found = $true } else { # AND logic between different parameter types: ALL specified criteria must match $found = $keywordMatch -and $peopleMatch -and $objectMatch -and $sceneMatch -and $descriptionMatch -and $pictureTypeMatch -and $styleTypeMatch -and $moodMatch -and $contentMatch -and $exifMatch -and $anyMatch -and $confidenceMatch } # return image data if all criteria matched if ($found) { # output match found for debugging purposes Microsoft.PowerShell.Utility\Write-Verbose ( "Found matching image: $image") # get image dimensions and metadata for output (if not already loaded by EXIF filtering) if ($null -eq $metadata) { try { # try to get metadata for output purposes $metadataStream = "${image}:EXIF.json" if (Microsoft.PowerShell.Management\Test-Path -LiteralPath $metadataStream -ErrorAction SilentlyContinue) { try { $cachedMetadata = Microsoft.PowerShell.Management\Get-Content -LiteralPath $metadataStream -Raw -ErrorAction SilentlyContinue if ($cachedMetadata) { $metadata = $cachedMetadata | Microsoft.PowerShell.Utility\ConvertFrom-Json -AsHashtable -ErrorAction Stop } } catch { Microsoft.PowerShell.Utility\Write-Verbose "Failed to read cached metadata: $_" $metadata = GenXdev.Helpers\Get-ImageMetadata -ImagePath $image } } else { $metadata = GenXdev.Helpers\Get-ImageMetadata -ImagePath $image } if ($null -ne $metadata) { $width = $metadata.Basic.Width $height = $metadata.Basic.Height } else { # fallback to just getting dimensions if metadata extraction fails $imageObj = [System.Drawing.Image]::FromFile($image) $width = $imageObj.Width $height = $imageObj.Height $null = $imageObj.Dispose() } } catch { Microsoft.PowerShell.Utility\Write-Warning ("Could not process image ${image}: $_") return } } # return standardized hashtable with all image metadata and processing results # ensuring consistent structure with Find-IndexedImage $standardizedOutput = @{ path = $image width = $width height = $height metadata = $metadata keywords = $keywordsFound description = $descriptionFound people = $peopleFound objects = $objectsFound scenes = $scenesFound } # ensure people object has predictions property for consistency with database output if ($null -ne $standardizedOutput.people -and -not $standardizedOutput.people.PSObject.Properties['predictions']) { # convert to PSCustomObject and add predictions array $standardizedOutput.people = [PSCustomObject]@{ count = $standardizedOutput.people.count faces = $standardizedOutput.people.faces predictions = @() # empty array for consistency } } # ensure objects object has objects property for consistency with database output if ($null -ne $standardizedOutput.objects -and -not $standardizedOutput.objects.PSObject.Properties['objects']) { # convert to PSCustomObject and add objects array $standardizedOutput.objects = [PSCustomObject]@{ count = $standardizedOutput.objects.count objects = if ($standardizedOutput.objects.objects) { $standardizedOutput.objects.objects } else { @() } object_counts = if ($standardizedOutput.objects.object_counts) { $standardizedOutput.objects.object_counts } else { @{} } } } # ensure scenes object has all required properties for consistency if ($null -ne $standardizedOutput.scenes) { $standardizedOutput.scenes = [PSCustomObject]@{ success = $standardizedOutput.scenes.success scene = $standardizedOutput.scenes.scene confidence = $standardizedOutput.scenes.confidence label = if ($standardizedOutput.scenes.PSObject.Properties['label']) { $standardizedOutput.scenes.label } else { $standardizedOutput.scenes.scene } confidence_percentage = if ($standardizedOutput.scenes.PSObject.Properties['confidence_percentage']) { $standardizedOutput.scenes.confidence_percentage } else { $standardizedOutput.scenes.confidence * 100 } processed_at = if ($standardizedOutput.scenes.PSObject.Properties['processed_at']) { $standardizedOutput.scenes.processed_at } else { $null } } } # ensure description object has all required properties and consistent structure if ($null -ne $standardizedOutput.description) { # create standardized description object structure $descObj = [PSCustomObject]@{ has_explicit_content = if ($standardizedOutput.description.PSObject.Properties['has_explicit_content']) { [bool]$standardizedOutput.description.has_explicit_content } else { $false } has_nudity = if ($standardizedOutput.description.PSObject.Properties['has_nudity']) { [bool]$standardizedOutput.description.has_nudity } else { $false } picture_type = if ($standardizedOutput.description.PSObject.Properties['picture_type']) { $standardizedOutput.description.picture_type } else { '' } overall_mood_of_image = if ($standardizedOutput.description.PSObject.Properties['overall_mood_of_image']) { $standardizedOutput.description.overall_mood_of_image } else { '' } style_type = if ($standardizedOutput.description.PSObject.Properties['style_type']) { $standardizedOutput.description.style_type } else { '' } keywords = $keywordsFound } # add description content if available if ($standardizedOutput.description.PSObject.Properties['description']) { $descObj | Microsoft.PowerShell.Utility\Add-Member -MemberType NoteProperty -Name 'description' -Value $standardizedOutput.description.description } if ($standardizedOutput.description.PSObject.Properties['short_description']) { $descObj | Microsoft.PowerShell.Utility\Add-Member -MemberType NoteProperty -Name 'short_description' -Value $standardizedOutput.description.short_description } if ($standardizedOutput.description.PSObject.Properties['long_description']) { $descObj | Microsoft.PowerShell.Utility\Add-Member -MemberType NoteProperty -Name 'long_description' -Value $standardizedOutput.description.long_description } $standardizedOutput.description = $descObj } Microsoft.PowerShell.Utility\Write-Output $standardizedOutput } } # handle input object processing from pipeline for direct file paths if ($fileNames.Count -gt 0) { # iterate through each resolved filename from input objects $fileNames | Microsoft.PowerShell.Core\ForEach-Object { # process each input object as an image file path $path = $_ # skip null or empty paths if ($null -eq $path) { return } # convert relative path to absolute path for consistency $path = GenXdev.FileSystem\Expand-Path $path # verify file exists before processing if ([IO.File]::Exists($path) -eq $false) { # notify user of missing file Microsoft.PowerShell.Utility\Write-Host ( "The file '$path' does not exist.") return } # filter on pathlike patterns if specified for direct file input filtering if ($null -ne $PathLike -and $PathLike.Count -gt 0) { # assume no match until pattern is found $found = $false # check each path pattern against current file path foreach ($pattern in $PathLike) { # expand pattern to full path if needed $patternDir = GenXdev.FileSystem\Expand-Path $pattern # add wildcards if pattern doesn't already contain them if ($patternDir.IndexOfAny('?' + '*') -eq -1) { $patternDir = "*$patternDir*" } # check if current path matches pattern if ($path -like $patternDir) { $found = $true break } } # skip file if no patterns match if (-not $found) { return } } # process the image file and handle output appropriately based on display mode processImageFile $path | Microsoft.PowerShell.Core\ForEach-Object { if ($done."$(($_.Path))") { return } $done."$(($_.Path))" = $true; # output directly or add to results based on browser display setting if (-not $ShowInBrowser) { Microsoft.PowerShell.Utility\Write-Output $_ } else { # add to results collection for browser display $null = $results.Add($_) } } } } # handle append mode - output InputObject first, then process as normal if ($Append -and $null -ne $InputObject) { # first, output all InputObject content using Write-Output $InputObject | Microsoft.PowerShell.Utility\Write-Output # then clear InputObject and continue processing as if it wasn't set $originalInputObject = $InputObject $InputObject = $null Microsoft.PowerShell.Utility\Write-Verbose ( "Append mode: Output ${originalInputObject.Count} objects, " + "now processing search criteria" ) } # handle input object processing from pipeline for complex input objects if ($null -ne $InputObject) { # process each complex input object from pipeline $InputObject | Microsoft.PowerShell.Core\ForEach-Object { # extract path from input object $path = $_.Path # skip objects without path property if ($null -eq $path) { return } # normalize file uri to local path if needed if ($path.StartsWith('file://')) { $path = $path.Substring(7).Replace('/', '\') } # convert relative path to absolute path for consistency $path = GenXdev.FileSystem\Expand-Path $path # verify file exists before processing if ([IO.File]::Exists($path) -eq $false) { # notify user of missing file Microsoft.PowerShell.Utility\Write-Host ( "The file '$path' does not exist.") return } # filter on pathlike patterns if specified if ($null -ne $PathLike -and $PathLike.Count -gt 0) { $found = $false foreach ($pattern in $PathLike) { $patternDir = GenXdev.FileSystem\Expand-Path $pattern if ($patternDir.IndexOfAny('?' + '*') -eq -1) { $patternDir = "*$patternDir*" } if ($path -like $patternDir) { $found = $true break } } if (-not $found) { return } } # process the image file and handle output appropriately processImageFile $path | Microsoft.PowerShell.Core\ForEach-Object { if ($done."$(($_.Path))") { return } $done."$(($_.Path))" = $true; if (-not $ShowInBrowser) { Microsoft.PowerShell.Utility\Write-Output $_ } else { $null = $results.Add($_) } } } return } # remove duplicate directories from search list for efficiency $directories = $directories | Microsoft.PowerShell.Utility\Select-Object -Unique # iterate through each specified image directory to scan for images foreach ($imageDirectory in $directories) { # convert relative path to absolute path for consistency $path = GenXdev.FileSystem\Expand-Path $imageDirectory # output directory being scanned for debugging purposes Microsoft.PowerShell.Utility\Write-Verbose "Scanning directory: $path" # validate directory exists before proceeding with search if (-not [System.IO.Directory]::Exists($path)) { # notify user of missing directory and continue with next Microsoft.PowerShell.Utility\Write-Host ( "The directory '$path' does not exist.") continue } # search for image files (jpg, jpeg, gif, png, bmp, webp, tiff, tif) and process each one found Microsoft.PowerShell.Management\Get-ChildItem ` -Path "$path\*.jpg", "$path\*.jpeg", "$path\*.gif", "$path\*.png", "$path\*.bmp", "$path\*.webp", "$path\*.tiff", "$path\*.tif" ` -Recurse:(!$NoRecurse) ` -File ` -ErrorAction SilentlyContinue | Microsoft.PowerShell.Core\ForEach-Object { # filter on pathlike patterns if specified for directory scanning if ($null -ne $PathLike -and ($PathLike.Count -gt 0)) { # assume no match until pattern is found $found = $false # check each path pattern against current image file foreach ($pattern in $PathLike) { # expand pattern to full path if needed $patternDir = GenXdev.FileSystem\Expand-Path $pattern # add wildcards if pattern doesn't already contain them if ($patternDir.IndexOfAny('?' + '*') -eq -1) { $patternDir = "*$patternDir*" } # check if current image path matches pattern if ($PSItem.FullName -like $patternDir) { $found = $true break } } # skip image if no patterns match if (-not $found) { return } } # process the image file and handle output appropriately based on display mode processImageFile $_ | Microsoft.PowerShell.Core\ForEach-Object { # output directly or add to results based on browser display setting if (-not $ShowInBrowser) { Microsoft.PowerShell.Utility\Write-Output $_ } else { # add to results collection for browser display $null = $results.Add($_) } } } } } end { # if showinbrowser is requested, display the gallery using browser interface if ($ShowInBrowser) { # check if any results were found before attempting to display if ((-not $results) -or ($null -eq $results) -or ($results.Length -eq 0)) { # notify user that no images matched the search criteria Microsoft.PowerShell.Utility\Write-Host ('No images found') return } # set default title if empty to provide meaningful gallery header if ([String]::IsNullOrWhiteSpace($Title)) { $Title = 'Image Search Results' } # set default description if empty to show the original command if ([String]::IsNullOrWhiteSpace($Description)) { $Description = $MyInvocation.Statement } # copy parameters for show function call using helper function $params = GenXdev.Helpers\Copy-IdenticalParamValues ` -BoundParameters $PSBoundParameters ` -FunctionName 'GenXdev.AI\Show-FoundImagesInBrowser' ` -DefaultValues (Microsoft.PowerShell.Utility\Get-Variable ` -Scope Local ` -ErrorAction SilentlyContinue) # pass the results to show-foundimagesinbrowser for display GenXdev.AI\Show-FoundImagesInBrowser @params -InputObject $results # return results if passthru is requested for further processing if ($PassThru) { # output each result object to pipeline $results | Microsoft.PowerShell.Core\ForEach-Object { Microsoft.PowerShell.Utility\Write-Output $_ } } } } } ############################################################################### |