XangleCs documentation
Paramètres
Route : /server-Paramètres
Configuration globale du serveur. Organisé en onglets : General, Studio Mode, Publish, Sharing, Player, Network, Advanced.
Onglet General
Préréglages
- Application rapide : Événement / Studio une seule caméra / Studio bullet-time / Photogrammétrie
Sortie principale
- Images case à cocher
- Process (redimensionner, assets…) case à cocher Pas pour Starter
- Vidéos case à cocher
Visibilité de la navigation supérieure
- Cases à cocher pour : Player, Share, Library, Display, Calibration, Chromakey, Live view, Assets, UI, Frames, Lights, E-mail monitoring, Files/folders, Performances, Trigger actions, Media collections
- Chacun est conditionné par la fonctionnalité de sa licence respective
Composants Trigger actions
- Cases à cocher pour : Camera Préréglages, Light Préréglages, Projector Préréglages, GPIO Préréglages, Display devices xangle-server-trigger-actions
Onglet Studio Mode
- Allow delete case à cocher
- App flash case à cocher
- App dimmer menu déroulant — No dimmer / Trigger duration / Preview duration / Complete duration
- Dimmer opacity curseur 10–100%
- Dimmer spinner case à cocher
- Frames to show champ de texte — Vide pour tous
- Extract JPG from RAW menu déroulant — Extract all / Extract selection / Extract none
Onglet Publish
Dossier de sortie
- Dossier de sortie champ de texte — Ce dossier est utilisé pour stocker les fichiers générés lors d'une prise de vue. Son contenu est également affiché dans la bibliothèque et la galerie. Les paramètres de calibration numérique précédents y seront également stockés.
- Bouton Reset to default
Options de publication
- RAW files (if available) case à cocher — Non disponible pour les licences d'essai xangle-server-raw
- Originals files case à cocher
- Aligned images case à cocher
- Preview images case à cocher
- Final images case à cocher — multi-caméra uniquement
- Final format menu déroulant — JPG / PNG
- Publish server and camera Paramètres case à cocher
- Extract thumbnails from RAW case à cocher
- Copy EXIF from RAW to JPG menu déroulant — None / Orientation only / All
- Thumbnail camera number champ numérique
Onglet Sharing
- Active case à cocher Pas pour Starter
- Allow multiple E-mails case à cocher
- Cloud upload case à cocher
- Pièces jointes Cloud upload : Video, First video frame, All original pictures cases à cocher
- E-mail template menu déroulant
Champs personnalisés d'e-mail
- Par champ : Name (ex. « first_name »), Type (Text / menu déroulant), Required, Placeholder, Values Valeurs séparées par des virgules (pour le type menu déroulant)
Terms & conditions cases à cocher
- Par case à cocher : Name (ex. « terms_and_conditions »), Text, HTML file path (optionnel), Required, Checked (par défaut)
Téléchargement direct
- Active case à cocher Pas pour Starter
Auto-hébergé
- Active case à cocher Pas pour Starter
- Sharing URL prefix champ de texte
Pièces jointes à télécharger
- Video, First video frame, All original pictures cases à cocher
Sélecteur de collection
- Active case à cocher Pas pour Starter
- Selected template menu déroulant
- Webhook URL champ de texte — Le webhook sera appelé lorsque le sélecteur de collection est modifié, avec les données POST : timestamp, foldername, path
- External processing menu déroulant — None / Managed automatic / Managed manual / Delayed
Modèles d'e-mail
- HTML file template menu déroulant
- Subject champ de texte
- Body zone de texte / Éditeur HTML — basculer : case à cocher "html editor"
Fournisseur SMTP
- E-mail Service menu déroulant — None / Simulation / SendGrid / Gmail / Custom
- Attention ! Avec Gmail, vous devez configurer votre compte Gmail pour autoriser les applications « non sécurisées ». Google peut vous bloquer après un certain nombre d'e-mails envoyés par jour.
- Attention ! La simulation utilise un serveur de messagerie local simulé. Aucun e-mail ne sera réellement envoyé !
- From (expéditeur) champ d'e-mail
- Host, Port, Secure, Check certificate errors — SMTP personnalisé uniquement
- Username, Password / API key — par fournisseur
- Check SMTP connection bouton
Fournisseur CDN
- Fournisseur CDN menu déroulant — Bunny CDN / Cloudinary / Cloudflare R2
- API key, API secret champs de mot de passe
- Bunny CDN : Storage zone, Region (DE/UK/US/SG/SE/BR/SA), Pull zone URL
- Cloudinary : Cloud name
- Cloudflare R2 : Account ID, Bucket name, Public URL
Onglet Player
- Mute player case à cocher — Requis pour la lecture automatique
- Preview image champ numérique — Affichera l'image de cette caméra si disponible. Laissez vide ou 0 si vous n'avez pas besoin d'un aperçu rapide.
Onglet Network
- Network interface menu déroulant — Ne peut être modifié que dans l'application, pas dans un navigateur
- Boutons Refresh / Renew IP addresses (application uniquement)
- Disable server broadcast on network case à cocher
Onglet Advanced
Raccourcis de traitement
- Skip processing case à cocher
- Batch recalibrate bouton
- Liens vers : Documentation API, Paramètres de sortie vidéo, Séquences de déclenchement personnalisées
Filtrage du signal de déclenchement
- Prevent trigger during image transfer case à cocher
- Prevent trigger until processing is finished case à cocher
- Prevent trigger without cameras case à cocher
- Bulb trigger cooldown curseur 0–2000 ms — [DSLR avec BULB uniquement] Temps pendant lequel le signal de déclenchement sera ignoré
- Mirror Lock cooldown curseur 0–2000 ms — [DSLR avec verrouillage du miroir uniquement] Temps pendant lequel le signal de déclenchement sera ignoré
Synchronisation du déclenchement
- Mirror Lockup delay curseur 0–1000 ms — Délai entre la commande de « levée du miroir » et la capture réelle. Recommandé : 300–500 ms
- Half-Press Delay curseur 0–1000 ms — [DSLR uniquement] Temps pendant lequel l'appareil photo reste en demi-pression lorsque vous ne pouvez pas contrôler le signal de veille
- Trigger warmup delay curseur 0–300 ms — Compense le décalage de traitement du signal logiciel. Améliore légèrement la synchronisation dans les situations de « gel » au détriment de la réactivité
- Trigger release delay curseur 0–500 ms — [DSLR uniquement] Durée pendant laquelle Xangle « maintient » le signal de déclenchement avant de le relâcher
- Mirror lockup half press delay curseur 0–500 ms — [DSLR avec verrouillage du miroir] Durée de maintien de la demi-pression avant de lever le miroir
- Release half-press after mirror lock case à cocher
Performance de traitement
- Définit le nombre de tâches parallèles. Une bonne règle générale est d'utiliser un nombre juste en dessous du nombre de cœurs de CPU.
- CPU cores for calibration curseur 1–64
- CPU cores for chromakey curseur 1–64
- Parallel instances for ffmpeg curseur 1–64 — Si vous utilisez nvenc avec une VRAM limitée, vous devrez peut-être réduire le nombre d'instances parallèles
Logique de transfert d'images
- Picture upload timeout curseur 0–30000 ms — Attente maximale avant de considérer le transfert comme échoué. 0 = désactivé (à utiliser à vos risques et périls)
- Ignore extra picture delay curseur 0–10000 ms — Les images supplémentaires transférées dans cette fenêtre seront ignorées lors de prises de vue multiples
- Client buffer capacity curseur 0–32 — Lors de l'utilisation de Pis avec une RAM limitée (1 Go ou moins), limitez les fichiers transitant par la mémoire. 0 = illimité
- Transfer during capture case à cocher — Autoriser le transfert de fichiers immédiat lors de captures longues (rafale, itérations multiples…)
Contrôle de la bande passante
- Image transfer rate limit curseur 0–1500 Mo/s — Contrôle la bande passante de pointe. Une bonne règle générale est de 90–95 % de la bande passante disponible. 0 = illimité Pas pour Starter
- Concurrent downloads curseur 0–300 — Nombre maximum de téléchargements de fichiers simultanés. Plus élevé = plus de bande passante, transfert plus rapide. 0 = illimité
Divers
- Raspberry Pi performance preset menu déroulant — powersave (600 MHz) / performance (1200+ MHz, nécessite plus de puissance)
- Raspberry Pi log level menu déroulant — debug / info / error / off