Functions/GenXdev.AI.Queries/Get-AIMetaLanguage.ps1
|
################################################################################ <# .SYNOPSIS Gets the configured default language for image metadata operations. .DESCRIPTION This function retrieves the default language used by the GenXdev.AI module for image metadata operations. It checks Global variables first (unless SkipSession is specified), then falls back to persistent preferences, and finally uses system defaults. .PARAMETER Language Optional language override. If specified, this language will be returned instead of retrieving from configuration. .PARAMETER ClearSession When specified, clears the session language setting (Global variable) before retrieving the configuration. .PARAMETER SkipSession When specified, skips checking the session setting (Global variable) and retrieves only from persistent preferences. .EXAMPLE Get-AIMetaLanguage Gets the currently configured language from Global variables or preferences. .EXAMPLE Get-AIMetaLanguage -SkipSession Gets the configured language only from persistent preferences, ignoring any session setting. .EXAMPLE Get-AIMetaLanguage -ClearSession Clears the session language setting and then gets the language from persistent preferences. .EXAMPLE getimgmetalang Uses alias to get the current language configuration. #> function Get-AIMetaLanguage { [CmdletBinding()] [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSAvoidGlobalVars', '')] [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseSingularNouns', '')] [Alias("getimgmetalang")] param( [Parameter( Position = 0, Mandatory = $false, HelpMessage = "The default language for image metadata operations" )] [ValidateSet( "Afrikaans", "Akan", "Albanian", "Amharic", "Arabic", "Armenian", "Azerbaijani", "Basque", "Belarusian", "Bemba", "Bengali", "Bihari", "Bosnian", "Breton", "Bulgarian", "Cambodian", "Catalan", "Cherokee", "Chichewa", "Chinese (Simplified)", "Chinese (Traditional)", "Corsican", "Croatian", "Czech", "Danish", "Dutch", "English", "Esperanto", "Estonian", "Ewe", "Faroese", "Filipino", "Finnish", "French", "Frisian", "Ga", "Galician", "Georgian", "German", "Greek", "Guarani", "Gujarati", "Haitian Creole", "Hausa", "Hawaiian", "Hebrew", "Hindi", "Hungarian", "Icelandic", "Igbo", "Indonesian", "Interlingua", "Irish", "Italian", "Japanese", "Javanese", "Kannada", "Kazakh", "Kinyarwanda", "Kirundi", "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", "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, ############################################################################### # Use alternative settings stored in session for AI preferences like Language, Image collections, etc [Parameter( Mandatory = $false, HelpMessage = "Use alternative settings stored in session for AI preferences like Language, Image collections, etc" )] [switch] $SessionOnly, ############################################################################### # clear the session setting (Global variable) before retrieving [Parameter( Mandatory = $false, HelpMessage = "Clear the session setting (Global variable) before retrieving" )] [switch] $ClearSession, ############################################################################### # Dont use alternative settings stored in session for AI preferences like Language, Image collections, etc [Parameter( Mandatory = $false, HelpMessage = "Dont use alternative settings stored in session for AI preferences like Language, Image collections, etc" )] [Alias("FromPreferences")] [switch] $SkipSession ) begin { # handle clearing session variables first if requested if ($ClearSession) { $Global:DefaultImagesMetaLanguage = $null Microsoft.PowerShell.Utility\Write-Verbose ( "Cleared session language setting: DefaultImagesMetaLanguage" ) } # initialize result object $result = GenXdev.Helpers\Get-DefaultWebLanguage } process { if (-not [string]::IsNullOrWhiteSpace($Language)) { # if no language specified, use default web language $result = $Language return } # determine language based on priority: Global variable first (unless skipped), then preferences (unless SessionOnly) # first check global variable for language (unless SkipSession is specified) if ((-not $SkipSession) -and (-not ([string]::IsNullOrWhiteSpace($Global:DefaultImagesMetaLanguage)))) { # use global variable if available and not empty $result = $Global:DefaultImagesMetaLanguage } elseif (-not $SessionOnly) { # fallback to preference storage $LanguagePreference = $null try { # retrieve language preference from genxdev data storage $json = GenXdev.Data\Get-GenXdevPreference ` -Name "ImagesMetaLanguage" ` -DefaultValue $null ` -ErrorAction SilentlyContinue if (-not [string]::IsNullOrEmpty($json)) { # convert json preference to powershell object $LanguagePreference = $json | Microsoft.PowerShell.Utility\ConvertFrom-Json } } catch { # set to null if preference retrieval fails $LanguagePreference = $null } if (-not ([string]::IsNullOrWhiteSpace(($LanguagePreference)))) { # use preference value if available and not empty $result = $LanguagePreference } else { # final fallback to default language $result = "English" } } else { # SessionOnly is specified but no session variable found, use default language $result = "English" } } end { # return the configured image directories and language return $result } } ################################################################################ |