aotrautils 0.0.1795 → 0.0.1797

aotrautils/aotrautils.build.js

@@ -1,6 +1,6 @@
 
 
-/*utils COMMONS library associated with aotra version : «1_29072022-2359 (24/06/2025-01:42:47)»*/
+/*utils COMMONS library associated with aotra version : «1_29072022-2359 (11/11/2025-17:05:51)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -1618,7 +1618,7 @@ aotest.profile=function(rootObject,methodName,visited=[]){
 
 
 //================================================================
-//================= Tjread control utility methods =================
+//================= Thread control utility methods =================
 //================================================================
 
 
@@ -3868,7 +3868,7 @@ Math.makeMultipleOf=function(bruteValue, multiple,/*OPTIONAL*/roundingMode){
 
 
 getTimer=function(callback, delay){
-	return new Timer(callback, delay);
+	return new SimpleTimer(callback, delay);
 //	let self={
 //		 timerId:null,
 //		 start:null,
@@ -3893,14 +3893,14 @@ getTimer=function(callback, delay){
 
 
 //Usage :
-//var timer=new Timer(function(){
+//var timer=new SimpleTimer(function(){
 //alert("Done!");
 //}, 1000);
 //
 //timer.pause();
 ////Do some stuff...
 //timer.resume();
-var Timer=function(callback, delay){
+var SimpleTimer=function(callback, delay){
   var timerId, start, remaining=delay;
 
   this.pause=function(){
@@ -5002,6 +5002,38 @@ window.splitURL=(urlOrigin)=>{
 	return {protocol:protocol, host:host, port:port, isSecure:isSecure};
 };
 
+window.getPathExtension=(path)=>{
+  const splits = path.split(".");
+  if(splits.length <= 1)
+	  return "";
+  return splits.pop();
+}
+
+window.getBasePath=(pathParam, fileSeparator="/")=>{
+	// Clean :
+	const path=pathParam.replace(/\/{2,}/gim,"/");
+  const splits = path.split(fileSeparator);
+  if(splits.length <= 1)
+	  return path;
+	// We remove the last part, corresponding to the file name:
+	return splits.slice(0,-1).join(fileSeparator)+fileSeparator;
+}
+
+window.getPathFileName=(path, fileSeparator="/", removeExtension=false)=>{
+  const splits = path.split(fileSeparator);
+  if(splits.length <= 0)
+	  return "";
+	let fileNameWithExtension=splits.pop();
+	if(empty(fileNameWithExtension))
+		return "";
+	if(!removeExtension)
+		return fileNameWithExtension;
+	const fileNameSplits = fileNameWithExtension.split(".");
+	if(fileNameSplits.length <= 0)
+	  return "";
+	return fileNameSplits[0];
+}
+
 
 
 // MUST REMAIN AT THE END OF THIS LIBRARY FILE !
@@ -5012,7 +5044,7 @@ AOTRAUTILS_LIB_IS_LOADED=true;
 
 	
 
-/*utils CLIENT library associated with aotra version : «1_29072022-2359 (24/06/2025-01:42:47)»*/
+/*utils CLIENT library associated with aotra version : «1_29072022-2359 (11/11/2025-17:05:51)»*/
 /*-----------------------------------------------------------------------------*/
 /* ## Utility global methods in a browser (htmljs) client environment.
  *
@@ -7949,55 +7981,84 @@ function filterPoints(allPoints ,ctx/*DBG*/){
 		/*OPTIONAL*/tagConfig={},
 		/*OPTIONAL*/audioBufferSize=null,/*OPTIONAL*/numberOfAudioChannels=null,
 		/*OPTIONAL*/doOnStart=null,
-		/*OPTIONAL*/doFinallyWhenMultipleDevices=null
+		/*OPTIONAL*//*DEPRECATED : USE PROMISE then() INSTEAD*/doFinallyWhenMultipleDevices=null
 ){
 	
+	
 	if(!isUserMediaAvailable()){
 		// TRACE
 		log("ERROR : User medias is not supported in your browser (or are you running in a non-https context ?). Aborting");
-		return null;
+		return new Promise();
 	}
-	
-	const cameras=[];
-	const microphones=[];
-	navigator.mediaDevices.enumerateDevices().then(function(devices){
 
-		devices.forEach(function(d){
-			if(d.kind==="videoinput")				cameras.push(d);
-			else if(d.kind==="audioinput")	microphones.push(d);
-	  });
+	return new Promise((accept,reject)=>{
+		
+		// Force request permissions :
+		const constraints={video:(videoConfigParam!=null), audio:(audioConfigParam!=null)}; // Default constraints (corresponding to no media)
+		navigator.mediaDevices.getUserMedia(constraints).then(()=>{
+					
 			
-		// CAUTION : On today this method only handles media handlers with a single track :
-
-		let constraints={video:(videoConfigParam!=null), audio:(audioConfigParam!=null)}; // Default constraints
-		if(!empty(cameras) && videoConfigParam){
-			let webcamIndex=videoConfigParam.webcamIndex;
-			if(webcamIndex!=null){
-				const deviceIndex=Math.min(cameras.length-1, webcamIndex);
-				constraints={ 
-						video:{
-							deviceId:{ exact: cameras[deviceIndex].deviceId }
+			const cameras=[];
+			const microphones=[];
+			
+			navigator.mediaDevices.enumerateDevices().then(function(devices){
+		
+				// DBG
+				lognow("DEBUG : Devices :",devices);
+				
+				devices.forEach(function(d){
+					if(d.kind==="videoinput")				cameras.push(d);
+					else if(d.kind==="audioinput")	microphones.push(d);
+			  });
+					
+				// CAUTION : On today this method only handles media handlers with a single track :
+		
+				if(videoConfigParam){
+					if(!empty(cameras)){
+						let webcamIndex=videoConfigParam.webcamIndex;
+						if(webcamIndex!=null && isNumber(webcamIndex)){
+							const deviceIndex=Math.min(cameras.length-1, webcamIndex);
+							constraints.video={	deviceId:{ exact: cameras[deviceIndex].deviceId }	};
 						}
-					};
-			}
-		}else if(!empty(microphones) && audioConfigParam){
-			let microphoneIndex=audioConfigParam.microphoneIndex;
-			if(microphoneIndex!=null){
-				const deviceIndex=Math.min(microphones.length-1, microphoneIndex);
-				constraints={ 
-						audio:{
-							deviceId: { exact: microphones[deviceIndex].deviceId }
+					}else{
+						// TRACE
+						lognow("ERROR : Video requested but no camera found. Aborting."); 
+						constraints.video=false;
+					}
+				}
+				if(audioConfigParam){
+					if(!empty(microphones)){
+						let microphoneIndex=audioConfigParam.microphoneIndex;
+						if(microphoneIndex!=null && isNumber(microphoneIndex)){
+							const deviceIndex=Math.min(microphones.length-1, microphoneIndex);
+							constraints.audio={	deviceId: { exact: microphones[deviceIndex].deviceId } };
 						}
-					};
-			}
-		}
-		
+					}else{
+						// TRACE
+						lognow("ERROR : Audio requested but no microphone found. Aborting."); 
+						constraints.audio=false;
+					}
+				}
+				
+				
+				let mediaHandler=getMediaHandlerIMPL(constraints, size, tagConfig, audioBufferSize, numberOfAudioChannels, doOnStart, {cameras:cameras, microphones:microphones});
+				if(doFinallyWhenMultipleDevices)	doFinallyWhenMultipleDevices(mediaHandler);
+				
+				accept(mediaHandler);
+					
+			}).catch(err=>{
+				// TRACE
+				lognow("ERROR : An error occured when trying to enumerate devices:",err);
+				reject(err);
+			});
 		
-		let mediaHandler=getMediaHandlerIMPL(constraints, size, tagConfig, audioBufferSize, numberOfAudioChannels, doOnStart, {cameras:cameras, microphones:microphones});
-		if(doFinallyWhenMultipleDevices)	doFinallyWhenMultipleDevices(mediaHandler);
-			
-	});
+		}).catch(err=>{
+			// TRACE
+			lognow("ERROR : An error occured when trying to get webcam handler:",err);
+			reject(err);
+		});
 	
+	});
 	
 };
 
@@ -8037,18 +8098,22 @@ function filterPoints(allPoints ,ctx/*DBG*/){
 	// 0- Basic validation :
 	if(!mediaConstraints){
 		// TRACE
-		log("ERROR : Are you kidding me ? no media constraint has been set for this mediaHandler !");
+		log("ERROR : No media constraint has been set for this mediaHandler !");
 		return null;
 	}
+	
+	
+	
 	const isVideo=!!(mediaConstraints.video);
 	const isAudio=!!(mediaConstraints.audio);
 	if(!isVideo && !isAudio){
 		// TRACE
-		log("ERROR : Are you kidding me ? nor audio nor video has been selected for this mediaHandler !");
+		log("ERROR : No audio nor video has been selected for this mediaHandler !");
 		return null;
 	}
 	
 	
+	
 	if(!isUserMediaAvailable()){
 		// TRACE
 		log("ERROR : User medias is not supported in your browser (or are you running in a non-https context ?). Aborting");
@@ -8066,14 +8131,19 @@ function filterPoints(allPoints ,ctx/*DBG*/){
 		devicesInfo:devicesInfo,
 //		UNUSED : mediaConstraints:mediaConstraints,
 		// technical attributes :
-		video:null, // This is where you will read the video image data !
+		videoReadingElement:null, // This is where you will read the video image data !
+		
+//		// DOES NOT WORK WELL :
+//		imageReader:null,
+//		currentVideoFrame:null,
+		
 		canvasTag:null,
 		canvasCtx:null,
 		audioData:[],// Where to store sound data
 		audioCtx:null,
 		
-		videoDeviceId:(mediaConstraints.video?mediaConstraints.video.deviceId.exact:null),
-		audioDeviceId:(mediaConstraints.audio?mediaConstraints.audio.deviceId.exact:null),
+		videoDeviceId:(mediaConstraints.video && mediaConstraints.video.deviceId?mediaConstraints.video.deviceId.exact:null),
+		audioDeviceId:(mediaConstraints.audio && mediaConstraints.audio.deviceId?mediaConstraints.audio.deviceId.exact:null),
 		
 		imageInterceptors:[],
 		appendImageInterceptor:(method)=>mediaHandler.imageInterceptors.push(method),
@@ -8102,36 +8172,40 @@ function filterPoints(allPoints ,ctx/*DBG*/){
 //canvasTag.style.display="none";
 
 
-	// This temporary, off-screen video is always needed to get the image data for further use :
-	let videoTag;
+	let videoTag=null;
 	if(!tagConfig || !tagConfig.videoToUse){
-		videoTag=document.createElement("video");
-		videoTag.id="tmpVideoElement";
-		videoTag.autoplay=true;
-		videoTag.width=canvasTag.width;
-		videoTag.height=canvasTag.height;
-		videoTag.style.width=canvasTag.width+"px";
-		videoTag.style.height=canvasTag.height+"px";
-
-//		// UNUSEFUL (SINCE VIDEO ELEMENT IS NEVER APPENDED TO PAGE !) :
-//		videoTag.style.position="absolute";
-//		videoTag.style["pointer-events"]="none";
-//		videoTag.style.display="none";
-//		videoTag.style.display="none";
-//		document.body.appendChild(videoTag);
+		
+//		// DOES NOT WORK WELL :
+//		if(!tagConfig.useNoVideoReadingElement){
+			
+			// This temporary, off-screen video is always needed to get the image data for further use :
+			videoTag=document.createElement("video");
+			videoTag.id="tmpVideoElement";
+			videoTag.autoplay=true;
+			videoTag.width=canvasTag.width;
+			videoTag.height=canvasTag.height;
+			videoTag.style.width=canvasTag.width+"px";
+			videoTag.style.height=canvasTag.height+"px";
+	
+	//		// UNUSEFUL (SINCE VIDEO ELEMENT IS NEVER APPENDED TO PAGE !) :
+	//		videoTag.style.position="absolute";
+	//		videoTag.style["pointer-events"]="none";
+	//		videoTag.style.display="none";
+	//		videoTag.style.display="none";
+	//		document.body.appendChild(videoTag);
+//		}
 
 	}else{
 		videoTag=tagConfig.videoToUse;
 	}
 	
-	
 		
-	mediaHandler.video=videoTag;
+	mediaHandler.videoReadingElement=videoTag;
 
 
 	// UNUSED
 //	mediaHandler.isReady=function(){
-////	return mediaHandler.video !== null;
+////	return mediaHandler.videoReadingElement !== null;
 //		return !!(mediaHandler.stream);
 //	};
 	
@@ -8141,8 +8215,7 @@ function filterPoints(allPoints ,ctx/*DBG*/){
 		if(!constraints){
 			//constraints={video: (isVideo?{zoom:true,width:{ideal:nonull(width,DEFAULT_WIDTH)},height:{ideal:nonull(height,DEFAULT_HEIGHT)}}:false), audio: isAudio};
 			// DBG
-			constraints={video: (isVideo?
-								{width:nonull(width,DEFAULT_WIDTH),height:nonull(height,DEFAULT_HEIGHT)}
+			constraints={video: (isVideo?{width:{ideal:nonull(width,DEFAULT_WIDTH)},height:{ideal:nonull(height,DEFAULT_HEIGHT)} }
 //// ALTERNATIVELY, AND MORE FINE_TUNED  :
 //							{zoom:true,mandatory: {
 //                            minWidth: 1280,
@@ -8152,6 +8225,24 @@ function filterPoints(allPoints ,ctx/*DBG*/){
 //                            }
 //							}
 							:false), audio: isAudio};
+		}else{
+			
+			if(isVideo){
+				if(!constraints.video){
+					constraints.video={};
+				}
+				if(!constraints.video.width){
+					constraints.video.width={ideal:nonull(width,DEFAULT_WIDTH)};
+				}
+				if(!constraints.video.height){
+					constraints.video.height={ideal:nonull(height,DEFAULT_HEIGHT)};
+				}
+			}
+			if(isAudio && !constraints.audio){
+				constraints.audio=true;
+			}
+			
+			
 		}
 		
 		// TRACE
@@ -8168,9 +8259,9 @@ function filterPoints(allPoints ,ctx/*DBG*/){
 	
 	
 					// DBG
-					lognow("(DEBUG) streamSettings:",streamSettings);
-					lognow("(DEBUG) stream:",stream);
-					lognow("(DEBUG) stream.getVideoTracks():",stream.getVideoTracks());
+					lognow("DEBUG : streamSettings:",streamSettings);
+					lognow("DEBUG : stream:",stream);
+					lognow("DEBUG : stream.getVideoTracks():",stream.getVideoTracks());
 					
 	
 					if(streamSettings){
@@ -8186,27 +8277,35 @@ function filterPoints(allPoints ,ctx/*DBG*/){
 	    			
 	    			// TRACE
 	    			lognow("INFO : MEDIA HANDLER : Starting video...");
-	    			
-	    			// We always have a video tag (to grab the video data)
-	  				if(!isArray(mediaHandler.video)){
+						
+//						// DOES NOT WORK WELL :
+//						if(tagConfig && tagConfig.useNoVideoReadingElement){
+//						
+//							const track = stream.getVideoTracks()[0];
+//							const processor = new MediaStreamTrackProcessor({track});
+//							const readableStream = processor.readable;
+//							mediaHandler.imageReader = readableStream.getReader();
+//						
+//							    			
+//	  				}else 
+	    			// In this case we have a single video tag for this mediaHandler (to grab the video data)
+						if(!isArray(mediaHandler.videoReadingElement)){
 	  					
-	  					mediaHandler.video.srcObject=stream;
+	  					mediaHandler.videoReadingElement.srcObject=stream;
 //	  					DOES NOT WORK : mediaHandler.video.src=stream;
 	  					
-	  					// NO : DOES NOT WORK (CREATES A BLANK IMAGE !) mediaHandler.video.muted=true;
+	  					// NO : DOES NOT WORK (CREATES A BLANK IMAGE !) mediaHandler.videoReadingElement.muted=true;
 	  					// STUPID WORKAROUND : Because apparently, if volume==0 or video is muted, then the image data is all black !!!
-	  					mediaHandler.video.volume=0.0000000000001;
-	//  				mediaHandler.video.autoplay=true;
+	  					mediaHandler.videoReadingElement.volume=0.0000000000001;
+	//  				mediaHandler.videoReadingElement.autoplay=true;
 	
-							if(tagConfig && tagConfig.videoToUse && tagConfig.videoScale){
-								if(isNumber(tagConfig.videoScale)){
-									mediaHandler.video.style.scale=tagConfig.videoScale;
-								}
+							if(tagConfig && tagConfig.videoToUse && tagConfig.videoScale && isNumber(tagConfig.videoScale)){
+								mediaHandler.videoReadingElement.style.scale=tagConfig.videoScale;
 							}
 							
 	  				}else{	// Audio part :
 		
-	  					foreach(mediaHandler.video,(v)=>{
+	  					foreach(mediaHandler.videoReadingElement,(v)=>{
 	  						
 	  						v.srcObject=stream;
 	  						
@@ -8220,7 +8319,7 @@ function filterPoints(allPoints ,ctx/*DBG*/){
 	
 	      		
 	      		mediaHandler.canvasTag=canvasTag;
-	      		mediaHandler.canvasCtx=mediaHandler.canvasTag.getContext("2d");
+	      		mediaHandler.canvasCtx=mediaHandler.canvasTag.getContext("2d",{ willReadFrequently: true }/*CAUTION : DISABLES GPU OPTIMIZATION !*/);
 	
 	      		let x=0;
 	      		let y=0;
@@ -8228,37 +8327,60 @@ function filterPoints(allPoints ,ctx/*DBG*/){
 	      		let width=mediaHandler.canvasTag.width;
 	      		let height=mediaHandler.canvasTag.height;
 	
-						mediaHandler.getVideoData=function(){
-
-		        		// To read the image data : (code from «PlaneWebcamProvider.js»)
-		        		// (in a canvas drawing function with canvasContext ctx :)
-		        		let ctx=mediaHandler.canvasCtx;
-
+						
+//						// DOES NOT WORK WELL :
+//						if(tagConfig && tagConfig.useNoVideoReadingElement){
+//							
+//							mediaHandler.getVideoData=()=>{
+//								if(mediaHandler.currentVideoFrame==null)
+//									mediaHandler.imageReader.read().then((videoFrame)=>{
+//										mediaHandler.currentVideoFrame=videoFrame.value;
+//									});
+//								currentVideoFrame=mediaHandler.currentVideoFrame;
+//								mediaHandler.currentVideoFrame=null;
+//								return currentVideoFrame;
+//							};
+//							
+//						}else{
+							
+							mediaHandler.getVideoData=function(){
+							
+								// To read the image data : (code from «PlaneWebcamProvider.js»)
+								// (in a canvas drawing function with canvasContext ctx :)
+							
+		        		const ctx=mediaHandler.canvasCtx;
 		        		ctx.save();
-		        		let imageObj= (isArray(mediaHandler.video)?mediaHandler.video[0]:mediaHandler.video);
+		        		const imageObj= (isArray(mediaHandler.videoReadingElement)?mediaHandler.videoReadingElement[0]:mediaHandler.videoReadingElement);
 		        		ctx.drawImage(imageObj,x,y,width,height);
-		        		let imageData=ctx.getImageData(x, y, width, height);
+		        		const imageData=ctx.getImageData(x, y, width, height);
+								imageData.messWithAlpha=true;
 								foreach(mediaHandler.imageInterceptors,(method)=>{method(imageData.data);});
+								
 			    			ctx.restore();
-		
-								imageData.messWithAlpha=true;
+								
 							
 			    			return imageData;// returns an object containing data in this form : {data:<image data array>, width:<image width>, height:<image height>, messWithAlpha:true}						  
-						};
+							};
+//						}
+						
+						
+						
+						
+						
 			      		
 	      		// If we have feed actual video visible tags, then we play them :
 	      		if(tagConfig && tagConfig.videoToUse && !tagConfig.invisibleVideoTag){
 	      			
 	      			
-	    			if(!isArray(mediaHandler.video)){
-			      		mediaHandler.video.onloadedmetadata=function(event){
+	    			if(!isArray(mediaHandler.videoReadingElement)){
+			      		mediaHandler.videoReadingElement.onloadedmetadata=function(event){
 							let video=event.target;
 			      			video.play();
 				        	if(tagConfig.videoMuted)	video.muted=true;
 				        	else											delete video.muted;
 			        	};
 	    			}else{
-	    				foreach(mediaHandler.video,(v)=>{	
+	    				foreach(mediaHandler.videoReadingElement,(v)=>{	
 	  		      			v.onloadedmetadata=function(event){
 	  		      				let video=event.target;
 	  		      				video.play();
@@ -8393,21 +8515,31 @@ drawVideoImage=function(canvas,videoImage,
 		/*OPTIONAL*/newWidthParam,/*OPTIONAL*/newHeightParam,
 		/*OPTIONAL*/isMessWithAlpha){
 	
-	var videoRawImageData=videoImage.data;
+	const ctx=canvas.getContext("2d");
+
+	var x=nonull(xParam,0);
+	var y=nonull(yParam,0);
+
+//	// DOES NOT WORK WELL :
+//	if(Object.getPrototypeOf(videoImage).constructor.name==="VideoFrame"){
+//		ctx.drawImage(videoImage, x, y, newWidthParam, newHeightParam);
+//		return;
+//	}
+
 	var oldWidth=videoImage.width;
 	var oldHeight=videoImage.height;
 	
-	var x=nonull(xParam,0);
-	var y=nonull(yParam,0);
 	const zooms=nonull(zoomsParam,{zx:1,zy:1});
 	
 	var newWidth=newWidthParam?newWidthParam:canvas.width;
 	var newHeight=newHeightParam?newHeightParam:canvas.height;
 
-	var ctx=canvas.getContext("2d");
 	
 	let imageData=null;
 	let tmpImage=null;
+
+	
+	const videoRawImageData=videoImage.data;
 	if(videoImage.format==="base64"){
 
 		tmpImage=new Image();
@@ -8422,6 +8554,9 @@ drawVideoImage=function(canvas,videoImage,
 		normalizeData(videoRawImageData, imageData.data, isMessWithAlpha);
 
 	}
+	
+	
+	
 
 	let clipX=0; // UNUSED
 	let clipY=0; // UNUSED
@@ -9676,7 +9811,7 @@ function arrayFromString(strParam,compressResult=true,precisionFraction=null,isS
 //	appendAsFirstChildOf(videoTag, backgroundContainerDiv);
 //}
 //
-//webcamHandler.video=videoTag;
+//webcamHandler.videoReadingElement=videoTag;
 //
 //webcamHandler.localMediaStream=null;
 //
@@ -9685,8 +9820,8 @@ function arrayFromString(strParam,compressResult=true,precisionFraction=null,isS
 //
 //	// Not showing vendor prefixes or code that works cross-browser.
 //	var initStream=function(stream){
-//		DEPRECATED : 	self.video.src=window.URL.createObjectURL(stream);
-//		self.video.srcObject=stream;
+//		DEPRECATED : 	self.videoReadingElement.src=window.URL.createObjectURL(stream);
+//		self.videoReadingElement.srcObject=stream;
 //		self.localMediaStream=stream;
 //	};
 //
@@ -9757,7 +9892,7 @@ function arrayFromString(strParam,compressResult=true,precisionFraction=null,isS
 //}
 //
 //webcamHandler.isReady=function(){
-//	return webcamHandler.video !== null;
+//	return webcamHandler.videoReadingElement !== null;
 //};
 //
 //return webcamHandler;
@@ -10838,6 +10973,49 @@ function normalizeDisplayQuotesForJSONParsing(str){
 }
 
 
+
+// Workaround to avoid «User interaction» errors for XR initialization :
+
+function addUserInteractionButton(selfObject, functionToExecuteAfterParam, functionArguments, label="START"){
+
+	const userInteractionButtonId="userInteractionButton";
+	let xrButton=document.getElementById(userInteractionButtonId);
+	if(!xrButton){
+		xrButton=document.createElement("button");
+		xrButton.id=userInteractionButtonId;
+		xrButton.innerHTML=label;
+		xrButton.style="position:fixed; font-size:7em; width:100%; height:100%; z-index:9999; cursor:pointer;";
+		document.body.appendChild(xrButton);
+	}
+
+	xrButton.selfObject=selfObject;
+	xrButton.listenerArgs=functionArguments;
+	xrButton.functionToExecuteAfter=functionToExecuteAfterParam;
+	xrButton.addEventListener("click",(event)=>{
+		
+		const targetXRButton=event.target;
+		const self=targetXRButton.selfObject;
+		const listenerArgs=targetXRButton.listenerArgs;
+		const functionToExecuteAfter=targetXRButton.functionToExecuteAfter;
+		
+		targetXRButton.parentNode.removeChild(targetXRButton);
+
+		functionToExecuteAfter.apply(self,listenerArgs);
+
+	});
+	
+}
+
+
+
+////
+
+
+
+
+
+
+
 //-------------------------------------------------------------------------------------------
 
 
@@ -10881,7 +11059,7 @@ function promptWindow(label,type=null,defaultValue=null,
 	//Each field rendering :
 	/* private */const getRenderedInputElement=function(inputType, defaultValueParam=null,/* OPTIONAL */labelParam=null){
 	
-		const DISABLED_OPACITY=0.6;
+		const DISABLED_RADIO_OPACITY=0.6;
 	
 		let inputElement=null;
 		if(contains(inputType, "password")){
@@ -10951,7 +11129,7 @@ function promptWindow(label,type=null,defaultValue=null,
 									
 									if(choiceLabelStr.inactive){
 										radio.disabled=true;
-										radio.style.opacity=DISABLED_OPACITY;
+										radio.style.opacity=DISABLED_RADIO_OPACITY;
 									}
 								}
 								
@@ -11332,155 +11510,7 @@ getInputCoords=function(event){
 
 
 
-
-// Three.js utils :
-
-/*private*/function isWebglAvailable(){
-	try {
-		let canvas=document.createElement("canvas");
-		return !!(window.WebGLRenderingContext && (canvas.getContext("webgl") || canvas.getContext("experimental-webgl")));
-	} catch (error){
-		return false;
-	}
-}
-
-
-function getThreeRenderer(conf, pixelRatio=window.devicePixelRatio){
-
-	if(!THREE){
-		lognow("ERROR : Three.js library missing ! Cannot create ThreeJS renderer.");
-		return null;
-	}
-	
-	let renderer;	
-	if(conf.canvas){
-		if(isWebglAvailable()){
-			
-			if(conf.background==="transparent"){
-				conf.alpha=true;
-			}
-			
-			renderer=new THREE.WebGLRenderer(conf);
-			renderer.setPixelRatio(pixelRatio);
-			
-			if(conf.background==="transparent"){
-				renderer.setClearColor(0x000000, 0);
-			}
-			
-		}
-	}else if(conf.type === "css"){ 
-		renderer=new THREE.CSS3DRenderer();
-	}
-
-	if(!renderer){
-		// TRACE
-		lognow("ERROR : No renderer found found. Aborting.");
-		return null;
-	}
-
-// REMOVED FROM THREEJS :
-// let renderer=new THREE.CanvasRenderer({
-//		canvas : conf.canvas
-// });
-
-
-	if(conf.canvas){
-		renderer.setSize(conf.canvas.width, conf.canvas.height);
-	}else if(conf.w && conf.h){
-		renderer.setSize(conf.w, conf.h);
-	}
-
-	return renderer;
-}
-
-
-function getVRHandler(renderer,modeVR="immersive-vr",optionsVR=["local-floor", "bounded-floor", "hand-tracking", "layers"]){
-//	"immersive-ar", "immersive-vr", "inline"
-
-	// See : https://developer.mozilla.org/en-US/docs/Web/API/XRSystem/requestSession	
-	
-	if(typeof(navigator)===undefined || !renderer){
-		// TRACE
-		lognow("ERROR : No 3D renderer provided, cannot init the VR session.");
-		return null;
-	}
-	
-
-	if("xr" in navigator){
-
-		const result={
-			
-			currentSession:null,
-
-			/*private*/onSessionStarted:async function(session){
-				session.addEventListener("end", result.onSessionEnded);
-				
-				await renderer.xr.setSession(session);
-
-				result.currentSession=session;
-			},
-
-			/*private*/onSessionEnded:(event)=>{
-				result.currentSession.removeEventListener("end", result.onSessionEnded);
-				result.currentSession=null;
-			},
-
-			start:()=>{
-
-				if(result.currentSession)	return;
-
-				// WebXR's requestReferenceSpace only works if the corresponding feature
-				// was requested at session creation time. For simplicity, just ask for
-				// the interesting ones as optional features, but be aware that the
-				// requestReferenceSpace call will fail if it turns out to be unavailable.
-				// ('local' is always available for immersive sessions and doesn't need to
-				// be requested separately.)
-
-				const sessionInitConf={optionalFeatures:optionsVR};
-				navigator.xr.requestSession(modeVR, sessionInitConf)
-						.then(result.onSessionStarted)
-						.catch(error=>lognow("ERROR : Error initializing XR context : ",error));
-
-				return result;
-			},
-			
-			end:()=>{
-				if(!result.currentSession)	return;
-				result.currentSession.end();
-				return result;
-			},
-
-		};
-
-		navigator.xr.isSessionSupported(modeVR).then((supported)=>{
-			if(!supported){
-				// TRACE
-				lognow("ERROR : VR is not supported by your browser.");
-			}else{
-				result.isReady=true;				
-			}
-		});
-		
-		if(renderer.xr)	renderer.xr.enabled=true;
-
-		return result;
-	}
-	
-	if(window.isSecureContext === false) {
-		// TRACE
-		lognow("ERROR : WEBXR needs a HTTPS environemnt.");
-		return null;
-	}
-	
-	// TRACE
-	lognow("ERROR : WEBXR not available.");
-	
-	return null;
-};
-
-
-
-// WEBGL Management :
+// HTML Management :
 
 function convertHTMLToImage(elementHTML,callBack,mode="png",quality=null,height,width){
 	
@@ -12570,6 +12600,10 @@ createOritaMicroClient=function(url, port, isNode=false, staticMicroClientIdPara
 		outputsGPIO:{},
 		inputsGPIO:{},
 		
+		setCaptureConfig:(captureConfig)=>{
+			oritaClient.captureConfig=captureConfig;
+			return oritaClient;
+		},
 		
 	};
 		
@@ -12863,7 +12897,7 @@ createOritaMicroClient=function(url, port, isNode=false, staticMicroClientIdPara
 								console.log("mh:", mh); console.log("medias:", medias);
 								doOnStartMediaHandlerMicroClient(mh, medias, videoSide);
 							},
-							(mh) => { mediaHandlerLocal = mh; });
+							(mh) => { mediaHandlerLocal = mh; }).catch(err=>{lognow("ERROR : Could not get webcam handler for BROWSER MICROCLIENT.");});
 
 					} else { // Case node micro client :
 
@@ -12884,13 +12918,13 @@ createOritaMicroClient=function(url, port, isNode=false, staticMicroClientIdPara
 						console.log("audioConfigLocal", audioConfigLocal);
 
 
-						mediaHandlerLocal = getNodeMediaHandler(
+						mediaHandlerLocal = getMediaHandler(
 							videoConfigLocal,
 							audioConfigLocal,
 							//									CHANNELS_CONFIG,
 							{ width: captureWidth, height: captureHeight },
 							audioBufferSize, 1/*(means mono audio)*/,
-							(mh) => { doOnStartMediaHandlerMicroClient(mh, medias, videoSide); });
+							(mh) => { doOnStartMediaHandlerMicroClient(mh, medias, videoSide); }).catch(err=>{lognow("ERROR : Could not get webcam handler for MICROCLIENT.");});
 
 
 					}
@@ -13613,7 +13647,7 @@ getAORTACClient=function(clientId=getUUID(), serverNodeOrigin="ws://127.0.0.1:40
 
 
 
-/*utils GEOMETRY library associated with aotra version : «1_29072022-2359 (24/06/2025-01:42:47)»*/
+/*utils GEOMETRY library associated with aotra version : «1_29072022-2359 (11/11/2025-17:05:51)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -13623,7 +13657,7 @@ getAORTACClient=function(clientId=getUUID(), serverNodeOrigin="ws://127.0.0.1:40
  * Several authors of snippets published freely on the Internet contributed to this library.
  * Feel free to use/modify-enhance/publish them under the terms of its license.
  * 
- * # Library name : «aotrautils» 
+ * # Library name : «aotrautils geometry» 
  * # Library license : HGPL(Help Burma) (see aotra README information for details : https://alqemia.com/aotra.js )
  * # Author name : Jérémie Ratomposon (massively helped by his native country free education system)
  * # Author email : info@alqemia.com
@@ -14852,7 +14886,10 @@ function rayVsUnitSphereClosestPoint(p, r) {
 // MUST REMAIN AT THE END OF THIS LIBRARY FILE !
 
 AOTRAUTILS_GEOMETRY_LIB_IS_LOADED=true;
-/*utils AI library associated with aotra version : «1_29072022-2359 (24/06/2025-01:42:47)»*/
+/*utils 3D library associated with aotra version : «1_29072022-2359 (11/11/2025-17:05:51)»*/
+/*-----------------------------------------------------------------------------*/
+
+/*utils AI library associated with aotra version : «1_29072022-2359 (11/11/2025-17:05:51)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -14998,7 +15035,7 @@ getOpenAIAPIClient=(modelName, apiURL, agentRole, defaultPrompt)=>{
 
 
 
-/*utils CONSOLE library associated with aotra version : «1_29072022-2359 (24/06/2025-01:42:47)»*/
+/*utils CONSOLE library associated with aotra version : «1_29072022-2359 (11/11/2025-17:05:51)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -15422,7 +15459,12 @@ WebsocketImplementation={
 					return null;
 				}
 
-				clientSocket=new WebSocket(serverURL+":"+port,/*WORKAROUND:*/{ rejectUnauthorized:false, secure: isSecure });
+				clientSocket=new WebSocket(serverURL+":"+port,/*WORKAROUND:*/{ 
+					// CAUTION : SECURITY BREACH :
+					// BUT ALSO NECESSARY TO ALLOW SELF-SIGNED CERTIFICATES USAGE WITH THE YESBOT SYSTEM !
+					rejectUnauthorized:false, // (THIS IS A KNOWN SECURITY BREACH)
+					secure: isSecure
+				});
 			}else{
 				// NOW : socket.io :
 				//client on server-side:
@@ -15460,6 +15502,11 @@ WebsocketImplementation={
 			// BROWSER CLIENT MODE ONLY :
 			let clientSocket;
 			if(!WebsocketImplementation.useSocketIOImplementation){
+				// CAUTION : PARAMETER rejectUnauthorized:false WILL DO NOTHING,
+				// BECAUSE THIS IS COMPLETLY HANDLED BY THE BROWSER SECURITY POLICY !
+				// SO TO CLEAR THE SSL ERROR :
+				// - FIRST GO TO THE HTTPS:// SERVER ADDRESS WITH BROWSER
+				// - THEN ADD THE SECURITY EXCEPTION IN THE BROWSER !
 				clientSocket=new WebSocket(serverURL+":"+port,["ws","wss"]);
 			}else if(typeof(io)!=="undefined"){
 					// OLD SYNTAX :clientSocket=io.connect(serverURL + ":" + port,{timeout: timeout, secure: isSecure});
@@ -15478,7 +15525,7 @@ WebsocketImplementation={
 
 launchNodeHTTPServer=function(port, doOnConnect=null, doOnFinalizeServer=null, /*OPTIONAL*/sslOptions=null, httpHandlerParam=null, addCORSHeader=ADD_CORS_HEADER){
 	
-	const EXCLUDED_FILENAMES_PARTS=[".keyHash."];
+	const EXCLUDED_FILENAMES_PARTS=[".keyHash.",".pem"];
 	
 	
 	
@@ -15745,8 +15792,8 @@ initNodeServerInfrastructureWrapper=function(doOnClientConnection=null, doOnFina
 			}else{
 				try{
 		  		sslOptions={
-		  			cert: fs.readFileSync(certPath),
-		  			key: fs.readFileSync(keyPath),
+		  			cert: fs.readFileSync(certPath, {encoding: "utf8"}),
+		  			key: fs.readFileSync(keyPath, {encoding: "utf8"}),
 		  		};
 				}catch(exception){
 					// TRACE
@@ -17162,7 +17209,14 @@ class NodeServerInstance{
 	}
 					
 	close(doOnCloseServer){
-		if(!this.serverSocket)	return;
+		if(!this.serverSocket){
+			//TRACE
+			lognow("WARN : Server socket is null ! Cannot close an inexistant serer socket. Attempting to close attached HTTP server anyway.");
+			lognow("WARN : THIS MAY CAUSE A MEMORY LEAK !!!");
+			if(!this.listenableServer)	return;
+			this.listenableServer.close(doOnCloseServer);	
+			return;
+		}
 		this.serverSocket.close(()=>{
 			if(!this.listenableServer)	return;	
 			this.listenableServer.close(doOnCloseServer);

aotrautils/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "aotrautils",
-	"version": "0.0.1795",
+	"version": "0.0.1797",
 	"main": "aotrautils.build.js",
 	"description": "A library for vanilla javascript utils (client-side) used in aotra javascript CMS",
 	"author": "Jeremie Ratomposon <info@alqemia.com> (https://alqemia.com)",